rn-system-bar 3.2.3 → 3.2.5

package/lib/src/SystemBar.js

@@ -1,11 +1,10 @@
 "use strict";
 // ─────────────────────────────────────────────
 //  rn-system-bar · SystemBar.ts
-//  Zero expo-navigation-bar dependency.
-//  All APIs → native Kotlin / iOS Swift.
+//  All APIs → native Kotlin (Android) / Swift (iOS)
 // ─────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.onAppCastChange = exports.getAppCastInfo = exports.disconnectAppCast = exports.connectAppCast = exports.stopAppCastScan = exports.startAppCastScan = exports.onScreencastChange = exports.getScreencastInfo = exports.onSystemScreencastChange = exports.getSystemScreencastInfo = exports.setOrientation = exports.setSecureScreen = exports.immersiveMode = exports.keepScreenOn = exports.onVolumeChange = exports.setVolumeHUDVisible = exports.getVolume = exports.setVolume = exports.onBrightnessChange = exports.getBrightness = exports.setBrightness = exports.setStatusBarVisibility = exports.setStatusBarStyle = exports.setStatusBarColor = exports.setNavigationBarBehavior = exports.setNavigationBarStyle = exports.setNavigationBarButtonStyle = exports.setNavigationBarVisibility = exports.setNavigationBarColor = void 0;
+exports.onScreencastChange = exports.getScreencastInfo = exports.onFontScaleChange = exports.getFontScaleInfo = exports.onSystemScreencastChange = exports.getSystemScreencastInfo = exports.haptic = exports.onBatteryChange = exports.getBatteryInfo = exports.onNetworkChange = exports.getNetworkInfo = exports.setOrientation = exports.setSecureScreen = exports.immersiveMode = exports.keepScreenOn = exports.onVolumeChange = exports.setVolumeHUDVisible = exports.getVolume = exports.setVolume = exports.onBrightnessChange = 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 { SystemBar: Native } = react_native_1.NativeModules;
 const isAndroid = react_native_1.Platform.OS === "android";
@@ -24,33 +23,15 @@ const checkNative = (method) => {
         throw new Error(`[rn-system-bar] Native.${method} not found. Rebuild your project.`);
 };
 // ═══════════════════════════════════════════════
-//  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
- */
 const setNavigationBarColor = (color) => {
     if (!androidOnly("setNavigationBarColor"))
         return;
     checkNative();
-    Native.setNavigationBarColor(color); // Kotlin handles the special values
+    Native.setNavigationBarColor(color);
 };
 exports.setNavigationBarColor = setNavigationBarColor;
