@glitchlab/react-video-player 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -3,6 +3,19 @@ import { HlsConfig } from 'hls.js';
 
 declare type AspectRatio = `${number}/${number}`;
 
+/**
+ * A normalized audio-track descriptor, independent of whether the source plays
+ * through hls.js or the native `<video>` element.
+ */
+export declare interface AudioTrackInfo {
+    /** Stable index into the player's track list. */
+    index: number;
+    /** Human-readable label, e.g. "English", "Español", or a fallback. */
+    label: string;
+    /** BCP-47-ish language code if the source provides one. */
+    lang?: string;
+}
+
 declare type DeviceMode = "desktop" | "mobile";
 
 /**
@@ -47,8 +60,14 @@ export declare interface ReactVideoPlayerProps {
     muted?: boolean;
     /** Loop playback. Defaults to `false`. */
     loop?: boolean;
-    /** Show native browser controls. Defaults to `false`. */
-    controls?: boolean;
+    /**
+     * Controls mode.
+     *  - `false` (default): no controls — just the centered play overlay.
+     *  - `true`: native browser controls (look varies by browser/OS).
+     *  - `"custom"`: branded custom control bar at the bottom of the frame,
+     *    consistent across browsers/OS. Auto-hides during playback.
+     */
+    controls?: boolean | "custom";
     /**
      * Start playback as soon as the source loads. Defaults to `false`.
      * Browsers block sound-on autoplay, so this only autoplays when `muted`
@@ -100,3 +119,23 @@ declare interface YouTubeEmbedOptions {
 export declare function youTubeEmbedUrl(id: string, opts?: YouTubeEmbedOptions): string;
 
 export { }
+
+
+declare global {
+    interface HTMLMediaElement {
+        readonly audioTracks?: AudioTrackListLike;
+    }
+    interface HTMLVideoElement {
+        /** iOS Safari only — opens Apple's native fullscreen player. */
+        webkitEnterFullscreen?(): void;
+    }
+    interface Document {
+        readonly webkitFullscreenElement?: Element | null;
+        readonly webkitFullscreenEnabled?: boolean;
+        webkitExitFullscreen?(): Promise<void>;
+    }
+    interface HTMLElement {
+        webkitRequestFullscreen?(): Promise<void>;
+    }
+}
+