pptx-react-viewer 4.3.0 → 4.5.0

package/dist/internals.d.ts

@@ -1692,6 +1692,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`). */
@@ -1794,6 +1804,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. */
@@ -1806,6 +1825,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
@@ -1845,6 +1876,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. */
@@ -1981,6 +2021,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`. */
@@ -3417,6 +3469,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 {
@@ -4081,6 +4142,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`).
    *
@@ -7270,11 +7343,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;
   /**
@@ -9284,7 +9363,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;
@@ -12038,7 +12122,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;
@@ -13190,7 +13274,7 @@ declare const P14_TRANSITION_KEYFRAMES = "\n/* ── Conveyor (translate X with
 /** Part 2: prism / reveal / ripple / shred / switch / vortex / warp / wheelReverse / window. */
 declare const P14_TRANSITION_KEYFRAMES_2 = "\n/* ── Prism: see `slide-transition-prism` (split out to keep this module\n   under the per-file LOC budget) ─────────────────────────────────────── */\n\n@keyframes pptx-tr-prism-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-bottom {\n\tfrom { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-top {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-top {\n\tfrom { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-bottom {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n}\n\n/* ── Reveal (slide away reveal) ──────────────────────────────────── */\n@keyframes pptx-tr-reveal-out-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-reveal-out-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n/* MEASURED: the incoming layer stays hidden for roughly the first half of the\n   transition (a real black/background gap shows through), then fades in -\n   not a flat 0.5->1 fade running the whole duration. */\n@keyframes pptx-tr-reveal-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n\n/* ── Ripple (expanding ring clip-path) ───────────────────────────── */\n@keyframes pptx-tr-ripple-in {\n\tfrom { clip-path: circle(0% at 50% 50%); opacity: 0.5; }\n\t30%  { clip-path: circle(20% at 50% 50%); opacity: 0.7; }\n\t60%  { clip-path: circle(50% at 50% 50%); opacity: 0.9; }\n\tto   { clip-path: circle(75% at 50% 50%); opacity: 1; }\n}\n\n/* ── Shred (fragmented clip-path pieces) ─────────────────────────── */\n@keyframes pptx-tr-shred-strips-in {\n\tfrom { clip-path: inset(0 100% 0 0); opacity: 0; }\n\t30%  { clip-path: inset(0 60% 0 0); opacity: 0.5; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-rectangles-in {\n\tfrom { clip-path: inset(50%); opacity: 0; }\n\t40%  { clip-path: inset(20%); opacity: 0.6; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Switch (flip/rotate swap) ───────────────────────────────────── */\n@keyframes pptx-tr-switch-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n}\n@keyframes pptx-tr-switch-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n}\n\n/* ── Vortex (rotate + scale spiral) ──────────────────────────────── */\n@keyframes pptx-tr-vortex-in {\n\tfrom { transform: rotate(720deg) scale(0); opacity: 0; }\n\tto   { transform: rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-vortex-out {\n\tfrom { transform: rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: rotate(-720deg) scale(0); opacity: 0; }\n}\n\n/* ── Warp: see `slide-transition-warp` (COM-measured radial zoom blur,\n   split out to keep this module under the per-file LOC budget) ────────── */\n\n@keyframes pptx-tr-warp-in {\n\t0%   { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n}\n@keyframes pptx-tr-warp-reverse-in {\n\t0%   { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-reverse-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n}\n\n\n/* ── WheelReverse (reverse wheel rotation) ───────────────────────── */\n@keyframes pptx-tr-wheel-reverse-in {\n\tfrom { clip-path: circle(0% at 50% 50%); transform: rotate(180deg); }\n\tto   { clip-path: circle(75% at 50% 50%); transform: rotate(0deg); }\n}\n\n/* ── Window (scale from center with border) ──────────────────────────\n   Same measured horz/vert meaning as Doors above (horz = horizontal split\n   line opening vertically; vert = vertical split line opening horizontally). */\n@keyframes pptx-tr-window-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-out {\n\tfrom { opacity: 1; transform: scale(1); }\n\tto   { opacity: 0; transform: scale(0.9); }\n}\n";
 /** Both p14 keyframe blocks concatenated, for single `<style>` injection. */
-declare const P14_TRANSITION_KEYFRAMES_ALL = "\n/* ── Conveyor (translate X with staggered timing) ──────────────────── */\n@keyframes pptx-tr-conveyor-in-from-right {\n\tfrom { transform: translateX(100%) rotateY(-30deg); }\n\t60%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-left {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(-100%) rotateY(30deg); }\n}\n@keyframes pptx-tr-conveyor-in-from-left {\n\tfrom { transform: translateX(-100%) rotateY(30deg); }\n\t60%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-right {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(100%) rotateY(-30deg); }\n}\n\n/* ── Doors (clip-path from center split) ──────────────────────────────\n   MEASURED via COM CreateVideo: PowerPoint's `dir=\"horz\"` names a\n   HORIZONTAL split line (two panels stacked top/bottom, opening upward and\n   downward), and `dir=\"vert\"` a VERTICAL split line (panels side by side,\n   opening left and right) - the opposite of what \"clips left/right\" vs\n   \"clips top/bottom\" would suggest at a glance. Keep the clip-path bodies\n   matched to the MEASURED direction, not the intuitive one. */\n@keyframes pptx-tr-doors-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-doors-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n\n/* ── Ferris (rotate elements around center) ───────────────────────── */\n@keyframes pptx-tr-ferris-in-from-right {\n\tfrom { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-left {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n}\n@keyframes pptx-tr-ferris-in-from-left {\n\tfrom { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-right {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n}\n\n/* ── Flash (bright flash opacity burst) ──────────────────────────── */\n@keyframes pptx-tr-flash-white {\n\t0%   { opacity: 1; }\n\t30%  { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n@keyframes pptx-tr-flash-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t70%  { opacity: 1; }\n\t100% { opacity: 1; }\n}\n\n/* ── Flythrough (scale + translate Z-axis feel) ──────────────────── */\n@keyframes pptx-tr-flythrough-in {\n\tfrom { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n}\n@keyframes pptx-tr-flythrough-reverse-in {\n\tfrom { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-reverse-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n}\n\n/* ── Gallery (translate with perspective) ─────────────────────────── */\n@keyframes pptx-tr-gallery-in-from-right {\n\tfrom { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-left {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n}\n@keyframes pptx-tr-gallery-in-from-left {\n\tfrom { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-right {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n}\n\n/* ── Glitter (particle dissolve effect) ──────────────────────────── */\n@keyframes pptx-tr-glitter-in {\n\tfrom { opacity: 0; filter: brightness(1.5) contrast(1.3) blur(2px); }\n\t60%  { opacity: 0.7; filter: brightness(1.2) contrast(1.1) blur(1px); }\n\tto   { opacity: 1; filter: brightness(1) contrast(1) blur(0); }\n}\n\n/* ── Honeycomb (hexagonal reveal) ────────────────────────────────── */\n@keyframes pptx-tr-honeycomb-in {\n\tfrom {\n\t\tclip-path: polygon(50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%);\n\t\topacity: 0;\n\t}\n\tto {\n\t\tclip-path: polygon(50% 0%, 100% 25%, 100% 75%, 50% 100%, 0% 75%, 0% 25%);\n\t\topacity: 1;\n\t}\n}\n@keyframes pptx-tr-honeycomb-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Pan (large-scale translate) ─────────────────────────────────── */\n@keyframes pptx-tr-pan-from-right {\n\tfrom { transform: translateX(100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n@keyframes pptx-tr-pan-from-left {\n\tfrom { transform: translateX(-100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-pan-from-bottom {\n\tfrom { transform: translateY(100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-top {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(-100%); }\n}\n@keyframes pptx-tr-pan-from-top {\n\tfrom { transform: translateY(-100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-bottom {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(100%); }\n}\n\n\n/* ── Prism: see `slide-transition-prism` (split out to keep this module\n   under the per-file LOC budget) ─────────────────────────────────────── */\n\n@keyframes pptx-tr-prism-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-bottom {\n\tfrom { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-top {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-top {\n\tfrom { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-bottom {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n}\n\n/* ── Reveal (slide away reveal) ──────────────────────────────────── */\n@keyframes pptx-tr-reveal-out-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-reveal-out-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n/* MEASURED: the incoming layer stays hidden for roughly the first half of the\n   transition (a real black/background gap shows through), then fades in -\n   not a flat 0.5->1 fade running the whole duration. */\n@keyframes pptx-tr-reveal-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n\n/* ── Ripple (expanding ring clip-path) ───────────────────────────── */\n@keyframes pptx-tr-ripple-in {\n\tfrom { clip-path: circle(0% at 50% 50%); opacity: 0.5; }\n\t30%  { clip-path: circle(20% at 50% 50%); opacity: 0.7; }\n\t60%  { clip-path: circle(50% at 50% 50%); opacity: 0.9; }\n\tto   { clip-path: circle(75% at 50% 50%); opacity: 1; }\n}\n\n/* ── Shred (fragmented clip-path pieces) ─────────────────────────── */\n@keyframes pptx-tr-shred-strips-in {\n\tfrom { clip-path: inset(0 100% 0 0); opacity: 0; }\n\t30%  { clip-path: inset(0 60% 0 0); opacity: 0.5; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-rectangles-in {\n\tfrom { clip-path: inset(50%); opacity: 0; }\n\t40%  { clip-path: inset(20%); opacity: 0.6; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Switch (flip/rotate swap) ───────────────────────────────────── */\n@keyframes pptx-tr-switch-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n}\n@keyframes pptx-tr-switch-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n}\n\n/* ── Vortex (rotate + scale spiral) ──────────────────────────────── */\n@keyframes pptx-tr-vortex-in {\n\tfrom { transform: rotate(720deg) scale(0); opacity: 0; }\n\tto   { transform: rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-vortex-out {\n\tfrom { transform: rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: rotate(-720deg) scale(0); opacity: 0; }\n}\n\n/* ── Warp: see `slide-transition-warp` (COM-measured radial zoom blur,\n   split out to keep this module under the per-file LOC budget) ────────── */\n\n@keyframes pptx-tr-warp-in {\n\t0%   { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n}\n@keyframes pptx-tr-warp-reverse-in {\n\t0%   { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-reverse-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n}\n\n\n/* ── WheelReverse (reverse wheel rotation) ───────────────────────── */\n@keyframes pptx-tr-wheel-reverse-in {\n\tfrom { clip-path: circle(0% at 50% 50%); transform: rotate(180deg); }\n\tto   { clip-path: circle(75% at 50% 50%); transform: rotate(0deg); }\n}\n\n/* ── Window (scale from center with border) ──────────────────────────\n   Same measured horz/vert meaning as Doors above (horz = horizontal split\n   line opening vertically; vert = vertical split line opening horizontally). */\n@keyframes pptx-tr-window-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-out {\n\tfrom { opacity: 1; transform: scale(1); }\n\tto   { opacity: 0; transform: scale(0.9); }\n}\n";
+declare const P14_TRANSITION_KEYFRAMES_ALL = "\n/* ── Conveyor (translate X with staggered timing) ──────────────────── */\n@keyframes pptx-tr-conveyor-in-from-right {\n\tfrom { transform: translateX(100%) rotateY(-30deg); }\n\t60%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-left {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(-100%) rotateY(30deg); }\n}\n@keyframes pptx-tr-conveyor-in-from-left {\n\tfrom { transform: translateX(-100%) rotateY(30deg); }\n\t60%  { transform: translateX(-20%) rotateY(10deg); }\n\tto   { transform: translateX(0) rotateY(0deg); }\n}\n@keyframes pptx-tr-conveyor-out-to-right {\n\tfrom { transform: translateX(0) rotateY(0deg); }\n\t40%  { transform: translateX(20%) rotateY(-10deg); }\n\tto   { transform: translateX(100%) rotateY(-30deg); }\n}\n\n/* ── Doors (clip-path from center split) ──────────────────────────────\n   MEASURED via COM CreateVideo: PowerPoint's `dir=\"horz\"` names a\n   HORIZONTAL split line (two panels stacked top/bottom, opening upward and\n   downward), and `dir=\"vert\"` a VERTICAL split line (panels side by side,\n   opening left and right) - the opposite of what \"clips left/right\" vs\n   \"clips top/bottom\" would suggest at a glance. Keep the clip-path bodies\n   matched to the MEASURED direction, not the intuitive one. */\n@keyframes pptx-tr-doors-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-doors-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n\n/* ── Ferris (rotate elements around center) ───────────────────────── */\n@keyframes pptx-tr-ferris-in-from-right {\n\tfrom { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-left {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n}\n@keyframes pptx-tr-ferris-in-from-left {\n\tfrom { transform: translateX(-80%) rotate(-45deg) scale(0.6); opacity: 0; }\n\tto   { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-ferris-out-to-right {\n\tfrom { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: translateX(80%) rotate(45deg) scale(0.6); opacity: 0; }\n}\n\n/* ── Flash (bright flash opacity burst) ──────────────────────────── */\n@keyframes pptx-tr-flash-white {\n\t0%   { opacity: 1; }\n\t30%  { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n@keyframes pptx-tr-flash-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t70%  { opacity: 1; }\n\t100% { opacity: 1; }\n}\n\n/* ── Flythrough (scale + translate Z-axis feel) ──────────────────── */\n@keyframes pptx-tr-flythrough-in {\n\tfrom { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n}\n@keyframes pptx-tr-flythrough-reverse-in {\n\tfrom { transform: scale(0.1) translateZ(-200px); opacity: 0; filter: blur(8px); }\n\tto   { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n}\n@keyframes pptx-tr-flythrough-reverse-out {\n\tfrom { transform: scale(1) translateZ(0); opacity: 1; filter: blur(0); }\n\tto   { transform: scale(4) translateZ(200px); opacity: 0; filter: blur(8px); }\n}\n\n/* ── Gallery (translate with perspective) ─────────────────────────── */\n@keyframes pptx-tr-gallery-in-from-right {\n\tfrom { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-left {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n}\n@keyframes pptx-tr-gallery-in-from-left {\n\tfrom { transform: perspective(800px) translateX(-100%) rotateY(45deg); opacity: 0.5; }\n\tto   { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-gallery-out-to-right {\n\tfrom { transform: perspective(800px) translateX(0) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) translateX(100%) rotateY(-45deg); opacity: 0.5; }\n}\n\n/* ── Glitter (particle dissolve effect) ──────────────────────────── */\n@keyframes pptx-tr-glitter-in {\n\tfrom { opacity: 0; filter: brightness(1.5) contrast(1.3) blur(2px); }\n\t60%  { opacity: 0.7; filter: brightness(1.2) contrast(1.1) blur(1px); }\n\tto   { opacity: 1; filter: brightness(1) contrast(1) blur(0); }\n}\n\n/* ── Honeycomb (hexagonal reveal) ────────────────────────────────── */\n@keyframes pptx-tr-honeycomb-in {\n\tfrom {\n\t\tclip-path: polygon(50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%, 50% 50%);\n\t\topacity: 0;\n\t}\n\tto {\n\t\tclip-path: polygon(50% 0%, 100% 25%, 100% 75%, 50% 100%, 0% 75%, 0% 25%);\n\t\topacity: 1;\n\t}\n}\n@keyframes pptx-tr-honeycomb-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Pan (large-scale translate) ─────────────────────────────────── */\n@keyframes pptx-tr-pan-from-right {\n\tfrom { transform: translateX(100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n@keyframes pptx-tr-pan-from-left {\n\tfrom { transform: translateX(-100%); }\n\tto   { transform: translateX(0); }\n}\n@keyframes pptx-tr-pan-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-pan-from-bottom {\n\tfrom { transform: translateY(100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-top {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(-100%); }\n}\n@keyframes pptx-tr-pan-from-top {\n\tfrom { transform: translateY(-100%); }\n\tto   { transform: translateY(0); }\n}\n@keyframes pptx-tr-pan-to-bottom {\n\tfrom { transform: translateY(0); }\n\tto   { transform: translateY(100%); }\n}\n\n\n/* ── Prism: see `slide-transition-prism` (split out to keep this module\n   under the per-file LOC budget) ─────────────────────────────────────── */\n\n@keyframes pptx-tr-prism-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(90deg) translateX(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg) translateX(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-90deg) translateX(50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-bottom {\n\tfrom { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-top {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n}\n@keyframes pptx-tr-prism-in-from-top {\n\tfrom { transform: perspective(800px) rotateX(-90deg) translateY(-50%); opacity: 0; }\n\tto   { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n}\n@keyframes pptx-tr-prism-out-to-bottom {\n\tfrom { transform: perspective(800px) rotateX(0deg) translateY(0); opacity: 1; }\n\tto   { transform: perspective(800px) rotateX(90deg) translateY(50%); opacity: 0; }\n}\n\n/* ── Reveal (slide away reveal) ──────────────────────────────────── */\n@keyframes pptx-tr-reveal-out-to-right {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(100%); }\n}\n@keyframes pptx-tr-reveal-out-to-left {\n\tfrom { transform: translateX(0); }\n\tto   { transform: translateX(-100%); }\n}\n/* MEASURED: the incoming layer stays hidden for roughly the first half of the\n   transition (a real black/background gap shows through), then fades in -\n   not a flat 0.5->1 fade running the whole duration. */\n@keyframes pptx-tr-reveal-in {\n\t0%   { opacity: 0; }\n\t50%  { opacity: 0; }\n\t100% { opacity: 1; }\n}\n\n/* ── Ripple (expanding ring clip-path) ───────────────────────────── */\n@keyframes pptx-tr-ripple-in {\n\tfrom { clip-path: circle(0% at 50% 50%); opacity: 0.5; }\n\t30%  { clip-path: circle(20% at 50% 50%); opacity: 0.7; }\n\t60%  { clip-path: circle(50% at 50% 50%); opacity: 0.9; }\n\tto   { clip-path: circle(75% at 50% 50%); opacity: 1; }\n}\n\n/* ── Shred (fragmented clip-path pieces) ─────────────────────────── */\n@keyframes pptx-tr-shred-strips-in {\n\tfrom { clip-path: inset(0 100% 0 0); opacity: 0; }\n\t30%  { clip-path: inset(0 60% 0 0); opacity: 0.5; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-rectangles-in {\n\tfrom { clip-path: inset(50%); opacity: 0; }\n\t40%  { clip-path: inset(20%); opacity: 0.6; }\n\tto   { clip-path: inset(0); opacity: 1; }\n}\n@keyframes pptx-tr-shred-out {\n\tfrom { opacity: 1; }\n\tto   { opacity: 0; filter: blur(2px); }\n}\n\n/* ── Switch (flip/rotate swap) ───────────────────────────────────── */\n@keyframes pptx-tr-switch-in-from-right {\n\tfrom { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-left {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n}\n@keyframes pptx-tr-switch-in-from-left {\n\tfrom { transform: perspective(800px) rotateY(180deg); opacity: 0; }\n\tto   { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n}\n@keyframes pptx-tr-switch-out-to-right {\n\tfrom { transform: perspective(800px) rotateY(0deg); opacity: 1; }\n\tto   { transform: perspective(800px) rotateY(-180deg); opacity: 0; }\n}\n\n/* ── Vortex (rotate + scale spiral) ──────────────────────────────── */\n@keyframes pptx-tr-vortex-in {\n\tfrom { transform: rotate(720deg) scale(0); opacity: 0; }\n\tto   { transform: rotate(0deg) scale(1); opacity: 1; }\n}\n@keyframes pptx-tr-vortex-out {\n\tfrom { transform: rotate(0deg) scale(1); opacity: 1; }\n\tto   { transform: rotate(-720deg) scale(0); opacity: 0; }\n}\n\n/* ── Warp: see `slide-transition-warp` (COM-measured radial zoom blur,\n   split out to keep this module under the per-file LOC budget) ────────── */\n\n@keyframes pptx-tr-warp-in {\n\t0%   { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(0.85); opacity: 0.7; filter: blur(3px) brightness(1.3); }\n\t100% { transform: scale(0.25); opacity: 0; filter: blur(10px) brightness(1.8); }\n}\n@keyframes pptx-tr-warp-reverse-in {\n\t0%   { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n}\n@keyframes pptx-tr-warp-reverse-out {\n\t0%   { transform: scale(1); opacity: 1; filter: blur(0) brightness(1); }\n\t50%  { transform: scale(1.7); opacity: 0.7; filter: blur(6px) brightness(1.5); }\n\t100% { transform: scale(3.2); opacity: 0; filter: blur(14px) brightness(2.2); }\n}\n\n\n/* ── WheelReverse (reverse wheel rotation) ───────────────────────── */\n@keyframes pptx-tr-wheel-reverse-in {\n\tfrom { clip-path: circle(0% at 50% 50%); transform: rotate(180deg); }\n\tto   { clip-path: circle(75% at 50% 50%); transform: rotate(0deg); }\n}\n\n/* ── Window (scale from center with border) ──────────────────────────\n   Same measured horz/vert meaning as Doors above (horz = horizontal split\n   line opening vertically; vert = vertical split line opening horizontally). */\n@keyframes pptx-tr-window-horz {\n\tfrom { clip-path: inset(50% 0); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-vert {\n\tfrom { clip-path: inset(0 50%); }\n\tto   { clip-path: inset(0 0); }\n}\n@keyframes pptx-tr-window-out {\n\tfrom { opacity: 1; transform: scale(1); }\n\tto   { opacity: 0; transform: scale(0.9); }\n}\n\n\n@keyframes pptx-tr-vortex-in-left { from { transform: translateX(-40%) rotate(720deg) scale(0); opacity: 0; } to { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-left { from { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateX(-40%) rotate(-720deg) scale(0); opacity: 0; } }\n@keyframes pptx-tr-vortex-in-right { from { transform: translateX(40%) rotate(-720deg) scale(0); opacity: 0; } to { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-right { from { transform: translateX(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateX(40%) rotate(720deg) scale(0); opacity: 0; } }\n@keyframes pptx-tr-vortex-in-up { from { transform: translateY(-40%) rotate(720deg) scale(0); opacity: 0; } to { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-up { from { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateY(-40%) rotate(-720deg) scale(0); opacity: 0; } }\n@keyframes pptx-tr-vortex-in-down { from { transform: translateY(40%) rotate(-720deg) scale(0); opacity: 0; } to { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } }\n@keyframes pptx-tr-vortex-out-down { from { transform: translateY(0) rotate(0deg) scale(1); opacity: 1; } to { transform: translateY(40%) rotate(720deg) scale(0); opacity: 0; } }\n\n\n@keyframes pptx-tr-ripple-in-lu { from { clip-path: circle(0% at 0% 0%); opacity: 0.5; } 30% { clip-path: circle(20% at 0% 0%); opacity: 0.7; } 60% { clip-path: circle(55% at 0% 0%); opacity: 0.9; } to { clip-path: circle(150% at 0% 0%); opacity: 1; } }\n@keyframes pptx-tr-ripple-in-ru { from { clip-path: circle(0% at 100% 0%); opacity: 0.5; } 30% { clip-path: circle(20% at 100% 0%); opacity: 0.7; } 60% { clip-path: circle(55% at 100% 0%); opacity: 0.9; } to { clip-path: circle(150% at 100% 0%); opacity: 1; } }\n@keyframes pptx-tr-ripple-in-ld { from { clip-path: circle(0% at 0% 100%); opacity: 0.5; } 30% { clip-path: circle(20% at 0% 100%); opacity: 0.7; } 60% { clip-path: circle(55% at 0% 100%); opacity: 0.9; } to { clip-path: circle(150% at 0% 100%); opacity: 1; } }\n@keyframes pptx-tr-ripple-in-rd { from { clip-path: circle(0% at 100% 100%); opacity: 0.5; } 30% { clip-path: circle(20% at 100% 100%); opacity: 0.7; } 60% { clip-path: circle(55% at 100% 100%); opacity: 0.9; } to { clip-path: circle(150% at 100% 100%); opacity: 1; } }\n\n\n@keyframes pptx-tr-glitter-diamond-in-l { from { opacity: 0; transform: translateX(-6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateX(-2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-diamond-in-r { from { opacity: 0; transform: translateX(6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateX(2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-diamond-in-u { from { opacity: 0; transform: translateY(-6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateY(-2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-diamond-in-d { from { opacity: 0; transform: translateY(6%); filter: brightness(1.5) contrast(1.3) blur(2px); } 60% { opacity: 0.7; transform: translateY(2%); filter: brightness(1.2) contrast(1.1) blur(1px); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0); } }\n@keyframes pptx-tr-glitter-hexagon-in-l { from { opacity: 0; transform: translateX(-6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateX(-2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n@keyframes pptx-tr-glitter-hexagon-in-r { from { opacity: 0; transform: translateX(6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateX(2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateX(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n@keyframes pptx-tr-glitter-hexagon-in-u { from { opacity: 0; transform: translateY(-6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateY(-2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n@keyframes pptx-tr-glitter-hexagon-in-d { from { opacity: 0; transform: translateY(6%); filter: brightness(1.5) contrast(1.3) blur(2px) hue-rotate(20deg); } 60% { opacity: 0.7; transform: translateY(2%); filter: brightness(1.2) contrast(1.1) blur(1px) hue-rotate(8deg); } to { opacity: 1; transform: translateY(0); filter: brightness(1) contrast(1) blur(0) hue-rotate(0deg); } }\n";
 //#endregion
 //#region src/render/p14-transition-css.d.ts
 /**
@@ -13271,6 +13355,10 @@ interface PresentationInkStroke {
   points: PresentationInkPoint[];
 }
 //#endregion
+//#region src/render/paste-special.d.ts
+/** The four paste formats PowerPoint's Paste Options / Paste Special offer. */
+type PasteSpecialFormat = 'keep-source-formatting' | 'use-destination-theme' | 'picture' | 'keep-text-only';
+//#endregion
 //#region src/render/find-replace.d.ts
 /** Identifies a single match of the find query at segment-level precision. */
 interface FindResult {
@@ -13343,6 +13431,37 @@ interface FontEmbeddingDescriptor {
   /** Present only when `interactive` is false. */
   disabledReasonKey?: string;
 }
+//#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;
+}
+/** A pending "return to the zoom's origin slide" excursion, tracked by the binding across forward-advance steps. */
+interface ZoomExcursion {
+  /** The slide to jump back to once `endSlideIndex` is passed (the slide the zoom was clicked from). */
+  returnSlideIndex: number;
+  /** The last slide index of the zoom's target range; see {@link resolveZoomExcursionEndIndex}. */
+  endSlideIndex: number;
+  /** The zoom's own `transitionDur`, applied to the jump INTO the target and to the return jump. */
+  transitionDurationMs?: number;
+}
 /** Everything a binding needs to render the recovery dialog, and nothing else. */
 interface AutosaveRecoveryPrompt {
   /** IndexedDB key the snapshot is stored under (the deck's file path/name). */
@@ -13978,8 +14097,13 @@ interface ElementContextMenuState {
   y: number;
   elementId: string;
 }
+/** Tracks the position of an open empty-canvas (no element hit) context menu. */
+interface CanvasContextMenuState {
+  x: number;
+  y: number;
+}
 /** Identifies an action triggered from the element right-click context menu. */
-type ElementContextMenuAction = 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'comment' | 'addComment' | 'group' | 'ungroup' | 'editPoints' | 'editHyperlink';
+type ElementContextMenuAction = 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'comment' | 'addComment' | 'group' | 'ungroup' | 'editPoints' | 'editHyperlink' | 'edit-text' | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape';
 /**
  * State of an active marquee (rubber-band) selection rectangle.
  * Created when the user clicks and drags on the canvas background,
@@ -14318,6 +14442,7 @@ interface CanvasInteractionHandlers {
   handleElementDoubleClick: (elementId: string, e: React.MouseEvent) => void;
   handleElementMouseDown: (elementId: string, e: React.MouseEvent) => void;
   handleElementContextMenu: (elementId: string, e: React.MouseEvent) => void;
+  handleCanvasContextMenu: (e: React.MouseEvent) => void;
   handleCanvasMouseDown: (e: React.MouseEvent) => void;
   handleResizePointerDown: (elementId: string, e: React.MouseEvent, handle: string) => void;
   handleAdjustmentPointerDown: (elementId: string, e: React.MouseEvent, descriptor: ShapeAdjustmentHandleDescriptor) => void;
@@ -14497,6 +14622,7 @@ interface UseCanvasInteractionsInput {
   setInlineEditingElementId: React.Dispatch<React.SetStateAction<string | null>>;
   setInlineEditingText: React.Dispatch<React.SetStateAction<string>>;
   setContextMenuState: React.Dispatch<React.SetStateAction<ElementContextMenuState | null>>;
+  setCanvasContextMenuState: React.Dispatch<React.SetStateAction<CanvasContextMenuState | null>>;
   setMarqueeSelectionState: React.Dispatch<React.SetStateAction<MarqueeSelectionState | null>>;
   setSnapLines: React.Dispatch<React.SetStateAction<Array<{
     axis: string;
@@ -14593,6 +14719,25 @@ interface UseElementManipulationInput {
   ops: ElementOperations;
   history: EditorHistoryResult;
   onOpenHyperlinkDialog: () => void;
+  /**
+   * Enter inline text edit for `elementId`, same as double-clicking it.
+   * Wired to `canvasHandlers.handleElementDoubleClick`; omitted (never) in
+   * production, only in tests that do not exercise "Edit Text".
+   */
+  onEditText?: (elementId: string) => void;
+  /**
+   * Rasterise `elementId`'s own DOM node and download it as PNG ("Save as
+   * Picture"). Lives outside this hook because it needs the binding's
+   * `html2canvasFallback` driver and a DOM lookup, neither of which this
+   * hook otherwise touches.
+   */
+  onSaveElementAsPicture?: (elementId: string) => void;
+  /**
+   * Notified with the freshly-inserted clone after an ordinary paste, so the
+   * Paste Options mini-toolbar (`usePasteSpecial`) has something to reformat.
+   * Not called for Duplicate: PowerPoint's toolbar only follows a paste.
+   */
+  onPasted?: (element: PptxElement) => void;
 }
 interface ElementManipulationHandlers {
   handleCopy: () => void;
@@ -14714,6 +14859,28 @@ interface InsertElementHandlers {
 }
 declare function useInsertElements(input: UseInsertElementsInput): InsertElementHandlers;
 //#endregion
+//#region src/viewer/hooks/usePasteSpecial.d.ts
+/** The pasted element the "Paste Options" toolbar is currently anchored to. */
+interface PasteOptionsToolbarState {
+  elementId: string;
+  /** The pristine "Keep Source Formatting" clone every choice re-derives from. */
+  sourceClone: PptxElement;
+}
+interface UsePasteSpecialResult {
+  isPasteSpecialDialogOpen: boolean;
+  openPasteSpecialDialog: () => void;
+  closePasteSpecialDialog: () => void;
+  /** Ctrl+Alt+V / dialog OK: paste the clipboard element in the chosen format. */
+  pasteWithFormat: (format: PasteSpecialFormat) => Promise<void>;
+  /** The Paste Options toolbar shown right after an ordinary Ctrl+V paste. */
+  pasteOptionsToolbar: PasteOptionsToolbarState | null;
+  /** Record an ordinary paste's result so the toolbar has something to reformat. */
+  notePastedElement: (element: PptxElement) => void;
+  /** Re-derive the pasted element in `format` from the frozen source clone. */
+  reformatPastedElement: (format: PasteSpecialFormat) => Promise<void>;
+  dismissPasteOptionsToolbar: () => void;
+}
+//#endregion
 //#region src/viewer/hooks/presentation-mode/useCustomShowRunner.d.ts
 /**
  * useCustomShowRunner: the runtime side of `ppaction://customshow?id=<id>[&return=true]`.
@@ -14884,7 +15051,7 @@ interface UsePresentationModeResult {
   openAllSlides: () => void;
   closeAllSlides: () => void;
   movePresentationSlide: (direction: 1 | -1, trigger?: SlideAdvanceTrigger) => void;
-  navigateToSlide: (slideIndex: number) => void;
+  navigateToSlide: (slideIndex: number, transitionOverride?: PptxSlideTransition) => void;
   /** `elementId` is the clicked element, for the verbs that act on it (`playMedia`, `oleVerb`). */
   handlePresentationAction: (action: PptxAction, elementId?: string) => void;
   /**
@@ -14934,13 +15101,14 @@ interface UsePresentationModeResult {
   rehearsalPaused: boolean;
   /** Toggle the rehearsal timer pause state. */
   toggleRehearsalPause: () => void;
-  /** Handle a zoom element click in presentation mode. */
-  handleZoomClick: (targetSlideIndex: number, returnSlideIndex: number) => void;
-  /** Ref holding the slide index to return to after zoom navigation. */
-  zoomReturnSlideIndex: React.RefObject<number | null>;
-  /** Navigate back to the zoom summary slide. Returns true if navigation occurred. */
-  returnToZoomSlide: () => boolean;
-  /** Clear the stored zoom return index. */
+  /**
+   * Handle a zoom element (or Summary Zoom tile) click in presentation mode:
+   * navigates to the target, applying its own `zmPr/@transitionDur`, and (when
+   * `returnToParent` is set) arms an automatic return once the show reaches
+   * the end of the target's range. See `useZoomNavigation` / `useSlideNavigation`.
+   */
+  handleZoomClick: (target: ZoomNavigationTarget, returnSlideIndex: number) => void;
+  /** Clear a pending "return to zoom" excursion (e.g. when presentation mode ends). */
   clearZoomReturn: () => void;
   /** Open the audience display in a separate browser window. Returns `true` if successful. */
   openAudienceWindow: () => boolean;
@@ -15534,6 +15702,9 @@ interface ViewerUIState {
   setAccessibilityIssues: React.Dispatch<React.SetStateAction<AccessibilityIssue[]>>;
   contextMenuState: ElementContextMenuState | null;
   setContextMenuState: React.Dispatch<React.SetStateAction<ElementContextMenuState | null>>;
+  /** The empty-canvas (no element hit) right-click menu; mutually exclusive with `contextMenuState`. */
+  canvasContextMenuState: CanvasContextMenuState | null;
+  setCanvasContextMenuState: React.Dispatch<React.SetStateAction<CanvasContextMenuState | null>>;
   tableEditorState: TableCellEditorState | null;
   setTableEditorState: React.Dispatch<React.SetStateAction<TableCellEditorState | null>>;
   spellCheckEnabled: boolean;
@@ -15652,6 +15823,8 @@ interface EditorOperationsResult {
   canvasHandlers: CanvasInteractionHandlers;
   insertHandlers: InsertElementHandlers;
   manipulation: ElementManipulationHandlers;
+  /** Paste Special (Ctrl+Alt+V) dialog + the post-paste Paste Options toolbar. */
+  pasteSpecial: UsePasteSpecialResult;
   slideOps: SlideManagementHandlers;
   tableOps: TableOperationHandlers;
   /**
@@ -15744,6 +15917,8 @@ interface SlideCanvasProps {
   onContextMenu: (elementId: string, e: React$1.MouseEvent) => void;
   /** Called when the user presses mouse down on empty canvas space. */
   onCanvasMouseDown?: (e: React$1.MouseEvent) => void;
+  /** Right-click on empty canvas (no element hit); opens the canvas context menu. */
+  onCanvasContextMenu?: (e: React$1.MouseEvent) => void;
   onResizePointerDown: (elementId: string, e: React$1.MouseEvent, handle: string) => void;
   onAdjustmentPointerDown: (elementId: string, e: React$1.MouseEvent, descriptor: ShapeAdjustmentHandleDescriptor) => void;
   /** Commit a new rotation (degrees) when the on-canvas rotate handle is dragged. */
@@ -15822,7 +15997,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.). */
@@ -17218,6 +17393,8 @@ interface UseKeyboardShortcutWiringInput {
   copyFormatFromSelection: () => void;
   /** Ctrl/Cmd+Shift+V: apply the copied format to the given element ids. */
   pasteFormatToSelection: (targetIds: string[]) => void;
+  /** Ctrl/Cmd+Alt+V: open the Paste Special dialog. */
+  onPasteSpecial: () => void;
 }
 declare function useKeyboardShortcutWiring(input: UseKeyboardShortcutWiringInput): void;
 //#endregion
@@ -17542,6 +17719,8 @@ interface ClipboardInput {
   } | null>>;
   ops: ElementOperations;
   history: EditorHistoryResult;
+  /** Notified with the freshly-inserted clone after an ordinary paste. */
+  onPasted?: (element: PptxElement) => void;
 }
 declare function useClipboardHandlers(input: ClipboardInput): ClipboardHandlers;
 //#endregion
@@ -17757,6 +17936,8 @@ interface UseKeyboardShortcutsInput {
   onCycleSelectionNext?: () => void;
   /** Shift+Tab: select the previous element on the slide. */
   onCycleSelectionPrev?: () => void;
+  /** Ctrl/Cmd+Alt+V: open the Paste Special dialog. */
+  onPasteSpecial?: () => void;
 }
 declare function useKeyboardShortcuts(input: UseKeyboardShortcutsInput): void;
 //#endregion
@@ -17998,10 +18179,18 @@ interface UseSlideNavigationInput {
   onOleVerb?: (verb: number, elementId: string | undefined) => void;
   /** `ppaction://program`. */
   onRunProgram?: (target: string) => void;
+  /**
+   * A pending "return to zoom" excursion armed by `useZoomNavigation`'s
+   * `handleZoomClick`. Consulted on every forward advance: once the show
+   * reaches `excursion.endSlideIndex`, the step jumps back to
+   * `excursion.returnSlideIndex` (playing the zoom's own `transitionDur`)
+   * instead of continuing linearly through the deck.
+   */
+  zoomExcursionRef: React.RefObject<ZoomExcursion | undefined>;
 }
 interface UseSlideNavigationResult {
   movePresentationSlide: (direction: 1 | -1, trigger?: SlideAdvanceTrigger) => void;
-  navigateToSlide: (slideIndex: number) => void;
+  navigateToSlide: (slideIndex: number, transitionOverride?: PptxSlideTransition) => void;
   /** `elementId` is the clicked element, for the verbs that act on it (`playMedia`, `oleVerb`). */
   handlePresentationAction: (action: PptxAction, elementId?: string) => void;
   scheduleAutoAdvanceForSlide: (slideIndex: number) => void;
@@ -18013,43 +18202,38 @@ declare function useSlideNavigation(input: UseSlideNavigationInput): UseSlideNav
  * Input for the useZoomNavigation sub-hook.
  */
 interface UseZoomNavigationInput {
-  /** Navigate to a specific slide index. */
-  navigateToSlide: (slideIndex: number) => void;
+  slides: readonly PptxSlide[];
+  /** Navigate to a specific slide index, optionally overriding the destination's own transition. */
+  navigateToSlide: (slideIndex: number, transitionOverride?: PptxSlideTransition) => void;
+  /**
+   * Shared with `useSlideNavigation`'s forward-advance step: set here on a
+   * zoom click that requests `returnToParent`, and consumed there once the
+   * show reaches the end of the zoom's target range.
+   */
+  zoomExcursionRef: React.RefObject<ZoomExcursion | undefined>;
 }
 /**
  * Return type for the useZoomNavigation sub-hook.
  */
 interface UseZoomNavigationResult {
   /**
-   * Handle a zoom element click. Navigates to the target slide and
-   * stores the return slide index so we can go back later.
-   */
-  handleZoomClick: (targetSlideIndex: number, returnSlideIndex: number) => void;
-  /**
-   * The slide index to return to after a zoom navigation, or `null` if
-   * there is no pending return.
-   */
-  zoomReturnSlideIndex: React.RefObject<number | null>;
-  /**
-   * Navigate back to the zoom summary slide (if a return index is set).
-   * Returns `true` if navigation occurred, `false` otherwise.
-   */
-  returnToZoomSlide: () => boolean;
-  /**
-   * Clear the stored return index (e.g. when the user manually navigates
-   * away from the zoomed section).
+   * Handle a zoom element (or Summary Zoom tile) click: navigates to the
+   * target slide, applying the zoom's own `transitionDur` when authored, and
+   * (when the target's `returnToParent` is set) arms an excursion so the
+   * next forward "advance" past the target's range returns here instead of
+   * continuing linearly through the deck.
    */
+  handleZoomClick: (target: ZoomNavigationTarget, returnSlideIndex: number) => void;
+  /** Clear a pending zoom excursion (e.g. when presentation mode ends). */
   clearZoomReturn: () => void;
 }
 /**
  * Sub-hook that manages zoom element navigation in presentation mode.
  *
- * When a zoom element is clicked, this hook:
- * 1. Navigates to the target slide
- * 2. Stores the "return" slide index
- *
- * The caller can later use `returnToZoomSlide()` to navigate back to
- * the summary zoom slide.
+ * The actual "return to zoom" jump is executed by `useSlideNavigation`'s
+ * forward-advance step (it owns the deck's natural next-slide computation);
+ * this hook only arms the excursion `useSlideNavigation` consults, via the
+ * `zoomExcursionRef` both hooks share.
  */
 declare function useZoomNavigation(input: UseZoomNavigationInput): UseZoomNavigationResult;
 //#endregion