pptx-react-viewer 2.3.0 → 2.5.0

package/dist/internals.d.ts

@@ -534,6 +534,62 @@ interface PptxCustomPathProperties {
   customGeometryTextRect?: CustomGeometryTextRect;
 }
 //#endregion
+//#region src/core/types/effect-dag.d.ts
+type EffectDagBlendMode = 'darken' | 'lighten' | 'mult' | 'over' | 'screen';
+type EffectDagContainerType = 'sib' | 'tree';
+type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagAlphaOutset | EffectDagPresetShadow | EffectDagRawLeaf;
+interface EffectDagContainer {
+  kind: 'cont';
+  type: EffectDagContainerType;
+  name?: string;
+  children: EffectDagNode[];
+}
+interface EffectDagBlend {
+  kind: 'blend';
+  mode: EffectDagBlendMode;
+  container: EffectDagContainer;
+}
+interface EffectDagXfrm {
+  kind: 'xfrmEffect';
+  sx?: number;
+  sy?: number;
+  kx?: number;
+  ky?: number;
+  tx?: number;
+  ty?: number;
+}
+interface EffectDagRelOff {
+  kind: 'relOff';
+  tx?: number;
+  ty?: number;
+}
+/** 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';
+  tag: string;
+  xml: Record<string, unknown>;
+}
+//#endregion
 //#region src/core/types/three-d.d.ts
 /**
  * 3-D effect properties, text warp (WordArt) presets, and scene/shape bevel
@@ -764,6 +820,18 @@ interface ShapeStyle {
   /** Original `gradFill` XML retained for unknown-child and extension round-tripping. */
   fillGradientXml?: XmlObject;
   fillMode?: 'solid' | 'gradient' | 'pattern' | 'none' | 'image' | 'theme' | 'group';
+  /**
+   * `<p:sp useBgFill="1">`: the shape paints with the SLIDE BACKGROUND's fill
+   * rather than its own or its theme style's.
+   *
+   * PowerPoint's designer emits full-bleed rectangles this way, and they also
+   * carry an `a:fillRef` pointing at `accent1`. Ignoring the attribute painted
+   * those panels in the accent colour, so a black-and-white title slide came out
+   * black-and-blue. The load pipeline copies the resolved slide background onto
+   * the fill fields; the flag stays for round-trip and for renderers that want
+   * to re-resolve against a changed background.
+   */
+  useBackgroundFill?: boolean;
   fillPatternPreset?: string;
   fillPatternBackgroundColor?: string;
   /** Original `pattFill` XML retained for unknown-child round-tripping. */
@@ -996,6 +1064,15 @@ interface ShapeStyle {
   lineGlowOpacity?: number;
   /** Raw `a:effectDag` XML node preserved for round-trip serialisation. */
   effectDagXml?: XmlObject;
+  /**
+   * Typed effect graph parsed from {@link ShapeStyle.effectDagXml}. The four
+   * structural container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`,
+   * `a:relOff`) are fully typed; any other leaf effect (e.g. `a:outerShdw`,
+   * `a:glow`, `a:alphaInv`) is captured as
+   * {@link import('./effect-dag').EffectDagRawLeaf} so we never have to
+   * recurse into the full effect taxonomy.
+   */
+  effectDagTree?: EffectDagContainer;
   /** Grayscale flag from effectDag `a:grayscl`. */
   dagGrayscale?: boolean;
   /** Bi-level threshold (0-100) from effectDag `a:biLevel`. */
@@ -1430,6 +1507,20 @@ interface TextStyle {
   textPresetShadowDirection?: number;
   /** Text blur effect radius in px (`a:blur`). */
   textBlurRadius?: number;
+  /**
+   * Raw `a:effectDag` XML node from `a:rPr`, preserved verbatim for
+   * round-trip serialisation. Mirrors the shape-level
+   * {@link import('./shape-style').ShapeStyle.effectDagXml} field.
+   */
+  textEffectDagXml?: XmlObject;
+  /**
+   * Typed effect graph parsed from `textEffectDagXml`. The four structural
+   * container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`, `a:relOff`) are
+   * fully typed; any other leaf effect is captured as
+   * {@link import('./effect-dag').EffectDagRawLeaf} so we never have to
+   * recurse into the full effect taxonomy.
+   */
+  textEffectDagTree?: EffectDagContainer;
   /** Text alpha modulation fixed (0-100) from `a:alphaModFix`. */
   textAlphaModFix?: number;
   /** Text alpha modulation from `a:alphaMod` (0-100 percentage). */
@@ -2820,62 +2911,6 @@ interface PptxChartData {
   clrMapOvr?: Record<string, string>;
 }
 //#endregion
-//#region src/core/types/effect-dag.d.ts
-type EffectDagBlendMode = 'darken' | 'lighten' | 'mult' | 'over' | 'screen';
-type EffectDagContainerType = 'sib' | 'tree';
-type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagBlur | EffectDagAlphaOutset | EffectDagPresetShadow | EffectDagRawLeaf;
-interface EffectDagContainer {
-  kind: 'cont';
-  type: EffectDagContainerType;
-  name?: string;
-  children: EffectDagNode[];
-}
-interface EffectDagBlend {
-  kind: 'blend';
-  mode: EffectDagBlendMode;
-  container: EffectDagContainer;
-}
-interface EffectDagXfrm {
-  kind: 'xfrmEffect';
-  sx?: number;
-  sy?: number;
-  kx?: number;
-  ky?: number;
-  tx?: number;
-  ty?: number;
-}
-interface EffectDagRelOff {
-  kind: 'relOff';
-  tx?: number;
-  ty?: number;
-}
-/** 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';
-  tag: string;
-  xml: Record<string, unknown>;
-}
-//#endregion
 //#region src/core/types/image.d.ts
 /**
  * Image recolour/adjustment properties parsed from blip extensions.
@@ -3078,36 +3113,6 @@ interface PptxImageProperties {
   /** Crop-to-shape — CSS clip-path shape name. */
   cropShape?: PptxCropShape;
 }
-declare module "./internals" {
-  interface TextStyle {
-    /**
-     * Raw `a:effectDag` XML node from `a:rPr`, preserved verbatim for
-     * round-trip serialisation. Mirrors the shape-level
-     * {@link import('./shape-style').ShapeStyle.effectDagXml} field.
-     */
-    textEffectDagXml?: XmlObject;
-    /**
-     * Typed effect graph parsed from `textEffectDagXml`. The four structural
-     * container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`, `a:relOff`) are
-     * fully typed; any other leaf effect is captured as
-     * {@link EffectDagRawLeaf} so we never have to recurse into the full
-     * effect taxonomy.
-     */
-    textEffectDagTree?: EffectDagContainer;
-  }
-}
-declare module "./internals" {
-  interface ShapeStyle {
-    /**
-     * Typed effect graph parsed from {@link ShapeStyle.effectDagXml}. The four
-     * structural container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`,
-     * `a:relOff`) are fully typed; any other leaf effect (e.g. `a:outerShdw`,
-     * `a:glow`, `a:alphaInv`) is captured as {@link EffectDagRawLeaf} so we
-     * never have to recurse into the full effect taxonomy.
-     */
-    effectDagTree?: EffectDagContainer;
-  }
-}
 //#endregion
 //#region src/core/types/media.d.ts
 /**
@@ -5174,6 +5179,27 @@ interface PptxNativeAnimation {
   soundPath?: string;
   /** Whether to stop any currently playing sound (`p:endSnd`). */
   stopSound?: boolean;
+  /**
+   * Whether the enclosing click-level group (a direct `p:par` child of the
+   * `mainSeq`) begins automatically when the slide appears, rather than waiting
+   * for a click.
+   *
+   * PowerPoint gates a click step with a lone `<p:cond delay="indefinite"/>`;
+   * a group that also carries a time-node condition (`onBegin`/`onEnd` with a
+   * `@tn`) or a finite delay starts on slide entry ("With/After Previous" as the
+   * first effect on the slide). The flat animation list cannot express that on
+   * its own, so the parse layer stamps it here.
+   */
+  groupAutoStart?: boolean;
+  /**
+   * Index of the enclosing effect-wrapper `p:par` inside the click-level group.
+   *
+   * Effects that share a wrapper are OOXML siblings: they all start when that
+   * wrapper starts, and each `p:cond/@delay` is measured from the wrapper's
+   * start, NOT chained off the effect before it. Playback uses this to place
+   * simultaneous effects at their true offsets instead of accumulating delays.
+   */
+  parGroupIndex?: number;
   /** Structured start conditions parsed from `p:stCondLst`. */
   startConditions?: AnimationCondition[];
   /** Structured end conditions parsed from `p:endCondLst`. */
@@ -6837,7 +6863,6 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 
-//#endregion
 //#region src/core/types/theme-presets.d.ts
 /**
  * A complete theme preset that can be applied to a presentation.
@@ -9471,243 +9496,80 @@ interface ViewerBuildingBlocksResult {
 }
 declare function useViewerBuildingBlocks(input: UseViewerBuildingBlocksInput): ViewerBuildingBlocksResult;
 
-//#region src/viewer/hooks/presentation-mode/types.d.ts
+//#region src/viewer/hooks/useThemeSwitching.d.ts
+interface UseThemeSwitchingInput {
+  /** Ref to the PptxHandler instance. */
+  handlerRef: RefObject<PptxHandler | null>;
+  /** Current parsed presentation data (null when nothing is loaded). */
+  data: PptxData | null;
+  /** Callback to update the presentation data after theme switch. */
+  onDataChange: (newData: PptxData) => void;
+  /** Optional callback fired when theme switch completes successfully. */
+  onThemeChanged?: (preset: PptxThemePreset) => void;
+}
+interface ThemeSwitchingResult {
+  /** All available built-in theme presets. */
+  presets: readonly PptxThemePreset[];
+  /**
+   * Apply a theme preset to the current presentation.
+   * Updates both the in-memory ZIP and all resolved element colours.
+   */
+  switchToPreset: (preset: PptxThemePreset) => Promise<void>;
+  /**
+   * Apply a custom colour scheme (and optional font scheme) to the
+   * current presentation.
+   */
+  switchToCustom: (colorScheme: PptxThemeColorScheme, fontScheme?: PptxThemeFontScheme, themeName?: string) => Promise<void>;
+  /**
+   * Get the preset matching the current presentation theme (if any).
+   * Returns undefined if the current theme does not match a built-in preset.
+   */
+  currentPreset: PptxThemePreset | undefined;
+}
 /**
- * How a forward/backward slide advance was requested.
+ * React hook providing theme switching capabilities for the PowerPoint viewer.
  *
- * - `'click'`: a click/tap on the slide surface (PowerPoint's "On Mouse Click"
- *   advance). This is the only trigger governed by `advanceOnClick`.
- * - `'explicit'`: keyboard, navigation buttons, action triggers, and timed
- *   auto-advance. These always navigate regardless of `advanceOnClick`, matching
- *   PowerPoint (arrow keys / Next always work even when click-advance is off).
+ * @example
+ * ```tsx
+ * const { presets, switchToPreset, currentPreset } = useThemeSwitching({
+ *   handlerRef,
+ *   data,
+ *   onDataChange: setData,
+ * });
+ *
+ * return (
+ *   <div>
+ *     {presets.map(preset => (
+ *       <button
+ *         key={preset.id}
+ *         onClick={() => switchToPreset(preset)}
+ *         aria-pressed={preset.id === currentPreset?.id}
+ *       >
+ *         {preset.name}
+ *       </button>
+ *     ))}
+ *   </div>
+ * );
+ * ```
  */
