react-native-video-provider 0.2.0 → 0.2.2

package/lib/typescript/src/core/VideoManager.d.ts

@@ -23,6 +23,8 @@ export declare class VideoManager {
     private config;
     /** Last non-reserved surface, restored after fullscreen/floating exits. */
     private lastInlineSurfaceId;
+    /** Per-player default for `enterFullscreen()` (VideoPlayer's prop). */
+    private fullscreenOrientationDefault;
     private constructor();
     get providerConfig(): Required<VideoProviderConfig>;
     /**
@@ -60,6 +62,14 @@ export declare class VideoManager {
      * overriding the app's own lock until cleared with `'auto'`.
      */
     setOrientation(lock: OrientationLock): void;
+    /**
+     * Register the orientation `enterFullscreen()` uses when called without an
+     * argument (the built-in controls call it that way). Scoped: applied when
+     * fullscreen opens, restored when it closes — the rest of the app is
+     * unaffected. Pass null to unregister. Set by VideoPlayer's
+     * `fullscreenOrientation` prop.
+     */
+    setFullscreenOrientation(lock: OrientationLock | null): void;
     getPosition(): Promise<number>;
     /** Re-parent the player into the surface registered under `surfaceId`. */
     attach(surfaceId: string): void;
@@ -72,13 +82,18 @@ export declare class VideoManager {
      */
     handleSurfaceUnmount(surfaceId: string): void;
     /**
-     * Show the built-in fullscreen host and unlock device rotation.
-     * The host mounts a surface and attaches automatically.
+     * Show the built-in fullscreen host. Rotation unlocks by default; pass an
+     * orientation (or set VideoPlayer's `fullscreenOrientation` prop) to force
+     * one for the fullscreen session only. That scoped orientation is the
+     * highest priority — it's applied in the SAME native call as entering
+     * fullscreen (never as a separate follow-up call), so there is no
+     * unlocked frame where the sensor could win before the lock takes effect.
+     * Restored on exit; the rest of the app never sees the lock.
      */
-    enterFullscreen(): void;
-    /** Restore the previous orientation lock and re-attach the previous surface. */
+    enterFullscreen(orientation?: OrientationLock): void;
+    /** Restore the standing orientation lock (if any) and re-attach the previous surface. */
     exitFullscreen(): void;
-    toggleFullscreen(): void;
+    toggleFullscreen(orientation?: OrientationLock): void;
     showFloating(): void;
     hideFloating(): void;
     enterPiP(): Promise<boolean>;

package/lib/typescript/src/core/VideoManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoManager.d.ts","sourceRoot":"","sources":["../../../../src/core/VideoManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VideoManager.d.ts","sourceRoot":"","sources":["../../../../src/core/VideoManager.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/hooks/useFullscreen.d.ts

@@ -1,9 +1,9 @@
 import type { OrientationLock } from '../types/video.js';
 export declare function useFullscreen(): {
     isFullscreen: boolean;
-    enter: () => void;
+    enter: (orientation?: OrientationLock) => void;
     exit: () => void;
-    toggle: () => void;
+    toggle: (orientation?: OrientationLock) => void;
     orientationLock: OrientationLock;
     setOrientation: (lock: OrientationLock) => void;
 };

package/lib/typescript/src/hooks/useFullscreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFullscreen.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useFullscreen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAgB,CAAC;AAGtD,wBAAgB,aAAa;;;;;;2BASlB,eAAe;EAKzB"}
+{"version":3,"file":"useFullscreen.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useFullscreen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAgB,CAAC;AAGtD,wBAAgB,aAAa;;0BAMV,eAAe;;2BAKf,eAAe;;2BAIvB,eAAe;EAKzB"}

package/lib/typescript/src/types/video.d.ts

@@ -78,11 +78,5 @@ export interface VideoProviderConfig {
     floatingHost?: boolean;
     /** Pause playback when the active surface unmounts. Default false. */
     pauseOnDetach?: boolean;
-    /**
-     * Orientation to force while fullscreen is active, e.g. `'landscape'`.
-     * Restored to the previous lock (or `'auto'`) on exit.
-     * Default `'auto'` — fullscreen just unlocks the sensor.
-     */
-    fullscreenOrientation?: OrientationLock;
 }
 //# sourceMappingURL=video.d.ts.map

package/lib/typescript/src/types/video.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../../src/types/video.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,UAAU,GACV,mBAAmB,GACnB,WAAW,GACX,oBAAoB,CAAC;AAEzB,MAAM,MAAM,UAAU,GACpB,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEzE,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,2EAA2E;IAC3E,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,eAAe,CAAC;CACzC"}
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../../src/types/video.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,UAAU,GACV,mBAAmB,GACnB,WAAW,GACX,oBAAoB,CAAC;AAEzB,MAAM,MAAM,UAAU,GACpB,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEzE,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,2EAA2E;IAC3E,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-video-provider",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Singleton-engine video library for React Native (one native player, many surfaces)",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -75,6 +75,7 @@
     "react": "19.2.3",
     "react-native": "0.85.0",
     "react-native-builder-bob": "^0.43.0",
+    "react-native-svg": "15.15.5",
     "turbo": "^2.9.16",
     "typescript": "^6.0.3"
   },
@@ -83,7 +84,8 @@
   },
   "peerDependencies": {
     "react": "*",
-    "react-native": "*"
+    "react-native": "*",
+    "react-native-svg": ">=13.0.0"
   },
   "workspaces": [
     "example"

package/src/NativeAuVideo.ts

@@ -81,10 +81,14 @@ export interface Spec extends TurboModule {
   attach(surfaceId: string): void;
   detach(): void;
 
-  /** Unlock rotation + immersive mode. Does not move the player. */
-  enterFullscreen(): void;
-  /** Restore the previous orientation lock. */
-  exitFullscreen(): void;
+  /**
+   * Enter fullscreen (immersive mode). `orientation` is applied in the same
+   * native call — no intermediate unlocked frame before a lock takes effect.
+   * auto | portrait | inverted-portrait | landscape | inverted-landscape
+   */
+  enterFullscreen(orientation: string): void;
+  /** Exit fullscreen, restoring `orientation` (same value semantics) atomically. */
+  exitFullscreen(orientation: string): void;
 
   /**
    * Force a screen orientation, overriding the app's own lock and the

package/src/components/FloatingPlayer.tsx

@@ -4,12 +4,12 @@ import {
   PanResponder,
   Pressable,
   StyleSheet,
-  Text,
   useWindowDimensions,
 } from 'react-native';
 import { FLOATING_SURFACE_ID } from '../core/VideoManager';
 import { usePlayback } from '../hooks/usePlayback';
 import { useVideoManager } from '../provider/VideoContext';
+import { CloseIcon, EnterFullscreenIcon } from './icons';
 import { VideoSurface } from './VideoSurface';
 
 export interface FloatingPlayerProps {
@@ -74,7 +74,7 @@ export function FloatingPlayer({ width = 200 }: FloatingPlayerProps) {
         hitSlop={8}
         onPress={() => manager.hideFloating()}
       >
-        <Text style={styles.icon}>✕</Text>
+        <CloseIcon size={12} color="#fff" />
       </Pressable>
       <Pressable
         style={[styles.button, styles.expandButton]}
@@ -84,7 +84,7 @@ export function FloatingPlayer({ width = 200 }: FloatingPlayerProps) {
           manager.enterFullscreen();
         }}
       >
-        <Text style={styles.icon}>⤢</Text>
+        <EnterFullscreenIcon size={12} color="#fff" />
       </Pressable>
     </Animated.View>
   );
@@ -123,8 +123,4 @@ const styles = StyleSheet.create({
   expandButton: {
     left: 4,
   },
-  icon: {
-    color: '#fff',
-    fontSize: 12,
-  },
 });

package/src/components/MiniPlayer.tsx

@@ -7,6 +7,7 @@ import {
 } from 'react-native';
 import { usePlayback } from '../hooks/usePlayback';
 import { useVideoManager } from '../provider/VideoContext';
+import { CloseIcon, PauseIcon, PlayIcon } from './icons';
 import { VideoSurface } from './VideoSurface';
 
 export interface MiniPlayerProps extends ViewProps {
@@ -47,11 +48,15 @@ export function MiniPlayer({
         hitSlop={8}
         onPress={() => manager.toggle()}
       >
-        <Text style={styles.icon}>{playing ? '❙❙' : '▶'}</Text>
+        {playing ? (
+          <PauseIcon size={16} color="#fff" />
+        ) : (
+          <PlayIcon size={16} color="#fff" />
+        )}
       </Pressable>
       {onClose ? (
         <Pressable style={styles.button} hitSlop={8} onPress={onClose}>
-          <Text style={styles.icon}>✕</Text>
+          <CloseIcon size={16} color="#fff" />
         </Pressable>
       ) : null}
     </View>
@@ -86,8 +91,4 @@ const styles = StyleSheet.create({
     paddingHorizontal: 10,
     paddingVertical: 8,
   },
-  icon: {
-    color: '#fff',
-    fontSize: 16,
-  },
 });

package/src/components/SvgIcons.tsx

@@ -0,0 +1,169 @@
+import Svg, { G, Path } from 'react-native-svg';
+
+const SvgIcons = ({
+  icon,
+  type,
+  fill,
+  size = 24,
+}: {
+  icon: string;
+  type?: string;
+  fill?: string;
+  size?: number;
+}) => {
+  switch (icon) {
+    case 'fullScreen':
+      return type === 'full' ? (
+        <Svg width={size} height={size} viewBox="0 0 24 24" fill="none">
+          <G id="SVGRepo_bgCarrier" strokeWidth={0} />
+          <G
+            id="SVGRepo_tracerCarrier"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+          <G id="SVGRepo_iconCarrier">
+            <Path
+              d="M4 1.5C2.61929 1.5 1.5 2.61929 1.5 4V8.5C1.5 9.05228 1.94772 9.5 2.5 9.5H3.5C4.05228 9.5 4.5 9.05228 4.5 8.5V4.5H8.5C9.05228 4.5 9.5 4.05228 9.5 3.5V2.5C9.5 1.94772 9.05228 1.5 8.5 1.5H4Z"
+              fill={fill || '#fff'}
+            />
+            <Path
+              d="M20 1.5C21.3807 1.5 22.5 2.61929 22.5 4V8.5C22.5 9.05228 22.0523 9.5 21.5 9.5H20.5C19.9477 9.5 19.5 9.05228 19.5 8.5V4.5H15.5C14.9477 4.5 14.5 4.05228 14.5 3.5V2.5C14.5 1.94772 14.9477 1.5 15.5 1.5H20Z"
+              fill={fill || '#fff'}
+            />
+            <Path
+              d="M20 22.5C21.3807 22.5 22.5 21.3807 22.5 20V15.5C22.5 14.9477 22.0523 14.5 21.5 14.5H20.5C19.9477 14.5 19.5 14.9477 19.5 15.5V19.5H15.5C14.9477 19.5 14.5 19.9477 14.5 20.5V21.5C14.5 22.0523 14.9477 22.5 15.5 22.5H20Z"
+              fill={fill || '#fff'}
+            />
+            <Path
+              d="M1.5 20C1.5 21.3807 2.61929 22.5 4 22.5H8.5C9.05228 22.5 9.5 22.0523 9.5 21.5V20.5C9.5 19.9477 9.05228 19.5 8.5 19.5H4.5V15.5C4.5 14.9477 4.05228 14.5 3.5 14.5H2.5C1.94772 14.5 1.5 14.9477 1.5 15.5V20Z"
+              fill={fill || '#fff'}
+            />
+          </G>
+        </Svg>
+      ) : (
+        <Svg width={size} height={size} viewBox="0 0 24 24" fill="none">
+          <G id="SVGRepo_bgCarrier" strokeWidth={0} />
+          <G
+            id="SVGRepo_tracerCarrier"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+          <G id="SVGRepo_iconCarrier">
+            <Path
+              d="M7 9.5C8.38071 9.5 9.5 8.38071 9.5 7V2.5C9.5 1.94772 9.05228 1.5 8.5 1.5H7.5C6.94772 1.5 6.5 1.94772 6.5 2.5V6.5H2.5C1.94772 6.5 1.5 6.94772 1.5 7.5V8.5C1.5 9.05228 1.94772 9.5 2.5 9.5H7Z"
+              fill={fill || '#fff'}
+            />
+            <Path
+              d="M17 9.5C15.6193 9.5 14.5 8.38071 14.5 7V2.5C14.5 1.94772 14.9477 1.5 15.5 1.5H16.5C17.0523 1.5 17.5 1.94772 17.5 2.5V6.5H21.5C22.0523 6.5 22.5 6.94772 22.5 7.5V8.5C22.5 9.05228 22.0523 9.5 21.5 9.5H17Z"
+              fill={fill || '#fff'}
+            />
+            <Path
+              d="M17 14.5C15.6193 14.5 14.5 15.6193 14.5 17V21.5C14.5 22.0523 14.9477 22.5 15.5 22.5H16.5C17.0523 22.5 17.5 22.0523 17.5 21.5V17.5H21.5C22.0523 17.5 22.5 17.0523 22.5 16.5V15.5C22.5 14.9477 22.0523 14.5 21.5 14.5H17Z"
+              fill={fill || '#fff'}
+            />
+            <Path
+              d="M9.5 17C9.5 15.6193 8.38071 14.5 7 14.5H2.5C1.94772 14.5 1.5 14.9477 1.5 15.5V16.5C1.5 17.0523 1.94772 17.5 2.5 17.5H6.5V21.5C6.5 22.0523 6.94772 22.5 7.5 22.5H8.5C9.05228 22.5 9.5 22.0523 9.5 21.5V17Z"
+              fill={fill || '#fff'}
+            />
+          </G>
+        </Svg>
+      );
+
+    case 'muteUnmute':
+      return type === 'mute' ? (
+        <Svg
+          fill={fill || '#000000'}
+          viewBox="0 0 24 24"
+          width={size || 24}
+          height={size || 24}
+        >
+          <G id="SVGRepo_bgCarrier" strokeWidth={0} />
+          <G
+            id="SVGRepo_tracerCarrier"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+          <G id="SVGRepo_iconCarrier">
+            <Path
+              fillRule="evenodd"
+              d="M11.553 3.064A.75.75 0 0112 3.75v16.5a.75.75 0 01-1.255.555L5.46 16H2.75A1.75 1.75 0 011 14.25v-4.5C1 8.784 1.784 8 2.75 8h2.71l5.285-4.805a.75.75 0 01.808-.13zM10.5 5.445l-4.245 3.86a.75.75 0 01-.505.195h-3a.25.25 0 00-.25.25v4.5c0 .138.112.25.25.25h3a.75.75 0 01.505.195l4.245 3.86V5.445z"
+            />
+            <Path d="M18.718 4.222a.75.75 0 011.06 0c4.296 4.296 4.296 11.26 0 15.556a.75.75 0 01-1.06-1.06 9.5 9.5 0 000-13.436.75.75 0 010-1.06z" />
+            <Path d="M16.243 7.757a.75.75 0 10-1.061 1.061 4.5 4.5 0 010 6.364.75.75 0 001.06 1.06 6 6 0 000-8.485z" />
+          </G>
+        </Svg>
+      ) : (
+        <Svg
+          fill={fill || '#000000'}
+          viewBox="0 0 16 16"
+          width={size || 16}
+          height={size || 16}
+        >
+          <G id="SVGRepo_bgCarrier" strokeWidth={0} />
+          <G
+            id="SVGRepo_tracerCarrier"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+          <G id="SVGRepo_iconCarrier">
+            <Path
+              d="M14.266 1.264l-13 13 .47.472 3.239-3.238L8 14.666V8.473l2.312-2.313c.467.542.737 1.227.737 1.947 0 .796-.316 1.559-.88 2.122l-.353.353.707.707.354-.353a4 4 0 0 0 1.172-2.829c0-.985-.377-1.923-1.03-2.654l1.422-1.422a5.994 5.994 0 0 1 1.608 4.076 5.999 5.999 0 0 1-1.758 4.243l-.354.353.707.707.354-.353a7 7 0 0 0 2.05-4.95 6.994 6.994 0 0 0-1.9-4.783l1.588-1.588zM8 1.334L4.5 5H1.871S1 5.894 1 8.002C1 10.11 1.871 11 1.871 11h1.422L8 6.293z"
+              opacity={1}
+              fill={fill || 'white'}
+            />
+          </G>
+        </Svg>
+      );
+
+    case 'playPause':
+      return type === 'play' ? (
+        <Svg
+          viewBox="0 0 24 24"
+          fill="none"
+          width={size || 24}
+          height={size || 24}
+        >
+          <G id="SVGRepo_bgCarrier" strokeWidth={0} />
+          <G
+            id="SVGRepo_tracerCarrier"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+          <G id="SVGRepo_iconCarrier">
+            <Path
+              d="M21.4086 9.35258C23.5305 10.5065 23.5305 13.4935 21.4086 14.6474L8.59662 21.6145C6.53435 22.736 4 21.2763 4 18.9671L4 5.0329C4 2.72368 6.53435 1.26402 8.59661 2.38548L21.4086 9.35258Z"
+              fill={fill || '#1C274C'}
+            />
+          </G>
+        </Svg>
+      ) : (
+        <Svg
+          viewBox="0 0 24 24"
+          fill="none"
+          width={size || 24}
+          height={size || 24}
+        >
+          <G id="SVGRepo_bgCarrier" strokeWidth={0} />
+          <G
+            id="SVGRepo_tracerCarrier"
+            strokeLinecap="round"
+            strokeLinejoin="round"
+          />
+          <G id="SVGRepo_iconCarrier">
+            <Path
+              d="M2 6C2 4.11438 2 3.17157 2.58579 2.58579C3.17157 2 4.11438 2 6 2C7.88562 2 8.82843 2 9.41421 2.58579C10 3.17157 10 4.11438 10 6V18C10 19.8856 10 20.8284 9.41421 21.4142C8.82843 22 7.88562 22 6 22C4.11438 22 3.17157 22 2.58579 21.4142C2 20.8284 2 19.8856 2 18V6Z"
+              fill={fill || '#1C274C'}
+            />
+            <Path
+              d="M14 6C14 4.11438 14 3.17157 14.5858 2.58579C15.1716 2 16.1144 2 18 2C19.8856 2 20.8284 2 21.4142 2.58579C22 3.17157 22 4.11438 22 6V18C22 19.8856 22 20.8284 21.4142 21.4142C20.8284 22 19.8856 22 18 22C16.1144 22 15.1716 22 14.5858 21.4142C14 20.8284 14 19.8856 14 18V6Z"
+              fill={fill || '#1C274C'}
+            />
+          </G>
+        </Svg>
+      );
+    default:
+      return null;
+  }
+};
+
+export default SvgIcons;

package/src/components/VideoControls.tsx

@@ -11,6 +11,8 @@ import { useVideoManager } from '../provider/VideoContext';
 import { usePlayback } from '../hooks/usePlayback';
 import { formatTime } from '../utils/formatTime';
 import { GestureOverlay } from './GestureOverlay';
+import { CloseIcon } from './icons';
+import SvgIcons from './SvgIcons';
 
 export interface VideoControlsProps {
   /** Seconds jumped by double-tap. Default 10. */
@@ -95,7 +97,7 @@ export function VideoControls({
           <View style={styles.topRow}>
             {onClose ? (
               <Pressable style={styles.button} onPress={onClose} hitSlop={8}>
-                <Text style={styles.icon}>✕</Text>
+                <CloseIcon size={18} color="#fff" />
               </Pressable>
             ) : (
               <View />
@@ -105,7 +107,16 @@ export function VideoControls({
               onPress={() => (muted ? manager.unmute() : manager.mute())}
               hitSlop={8}
             >
-              <Text style={styles.icon}>{muted ? '🔇' : '🔊'}</Text>
+              {muted ? (
+                <SvgIcons icon="muteUnmute" type="mute" size={18} fill="#fff" />
+              ) : (
+                <SvgIcons
+                  icon="muteUnmute"
+                  type="unmute"
+                  size={18}
+                  fill="#fff"
+                />
+              )}
             </Pressable>
           </View>
 
@@ -117,9 +128,13 @@ export function VideoControls({
             }}
             hitSlop={16}
           >
-            <Text style={styles.playIcon}>
-              {buffering ? '…' : playing ? '❙❙' : '▶'}
-            </Text>
+            {buffering ? (
+              <Text style={styles.playIcon}>…</Text>
+            ) : playing ? (
+              <SvgIcons icon="playPause" type="pause" size={34} fill="#fff" />
+            ) : (
+              <SvgIcons icon="playPause" type="play" size={34} fill="#fff" />
+            )}
           </Pressable>
 
           <View style={styles.bottomRow}>
@@ -141,7 +156,16 @@ export function VideoControls({
                 onPress={() => manager.toggleFullscreen()}
                 hitSlop={8}
               >
-                <Text style={styles.icon}>{fullscreen ? '⤡' : '⤢'}</Text>
+                {fullscreen ? (
+                  <SvgIcons icon="fullScreen" size={18} fill="#fff" />
+                ) : (
+                  <SvgIcons
+                    icon="fullScreen"
+                    type="full"
+                    size={18}
+                    fill="#fff"
+                  />
+                )}
               </Pressable>
             ) : null}
           </View>
@@ -206,8 +230,4 @@ const styles = StyleSheet.create({
   button: {
     padding: 4,
   },
-  icon: {
-    color: '#fff',
-    fontSize: 18,
-  },
 });

package/src/components/VideoPlayer.tsx

@@ -24,6 +24,13 @@ export interface VideoPlayerProps extends ViewProps {
    * `'inverted-portrait'`. Released (back to `'auto'`) on unmount.
    */
   orientation?: OrientationLock;
+  /**
+   * Orientation to force ONLY while this player is fullscreen (e.g.
+   * `'portrait'` for a vertical video). Applied when fullscreen opens —
+   * including via the built-in controls' fullscreen button — and restored
+   * when it closes, so the rest of the app is unaffected.
+   */
+  fullscreenOrientation?: OrientationLock;
 }
 
 /**
@@ -42,6 +49,7 @@ export function VideoPlayer({
   controls = true,
   resizeMode,
   orientation,
+  fullscreenOrientation,
   style,
   ...rest
 }: VideoPlayerProps) {
@@ -69,6 +77,14 @@ export function VideoPlayer({
     return () => manager.setOrientation('auto');
   }, [manager, orientation]);
 
+  useEffect(() => {
+    if (!fullscreenOrientation) {
+      return;
+    }
+    manager.setFullscreenOrientation(fullscreenOrientation);
+    return () => manager.setFullscreenOrientation(null);
+  }, [manager, fullscreenOrientation]);
+
   return (
     <View style={[styles.container, style]} {...rest}>
       <VideoSurface surfaceId={id} style={styles.surface} />

package/src/components/icons.tsx

@@ -0,0 +1,117 @@
+import Svg, { Line, Path, Polygon, Rect } from 'react-native-svg';
+
+interface IconProps {
+  size: number;
+  color: string;
+}
+
+export function PlayIcon({ size, color }: IconProps) {
+  return (
+    <Svg width={size} height={size} viewBox="0 0 24 24" fill={color}>
+      <Polygon points="6 3 20 12 6 21 6 3" />
+    </Svg>
+  );
+}
+
+export function PauseIcon({ size, color }: IconProps) {
+  return (
+    <Svg width={size} height={size} viewBox="0 0 24 24" fill={color}>
+      <Rect x="6" y="4" width="4" height="16" />
+      <Rect x="14" y="4" width="4" height="16" />
+    </Svg>
+  );
+}
+
+export function CloseIcon({ size, color }: IconProps) {
+  return (
+    <Svg
+      width={size}
+      height={size}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke={color}
+      strokeWidth={2}
+      strokeLinecap="round"
+    >
+      <Line x1="18" y1="6" x2="6" y2="18" />
+      <Line x1="6" y1="6" x2="18" y2="18" />
+    </Svg>
+  );
+}
+
+export function VolumeOnIcon({ size, color }: IconProps) {
+  return (
+    <Svg
+      width={size}
+      height={size}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke={color}
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    >
+      <Polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5" fill={color} />
+      <Path d="M19.07 4.93a10 10 0 0 1 0 14.14M15.54 8.46a5 5 0 0 1 0 7.07" />
+    </Svg>
+  );
+}
+
+export function VolumeOffIcon({ size, color }: IconProps) {
+  return (
+    <Svg
+      width={size}
+      height={size}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke={color}
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    >
+      <Polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5" fill={color} />
+      <Line x1="23" y1="9" x2="17" y2="15" />
+      <Line x1="17" y1="9" x2="23" y2="15" />
+    </Svg>
+  );
+}
+
+export function EnterFullscreenIcon({ size, color }: IconProps) {
+  return (
+    <Svg
+      width={size}
+      height={size}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke={color}
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    >
+      <Path d="M8 3H5a2 2 0 0 0-2 2v3" />
+      <Path d="M16 3h3a2 2 0 0 1 2 2v3" />
+      <Path d="M21 16v3a2 2 0 0 1-2 2h-3" />
+      <Path d="M3 16v3a2 2 0 0 0 2 2h3" />
+    </Svg>
+  );
+}
+
+export function ExitFullscreenIcon({ size, color }: IconProps) {
+  return (
+    <Svg
+      width={size}
+      height={size}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke={color}
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+    >
+      <Path d="M8 3v3a2 2 0 0 1-2 2H3" />
+      <Path d="M16 3v3a2 2 0 0 0 2 2h3" />
+      <Path d="M21 16h-3a2 2 0 0 0-2 2v3" />
+      <Path d="M3 16h3a2 2 0 0 1 2 2v3" />
+    </Svg>
+  );
+}