rn-system-bar 3.0.3 → 3.1.1

package/ios/SystemBarModule.swift

@@ -1,46 +1,47 @@
 // ─────────────────────────────────────────────
-//  rn-system-bar · SystemBarModule.swift
-//  iOS Native Module
+//  rn-system-bar · SystemBarModule.swift  v5
+//  New: Network, Battery, Haptics, Screencast, FontScale
 // ─────────────────────────────────────────────
 
 import Foundation
 import UIKit
 import AVFoundation
+import CoreHaptics
+import Network
+import SystemConfiguration
 
 @objc(SystemBar)
-class SystemBarModule: NSObject {
+class SystemBarModule: RCTEventEmitter {
 
-  // ── Helper ─────────────────────────────────────
-  private func mainVC() -> UIViewController? {
-    return UIApplication.shared.keyWindow?.rootViewController
+  // ── Event names ────────────────────────────
+  override func supportedEvents() -> [String]! {
+    return [
+      "SystemBar_NetworkChange",
+      "SystemBar_BatteryChange",
+      "SystemBar_ScreencastChange",
+      "SystemBar_FontScaleChange",
+    ]
   }
 
-  // ─────────────────────────────────────────────
-  //  STATUS BAR  (iOS supports these natively)
-  // ─────────────────────────────────────────────
+  override static func requiresMainQueueSetup() -> Bool { return false }
 
-  @objc
-  func setStatusBarStyle(_ style: String) {
-    DispatchQueue.main.async {
-      // Post notification so RN's StatusBar component stays in sync
-      let value = style == "light"
-        ? UIStatusBarStyle.lightContent
-        : UIStatusBarStyle.darkContent
+  // ── Listeners state ────────────────────────
+  private var networkMonitor: NWPathMonitor?
+  private var batteryObservers: [NSObjectProtocol] = []
+  private var screencastObserver: NSObjectProtocol?
+  private var fontScaleObserver: NSObjectProtocol?
+  private var hasListeners = false
 
-      UIApplication.shared.statusBarStyle = value
-    }
-  }
+  override func startObserving() { hasListeners = true  }
+  override func stopObserving()  { hasListeners = false }
 
-  @objc
-  func setStatusBarVisibility(_ visible: Bool) {
-    DispatchQueue.main.async {
-      UIApplication.shared.isStatusBarHidden = !visible
-    }
+  private func emit(_ event: String, body: Any) {
+    if hasListeners { sendEvent(withName: event, body: body) }
   }
 
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
   //  BRIGHTNESS
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
 
   @objc
   func setBrightness(_ level: Float) {
@@ -51,86 +52,244 @@ class SystemBarModule: NSObject {
 
   @objc
   func getBrightness(_ resolve: @escaping RCTPromiseResolveBlock,
-                     rejecter reject: @escaping RCTPromiseRejectBlock) {
-    DispatchQueue.main.async {
-      resolve(Double(UIScreen.main.brightness))
-    }
+                     rejecter reject: RCTPromiseRejectBlock) {
+    DispatchQueue.main.async { resolve(Double(UIScreen.main.brightness)) }
   }
 
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
   //  VOLUME
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
 
-  @objc
-  func setVolume(_ level: Float, stream: String) {
-    // AVAudioSession volume cannot be set programmatically on iOS
-    // (Apple restriction). Use MPVolumeView or inform user.
-    // We silently ignore to prevent crashes.
-  }
+  @objc func setVolume(_ level: Float, stream: String) { /* iOS restriction — no-op */ }
 
   @objc
   func getVolume(_ stream: String,
                  resolver resolve: @escaping RCTPromiseResolveBlock,
-                 rejecter reject: @escaping RCTPromiseRejectBlock) {
-    let session = AVAudioSession.sharedInstance()
-    resolve(Double(session.outputVolume))
+                 rejecter reject: RCTPromiseRejectBlock) {
+    resolve(Double(AVAudioSession.sharedInstance().outputVolume))
   }
 
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
   //  SCREEN
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
 
-  @objc
-  func keepScreenOn(_ enable: Bool) {
-    DispatchQueue.main.async {
-      UIApplication.shared.isIdleTimerDisabled = enable
-    }
+  @objc func keepScreenOn(_ enable: Bool) {
+    DispatchQueue.main.async { UIApplication.shared.isIdleTimerDisabled = enable }
   }
 
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
   //  ORIENTATION
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
 
-  @objc
-  func setOrientation(_ mode: String) {
+  @objc func setOrientation(_ mode: String) {
     DispatchQueue.main.async {
-      var mask: UIInterfaceOrientationMask = .all
+      var mask: UIInterfaceOrientationMask
       switch mode {
-      case "portrait":
-        mask = .portrait
-      case "landscape":
-        mask = .landscape
-      case "landscape-left":
-        mask = .landscapeLeft
-      case "landscape-right":
-        mask = .landscapeRight
-      default: // "auto"
-        mask = .all
+      case "portrait":       mask = .portrait
+      case "landscape":      mask = .landscape
+      case "landscape-left": mask = .landscapeLeft
+      case "landscape-right":mask = .landscapeRight
+      default:               mask = .all
       }
-
-      // iOS 16+
       if #available(iOS 16.0, *) {
-        let windowScene = UIApplication.shared.connectedScenes
-          .first as? UIWindowScene
-        windowScene?.requestGeometryUpdate(
-          .iOS(interfaceOrientations: mask)
-        )
+        (UIApplication.shared.connectedScenes.first as? UIWindowScene)?
+          .requestGeometryUpdate(.iOS(interfaceOrientations: mask))
       } else {
-        // Pre-iOS 16
-        UIDevice.current.setValue(
-          UIInterfaceOrientation.portrait.rawValue,
-          forKey: "orientation"
-        )
+        UIDevice.current.setValue(UIInterfaceOrientation.portrait.rawValue, forKey: "orientation")
+      }
+    }
+  }
+
+  // ═══════════════════════════════════════════════
+  //  🆕 NETWORK INFO
+  // ═══════════════════════════════════════════════
+
+  private func currentNetworkMap() -> [String: Any] {
+    var isConnected = false
+    var type = "unknown"
+
+    // Use NWPathMonitor snapshot via reachability
+    if let reachability = SCNetworkReachabilityCreateWithName(nil, "apple.com") {
+      var flags: SCNetworkReachabilityFlags = []
+      SCNetworkReachabilityGetFlags(reachability, &flags)
+      isConnected = flags.contains(.reachable) && !flags.contains(.connectionRequired)
+      if flags.contains(.isWWAN) { type = "cellular" }
+      else if isConnected        { type = "wifi"      }
+      else                       { type = "none"      }
+    }
+
+    let airplaneMode = false // iOS doesn't expose this to apps
+    return [
+      "type":                type,
+      "isConnected":         isConnected,
+      "isAirplaneMode":      airplaneMode,
+      "ssid":                NSNull(),
+      "cellularGeneration":  NSNull(),
+    ]
+  }
+
+  @objc
+  func getNetworkInfo(_ resolve: @escaping RCTPromiseResolveBlock,
+                      rejecter reject: RCTPromiseRejectBlock) {
+    resolve(currentNetworkMap())
+  }
+
+  @objc func startNetworkListener() {
+    networkMonitor?.cancel()
+    let monitor = NWPathMonitor()
+    monitor.pathUpdateHandler = { [weak self] _ in
+      self?.emit("SystemBar_NetworkChange", body: self?.currentNetworkMap() ?? [:])
+    }
+    monitor.start(queue: DispatchQueue.global(qos: .background))
+    networkMonitor = monitor
+  }
+
+  @objc func stopNetworkListener() {
+    networkMonitor?.cancel(); networkMonitor = nil
+  }
+
+  // ═══════════════════════════════════════════════
+  //  🆕 BATTERY
+  // ═══════════════════════════════════════════════
+
+  private func currentBatteryMap() -> [String: Any] {
+    UIDevice.current.isBatteryMonitoringEnabled = true
+    let raw   = UIDevice.current.batteryLevel  // -1 if unknown
+    let level = raw >= 0 ? Int(raw * 100) : -1
+    let state: String
+    switch UIDevice.current.batteryState {
+    case .charging:    state = "charging"
+    case .full:        state = "full"
+    case .unplugged:   state = "discharging"
+    default:           state = "unknown"
+    }
+    let isCharging = state == "charging" || state == "full"
+    return [
+      "level":      level,
+      "state":      state,
+      "isCharging": isCharging,
+      "isLow":      level >= 0 && level <= 20 && !isCharging,
+    ]
+  }
+
+  @objc
+  func getBatteryInfo(_ resolve: @escaping RCTPromiseResolveBlock,
+                      rejecter reject: RCTPromiseRejectBlock) {
+    UIDevice.current.isBatteryMonitoringEnabled = true
+    resolve(currentBatteryMap())
+  }
+
+  @objc func startBatteryListener() {
+    UIDevice.current.isBatteryMonitoringEnabled = true
+    let nc = NotificationCenter.default
+    batteryObservers = [
+      nc.addObserver(forName: UIDevice.batteryLevelDidChangeNotification,  object: nil, queue: .main) { [weak self] _ in
+        self?.emit("SystemBar_BatteryChange", body: self?.currentBatteryMap() ?? [:])
+      },
+      nc.addObserver(forName: UIDevice.batteryStateDidChangeNotification, object: nil, queue: .main) { [weak self] _ in
+        self?.emit("SystemBar_BatteryChange", body: self?.currentBatteryMap() ?? [:])
+      },
+    ]
+  }
+
+  @objc func stopBatteryListener() {
+    batteryObservers.forEach { NotificationCenter.default.removeObserver($0) }
+    batteryObservers = []
+    UIDevice.current.isBatteryMonitoringEnabled = false
+  }
+
+  // ═══════════════════════════════════════════════
+  //  🆕 HAPTIC FEEDBACK
+  // ═══════════════════════════════════════════════
+
+  @objc func haptic(_ pattern: String) {
+    DispatchQueue.main.async {
+      switch pattern {
+      case "light":
+        UIImpactFeedbackGenerator(style: .light).impactOccurred()
+      case "medium":
+        UIImpactFeedbackGenerator(style: .medium).impactOccurred()
+      case "heavy":
+        UIImpactFeedbackGenerator(style: .heavy).impactOccurred()
+      case "success":
+        UINotificationFeedbackGenerator().notificationOccurred(.success)
+      case "warning":
+        UINotificationFeedbackGenerator().notificationOccurred(.warning)
+      case "error":
+        UINotificationFeedbackGenerator().notificationOccurred(.error)
+      case "selection":
+        UISelectionFeedbackGenerator().selectionChanged()
+      default:
+        UIImpactFeedbackGenerator(style: .medium).impactOccurred()
       }
     }
   }
 
-  // ─────────────────────────────────────────────
-  //  ANDROID-ONLY stubs (no-op on iOS)
-  //  Prevents "module not found" JS errors when
-  //  called without Platform.OS guard
-  // ─────────────────────────────────────────────
+  // ═══════════════════════════════════════════════
+  //  🆕 SCREENCAST
+  // ═══════════════════════════════════════════════
+
+  private func currentScreencastMap() -> [String: Any] {
+    let isCasting = UIScreen.screens.count > 1
+    return [
+      "isCasting":   isCasting,
+      "displayName": isCasting ? "External Display" : NSNull(),
+    ]
+  }
 
+  @objc
+  func getScreencastInfo(_ resolve: @escaping RCTPromiseResolveBlock,
+                         rejecter reject: RCTPromiseRejectBlock) {
+    resolve(currentScreencastMap())
+  }
+
+  @objc func startScreencastListener() {
+    screencastObserver = NotificationCenter.default.addObserver(
+      forName: UIScreen.didConnectNotification, object: nil, queue: .main
+    ) { [weak self] _ in
+      self?.emit("SystemBar_ScreencastChange", body: self?.currentScreencastMap() ?? [:])
+    }
+  }
+
+  @objc func stopScreencastListener() {
+    if let obs = screencastObserver { NotificationCenter.default.removeObserver(obs) }
+    screencastObserver = nil
+  }
+
+  // setSecureScreen — iOS doesn't support this via public API (no-op)
+  @objc func setSecureScreen(_ enable: Bool) {}
+
+  // ═══════════════════════════════════════════════
+  //  🆕 FONT SCALE
+  // ═══════════════════════════════════════════════
+
+  private func currentFontScaleMap() -> [String: Any] {
+    return [
+      "fontScale": Double(UIApplication.shared.preferredContentSizeCategory == .large ? 1.0 : 1.0),
+      "density":   Double(UIScreen.main.scale),
+    ]
+  }
+
+  @objc
+  func getFontScaleInfo(_ resolve: @escaping RCTPromiseResolveBlock,
+                        rejecter reject: RCTPromiseRejectBlock) {
+    resolve(currentFontScaleMap())
+  }
+
+  @objc func startFontScaleListener() {
+    fontScaleObserver = NotificationCenter.default.addObserver(
+      forName: UIContentSizeCategory.didChangeNotification, object: nil, queue: .main
+    ) { [weak self] _ in
+      self?.emit("SystemBar_FontScaleChange", body: self?.currentFontScaleMap() ?? [:])
+    }
+  }
+
+  @objc func stopFontScaleListener() {
+    if let obs = fontScaleObserver { NotificationCenter.default.removeObserver(obs) }
+    fontScaleObserver = nil
+  }
+
+  // ── Android-only stubs ─────────────────────
   @objc func setNavigationBarColor(_ color: String) {}
   @objc func setNavigationBarVisibility(_ mode: String) {}
   @objc func setNavigationBarButtonStyle(_ style: String) {}
@@ -139,7 +298,6 @@ class SystemBarModule: NSObject {
   @objc func setStatusBarColor(_ color: String) {}
   @objc func setVolumeHUDVisible(_ visible: Bool) {}
   @objc func immersiveMode(_ enable: Bool) {}
-
-  // Required by React Native
-  @objc static func requiresMainQueueSetup() -> Bool { return false }
+  @objc func setStatusBarStyle(_ style: String) {}
+  @objc func setStatusBarVisibility(_ visible: Bool) {}
 }

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./src/SystemBar";
+export * from "./src/types";
+export { useSystemBar, useScreencast } from "./src/useSystemBar";
+export type { SystemBarConfig } from "./src/useSystemBar";

package/lib/index.js

@@ -0,0 +1,25 @@
+"use strict";
+// ─────────────────────────────────────────────
+//  rn-system-bar · index.ts
+// ─────────────────────────────────────────────
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useScreencast = exports.useSystemBar = void 0;
+__exportStar(require("./src/SystemBar"), exports);
+__exportStar(require("./src/types"), exports);
+var useSystemBar_1 = require("./src/useSystemBar");
+Object.defineProperty(exports, "useSystemBar", { enumerable: true, get: function () { return useSystemBar_1.useSystemBar; } });
+Object.defineProperty(exports, "useScreencast", { enumerable: true, get: function () { return useSystemBar_1.useScreencast; } });

package/lib/specs/NativeSystemBar.d.ts

@@ -0,0 +1,21 @@
+import type { TurboModule } from "react-native";
+export interface Spec extends TurboModule {
+    setNavigationBarColor(color: string): void;
+    setNavigationBarVisibility(mode: string): void;
+    setNavigationBarButtonStyle(style: string): void;
+    setNavigationBarStyle(style: string): void;
+    setNavigationBarBehavior(behavior: string): void;
+    setStatusBarColor(color: string): void;
+    setStatusBarStyle(style: string): void;
+    setStatusBarVisibility(visible: boolean): void;
+    setBrightness(level: number): void;
+    getBrightness(): Promise<number>;
+    setVolume(level: number, stream: string): void;
+    getVolume(stream: string): Promise<number>;
+    setVolumeHUDVisible(visible: boolean): void;
+    keepScreenOn(enable: boolean): void;
+    immersiveMode(enable: boolean): void;
+    setOrientation(mode: string): void;
+}
+declare const _default: Spec;
+export default _default;

package/lib/specs/NativeSystemBar.js

@@ -0,0 +1,8 @@
+"use strict";
+// ─────────────────────────────────────────────
+//  rn-system-bar · NativeSystemBar.ts
+//  TurboModule spec — New Architecture (JSI)
+// ─────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_native_1 = require("react-native");
+exports.default = react_native_1.TurboModuleRegistry.getEnforcing("SystemBar");

package/lib/src/SystemBar.d.ts

@@ -0,0 +1,20 @@
+import type { NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarStyle, NavigationBarVisibility, Orientation, ScreencastInfo, StatusBarStyle, VolumeStream } from "./types";
+export declare const setNavigationBarColor: (color: string) => void;
+export declare const setNavigationBarVisibility: (mode: NavigationBarVisibility) => Promise<void>;
+export declare const setNavigationBarButtonStyle: (style: NavigationBarButtonStyle) => Promise<void>;
+export declare const setNavigationBarStyle: (style: NavigationBarStyle) => Promise<void>;
+export declare const setNavigationBarBehavior: (behavior: NavigationBarBehavior) => Promise<void>;
+export declare const setStatusBarColor: (color: string, animated?: boolean) => void;
+export declare const setStatusBarStyle: (style: StatusBarStyle, animated?: boolean) => void;
+export declare const setStatusBarVisibility: (visible: boolean, animated?: boolean) => void;
+export declare const setBrightness: (level: number) => void;
+export declare const getBrightness: () => Promise<number>;
+export declare const setVolume: (level: number, stream?: VolumeStream) => void;
+export declare const getVolume: (stream?: VolumeStream) => Promise<number>;
+export declare const setVolumeHUDVisible: (visible: boolean) => void;
+export declare const keepScreenOn: (enable: boolean) => void;
+export declare const immersiveMode: (enable: boolean) => void;
+export declare const setSecureScreen: (enable: boolean) => void;
+export declare const setOrientation: (mode: Orientation) => void;
+export declare const getScreencastInfo: () => Promise<ScreencastInfo>;
+export declare const onScreencastChange: (callback: (info: ScreencastInfo) => void) => (() => void);

package/lib/src/SystemBar.js

@@ -0,0 +1,176 @@
+"use strict";
+// ─────────────────────────────────────────────
+//  rn-system-bar · SystemBar.ts
+// ─────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onScreencastChange = exports.getScreencastInfo = exports.setOrientation = exports.setSecureScreen = exports.immersiveMode = exports.keepScreenOn = exports.setVolumeHUDVisible = exports.getVolume = exports.setVolume = exports.getBrightness = exports.setBrightness = exports.setStatusBarVisibility = exports.setStatusBarStyle = exports.setStatusBarColor = exports.setNavigationBarBehavior = exports.setNavigationBarStyle = exports.setNavigationBarButtonStyle = exports.setNavigationBarVisibility = exports.setNavigationBarColor = void 0;
+const react_native_1 = require("react-native");
+const NavBar = (() => {
+    try {
+        return require("expo-navigation-bar");
+    }
+    catch (_a) {
+        return null;
+    }
+})();
+const { SystemBar: Native } = react_native_1.NativeModules;
+const isAndroid = react_native_1.Platform.OS === "android";
+const androidOnly = (name) => {
+    if (!isAndroid) {
+        if (__DEV__)
+            console.warn(`[rn-system-bar] ${name}() is Android-only, no-op on iOS.`);
+        return false;
+    }
+    return true;
+};
+const checkNative = () => {
+    if (!Native)
+        throw new Error("[rn-system-bar] Native module not found. Rebuild your project.");
+};
+// ═══════════════════════════════════════════════
+//  NAVIGATION BAR  (Android-only)
+//  Color → native Window API (edge-to-edge safe)
+//  Others → expo-navigation-bar (work in edge-to-edge)
+// ═══════════════════════════════════════════════
+const setNavigationBarColor = (color) => {
+    if (!androidOnly("setNavigationBarColor"))
+        return;
+    checkNative();
+    Native.setNavigationBarColor(color);
+};
+exports.setNavigationBarColor = setNavigationBarColor;
+const setNavigationBarVisibility = (mode) => {
+    var _a;
+    if (!androidOnly("setNavigationBarVisibility"))
+        return Promise.resolve();
+    return (_a = NavBar === null || NavBar === void 0 ? void 0 : NavBar.setVisibilityAsync(mode)) !== null && _a !== void 0 ? _a : Promise.resolve();
+};
+exports.setNavigationBarVisibility = setNavigationBarVisibility;
+const setNavigationBarButtonStyle = (style) => {
+    var _a;
+    if (!androidOnly("setNavigationBarButtonStyle"))
+        return Promise.resolve();
+    return (_a = NavBar === null || NavBar === void 0 ? void 0 : NavBar.setButtonStyleAsync(style)) !== null && _a !== void 0 ? _a : Promise.resolve();
+};
+exports.setNavigationBarButtonStyle = setNavigationBarButtonStyle;
+const setNavigationBarStyle = (style) => {
+    var _a;
+    if (!androidOnly("setNavigationBarStyle"))
+        return Promise.resolve();
+    const btn = style === "dark" || style === "auto" ? "dark" : "light";
+    return (_a = NavBar === null || NavBar === void 0 ? void 0 : NavBar.setButtonStyleAsync(btn)) !== null && _a !== void 0 ? _a : Promise.resolve();
+};
+exports.setNavigationBarStyle = setNavigationBarStyle;
+const setNavigationBarBehavior = (behavior) => {
+    var _a;
+    if (!androidOnly("setNavigationBarBehavior"))
+        return Promise.resolve();
+    return (_a = NavBar === null || NavBar === void 0 ? void 0 : NavBar.setBehaviorAsync(behavior)) !== null && _a !== void 0 ? _a : Promise.resolve();
+};
+exports.setNavigationBarBehavior = setNavigationBarBehavior;
+// ═══════════════════════════════════════════════
+//  STATUS BAR
+// ═══════════════════════════════════════════════
+const setStatusBarColor = (color, animated = false) => {
+    if (!androidOnly("setStatusBarColor"))
+        return;
+    react_native_1.StatusBar.setBackgroundColor(color, animated);
+};
+exports.setStatusBarColor = setStatusBarColor;
+const setStatusBarStyle = (style, animated = false) => {
+    react_native_1.StatusBar.setBarStyle(style === "light" ? "light-content" : "dark-content", animated);
+};
+exports.setStatusBarStyle = setStatusBarStyle;
+const setStatusBarVisibility = (visible, animated = false) => {
+    react_native_1.StatusBar.setHidden(!visible, animated ? "slide" : "none");
+};
+exports.setStatusBarVisibility = setStatusBarVisibility;
+// ═══════════════════════════════════════════════
+//  BRIGHTNESS
+//
+//  setBrightness  → updates BOTH window brightness (instant)
+//                   AND system brightness (persisted).
+//                   On first call: opens WRITE_SETTINGS if not granted.
+//
+//  getBrightness  → reads SYSTEM brightness so slider always
+//                   matches the device brightness bar.
+// ═══════════════════════════════════════════════
+const setBrightness = (level) => {
+    checkNative();
+    Native.setBrightness(Math.max(0.01, Math.min(1, level)));
+};
+exports.setBrightness = setBrightness;
+const getBrightness = () => {
+    checkNative();
+    return Native.getBrightness();
+};
+exports.getBrightness = getBrightness;
+// ═══════════════════════════════════════════════
+//  VOLUME
+// ═══════════════════════════════════════════════
+const setVolume = (level, stream = "music") => {
+    checkNative();
+    Native.setVolume(Math.max(0, Math.min(1, level)), stream);
+};
+exports.setVolume = setVolume;
+const getVolume = (stream = "music") => {
+    checkNative();
+    return Native.getVolume(stream);
+};
+exports.getVolume = getVolume;
+const setVolumeHUDVisible = (visible) => {
+    if (!androidOnly("setVolumeHUDVisible"))
+        return;
+    checkNative();
+    Native.setVolumeHUDVisible(visible);
+};
+exports.setVolumeHUDVisible = setVolumeHUDVisible;
+// ═══════════════════════════════════════════════
+//  SCREEN
+// ═══════════════════════════════════════════════
+const keepScreenOn = (enable) => {
+    checkNative();
+    Native.keepScreenOn(enable);
+};
+exports.keepScreenOn = keepScreenOn;
+const immersiveMode = (enable) => {
+    if (!androidOnly("immersiveMode"))
+        return;
+    checkNative();
+    Native.immersiveMode(enable);
+};
+exports.immersiveMode = immersiveMode;
+const setSecureScreen = (enable) => {
+    if (!androidOnly("setSecureScreen"))
+        return;
+    checkNative();
+    Native.setSecureScreen(enable);
+};
+exports.setSecureScreen = setSecureScreen;
+// ═══════════════════════════════════════════════
+//  ORIENTATION
+// ═══════════════════════════════════════════════
+const setOrientation = (mode) => {
+    checkNative();
+    Native.setOrientation(mode);
+};
+exports.setOrientation = setOrientation;
+// ═══════════════════════════════════════════════
+//  SCREENCAST
+// ═══════════════════════════════════════════════
+const getScreencastInfo = () => {
+    checkNative();
+    return Native.getScreencastInfo();
+};
+exports.getScreencastInfo = getScreencastInfo;
+const onScreencastChange = (callback) => {
+    checkNative();
+    const { DeviceEventEmitter } = require("react-native");
+    Native.startScreencastListener();
+    const sub = DeviceEventEmitter.addListener("SystemBar_ScreencastChange", callback);
+    return () => {
+        sub.remove();
+        Native.stopScreencastListener();
+    };
+};
+exports.onScreencastChange = onScreencastChange;

package/lib/src/types.d.ts

@@ -0,0 +1,11 @@
+export type NavigationBarBehavior = "overlay-swipe" | "inset-swipe" | "inset-touch";
+export type NavigationBarButtonStyle = "light" | "dark";
+export type NavigationBarStyle = "auto" | "inverted" | "light" | "dark";
+export type NavigationBarVisibility = "visible" | "hidden";
+export type StatusBarStyle = "light" | "dark";
+export type Orientation = "portrait" | "landscape" | "landscape-left" | "landscape-right" | "auto";
+export type VolumeStream = "music" | "ring" | "notification" | "alarm" | "system";
+export interface ScreencastInfo {
+    isCasting: boolean;
+    displayName: string | null;
+}

package/lib/src/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// ─────────────────────────────────────────────
+//  rn-system-bar · types.ts
+// ─────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });