rn-system-bar 3.1.7 → 3.1.8

package/ios/SystemBarModule.swift

@@ -226,36 +226,70 @@ class SystemBarModule: RCTEventEmitter {
   }
 
   // ═══════════════════════════════════════════════
-  //  🆕 SCREENCAST
+  //  🆕 SYSTEM SCREENCAST  (external display / AirPlay mirror)
+  //  Detects OS-level external screens via UIScreen.
   // ═══════════════════════════════════════════════
 
-  private func currentScreencastMap() -> [String: Any] {
+  private func currentSystemScreencastMap() -> [String: Any] {
     let isCasting = UIScreen.screens.count > 1
     return [
       "isCasting":   isCasting,
       "displayName": isCasting ? "External Display" : NSNull(),
+      "displays":    UIScreen.screens.dropFirst().enumerated().map { idx, _ in
+        ["id": idx + 1, "name": "External Display \(idx + 1)", "isValid": true]
+      },
     ]
   }
 
   @objc
-  func getScreencastInfo(_ resolve: @escaping RCTPromiseResolveBlock,
-                         rejecter reject: RCTPromiseRejectBlock) {
-    resolve(currentScreencastMap())
+  func getSystemScreencastInfo(_ resolve: @escaping RCTPromiseResolveBlock,
+                                rejecter reject: RCTPromiseRejectBlock) {
+    resolve(currentSystemScreencastMap())
   }
 
-  @objc func startScreencastListener() {
+  @objc func startSystemScreencastListener() {
     screencastObserver = NotificationCenter.default.addObserver(
       forName: UIScreen.didConnectNotification, object: nil, queue: .main
     ) { [weak self] _ in
-      self?.emit("SystemBar_ScreencastChange", body: self?.currentScreencastMap() ?? [:])
+      self?.emit("SystemBar_SystemScreencastChange", body: self?.currentSystemScreencastMap() ?? [:])
     }
   }
 
-  @objc func stopScreencastListener() {
+  @objc func stopSystemScreencastListener() {
     if let obs = screencastObserver { NotificationCenter.default.removeObserver(obs) }
     screencastObserver = nil
   }
 
+  // ═══════════════════════════════════════════════
+  //  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) {}
 
@@ -295,9 +329,10 @@ class SystemBarModule: RCTEventEmitter {
   @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) {}
-}
+}

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./src/SystemBar";
 export * from "./src/types";
-export { useSystemBar, useScreencast } from "./src/useSystemBar";
-export type { SystemBarConfig } from "./src/useSystemBar";
+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";

package/lib/index.js

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

package/lib/specs/NativeSystemBar.d.ts

@@ -15,7 +15,16 @@ export interface Spec extends TurboModule {
     setVolumeHUDVisible(visible: boolean): void;
     keepScreenOn(enable: boolean): void;
     immersiveMode(enable: boolean): void;
+    setSecureScreen(enable: boolean): void;
     setOrientation(mode: string): void;
+    getSystemScreencastInfo(): Promise<Object>;
+    startSystemScreencastListener(): void;
+    stopSystemScreencastListener(): void;
+    startAppCastScan(): void;
+    stopAppCastScan(): void;
+    connectAppCast(deviceId: string, pairingPin: string | null): void;
+    disconnectAppCast(): void;
+    getAppCastInfo(): Promise<Object>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/src/SystemBar.d.ts

@@ -1,15 +1,42 @@
-import type { NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarStyle, NavigationBarVisibility, Orientation, ScreencastInfo, StatusBarStyle, VolumeStream } from "./types";
-export declare const setNavigationBarColor: (color: string) => void;
+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
+ */
+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 500ms on Android).
+ * Subscribe to system brightness changes (polls every 500 ms on Android).
  * @returns unsubscribe function
  */
 export declare const onBrightnessChange: (callback: (brightness: number) => void) => (() => void);
@@ -25,5 +52,56 @@ 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);
+/**
+ * One-shot snapshot of system-level external display state.
+ * Works on both Android (DisplayManager) and iOS (UIScreen.screens).
+ */
+export declare const getSystemScreencastInfo: () => Promise<SystemScreencastInfo>;
+/**
+ * Subscribe to system external-display changes.
+ * Fires when an HDMI / Miracast / AirPlay display connects or disconnects.
+ * @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);
+/**
+ * Start scanning for nearby castable devices (Chromecast, TV, etc.).
+ * Listen for results via `onAppCastChange`.
+ * Android: uses MediaRouter. iOS: no-op (AirPlay is system-only).
+ */
+export declare const startAppCastScan: () => void;
+/**
+ * Stop the device discovery scan.
+ */
+export declare const stopAppCastScan: () => 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.
+ */
+export declare const connectAppCast: (deviceId: string, pairingPin?: string) => void;
+/**
+ * Disconnect the active in-app cast session.
+ */
+export declare const disconnectAppCast: () => void;
+/**
+ * Get the current in-app cast snapshot (state + device list).
+ */
+export declare const getAppCastInfo: () => Promise<AppCastInfo>;
+/**
+ * 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);
+ * });
+ *
+ * @returns unsubscribe function
+ */
+export declare const onAppCastChange: (callback: (info: AppCastInfo) => void) => (() => void);

package/lib/src/SystemBar.js

@@ -5,7 +5,7 @@
 //  All APIs → native Kotlin / iOS Swift.
 // ─────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.onScreencastChange = exports.getScreencastInfo = 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.setNavigationBarBehavior = exports.setNavigationBarStyle = exports.setNavigationBarButtonStyle = exports.setNavigationBarVisibility = exports.setNavigationBarColor = void 0;
+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;
 const react_native_1 = require("react-native");
 const { SystemBar: Native } = react_native_1.NativeModules;
 const isAndroid = react_native_1.Platform.OS === "android";
@@ -24,13 +24,31 @@ const checkNative = () => {
 // ═══════════════════════════════════════════════
 //  NAVIGATION BAR  (Android — 100% native)
 // ═══════════════════════════════════════════════
+/**
+ * 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);
+    Native.setNavigationBarColor(color); // Kotlin handles the special values
 };
 exports.setNavigationBarColor = setNavigationBarColor;
+/**
+ * Hide or show the navigation bar.
+ *
+ * @param mode `"visible"` | `"hidden"`
+ */
 const setNavigationBarVisibility = (mode) => {
     if (!androidOnly("setNavigationBarVisibility"))
         return;
@@ -62,6 +80,21 @@ exports.setNavigationBarBehavior = setNavigationBarBehavior;
 // ═══════════════════════════════════════════════
 //  STATUS BAR  (native — no RN StatusBar)
 // ═══════════════════════════════════════════════
+/**
+ * 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;
+    checkNative();
+    Native.setStatusBarColor(color);
+};
+exports.setStatusBarColor = setStatusBarColor;
 const setStatusBarStyle = (style) => {
     checkNative();
     Native.setStatusBarStyle(style);
@@ -86,7 +119,7 @@ const getBrightness = () => {
 };
 exports.getBrightness = getBrightness;
 /**
- * Subscribe to system brightness changes (polls every 500ms on Android).
+ * Subscribe to system brightness changes (polls every 500 ms on Android).
  * @returns unsubscribe function
  */
 const onBrightnessChange = (callback) => {
@@ -166,21 +199,137 @@ const setOrientation = (mode) => {
 };
 exports.setOrientation = setOrientation;
 // ═══════════════════════════════════════════════
-//  SCREENCAST
+//  SYSTEM SCREENCAST  (external display / HDMI / Miracast)
+//  Reads DisplayManager — detects any externally mirrored display.
 // ═══════════════════════════════════════════════
-const getScreencastInfo = () => {
+/**
+ * One-shot snapshot of system-level external display state.
+ * Works on both Android (DisplayManager) and iOS (UIScreen.screens).
+ */
+const getSystemScreencastInfo = () => {
+    checkNative();
+    return Native.getSystemScreencastInfo();
+};
+exports.getSystemScreencastInfo = getSystemScreencastInfo;
+/**
+ * Subscribe to system external-display changes.
+ * Fires when an HDMI / Miracast / AirPlay display connects or disconnects.
+ * @returns unsubscribe function
+ */
+const onSystemScreencastChange = (callback) => {
     checkNative();
-    return Native.getScreencastInfo();
+    const { DeviceEventEmitter } = require("react-native");
+    Native.startSystemScreencastListener();
+    const sub = DeviceEventEmitter.addListener("SystemBar_SystemScreencastChange", callback);
+    return () => {
+        sub.remove();
+        Native.stopSystemScreencastListener();
+    };
 };
-exports.getScreencastInfo = getScreencastInfo;
-const onScreencastChange = (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()
+// ═══════════════════════════════════════════════
+/**
+ * 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.
+ */
+const disconnectAppCast = () => {
+    if (!androidOnly("disconnectAppCast"))
+        return;
+    checkNative();
+    Native.disconnectAppCast();
+};
+exports.disconnectAppCast = disconnectAppCast;
+/**
+ * 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);
+ * });
+ *
+ * @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 () => { };
+    }
     checkNative();
     const { DeviceEventEmitter } = require("react-native");
-    Native.startScreencastListener();
-    const sub = DeviceEventEmitter.addListener("SystemBar_ScreencastChange", callback);
+    const sub = DeviceEventEmitter.addListener("SystemBar_AppCastChange", callback);
     return () => {
         sub.remove();
-        Native.stopScreencastListener();
     };
 };
-exports.onScreencastChange = onScreencastChange;
+exports.onAppCastChange = onAppCastChange;

package/lib/src/types.d.ts

@@ -3,6 +3,37 @@ export type NavigationBarButtonStyle = "light" | "dark";
 export type NavigationBarStyle = "auto" | "inverted" | "light" | "dark";
 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)
+ */
+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
+ */
+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";
 export type VolumeStream = "music" | "ring" | "notification" | "alarm" | "system";
 export interface ScreencastDisplay {
@@ -10,8 +41,37 @@ export interface ScreencastDisplay {
     name: string;
     isValid: boolean;
 }
-export interface ScreencastInfo {
+/** 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 {
+}

package/lib/src/useSystemBar.d.ts

@@ -1,11 +1,11 @@
-import type { NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarStyle, NavigationBarVisibility, Orientation, ScreencastInfo, StatusBarStyle } from "./types";
+import type { AppCastInfo, NavigationBarBehavior, NavigationBarButtonStyle, NavigationBarColorValue, NavigationBarStyle, NavigationBarVisibility, Orientation, StatusBarColorValue, StatusBarStyle, SystemScreencastInfo, ThemeMode, ThemeState } from "./types";
 export interface SystemBarConfig {
-    navigationBarColor?: string;
+    navigationBarColor?: NavigationBarColorValue;
     navigationBarVisibility?: NavigationBarVisibility;
     navigationBarButtonStyle?: NavigationBarButtonStyle;
     navigationBarStyle?: NavigationBarStyle;
     navigationBarBehavior?: NavigationBarBehavior;
-    statusBarColor?: string;
+    statusBarColor?: StatusBarColorValue;
     statusBarStyle?: StatusBarStyle;
     statusBarVisible?: boolean;
     statusBarAnimated?: boolean;
@@ -16,4 +16,35 @@ export interface SystemBarConfig {
     secureScreen?: boolean;
 }
 export declare const useSystemBar: (config: SystemBarConfig) => void;
-export declare const useScreencast: () => ScreencastInfo;
+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() */
+export declare const useScreencast: () => SystemScreencastInfo;
+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;