rn-system-bar 3.2.3 → 3.2.4

package/lib/src/useSystemBar.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useAppCast = exports.useScreencast = exports.useSystemScreencast = exports.useTheme = exports.useThemeSystemBar = exports.useSystemBar = void 0;
+exports.useFontScale = exports.useBattery = exports.useNetwork = exports.useScreencast = exports.useSystemScreencast = exports.useTheme = exports.useThemeSystemBar = exports.useSystemBar = void 0;
 const react_1 = require("react");
 const SystemBar = __importStar(require("./SystemBar"));
 const useTheme_1 = require("./useTheme");
@@ -53,44 +53,34 @@ const useTheme_1 = require("./useTheme");
 //  });
 // ─────────────────────────────────────────────
 const useSystemBar = (config) => {
-    const configRef = (0, react_1.useRef)("");
     const configStr = JSON.stringify(config);
     (0, react_1.useEffect)(() => {
-        if (configRef.current === configStr)
-            return;
-        configRef.current = configStr;
-        const apply = async () => {
-            if (config.navigationBarColor !== undefined)
-                SystemBar.setNavigationBarColor(config.navigationBarColor);
-            if (config.navigationBarVisibility !== undefined)
-                SystemBar.setNavigationBarVisibility(config.navigationBarVisibility);
-            if (config.navigationBarButtonStyle !== undefined)
-                SystemBar.setNavigationBarButtonStyle(config.navigationBarButtonStyle);
-            if (config.navigationBarStyle !== undefined)
-                SystemBar.setNavigationBarStyle(config.navigationBarStyle);
-            if (config.navigationBarBehavior !== undefined)
-                SystemBar.setNavigationBarBehavior(config.navigationBarBehavior);
-            if (config.statusBarColor !== undefined)
-                SystemBar.setStatusBarColor(config.statusBarColor);
-            if (config.statusBarStyle !== undefined)
-                SystemBar.setStatusBarStyle(config.statusBarStyle);
-            if (config.statusBarVisible !== undefined)
-                SystemBar.setStatusBarVisibility(config.statusBarVisible);
-            if (config.keepScreenOn !== undefined)
-                SystemBar.keepScreenOn(config.keepScreenOn);
-            if (config.immersiveMode !== undefined)
-                SystemBar.immersiveMode(config.immersiveMode);
-            if (config.brightness !== undefined)
-                SystemBar.setBrightness(config.brightness);
-            if (config.orientation !== undefined)
-                SystemBar.setOrientation(config.orientation);
-            if (config.secureScreen !== undefined)
-                SystemBar.setSecureScreen(config.secureScreen);
-        };
-        apply().catch(() => {
-            if (__DEV__)
-                console.warn("[rn-system-bar] useSystemBar: one or more settings failed.");
-        });
+        if (config.navigationBarColor !== undefined)
+            SystemBar.setNavigationBarColor(config.navigationBarColor);
+        if (config.navigationBarVisibility !== undefined)
+            SystemBar.setNavigationBarVisibility(config.navigationBarVisibility);
+        if (config.navigationBarButtonStyle !== undefined)
+            SystemBar.setNavigationBarButtonStyle(config.navigationBarButtonStyle);
+        if (config.navigationBarStyle !== undefined)
+            SystemBar.setNavigationBarStyle(config.navigationBarStyle);
+        if (config.navigationBarBehavior !== undefined)
+            SystemBar.setNavigationBarBehavior(config.navigationBarBehavior);
+        if (config.statusBarColor !== undefined)
+            SystemBar.setStatusBarColor(config.statusBarColor);
+        if (config.statusBarStyle !== undefined)
+            SystemBar.setStatusBarStyle(config.statusBarStyle);
+        if (config.statusBarVisible !== undefined)
+            SystemBar.setStatusBarVisibility(config.statusBarVisible);
+        if (config.keepScreenOn !== undefined)
+            SystemBar.keepScreenOn(config.keepScreenOn);
+        if (config.immersiveMode !== undefined)
+            SystemBar.immersiveMode(config.immersiveMode);
+        if (config.brightness !== undefined)
+            SystemBar.setBrightness(config.brightness);
+        if (config.orientation !== undefined)
+            SystemBar.setOrientation(config.orientation);
+        if (config.secureScreen !== undefined)
+            SystemBar.setSecureScreen(config.secureScreen);
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [configStr]);
 };
@@ -110,12 +100,6 @@ var useTheme_2 = require("./useTheme");
 Object.defineProperty(exports, "useTheme", { enumerable: true, get: function () { return useTheme_2.useTheme; } });
 // ─────────────────────────────────────────────
 //  useSystemScreencast
-//  Tracks OS-level external display state.
-//  Android: DisplayManager (HDMI / Miracast / Presentation display).
-//  iOS:     UIScreen.screens (AirPlay mirror).
-//
-//  @example
-//  const { isCasting, displayName, displays } = useSystemScreencast();
 // ─────────────────────────────────────────────
 const useSystemScreencast = () => {
     const [info, setInfo] = (0, react_1.useState)({
@@ -133,8 +117,7 @@ const useSystemScreencast = () => {
     return info;
 };
 exports.useSystemScreencast = useSystemScreencast;
-/** @deprecated Renamed to useSystemScreencast() */
-// useSystemBar.ts — useScreencast
+/** @deprecated Use useSystemScreencast() */
 const useScreencast = () => {
     const [info, setInfo] = (0, react_1.useState)({
         isCasting: false,
@@ -142,7 +125,6 @@ const useScreencast = () => {
         displays: [],
     });
     (0, react_1.useEffect)(() => {
-        // Guard: if method doesn't exist on native module, bail silently
         SystemBar.getScreencastInfo()
             .then(setInfo)
             .catch(() => {
@@ -153,38 +135,88 @@ const useScreencast = () => {
         try {
             unsub = SystemBar.onScreencastChange(setInfo);
         }
-        catch (_a) {
-            // native listener not available
-        }
+        catch (_a) { }
         return () => unsub === null || unsub === void 0 ? void 0 : unsub();
     }, []);
     return info;
 };
 exports.useScreencast = useScreencast;
-const useAppCast = () => {
+// ─────────────────────────────────────────────
+//  useNetwork
+// ─────────────────────────────────────────────
+/**
+ * Subscribe to network state. Fires immediately with the current snapshot,
+ * then on every connectivity change.
+ *
+ * @example
+ * const { isConnected, type } = useNetwork();
+ */
+const useNetwork = () => {
     const [info, setInfo] = (0, react_1.useState)({
-        state: "idle",
-        devices: [],
-        connectedDevice: null,
-        error: null,
+        type: "unknown",
+        isConnected: false,
+        isAirplaneMode: false,
+        ssid: null,
+        cellularGeneration: null,
     });
     (0, react_1.useEffect)(() => {
-        // Sync initial state
-        SystemBar.getAppCastInfo()
+        SystemBar.getNetworkInfo()
             .then(setInfo)
             .catch(() => { });
-        // Subscribe to all cast events (device found/lost, state changes, errors)
-        const unsub = SystemBar.onAppCastChange(setInfo);
-        return () => {
-            unsub();
-            // Auto-stop scan on unmount — avoids background battery drain
-            SystemBar.stopAppCastScan();
-        };
+        const unsub = SystemBar.onNetworkChange(setInfo);
+        return () => unsub();
     }, []);
-    const scan = (0, react_1.useCallback)(() => SystemBar.startAppCastScan(), []);
-    const stopScan = (0, react_1.useCallback)(() => SystemBar.stopAppCastScan(), []);
-    const connect = (0, react_1.useCallback)((id, pin) => SystemBar.connectAppCast(id, pin), []);
-    const disconnect = (0, react_1.useCallback)(() => SystemBar.disconnectAppCast(), []);
-    return Object.assign(Object.assign({}, info), { scan, stopScan, connect, disconnect });
+    return info;
+};
+exports.useNetwork = useNetwork;
+// ─────────────────────────────────────────────
+//  useBattery
+// ─────────────────────────────────────────────
+/**
+ * Subscribe to battery state. Fires immediately with the current snapshot,
+ * then on every level / state change.
+ *
+ * @example
+ * const { level, isCharging, isLow } = useBattery();
+ */
+const useBattery = () => {
+    const [info, setInfo] = (0, react_1.useState)({
+        level: -1,
+        state: "unknown",
+        isCharging: false,
+        isLow: false,
+    });
+    (0, react_1.useEffect)(() => {
+        SystemBar.getBatteryInfo()
+            .then(setInfo)
+            .catch(() => { });
+        const unsub = SystemBar.onBatteryChange(setInfo);
+        return () => unsub();
+    }, []);
+    return info;
+};
+exports.useBattery = useBattery;
+// ─────────────────────────────────────────────
+//  useFontScale
+// ─────────────────────────────────────────────
+/**
+ * Subscribe to system font scale changes (accessibility text size).
+ *
+ * @example
+ * const { fontScale, density } = useFontScale();
+ */
+const useFontScale = () => {
+    const [info, setInfo] = (0, react_1.useState)({
+        fontScale: 1,
+        density: 1,
+    });
+    (0, react_1.useEffect)(() => {
+        SystemBar.getFontScaleInfo()
+            .then(setInfo)
+            .catch(() => { });
+        const unsub = SystemBar.onFontScaleChange(setInfo);
+        return () => unsub();
+    }, []);
+    return info;
 };
-exports.useAppCast = useAppCast;
+exports.useFontScale = useFontScale;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rn-system-bar",
-  "version": "3.2.3",
+  "version": "3.2.4",
   "description": "Control Android & iOS system bars, brightness, volume, orientation and screen flags from React Native.",
   "main": "lib/index.js",
   "react-native": "lib/index.js",

package/src/SystemBar.ts

@@ -1,19 +1,20 @@
 // ─────────────────────────────────────────────
 //  rn-system-bar · SystemBar.ts
-//  Zero expo-navigation-bar dependency.
-//  All APIs → native Kotlin / iOS Swift.
+//  All APIs → native Kotlin (Android) / Swift (iOS)
 // ─────────────────────────────────────────────
 
 import { NativeModules, Platform } from "react-native";
 
 import type {
-  AppCastInfo,
-  AppCastState,
+  BatteryInfo,
+  FontScaleInfo,
+  HapticPattern,
   NavigationBarBehavior,
   NavigationBarButtonStyle,
   NavigationBarColorValue,
   NavigationBarStyle,
   NavigationBarVisibility,
+  NetworkInfo,
   Orientation,
   StatusBarColorValue,
   StatusBarStyle,
@@ -46,33 +47,15 @@ const checkNative = (method?: string) => {
 };
 
 // ═══════════════════════════════════════════════
-//  NAVIGATION BAR  (Android — 100% native)
+//  NAVIGATION BAR  (Android only)
 // ═══════════════════════════════════════════════
 
-/**
- * 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
- */
 export const setNavigationBarColor = (color: NavigationBarColorValue): void => {
   if (!androidOnly("setNavigationBarColor")) return;
   checkNative();
-  Native.setNavigationBarColor(color); // Kotlin handles the special values
+  Native.setNavigationBarColor(color);
 };
 
-/**
- * Hide or show the navigation bar.
- *
- * @param mode `"visible"` | `"hidden"`
- */
 export const setNavigationBarVisibility = (
   mode: NavigationBarVisibility,
 ): void => {
@@ -104,17 +87,9 @@ export const setNavigationBarBehavior = (
 };
 
 // ═══════════════════════════════════════════════
-//  STATUS BAR  (native — no RN StatusBar)
+//  STATUS BAR
 // ═══════════════════════════════════════════════
 
-/**
- * Set the status bar background colour (Android only).
- *
- * @param color
- *   - Any hex string   →  solid colour
- *   - `"transparent"`  →  fully transparent
- *   - `"translucent"`  →  semi-transparent
- */
 export const setStatusBarColor = (color: StatusBarColorValue): void => {
   if (!androidOnly("setStatusBarColor")) return;
   checkNative();
@@ -146,7 +121,8 @@ export 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 const onBrightnessChange = (
@@ -189,7 +165,7 @@ export const setVolumeHUDVisible = (visible: boolean): void => {
 };
 
 /**
- * Subscribe to system volume changes (hardware buttons, other apps).
+ * Subscribe to system volume changes.
  * @returns unsubscribe function
  */
 export const onVolumeChange = (
@@ -240,155 +216,162 @@ export const setOrientation = (mode: Orientation): void => {
 };
 
 // ═══════════════════════════════════════════════
-//  SYSTEM SCREENCAST  (external display / HDMI / Miracast)
-//  Reads DisplayManager — detects any externally mirrored display.
+//  NETWORK
 // ═══════════════════════════════════════════════
 
 /**
- * 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 const getSystemScreencastInfo = (): Promise<SystemScreencastInfo> => {
-  if (!Native || typeof Native.getSystemScreencastInfo !== "function") {
-    if (__DEV__)
-      console.warn(
-        "[rn-system-bar] getSystemScreencastInfo not available on this build.",
-      );
-    return Promise.resolve({
-      isCasting: false,
-      displayName: null,
-      displays: [],
-    });
-  }
-  return Native.getSystemScreencastInfo();
+export const getNetworkInfo = (): Promise<NetworkInfo> => {
+  checkNative("getNetworkInfo");
+  return Native.getNetworkInfo();
 };
 
 /**
- * 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 const onSystemScreencastChange = (
-  callback: (info: SystemScreencastInfo) => void,
+export const onNetworkChange = (
+  callback: (info: NetworkInfo) => void,
 ): (() => void) => {
   checkNative();
   const { DeviceEventEmitter } = require("react-native");
-  Native.startSystemScreencastListener();
+  Native.startNetworkListener();
   const sub = DeviceEventEmitter.addListener(
-    "SystemBar_SystemScreencastChange",
+    "SystemBar_NetworkChange",
     callback,
   );
   return () => {
     sub.remove();
-    Native.stopSystemScreencastListener();
+    Native.stopNetworkListener();
   };
 };
 
-// ─────────────────────────────────────────────
-//  Legacy aliases (backward compat)
-// ─────────────────────────────────────────────
-/** @deprecated Use getSystemScreencastInfo() */
-export const getScreencastInfo = getSystemScreencastInfo;
-/** @deprecated Use onSystemScreencastChange() */
-export const onScreencastChange = onSystemScreencastChange;
-
 // ═══════════════════════════════════════════════
-//  APP-ONLY CAST  (MediaRouter — Chromecast / TV)
-//  Mirrors only this app's screen — NOT the whole system.
-//  Flow:  startAppCastScan() → onAppCastChange (devices arrive)
-//         → connectAppCast(deviceId) → onAppCastChange (state = "connected")
-//         → disconnectAppCast()
+//  BATTERY
 // ═══════════════════════════════════════════════
 
 /**
- * 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 const startAppCastScan = (): void => {
-  if (!androidOnly("startAppCastScan")) return;
-  checkNative();
-  Native.startAppCastScan();
+export const getBatteryInfo = (): Promise<BatteryInfo> => {
+  checkNative("getBatteryInfo");
+  return Native.getBatteryInfo();
 };
 
 /**
- * Stop the device discovery scan.
+ * Subscribe to battery level / state changes.
+ * @returns unsubscribe function
  */
-export const stopAppCastScan = (): void => {
-  if (!androidOnly("stopAppCastScan")) return;
+export const onBatteryChange = (
+  callback: (info: BatteryInfo) => void,
+): (() => void) => {
   checkNative();
-  Native.stopAppCastScan();
+  const { DeviceEventEmitter } = require("react-native");
+  Native.startBatteryListener();
+  const sub = DeviceEventEmitter.addListener(
+    "SystemBar_BatteryChange",
+    callback,
+  );
+  return () => {
+    sub.remove();
+    Native.stopBatteryListener();
+  };
 };
 
-/**
- * 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.
- */
-export const connectAppCast = (deviceId: string, pairingPin?: string): void => {
-  if (!androidOnly("connectAppCast")) return;
-  checkNative();
-  Native.connectAppCast(deviceId, pairingPin ?? null);
-};
+// ═══════════════════════════════════════════════
+//  HAPTICS
+// ═══════════════════════════════════════════════
 
 /**
- * Disconnect the active in-app cast session.
+ * Trigger a haptic feedback pattern.
+ * iOS: UIFeedbackGenerator. Android: Vibrator.
+ *
+ * @param pattern "light" | "medium" | "heavy" | "success" | "warning" | "error" | "selection"
  */
-export const disconnectAppCast = (): void => {
-  if (!androidOnly("disconnectAppCast")) return;
+export const haptic = (pattern: HapticPattern = "medium"): void => {
   checkNative();
-  Native.disconnectAppCast();
+  Native.haptic(pattern);
 };
 
+// ═══════════════════════════════════════════════
+//  SYSTEM SCREENCAST  (external display / HDMI / Miracast / AirPlay)
+// ═══════════════════════════════════════════════
+
 /**
- * Get the current in-app cast snapshot (state + device list).
+ * One-shot snapshot of system-level external display state.
  */
-export const getAppCastInfo = (): Promise<AppCastInfo> => {
-  if (!isAndroid) {
+export const getSystemScreencastInfo = (): Promise<SystemScreencastInfo> => {
+  if (!Native || typeof Native.getSystemScreencastInfo !== "function") {
+    if (__DEV__)
+      console.warn(
+        "[rn-system-bar] getSystemScreencastInfo not available on this build.",
+      );
     return Promise.resolve({
-      state: "idle" as AppCastState,
-      devices: [],
-      connectedDevice: null,
-      error: null,
+      isCasting: false,
+      displayName: null,
+      displays: [],
     });
   }
+  return Native.getSystemScreencastInfo();
+};
+
+/**
+ * Subscribe to external-display connect / disconnect events.
+ * @returns unsubscribe function
+ */
+export const onSystemScreencastChange = (
+  callback: (info: SystemScreencastInfo) => void,
+): (() => void) => {
   checkNative();
-  return Native.getAppCastInfo();
+  const { DeviceEventEmitter } = require("react-native");
+  Native.startSystemScreencastListener();
+  const sub = DeviceEventEmitter.addListener(
+    "SystemBar_SystemScreencastChange",
+    callback,
+  );
+  return () => {
+    sub.remove();
+    Native.stopSystemScreencastListener();
+  };
 };
 
+// ═══════════════════════════════════════════════
+//  FONT SCALE
+// ═══════════════════════════════════════════════
+
 /**
- * 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 const getFontScaleInfo = (): Promise<FontScaleInfo> => {
+  checkNative("getFontScaleInfo");
+  return Native.getFontScaleInfo();
+};
+
+/**
+ * Subscribe to font scale / accessibility text size changes.
  * @returns unsubscribe function
  */
-export const onAppCastChange = (
-  callback: (info: AppCastInfo) => void,
+export const onFontScaleChange = (
+  callback: (info: FontScaleInfo) => void,
 ): (() => void) => {
-  if (!isAndroid) {
-    // iOS: immediately call with idle state, return no-op
-    callback({
-      state: "idle",
-      devices: [],
-      connectedDevice: null,
-      error: null,
-    });
-    return () => {};
-  }
   checkNative();
   const { DeviceEventEmitter } = require("react-native");
+  Native.startFontScaleListener();
   const sub = DeviceEventEmitter.addListener(
-    "SystemBar_AppCastChange",
+    "SystemBar_FontScaleChange",
     callback,
   );
   return () => {
     sub.remove();
+    Native.stopFontScaleListener();
   };
 };
+
+// ─────────────────────────────────────────────
+//  Legacy aliases (backward compat)
+// ─────────────────────────────────────────────
+/** @deprecated Use getSystemScreencastInfo() */
+export const getScreencastInfo = getSystemScreencastInfo;
+/** @deprecated Use onSystemScreencastChange() */
+export const onScreencastChange = onSystemScreencastChange;