-type SlideAdvanceTrigger = 'click' | 'explicit';
+declare function useThemeSwitching(input: UseThemeSwitchingInput): ThemeSwitchingResult;
+//#endregion
+//#region ../../node_modules/.bun/lib0@0.2.117/node_modules/lib0/observable.d.ts
 /**
- * State describing the transition overlay that plays while advancing into a
- * slide that carries a `p:transition`. The outgoing slide is snapshotted into
- * an animated overlay layer while the incoming slide renders underneath on the
- * main stage; the overlay tears down once `durationMs` elapses.
+ * Handles named events.
+ *
+ * @deprecated
+ * @template N
  */
-interface PresentationTransitionOverlayState {
-  /** Index of the leaving slide, rendered (animated) in the overlay layer. */
-  outgoingSlideIndex: number;
-  /** Index of the arriving slide, already live on the main stage. */
-  incomingSlideIndex: number;
-  /** The incoming slide's transition definition (drives the CSS animation). */
-  transition: PptxSlideTransition;
-  /** Resolved transition duration (ms). */
-  durationMs: number;
-}
-interface UsePresentationModeInput {
-  mode: ViewerMode;
-  slides: PptxSlide[];
-  visibleSlideIndexes: number[];
-  activeSlideIndex: number;
-  containerRef: React.RefObject<HTMLElement | null>;
-  /** Raw PPTX bytes: forwarded to audience window for content sharing. */
-  content?: ArrayBuffer | Uint8Array | null;
-  onSetMode: (mode: ViewerMode) => void;
-  onSetActiveSlideIndex: (index: number) => void;
+declare class Observable<N> {
   /**
-   * Play a sound file for an action/transition. When `options.loop` is true the
-   * audio repeats until the next animation sound plays or the show exits
-   * (used for transition sounds flagged with `soundLoop`).
+   * Some desc.
+   * @type {Map<N, any>}
    */
-  onPlayActionSound?: (soundPath: string, options?: {
-    loop?: boolean;
-  }) => void;
-  /** Select a pointer tool (Ctrl+L laser, Ctrl+P pen, Ctrl+A arrow, Ctrl+E eraser). */
-  onSetPointerTool?: (tool: PresentationPointerTool | 'arrow') => void;
-  /** Erase the current slide's ink annotations (E). */
-  onEraseAnnotations?: () => void;
-  /** Show or hide ink markup (Ctrl+M). */
-  onToggleInkMarkup?: () => void;
-  /** Show or hide the slide-show chrome (Ctrl+H). */
-  onToggleToolbar?: () => void;
-  /** Open the All Slides navigator (Ctrl+S). */
-  onShowAllSlides?: () => void;
-  /** Called to persist rehearsal timings into slide transitions. */
-  onSaveRehearsalTimings?: (timings: Record<number, number>) => void;
-  /** Whether to loop continuously (kiosk or explicit loop setting). */
-  loopContinuously?: boolean;
-  /** Whether to play animations during the slide show (false = skip all animations). */
-  showWithAnimation?: boolean;
-  /** Whether to use rehearsed auto-advance timings (false = manual advance only). */
-  useTimings?: boolean;
+  _observers: Map<N, any>;
   /**
-   * Options > Advanced > "End with black slide". When true (PowerPoint's
-   * default), advancing past the last slide shows a black end-of-show
-   * screen; the next advance (or a click on it) exits. When false,
-   * advancing past the last slide exits the show directly.
-   */
-  endWithBlackSlide?: boolean;
-}
-interface UsePresentationModeResult {
-  presentationSlideIndex: number;
-  setPresentationSlideIndex: (index: number) => void;
-  presentationSlideVisible: boolean;
-  /** Active slide-transition overlay, or `null` when no transition is playing. */
-  transitionOverlay: PresentationTransitionOverlayState | null;
-  /** Tear down the transition overlay once its animation completes. */
-  handleTransitionOverlayComplete: () => void;
-  presentationAnimations: PresentationAnimationRuntime[];
-  presentationElementStates: Map<string, ElementAnimationState>;
-  presentationKeyframesCss: string;
-  clearPresentationTimers: () => void;
-  runPresentationEntranceAnimations: (slideIndex: number) => void;
-  /** True while the black "End of slide show" screen is displayed. */
-  endOfShowVisible: boolean;
-  /** Whether the All Slides navigator (Ctrl+S) is open during the show. */
-  allSlidesOpen: boolean;
-  openAllSlides: () => void;
-  closeAllSlides: () => void;
-  movePresentationSlide: (direction: 1 | -1, trigger?: SlideAdvanceTrigger) => void;
-  navigateToSlide: (slideIndex: number) => void;
-  handlePresentationAction: (action: PptxAction) => void;
-  /**
-   * Handle a shape click in presentation mode. If the shape is an interactive
-   * trigger, play its animation sequence. Returns `true` if handled.
-   */
-  handleInteractiveShapeClick: (shapeId: string) => boolean;
-  /** Set of shape IDs that are interactive sequence triggers on the current slide. */
-  interactiveTriggerShapeIds: ReadonlySet<string>;
-  /** Set of shape IDs that are hover animation triggers on the current slide. */
-  hoverTriggerShapeIds: ReadonlySet<string>;
-  /** Handle hover start on a shape. If the shape has a hover sequence, play it. Returns `true` if handled. */
-  handleHoverStart: (shapeId: string) => boolean;
-  /** Handle hover end on a shape. Resets the hover sequence for replay. */
-  handleHoverEnd: (shapeId: string) => void;
-  /** Must be called from a user-gesture handler (click) to satisfy browser fullscreen policy. */
-  enterPresentMode: () => void;
-  /** Whether presenter view (split-screen with notes) is active instead of fullscreen. */
-  presenterMode: boolean;
-  /** Enter presenter view mode (no fullscreen, shows notes panel). */
-  enterPresenterView: () => void;
-  /** Toggle between fullscreen and presenter view during presentation. */
-  togglePresenterView: () => void;
-  /** Timestamp (ms) when the presentation started: used for elapsed timer. */
-  presentationStartTime: number | null;
-  /** Whether the current presentation session is in rehearse-timings mode. */
-  rehearsing: boolean;
-  /** Enter rehearse-timings mode (fullscreen presentation + timing HUD). */
-  enterRehearsalMode: () => void;
-  /** Recorded timings in ms, keyed by slide index. Populated during rehearsal. */
-  recordedTimings: Record<number, number>;
-  /** Timestamp when the current slide started (ms since epoch). */
-  slideStartTime: number | null;
-  /** Whether the rehearsal summary dialog should be shown. */
-  showRehearsalSummary: boolean;
-  /** Dismiss the rehearsal summary (discard timings). */
-  dismissRehearsalSummary: () => void;
-  /** Save recorded timings into each slide's transition.advanceAfterMs. */
-  saveRehearsalTimings: () => void;
-  /** Whether rehearsal timer is paused. */
-  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. */
-  clearZoomReturn: () => void;
-  /** Open the audience display in a separate browser window. Returns `true` if successful. */
-  openAudienceWindow: () => boolean;
-  /** Close the audience display window. */
-  closeAudienceWindow: () => void;
-  /** Whether the audience window is currently open. */
-  isAudienceWindowOpen: () => boolean;
-  /** Send a slide index to the audience window explicitly. */
-  syncSlideToAudience: (slideIndex: number) => void;
-  syncStateToAudience: (snapshot: PresentationSnapshot) => void;
-  presenterSnapshot: PresentationSnapshot;
-  setPresenterBlackout: (blackout: PresentationSnapshot['blackout']) => void;
-  togglePresenterTimer: () => void;
-  resetPresenterTimer: () => void;
-  stepPresenterZoom: (direction: 1 | -1) => void;
-  resetPresenterZoom: () => void;
-  setPresenterCaption: (caption: string) => void;
-  setPresenterSubtitlesVisible: (visible: boolean) => void;
-  updatePresenterSnapshot: (patch: Partial<PresentationSnapshot>) => void;
-  swapPresenterDisplays: () => Promise<boolean>;
-}
-//#endregion
-//#region src/viewer/hooks/useThemeSwitching.d.ts
-interface UseThemeSwitchingInput {
-  /** Ref to the PptxHandler instance. */
-  handlerRef: RefObject<PptxHandler | null>;
-  /** Current parsed presentation data (null when nothing is loaded). */
-  data: PptxData | null;
-  /** Callback to update the presentation data after theme switch. */
-  onDataChange: (newData: PptxData) => void;
-  /** Optional callback fired when theme switch completes successfully. */
-  onThemeChanged?: (preset: PptxThemePreset) => void;
-}
-interface ThemeSwitchingResult {
-  /** All available built-in theme presets. */
-  presets: readonly PptxThemePreset[];
-  /**
-   * Apply a theme preset to the current presentation.
-   * Updates both the in-memory ZIP and all resolved element colours.
-   */
-  switchToPreset: (preset: PptxThemePreset) => Promise<void>;
-  /**
-   * Apply a custom colour scheme (and optional font scheme) to the
-   * current presentation.
-   */
-  switchToCustom: (colorScheme: PptxThemeColorScheme, fontScheme?: PptxThemeFontScheme, themeName?: string) => Promise<void>;
-  /**
-   * Get the preset matching the current presentation theme (if any).
-   * Returns undefined if the current theme does not match a built-in preset.
-   */
-  currentPreset: PptxThemePreset | undefined;
-}
-/**
- * React hook providing theme switching capabilities for the PowerPoint viewer.
- *
- * @example
- * ```tsx
- * const { presets, switchToPreset, currentPreset } = useThemeSwitching({
- *   handlerRef,
- *   data,
- *   onDataChange: setData,
- * });
- *
- * return (
- *   <div>
- *     {presets.map(preset => (
- *       <button
- *         key={preset.id}
- *         onClick={() => switchToPreset(preset)}
- *         aria-pressed={preset.id === currentPreset?.id}
- *       >
- *         {preset.name}
- *       </button>
- *     ))}
- *   </div>
- * );
- * ```
- */
-declare function useThemeSwitching(input: UseThemeSwitchingInput): ThemeSwitchingResult;
-//#endregion
-//#region ../../node_modules/.bun/lib0@0.2.117/node_modules/lib0/observable.d.ts
-/**
- * Handles named events.
- *
- * @deprecated
- * @template N
- */
-declare class Observable<N> {
-  /**
-   * Some desc.
-   * @type {Map<N, any>}
-   */
-  _observers: Map<N, any>;
-  /**
-   * @param {N} name
-   * @param {function} f
+   * @param {N} name
+   * @param {function} f
    */
   on(name: N, f: Function): void;
   /**
@@ -9986,67 +9848,149 @@ interface UseFollowModeResult {
   followUser: (clientId: number | null) => void;
 }
 declare function useFollowMode({ collab, activeSlideIndex, setActiveSlideIndex, slideCount }: UseFollowModeInput): UseFollowModeResult;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useAnimationPlayback.d.ts
-interface UseAnimationPlaybackInput {
+interface UsePresenterWindowInput {
+  currentSlideIndex: number;
+  isPresenterMode: boolean;
+  /** Raw PPTX bytes to share with the audience tab via IndexedDB. */
+  content?: ArrayBuffer | Uint8Array | null;
+  snapshot: PresentationSnapshot;
+}
+interface UsePresenterWindowResult {
+  openAudienceWindow: () => boolean;
+  closeAudienceWindow: () => void;
+  isAudienceWindowOpen: () => boolean;
+  syncSlideToAudience: (slideIndex: number) => void;
+  syncStateToAudience: (snapshot: PresentationSnapshot) => void;
+  swapDisplays: () => Promise<boolean>;
+}
+declare function usePresenterWindow(input: UsePresenterWindowInput): UsePresenterWindowResult;
+
+//#region src/viewer/hooks/useEditorHistory.d.ts
+interface EditorHistoryInput {
   slides: PptxSlide[];
-  onPlayActionSound?: (soundPath: string) => void;
-  /** When false, all animations are skipped (elements shown immediately). */
-  showWithAnimation?: boolean;
+  canvasSize: CanvasSize;
+  activeSlideIndex: number;
+  templateElementsBySlideId: Record<string, PptxElement[]>;
+  selectedElementId: string | null;
+  selectedElementIds: string[];
+  editTemplateMode: boolean;
+  headerFooter: PptxHeaderFooter;
+  loading: boolean;
+  error: string | null;
+  /**
+   * Undo-stack depth (File > Options > Advanced > "Maximum number of undos",
+   * resolved via the shared `resolveHistoryDepth`). Defaults to 120.
+   */
+  maxHistoryEntries?: number;
+  hasActivePointerInteraction: () => boolean;
+  pointerCommitNonce: number;
+  setSlides: (slides: PptxSlide[]) => void;
+  setCanvasSize: (size: CanvasSize) => void;
+  setActiveSlideIndex: (index: number) => void;
+  setTemplateElementsBySlideId: (map: Record<string, PptxElement[]>) => void;
+  setSelectedElementId: (id: string | null) => void;
+  setSelectedElementIds: (ids: string[]) => void;
+  setEditTemplateMode: (mode: boolean) => void;
+  setHeaderFooter: (hf: PptxHeaderFooter) => void;
 }
-interface UseAnimationPlaybackResult {
-  presentationAnimations: PresentationAnimationRuntime[];
-  presentationElementStates: Map<string, ElementAnimationState>;
-  presentationKeyframesCss: string;
-  interactiveTriggerShapeIds: ReadonlySet<string>;
-  hoverTriggerShapeIds: ReadonlySet<string>;
-  clearPresentationTimers: () => void;
-  playNextAnimationGroup: () => boolean;
-  handleInteractiveShapeClick: (shapeId: string) => boolean;
-  handleHoverStart: (shapeId: string) => boolean;
-  handleHoverEnd: (shapeId: string) => void;
-  runPresentationEntranceAnimations: (slideIndex: number) => void;
-  /** Exposed so the orchestrator can schedule additional timers (e.g. auto-advance). */
-  presentationTimersRef: React.RefObject<number[]>;
+interface EditorHistoryResult {
+  canUndo: boolean;
+  canRedo: boolean;
+  undoLabel: string | undefined;
+  redoLabel: string | undefined;
+  handleUndo: () => void;
+  handleRedo: () => void;
+  resetHistory: () => void;
+  markDirty: () => void;
+  buildHistorySnapshot: (actionLabel?: string) => EditorHistorySnapshot;
 }
-declare function useAnimationPlayback(input: UseAnimationPlaybackInput): UseAnimationPlaybackResult;
+declare function useEditorHistory(input: EditorHistoryInput): EditorHistoryResult;
 //#endregion
-//#region src/viewer/hooks/presentation-mode/useRehearsalTimings.d.ts
-interface UseRehearsalTimingsInput {
-  containerRef: React.RefObject<HTMLElement | null>;
-  onSetMode: (mode: ViewerMode) => void;
-  onSaveRehearsalTimings?: (timings: Record<number, number>) => void;
-  setPresentationStartTime: (time: number | null) => void;
-  setPresenterMode: (mode: boolean) => void;
+//#region src/viewer/hooks/useZoomViewport.d.ts
+/** Axis-aligned bounding box used by zoom / viewport helpers. */
+interface SelectionBounds {
+  minX: number;
+  minY: number;
+  maxX: number;
+  maxY: number;
 }
-interface UseRehearsalTimingsResult {
-  rehearsing: boolean;
-  setRehearsing: React.Dispatch<React.SetStateAction<boolean>>;
-  recordedTimings: Record<number, number>;
-  slideStartTime: number | null;
-  showRehearsalSummary: boolean;
-  setShowRehearsalSummary: React.Dispatch<React.SetStateAction<boolean>>;
-  rehearsalPaused: boolean;
-  recordCurrentSlideTime: (slideIndex: number) => void;
-  dismissRehearsalSummary: () => void;
-  saveRehearsalTimings: () => void;
-  enterRehearsalMode: () => void;
-  toggleRehearsalPause: () => void;
+interface UseZoomViewportInput {
+  canvasSize: CanvasSize;
+  selectedElements: PptxElement[];
 }
-declare function useRehearsalTimings(input: UseRehearsalTimingsInput): UseRehearsalTimingsResult;
+interface UseZoomViewportResult {
+  editWrapperRef: React.RefObject<HTMLDivElement | null>;
+  canvasStageRef: React.RefObject<HTMLDivElement | null>;
+  canvasViewportRef: React.RefObject<HTMLDivElement | null>;
+  renderScaleRef: React.MutableRefObject<number>;
+  scale: number;
+  setScale: (scale: number) => void;
+  editorDimensions: CanvasSize | null;
+  setEditorDimensions: (dims: CanvasSize | null) => void;
+  fitScale: number;
+  editorScale: number;
+  handleZoomIn: () => void;
+  handleZoomOut: () => void;
+  handleResetZoom: () => void;
+  handleZoomToFit: () => void;
+  handleZoomToSelection: () => void;
+  handleWheel: (e: WheelEvent) => void;
+  centerBoundsInViewport: (bounds: SelectionBounds, nextScale: number) => void;
+  getCanvasPointFromClient: (clientX: number, clientY: number) => {
+    x: number;
+    y: number;
+  } | null;
+}
+declare function useZoomViewport({ canvasSize, selectedElements }: UseZoomViewportInput): UseZoomViewportResult;
 //#endregion
-//#region src/viewer/hooks/presentation-mode/usePresentationKeyboard.d.ts
-interface UsePresentationKeyboardInput {
+//#region src/viewer/hooks/presentation-mode/types.d.ts
+/**
+ * How a forward/backward slide advance was requested.
+ *
+ * - `'click'`: a click/tap on the slide surface (PowerPoint's "On Mouse Click"
+ *   advance). This is the only trigger governed by `advanceOnClick`.
+ * - `'explicit'`: keyboard, navigation buttons, action triggers, and timed
+ *   auto-advance. These always navigate regardless of `advanceOnClick`, matching
+ *   PowerPoint (arrow keys / Next always work even when click-advance is off).
+ */
+type SlideAdvanceTrigger = 'click' | 'explicit';
+/**
+ * State describing the transition overlay that plays while advancing into a
+ * slide that carries a `p:transition`. The outgoing slide is snapshotted into
+ * an animated overlay layer while the incoming slide renders underneath on the
+ * main stage; the overlay tears down once `durationMs` elapses.
+ */
+interface PresentationTransitionOverlayState {
+  /** Index of the leaving slide, rendered (animated) in the overlay layer. */
+  outgoingSlideIndex: number;
+  /** Index of the arriving slide, already live on the main stage. */
+  incomingSlideIndex: number;
+  /** The incoming slide's transition definition (drives the CSS animation). */
+  transition: PptxSlideTransition;
+  /** Resolved transition duration (ms). */
+  durationMs: number;
+}
+interface UsePresentationModeInput {
   mode: ViewerMode;
-  movePresentationSlide: (direction: 1 | -1) => void;
-  /** Jump to a 0-based slide index (Home / End / typed slide number). */
-  navigateToSlide: (index: number) => void;
-  /** Total slide count, so End can resolve the last slide. */
-  slideCount: number;
+  slides: PptxSlide[];
+  visibleSlideIndexes: number[];
+  activeSlideIndex: number;
+  containerRef: React.RefObject<HTMLElement | null>;
+  /** Raw PPTX bytes: forwarded to audience window for content sharing. */
+  content?: ArrayBuffer | Uint8Array | null;
   onSetMode: (mode: ViewerMode) => void;
-  /** Select a pointer tool (Ctrl+L / Ctrl+P / Ctrl+A / Ctrl+E). */
+  onSetActiveSlideIndex: (index: number) => void;
+  /**
+   * Play a sound file for an action/transition. When `options.loop` is true the
+   * audio repeats until the next animation sound plays or the show exits
+   * (used for transition sounds flagged with `soundLoop`).
+   */
+  onPlayActionSound?: (soundPath: string, options?: {
+    loop?: boolean;
+  }) => void;
+  /** Select a pointer tool (Ctrl+L laser, Ctrl+P pen, Ctrl+A arrow, Ctrl+E eraser). */
   onSetPointerTool?: (tool: PresentationPointerTool | 'arrow') => void;
-  /** Erase this slide's ink annotations (E). */
+  /** Erase the current slide's ink annotations (E). */
   onEraseAnnotations?: () => void;
   /** Show or hide ink markup (Ctrl+M). */
   onToggleInkMarkup?: () => void;
@@ -10054,168 +9998,113 @@ interface UsePresentationKeyboardInput {
   onToggleToolbar?: () => void;
   /** Open the All Slides navigator (Ctrl+S). */
   onShowAllSlides?: () => void;
-  onToggleBlackScreen?: () => void;
-  onToggleWhiteScreen?: () => void;
-  rehearsing: boolean;
-  recordCurrentSlideTime: (slideIndex: number) => void;
-  presentationSlideIndex: number;
-  setShowRehearsalSummary: (value: boolean) => void;
-}
-/**
- * Registers PowerPoint's slide-show shortcuts while a show is running.
- *
- * The key-to-action mapping lives in `pptx-viewer-shared` so every binding
- * resolves the same chords; this hook only performs the resulting actions.
- */
-declare function usePresentationKeyboard(input: UsePresentationKeyboardInput): void;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useSlideNavigation.d.ts
-interface UseSlideNavigationInput {
-  slides: PptxSlide[];
-  visibleSlideIndexes: number[];
-  presentationSlideIndex: number;
-  setPresentationSlideIndex: (index: number) => void;
-  setPresentationSlideVisible: (visible: boolean) => void;
-  setTransitionOverlay: (state: PresentationTransitionOverlayState | null) => void;
-  onSetMode: (mode: ViewerMode) => void;
-  onSetActiveSlideIndex: (index: number) => void;
-  onPlayActionSound?: (soundPath: string) => void;
+  /** Called to persist rehearsal timings into slide transitions. */
+  onSaveRehearsalTimings?: (timings: Record<number, number>) => void;
+  /** Whether to loop continuously (kiosk or explicit loop setting). */
   loopContinuously?: boolean;
-  /** Whether to use rehearsed auto-advance timings. When false, slides advance only on click. */
+  /** Whether to play animations during the slide show (false = skip all animations). */
+  showWithAnimation?: boolean;
+  /** Whether to use rehearsed auto-advance timings (false = manual advance only). */
   useTimings?: boolean;
   /**
-   * Fired when the user advances past the last slide (no loop, no rehearsal).
-   * The presentation-mode hook uses it for PowerPoint's "End with black
-   * slide" behavior. When absent, advancing past the end clamps as before.
+   * Options > Advanced > "End with black slide". When true (PowerPoint's
+   * default), advancing past the last slide shows a black end-of-show
+   * screen; the next advance (or a click on it) exits. When false,
+   * advancing past the last slide exits the show directly.
    */
-  onAdvancePastLastSlide?: () => void;
-  playNextAnimationGroup: () => boolean;
+  endWithBlackSlide?: boolean;
+}
+interface UsePresentationModeResult {
+  presentationSlideIndex: number;
+  setPresentationSlideIndex: (index: number) => void;
+  presentationSlideVisible: boolean;
+  /** Active slide-transition overlay, or `null` when no transition is playing. */
+  transitionOverlay: PresentationTransitionOverlayState | null;
+  /** Tear down the transition overlay once its animation completes. */
+  handleTransitionOverlayComplete: () => void;
+  presentationAnimations: PresentationAnimationRuntime[];
+  presentationElementStates: Map<string, ElementAnimationState>;
+  presentationKeyframesCss: string;
   clearPresentationTimers: () => void;
   runPresentationEntranceAnimations: (slideIndex: number) => void;
-  presentationTimersRef: {
-    current: number[];
-  };
-  rehearsing: boolean;
-  recordCurrentSlideTime: (slideIndex: number) => void;
-  setShowRehearsalSummary: (value: boolean) => void;
-}
-interface UseSlideNavigationResult {
+  /** True while the black "End of slide show" screen is displayed. */
+  endOfShowVisible: boolean;
+  /** Whether the All Slides navigator (Ctrl+S) is open during the show. */
+  allSlidesOpen: boolean;
+  openAllSlides: () => void;
+  closeAllSlides: () => void;
   movePresentationSlide: (direction: 1 | -1, trigger?: SlideAdvanceTrigger) => void;
   navigateToSlide: (slideIndex: number) => void;
   handlePresentationAction: (action: PptxAction) => void;
-  scheduleAutoAdvanceForSlide: (slideIndex: number) => void;
-}
-declare function useSlideNavigation(input: UseSlideNavigationInput): UseSlideNavigationResult;
-interface UsePresenterWindowInput {
-  currentSlideIndex: number;
-  isPresenterMode: boolean;
-  /** Raw PPTX bytes to share with the audience tab via IndexedDB. */
-  content?: ArrayBuffer | Uint8Array | null;
-  snapshot: PresentationSnapshot;
-}
-interface UsePresenterWindowResult {
+  /**
+   * Handle a shape click in presentation mode. If the shape is an interactive
+   * trigger, play its animation sequence. Returns `true` if handled.
+   */
+  handleInteractiveShapeClick: (shapeId: string) => boolean;
+  /** Set of shape IDs that are interactive sequence triggers on the current slide. */
+  interactiveTriggerShapeIds: ReadonlySet<string>;
+  /** Set of shape IDs that are hover animation triggers on the current slide. */
+  hoverTriggerShapeIds: ReadonlySet<string>;
+  /** Handle hover start on a shape. If the shape has a hover sequence, play it. Returns `true` if handled. */
+  handleHoverStart: (shapeId: string) => boolean;
+  /** Handle hover end on a shape. Resets the hover sequence for replay. */
+  handleHoverEnd: (shapeId: string) => void;
+  /** Must be called from a user-gesture handler (click) to satisfy browser fullscreen policy. */
+  enterPresentMode: () => void;
+  /** Whether presenter view (split-screen with notes) is active instead of fullscreen. */
+  presenterMode: boolean;
+  /** Enter presenter view mode (no fullscreen, shows notes panel). */
+  enterPresenterView: () => void;
+  /** Toggle between fullscreen and presenter view during presentation. */
+  togglePresenterView: () => void;
+  /** Timestamp (ms) when the presentation started: used for elapsed timer. */
+  presentationStartTime: number | null;
+  /** Whether the current presentation session is in rehearse-timings mode. */
+  rehearsing: boolean;
+  /** Enter rehearse-timings mode (fullscreen presentation + timing HUD). */
+  enterRehearsalMode: () => void;
+  /** Recorded timings in ms, keyed by slide index. Populated during rehearsal. */
+  recordedTimings: Record<number, number>;
+  /** Timestamp when the current slide started (ms since epoch). */
+  slideStartTime: number | null;
+  /** Whether the rehearsal summary dialog should be shown. */
+  showRehearsalSummary: boolean;
+  /** Dismiss the rehearsal summary (discard timings). */
+  dismissRehearsalSummary: () => void;
+  /** Save recorded timings into each slide's transition.advanceAfterMs. */
+  saveRehearsalTimings: () => void;
+  /** Whether rehearsal timer is paused. */
+  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. */
+  clearZoomReturn: () => void;
+  /** Open the audience display in a separate browser window. Returns `true` if successful. */
   openAudienceWindow: () => boolean;
+  /** Close the audience display window. */
   closeAudienceWindow: () => void;
+  /** Whether the audience window is currently open. */
   isAudienceWindowOpen: () => boolean;
+  /** Send a slide index to the audience window explicitly. */
   syncSlideToAudience: (slideIndex: number) => void;
   syncStateToAudience: (snapshot: PresentationSnapshot) => void;
-  swapDisplays: () => Promise<boolean>;
-}
-declare function usePresenterWindow(input: UsePresenterWindowInput): UsePresenterWindowResult;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useAudienceMode.d.ts
-interface UseAudienceModeInput {
-  mode: ViewerMode;
-  onSetMode: (mode: ViewerMode) => void;
-  onSetActiveSlideIndex: (index: number) => void;
-  containerRef: React.RefObject<HTMLElement | null>;
-  onSnapshot?: (snapshot: PresentationSnapshot) => void;
-}
-/**
- * When the page was opened with the `#pptx-audience` hash, this hook:
- * 1. Auto-enters fullscreen presentation mode after content loads
- * 2. Listens on BroadcastChannel for slide-change messages from the presenter
- * 3. Exits presentation mode when the presenter sends an exit signal
- */
-declare function useAudienceMode(input: UseAudienceModeInput): void;
-
-//#region src/viewer/hooks/useEditorHistory.d.ts
-interface EditorHistoryInput {
-  slides: PptxSlide[];
-  canvasSize: CanvasSize;
-  activeSlideIndex: number;
-  templateElementsBySlideId: Record<string, PptxElement[]>;
-  selectedElementId: string | null;
-  selectedElementIds: string[];
-  editTemplateMode: boolean;
-  headerFooter: PptxHeaderFooter;
-  loading: boolean;
-  error: string | null;
-  /**
-   * Undo-stack depth (File > Options > Advanced > "Maximum number of undos",
-   * resolved via the shared `resolveHistoryDepth`). Defaults to 120.
-   */
-  maxHistoryEntries?: number;
-  hasActivePointerInteraction: () => boolean;
-  pointerCommitNonce: number;
-  setSlides: (slides: PptxSlide[]) => void;
-  setCanvasSize: (size: CanvasSize) => void;
-  setActiveSlideIndex: (index: number) => void;
-  setTemplateElementsBySlideId: (map: Record<string, PptxElement[]>) => void;
-  setSelectedElementId: (id: string | null) => void;
-  setSelectedElementIds: (ids: string[]) => void;
-  setEditTemplateMode: (mode: boolean) => void;
-  setHeaderFooter: (hf: PptxHeaderFooter) => void;
-}
-interface EditorHistoryResult {
-  canUndo: boolean;
-  canRedo: boolean;
-  undoLabel: string | undefined;
-  redoLabel: string | undefined;
-  handleUndo: () => void;
-  handleRedo: () => void;
-  resetHistory: () => void;
-  markDirty: () => void;
-  buildHistorySnapshot: (actionLabel?: string) => EditorHistorySnapshot;
-}
-declare function useEditorHistory(input: EditorHistoryInput): EditorHistoryResult;
-//#endregion
-//#region src/viewer/hooks/useZoomViewport.d.ts
-/** Axis-aligned bounding box used by zoom / viewport helpers. */
-interface SelectionBounds {
-  minX: number;
-  minY: number;
-  maxX: number;
-  maxY: number;
-}
-interface UseZoomViewportInput {
-  canvasSize: CanvasSize;
-  selectedElements: PptxElement[];
-}
-interface UseZoomViewportResult {
-  editWrapperRef: React.RefObject<HTMLDivElement | null>;
-  canvasStageRef: React.RefObject<HTMLDivElement | null>;
-  canvasViewportRef: React.RefObject<HTMLDivElement | null>;
-  renderScaleRef: React.MutableRefObject<number>;
-  scale: number;
-  setScale: (scale: number) => void;
-  editorDimensions: CanvasSize | null;
-  setEditorDimensions: (dims: CanvasSize | null) => void;
-  fitScale: number;
-  editorScale: number;
-  handleZoomIn: () => void;
-  handleZoomOut: () => void;
-  handleResetZoom: () => void;
-  handleZoomToFit: () => void;
-  handleZoomToSelection: () => void;
-  handleWheel: (e: WheelEvent) => void;
-  centerBoundsInViewport: (bounds: SelectionBounds, nextScale: number) => void;
-  getCanvasPointFromClient: (clientX: number, clientY: number) => {
-    x: number;
-    y: number;
-  } | null;
+  presenterSnapshot: PresentationSnapshot;
+  setPresenterBlackout: (blackout: PresentationSnapshot['blackout']) => void;
+  togglePresenterTimer: () => void;
+  resetPresenterTimer: () => void;
+  stepPresenterZoom: (direction: 1 | -1) => void;
+  resetPresenterZoom: () => void;
+  setPresenterCaption: (caption: string) => void;
+  setPresenterSubtitlesVisible: (visible: boolean) => void;
+  updatePresenterSnapshot: (patch: Partial<PresentationSnapshot>) => void;
+  swapPresenterDisplays: () => Promise<boolean>;
 }
-declare function useZoomViewport({ canvasSize, selectedElements }: UseZoomViewportInput): UseZoomViewportResult;
 //#endregion
 //#region src/viewer/hooks/usePresentationMode.d.ts
 declare function usePresentationMode(input: UsePresentationModeInput): UsePresentationModeResult;
@@ -12150,6 +12039,144 @@ interface UseSwipeNavigationResult {
 }
 declare function useSwipeNavigation(input: UseSwipeNavigationInput): UseSwipeNavigationResult;
 //#endregion
+//#region src/viewer/hooks/presentation-mode/useAnimationPlayback.d.ts
+interface UseAnimationPlaybackInput {
+  slides: PptxSlide[];
+  onPlayActionSound?: (soundPath: string) => void;
+  /** When false, all animations are skipped (elements shown immediately). */
+  showWithAnimation?: boolean;
+}
+/** How a slide's animation timeline should be seeded when it becomes active. */
+interface SeedSlideAnimationOptions {
+  /**
+   * Seed the slide as fully built instead of playing it from the start.
+   *
+   * PowerPoint shows a slide you step BACKWARD onto with its builds already
+   * complete; a further back press then walks them off. Replaying from zero
+   * made a deck whose opening build auto-starts restart every time the
+   * presenter stepped back onto it.
+   */
+  completed?: boolean;
+}
+interface UseAnimationPlaybackResult {
+  presentationAnimations: PresentationAnimationRuntime[];
+  presentationElementStates: Map<string, ElementAnimationState>;
+  presentationKeyframesCss: string;
+  interactiveTriggerShapeIds: ReadonlySet<string>;
+  hoverTriggerShapeIds: ReadonlySet<string>;
+  clearPresentationTimers: () => void;
+  playNextAnimationGroup: () => boolean;
+  handleInteractiveShapeClick: (shapeId: string) => boolean;
+  handleHoverStart: (shapeId: string) => boolean;
+  handleHoverEnd: (shapeId: string) => void;
+  runPresentationEntranceAnimations: (slideIndex: number, options?: SeedSlideAnimationOptions) => void;
+  /**
+   * True while the active slide is showing its builds as already complete
+   * because the presenter stepped backward onto it. The next backward press
+   * replays the slide instead of leaving it (PowerPoint's behaviour).
+   */
+  isSeededCompleted: () => boolean;
+  /** Exposed so the orchestrator can schedule additional timers (e.g. auto-advance). */
+  presentationTimersRef: React.RefObject<number[]>;
+}
+declare function useAnimationPlayback(input: UseAnimationPlaybackInput): UseAnimationPlaybackResult;
+//#endregion
+//#region src/viewer/hooks/presentation-mode/useRehearsalTimings.d.ts
+interface UseRehearsalTimingsInput {
+  containerRef: React.RefObject<HTMLElement | null>;
+  onSetMode: (mode: ViewerMode) => void;
+  onSaveRehearsalTimings?: (timings: Record<number, number>) => void;
+  setPresentationStartTime: (time: number | null) => void;
+  setPresenterMode: (mode: boolean) => void;
+}
+interface UseRehearsalTimingsResult {
+  rehearsing: boolean;
+  setRehearsing: React.Dispatch<React.SetStateAction<boolean>>;
+  recordedTimings: Record<number, number>;
+  slideStartTime: number | null;
+  showRehearsalSummary: boolean;
+  setShowRehearsalSummary: React.Dispatch<React.SetStateAction<boolean>>;
+  rehearsalPaused: boolean;
+  recordCurrentSlideTime: (slideIndex: number) => void;
+  dismissRehearsalSummary: () => void;
+  saveRehearsalTimings: () => void;
+  enterRehearsalMode: () => void;
+  toggleRehearsalPause: () => void;
+}
+declare function useRehearsalTimings(input: UseRehearsalTimingsInput): UseRehearsalTimingsResult;
+//#endregion
+//#region src/viewer/hooks/presentation-mode/usePresentationKeyboard.d.ts
+interface UsePresentationKeyboardInput {
+  mode: ViewerMode;
+  movePresentationSlide: (direction: 1 | -1) => void;
+  /** Jump to a 0-based slide index (Home / End / typed slide number). */
+  navigateToSlide: (index: number) => void;
+  /** Total slide count, so End can resolve the last slide. */
+  slideCount: number;
+  onSetMode: (mode: ViewerMode) => void;
+  /** Select a pointer tool (Ctrl+L / Ctrl+P / Ctrl+A / Ctrl+E). */
+  onSetPointerTool?: (tool: PresentationPointerTool | 'arrow') => void;
+  /** Erase this slide's ink annotations (E). */
+  onEraseAnnotations?: () => void;
+  /** Show or hide ink markup (Ctrl+M). */
+  onToggleInkMarkup?: () => void;
+  /** Show or hide the slide-show chrome (Ctrl+H). */
+  onToggleToolbar?: () => void;
+  /** Open the All Slides navigator (Ctrl+S). */
+  onShowAllSlides?: () => void;
+  onToggleBlackScreen?: () => void;
+  onToggleWhiteScreen?: () => void;
+  rehearsing: boolean;
+  recordCurrentSlideTime: (slideIndex: number) => void;
+  presentationSlideIndex: number;
+  setShowRehearsalSummary: (value: boolean) => void;
+}
+/**
+ * Registers PowerPoint's slide-show shortcuts while a show is running.
+ *
+ * The key-to-action mapping lives in `pptx-viewer-shared` so every binding
+ * resolves the same chords; this hook only performs the resulting actions.
+ */
+declare function usePresentationKeyboard(input: UsePresentationKeyboardInput): void;
+//#endregion
+//#region src/viewer/hooks/presentation-mode/useSlideNavigation.d.ts
+interface UseSlideNavigationInput {
+  slides: PptxSlide[];
+  visibleSlideIndexes: number[];
+  presentationSlideIndex: number;
+  setPresentationSlideIndex: (index: number) => void;
+  setPresentationSlideVisible: (visible: boolean) => void;
+  setTransitionOverlay: (state: PresentationTransitionOverlayState | null) => void;
+  onSetMode: (mode: ViewerMode) => void;
+  onSetActiveSlideIndex: (index: number) => void;
+  onPlayActionSound?: (soundPath: string) => void;
+  loopContinuously?: boolean;
+  /** Whether to use rehearsed auto-advance timings. When false, slides advance only on click. */
+  useTimings?: boolean;
+  /**
+   * Fired when the user advances past the last slide (no loop, no rehearsal).
+   * The presentation-mode hook uses it for PowerPoint's "End with black
+   * slide" behavior. When absent, advancing past the end clamps as before.
+   */
+  onAdvancePastLastSlide?: () => void;
+  playNextAnimationGroup: () => boolean;
+  clearPresentationTimers: () => void;
+  runPresentationEntranceAnimations: (slideIndex: number) => void;
+  presentationTimersRef: {
+    current: number[];
+  };
+  rehearsing: boolean;
+  recordCurrentSlideTime: (slideIndex: number) => void;
+  setShowRehearsalSummary: (value: boolean) => void;
+}
+interface UseSlideNavigationResult {
+  movePresentationSlide: (direction: 1 | -1, trigger?: SlideAdvanceTrigger) => void;
+  navigateToSlide: (slideIndex: number) => void;
+  handlePresentationAction: (action: PptxAction) => void;
+  scheduleAutoAdvanceForSlide: (slideIndex: number) => void;
+}
+declare function useSlideNavigation(input: UseSlideNavigationInput): UseSlideNavigationResult;
+//#endregion
 //#region src/viewer/hooks/presentation-mode/useZoomNavigation.d.ts
 /**
  * Input for the useZoomNavigation sub-hook.
@@ -12194,6 +12221,28 @@ interface UseZoomNavigationResult {
  * the summary zoom slide.
  */
 declare function useZoomNavigation(input: UseZoomNavigationInput): UseZoomNavigationResult;
+//#endregion
+//#region src/viewer/hooks/presentation-mode/useAudienceMode.d.ts
+interface UseAudienceModeInput {
+  mode: ViewerMode;
+  onSetMode: (mode: ViewerMode) => void;
+  onSetActiveSlideIndex: (index: number) => void;
+  containerRef: React.RefObject<HTMLElement | null>;
+  onSnapshot?: (snapshot: PresentationSnapshot) => void;
+  /**
+   * Raise the end-of-slide-show screen. Called when the presenter ends the
+   * session and the browser refuses to close this tab: the audience must see
+   * the black end screen, never the editor.
+   */
+  onPresenterEnded?: () => void;
+}
+/**
+ * When the page was opened with the `#pptx-audience` hash, this hook:
+ * 1. Auto-enters fullscreen presentation mode after content loads
+ * 2. Listens on BroadcastChannel for slide-change messages from the presenter
+ * 3. Exits presentation mode when the presenter sends an exit signal
+ */
+declare function useAudienceMode(input: UseAudienceModeInput): void;
 
 export { MIN_TOUCH_TARGET, MOBILE_BREAKPOINT, TABLET_BREAKPOINT, computeToolbarVisibility, computeVirtualRange, useAnimationPlayback, useAnnotationHandlers, useAudienceMode, useAutosave, useBroadcastFollower, useCanvasInteractions, useClipboardHandlers, useCollaborativeHistory, useCollaborativeState, useComments, useContentLifecycle, useDerivedElementState, useDerivedSlideState, useDialogCustomShows, useEditorHistory, useEditorOperations, useElementManipulation, useElementOperations, useExportHandlers, useExportSaveAs, useFindReplace, useFollowMode, useFontInjection, useGroupAlignLayerHandlers, useIOHandlers, useInsertElements, useIsMobile, useKeyboardInsets, useKeyboardShortcutWiring, useKeyboardShortcuts, useLayoutSwitching, useLoadContent, useMergeShapesHandler, useModalDismissDrag, usePointerHandlers, usePresenceTracking, usePresentationAnnotations, usePresentationKeyboard, usePresentationMode, usePresentationSetup, usePresenterWindow, usePrintHandlers, usePropertyHandlers, useRecoveryDetection, useReducedMotion, useRehearsalTimings, useResizablePanels, useSectionOperations, useSerialize, useSheetDismissDrag, useSlideManagement, useSlideNavigation, useSwipeNavigation, useTableOperations, useThemeHandlers, useThemeSwitching, useToolbarVisibility, useTouchGestures, useViewerBuildingBlocks, useViewerCoreState, useViewerDialogs, useViewerIntegration, useViewerOptions, useViewerState, useViewerUIState, useVirtualizedSlides, useYjsDocumentSync, useYjsProvider, useZoomNavigation, useZoomViewport };
 export type { AnnotationHandlersResult, AnnotationStroke, AutosaveStatus, CanvasInteractionHandlers, CollaborationConfig, CollaborationContextValue, ConnectionStatus, ContentLifecycleResult, DerivedElementState, DerivedSlideState, DeviceOrientation, EditorHistoryInput, EditorHistoryResult, EditorOperationsResult, ElementManipulationHandlers, ElementOperations, ExportHandlersResult, ExportSaveAsResult, IOHandlersResult, InsertElementHandlers, LayoutSwitchingResult, MergeShapesHandlerInput, MergeShapesHandlers, ModalDismissDrag, ModalDismissDragHandlers, PresentationSetupResult, PresentationTool, PrintHandlersResult, PropertyHandlersResult, SectionOperations, SheetDismissDrag, SheetDismissDragHandlers, SlideManagementHandlers, TableOperationHandlers, ThemeHandlersResult, ThemeSwitchingResult, ToolbarVisibility, TouchGestureCallbacks, UseAnimationPlaybackInput, UseAnimationPlaybackResult, UseAnnotationHandlersInput, UseAutosaveInput, UseAutosaveResult, UseBroadcastFollowerInput, UseCanvasInteractionsInput, UseCollaborativeHistoryInput, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UseContentLifecycleInput, UseDerivedElementStateInput, UseDerivedSlideStateInput, UseDialogCustomShowsInput, UseDialogCustomShowsResult, UseEditorOperationsInput, UseElementManipulationInput, UseElementOperationsInput, UseExportHandlersInput, UseExportSaveAsInput, UseFollowModeInput, UseFollowModeResult, UseFontInjectionInput, UseIOHandlersInput, UseInsertElementsInput, UseIsMobileInput, UseIsMobileResult, UseKeyboardInsetsResult, UseKeyboardShortcutWiringInput, UseKeyboardShortcutsInput, UseLayoutSwitchingInput, UseLoadContentInput, UseLoadContentResult, UsePointerHandlersInput, UsePresenceTrackingInput, UsePresenceTrackingResult, UsePresentationAnnotationsResult, UsePresentationSetupInput, UsePresenterWindowInput, UsePresenterWindowResult, UsePrintHandlersInput, UsePropertyHandlersInput, UseRecoveryDetectionInput, UseReducedMotionResult, UseRehearsalTimingsInput, UseRehearsalTimingsResult, UseResizablePanelsResult, UseSectionOperationsInput, UseSerializeInput, UseSlideManagementInput, UseSlideNavigationInput, UseSlideNavigationResult, UseSwipeNavigationInput, UseSwipeNavigationResult, UseTableOperationsInput, UseThemeHandlersInput, UseThemeSwitchingInput, UseTouchGesturesInput, UseViewerBuildingBlocksInput, UseViewerCoreStateInput, UseViewerDialogsInput, UseViewerIntegrationInput, UseViewerOptionsResult, UseViewerStateInput, UseYjsDocumentSyncInput, UseYjsProviderInput, UseYjsProviderResult, UseZoomNavigationInput, UseZoomNavigationResult, UserPresence, ViewerBuildingBlocksResult, ViewerCoreState, ViewerDialogsResult, ViewerIntegrationResult, ViewerState, ViewerUIState, VirtualizedRange, VirtualizedSlidesOptions, VirtualizedSlidesResult };