@oddin-gg/havik-player 1.15.0 → 1.16.0

package/dist/index.d.cts

@@ -289,6 +289,29 @@ export declare interface EmbedHandle {
     destroy(): void;
 }
 
+/**
+ * Enter fullscreen for `video`, walking the capability ladder above.
+ * `container` is the element to present in element fullscreen (defaults to
+ * the video) — pass your player wrapper to keep your own controls visible on
+ * platforms that support it. Returns false when NO mechanism exists (some
+ * webviews) so the caller can hide or disable its button; rejections from a
+ * denied request (permissions policy) propagate.
+ *
+ * Call from a user gesture: every branch of the ladder requires one.
+ */
+export declare function enterVideoFullscreen(video: HTMLVideoElement, container?: HTMLElement): Promise<boolean>;
+
+/**
+ * Leave whichever fullscreen presentation `video` is in: iPhone's video-native
+ * fullscreen first (it reports only through the video, never the document),
+ * then element fullscreen via the document (unprefixed or prefixed). Safe to
+ * call when not fullscreen — and scoped to THIS video's presentation: an
+ * unrelated element's fullscreen (a lightbox, another player) is left alone,
+ * mirroring the ownership check exitPictureInPicture makes on
+ * pictureInPictureElement. Pass the same `container` you entered with.
+ */
+export declare function exitVideoFullscreen(video: HTMLVideoElement, container?: HTMLElement): Promise<void>;
+
 export declare interface FairPlayInfo {
     licenseUrl: string;
     certificateUrl: string;
@@ -631,6 +654,17 @@ export declare interface Player {
     seekToLive(): void;
     enterPictureInPicture(): Promise<void>;
     exitPictureInPicture(): Promise<void>;
+    /**
+     * Enter fullscreen: element fullscreen on the player container where the
+     * API exists (custom controls stay on screen); on iPhone Safari falls back
+     * to the video-native presentation with NATIVE controls (there is no
+     * element Fullscreen API there at all). Call from a user gesture; on
+     * iPhone it takes effect once media is loaded. Resolves false when no
+     * fullscreen mechanism exists on the platform.
+     */
+    enterFullscreen(): Promise<boolean>;
+    /** Leave fullscreen (element or video-native). Safe when not fullscreen. */
+    exitFullscreen(): Promise<void>;
     /** Retry playback after an error (re-resolves and re-attaches). */
     retry(): Promise<void>;
     /** Re-resolve playback (refreshes the signed license URL) and re-attach. */
@@ -816,6 +850,13 @@ export declare interface TournamentResult {
     notFound: boolean;
 }
 
+/**
+ * True while this video's fullscreen presentation is active: element
+ * fullscreen on `container` or the video itself, or iPhone's video-native
+ * fullscreen. Pass the same `container` you pass to enterVideoFullscreen.
+ */
+export declare function videoFullscreenActive(video: HTMLVideoElement, container?: HTMLElement): boolean;
+
 export declare type WaitForLive = boolean | WaitForLiveOptions;
 
 export declare interface WaitForLiveOptions {

package/dist/index.d.ts

@@ -289,6 +289,29 @@ export declare interface EmbedHandle {
     destroy(): void;
 }
 
+/**
+ * Enter fullscreen for `video`, walking the capability ladder above.
+ * `container` is the element to present in element fullscreen (defaults to
+ * the video) — pass your player wrapper to keep your own controls visible on
+ * platforms that support it. Returns false when NO mechanism exists (some
+ * webviews) so the caller can hide or disable its button; rejections from a
+ * denied request (permissions policy) propagate.
+ *
+ * Call from a user gesture: every branch of the ladder requires one.
+ */
+export declare function enterVideoFullscreen(video: HTMLVideoElement, container?: HTMLElement): Promise<boolean>;
+
+/**
+ * Leave whichever fullscreen presentation `video` is in: iPhone's video-native
+ * fullscreen first (it reports only through the video, never the document),
+ * then element fullscreen via the document (unprefixed or prefixed). Safe to
+ * call when not fullscreen — and scoped to THIS video's presentation: an
+ * unrelated element's fullscreen (a lightbox, another player) is left alone,
+ * mirroring the ownership check exitPictureInPicture makes on
+ * pictureInPictureElement. Pass the same `container` you entered with.
+ */
+export declare function exitVideoFullscreen(video: HTMLVideoElement, container?: HTMLElement): Promise<void>;
+
 export declare interface FairPlayInfo {
     licenseUrl: string;
     certificateUrl: string;
@@ -631,6 +654,17 @@ export declare interface Player {
     seekToLive(): void;
     enterPictureInPicture(): Promise<void>;
     exitPictureInPicture(): Promise<void>;
+    /**
+     * Enter fullscreen: element fullscreen on the player container where the
+     * API exists (custom controls stay on screen); on iPhone Safari falls back
+     * to the video-native presentation with NATIVE controls (there is no
+     * element Fullscreen API there at all). Call from a user gesture; on
+     * iPhone it takes effect once media is loaded. Resolves false when no
+     * fullscreen mechanism exists on the platform.
+     */
+    enterFullscreen(): Promise<boolean>;
+    /** Leave fullscreen (element or video-native). Safe when not fullscreen. */
+    exitFullscreen(): Promise<void>;
     /** Retry playback after an error (re-resolves and re-attaches). */
     retry(): Promise<void>;
     /** Re-resolve playback (refreshes the signed license URL) and re-attach. */
@@ -816,6 +850,13 @@ export declare interface TournamentResult {
     notFound: boolean;
 }
 
+/**
+ * True while this video's fullscreen presentation is active: element
+ * fullscreen on `container` or the video itself, or iPhone's video-native
+ * fullscreen. Pass the same `container` you pass to enterVideoFullscreen.
+ */
+export declare function videoFullscreenActive(video: HTMLVideoElement, container?: HTMLElement): boolean;
+
 export declare type WaitForLive = boolean | WaitForLiveOptions;
 
 export declare interface WaitForLiveOptions {