@oddin-gg/havik-player 2.18.0 → 2.19.0

package/dist/index.d.cts

@@ -624,6 +624,26 @@ export declare type FrameToHost = {
     message: string;
 };
 
+/**
+ * Whether a fullscreen presentation for `video` can work, by the same
+ * ladder enterVideoFullscreen walks. False means a request is KNOWN to
+ * fail, so the caller should hide its button:
+ *
+ *  - the element API exists on `container` (or the video) but the document
+ *    reports `fullscreenEnabled === false` — the Fullscreen spec sets that
+ *    exactly when permissions policy blocks the feature, which is what a
+ *    cross-origin iframe without `fullscreen` in its `allow` list looks
+ *    like (prefixed `webkitFullscreenEnabled` on older Safari);
+ *  - no element API at all, media already loaded, and the video does not
+ *    offer the video-native presentation either (a webview with nothing).
+ *
+ * True otherwise — including "not known yet": with no element API and
+ * media not loaded (iPhone before the first play) the video-native flag
+ * is not readable, so the answer stays optimistic. Re-check on
+ * `loadedmetadata`; the managed control bar does.
+ */
+export declare function fullscreenSupported(video: HTMLVideoElement, container?: HTMLElement): boolean;
+
 export declare function getDeviceId(): string;
 
 /**
@@ -997,6 +1017,14 @@ export declare interface Player {
     enterFullscreen(): Promise<boolean>;
     /** Leave fullscreen (element or video-native). Safe when not fullscreen. */
     exitFullscreen(): Promise<void>;
+    /**
+     * Whether enterFullscreen can work here: false when the page's permissions
+     * policy blocks fullscreen (an iframe without `fullscreen` in `allow`) or
+     * the platform has no mechanism, so a custom UI can hide its button. Stays
+     * true before media loads on iPhone (not knowable yet); re-check on the
+     * video's `loadedmetadata`.
+     */
+    fullscreenSupported(): boolean;
     /** Retry playback after an error (re-resolves and re-attaches). */
     retry(): Promise<void>;
     /** Re-resolve playback (refreshes the signed license URL) and re-attach. */

package/dist/index.d.ts

@@ -624,6 +624,26 @@ export declare type FrameToHost = {
     message: string;
 };
 
+/**
+ * Whether a fullscreen presentation for `video` can work, by the same
+ * ladder enterVideoFullscreen walks. False means a request is KNOWN to
+ * fail, so the caller should hide its button:
+ *
+ *  - the element API exists on `container` (or the video) but the document
+ *    reports `fullscreenEnabled === false` — the Fullscreen spec sets that
+ *    exactly when permissions policy blocks the feature, which is what a
+ *    cross-origin iframe without `fullscreen` in its `allow` list looks
+ *    like (prefixed `webkitFullscreenEnabled` on older Safari);
+ *  - no element API at all, media already loaded, and the video does not
+ *    offer the video-native presentation either (a webview with nothing).
+ *
+ * True otherwise — including "not known yet": with no element API and
+ * media not loaded (iPhone before the first play) the video-native flag
+ * is not readable, so the answer stays optimistic. Re-check on
+ * `loadedmetadata`; the managed control bar does.
+ */
+export declare function fullscreenSupported(video: HTMLVideoElement, container?: HTMLElement): boolean;
+
 export declare function getDeviceId(): string;
 
 /**
@@ -997,6 +1017,14 @@ export declare interface Player {
     enterFullscreen(): Promise<boolean>;
     /** Leave fullscreen (element or video-native). Safe when not fullscreen. */
     exitFullscreen(): Promise<void>;
+    /**
+     * Whether enterFullscreen can work here: false when the page's permissions
+     * policy blocks fullscreen (an iframe without `fullscreen` in `allow`) or
+     * the platform has no mechanism, so a custom UI can hide its button. Stays
+     * true before media loads on iPhone (not knowable yet); re-check on the
+     * video's `loadedmetadata`.
+     */
+    fullscreenSupported(): boolean;
     /** Retry playback after an error (re-resolves and re-attaches). */
     retry(): Promise<void>;
     /** Re-resolve playback (refreshes the signed license URL) and re-attach. */