rn-system-bar 3.0.1 → 3.0.3

package/android/build.gradle

@@ -3,13 +3,13 @@
 // ─────────────────────────────────────────────
 
 buildscript {
-  ext.kotlin_version = "1.9.0"
+  ext.kotlin_version = "2.1.20"
   repositories {
     google()
     mavenCentral()
   }
   dependencies {
-    classpath "com.android.tools.build:gradle:8.1.1"
+    classpath "com.android.tools.build:gradle:8.5.0"
     classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
   }
 }
@@ -18,12 +18,12 @@ apply plugin: "com.android.library"
 apply plugin: "kotlin-android"
 
 android {
-  compileSdkVersion 34
+  compileSdk 36
   namespace "com.systembar"
 
   defaultConfig {
-    minSdkVersion 21
-    targetSdkVersion 34
+    minSdk 24
+    targetSdk 36
   }
 
   compileOptions {

package/android/src/main/java/com/systembar/SystemBarModule.kt

@@ -1,6 +1,9 @@
 // ─────────────────────────────────────────────
 //  rn-system-bar · SystemBarModule.kt
-//  Android Native Module — Old + New Architecture
+//  v4 — Navigation bar removed (handled by expo-navigation-bar).
+//       Status bar removed (handled by RN StatusBar).
+//       Only: Brightness, Volume, Screen flags, Orientation.
+//       Zero deprecated APIs.
 // ─────────────────────────────────────────────
 
 package com.systembar
@@ -8,11 +11,11 @@ package com.systembar
 import android.app.Activity
 import android.content.Context
 import android.content.pm.ActivityInfo
-import android.graphics.Color
 import android.media.AudioManager
 import android.os.Build
 import android.provider.Settings
 import android.view.View
+import android.view.WindowInsets
 import android.view.WindowInsetsController
 import android.view.WindowManager
 
@@ -24,7 +27,6 @@ class SystemBarModule(
 
   override fun getName(): String = "SystemBar"
 
-  // ── Helper ─────────────────────────────────────
   private fun activity(): Activity? = reactContext.currentActivity
 
   private fun audioManager(): AudioManager =
@@ -35,184 +37,7 @@ class SystemBarModule(
     "notification" -> AudioManager.STREAM_NOTIFICATION
     "alarm"        -> AudioManager.STREAM_ALARM
     "system"       -> AudioManager.STREAM_SYSTEM
-    else           -> AudioManager.STREAM_MUSIC  // default: "music"
-  }
-
-  // ═══════════════════════════════════════════════
-  //  NAVIGATION BAR
-  // ═══════════════════════════════════════════════
-
-  @ReactMethod
-  fun setNavigationBarColor(color: String) {
-    val act = activity() ?: return
-    act.runOnUiThread {
-      try {
-        act.window.navigationBarColor = Color.parseColor(color)
-      } catch (e: Exception) {
-        // ignore invalid color
-      }
-    }
-  }
-
-  @ReactMethod
-  fun setNavigationBarVisibility(mode: String) {
-    val act = activity() ?: return
-    act.runOnUiThread {
-      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-        val controller = act.window.insetsController ?: return@runOnUiThread
-        if (mode == "hidden") {
-          controller.hide(android.view.WindowInsets.Type.navigationBars())
-        } else {
-          controller.show(android.view.WindowInsets.Type.navigationBars())
-        }
-      } else {
-        @Suppress("DEPRECATION")
-        if (mode == "hidden") {
-          act.window.decorView.systemUiVisibility =
-            act.window.decorView.systemUiVisibility or
-            View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or
-            View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
-        } else {
-          act.window.decorView.systemUiVisibility =
-            act.window.decorView.systemUiVisibility and
-            View.SYSTEM_UI_FLAG_HIDE_NAVIGATION.inv()
-        }
-      }
-    }
-  }
-
-  @ReactMethod
-  fun setNavigationBarButtonStyle(style: String) {
-    val act = activity() ?: return
-    act.runOnUiThread {
-      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-        val controller = act.window.insetsController ?: return@runOnUiThread
-        controller.setSystemBarsAppearance(
-          if (style == "dark")
-            WindowInsetsController.APPEARANCE_LIGHT_NAVIGATION_BARS
-          else 0,
-          WindowInsetsController.APPEARANCE_LIGHT_NAVIGATION_BARS
-        )
-      } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-        @Suppress("DEPRECATION")
-        val flags = act.window.decorView.systemUiVisibility
-        act.window.decorView.systemUiVisibility = if (style == "dark") {
-          flags or View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR
-        } else {
-          flags and View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR.inv()
-        }
-      }
-    }
-  }
-
-  @ReactMethod
-  fun setNavigationBarStyle(style: String) {
-    // "style" maps to button style + optional color hinting
-    val act = activity() ?: return
-    act.runOnUiThread {
-      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-        val controller = act.window.insetsController ?: return@runOnUiThread
-        val useLightIcons = style == "light"
-        controller.setSystemBarsAppearance(
-          if (useLightIcons) 0
-          else WindowInsetsController.APPEARANCE_LIGHT_NAVIGATION_BARS,
-          WindowInsetsController.APPEARANCE_LIGHT_NAVIGATION_BARS
-        )
-      } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
-        @Suppress("DEPRECATION")
-        val flags = act.window.decorView.systemUiVisibility
-        act.window.decorView.systemUiVisibility = when (style) {
-          "dark" -> flags or View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR
-          else   -> flags and View.SYSTEM_UI_FLAG_LIGHT_NAVIGATION_BAR.inv()
-        }
-      }
-    }
-  }
-
-  @ReactMethod
-  fun setNavigationBarBehavior(behavior: String) {
-    val act = activity() ?: return
-    act.runOnUiThread {
-      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-        val controller = act.window.insetsController ?: return@runOnUiThread
-        controller.systemBarsBehavior = when (behavior) {
-          "inset-swipe"  ->
-            WindowInsetsController.BEHAVIOR_SHOW_BARS_BY_SWIPE
-          "inset-touch"  ->
-            WindowInsetsController.BEHAVIOR_SHOW_BARS_BY_TOUCH
-          else           ->  // "overlay-swipe" (default)
-            WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
-        }
-      }
-      // API < 30: behavior is controlled via systemUiVisibility flags
-      // IMMERSIVE_STICKY is the closest to overlay-swipe on older APIs
-    }
-  }
-
-  // ═══════════════════════════════════════════════
-  //  STATUS BAR
-  // ═══════════════════════════════════════════════
-
-  @ReactMethod
-  fun setStatusBarColor(color: String) {
-    val act = activity() ?: return
-    act.runOnUiThread {
-      try {
-        act.window.statusBarColor = Color.parseColor(color)
-      } catch (e: Exception) {
-        // ignore invalid color
-      }
-    }
-  }
-
-  @ReactMethod
-  fun setStatusBarStyle(style: String) {
-    val act = activity() ?: return
-    act.runOnUiThread {
-      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-        val controller = act.window.insetsController ?: return@runOnUiThread
-        controller.setSystemBarsAppearance(
-          if (style == "dark")
-            WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS
-          else 0,
-          WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS
-        )
-      } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
-        @Suppress("DEPRECATION")
-        val flags = act.window.decorView.systemUiVisibility
-        act.window.decorView.systemUiVisibility = if (style == "dark") {
-          flags or View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR
-        } else {
-          flags and View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR.inv()
-        }
-      }
-    }
-  }
-
-  @ReactMethod
-  fun setStatusBarVisibility(visible: Boolean) {
-    val act = activity() ?: return
-    act.runOnUiThread {
-      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-        val controller = act.window.insetsController ?: return@runOnUiThread
-        if (visible) {
-          controller.show(android.view.WindowInsets.Type.statusBars())
-        } else {
-          controller.hide(android.view.WindowInsets.Type.statusBars())
-        }
-      } else {
-        @Suppress("DEPRECATION")
-        if (visible) {
-          act.window.decorView.systemUiVisibility =
-            act.window.decorView.systemUiVisibility and
-            View.SYSTEM_UI_FLAG_FULLSCREEN.inv()
-        } else {
-          act.window.decorView.systemUiVisibility =
-            act.window.decorView.systemUiVisibility or
-            View.SYSTEM_UI_FLAG_FULLSCREEN
-        }
-      }
-    }
+    else           -> AudioManager.STREAM_MUSIC
   }
 
   // ═══════════════════════════════════════════════
