capacitor-plugin-status-bar 2.0.0

package/dist/plugin.cjs.js

@@ -0,0 +1,62 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+exports.Style = void 0;
+(function (Style) {
+    Style["LIGHT"] = "LIGHT";
+    Style["DARK"] = "DARK";
+    Style["CUSTOM"] = "CUSTOM";
+})(exports.Style || (exports.Style = {}));
+exports.StatusBarAnimation = void 0;
+(function (StatusBarAnimation) {
+    StatusBarAnimation["NONE"] = "none";
+    StatusBarAnimation["FADE"] = "fade";
+    StatusBarAnimation["SLIDE"] = "slide";
+})(exports.StatusBarAnimation || (exports.StatusBarAnimation = {}));
+
+const StatusBar = core.registerPlugin('StatusBar', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.StatusBarWeb()),
+});
+
+class StatusBarWeb extends core.WebPlugin {
+    async setStyle(options) {
+        console.log('setStyle', options);
+    }
+    async show(options) {
+        console.log('show', options);
+    }
+    async hide(options) {
+        console.log('hide', options);
+    }
+    async setOverlaysWebView(options) {
+        console.log('setOverlaysWebView', options);
+    }
+    async setBackground(options) {
+        console.log('setBackground', options);
+    }
+    async getSafeAreaInsets() {
+        // On web, we can use CSS environment variables to get safe area insets
+        // These are set by the browser on devices with notches, etc.
+        const getInsetValue = (variable) => {
+            const value = getComputedStyle(document.documentElement).getPropertyValue(variable).trim();
+            return value ? parseInt(value, 10) : 0;
+        };
+        const insets = {
+            top: getInsetValue('env(safe-area-inset-top)') || getInsetValue('constant(safe-area-inset-top)') || 0,
+            bottom: getInsetValue('env(safe-area-inset-bottom)') || getInsetValue('constant(safe-area-inset-bottom)') || 0,
+            left: getInsetValue('env(safe-area-inset-left)') || getInsetValue('constant(safe-area-inset-left)') || 0,
+            right: getInsetValue('env(safe-area-inset-right)') || getInsetValue('constant(safe-area-inset-right)') || 0,
+        };
+        console.log('getSafeAreaInsets', insets);
+        return insets;
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    StatusBarWeb: StatusBarWeb
+});
+
+exports.StatusBar = StatusBar;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["export var Style;\n(function (Style) {\n    Style[\"LIGHT\"] = \"LIGHT\";\n    Style[\"DARK\"] = \"DARK\";\n    Style[\"CUSTOM\"] = \"CUSTOM\";\n})(Style || (Style = {}));\nexport var StatusBarAnimation;\n(function (StatusBarAnimation) {\n    StatusBarAnimation[\"NONE\"] = \"none\";\n    StatusBarAnimation[\"FADE\"] = \"fade\";\n    StatusBarAnimation[\"SLIDE\"] = \"slide\";\n})(StatusBarAnimation || (StatusBarAnimation = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst StatusBar = registerPlugin('StatusBar', {\n    web: () => import('./web').then((m) => new m.StatusBarWeb()),\n});\nexport * from './definitions';\nexport { StatusBar };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class StatusBarWeb extends WebPlugin {\n    async setStyle(options) {\n        console.log('setStyle', options);\n    }\n    async show(options) {\n        console.log('show', options);\n    }\n    async hide(options) {\n        console.log('hide', options);\n    }\n    async setOverlaysWebView(options) {\n        console.log('setOverlaysWebView', options);\n    }\n    async setBackground(options) {\n        console.log('setBackground', options);\n    }\n    async getSafeAreaInsets() {\n        // On web, we can use CSS environment variables to get safe area insets\n        // These are set by the browser on devices with notches, etc.\n        const getInsetValue = (variable) => {\n            const value = getComputedStyle(document.documentElement).getPropertyValue(variable).trim();\n            return value ? parseInt(value, 10) : 0;\n        };\n        const insets = {\n            top: getInsetValue('env(safe-area-inset-top)') || getInsetValue('constant(safe-area-inset-top)') || 0,\n            bottom: getInsetValue('env(safe-area-inset-bottom)') || getInsetValue('constant(safe-area-inset-bottom)') || 0,\n            left: getInsetValue('env(safe-area-inset-left)') || getInsetValue('constant(safe-area-inset-left)') || 0,\n            right: getInsetValue('env(safe-area-inset-right)') || getInsetValue('constant(safe-area-inset-right)') || 0,\n        };\n        console.log('getSafeAreaInsets', insets);\n        return insets;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["Style","StatusBarAnimation","registerPlugin","WebPlugin"],"mappings":";;;;AAAWA;AACX,CAAC,UAAU,KAAK,EAAE;AAClB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO;AAC5B,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM;AAC1B,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,QAAQ;AAC9B,CAAC,EAAEA,aAAK,KAAKA,aAAK,GAAG,EAAE,CAAC,CAAC;AACdC;AACX,CAAC,UAAU,kBAAkB,EAAE;AAC/B,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,MAAM;AACvC,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,MAAM;AACvC,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,OAAO;AACzC,CAAC,EAAEA,0BAAkB,KAAKA,0BAAkB,GAAG,EAAE,CAAC,CAAC;;ACV9C,MAAC,SAAS,GAAGC,mBAAc,CAAC,WAAW,EAAE;AAC9C,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;AAChE,CAAC;;ACFM,MAAM,YAAY,SAASC,cAAS,CAAC;AAC5C,IAAI,MAAM,QAAQ,CAAC,OAAO,EAAE;AAC5B,QAAQ,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC;AACxC,IAAI;AACJ,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;AACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;AACpC,IAAI;AACJ,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;AACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;AACpC,IAAI;AACJ,IAAI,MAAM,kBAAkB,CAAC,OAAO,EAAE;AACtC,QAAQ,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC;AAClD,IAAI;AACJ,IAAI,MAAM,aAAa,CAAC,OAAO,EAAE;AACjC,QAAQ,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC;AAC7C,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG;AAC9B;AACA;AACA,QAAQ,MAAM,aAAa,GAAG,CAAC,QAAQ,KAAK;AAC5C,YAAY,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;AACtG,YAAY,OAAO,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC;AAClD,QAAQ,CAAC;AACT,QAAQ,MAAM,MAAM,GAAG;AACvB,YAAY,GAAG,EAAE,aAAa,CAAC,0BAA0B,CAAC,IAAI,aAAa,CAAC,+BAA+B,CAAC,IAAI,CAAC;AACjH,YAAY,MAAM,EAAE,aAAa,CAAC,6BAA6B,CAAC,IAAI,aAAa,CAAC,kCAAkC,CAAC,IAAI,CAAC;AAC1H,YAAY,IAAI,EAAE,aAAa,CAAC,2BAA2B,CAAC,IAAI,aAAa,CAAC,gCAAgC,CAAC,IAAI,CAAC;AACpH,YAAY,KAAK,EAAE,aAAa,CAAC,4BAA4B,CAAC,IAAI,aAAa,CAAC,iCAAiC,CAAC,IAAI,CAAC;AACvH,SAAS;AACT,QAAQ,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC;AAChD,QAAQ,OAAO,MAAM;AACrB,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,65 @@
+var capStatusBar = (function (exports, core) {
+    'use strict';
+
+    exports.Style = void 0;
+    (function (Style) {
+        Style["LIGHT"] = "LIGHT";
+        Style["DARK"] = "DARK";
+        Style["CUSTOM"] = "CUSTOM";
+    })(exports.Style || (exports.Style = {}));
+    exports.StatusBarAnimation = void 0;
+    (function (StatusBarAnimation) {
+        StatusBarAnimation["NONE"] = "none";
+        StatusBarAnimation["FADE"] = "fade";
+        StatusBarAnimation["SLIDE"] = "slide";
+    })(exports.StatusBarAnimation || (exports.StatusBarAnimation = {}));
+
+    const StatusBar = core.registerPlugin('StatusBar', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.StatusBarWeb()),
+    });
+
+    class StatusBarWeb extends core.WebPlugin {
+        async setStyle(options) {
+            console.log('setStyle', options);
+        }
+        async show(options) {
+            console.log('show', options);
+        }
+        async hide(options) {
+            console.log('hide', options);
+        }
+        async setOverlaysWebView(options) {
+            console.log('setOverlaysWebView', options);
+        }
+        async setBackground(options) {
+            console.log('setBackground', options);
+        }
+        async getSafeAreaInsets() {
+            // On web, we can use CSS environment variables to get safe area insets
+            // These are set by the browser on devices with notches, etc.
+            const getInsetValue = (variable) => {
+                const value = getComputedStyle(document.documentElement).getPropertyValue(variable).trim();
+                return value ? parseInt(value, 10) : 0;
+            };
+            const insets = {
+                top: getInsetValue('env(safe-area-inset-top)') || getInsetValue('constant(safe-area-inset-top)') || 0,
+                bottom: getInsetValue('env(safe-area-inset-bottom)') || getInsetValue('constant(safe-area-inset-bottom)') || 0,
+                left: getInsetValue('env(safe-area-inset-left)') || getInsetValue('constant(safe-area-inset-left)') || 0,
+                right: getInsetValue('env(safe-area-inset-right)') || getInsetValue('constant(safe-area-inset-right)') || 0,
+            };
+            console.log('getSafeAreaInsets', insets);
+            return insets;
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        StatusBarWeb: StatusBarWeb
+    });
+
+    exports.StatusBar = StatusBar;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["export var Style;\n(function (Style) {\n    Style[\"LIGHT\"] = \"LIGHT\";\n    Style[\"DARK\"] = \"DARK\";\n    Style[\"CUSTOM\"] = \"CUSTOM\";\n})(Style || (Style = {}));\nexport var StatusBarAnimation;\n(function (StatusBarAnimation) {\n    StatusBarAnimation[\"NONE\"] = \"none\";\n    StatusBarAnimation[\"FADE\"] = \"fade\";\n    StatusBarAnimation[\"SLIDE\"] = \"slide\";\n})(StatusBarAnimation || (StatusBarAnimation = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst StatusBar = registerPlugin('StatusBar', {\n    web: () => import('./web').then((m) => new m.StatusBarWeb()),\n});\nexport * from './definitions';\nexport { StatusBar };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class StatusBarWeb extends WebPlugin {\n    async setStyle(options) {\n        console.log('setStyle', options);\n    }\n    async show(options) {\n        console.log('show', options);\n    }\n    async hide(options) {\n        console.log('hide', options);\n    }\n    async setOverlaysWebView(options) {\n        console.log('setOverlaysWebView', options);\n    }\n    async setBackground(options) {\n        console.log('setBackground', options);\n    }\n    async getSafeAreaInsets() {\n        // On web, we can use CSS environment variables to get safe area insets\n        // These are set by the browser on devices with notches, etc.\n        const getInsetValue = (variable) => {\n            const value = getComputedStyle(document.documentElement).getPropertyValue(variable).trim();\n            return value ? parseInt(value, 10) : 0;\n        };\n        const insets = {\n            top: getInsetValue('env(safe-area-inset-top)') || getInsetValue('constant(safe-area-inset-top)') || 0,\n            bottom: getInsetValue('env(safe-area-inset-bottom)') || getInsetValue('constant(safe-area-inset-bottom)') || 0,\n            left: getInsetValue('env(safe-area-inset-left)') || getInsetValue('constant(safe-area-inset-left)') || 0,\n            right: getInsetValue('env(safe-area-inset-right)') || getInsetValue('constant(safe-area-inset-right)') || 0,\n        };\n        console.log('getSafeAreaInsets', insets);\n        return insets;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["Style","StatusBarAnimation","registerPlugin","WebPlugin"],"mappings":";;;AAAWA;IACX,CAAC,UAAU,KAAK,EAAE;IAClB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO;IAC5B,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM;IAC1B,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,QAAQ;IAC9B,CAAC,EAAEA,aAAK,KAAKA,aAAK,GAAG,EAAE,CAAC,CAAC;AACdC;IACX,CAAC,UAAU,kBAAkB,EAAE;IAC/B,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,MAAM;IACvC,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,MAAM;IACvC,IAAI,kBAAkB,CAAC,OAAO,CAAC,GAAG,OAAO;IACzC,CAAC,EAAEA,0BAAkB,KAAKA,0BAAkB,GAAG,EAAE,CAAC,CAAC;;ACV9C,UAAC,SAAS,GAAGC,mBAAc,CAAC,WAAW,EAAE;IAC9C,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;IAChE,CAAC;;ICFM,MAAM,YAAY,SAASC,cAAS,CAAC;IAC5C,IAAI,MAAM,QAAQ,CAAC,OAAO,EAAE;IAC5B,QAAQ,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC;IACxC,IAAI;IACJ,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;IACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IACpC,IAAI;IACJ,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE;IACxB,QAAQ,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IACpC,IAAI;IACJ,IAAI,MAAM,kBAAkB,CAAC,OAAO,EAAE;IACtC,QAAQ,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAClD,IAAI;IACJ,IAAI,MAAM,aAAa,CAAC,OAAO,EAAE;IACjC,QAAQ,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC;IAC7C,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG;IAC9B;IACA;IACA,QAAQ,MAAM,aAAa,GAAG,CAAC,QAAQ,KAAK;IAC5C,YAAY,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;IACtG,YAAY,OAAO,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC;IAClD,QAAQ,CAAC;IACT,QAAQ,MAAM,MAAM,GAAG;IACvB,YAAY,GAAG,EAAE,aAAa,CAAC,0BAA0B,CAAC,IAAI,aAAa,CAAC,+BAA+B,CAAC,IAAI,CAAC;IACjH,YAAY,MAAM,EAAE,aAAa,CAAC,6BAA6B,CAAC,IAAI,aAAa,CAAC,kCAAkC,CAAC,IAAI,CAAC;IAC1H,YAAY,IAAI,EAAE,aAAa,CAAC,2BAA2B,CAAC,IAAI,aAAa,CAAC,gCAAgC,CAAC,IAAI,CAAC;IACpH,YAAY,KAAK,EAAE,aAAa,CAAC,4BAA4B,CAAC,IAAI,aAAa,CAAC,iCAAiC,CAAC,IAAI,CAAC;IACvH,SAAS;IACT,QAAQ,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAChD,QAAQ,OAAO,MAAM;IACrB,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/StatusBarPlugin/StatusBar.swift

@@ -0,0 +1,325 @@
+import Foundation
+import UIKit
+import Capacitor
+
+@objc public class StatusBar: NSObject {
+    // Tag to identify the status bar background view
+    private static let statusBarViewTag = 38482458
+    // Store the current background color to restore when showing
+    private var currentBackgroundColor: UIColor?
+    // Track whether overlays web view mode is active
+    private var isOverlayMode = false
+
+    @objc public func applyDefaultStyle() {
+        DispatchQueue.main.async {
+            let isDarkMode = self.isSystemInDarkMode()
+            let style = isDarkMode ? "DARK" : "LIGHT"
+            print("StatusBar: Applying default style based on system theme - isDarkMode=\(isDarkMode), style=\(style)")
+            self.setStyle(style: style, colorHex: nil)
+        }
+    }
+
+    @objc public func setStyle(style: String, colorHex: String?) {
+        DispatchQueue.main.async {
+            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 }
+
+            let upperStyle = style.uppercased()
+            var backgroundColor: UIColor?
+            var statusBarStyle: UIStatusBarStyle = .default
+
+            // 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")
+
+            // Store the background color for later restoration
+            self.currentBackgroundColor = backgroundColor
+
+            // Skip background color update when overlays web view is active
+            if self.isOverlayMode {
+                print("StatusBar: 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)
+            }
+
+            print("StatusBar: setStyle - style=\(upperStyle), backgroundColor=\(String(describing: backgroundColor)), statusBarStyle=\(statusBarStyle)")
+        }
+    }
+
+    @objc public func show(animated: Bool) {
+        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.
+
+            // Log current status bar state via status bar manager
+            if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+               let statusBarManager = windowScene.statusBarManager {
+                print("StatusBar: show() - Current hidden state: \(statusBarManager.isStatusBarHidden)")
+            }
+
+            // Set visibility using the application-level API
+            // Note: This requires UIViewControllerBasedStatusBarAppearance = NO
+            self.setStatusBarVisibility(hidden: false, animated: animated)
+
+            // Restore the background view color when showing
+            self.restoreStatusBarBackgroundColor()
+        }
+    }
+
+    @objc public func hide(animation: String) {
+        DispatchQueue.main.async {
+            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("StatusBar: hide() - animation=\(animationType), Current hidden state: \(statusBarManager.isStatusBarHidden)")
+            }
+
+            if animationType == "fade" {
+                // Fade mode: Make background transparent without removing status bar
+                print("StatusBar: hide() - fade mode: making background transparent")
+                self.makeStatusBarBackgroundTransparent()
+            } else if animationType == "slide" {
+                // Slide mode: Hide the status bar completely (current behavior)
+                print("StatusBar: 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()
+            } else {
+                print("StatusBar: hide() - unknown animation type '\(animationType)', defaulting to slide")
+                self.setStatusBarVisibility(hidden: true, animated: true)
+                self.makeStatusBarBackgroundTransparent()
+            }
+        }
+    }
+
+    // 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
+    ///   - height: The height of the status bar
+    ///   - color: The background color (nil to remove the view)
+    private func updateStatusBarBackgroundView(in window: UIWindow, height: CGFloat, color: UIColor?) {
+        // Find existing status bar view
+        let existingView = window.viewWithTag(StatusBar.statusBarViewTag)
+
+        if let color = color {
+            // Create or update the status bar background view
+            let statusBarView: UIView
+
+            if let existing = existingView {
+                statusBarView = existing
+            } else {
+                statusBarView = UIView(frame: CGRect(x: 0, y: 0, width: window.bounds.width, height: height))
+                statusBarView.tag = StatusBar.statusBarViewTag
+                statusBarView.autoresizingMask = [.flexibleWidth]
+                window.addSubview(statusBarView)
+            }
+
+            // Update the frame and color
+            statusBarView.frame = CGRect(x: 0, y: 0, width: window.bounds.width, height: height)
+            statusBarView.backgroundColor = color
+
+            // Ensure the view is on top
+            window.bringSubviewToFront(statusBarView)
+        } else {
+            // Remove the status bar view if color is nil
+            existingView?.removeFromSuperview()
+        }
+    }
+
+    @objc public func setOverlaysWebView(value: Bool) {
+        DispatchQueue.main.async {
+            guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+                  let window = windowScene.windows.first,
+                  let statusBarManager = windowScene.statusBarManager else {
+                print("StatusBar: setOverlaysWebView - Unable to get window or status bar manager")
+                return
+            }
+
+            self.isOverlayMode = value
+
+            if value {
+                // Overlay mode: make the status bar background transparent so web content shows through
+                let statusBarView = window.viewWithTag(StatusBar.statusBarViewTag)
+                statusBarView?.backgroundColor = .clear
+                print("StatusBar: 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("StatusBar: setOverlaysWebView(false) - restored background color")
+                } else {
+                    // No style was set; apply default style based on system theme
+                    self.applyDefaultStyle()
+                    print("StatusBar: 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("StatusBar: setBackground - Invalid color or nil")
+                return
+            }
+
+            guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+                  let window = windowScene.windows.first else {
+                print("StatusBar: setBackground - Unable to get window")
+                return
+            }
+
+            window.backgroundColor = color
+            print("StatusBar: setBackground - Set window background to \(colorHex)")
+        }
+    }
+
+    @objc public func getSafeAreaInsets(completion: @escaping ([String: CGFloat]) -> Void) {
+        DispatchQueue.main.async {
+            var insets: [String: CGFloat] = ["top": 0, "bottom": 0, "left": 0, "right": 0]
+
+            if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+               let window = windowScene.windows.first {
+                let safeAreaInsets = window.safeAreaInsets
+                insets["top"] = safeAreaInsets.top
+                insets["bottom"] = safeAreaInsets.bottom
+                insets["left"] = safeAreaInsets.left
+                insets["right"] = safeAreaInsets.right
+
+                print("StatusBar: getSafeAreaInsets - top=\(safeAreaInsets.top), bottom=\(safeAreaInsets.bottom), left=\(safeAreaInsets.left), right=\(safeAreaInsets.right)")
+            } else {
+                print("StatusBar: getSafeAreaInsets - Unable to get window, returning zero insets")
+            }
+
+            completion(insets)
+        }
+    }
+
+    /// Makes the status bar background view transparent
+    private func makeStatusBarBackgroundTransparent() {
+        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+              let window = windowScene.windows.first,
+              let statusBarView = window.viewWithTag(StatusBar.statusBarViewTag) else {
+            return
+        }
+
+        statusBarView.backgroundColor = .clear
+        print("StatusBar: Made background transparent")
+    }
+
+    /// Restores the status bar background view to its original color
+    private func restoreStatusBarBackgroundColor() {
+        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+              let window = windowScene.windows.first,
+              let statusBarManager = windowScene.statusBarManager else {
+            return
+        }
+
+        // Only restore if we have a stored color
+        if let color = self.currentBackgroundColor {
+            self.updateStatusBarBackgroundView(in: window,
+                                               height: statusBarManager.statusBarFrame.height,
+                                               color: color)
+            print("StatusBar: Restored background color: \(color)")
+        }
+    }
+
+    // MARK: - Helper Methods
+
+    private func colorFromHex(_ hex: String) -> UIColor? {
+        var hexSanitized = hex.trimmingCharacters(in: .whitespacesAndNewlines)
+        hexSanitized = hexSanitized.replacingOccurrences(of: "#", with: "")
+
+        var rgb: UInt64 = 0
+        guard Scanner(string: hexSanitized).scanHexInt64(&rgb) else { return nil }
+
+        let length = hexSanitized.count
+        let r, g, b, a: CGFloat
+
+        if length == 6 {
+            r = CGFloat((rgb & 0xFF0000) >> 16) / 255.0
+            g = CGFloat((rgb & 0x00FF00) >> 8) / 255.0
+            b = CGFloat(rgb & 0x0000FF) / 255.0
+            a = 1.0
+        } else if length == 8 {
+            r = CGFloat((rgb & 0xFF000000) >> 24) / 255.0
+            g = CGFloat((rgb & 0x00FF0000) >> 16) / 255.0
+            b = CGFloat((rgb & 0x0000FF00) >> 8) / 255.0
+            a = CGFloat(rgb & 0x000000FF) / 255.0
+        } else {
+            return nil
+        }
+
+        return UIColor(red: r, green: g, blue: b, alpha: a)
+    }
+
+    private func getColorBrightness(_ color: UIColor) -> CGFloat {
+        var red: CGFloat = 0
+        var green: CGFloat = 0
+        var blue: CGFloat = 0
+        var alpha: CGFloat = 0
+
+        color.getRed(&red, green: &green, blue: &blue, alpha: &alpha)
+
+        // Calculate relative luminance using the formula for sRGB
+        return (0.299 * red + 0.587 * green + 0.114 * blue)
+    }
+
+    private func isSystemInDarkMode() -> Bool {
+        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
+              let window = windowScene.windows.first else {
+            return false
+        }
+        return window.traitCollection.userInterfaceStyle == .dark
+    }
+}

package/ios/Sources/StatusBarPlugin/StatusBarPlugin.swift

@@ -0,0 +1,81 @@
+import Foundation
+import Capacitor
+
+/**
+ * Please read the Capacitor iOS Plugin Development Guide
+ * here: https://capacitorjs.com/docs/plugins/ios
+ */
+@objc(StatusBarPlugin)
+public class StatusBarPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "StatusBarPlugin"
+    public let jsName = "StatusBar"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "setStyle", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "show", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "hide", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "setOverlaysWebView", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "setBackground", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getSafeAreaInsets", returnType: CAPPluginReturnPromise)
+    ]
+    private let implementation = StatusBar()
+
+    override public func load() {
+        super.load()
+        // Apply default style based on system theme on plugin load
+        implementation.applyDefaultStyle()
+    }
+
+    @objc func setStyle(_ call: CAPPluginCall) {
+        guard let style = call.getString("style") else {
+            call.reject("style is required")
+            return
+        }
+        let color = call.getString("color")
+        implementation.setStyle(style: style, colorHex: color)
+        call.resolve()
+    }
+
+    @objc func show(_ call: CAPPluginCall) {
+        let animated = call.getBool("animated") ?? true
+        implementation.show(animated: animated)
+        call.resolve()
+    }
+
+    @objc func hide(_ call: CAPPluginCall) {
+        guard let animation = call.getString("animation") else {
+            call.reject("animation is required")
+            return
+        }
+        implementation.hide(animation: animation)
+        call.resolve()
+    }
+
+    @objc func setOverlaysWebView(_ call: CAPPluginCall) {
+        guard let value = call.getBool("value") else {
+            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.setBackground(colorHex: color)
+        call.resolve()
+    }
+
+    @objc func getSafeAreaInsets(_ call: CAPPluginCall) {
+        implementation.getSafeAreaInsets { insets in
+            call.resolve([
+                "top": insets["top"] ?? 0,
+                "bottom": insets["bottom"] ?? 0,
+                "left": insets["left"] ?? 0,
+                "right": insets["right"] ?? 0
+            ])
+        }
+    }
+}

package/ios/Tests/StatusBarPluginTests/StatusBarPluginTests.swift

@@ -0,0 +1,15 @@
+import XCTest
+@testable import StatusBarPlugin
+
+class StatusBarTests: XCTestCase {
+    func testEcho() {
+        // This is an example of a functional test case for a plugin.
+        // Use XCTAssert and related functions to verify your tests produce the correct results.
+
+        let implementation = StatusBar()
+        let value = "Hello, World!"
+        let result = implementation.echo(value)
+
+        XCTAssertEqual(value, result)
+    }
+}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "capacitor-plugin-status-bar",
+  "version": "2.0.0",
+  "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",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapacitorPluginStatusBar.podspec"
+  ],
+  "author": "Abdelfattah Ashour",
+  "license": "MIT",
+  "homepage": "https://github.com/abdelfatah-ashour/cap-status-bar#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abdelfatah-ashour/cap-status-bar.git"
+  },
+  "bugs": {
+    "url": "https://github.com/abdelfatah-ashour/cap-status-bar/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "capacitor-plugin",
+    "capacitor-community",
+    "plugin",
+    "native",
+    "status-bar",
+    "statusbar",
+    "android",
+    "ios",
+    "mobile",
+    "ionic",
+    "cordova",
+    "hybrid-app",
+    "native-bridge",
+    "mobile-app",
+    "status-bar-style",
+    "status-bar-color",
+    "overlay",
+    "immersive",
+    "navigation-bar"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapacitorPluginStatusBar -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api StatusBarPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "bump": "bash scripts/bump-version.sh"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.0",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.4.2",
+    "prettier-plugin-java": "^2.6.6",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.30.1",
+    "swiftlint": "^2.0.0",
+    "typescript": "~4.1.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}