capacitor-plugin-status-bar 2.0.13 → 2.0.15

package/ios/Sources/CapacitorStatusBarPlugin/CapacitorStatusBar.swift

@@ -9,6 +9,12 @@ import Capacitor
     private var currentBackgroundColor: UIColor?
     // Track whether overlays web view mode is active
     private var isOverlayMode = false
+    // Keep a weak reference to the Capacitor WKWebView for layout updates
+    private weak var webView: UIView?
+
+    @objc public func setWebView(_ webView: UIView?) {
+        self.webView = webView
+    }
 
     @objc public func applyDefaultStyle() {
         DispatchQueue.main.async {
@@ -19,11 +25,14 @@ import Capacitor
         }
     }
 
-    @objc public func setStyle(style: String, colorHex: String?) {
+    @objc public func setStyle(style: String, colorHex: String?, completion: (() -> Void)? = nil) {
         DispatchQueue.main.async {
+            defer { completion?() }
+
             guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene else { return }
             guard let window = windowScene.windows.first else { return }
             guard let statusBarManager = windowScene.statusBarManager else { return }
+            guard let rootVC = window.rootViewController else { return }
 
             let upperStyle = style.uppercased()
             var backgroundColor: UIColor?
@@ -31,33 +40,29 @@ import Capacitor
 
             // Determine the status bar style and background color
             if upperStyle == "LIGHT" {
-                // Light style: light background with dark content
                 statusBarStyle = .darkContent
                 backgroundColor = .white
             } else if upperStyle == "DARK" {
-                // Dark style: dark background with light content
                 statusBarStyle = .lightContent
                 backgroundColor = .black
             } else if upperStyle == "CUSTOM" {
-                // Custom style: use provided color and determine content style based on brightness
                 if let colorHex = colorHex, let color = self.colorFromHex(colorHex) {
                     backgroundColor = color
                     let brightness = self.getColorBrightness(color)
-                    // If background is light, use dark content; if dark, use light content
                     statusBarStyle = brightness > 0.5 ? .darkContent : .lightContent
                 } else {
-                    // No color provided, use system default
                     statusBarStyle = .default
                     backgroundColor = nil
                 }
             } else {
-                // Default: use system default
                 statusBarStyle = .default
                 backgroundColor = nil
             }
 
-            // Set the status bar style using KVC to avoid deprecation warnings
-            UIApplication.shared.setValue(statusBarStyle.rawValue, forKey: "statusBarStyle")
+            // Set the status bar style via swizzled preferredStatusBarStyle
+            CapacitorStatusBar.swizzleStatusBarStyleIfNeeded()
+            CapacitorStatusBar.currentStatusBarStyle = statusBarStyle
+            rootVC.setNeedsStatusBarAppearanceUpdate()
 
             // Store the background color for later restoration
             self.currentBackgroundColor = backgroundColor
@@ -66,7 +71,6 @@ import Capacitor
             if self.isOverlayMode {
                 print("CapacitorStatusBar: setStyle - overlay mode active, skipping background color")
             } else {
-                // Create or update the status bar background view
                 self.updateStatusBarBackgroundView(in: window,
                                                    height: statusBarManager.statusBarFrame.height,
                                                    color: backgroundColor)
@@ -76,78 +80,78 @@ import Capacitor
         }
     }
 
-    @objc public func show(animated: Bool) {
+    @objc public func show(animated: Bool, completion: (() -> Void)? = nil) {
         DispatchQueue.main.async {
-            // Note: Status bar visibility is controlled through view controllers in modern iOS.
-            // This plugin requires UIViewControllerBasedStatusBarAppearance to be set to NO
-            // in the app's Info.plist for programmatic show/hide to work.
+            defer { completion?() }
 
-            // Log current status bar state via status bar manager
-            if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
-               let statusBarManager = windowScene.statusBarManager {
+            guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+                  let window = windowScene.windows.first,
+                  let rootVC = window.rootViewController else { return }
+
+            if let statusBarManager = windowScene.statusBarManager {
                 print("CapacitorStatusBar: show() - Current hidden state: \(statusBarManager.isStatusBarHidden)")
             }
 
-            // Set visibility using the application-level API
-            // Note: This requires UIViewControllerBasedStatusBarAppearance = NO
-            self.setStatusBarVisibility(hidden: false, animated: animated)
+            // Show status bar via swizzled prefersStatusBarHidden
+            CapacitorStatusBar.swizzleStatusBarVisibilityIfNeeded()
+            CapacitorStatusBar.currentStatusBarHidden = false
+            rootVC.setNeedsStatusBarAppearanceUpdate()
 
             // Restore the background view color when showing (unless overlay mode is active)
             if !self.isOverlayMode {
                 self.restoreStatusBarBackgroundColor()
             }
 
-            // Also show the navigation bar (home indicator)
-            self.showNavigationBar(animated: animated)
+            self.updateWebViewLayout()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
+                self.updateWebViewLayout()
+            }
         }
     }
 
-    @objc public func hide(animation: String) {
+    @objc public func hide(animation: String, completion: (() -> Void)? = nil) {
         DispatchQueue.main.async {
+            defer { completion?() }
+
             let animationType = animation.lowercased()
 
-            // Log current status bar state via status bar manager
             if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
                let statusBarManager = windowScene.statusBarManager {
                 print("CapacitorStatusBar: hide() - animation=\(animationType), Current hidden state: \(statusBarManager.isStatusBarHidden)")
             }
 
             if animationType == "fade" {
-                // Fade mode: Make background transparent without removing status bar
+                // Fade mode: Make background transparent without hiding status bar
                 print("CapacitorStatusBar: hide() - fade mode: making background transparent")
                 self.makeStatusBarBackgroundTransparent()
-                self.hideNavigationBar(animation: "fade")
-            } else if animationType == "slide" {
-                // Slide mode: Hide the status bar completely (current behavior)
-                print("CapacitorStatusBar: hide() - slide mode: hiding bars completely")
-                // Note: Status bar visibility is controlled through view controllers in modern iOS.
-                // This plugin requires UIViewControllerBasedStatusBarAppearance to be set to NO
-                // in the app's Info.plist for programmatic show/hide to work.
-                self.setStatusBarVisibility(hidden: true, animated: true)
-                // Also make the background view transparent when hiding
-                self.makeStatusBarBackgroundTransparent()
-                self.hideNavigationBar(animation: "slide")
             } else {
-                print("CapacitorStatusBar: hide() - unknown animation type '\(animationType)', defaulting to slide")
-                self.setStatusBarVisibility(hidden: true, animated: true)
+                // Slide mode (default): Hide the status bar completely
+                if animationType != "slide" {
+                    print("CapacitorStatusBar: hide() - unknown animation '\(animationType)', defaulting to slide")
+                } else {
+                    print("CapacitorStatusBar: hide() - slide mode: hiding status bar")
+                }
+
+                guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+                      let window = windowScene.windows.first,
+                      let rootVC = window.rootViewController else { return }
+
+                CapacitorStatusBar.swizzleStatusBarVisibilityIfNeeded()
+                CapacitorStatusBar.currentStatusBarHidden = true
+                rootVC.setNeedsStatusBarAppearanceUpdate()
+
                 self.makeStatusBarBackgroundTransparent()
-                self.hideNavigationBar(animation: "slide")
+            }
+
+            self.updateWebViewLayout()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
+                self.updateWebViewLayout()
             }
         }
     }
 
     // MARK: - Private Methods
 
-    /// Sets the status bar visibility.
-    /// - Parameters:
-    ///   - hidden: Whether the status bar should be hidden
-    ///   - animated: Whether the change should be animated
-    private func setStatusBarVisibility(hidden: Bool, animated: Bool) {
-        // Use KVC to set status bar state without triggering deprecation warnings
-        // This approach is necessary when UIViewControllerBasedStatusBarAppearance is NO
-        UIApplication.shared.setValue(hidden, forKey: "statusBarHidden")
-    }
-
     /// Updates or creates the status bar background view with the specified color.
     /// - Parameters:
     ///   - window: The window where the status bar view will be added
@@ -182,8 +186,10 @@ import Capacitor
         }
     }
 
-    @objc public func setOverlaysWebView(value: Bool) {
+    @objc public func setOverlaysWebView(value: Bool, completion: (() -> Void)? = nil) {
         DispatchQueue.main.async {
+            defer { completion?() }
+
             guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
                   let window = windowScene.windows.first,
                   let statusBarManager = windowScene.statusBarManager else {
@@ -194,41 +200,25 @@ import Capacitor
             self.isOverlayMode = value
 
             if value {
-                // Overlay mode: make the status bar background transparent so web content shows through
                 let statusBarView = window.viewWithTag(CapacitorStatusBar.statusBarViewTag)
                 statusBarView?.backgroundColor = .clear
                 print("CapacitorStatusBar: setOverlaysWebView(true) - content extends behind status bar")
             } else {
-                // Non-overlay mode: restore the status bar background from the current style
                 if let color = self.currentBackgroundColor {
                     self.updateStatusBarBackgroundView(in: window,
                                                        height: statusBarManager.statusBarFrame.height,
                                                        color: color)
                     print("CapacitorStatusBar: setOverlaysWebView(false) - restored background color")
                 } else {
-                    // No style was set; apply default style based on system theme
                     self.applyDefaultStyle()
                     print("CapacitorStatusBar: setOverlaysWebView(false) - applied default style from config")
                 }
             }
-        }
-    }
-
-    @objc public func setBackground(colorHex: String?) {
-        DispatchQueue.main.async {
-            guard let colorHex = colorHex, let color = self.colorFromHex(colorHex) else {
-                print("CapacitorStatusBar: setBackground - Invalid color or nil")
-                return
-            }
 
-            guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
-                  let window = windowScene.windows.first else {
-                print("CapacitorStatusBar: setBackground - Unable to get window")
-                return
+            self.updateWebViewLayout()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
+                self.updateWebViewLayout()
             }
-
-            window.backgroundColor = .clear
-            print("CapacitorStatusBar: setBackground - Body is always transparent; status/nav bars use overlays/native APIs")
         }
     }
 
@@ -262,8 +252,10 @@ import Capacitor
     /// Shared flag read by the swizzled `prefersHomeIndicatorAutoHidden` override.
     static var homeIndicatorHidden = false
 
-    @objc public func showNavigationBar(animated: Bool) {
+    @objc public func showNavigationBar(animated: Bool, completion: (() -> Void)? = nil) {
         DispatchQueue.main.async {
+            defer { completion?() }
+
             guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
                   let window = windowScene.windows.first,
                   let rootVC = window.rootViewController else {
@@ -276,11 +268,17 @@ import Capacitor
             rootVC.setNeedsUpdateOfHomeIndicatorAutoHidden()
 
             print("CapacitorStatusBar: showNavigationBar - animated=\(animated)")
+            self.updateWebViewLayout()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
+                self.updateWebViewLayout()
+            }
         }
     }
 
-    @objc public func hideNavigationBar(animation: String) {
+    @objc public func hideNavigationBar(animation: String, completion: (() -> Void)? = nil) {
         DispatchQueue.main.async {
+            defer { completion?() }
+
             guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
                   let window = windowScene.windows.first,
                   let rootVC = window.rootViewController else {
@@ -294,24 +292,82 @@ import Capacitor
             rootVC.setNeedsUpdateOfHomeIndicatorAutoHidden()
 
             print("CapacitorStatusBar: hideNavigationBar - animation=\(animationType)")
+            self.updateWebViewLayout()
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
+                self.updateWebViewLayout()
+            }
+        }
+    }
+
+    // MARK: - Swizzling
+
+    private static var hasSwizzledHomeIndicator = false
+    private static var hasSwizzledStatusBarStyle = false
+    private static var hasSwizzledStatusBarVisibility = false
+
+    /// Current status bar style, read by the swizzled `preferredStatusBarStyle` override.
+    static var currentStatusBarStyle: UIStatusBarStyle = .default
+
+    /// Current status bar hidden state, read by the swizzled `prefersStatusBarHidden` override.
+    static var currentStatusBarHidden = false
+
+    /// Swizzle `preferredStatusBarStyle` so we can control status bar appearance
+    /// without using private KVC APIs. Requires UIViewControllerBasedStatusBarAppearance = YES (default).
+    static func swizzleStatusBarStyleIfNeeded() {
+        guard !hasSwizzledStatusBarStyle else { return }
+        hasSwizzledStatusBarStyle = true
+
+        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+              let window = windowScene.windows.first,
+              let rootVC = window.rootViewController else { return }
+
+        let vcClass: AnyClass = type(of: rootVC)
+        let originalSelector = #selector(getter: UIViewController.preferredStatusBarStyle)
+        let swizzledSelector = #selector(UIViewController.capsb_preferredStatusBarStyle)
+
+        guard let originalMethod = class_getInstanceMethod(vcClass, originalSelector),
+              let swizzledMethod = class_getInstanceMethod(UIViewController.self, swizzledSelector) else {
+            print("CapacitorStatusBar: Failed to swizzle preferredStatusBarStyle")
+            return
         }
+
+        method_exchangeImplementations(originalMethod, swizzledMethod)
+        print("CapacitorStatusBar: Swizzled preferredStatusBarStyle on \(vcClass)")
     }
 
-    // MARK: - Home Indicator Swizzling
+    /// Swizzle `prefersStatusBarHidden` so we can control status bar visibility
+    /// without using private KVC APIs. Requires UIViewControllerBasedStatusBarAppearance = YES (default).
+    static func swizzleStatusBarVisibilityIfNeeded() {
+        guard !hasSwizzledStatusBarVisibility else { return }
+        hasSwizzledStatusBarVisibility = true
+
+        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+              let window = windowScene.windows.first,
+              let rootVC = window.rootViewController else { return }
+
+        let vcClass: AnyClass = type(of: rootVC)
+        let originalSelector = #selector(getter: UIViewController.prefersStatusBarHidden)
+        let swizzledSelector = #selector(UIViewController.capsb_prefersStatusBarHidden)
 
-    private static var hasSwizzled = false
+        guard let originalMethod = class_getInstanceMethod(vcClass, originalSelector),
+              let swizzledMethod = class_getInstanceMethod(UIViewController.self, swizzledSelector) else {
+            print("CapacitorStatusBar: Failed to swizzle prefersStatusBarHidden")
+            return
+        }
+
+        method_exchangeImplementations(originalMethod, swizzledMethod)
+        print("CapacitorStatusBar: Swizzled prefersStatusBarHidden on \(vcClass)")
+    }
 
     /// Swizzle `prefersHomeIndicatorAutoHidden` on the root view controller so we
     /// can control the home indicator visibility from the plugin.
     static func swizzleHomeIndicatorIfNeeded() {
-        guard !hasSwizzled else { return }
-        hasSwizzled = true
+        guard !hasSwizzledHomeIndicator else { return }
+        hasSwizzledHomeIndicator = true
 
         guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
               let window = windowScene.windows.first,
-              let rootVC = window.rootViewController else {
-            return
-        }
+              let rootVC = window.rootViewController else { return }
 
         let vcClass: AnyClass = type(of: rootVC)
         let originalSelector = #selector(getter: UIViewController.prefersHomeIndicatorAutoHidden)
@@ -339,6 +395,37 @@ import Capacitor
         print("CapacitorStatusBar: Made background transparent")
     }
 
+    /// Updates WebView frame to respect overlay mode behavior.
+    /// - overlay mode true: content extends edge-to-edge (no reserved top/bottom)
+    /// - overlay mode false: content is inset away from status/home-indicator areas
+    private func updateWebViewLayout() {
+        guard let webView = self.webView else {
+            print("CapacitorStatusBar: updateWebViewLayout - WebView unavailable")
+            return
+        }
+
+        guard let window = webView.window
+                ?? (UIApplication.shared.connectedScenes.first as? UIWindowScene)?
+                    .windows.first(where: { $0.isKeyWindow })
+                ?? (UIApplication.shared.connectedScenes.first as? UIWindowScene)?.windows.first else {
+            print("CapacitorStatusBar: updateWebViewLayout - Unable to resolve window")
+            return
+        }
+
+        let safeAreaInsets = window.safeAreaInsets
+        let topInset: CGFloat = isOverlayMode ? 0 : sanitizedInsetValue(safeAreaInsets.top)
+        let bottomInset: CGFloat = isOverlayMode ? 0 : sanitizedInsetValue(safeAreaInsets.bottom)
+
+        var frame = window.bounds
+        frame.origin.y = topInset
+        frame.size.height = max(0, frame.size.height - topInset - bottomInset)
+
+        if webView.frame != frame {
+            webView.frame = frame
+            print("CapacitorStatusBar: updateWebViewLayout - topInset=\(topInset), bottomInset=\(bottomInset), frame=\(frame)")
+        }
+    }
+
     /// Restores the status bar background view to its original color
     private func restoreStatusBarBackgroundColor() {
         guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
@@ -415,6 +502,14 @@ import Capacitor
 // MARK: - UIViewController extension for home indicator swizzling
 
 extension UIViewController {
+    @objc func capsb_preferredStatusBarStyle() -> UIStatusBarStyle {
+        return CapacitorStatusBar.currentStatusBarStyle
+    }
+
+    @objc func capsb_prefersStatusBarHidden() -> Bool {
+        return CapacitorStatusBar.currentStatusBarHidden
+    }
+
     @objc func capsb_prefersHomeIndicatorAutoHidden() -> Bool {
         return CapacitorStatusBar.homeIndicatorHidden
     }

package/ios/Sources/CapacitorStatusBarPlugin/CapacitorStatusBarPlugin.swift

@@ -14,7 +14,6 @@ public class CapacitorStatusBarPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "show", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "hide", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "setOverlaysWebView", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "setBackground", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "showNavigationBar", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "hideNavigationBar", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "getSafeAreaInsets", returnType: CAPPluginReturnPromise)
@@ -23,6 +22,7 @@ public class CapacitorStatusBarPlugin: CAPPlugin, CAPBridgedPlugin {
 
     override public func load() {
         super.load()
+        implementation.setWebView(bridge?.webView)
         // Apply default style based on system theme on plugin load
         implementation.applyDefaultStyle()
     }
@@ -33,18 +33,21 @@ public class CapacitorStatusBarPlugin: CAPPlugin, CAPBridgedPlugin {
             return
         }
         let color = call.getString("color")
-        implementation.setStyle(style: style, colorHex: color)
-        call.resolve()
+        implementation.setStyle(style: style, colorHex: color) {
+            call.resolve()
+        }
     }
 
     @objc func show(_ call: CAPPluginCall) {
-        implementation.show(animated: true)
-        call.resolve()
+        implementation.show(animated: true) {
+            call.resolve()
+        }
     }
 
     @objc func hide(_ call: CAPPluginCall) {
-        implementation.hide(animation: "slide")
-        call.resolve()
+        implementation.hide(animation: "slide") {
+            call.resolve()
+        }
     }
 
     @objc func setOverlaysWebView(_ call: CAPPluginCall) {
@@ -52,27 +55,21 @@ public class CapacitorStatusBarPlugin: CAPPlugin, CAPBridgedPlugin {
             call.reject("value is required")
             return
         }
-        implementation.setOverlaysWebView(value: value)
-        call.resolve()
-    }
-
-    @objc func setBackground(_ call: CAPPluginCall) {
-        guard let color = call.getString("color") else {
-            call.reject("color is required")
-            return
+        implementation.setOverlaysWebView(value: value) {
+            call.resolve()
         }
-        implementation.setBackground(colorHex: color)
-        call.resolve()
     }
 
     @objc func showNavigationBar(_ call: CAPPluginCall) {
-        implementation.showNavigationBar(animated: true)
-        call.resolve()
+        implementation.showNavigationBar(animated: true) {
+            call.resolve()
+        }
     }
 
     @objc func hideNavigationBar(_ call: CAPPluginCall) {
-        implementation.hideNavigationBar(animation: "slide")
-        call.resolve()
+        implementation.hideNavigationBar(animation: "slide") {
+            call.resolve()
+        }
     }
 
     @objc func getSafeAreaInsets(_ call: CAPPluginCall) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-plugin-status-bar",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "description": "Capacitor plugin for managing the status bar style, visibility, and color on iOS and Android. Control overlay modes, background colors, and appearance for native mobile applications.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",