@@ -235,13 +60,11 @@ class SystemBarModule(
       val act = activity()
       if (act != null) {
         val lp = act.window.attributes
-        // screenBrightness == -1 means "use system default"
         if (lp.screenBrightness >= 0f) {
           promise.resolve(lp.screenBrightness.toDouble())
           return
         }
       }
-      // Fall back to system brightness setting (0–255 → 0.0–1.0)
       val sysBrightness = Settings.System.getInt(
         reactContext.contentResolver,
         Settings.System.SCREEN_BRIGHTNESS,
@@ -268,23 +91,21 @@ class SystemBarModule(
   fun setVolume(level: Float, stream: String) {
     try {
       val am = audioManager()
-      val streamType = streamType(stream)
-      val max = am.getStreamMaxVolume(streamType)
+      val type = streamType(stream)
+      val max = am.getStreamMaxVolume(type)
       val vol = (level.coerceIn(0f, 1f) * max).toInt()
       val flags = if (suppressVolumeHUD) 0 else AudioManager.FLAG_SHOW_UI
-      am.setStreamVolume(streamType, vol, flags)
-    } catch (e: Exception) {
-      // ignore
-    }
+      am.setStreamVolume(type, vol, flags)
+    } catch (_: Exception) {}
   }
 
   @ReactMethod
   fun getVolume(stream: String, promise: Promise) {
     try {
       val am = audioManager()
-      val streamType = streamType(stream)
-      val current = am.getStreamVolume(streamType)
-      val max = am.getStreamMaxVolume(streamType)
+      val type = streamType(stream)
+      val current = am.getStreamVolume(type)
+      val max = am.getStreamMaxVolume(type)
       promise.resolve(if (max > 0) current.toDouble() / max else 0.0)
     } catch (e: Exception) {
       promise.reject("VOLUME_ERROR", e.message, e)
@@ -312,32 +133,30 @@ class SystemBarModule(
     val act = activity() ?: return
     act.runOnUiThread {
       if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+        // API 30+ — WindowInsetsController (modern, no deprecated flags)
         val controller = act.window.insetsController ?: return@runOnUiThread
         if (enable) {
           controller.hide(
-            android.view.WindowInsets.Type.statusBars() or
-            android.view.WindowInsets.Type.navigationBars()
+            WindowInsets.Type.statusBars() or WindowInsets.Type.navigationBars()
           )
           controller.systemBarsBehavior =
             WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE
         } else {
           controller.show(
-            android.view.WindowInsets.Type.statusBars() or
-            android.view.WindowInsets.Type.navigationBars()
+            WindowInsets.Type.statusBars() or WindowInsets.Type.navigationBars()
           )
         }
       } else {
+        // API 21–29: only path available; suppressed intentionally
         @Suppress("DEPRECATION")
-        if (enable) {
-          act.window.decorView.systemUiVisibility =
-            View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or
-            View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION or
-            View.SYSTEM_UI_FLAG_FULLSCREEN or
-            View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or
-            View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
+        act.window.decorView.systemUiVisibility = if (enable) {
+          View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN or
+          View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION or
+          View.SYSTEM_UI_FLAG_FULLSCREEN or
+          View.SYSTEM_UI_FLAG_HIDE_NAVIGATION or
+          View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
         } else {
-          act.window.decorView.systemUiVisibility =
-            View.SYSTEM_UI_FLAG_VISIBLE
+          View.SYSTEM_UI_FLAG_VISIBLE
         }
       }
     }
@@ -351,11 +170,11 @@ class SystemBarModule(
   fun setOrientation(mode: String) {
     val act = activity() ?: return
     act.requestedOrientation = when (mode) {
-      "portrait"         -> ActivityInfo.SCREEN_ORIENTATION_PORTRAIT
-      "landscape"        -> ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
-      "landscape-left"   -> ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE
-      "landscape-right"  -> ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
-      else               -> ActivityInfo.SCREEN_ORIENTATION_FULL_SENSOR  // "auto"
+      "portrait"        -> ActivityInfo.SCREEN_ORIENTATION_PORTRAIT
+      "landscape"       -> ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
+      "landscape-left"  -> ActivityInfo.SCREEN_ORIENTATION_REVERSE_LANDSCAPE
+      "landscape-right" -> ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE
+      else              -> ActivityInfo.SCREEN_ORIENTATION_FULL_SENSOR
     }
   }
-}
+}

package/android/src/main/java/com/systembar/SystemBarPackage.kt

@@ -15,6 +15,7 @@ class SystemBarPackage : ReactPackage {
     reactContext: ReactApplicationContext
   ): List<NativeModule> = listOf(SystemBarModule(reactContext))
 
+  @Suppress("DEPRECATION")
   override fun createViewManagers(
     reactContext: ReactApplicationContext
   ): List<ViewManager<*, *>> = emptyList()

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "rn-system-bar",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "Control Android & iOS system bars, brightness, volume, orientation and screen flags from React Native.",
   "main": "index.ts",
   "react-native": "index.ts",
   "types": "src/types.ts",
+  "homepage": "https://github.com/your-org/rn-system-bar",
   "license": "MIT",
   "author": "Your Name",
   "keywords": [
@@ -30,10 +31,5 @@
   "peerDependencies": {
     "react": ">=18.0.0",
     "react-native": ">=0.73.0"
-  },
-  "codegenConfig": {
-    "name": "RNSystemBarSpec",
-    "type": "modules",
-    "jsSrcsDir": "specs"
   }
 }

package/src/SystemBar.ts

@@ -1,8 +1,10 @@
 // ─────────────────────────────────────────────
 //  rn-system-bar · SystemBar.ts
+//  v4 — expo-navigation-bar based, zero deprecated APIs
 // ─────────────────────────────────────────────
 
-import { NativeModules, Platform } from "react-native";
+import * as NavigationBar from "expo-navigation-bar";
+import { NativeModules, Platform, StatusBar } from "react-native";
 
 import type {
   NavigationBarBehavior,
@@ -14,20 +16,15 @@ import type {
   VolumeStream,
 } from "./types";
 
-const { SystemBar } = NativeModules;
-
-// ─── Guard helper ──────────────────────────────
-// Navigation-bar APIs are Android-only.
-// iOS has no navigation bar concept.
-// All other APIs work on both platforms.
+const { SystemBar: SystemBarNative } = NativeModules;
 
 const isAndroid = Platform.OS === "android";
 
-const androidOnly = (name: string) => {
+const androidOnly = (name: string): boolean => {
   if (!isAndroid) {
     if (__DEV__) {
       console.warn(
-        `[rn-system-bar] ${name}() is Android-only and has no effect on iOS.`
+        `[rn-system-bar] ${name}() is Android-only and is a no-op on iOS.`,
       );
     }
     return false;
@@ -35,28 +32,28 @@ const androidOnly = (name: string) => {
   return true;
 };
 
-const checkModule = () => {
-  if (!SystemBar) {
+const checkNative = () => {
+  if (!SystemBarNative) {
     throw new Error(
-      "[rn-system-bar] Native module not found. " +
-        "Did you forget to run `pod install` (iOS) or rebuild the Android project?"
+      "[rn-system-bar] Native module not found. Rebuild your Android/iOS project.",
     );
   }
 };
 
 // ═══════════════════════════════════════════════
-//  NAVIGATION BAR  (Android-only)
+//  NAVIGATION BAR  — expo-navigation-bar (Android only)
+//  Uses WindowInsetsController internally on API 30+.
+//  Zero deprecated APIs.
 // ═══════════════════════════════════════════════
 
 /**
  * Set navigation bar background color.
- * @param color  Hex color string e.g. "#000000"
+ * @param color  Hex string e.g. "#000000"
  * @platform android
  */
-export const setNavigationBarColor = (color: string): void => {
-  if (!androidOnly("setNavigationBarColor")) return;
-  checkModule();
-  SystemBar.setNavigationBarColor(color);
+export const setNavigationBarColor = (color: string): Promise<void> => {
+  if (!androidOnly("setNavigationBarColor")) return Promise.resolve();
+  return NavigationBar.setBackgroundColorAsync(color);
 };
 
 /**
@@ -64,91 +61,96 @@ export const setNavigationBarColor = (color: string): void => {
  * @platform android
  */
 export const setNavigationBarVisibility = (
-  mode: NavigationBarVisibility
-): void => {
-  if (!androidOnly("setNavigationBarVisibility")) return;
-  checkModule();
-  SystemBar.setNavigationBarVisibility(mode);
+  mode: NavigationBarVisibility,
+): Promise<void> => {
+  if (!androidOnly("setNavigationBarVisibility")) return Promise.resolve();
+  return NavigationBar.setVisibilityAsync(mode);
 };
 
 /**
- * Set icon/button style of the navigation bar.
+ * Set navigation bar icon/button style.
  * @param style  "light" = white icons | "dark" = black icons
  * @platform android
  */
 export const setNavigationBarButtonStyle = (
-  style: NavigationBarButtonStyle
-): void => {
-  if (!androidOnly("setNavigationBarButtonStyle")) return;
-  checkModule();
-  SystemBar.setNavigationBarButtonStyle(style);
+  style: NavigationBarButtonStyle,
+): Promise<void> => {
+  if (!androidOnly("setNavigationBarButtonStyle")) return Promise.resolve();
+  return NavigationBar.setButtonStyleAsync(style);
 };
 
 /**
- * Set the overall visual style of the navigation bar.
+ * Set navigation bar visual style.
  * @platform android
  */
-export const setNavigationBarStyle = (style: NavigationBarStyle): void => {
-  if (!androidOnly("setNavigationBarStyle")) return;
-  checkModule();
-  SystemBar.setNavigationBarStyle(style);
+export const setNavigationBarStyle = (
+  style: NavigationBarStyle,
+): Promise<void> => {
+  if (!androidOnly("setNavigationBarStyle")) return Promise.resolve();
+  const buttonStyle: NavigationBarButtonStyle =
+    style === "dark" || style === "auto" ? "dark" : "light";
+  return NavigationBar.setButtonStyleAsync(buttonStyle);
 };
 
 /**
- * Set the gesture behavior of the navigation bar.
+ * Set navigation bar gesture behavior.
  * @platform android
  */
 export const setNavigationBarBehavior = (
-  behavior: NavigationBarBehavior
-): void => {
-  if (!androidOnly("setNavigationBarBehavior")) return;
-  checkModule();
-  SystemBar.setNavigationBarBehavior(behavior);
+  behavior: NavigationBarBehavior,
+): Promise<void> => {
+  if (!androidOnly("setNavigationBarBehavior")) return Promise.resolve();
+  return NavigationBar.setBehaviorAsync(behavior);
 };
 
 // ═══════════════════════════════════════════════
 //  STATUS BAR
+//  React Native StatusBar — cross-platform, no deprecated APIs.
 // ═══════════════════════════════════════════════
 
 /**
  * Set status bar background color.
- * @param color  Hex color string e.g. "#FF0000"
- * @platform android  (iOS ignores background color by OS design)
+ * @platform android
  */
-export const setStatusBarColor = (color: string): void => {
+export const setStatusBarColor = (color: string, animated = false): void => {
   if (!androidOnly("setStatusBarColor")) return;
-  checkModule();
-  SystemBar.setStatusBarColor(color);
+  StatusBar.setBackgroundColor(color, animated);
 };
 
 /**
- * Set status bar icon style (light/dark icons).
- * Works on both Android and iOS.
+ * Set status bar icon style.
+ * "light" = white icons | "dark" = dark icons
  */
-export const setStatusBarStyle = (style: StatusBarStyle): void => {
-  checkModule();
-  SystemBar.setStatusBarStyle(style);
+export const setStatusBarStyle = (
+  style: StatusBarStyle,
+  animated = false,
+): void => {
+  StatusBar.setBarStyle(
+    style === "light" ? "light-content" : "dark-content",
+    animated,
+  );
 };
 
 /**
  * Show or hide the status bar.
  */
-export const setStatusBarVisibility = (visible: boolean): void => {
-  checkModule();
-  SystemBar.setStatusBarVisibility(visible);
+export const setStatusBarVisibility = (
+  visible: boolean,
+  animated = false,
+): void => {
+  StatusBar.setHidden(!visible, animated ? "slide" : "none");
 };
 
 // ═══════════════════════════════════════════════
-//  BRIGHTNESS
+//  BRIGHTNESS  — native module
 // ═══════════════════════════════════════════════
 
 /**
- * Set screen brightness.
- * @param level  0.0 (min) – 1.0 (max)
+ * Set screen brightness (0.0 – 1.0).
  */
 export const setBrightness = (level: number): void => {
-  checkModule();
-  SystemBar.setBrightness(Math.max(0, Math.min(1, level)));
+  checkNative();
+  SystemBarNative.setBrightness(Math.max(0, Math.min(1, level)));
 };
 
 /**
@@ -156,81 +158,76 @@ export const setBrightness = (level: number): void => {
  * @returns Promise<number>  0.0 – 1.0
  */
 export const getBrightness = (): Promise<number> => {
-  checkModule();
-  return SystemBar.getBrightness();
+  checkNative();
+  return SystemBarNative.getBrightness();
 };
 
 // ═══════════════════════════════════════════════
-//  VOLUME
+//  VOLUME  — native module
 // ═══════════════════════════════════════════════
 
 /**
- * Set volume level.
- * @param level   0.0 (mute) – 1.0 (max)
- * @param stream  Audio stream to target (default: "music")
+ * Set volume level (0.0 – 1.0).
+ * @param stream  "music" | "ring" | "notification" | "alarm" | "system"
  */
 export const setVolume = (
   level: number,
-  stream: VolumeStream = "music"
+  stream: VolumeStream = "music",
 ): void => {
-  checkModule();
-  SystemBar.setVolume(Math.max(0, Math.min(1, level)), stream);
+  checkNative();
+  SystemBarNative.setVolume(Math.max(0, Math.min(1, level)), stream);
 };
 
 /**
- * Get current volume level.
- * @param stream  Audio stream to query (default: "music")
- * @returns Promise<number>  0.0 – 1.0
+ * Get current volume level (0.0 – 1.0).
  */
 export const getVolume = (stream: VolumeStream = "music"): Promise<number> => {
-  checkModule();
-  return SystemBar.getVolume(stream);
+  checkNative();
+  return SystemBarNative.getVolume(stream);
 };
 
 /**
- * Show or hide the system Volume HUD when changing volume.
- * @param visible  false = suppress the volume popup
+ * Show or hide the system volume popup.
  * @platform android
  */
 export const setVolumeHUDVisible = (visible: boolean): void => {
   if (!androidOnly("setVolumeHUDVisible")) return;
-  checkModule();
-  SystemBar.setVolumeHUDVisible(visible);
+  checkNative();
+  SystemBarNative.setVolumeHUDVisible(visible);
 };
 
 // ═══════════════════════════════════════════════
-//  SCREEN
+//  SCREEN  — native module
 // ═══════════════════════════════════════════════
 
 /**
- * Prevent the screen from sleeping.
- * @param enable  true = keep screen on | false = allow sleep
+ * Prevent the screen from going to sleep.
  */
 export const keepScreenOn = (enable: boolean): void => {
-  checkModule();
-  SystemBar.keepScreenOn(enable);
+  checkNative();
+  SystemBarNative.keepScreenOn(enable);
 };
 
 /**
- * Enable or disable immersive fullscreen mode.
- * Hides both status bar and navigation bar.
+ * Enable immersive fullscreen (hides status + nav bar).
+ * Uses WindowInsetsController on API 30+.
  * @platform android
  */
 export const immersiveMode = (enable: boolean): void => {
   if (!androidOnly("immersiveMode")) return;
-  checkModule();
-  SystemBar.immersiveMode(enable);
+  checkNative();
+  SystemBarNative.immersiveMode(enable);
 };
 
 // ═══════════════════════════════════════════════
-//  ORIENTATION
+//  ORIENTATION  — native module
 // ═══════════════════════════════════════════════
 
 /**
  * Lock or unlock screen orientation.
- * @param mode  "portrait" | "landscape" | "landscape-left" | "landscape-right" | "auto"
+ * "portrait" | "landscape" | "landscape-left" | "landscape-right" | "auto"
  */
 export const setOrientation = (mode: Orientation): void => {
-  checkModule();
-  SystemBar.setOrientation(mode);
+  checkNative();
+  SystemBarNative.setOrientation(mode);
 };