pptx-react-viewer 2.3.0 → 2.4.0

package/dist/index-CDCSXtK3.d.ts

@@ -1,685 +0,0 @@
-import { D as ConnectionStatus, O as UserPresence, T as CollaborationContextValue, h as PresentationAnimationRuntime, t as ElementAnimationState, ut as ViewerMode$1, w as CollaborationConfig$1 } from "./animation-timeline-eb5z0SHW.js";
-import { PptxAction, PptxData, PptxElement, PptxHandler, PptxSlide, PptxSlideTransition, PptxThemeColorScheme, PptxThemeFontScheme, PptxThemePreset } from "pptx-viewer-core";
-import { CollaborationConfig, CollaborationLivePatcher, PresentationPointerTool, PresentationSnapshot, clearAudienceContent, loadAudienceContent, storeAudienceContent } from "pptx-viewer-shared";
-import { RefObject } from "react";
-import * as Y from "yjs";
-import { Doc, Doc as YDoc } from "yjs";
-//#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$1;
-  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$1) => void;
-  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 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;
-  /**
-   * 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
-   */
-  on(name: N, f: Function): void;
-  /**
-   * @param {N} name
-   * @param {function} f
-   */
-  once(name: N, f: Function): void;
-  /**
-   * @param {N} name
-   * @param {function} f
-   */
-  off(name: N, f: Function): void;
-  /**
-   * Emit a named event. All registered event listeners that listen to the
-   * specified name will receive the event.
-   *
-   * @todo This should catch exceptions
-   *
-   * @param {N} name The event name.
-   * @param {Array<any>} args The arguments that are applied to the event listener.
-   */
-  emit(name: N, args: Array<any>): void;
-  destroy(): void;
-}
-//#endregion
-//#region ../../node_modules/.bun/y-protocols@1.0.7+253afa400b9c0a30/node_modules/y-protocols/awareness.d.ts
-/**
- * @typedef {Object} MetaClientState
- * @property {number} MetaClientState.clock
- * @property {number} MetaClientState.lastUpdated unix timestamp
- */
-/**
- * The Awareness class implements a simple shared state protocol that can be used for non-persistent data like awareness information
- * (cursor, username, status, ..). Each client can update its own local state and listen to state changes of
- * remote clients. Every client may set a state of a remote peer to `null` to mark the client as offline.
- *
- * Each client is identified by a unique client id (something we borrow from `doc.clientID`). A client can override
- * its own state by propagating a message with an increasing timestamp (`clock`). If such a message is received, it is
- * applied if the known state of that client is older than the new state (`clock < newClock`). If a client thinks that
- * a remote client is offline, it may propagate a message with
- * `{ clock: currentClientClock, state: null, client: remoteClient }`. If such a
- * message is received, and the known clock of that client equals the received clock, it will override the state with `null`.
- *
- * Before a client disconnects, it should propagate a `null` state with an updated clock.
- *
- * Awareness states must be updated every 30 seconds. Otherwise the Awareness instance will delete the client state.
- *
- * @extends {Observable<string>}
- */
-declare class Awareness extends Observable<string> {
-  /**
-   * @param {Y.Doc} doc
-   */
-  constructor(doc: Y.Doc);
-  doc: Y.Doc;
-  /**
-   * @type {number}
-   */
-  clientID: number;
-  /**
-   * Maps from client id to client state
-   * @type {Map<number, Object<string, any>>}
-   */
-  states: Map<number, {
-    [x: string]: any;
-  }>;
-  /**
-   * @type {Map<number, MetaClientState>}
-   */
-  meta: Map<number, MetaClientState>;
-  _checkInterval: any;
-  /**
-   * @return {Object<string,any>|null}
-   */
-  getLocalState(): {
-    [x: string]: any;
-  } | null;
-  /**
-   * @param {Object<string,any>|null} state
-   */
-  setLocalState(state: {
-    [x: string]: any;
-  } | null): void;
-  /**
-   * @param {string} field
-   * @param {any} value
-   */
-  setLocalStateField(field: string, value: any): void;
-  /**
-   * @return {Map<number,Object<string,any>>}
-   */
-  getStates(): Map<number, {
-    [x: string]: any;
-  }>;
-}
-type MetaClientState = {
-  clock: number;
-  /**
-   * unix timestamp
-   */
-  lastUpdated: number;
-};
-//#endregion
-//#region src/viewer/hooks/collaboration/useYjsProvider.d.ts
-interface UseYjsProviderInput {
-  /**
-   * Collaboration config, or `undefined` when collaboration is inactive. The
-   * hook is always called (React hook rules) but stays fully dormant, never
-   * opening a transport, while config is absent.
-   */
-  config?: CollaborationConfig$1;
-}
-interface UseYjsProviderResult {
-  /** Current WebSocket connection status. */
-  status: ConnectionStatus;
-  /** The Yjs awareness instance (null until connected). */
-  awareness: Awareness | null;
-  /** The Yjs document (null until initialised). */
-  doc: YDoc | null;
-  /** Local awareness client ID. */
-  clientId: number | null;
-  /**
-   * Whether the provider completed its initial document sync. Local doc
-   * writes should be gated on this so a late joiner never seeds its
-   * bootstrap deck into a room whose content has not arrived yet. Websocket
-   * flips it on the provider's 'synced' event; webrtc flips it on peer sync
-   * or after {@link INITIAL_SYNC_GRACE_MS} (a lone fresh-room peer never
-   * receives a sync event).
-   */
-  synced: boolean;
-  /** Manually retry the connection after a timeout or error. */
-  retry: () => void;
-}
-/**
- * Lazily loads `yjs` and `y-websocket`, creates a Y.Doc and
- * WebSocketProvider, and tracks the connection lifecycle.
- *
- * If the connection does not succeed within {@link CONNECTION_TIMEOUT_MS},
- * the provider is torn down and status moves to `'error'`. The consumer
- * can call `retry()` to attempt a fresh connection.
- *
- * The Yjs packages are dynamically imported so they are fully
- * tree-shaken when collaboration is not enabled.
- */
-declare function useYjsProvider({ config }: UseYjsProviderInput): UseYjsProviderResult;
-//#endregion
-//#region src/viewer/hooks/collaboration/usePresenceTracking.d.ts
-interface UsePresenceTrackingInput {
-  awareness: Awareness | null;
-  localClientId: number | null;
-  userName: string;
-  userColor: string;
-  userAvatar?: string;
-  /** Role in the session (broadcaster, viewer, or collaborator). */
-  role?: string;
-  canvasWidth: number;
-  canvasHeight: number;
-}
-interface UsePresenceTrackingResult {
-  /** Presence data for all remote users (excludes local). */
-  remoteUsers: UserPresence[];
-  /** Broadcast a partial presence update for the local user. */
-  broadcastPresence: (update: Partial<Omit<UserPresence, 'clientId'>>) => void;
-}
-declare function usePresenceTracking({ awareness, localClientId, userName, userColor, userAvatar, role, canvasWidth, canvasHeight }: UsePresenceTrackingInput): UsePresenceTrackingResult;
-//#endregion
-//#region src/viewer/hooks/collaboration/useCollaborativeState.d.ts
-interface UseCollaborativeStateInput {
-  /**
-   * Collaboration config, or `undefined` when collaboration is inactive. The
-   * hook is always called so the surrounding provider keeps a stable React
-   * tree shape; it produces a dormant value (no transport, empty presence)
-   * while config is absent.
-   */
-  config?: CollaborationConfig$1;
-  canvasWidth: number;
-  canvasHeight: number;
-}
-declare function useCollaborativeState({ config, canvasWidth, canvasHeight }: UseCollaborativeStateInput): CollaborationContextValue | null;
-//#endregion
-//#region src/viewer/hooks/collaboration/useCollaborativeHistory.d.ts
-interface UseCollaborativeHistoryInput {
-  /** The local user's client ID (from Yjs awareness). */
-  localClientId: number | null;
-  /** Standard history undo function. */
-  handleUndo: () => void;
-  /** Standard history redo function. */
-  handleRedo: () => void;
-  /** Whether undo is available. */
-  canUndo: boolean;
-  /** Whether redo is available. */
-  canRedo: boolean;
-}
-interface UseCollaborativeHistoryResult {
-  /** Undo the last local change. */
-  handleUndo: () => void;
-  /** Redo the last undone local change. */
-  handleRedo: () => void;
-  /** Whether undo is available. */
-  canUndo: boolean;
-  /** Whether redo is available. */
-  canRedo: boolean;
-}
-declare function useCollaborativeHistory({ localClientId: _localClientId, handleUndo, handleRedo, canUndo, canRedo }: UseCollaborativeHistoryInput): UseCollaborativeHistoryResult;
-//#endregion
-//#region src/viewer/hooks/collaboration/useYjsDocumentSync.d.ts
-interface UseYjsDocumentSyncInput {
-  /** The Yjs document (from useYjsProvider). null when not collaborating. */
-  doc: Doc | null;
-  /** Current slides state. */
-  slides: PptxSlide[];
-  /** Separated master/layout (template) elements, merged back on write-back. */
-  templateElementsBySlideId: Record<string, PptxElement[]>;
-  /** React state setter for slides. */
-  setSlides: React.Dispatch<React.SetStateAction<PptxSlide[]>>;
-  /** Whether collaboration is active (status === 'connected'). */
-  isConnected: boolean;
-  /**
-   * Whether the provider completed its initial document sync. Local -> doc
-   * writes are gated on this so a late joiner never seeds its bootstrap deck
-   * into a room whose real content has not arrived yet. Defaults to true for
-   * callers that manage sync readiness themselves.
-   */
-  isSynced?: boolean;
-  /** Collaboration config (for role and write-back). */
-  config?: Pick<CollaborationConfig, 'role' | 'onWriteBack' | 'writeBackDebounceMs'>;
-  /**
-   * Return the source PPTX bytes for write-back serialization. Only called
-   * when role === 'owner' and onWriteBack is set.
-   */
-  getSourceBytes?: () => Uint8Array | null;
-  /**
-   * Monotonic counter bumped each time the content-load pipeline finishes
-   * applying a parsed deck to viewer state. A local load that lands while the
-   * shared doc already holds slides (a late joiner's bootstrap deck parsing
-   * after the room state arrived) would silently clobber the synced slides;
-   * each bump re-adopts the doc's slides when the room has content.
-   */
-  loadVersion?: number;
-}
-declare function useYjsDocumentSync({ doc, slides, templateElementsBySlideId, setSlides, isConnected, isSynced, config, getSourceBytes, loadVersion }: UseYjsDocumentSyncInput): void;
-//#endregion
-//#region src/viewer/hooks/collaboration/useBroadcastFollower.d.ts
-interface UseBroadcastFollowerInput {
-  /** The collaboration context (null when collaboration is disabled). */
-  collab: CollaborationContextValue | null;
-  /** Current local active slide index. */
-  activeSlideIndex: number;
-  /** Setter for the active slide index. */
-  setActiveSlideIndex: (index: number) => void;
-  /** Total number of slides (for bounds checking). */
-  slideCount: number;
-  /**
-   * When true, auto-follow stands down (e.g. the local user is manually
-   * following a specific peer via the follow bar). Defaults to false.
-   */
-  paused?: boolean;
-}
-declare function useBroadcastFollower({ collab, activeSlideIndex, setActiveSlideIndex, slideCount, paused }: UseBroadcastFollowerInput): void;
-//#endregion
-//#region src/viewer/hooks/collaboration/useFollowMode.d.ts
-interface UseFollowModeInput {
-  /** The collaboration context (null when collaboration is disabled). */
-  collab: CollaborationContextValue | null;
-  /** Current local active slide index. */
-  activeSlideIndex: number;
-  /** Setter for the active slide index. */
-  setActiveSlideIndex: (index: number) => void;
-  /** Total number of slides (for bounds checking). */
-  slideCount: number;
-}
-interface UseFollowModeResult {
-  /** The clientId currently being followed, or null. */
-  followedClientId: number | null;
-  /** Follow the given peer, or `null` to stop following. */
-  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 {
-  slides: PptxSlide[];
-  onPlayActionSound?: (soundPath: string) => void;
-  /** When false, all animations are skipped (elements shown immediately). */
-  showWithAnimation?: 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) => void;
-  /** 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$1) => 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$1;
-  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$1) => 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$1) => 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/usePresenterWindow.d.ts
-/**
- * Parse the session nonce from the current page URL hash. Returns null if the
- * hash is not in the expected `#pptx-audience&nonce=<uuid>` form.
- */
-declare function parseAudienceNonce(): string | null;
-/** Returns true if the current page was opened as an audience tab. */
-declare function isAudienceTab(): boolean;
-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;
-//#endregion
-//#region src/viewer/hooks/presentation-mode/useAudienceMode.d.ts
-interface UseAudienceModeInput {
-  mode: ViewerMode$1;
-  onSetMode: (mode: ViewerMode$1) => 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;
-//#endregion
-export { UseCollaborativeStateInput as A, useThemeSwitching as B, UseBroadcastFollowerInput as C, UseCollaborativeHistoryInput as D, useYjsDocumentSync as E, UseYjsProviderInput as F, UsePresentationModeResult as H, UseYjsProviderResult as I, useYjsProvider as L, UsePresenceTrackingInput as M, UsePresenceTrackingResult as N, UseCollaborativeHistoryResult as O, usePresenceTracking as P, ThemeSwitchingResult as R, useFollowMode as S, UseYjsDocumentSyncInput as T, UsePresentationModeInput as V, UseAnimationPlaybackInput as _, UsePresenterWindowInput as a, UseFollowModeInput as b, parseAudienceNonce as c, UseSlideNavigationResult as d, useSlideNavigation as f, useRehearsalTimings as g, UseRehearsalTimingsResult as h, useAudienceMode as i, useCollaborativeState as j, useCollaborativeHistory as k, usePresenterWindow as l, UseRehearsalTimingsInput as m, loadAudienceContent as n, UsePresenterWindowResult as o, usePresentationKeyboard as p, storeAudienceContent as r, isAudienceTab as s, clearAudienceContent as t, UseSlideNavigationInput as u, UseAnimationPlaybackResult as v, useBroadcastFollower as w, UseFollowModeResult as x, useAnimationPlayback as y, UseThemeSwitchingInput as z };
-//# sourceMappingURL=index-CDCSXtK3.d.ts.map