rn-system-bar 3.1.0 → 3.1.3

package/src/SystemBar.ts

@@ -1,27 +1,20 @@
 // ─────────────────────────────────────────────
-//  rn-system-bar · SystemBar.ts  v5
-//  All features — Android + iOS
+//  rn-system-bar · SystemBar.ts
 // ─────────────────────────────────────────────
 
-import { NativeModules, Platform, StatusBar, Vibration } from "react-native";
+import { NativeModules, Platform, StatusBar } from "react-native";
 
 import type {
-  BatteryInfo,
-  FontScaleInfo,
-  HapticPattern,
   NavigationBarBehavior,
   NavigationBarButtonStyle,
   NavigationBarStyle,
   NavigationBarVisibility,
-  NetworkInfo,
   Orientation,
   ScreencastInfo,
   StatusBarStyle,
   VolumeStream,
 } from "./types";
 
-// expo-navigation-bar — peer dep, loaded at runtime
-// eslint-disable-next-line @typescript-eslint/no-var-requires
 const NavBar = (() => {
   try { return require("expo-navigation-bar"); }
   catch { return null; }
@@ -30,7 +23,6 @@ const NavBar = (() => {
 const { SystemBar: Native } = NativeModules;
 
 const isAndroid = Platform.OS === "android";
-const isIOS     = Platform.OS === "ios";
 
 const androidOnly = (name: string): boolean => {
   if (!isAndroid) {
@@ -45,12 +37,15 @@ const checkNative = () => {
 };
 
 // ═══════════════════════════════════════════════
-//  NAVIGATION BAR  (Android — expo-navigation-bar)
+//  NAVIGATION BAR  (Android-only)
+//  Color → native Window API (edge-to-edge safe)
+//  Others → expo-navigation-bar (work in edge-to-edge)
 // ═══════════════════════════════════════════════
 
-export const setNavigationBarColor = (color: string): Promise<void> => {
-  if (!androidOnly("setNavigationBarColor")) return Promise.resolve();
-  return NavBar?.setBackgroundColorAsync(color) ?? Promise.resolve();
+export const setNavigationBarColor = (color: string): void => {
+  if (!androidOnly("setNavigationBarColor")) return;
+  checkNative();
+  Native.setNavigationBarColor(color);
 };
 
 export const setNavigationBarVisibility = (mode: NavigationBarVisibility): Promise<void> => {
@@ -93,11 +88,18 @@ export const setStatusBarVisibility = (visible: boolean, animated = false): void
 
 // ═══════════════════════════════════════════════
 //  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.
 // ═══════════════════════════════════════════════
 
 export const setBrightness = (level: number): void => {
   checkNative();
-  Native.setBrightness(Math.max(0, Math.min(1, level)));
+  Native.setBrightness(Math.max(0.01, Math.min(1, level)));
 };
 
 export const getBrightness = (): Promise<number> => {
@@ -140,121 +142,30 @@ export const immersiveMode = (enable: boolean): void => {
   Native.immersiveMode(enable);
 };
 
-// ═══════════════════════════════════════════════
-//  ORIENTATION
-// ═══════════════════════════════════════════════
-
-export const setOrientation = (mode: Orientation): void => {
-  checkNative();
-  Native.setOrientation(mode);
-};
-
-// ═══════════════════════════════════════════════
-//  🆕 NETWORK INFO
-// ═══════════════════════════════════════════════
-
-/**
- * Get current network connection info.
- * Includes: type, isConnected, isAirplaneMode, ssid, cellularGeneration
- */
-export const getNetworkInfo = (): Promise<NetworkInfo> => {
-  checkNative();
-  return Native.getNetworkInfo();
-};
-
-/**
- * Subscribe to network changes.
- * @returns unsubscribe function — call it in useEffect cleanup
- * @example
- * const unsub = onNetworkChange((info) => console.log(info));
- * return () => unsub();
- */
-export const onNetworkChange = (
-  callback: (info: NetworkInfo) => void
-): (() => void) => {
+export const setSecureScreen = (enable: boolean): void => {
+  if (!androidOnly("setSecureScreen")) return;
   checkNative();
-  // Native side emits "SystemBar_NetworkChange" events
-  const { DeviceEventEmitter } = require("react-native");
-  Native.startNetworkListener();
-  const sub = DeviceEventEmitter.addListener("SystemBar_NetworkChange", callback);
-  return () => {
-    sub.remove();
-    Native.stopNetworkListener();
-  };
+  Native.setSecureScreen(enable);
 };
 
 // ═══════════════════════════════════════════════
-//  🆕 BATTERY
+//  ORIENTATION
 // ═══════════════════════════════════════════════
 
-/**
- * Get current battery info: level (0–100), state, isCharging, isLow.
- */
-export const getBatteryInfo = (): Promise<BatteryInfo> => {
-  checkNative();
-  return Native.getBatteryInfo();
-};
-
-/**
- * Subscribe to battery level / state changes.
- * @returns unsubscribe function
- */
-export const onBatteryChange = (
-  callback: (info: BatteryInfo) => void
-): (() => void) => {
+export const setOrientation = (mode: Orientation): void => {
   checkNative();
-  const { DeviceEventEmitter } = require("react-native");
-  Native.startBatteryListener();
-  const sub = DeviceEventEmitter.addListener("SystemBar_BatteryChange", callback);
-  return () => {
-    sub.remove();
-    Native.stopBatteryListener();
-  };
-};
-
-// ═══════════════════════════════════════════════
-//  🆕 HAPTIC FEEDBACK
-// ═══════════════════════════════════════════════
-
-/**
- * Trigger haptic feedback.
- *
- * iOS: Uses UIImpactFeedbackGenerator / UINotificationFeedbackGenerator.
- * Android: Uses Vibrator / VibrationEffect (API 26+).
- *
- * @param pattern  "light" | "medium" | "heavy" | "success" | "warning" | "error" | "selection"
- */
-export const haptic = (pattern: HapticPattern): void => {
-  if (isIOS) {
-    checkNative();
-    Native.haptic(pattern);
-    return;
-  }
-
-  // Android fallback using RN's built-in Vibration API
-  // when native module is unavailable
-  if (isAndroid) {
-    checkNative();
-    Native.haptic(pattern);
-  }
+  Native.setOrientation(mode);
 };
 
 // ═══════════════════════════════════════════════
-//  🆕 SCREENCAST DETECTION
+//  SCREENCAST
 // ═══════════════════════════════════════════════
 
-/**
- * Check if screen is currently being cast or mirrored.
- */
 export const getScreencastInfo = (): Promise<ScreencastInfo> => {
   checkNative();
   return Native.getScreencastInfo();
 };
 
-/**
- * Subscribe to screencast state changes (started / stopped).
- * @returns unsubscribe function
- */
 export const onScreencastChange = (
   callback: (info: ScreencastInfo) => void
 ): (() => void) => {
@@ -267,44 +178,3 @@ export const onScreencastChange = (
     Native.stopScreencastListener();
   };
 };
-
-/**
- * Prevent screen content from appearing in screenshots / recordings.
- * Useful for sensitive screens (payments, passwords).
- * @platform android
- */
-export const setSecureScreen = (enable: boolean): void => {
-  if (!androidOnly("setSecureScreen")) return;
-  checkNative();
-  Native.setSecureScreen(enable);
-};
-
-// ═══════════════════════════════════════════════
-//  🆕 FONT SCALE / DISPLAY INFO
-// ═══════════════════════════════════════════════
-
-/**
- * Get current system font scale and display density.
- * Useful for adapting layout to accessibility settings.
- */
-export const getFontScaleInfo = (): Promise<FontScaleInfo> => {
-  checkNative();
-  return Native.getFontScaleInfo();
-};
-
-/**
- * Subscribe to font scale changes (user changes system text size).
- * @returns unsubscribe function
- */
-export const onFontScaleChange = (
-  callback: (info: FontScaleInfo) => void
-): (() => void) => {
-  checkNative();
-  const { DeviceEventEmitter } = require("react-native");
-  Native.startFontScaleListener();
-  const sub = DeviceEventEmitter.addListener("SystemBar_FontScaleChange", callback);
-  return () => {
-    sub.remove();
-    Native.stopFontScaleListener();
-  };
-};

package/src/types.ts

@@ -1,8 +1,7 @@
 // ─────────────────────────────────────────────
-//  rn-system-bar · types.ts  v5
+//  rn-system-bar · types.ts
 // ─────────────────────────────────────────────
 
-// ── Navigation Bar ────────────────────────────
 export type NavigationBarBehavior =
   | "overlay-swipe"
   | "inset-swipe"
@@ -11,11 +10,8 @@ export type NavigationBarBehavior =
 export type NavigationBarButtonStyle = "light" | "dark";
 export type NavigationBarStyle = "auto" | "inverted" | "light" | "dark";
 export type NavigationBarVisibility = "visible" | "hidden";
-
-// ── Status Bar ────────────────────────────────
 export type StatusBarStyle = "light" | "dark";
 
-// ── Orientation ───────────────────────────────
 export type Orientation =
   | "portrait"
   | "landscape"
@@ -23,7 +19,6 @@ export type Orientation =
   | "landscape-right"
   | "auto";
 
-// ── Volume ────────────────────────────────────
 export type VolumeStream =
   | "music"
   | "ring"
@@ -31,67 +26,14 @@ export type VolumeStream =
   | "alarm"
   | "system";
 
-// ── Network ───────────────────────────────────
-export type NetworkType =
-  | "wifi"
-  | "cellular"
-  | "ethernet"
-  | "none"
-  | "unknown";
-
-export interface NetworkInfo {
-  /** Current connection type */
-  type: NetworkType;
-  /** true if any network is reachable */
-  isConnected: boolean;
-  /** true if in airplane mode */
-  isAirplaneMode: boolean;
-  /** WiFi SSID — Android only; null on iOS / when not connected */
-  ssid: string | null;
-  /** Cellular network generation: "2G" | "3G" | "4G" | "5G" | null */
-  cellularGeneration: "2G" | "3G" | "4G" | "5G" | null;
-}
-
-// ── Battery ───────────────────────────────────
-export type BatteryState =
-  | "charging"
-  | "discharging"
-  | "full"
-  | "unknown";
-
-export interface BatteryInfo {
-  /** 0–100 */
-  level: number;
-  /** Current charging state */
-  state: BatteryState;
-  /** Shorthand: is it plugged in? */
-  isCharging: boolean;
-  /** Low battery threshold (<= 20%) */
-  isLow: boolean;
+export interface ScreencastDisplay {
+  id: number;
+  name: string;
+  isValid: boolean;
 }
 
-// ── Haptics ───────────────────────────────────
-export type HapticPattern =
-  | "light"       // subtle tap
-  | "medium"      // standard tap
-  | "heavy"       // strong tap
-  | "success"     // double bump — success feedback
-  | "warning"     // single bump — warning feedback
-  | "error"       // triple bump — error feedback
-  | "selection";  // light tick — selection change
-
-// ── Screencast ────────────────────────────────
 export interface ScreencastInfo {
-  /** true if screen is currently being cast / mirrored */
   isCasting: boolean;
-  /** Name of the display being cast to, or null */
   displayName: string | null;
-}
-
-// ── Font Scale ────────────────────────────────
-export interface FontScaleInfo {
-  /** System font scale multiplier, e.g. 1.0 = default, 1.3 = large */
-  fontScale: number;
-  /** Display density (Android: dp ratio, iOS: scale) */
-  density: number;
+  displays: ScreencastDisplay[];
 }

package/src/useSystemBar.ts

@@ -1,19 +1,13 @@
 // ─────────────────────────────────────────────
-//  rn-system-bar · useSystemBar.ts  v5
-//  Hooks: useSystemBar, useBattery, useNetwork,
-//         useScreencast, useFontScale
+//  rn-system-bar · useSystemBar.ts
 // ─────────────────────────────────────────────
 
 import { useEffect, useRef, useState } from "react";
 import type {
-  BatteryInfo,
-  FontScaleInfo,
-  HapticPattern,
   NavigationBarBehavior,
   NavigationBarButtonStyle,
   NavigationBarStyle,
   NavigationBarVisibility,
-  NetworkInfo,
   Orientation,
   ScreencastInfo,
   StatusBarStyle,
@@ -21,7 +15,8 @@ import type {
 import * as SystemBar from "./SystemBar";
 
 // ─────────────────────────────────────────────
-//  useSystemBar — apply config safely
+//  useSystemBar — apply system bar config safely
+//  All async calls run inside useEffect — no Suspense crash
 // ─────────────────────────────────────────────
 export interface SystemBarConfig {
   navigationBarColor?: string;
@@ -51,11 +46,11 @@ export const useSystemBar = (config: SystemBarConfig) => {
     const apply = async () => {
       const p: Promise<void>[] = [];
 
-      if (config.navigationBarColor     !== undefined) p.push(SystemBar.setNavigationBarColor(config.navigationBarColor));
-      if (config.navigationBarVisibility !== undefined) p.push(SystemBar.setNavigationBarVisibility(config.navigationBarVisibility));
+      if (config.navigationBarColor       !== undefined) SystemBar.setNavigationBarColor(config.navigationBarColor);
+      if (config.navigationBarVisibility  !== undefined) p.push(SystemBar.setNavigationBarVisibility(config.navigationBarVisibility));
       if (config.navigationBarButtonStyle !== undefined) p.push(SystemBar.setNavigationBarButtonStyle(config.navigationBarButtonStyle));
-      if (config.navigationBarStyle      !== undefined) p.push(SystemBar.setNavigationBarStyle(config.navigationBarStyle));
-      if (config.navigationBarBehavior   !== undefined) p.push(SystemBar.setNavigationBarBehavior(config.navigationBarBehavior));
+      if (config.navigationBarStyle       !== undefined) p.push(SystemBar.setNavigationBarStyle(config.navigationBarStyle));
+      if (config.navigationBarBehavior    !== undefined) p.push(SystemBar.setNavigationBarBehavior(config.navigationBarBehavior));
 
       await Promise.allSettled(p);
 
@@ -77,115 +72,20 @@ export const useSystemBar = (config: SystemBarConfig) => {
 };
 
 // ─────────────────────────────────────────────
-//  🆕 useBattery
+//  useScreencast
 // ─────────────────────────────────────────────
-/**
- * Reactive battery info. Auto-updates on level/state changes.
- * @example
- * const { level, isCharging, isLow, state } = useBattery();
- */
-export const useBattery = () => {
-  const [info, setInfo] = useState<BatteryInfo>({
-    level: -1,
-    state: "unknown",
-    isCharging: false,
-    isLow: false,
-  });
-
-  useEffect(() => {
-    let unsub: (() => void) | undefined;
-    SystemBar.getBatteryInfo().then(setInfo).catch(() => {});
-    unsub = SystemBar.onBatteryChange(setInfo);
-    return () => unsub?.();
-  }, []);
-
-  return info;
-};
-
-// ─────────────────────────────────────────────
-//  🆕 useNetwork
-// ─────────────────────────────────────────────
-/**
- * Reactive network info. Auto-updates on connection changes.
- * @example
- * const { isConnected, type, isAirplaneMode } = useNetwork();
- */
-export const useNetwork = () => {
-  const [info, setInfo] = useState<NetworkInfo>({
-    type: "unknown",
-    isConnected: false,
-    isAirplaneMode: false,
-    ssid: null,
-    cellularGeneration: null,
-  });
-
-  useEffect(() => {
-    let unsub: (() => void) | undefined;
-    SystemBar.getNetworkInfo().then(setInfo).catch(() => {});
-    unsub = SystemBar.onNetworkChange(setInfo);
-    return () => unsub?.();
-  }, []);
-
-  return info;
-};
-
-// ─────────────────────────────────────────────
-//  🆕 useScreencast
-// ─────────────────────────────────────────────
-/**
- * Reactive screencast detection.
- * @example
- * const { isCasting, displayName } = useScreencast();
- */
 export const useScreencast = () => {
   const [info, setInfo] = useState<ScreencastInfo>({
     isCasting: false,
     displayName: null,
+    displays: [],
   });
 
   useEffect(() => {
-    let unsub: (() => void) | undefined;
     SystemBar.getScreencastInfo().then(setInfo).catch(() => {});
-    unsub = SystemBar.onScreencastChange(setInfo);
-    return () => unsub?.();
+    const unsub = SystemBar.onScreencastChange(setInfo);
+    return () => unsub();
   }, []);
 
   return info;
 };
-
-// ─────────────────────────────────────────────
-//  🆕 useFontScale
-// ─────────────────────────────────────────────
-/**
- * Reactive font scale info. Updates when user changes system text size.
- * @example
- * const { fontScale, density } = useFontScale();
- */
-export const useFontScale = () => {
-  const [info, setInfo] = useState<FontScaleInfo>({
-    fontScale: 1.0,
-    density: 1.0,
-  });
-
-  useEffect(() => {
-    let unsub: (() => void) | undefined;
-    SystemBar.getFontScaleInfo().then(setInfo).catch(() => {});
-    unsub = SystemBar.onFontScaleChange(setInfo);
-    return () => unsub?.();
-  }, []);
-
-  return info;
-};
-
-// ─────────────────────────────────────────────
-//  🆕 useHaptic
-// ─────────────────────────────────────────────
-/**
- * Returns a stable haptic trigger function.
- * @example
- * const triggerHaptic = useHaptic();
- * <Button onPress={() => triggerHaptic("success")} />
- */
-export const useHaptic = () => {
-  return (pattern: HapticPattern) => SystemBar.haptic(pattern);
-};