rn-system-bar 3.2.3 → 3.2.5

package/ios/SystemBarModule.swift

@@ -1,6 +1,5 @@
 // ─────────────────────────────────────────────
-//  rn-system-bar · SystemBarModule.swift  v5
-//  New: Network, Battery, Haptics, Screencast, FontScale
+//  rn-system-bar · SystemBarModule.swift
 // ─────────────────────────────────────────────
 
 import Foundation
@@ -18,7 +17,7 @@ class SystemBarModule: RCTEventEmitter {
     return [
       "SystemBar_NetworkChange",
       "SystemBar_BatteryChange",
-      "SystemBar_ScreencastChange",
+      "SystemBar_SystemScreencastChange",
       "SystemBar_FontScaleChange",
     ]
   }
@@ -77,6 +76,9 @@ class SystemBarModule: RCTEventEmitter {
     DispatchQueue.main.async { UIApplication.shared.isIdleTimerDisabled = enable }
   }
 
+  // setSecureScreen — iOS doesn't support this via public API (no-op)
+  @objc func setSecureScreen(_ enable: Bool) {}
+
   // ═══════════════════════════════════════════════
   //  ORIENTATION
   // ═══════════════════════════════════════════════
@@ -85,11 +87,11 @@ class SystemBarModule: RCTEventEmitter {
     DispatchQueue.main.async {
       var mask: UIInterfaceOrientationMask
       switch mode {
-      case "portrait":       mask = .portrait
-      case "landscape":      mask = .landscape
-      case "landscape-left": mask = .landscapeLeft
-      case "landscape-right":mask = .landscapeRight
-      default:               mask = .all
+      case "portrait":        mask = .portrait
+      case "landscape":       mask = .landscape
+      case "landscape-left":  mask = .landscapeLeft
+      case "landscape-right": mask = .landscapeRight
+      default:                mask = .all
       }
       if #available(iOS 16.0, *) {
         (UIApplication.shared.connectedScenes.first as? UIWindowScene)?
@@ -101,14 +103,13 @@ class SystemBarModule: RCTEventEmitter {
   }
 
   // ═══════════════════════════════════════════════
-  //  🆕 NETWORK INFO
+  //  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)
@@ -118,13 +119,12 @@ class SystemBarModule: RCTEventEmitter {
       else                       { type = "none"      }
     }
 
-    let airplaneMode = false // iOS doesn't expose this to apps
     return [
-      "type":                type,
-      "isConnected":         isConnected,
-      "isAirplaneMode":      airplaneMode,
-      "ssid":                NSNull(),
-      "cellularGeneration":  NSNull(),
+      "type":               type,
+      "isConnected":        isConnected,
+      "isAirplaneMode":     false,   // iOS does not expose this to apps
+      "ssid":               NSNull(),
+      "cellularGeneration": NSNull(),
     ]
   }
 
@@ -145,23 +145,24 @@ class SystemBarModule: RCTEventEmitter {
   }
 
   @objc func stopNetworkListener() {
-    networkMonitor?.cancel(); networkMonitor = nil
+    networkMonitor?.cancel()
+    networkMonitor = nil
   }
 
   // ═══════════════════════════════════════════════
-  //  🆕 BATTERY
+  //  BATTERY
   // ═══════════════════════════════════════════════
 
   private func currentBatteryMap() -> [String: Any] {
     UIDevice.current.isBatteryMonitoringEnabled = true
-    let raw   = UIDevice.current.batteryLevel  // -1 if unknown
+    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"
+    case .charging:  state = "charging"
+    case .full:      state = "full"
+    case .unplugged: state = "discharging"
+    default:         state = "unknown"
     }
     let isCharging = state == "charging" || state == "full"
     return [
@@ -183,10 +184,12 @@ class SystemBarModule: RCTEventEmitter {
     UIDevice.current.isBatteryMonitoringEnabled = true
     let nc = NotificationCenter.default
     batteryObservers = [
-      nc.addObserver(forName: UIDevice.batteryLevelDidChangeNotification,  object: nil, queue: .main) { [weak self] _ in
+      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
+      nc.addObserver(forName: UIDevice.batteryStateDidChangeNotification,
+                     object: nil, queue: .main) { [weak self] _ in
         self?.emit("SystemBar_BatteryChange", body: self?.currentBatteryMap() ?? [:])
       },
     ]
@@ -199,7 +202,7 @@ class SystemBarModule: RCTEventEmitter {
   }
 
   // ═══════════════════════════════════════════════
-  //  🆕 HAPTIC FEEDBACK
+  //  HAPTIC FEEDBACK
   // ═══════════════════════════════════════════════
 
   @objc func haptic(_ pattern: String) {
@@ -226,8 +229,7 @@ class SystemBarModule: RCTEventEmitter {
   }
 
   // ═══════════════════════════════════════════════
-  //  🆕 SYSTEM SCREENCAST  (external display / AirPlay mirror)
-  //  Detects OS-level external screens via UIScreen.
+  //  SYSTEM SCREENCAST  (external display / AirPlay mirror)
   // ═══════════════════════════════════════════════
 
   private func currentSystemScreencastMap() -> [String: Any] {
@@ -251,7 +253,8 @@ class SystemBarModule: RCTEventEmitter {
     screencastObserver = NotificationCenter.default.addObserver(
       forName: UIScreen.didConnectNotification, object: nil, queue: .main
     ) { [weak self] _ in
-      self?.emit("SystemBar_SystemScreencastChange", body: self?.currentSystemScreencastMap() ?? [:])
+      self?.emit("SystemBar_SystemScreencastChange",
+                 body: self?.currentSystemScreencastMap() ?? [:])
     }
   }
 
@@ -261,45 +264,30 @@ class SystemBarModule: RCTEventEmitter {
   }
 
   // ═══════════════════════════════════════════════
-  //  APP-ONLY CAST  (Android MediaRouter — iOS stubs)
-  //  AirPlay is system-managed on iOS; no public API for app-only casting.
-  // ═══════════════════════════════════════════════
-
-  @objc func startAppCastScan() {
-    // iOS: AirPlay is system-managed — no-op. Emit idle state.
-    emit("SystemBar_AppCastChange", body: [
-      "state": "idle", "devices": [], "connectedDevice": NSNull(), "error": NSNull()
-    ])
-  }
-  @objc func stopAppCastScan() {}
-
-  @objc func connectAppCast(_ deviceId: String, pairingPin: String?) {
-    emit("SystemBar_AppCastChange", body: [
-      "state": "idle", "devices": [], "connectedDevice": NSNull(),
-      "error": "App-only cast not supported on iOS"
-    ])
-  }
-
-  @objc func disconnectAppCast() {}
-
-  @objc
-  func getAppCastInfo(_ resolve: @escaping RCTPromiseResolveBlock,
-                      rejecter reject: RCTPromiseRejectBlock) {
-    resolve([
-      "state": "idle", "devices": [], "connectedDevice": NSNull(), "error": NSNull()
-    ])
-  }
-
-  // setSecureScreen — iOS doesn't support this via public API (no-op)
-  @objc func setSecureScreen(_ enable: Bool) {}
-
-  // ═══════════════════════════════════════════════
-  //  🆕 FONT SCALE
+  //  FONT SCALE
   // ═══════════════════════════════════════════════
 
   private func currentFontScaleMap() -> [String: Any] {
+    let category = UIApplication.shared.preferredContentSizeCategory
+    // Map Apple's content size category to a numeric scale factor
+    let scale: Double
+    switch category {
+    case .extraSmall:                         scale = 0.82
+    case .small:                              scale = 0.88
+    case .medium:                             scale = 0.94
+    case .large:                              scale = 1.00   // default
+    case .extraLarge:                         scale = 1.12
+    case .extraExtraLarge:                    scale = 1.24
+    case .extraExtraExtraLarge:               scale = 1.35
+    case .accessibilityMedium:                scale = 1.60
+    case .accessibilityLarge:                 scale = 1.90
+    case .accessibilityExtraLarge:            scale = 2.35
+    case .accessibilityExtraExtraLarge:       scale = 2.75
+    case .accessibilityExtraExtraExtraLarge:  scale = 3.12
+    default:                                  scale = 1.00
+    }
     return [
-      "fontScale": Double(UIApplication.shared.preferredContentSizeCategory == .large ? 1.0 : 1.0),
+      "fontScale": scale,
       "density":   Double(UIScreen.main.scale),
     ]
   }
@@ -323,16 +311,15 @@ class SystemBarModule: RCTEventEmitter {
     fontScaleObserver = nil
   }
 
-  // ── Android-only stubs ─────────────────────
+  // ── Android-only stubs (no-op on iOS) ─────────
   @objc func setNavigationBarColor(_ color: String) {}
   @objc func setNavigationBarVisibility(_ mode: String) {}
   @objc func setNavigationBarButtonStyle(_ style: String) {}
   @objc func setNavigationBarStyle(_ style: String) {}
   @objc func setNavigationBarBehavior(_ behavior: String) {}
-  // color: hex | "transparent" | "translucent" — Android only
   @objc func setStatusBarColor(_ color: String) {}
-  @objc func setVolumeHUDVisible(_ visible: Bool) {}
-  @objc func immersiveMode(_ enable: Bool) {}
   @objc func setStatusBarStyle(_ style: String) {}
   @objc func setStatusBarVisibility(_ visible: Bool) {}
+  @objc func setVolumeHUDVisible(_ visible: Bool) {}
+  @objc func immersiveMode(_ enable: Bool) {}
 }

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./src/SystemBar";
 export * from "./src/types";
 export { setGlobalThemeMode, useTheme } from "./src/useTheme";
-export { useAppCast, useScreencast, useSystemBar, useSystemScreencast, useTheme as useThemeHook, useThemeSystemBar, } from "./src/useSystemBar";
-export type { SystemBarConfig, ThemedSystemBarConfig, UseAppCastReturn, } from "./src/useSystemBar";
+export { useBattery, useFontScale, useNetwork, useScreencast, useSystemBar, useSystemScreencast, useTheme as useThemeHook, useThemeSystemBar, } from "./src/useSystemBar";
+export type { SystemBarConfig, ThemedSystemBarConfig, } from "./src/useSystemBar";

package/lib/index.js

@@ -17,7 +17,7 @@ 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.useThemeSystemBar = exports.useThemeHook = exports.useSystemScreencast = exports.useSystemBar = exports.useScreencast = exports.useAppCast = exports.useTheme = exports.setGlobalThemeMode = void 0;
+exports.useThemeSystemBar = exports.useThemeHook = exports.useSystemScreencast = exports.useSystemBar = exports.useScreencast = exports.useNetwork = exports.useFontScale = exports.useBattery = exports.useTheme = exports.setGlobalThemeMode = void 0;
 // All imperative JS/TS APIs
 __exportStar(require("./src/SystemBar"), exports);
 // All TypeScript types
@@ -28,7 +28,9 @@ Object.defineProperty(exports, "setGlobalThemeMode", { enumerable: true, get: fu
 Object.defineProperty(exports, "useTheme", { enumerable: true, get: function () { return useTheme_1.useTheme; } });
 // React hooks
 var useSystemBar_1 = require("./src/useSystemBar");
-Object.defineProperty(exports, "useAppCast", { enumerable: true, get: function () { return useSystemBar_1.useAppCast; } });
+Object.defineProperty(exports, "useBattery", { enumerable: true, get: function () { return useSystemBar_1.useBattery; } });
+Object.defineProperty(exports, "useFontScale", { enumerable: true, get: function () { return useSystemBar_1.useFontScale; } });
+Object.defineProperty(exports, "useNetwork", { enumerable: true, get: function () { return useSystemBar_1.useNetwork; } });
 Object.defineProperty(exports, "useScreencast", { enumerable: true, get: function () { return useSystemBar_1.useScreencast; } });
 Object.defineProperty(exports, "useSystemBar", { enumerable: true, get: function () { return useSystemBar_1.useSystemBar; } });
 Object.defineProperty(exports, "useSystemScreencast", { enumerable: true, get: function () { return useSystemBar_1.useSystemScreencast; } });

package/lib/src/SystemBar.d.ts

@@ -1,42 +1,17 @@
-import type { AppCastInfo, NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarColorValue, NavigationBarStyle, NavigationBarVisibility, Orientation, StatusBarColorValue, StatusBarStyle, SystemScreencastInfo, VolumeStream } from "./types";
-/**
- * Set the navigation bar background colour.
- *
- * @param color
- *   - Any hex string   →  solid colour        e.g. `"#1a1a2e"`
- *   - `"transparent"`  →  fully transparent   (content draws behind bar)
- *   - `"translucent"`  →  semi-transparent    (system scrim over content)
- *
- * @example
- * setNavigationBarColor("#000000");       // solid black
- * setNavigationBarColor("transparent");   // glass / edge-to-edge
- * setNavigationBarColor("translucent");   // frosted glass
- */
+import type { BatteryInfo, FontScaleInfo, HapticPattern, NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarColorValue, NavigationBarStyle, NavigationBarVisibility, NetworkInfo, Orientation, StatusBarColorValue, StatusBarStyle, SystemScreencastInfo, VolumeStream } from "./types";
 export declare const setNavigationBarColor: (color: NavigationBarColorValue) => void;
-/**
- * Hide or show the navigation bar.
- *
- * @param mode `"visible"` | `"hidden"`
- */
 export declare const setNavigationBarVisibility: (mode: NavigationBarVisibility) => void;
 export declare const setNavigationBarButtonStyle: (style: NavigationBarButtonStyle) => void;
 export declare const setNavigationBarStyle: (style: NavigationBarStyle) => void;
 export declare const setNavigationBarBehavior: (behavior: NavigationBarBehavior) => void;
-/**
- * Set the status bar background colour (Android only).
- *
- * @param color
- *   - Any hex string   →  solid colour
- *   - `"transparent"`  →  fully transparent
- *   - `"translucent"`  →  semi-transparent
- */
 export declare const setStatusBarColor: (color: StatusBarColorValue) => void;
 export declare const setStatusBarStyle: (style: StatusBarStyle) => void;
 export declare const setStatusBarVisibility: (visible: boolean) => void;
 export declare const setBrightness: (level: number) => void;
 export declare const getBrightness: () => Promise<number>;
 /**
- * Subscribe to system brightness changes (polls every 500 ms on Android).
+ * Subscribe to system brightness changes.
+ * Android: polls every 500 ms. iOS: UIScreen brightness.
  * @returns unsubscribe function
  */
 export declare const onBrightnessChange: (callback: (brightness: number) => void) => (() => void);
@@ -44,7 +19,7 @@ export declare const setVolume: (level: number, stream?: VolumeStream) => void;
 export declare const getVolume: (stream?: VolumeStream) => Promise<number>;
 export declare const setVolumeHUDVisible: (visible: boolean) => void;
 /**
- * Subscribe to system volume changes (hardware buttons, other apps).
+ * Subscribe to system volume changes.
  * @returns unsubscribe function
  */
 export declare const onVolumeChange: (callback: (volume: number, stream: VolumeStream) => void) => (() => void);
@@ -53,55 +28,49 @@ export declare const immersiveMode: (enable: boolean) => void;
 export declare const setSecureScreen: (enable: boolean) => void;
 export declare const setOrientation: (mode: Orientation) => void;
 /**
- * One-shot snapshot of system-level external display state.
- * Works on both Android (DisplayManager) and iOS (UIScreen.screens).
+ * One-shot snapshot of the current network state.
  */
-export declare const getSystemScreencastInfo: () => Promise<SystemScreencastInfo>;
+export declare const getNetworkInfo: () => Promise<NetworkInfo>;
 /**
- * Subscribe to system external-display changes.
- * Fires when an HDMI / Miracast / AirPlay display connects or disconnects.
+ * Subscribe to network changes (connectivity, type).
  * @returns unsubscribe function
  */
-export declare const onSystemScreencastChange: (callback: (info: SystemScreencastInfo) => void) => (() => void);
-/** @deprecated Use getSystemScreencastInfo() */
-export declare const getScreencastInfo: () => Promise<SystemScreencastInfo>;
-/** @deprecated Use onSystemScreencastChange() */
-export declare const onScreencastChange: (callback: (info: SystemScreencastInfo) => void) => (() => void);
+export declare const onNetworkChange: (callback: (info: NetworkInfo) => void) => (() => void);
 /**
- * Start scanning for nearby castable devices (Chromecast, TV, etc.).
- * Listen for results via `onAppCastChange`.
- * Android: uses MediaRouter. iOS: no-op (AirPlay is system-only).
+ * One-shot snapshot of the current battery state.
  */
-export declare const startAppCastScan: () => void;
+export declare const getBatteryInfo: () => Promise<BatteryInfo>;
 /**
- * Stop the device discovery scan.
+ * Subscribe to battery level / state changes.
+ * @returns unsubscribe function
  */
-export declare const stopAppCastScan: () => void;
+export declare const onBatteryChange: (callback: (info: BatteryInfo) => void) => (() => void);
 /**
- * Connect to a discovered device and begin casting this app's screen.
- * @param deviceId  The `id` field from `AppCastDevice` (MediaRouter route ID).
- * @param pairingPin  Optional PIN string if `requiresPairing` is true.
+ * Trigger a haptic feedback pattern.
+ * iOS: UIFeedbackGenerator. Android: Vibrator.
+ *
+ * @param pattern "light" | "medium" | "heavy" | "success" | "warning" | "error" | "selection"
  */
-export declare const connectAppCast: (deviceId: string, pairingPin?: string) => void;
+export declare const haptic: (pattern?: HapticPattern) => void;
 /**
- * Disconnect the active in-app cast session.
+ * One-shot snapshot of system-level external display state.
  */
-export declare const disconnectAppCast: () => void;
+export declare const getSystemScreencastInfo: () => Promise<SystemScreencastInfo>;
 /**
- * Get the current in-app cast snapshot (state + device list).
+ * Subscribe to external-display connect / disconnect events.
+ * @returns unsubscribe function
  */
-export declare const getAppCastInfo: () => Promise<AppCastInfo>;
+export declare const onSystemScreencastChange: (callback: (info: SystemScreencastInfo) => void) => (() => void);
 /**
- * Subscribe to in-app cast state changes.
- * Fires on: device discovered/lost, state changes (scanning → connecting → connected),
- * pairing requests, errors.
- *
- * @example
- * const unsub = onAppCastChange((info) => {
- *   if (info.state === "connected") console.log("Casting to", info.connectedDevice?.name);
- *   if (info.error) console.warn("Cast error:", info.error);
- * });
- *
+ * One-shot snapshot of the system font scale and screen density.
+ */
+export declare const getFontScaleInfo: () => Promise<FontScaleInfo>;
+/**
+ * Subscribe to font scale / accessibility text size changes.
  * @returns unsubscribe function
  */
-export declare const onAppCastChange: (callback: (info: AppCastInfo) => void) => (() => void);
+export declare const onFontScaleChange: (callback: (info: FontScaleInfo) => void) => (() => void);
+/** @deprecated Use getSystemScreencastInfo() */
+export declare const getScreencastInfo: () => Promise<SystemScreencastInfo>;
+/** @deprecated Use onSystemScreencastChange() */
+export declare const onScreencastChange: (callback: (info: SystemScreencastInfo) => void) => (() => void);