-/**
- * Hide or show the navigation bar.
- *
- * @param mode `"visible"` | `"hidden"`
- */
 const setNavigationBarVisibility = (mode) => {
     if (!androidOnly("setNavigationBarVisibility"))
         return;
@@ -80,16 +61,8 @@ const setNavigationBarBehavior = (behavior) => {
 };
 exports.setNavigationBarBehavior = 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
- */
 const setStatusBarColor = (color) => {
     if (!androidOnly("setStatusBarColor"))
         return;
@@ -121,7 +94,8 @@ const getBrightness = () => {
 };
 exports.getBrightness = getBrightness;
 /**
- * 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
  */
 const onBrightnessChange = (callback) => {
@@ -156,7 +130,7 @@ const setVolumeHUDVisible = (visible) => {
 };
 exports.setVolumeHUDVisible = setVolumeHUDVisible;
 /**
- * Subscribe to system volume changes (hardware buttons, other apps).
+ * Subscribe to system volume changes.
  * @returns unsubscribe function
  */
 const onVolumeChange = (callback) => {
@@ -201,12 +175,76 @@ const setOrientation = (mode) => {
 };
 exports.setOrientation = setOrientation;
 // ═══════════════════════════════════════════════
-//  SYSTEM SCREENCAST  (external display / HDMI / Miracast)
-//  Reads DisplayManager — detects any externally mirrored display.
+//  NETWORK
+// ═══════════════════════════════════════════════
+/**
+ * One-shot snapshot of the current network state.
+ */
+const getNetworkInfo = () => {
+    checkNative("getNetworkInfo");
+    return Native.getNetworkInfo();
+};
+exports.getNetworkInfo = getNetworkInfo;
+/**
+ * Subscribe to network changes (connectivity, type).
+ * @returns unsubscribe function
+ */
+const onNetworkChange = (callback) => {
+    checkNative();
+    const { DeviceEventEmitter } = require("react-native");
+    Native.startNetworkListener();
+    const sub = DeviceEventEmitter.addListener("SystemBar_NetworkChange", callback);
+    return () => {
+        sub.remove();
+        Native.stopNetworkListener();
+    };
+};
+exports.onNetworkChange = onNetworkChange;
+// ═══════════════════════════════════════════════
+//  BATTERY
+// ═══════════════════════════════════════════════
+/**
+ * One-shot snapshot of the current battery state.
+ */
+const getBatteryInfo = () => {
+    checkNative("getBatteryInfo");
+    return Native.getBatteryInfo();
+};
+exports.getBatteryInfo = getBatteryInfo;
+/**
+ * Subscribe to battery level / state changes.
+ * @returns unsubscribe function
+ */
+const onBatteryChange = (callback) => {
+    checkNative();
+    const { DeviceEventEmitter } = require("react-native");
+    Native.startBatteryListener();
+    const sub = DeviceEventEmitter.addListener("SystemBar_BatteryChange", callback);
+    return () => {
+        sub.remove();
+        Native.stopBatteryListener();
+    };
+};
+exports.onBatteryChange = onBatteryChange;
+// ═══════════════════════════════════════════════
+//  HAPTICS
+// ═══════════════════════════════════════════════
+/**
+ * Trigger a haptic feedback pattern.
+ * iOS: UIFeedbackGenerator. Android: Vibrator.
+ *
+ * @param pattern "light" | "medium" | "heavy" | "success" | "warning" | "error" | "selection"
+ */
+const haptic = (pattern = "medium") => {
+    checkNative();
+    Native.haptic(pattern);
+};
+exports.haptic = haptic;
+// ═══════════════════════════════════════════════
+//  SYSTEM SCREENCAST  (external display / HDMI / Miracast / AirPlay)
 // ═══════════════════════════════════════════════
 /**
  * One-shot snapshot of system-level external display state.
- * Works on both Android (DisplayManager) and iOS (UIScreen.screens).
  */
 const getSystemScreencastInfo = () => {
     if (!Native || typeof Native.getSystemScreencastInfo !== "function") {
@@ -222,8 +260,7 @@ const getSystemScreencastInfo = () => {
 };
 exports.getSystemScreencastInfo = getSystemScreencastInfo;
 /**
- * Subscribe to system external-display changes.
- * Fires when an HDMI / Miracast / AirPlay display connects or disconnects.
+ * Subscribe to external-display connect / disconnect events.
  * @returns unsubscribe function
  */
 const onSystemScreencastChange = (callback) => {
@@ -237,109 +274,36 @@ const onSystemScreencastChange = (callback) => {
     };
 };
 exports.onSystemScreencastChange = onSystemScreencastChange;
-// ─────────────────────────────────────────────
-//  Legacy aliases (backward compat)
-// ─────────────────────────────────────────────
-/** @deprecated Use getSystemScreencastInfo() */
-exports.getScreencastInfo = exports.getSystemScreencastInfo;
-/** @deprecated Use onSystemScreencastChange() */
-exports.onScreencastChange = exports.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()
+//  FONT SCALE
 // ═══════════════════════════════════════════════
 /**
- * Start scanning for nearby castable devices (Chromecast, TV, etc.).
- * Listen for results via `onAppCastChange`.
- * Android: uses MediaRouter. iOS: no-op (AirPlay is system-only).
- */
-const startAppCastScan = () => {
-    if (!androidOnly("startAppCastScan"))
-        return;
-    checkNative();
-    Native.startAppCastScan();
-};
-exports.startAppCastScan = startAppCastScan;
-/**
- * Stop the device discovery scan.
- */
-const stopAppCastScan = () => {
-    if (!androidOnly("stopAppCastScan"))
-        return;
-    checkNative();
-    Native.stopAppCastScan();
-};
-exports.stopAppCastScan = stopAppCastScan;
-/**
- * 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.
- */
-const connectAppCast = (deviceId, pairingPin) => {
-    if (!androidOnly("connectAppCast"))
-        return;
-    checkNative();
-    Native.connectAppCast(deviceId, pairingPin !== null && pairingPin !== void 0 ? pairingPin : null);
-};
-exports.connectAppCast = connectAppCast;
-/**
- * Disconnect the active in-app cast session.
+ * One-shot snapshot of the system font scale and screen density.
  */
-const disconnectAppCast = () => {
-    if (!androidOnly("disconnectAppCast"))
-        return;
-    checkNative();
-    Native.disconnectAppCast();
+const getFontScaleInfo = () => {
+    checkNative("getFontScaleInfo");
+    return Native.getFontScaleInfo();
 };
-exports.disconnectAppCast = disconnectAppCast;
+exports.getFontScaleInfo = getFontScaleInfo;
 /**
- * Get the current in-app cast snapshot (state + device list).
- */
-const getAppCastInfo = () => {
-    if (!isAndroid) {
-        return Promise.resolve({
-            state: "idle",
-            devices: [],
-            connectedDevice: null,
-            error: null,
-        });
-    }
-    checkNative();
-    return Native.getAppCastInfo();
-};
-exports.getAppCastInfo = getAppCastInfo;
-/**
- * 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);
- * });
- *
+ * Subscribe to font scale / accessibility text size changes.
  * @returns unsubscribe function
  */
-const onAppCastChange = (callback) => {
-    if (!isAndroid) {
-        // iOS: immediately call with idle state, return no-op
-        callback({
-            state: "idle",
-            devices: [],
-            connectedDevice: null,
-            error: null,
-        });
-        return () => { };
-    }
+const onFontScaleChange = (callback) => {
     checkNative();
     const { DeviceEventEmitter } = require("react-native");
-    const sub = DeviceEventEmitter.addListener("SystemBar_AppCastChange", callback);
+    Native.startFontScaleListener();
+    const sub = DeviceEventEmitter.addListener("SystemBar_FontScaleChange", callback);
     return () => {
         sub.remove();
+        Native.stopFontScaleListener();
     };
 };
-exports.onAppCastChange = onAppCastChange;
+exports.onFontScaleChange = onFontScaleChange;
+// ─────────────────────────────────────────────
+//  Legacy aliases (backward compat)
+// ─────────────────────────────────────────────
+/** @deprecated Use getSystemScreencastInfo() */
+exports.getScreencastInfo = exports.getSystemScreencastInfo;
+/** @deprecated Use onSystemScreencastChange() */
+exports.onScreencastChange = exports.onSystemScreencastChange;

package/lib/src/types.d.ts

@@ -5,33 +5,22 @@ export type NavigationBarVisibility = "visible" | "hidden";
 export type StatusBarStyle = "light" | "dark";
 /**
  * Navigation bar color value.
- *
- * - Any CSS hex string  →  solid colour      e.g. "#1a1a2e", "#000"
- * - `"transparent"`     →  fully transparent  (FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS +
- *                           transparent color; content draws behind bar)
- * - `"translucent"`     →  semi-transparent   (FLAG_TRANSLUCENT_NAVIGATION)
+ * - Any hex string  →  solid colour      e.g. "#1a1a2e"
+ * - `"transparent"` →  fully transparent
+ * - `"translucent"` →  semi-transparent
  */
 export type NavigationBarColorValue = string | "transparent" | "translucent";
 /**
  * Status bar background color value.
- *
- * - Any CSS hex string  →  solid colour
- * - `"transparent"`     →  fully transparent  (draws behind content)
- * - `"translucent"`     →  semi-transparent
+ * - Any hex string  →  solid colour
+ * - `"transparent"` →  fully transparent
+ * - `"translucent"` →  semi-transparent
  */
 export type StatusBarColorValue = string | "transparent" | "translucent";
-/**
- * "system"  → follow the OS Appearance (dark/light).
- * "dark"    → force dark.
- * "light"   → force light.
- */
 export type ThemeMode = "system" | "dark" | "light";
 export interface ThemeState {
-    /** Resolved dark-mode flag. Always a concrete boolean. */
     isDark: boolean;
-    /** Currently active override ("system" = following OS). */
     mode: ThemeMode;
-    /** Set the override mode. Pass "system" to revert to OS. */
     setMode: (mode: ThemeMode) => void;
 }
 export type Orientation = "portrait" | "landscape" | "landscape-left" | "landscape-right" | "auto";
@@ -41,37 +30,48 @@ export interface ScreencastDisplay {
     name: string;
     isValid: boolean;
 }
-/** Result of getSystemScreencastInfo() — physical/HDMI/Miracast external display. */
 export interface SystemScreencastInfo {
     isCasting: boolean;
     displayName: string | null;
     displays: ScreencastDisplay[];
 }
-/** Connection state of the in-app cast session. */
-export type AppCastState = "idle" | "scanning" | "connecting" | "connected" | "disconnecting";
-/** A discovered castable device (TV, Chromecast, etc.). */
-export interface AppCastDevice {
-    /** Unique route ID from MediaRouter. */
-    id: string;
-    /** Human-readable device name e.g. "Living Room TV". */
-    name: string;
-    /** Device description / model string (may be null). */
-    description: string | null;
-    /** Signal strength 0–100, or null if unavailable. */
-    signalStrength: number | null;
-    /** Whether a pairing/PIN step is required. */
-    requiresPairing: boolean;
-}
-/** Full snapshot of in-app cast state. */
-export interface AppCastInfo {
-    state: AppCastState;
-    /** Devices found during the last scan. */
-    devices: AppCastDevice[];
-    /** The device currently connected (or connecting). */
-    connectedDevice: AppCastDevice | null;
-    /** Error message from the last failed operation. */
-    error: string | null;
-}
 /** @deprecated Use SystemScreencastInfo */
 export interface ScreencastInfo extends SystemScreencastInfo {
 }
+export type NetworkType = "wifi" | "cellular" | "none" | "unknown";
+export interface NetworkInfo {
+    /** Connection medium. */
+    type: NetworkType;
+    /** True when the device has an active internet connection. */
+    isConnected: boolean;
+    /** True when airplane mode is on (Android only; always false on iOS). */
+    isAirplaneMode: boolean;
+    /** Wi-Fi SSID — Android only, requires location permission; null on iOS. */
+    ssid: string | null;
+    /** Cellular generation e.g. "4g" | "5g" — Android only; null on iOS. */
+    cellularGeneration: string | null;
+}
+export type BatteryState = "charging" | "discharging" | "full" | "unknown";
+export interface BatteryInfo {
+    /** Battery level 0–100, or -1 if unknown. */
+    level: number;
+    state: BatteryState;
+    isCharging: boolean;
+    /** True when level ≤ 20 and not charging. */
+    isLow: boolean;
+}
+export type HapticPattern = "light" | "medium" | "heavy" | "success" | "warning" | "error" | "selection";
+export interface FontScaleInfo {
+    /**
+     * System font scale multiplier (1.0 = default).
+     * Android: from Configuration.fontScale.
+     * iOS: derived from UIContentSizeCategory.
+     */
+    fontScale: number;
+    /**
+     * Screen pixel density.
+     * Android: DisplayMetrics.density.
+     * iOS: UIScreen.main.scale.
+     */
+    density: number;
+}

package/lib/src/useSystemBar.d.ts

@@ -1,4 +1,4 @@
-import type { AppCastInfo, NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarColorValue, NavigationBarStyle, NavigationBarVisibility, Orientation, ScreencastInfo, StatusBarColorValue, StatusBarStyle, SystemScreencastInfo, ThemeMode, ThemeState } from "./types";
+import type { BatteryInfo, FontScaleInfo, NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarColorValue, NavigationBarStyle, NavigationBarVisibility, NetworkInfo, Orientation, ScreencastInfo, StatusBarColorValue, StatusBarStyle, SystemScreencastInfo, ThemeMode, ThemeState } from "./types";
 export interface SystemBarConfig {
     navigationBarColor?: NavigationBarColorValue;
     navigationBarVisibility?: NavigationBarVisibility;
@@ -8,7 +8,6 @@ export interface SystemBarConfig {
     statusBarColor?: StatusBarColorValue;
     statusBarStyle?: StatusBarStyle;
     statusBarVisible?: boolean;
-    statusBarAnimated?: boolean;
     keepScreenOn?: boolean;
     immersiveMode?: boolean;
     brightness?: number;
@@ -17,34 +16,36 @@ export interface SystemBarConfig {
 }
 export declare const useSystemBar: (config: SystemBarConfig) => void;
 export interface ThemedSystemBarConfig {
-    /** Config applied when the resolved theme is DARK. */
     dark?: SystemBarConfig;
-    /** Config applied when the resolved theme is LIGHT. */
     light?: SystemBarConfig;
-    /**
-     * Static config merged under both themes.
-     * Theme-specific (dark/light) values always win.
-     */
     base?: SystemBarConfig;
 }
 export declare const useThemeSystemBar: (config: ThemedSystemBarConfig) => ThemeState;
 export { useTheme } from "./useTheme";
 export type { ThemeMode, ThemeState };
 export declare const useSystemScreencast: () => SystemScreencastInfo;
-/** @deprecated Renamed to useSystemScreencast() */
+/** @deprecated Use useSystemScreencast() */
 export declare const useScreencast: () => ScreencastInfo;
-export interface UseAppCastReturn extends AppCastInfo {
-    /** Start scanning for nearby castable devices (TV, Chromecast, etc.). */
-    scan: () => void;
-    /** Stop the device discovery scan. */
-    stopScan: () => void;
-    /**
-     * Connect to a discovered device and begin casting this app's screen.
-     * @param deviceId   The `id` field from `AppCastDevice`.
-     * @param pairingPin Optional PIN string if `requiresPairing` is true.
-     */
-    connect: (deviceId: string, pairingPin?: string) => void;
-    /** End the active cast session and return to idle. */
-    disconnect: () => void;
-}
-export declare const useAppCast: () => UseAppCastReturn;
+/**
+ * Subscribe to network state. Fires immediately with the current snapshot,
+ * then on every connectivity change.
+ *
+ * @example
+ * const { isConnected, type } = useNetwork();
+ */
+export declare const useNetwork: () => NetworkInfo;
+/**
+ * Subscribe to battery state. Fires immediately with the current snapshot,
+ * then on every level / state change.
+ *
+ * @example
+ * const { level, isCharging, isLow } = useBattery();
+ */
+export declare const useBattery: () => BatteryInfo;
+/**
+ * Subscribe to system font scale changes (accessibility text size).
+ *
+ * @example
+ * const { fontScale, density } = useFontScale();
+ */
+export declare const useFontScale: () => FontScaleInfo;