import { PlayerStatus } from "./use-audio-player.cjs";
import { VideoMedia } from "@langchain/langgraph-sdk/stream";
import { RefObject } from "react";

//#region src/use-video-player.d.ts
/**
 * Options for {@link useVideoPlayer}.
 */
interface UseVideoPlayerOptions {
  /**
   * Start playback as soon as the blob URL resolves. Subject to
   * browser autoplay policies — pair with `muted={true}` on the
   * `<video>` element to bypass the user-gesture requirement.
   */
  autoPlay?: boolean;
}
/**
 * Controls + live state returned by {@link useVideoPlayer}. Mirrors
 * {@link AudioPlayerHandle} on the shared subset so callers only ever
 * learn one shape.
 */
interface VideoPlayerHandle {
  status: PlayerStatus;
  play(): void;
  pause(): void;
  stop(): void;
  toggle(): void;
  reset(): void;
  /**
   * Resolve on the next terminal transition (`finished` / `paused` /
   * `idle`). Reject on transitions to `"error"`. Triggers `play()`
   * when called.
   */
  playToEnd(): Promise<void>;
  currentTime: number;
  /** Total duration (seconds) once the element has parsed the blob. */
  duration?: number;
  /** Seek to an absolute timestamp in seconds. */
  seek(seconds: number): void;
  error: Error | undefined;
}
/**
 * Bind a {@link VideoMedia} handle to a caller-owned `<video>` element.
 *
 * ### Contract
 *
 * - The caller renders `<video ref={videoRef}>` and styles it however
 *   they like; the hook never injects DOM nor overrides layout.
 * - On `message-finish`, the underlying blob URL is minted and assigned
 *   as `video.src`. Progressive playback of streamed container video
 *   (fragmented mp4 / webm via MSE) is out of scope for this version;
 *   `status` stays in `"buffering"` until the blob resolves.
 * - Element events (`play` / `pause` / `ended` / `timeupdate` /
 *   `loadedmetadata` / `error`) are translated into the shared
 *   {@link PlayerStatus} enum.
 * - On unmount, `media.revoke()` is called to free the object URL.
 *
 * @param videoRef - Ref to the `<video>` element the caller renders.
 * @param media    - Video handle from {@link useVideo}.
 * @param options  - Auto-play toggle.
 */
declare function useVideoPlayer(videoRef: RefObject<HTMLVideoElement | null>, media: VideoMedia | undefined, options?: UseVideoPlayerOptions): VideoPlayerHandle;
//#endregion
export { UseVideoPlayerOptions, VideoPlayerHandle, useVideoPlayer };
//# sourceMappingURL=use-video-player.d.cts.map