capacitor-plugin-status-bar 2.0.1 → 2.0.3

package/README.md

@@ -137,7 +137,7 @@ getSafeAreaInsets() => Promise<SafeAreaInsets>
 
 Get the safe area insets.
 Returns the insets for status bar, navigation bar, and notch areas.
-Values are in pixels on Android and points on iOS.
+Values are in CSS pixels (dp) on all platforms.
 
 **Returns:** <code>Promise&lt;<a href="#safeareainsets">SafeAreaInsets</a>&gt;</code>
 

package/android/src/main/java/com/cap/plugins/statusbar/StatusBar.java

@@ -21,7 +21,6 @@ import androidx.core.view.WindowInsetsCompat;
 
 import com.getcapacitor.Plugin;
 
-import java.util.Objects;
 
 /**
  * Android Status Bar utilities with Android 10-15+ (API 29-35+) support.
@@ -43,62 +42,65 @@ public class StatusBar extends Plugin {
     private int currentStatusBarColor = Color.BLACK;
     private int currentNavBarColor = Color.BLACK;
 
-    @Override
-    public void load() {
-        super.load();
-        setupEdgeToEdgeBehavior();
-    }
-
-    private void setupEdgeToEdgeBehavior() {
-        Activity activity = getActivity();
-        if (activity == null)
-            return;
-
-        Window window = activity.getWindow();
-        View decorView = window.getDecorView();
-
-        WindowCompat.setDecorFitsSystemWindows(window, false);
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) { // Android 14+
-            ViewCompat.setOnApplyWindowInsetsListener(decorView, (v, insets) -> {
-                ViewCompat.onApplyWindowInsets(v, insets);
-                return insets;
-            });
-        }
-    }
+    // Note: load() is not called since StatusBar is instantiated via new StatusBar()
+    // from StatusBarPlugin, not registered as a Capacitor plugin itself.
+    // All initialization happens via ensureEdgeToEdgeConfigured() called from StatusBarPlugin.load().
 
     /**
      * Ensures edge-to-edge is properly configured for Android 15+.
-     * This fixes the keyboard extra space issue by properly handling IME insets
-     * using the modern WindowInsets API instead of deprecated soft input modes.
+     * Sets up a unified insets listener on the decorView that handles both
+     * IME insets and overlay view sizing.
      *
      * @param activity The activity to configure
      */
     public void ensureEdgeToEdgeConfigured(Activity activity) {
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) { // Android 15 (API 35)
-            Window window = activity.getWindow();
-            View decorView = window.getDecorView();
+        Window window = activity.getWindow();
+        View decorView = window.getDecorView();
 
-            // Enable edge-to-edge mode for Android 15+
-            WindowCompat.setDecorFitsSystemWindows(window, false);
+        // Enable edge-to-edge for ALL API levels.
+        // window.setStatusBarColor() is unreliable on many devices/OEMs,
+        // so we use overlay views to control bar colors consistently.
+        WindowCompat.setDecorFitsSystemWindows(window, false);
 
-            ViewCompat.setOnApplyWindowInsetsListener(decorView, (v, insets) -> {
-                androidx.core.graphics.Insets imeInsets = insets.getInsets(WindowInsetsCompat.Type.ime());
-                androidx.core.graphics.Insets systemBarsInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars());
+        // Make native bar colors transparent so our overlays are the sole color source
+        window.setStatusBarColor(Color.TRANSPARENT);
+        window.setNavigationBarColor(Color.TRANSPARENT);
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            window.setStatusBarContrastEnforced(false);
+            window.setNavigationBarContrastEnforced(false);
+        }
 
-                boolean isKeyboardVisible = imeInsets.bottom > 0;
-                Log.d(TAG, "ensureEdgeToEdgeConfigured: IME visible=" + isKeyboardVisible
-                        + ", IME bottom=" + imeInsets.bottom
-                        + ", system bars bottom=" + systemBarsInsets.bottom);
+        // Single unified insets listener on decorView for overlay sizing
+        ViewCompat.setOnApplyWindowInsetsListener(decorView, (v, insets) -> {
+            // Size status bar overlay
+            int top = insets.getInsets(WindowInsetsCompat.Type.statusBars()).top;
+            View statusOverlay = ((ViewGroup) v).findViewWithTag(STATUS_BAR_OVERLAY_TAG);
+            if (statusOverlay != null) {
+                ViewGroup.LayoutParams params = statusOverlay.getLayoutParams();
+                if (params.height != top) {
+                    params.height = top;
+                    statusOverlay.setLayoutParams(params);
+                    Log.d(TAG, "insetsListener: status bar overlay height=" + top);
+                }
+            }
 
-                ViewCompat.onApplyWindowInsets(v, insets);
-                return insets;
-            });
+            // Size navigation bar overlay
+            int bottom = insets.getInsets(WindowInsetsCompat.Type.navigationBars()).bottom;
+            View navOverlay = ((ViewGroup) v).findViewWithTag(NAV_BAR_OVERLAY_TAG);
+            if (navOverlay != null) {
+                ViewGroup.LayoutParams params = navOverlay.getLayoutParams();
+                if (params.height != bottom) {
+                    params.height = bottom;
+                    navOverlay.setLayoutParams(params);
+                    Log.d(TAG, "insetsListener: nav bar overlay height=" + bottom);
+                }
+            }
 
-            Log.d(TAG,
-                    "ensureEdgeToEdgeConfigured: Edge-to-edge enabled with WindowInsets API for Android 15+ (API 35+)");
-        } else {
-            Log.d(TAG, "ensureEdgeToEdgeConfigured: Android < 15, no action needed");
-        }
+            ViewCompat.onApplyWindowInsets(v, insets);
+            return insets;
+        });
+
+        Log.d(TAG, "ensureEdgeToEdgeConfigured: edge-to-edge with overlay views, API=" + Build.VERSION.SDK_INT);
     }
 
     public void setOverlaysWebView(Activity activity, boolean overlay) {
@@ -196,11 +198,6 @@ public class StatusBar extends Plugin {
         Log.d(TAG, "setStyle: style=" + style + ", colorHex=" + colorHex);
         Window window = activity.getWindow();
 
-        // Enable drawing of system bar backgrounds (required for color changes)
-        window.addFlags(android.view.WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
-        window.clearFlags(android.view.WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
-        window.clearFlags(android.view.WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION);
-
         // Store the current style and color for later reapplication
         currentStyle = style;
         currentColorHex = colorHex;
@@ -279,60 +276,45 @@ public class StatusBar extends Plugin {
      * Returns the insets for status bar, navigation bar, and notch areas.
      *
      * @param activity The activity to get the insets from
-     * @return A map containing top, bottom, left, and right inset values in pixels
+     * @return A map containing top, bottom, left, and right inset values in dp (density-independent pixels)
      */
     public java.util.Map<String, Integer> getSafeAreaInsets(Activity activity) {
         Log.d(TAG, "getSafeAreaInsets");
         java.util.Map<String, Integer> insets = new java.util.HashMap<>();
+        float density = activity.getResources().getDisplayMetrics().density;
 
-        Window window = activity.getWindow();
-        View decorView = window.getDecorView();
-
-        WindowInsets windowInsets = decorView.getRootWindowInsets();
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-            // API 30+ (Android 11+) - Use WindowInsets API
-            if (windowInsets != null) {
-                android.graphics.Insets systemBarsInsets = windowInsets.getInsets(WindowInsets.Type.systemBars());
-                android.graphics.Insets displayCutoutInsets = windowInsets.getInsets(WindowInsets.Type.displayCutout());
-
-                // Combine system bars and display cutout insets (use maximum of both)
-                insets.put("top", Math.max(systemBarsInsets.top, displayCutoutInsets.top));
-                insets.put("bottom", Math.max(systemBarsInsets.bottom, displayCutoutInsets.bottom));
-                insets.put("left", Math.max(systemBarsInsets.left, displayCutoutInsets.left));
-                insets.put("right", Math.max(systemBarsInsets.right, displayCutoutInsets.right));
-
-                Log.d(TAG, "getSafeAreaInsets (API 30+): top=" + insets.get("top")
-                        + ", bottom=" + insets.get("bottom")
-                        + ", left=" + insets.get("left")
-                        + ", right=" + insets.get("right"));
-            } else {
-                // Fallback to zero insets
-                insets.put("top", 0);
-                insets.put("bottom", 0);
-                insets.put("left", 0);
-                insets.put("right", 0);
-                Log.w(TAG, "getSafeAreaInsets: windowInsets is null");
-            }
+        View decorView = activity.getWindow().getDecorView();
+        WindowInsetsCompat windowInsets = ViewCompat.getRootWindowInsets(decorView);
+
+        if (windowInsets != null) {
+            // Use WindowInsetsCompat for accurate, type-specific insets across all API levels
+            androidx.core.graphics.Insets statusBars = windowInsets.getInsets(WindowInsetsCompat.Type.statusBars());
+            androidx.core.graphics.Insets navBars = windowInsets.getInsets(WindowInsetsCompat.Type.navigationBars());
+            androidx.core.graphics.Insets displayCutout = windowInsets.getInsets(WindowInsetsCompat.Type.displayCutout());
+
+            int topPx = Math.max(statusBars.top, displayCutout.top);
+            int bottomPx = Math.max(navBars.bottom, displayCutout.bottom);
+            int leftPx = Math.max(navBars.left, displayCutout.left);
+            int rightPx = Math.max(navBars.right, displayCutout.right);
+
+            // Convert physical pixels to dp (CSS pixels) for the WebView layer
+            insets.put("top", Math.round(topPx / density));
+            insets.put("bottom", Math.round(bottomPx / density));
+            insets.put("left", Math.round(leftPx / density));
+            insets.put("right", Math.round(rightPx / density));
+
+            Log.d(TAG, "getSafeAreaInsets: topPx=" + topPx + " bottomPx=" + bottomPx
+                    + " density=" + density
+                    + " -> top=" + insets.get("top") + "dp"
+                    + " bottom=" + insets.get("bottom") + "dp"
+                    + " left=" + insets.get("left") + "dp"
+                    + " right=" + insets.get("right") + "dp");
         } else {
-            // API 29 (Android 10) - Use deprecated system window insets
-            if (windowInsets != null) {
-                insets.put("top", windowInsets.getSystemWindowInsetTop());
-                insets.put("bottom", windowInsets.getSystemWindowInsetBottom());
-                insets.put("left", windowInsets.getSystemWindowInsetLeft());
-                insets.put("right", windowInsets.getSystemWindowInsetRight());
-
-                Log.d(TAG, "getSafeAreaInsets (API 29): top=" + insets.get("top")
-                        + ", bottom=" + insets.get("bottom")
-                        + ", left=" + insets.get("left")
-                        + ", right=" + insets.get("right"));
-            } else {
-                // Fallback to zero insets
-                insets.put("top", 0);
-                insets.put("bottom", 0);
-                insets.put("left", 0);
-                insets.put("right", 0);
-                Log.w(TAG, "getSafeAreaInsets: windowInsets is null");
-            }
+            insets.put("top", 0);
+            insets.put("bottom", 0);
+            insets.put("left", 0);
+            insets.put("right", 0);
+            Log.w(TAG, "getSafeAreaInsets: windowInsets is null");
         }
 
         return insets;
@@ -400,16 +382,14 @@ public class StatusBar extends Plugin {
 
     private void applyStatusBarBackground(Activity activity, @ColorInt int color) {
         Log.d(TAG, "applyStatusBarBackground: color=#" + Integer.toHexString(color) + ", API=" + Build.VERSION.SDK_INT);
-        // Use overlay approach for all API levels since edge-to-edge mode
-        // (setDecorFitsSystemWindows=false) makes window.setStatusBarColor() ineffective
+        // Use overlay views for all API levels for consistent behavior
         ensureStatusBarOverlay(activity, color);
     }
 
     private void applyNavigationBarBackground(Activity activity, @ColorInt int color) {
         Log.d(TAG, "applyNavigationBarBackground: color=#" + Integer.toHexString(color) + ", API="
                 + Build.VERSION.SDK_INT);
-        // Use overlay approach for all API levels since edge-to-edge mode
-        // (setDecorFitsSystemWindows=false) makes window.setNavigationBarColor() ineffective
+        // Use overlay views for all API levels for consistent behavior
         ensureNavBarOverlay(activity, color);
     }
 
@@ -417,41 +397,38 @@ public class StatusBar extends Plugin {
         Log.d(TAG, "ensureStatusBarOverlay: color=#" + Integer.toHexString(color));
         ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
         View existing = decorView.findViewWithTag(STATUS_BAR_OVERLAY_TAG);
+
+        // Get current status bar height synchronously for immediate sizing
+        int initialHeight = 0;
+        WindowInsetsCompat rootInsets = ViewCompat.getRootWindowInsets(decorView);
+        if (rootInsets != null) {
+            initialHeight = rootInsets.getInsets(WindowInsetsCompat.Type.statusBars()).top;
+        }
+
         if (existing == null) {
-            Log.d(TAG, "ensureStatusBarOverlay: creating new overlay");
+            Log.d(TAG, "ensureStatusBarOverlay: creating new overlay, initialHeight=" + initialHeight);
             View overlay = new View(activity);
             overlay.setTag(STATUS_BAR_OVERLAY_TAG);
             overlay.setBackgroundColor(color);
 
             FrameLayout.LayoutParams lp = new FrameLayout.LayoutParams(
                     ViewGroup.LayoutParams.MATCH_PARENT,
-                    0);
-            lp.topMargin = 0;
+                    initialHeight);
             overlay.setLayoutParams(lp);
 
-            // Add to the top of the decor view
             decorView.addView(overlay);
-
-            // Apply correct height from insets
-            ViewCompat.setOnApplyWindowInsetsListener(overlay, (v, windowInsets) -> {
-                int top;
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-                    top = Objects.requireNonNull(windowInsets.toWindowInsets())
-                            .getInsets(WindowInsets.Type.statusBars()).top;
-                } else {
-                    top = Objects.requireNonNull(windowInsets.toWindowInsets()).getSystemWindowInsetTop();
-                }
-                ViewGroup.LayoutParams params = v.getLayoutParams();
-                params.height = top;
-                v.setLayoutParams(params);
-                // Don't set color here - it's set before listener and should not be overridden
-                return windowInsets;
-            });
-            overlay.requestApplyInsets();
+            // Sizing updates are handled by the unified listener in ensureEdgeToEdgeConfigured
+            decorView.requestApplyInsets();
         } else {
             Log.d(TAG, "ensureStatusBarOverlay: updating existing overlay");
             existing.setBackgroundColor(color);
-            existing.requestApplyInsets();
+            // Update height if it was 0 (listener hadn't fired yet)
+            ViewGroup.LayoutParams params = existing.getLayoutParams();
+            if (params.height == 0 && initialHeight > 0) {
+                params.height = initialHeight;
+                existing.setLayoutParams(params);
+                Log.d(TAG, "ensureStatusBarOverlay: fixed height to " + initialHeight);
+            }
         }
     }
 
@@ -469,39 +446,39 @@ public class StatusBar extends Plugin {
         Log.d(TAG, "ensureNavBarOverlay: color=#" + Integer.toHexString(color));
         ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
         View existing = decorView.findViewWithTag(NAV_BAR_OVERLAY_TAG);
+
+        // Get current nav bar height synchronously for immediate sizing
+        int initialHeight = 0;
+        WindowInsetsCompat rootInsets = ViewCompat.getRootWindowInsets(decorView);
+        if (rootInsets != null) {
+            initialHeight = rootInsets.getInsets(WindowInsetsCompat.Type.navigationBars()).bottom;
+        }
+
         if (existing == null) {
-            Log.d(TAG, "ensureNavBarOverlay: creating new overlay");
+            Log.d(TAG, "ensureNavBarOverlay: creating new overlay, initialHeight=" + initialHeight);
             View overlay = new View(activity);
             overlay.setTag(NAV_BAR_OVERLAY_TAG);
             overlay.setBackgroundColor(color);
 
             FrameLayout.LayoutParams lp = new FrameLayout.LayoutParams(
                     ViewGroup.LayoutParams.MATCH_PARENT,
-                    0);
+                    initialHeight);
             lp.gravity = Gravity.BOTTOM;
             overlay.setLayoutParams(lp);
 
             decorView.addView(overlay);
-
-            ViewCompat.setOnApplyWindowInsetsListener(overlay, (v, windowInsets) -> {
-                int bottom;
-                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-                    bottom = Objects.requireNonNull(windowInsets.toWindowInsets())
-                            .getInsets(WindowInsets.Type.navigationBars()).bottom;
-                } else {
-                    bottom = Objects.requireNonNull(windowInsets.toWindowInsets()).getSystemWindowInsetBottom();
-                }
-                ViewGroup.LayoutParams params = v.getLayoutParams();
-                params.height = bottom;
-                v.setLayoutParams(params);
-                // Don't set color here - it's set before listener and should not be overridden
-                return windowInsets;
-            });
-            overlay.requestApplyInsets();
+            // Sizing updates are handled by the unified listener in ensureEdgeToEdgeConfigured
+            decorView.requestApplyInsets();
         } else {
             Log.d(TAG, "ensureNavBarOverlay: updating existing overlay");
             existing.setBackgroundColor(color);
-            existing.requestApplyInsets();
+            // Update height if it was 0 (listener hadn't fired yet)
+            ViewGroup.LayoutParams params = existing.getLayoutParams();
+            if (params.height == 0 && initialHeight > 0) {
+                params.height = initialHeight;
+                existing.setLayoutParams(params);
+                Log.d(TAG, "ensureNavBarOverlay: fixed height to " + initialHeight);
+            }
         }
     }
 
@@ -527,18 +504,15 @@ public class StatusBar extends Plugin {
      */
     private void makeStatusBarBackgroundTransparent(Activity activity) {
         Log.d(TAG, "makeStatusBarBackgroundTransparent: API=" + Build.VERSION.SDK_INT);
-        Window window = activity.getWindow();
+        ViewGroup decorView = (ViewGroup) activity.getWindow().getDecorView();
 
-        // Make overlay views transparent (used for all API levels)
-        ViewGroup decorView = (ViewGroup) window.getDecorView();
         View statusBarOverlay = decorView.findViewWithTag(STATUS_BAR_OVERLAY_TAG);
-        View navBarOverlay = decorView.findViewWithTag(NAV_BAR_OVERLAY_TAG);
-
         if (statusBarOverlay != null) {
             statusBarOverlay.setBackgroundColor(Color.TRANSPARENT);
             Log.d(TAG, "makeStatusBarBackgroundTransparent: status bar overlay made transparent");
         }
 
+        View navBarOverlay = decorView.findViewWithTag(NAV_BAR_OVERLAY_TAG);
         if (navBarOverlay != null) {
             navBarOverlay.setBackgroundColor(Color.TRANSPARENT);
             Log.d(TAG, "makeStatusBarBackgroundTransparent: navigation bar overlay made transparent");

package/dist/docs.json

@@ -150,7 +150,7 @@
         "parameters": [],
         "returns": "Promise<SafeAreaInsets>",
         "tags": [],
-        "docs": "Get the safe area insets.\nReturns the insets for status bar, navigation bar, and notch areas.\nValues are in pixels on Android and points on iOS.",
+        "docs": "Get the safe area insets.\nReturns the insets for status bar, navigation bar, and notch areas.\nValues are in CSS pixels (dp) on all platforms.",
         "complexTypes": [
           "SafeAreaInsets"
         ],

package/dist/esm/definitions.d.ts

@@ -90,7 +90,7 @@ export interface StatusBarPlugin {
     /**
      * Get the safe area insets.
      * Returns the insets for status bar, navigation bar, and notch areas.
-     * Values are in pixels on Android and points on iOS.
+     * Values are in CSS pixels (dp) on all platforms.
      */
     getSafeAreaInsets(): Promise<SafeAreaInsets>;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,KAIX;AAJD,WAAY,KAAK;IACf,wBAAe,CAAA;IACf,sBAAa,CAAA;IACb,0BAAiB,CAAA;AACnB,CAAC,EAJW,KAAK,KAAL,KAAK,QAIhB;AAWD,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,mCAAa,CAAA;IACb,qCAAe,CAAA;AACjB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B","sourcesContent":["export enum Style {\n  LIGHT = 'LIGHT',\n  DARK = 'DARK',\n  CUSTOM = 'CUSTOM',\n}\n\n/**\n * Full HEX color format only (6 or 8 digits).\n * - 6 digits: #RRGGBB (e.g., #FFFFFF, #000000, #FF5733)\n * - 8 digits: #RRGGBBAA with alpha channel (e.g., #FFFFFF00, #FF5733CC)\n *\n * Note: Short 3-digit format (#FFF) is NOT supported.\n */\nexport type StatusBarColor = `#${string}`;\n\nexport enum StatusBarAnimation {\n  NONE = 'none',\n  FADE = 'fade',\n  SLIDE = 'slide',\n}\n\ntype StatusBarStyleNoDefaultOptions = {\n  style: Style;\n};\n\ntype StatusBarStyleOptions =\n  | StatusBarStyleNoDefaultOptions\n  | {\n      style: Style.CUSTOM;\n      color: StatusBarColor;\n    };\n\nexport type StatusBarOptions = StatusBarStyleOptions;\n\nexport type StatusBarShowOptions = {\n  animated: boolean;\n};\n\nexport type StatusBarHideOptions = {\n  /**\n   * The animation type for hiding the status bar.\n   * - 'fade': Makes the background transparent without removing the status bar and navigation bar.\n   * - 'slide': Hides the status bar and navigation bar completely (default behavior).\n   */\n  animation: StatusBarAnimation;\n};\n\nexport type StatusBarSetOverlaysWebViewOptions = {\n  value: boolean;\n};\n\nexport type StatusBarSetBackgroundOptions = {\n  color: StatusBarColor;\n};\n\nexport type SafeAreaInsets = {\n  top: number;\n  bottom: number;\n  left: number;\n  right: number;\n};\n\nexport interface StatusBarPlugin {\n  /**\n   * Set the status bar and navigation bar style and color.\n   * @param options - The options to set the status bar style and color.\n   * @param options.style - The style of the status bar.\n   * @param options.color - The color of the status bar.\n   */\n  setStyle(options: StatusBarOptions): Promise<void>;\n  /**\n   * Show the status bar.\n   * @param options - The options to show the status bar.\n   * @param options.animated - Whether to animate the status bar.\n   */\n  show(options: StatusBarShowOptions): Promise<void>;\n  /**\n   * Hide the status bar.\n   * @param options - The options to hide the status bar.\n   * @param options.animation - The animation type: 'fade' makes background transparent, 'slide' hides bars completely.\n   */\n  hide(options: StatusBarHideOptions): Promise<void>;\n  /**\n   * Set whether the status bar overlays the web view.\n   *\n   * **iOS only** - On Android this is a no-op (resolves without error).\n   *\n   * - `true`: Web content extends behind the status bar (transparent background),\n   *   allowing content to be visible through the status bar area on scroll.\n   * - `false`: Restores the status bar background to the color set by `setStyle`\n   *   or falls back to the default style from Capacitor config.\n   *\n   * @param options - The options to set the status bar overlays web view.\n   * @param options.value - Whether the status bar overlays the web view (required).\n   */\n  setOverlaysWebView(options: StatusBarSetOverlaysWebViewOptions): Promise<void>;\n  /**\n   * Set the window background color.\n   * @param options - The options to set the window background color.\n   * @param options.color - The background color in HEX format.\n   */\n  setBackground(options: StatusBarSetBackgroundOptions): Promise<void>;\n  /**\n   * Get the safe area insets.\n   * Returns the insets for status bar, navigation bar, and notch areas.\n   * Values are in pixels on Android and points on iOS.\n   */\n  getSafeAreaInsets(): Promise<SafeAreaInsets>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,KAIX;AAJD,WAAY,KAAK;IACf,wBAAe,CAAA;IACf,sBAAa,CAAA;IACb,0BAAiB,CAAA;AACnB,CAAC,EAJW,KAAK,KAAL,KAAK,QAIhB;AAWD,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,mCAAa,CAAA;IACb,qCAAe,CAAA;AACjB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B","sourcesContent":["export enum Style {\n  LIGHT = 'LIGHT',\n  DARK = 'DARK',\n  CUSTOM = 'CUSTOM',\n}\n\n/**\n * Full HEX color format only (6 or 8 digits).\n * - 6 digits: #RRGGBB (e.g., #FFFFFF, #000000, #FF5733)\n * - 8 digits: #RRGGBBAA with alpha channel (e.g., #FFFFFF00, #FF5733CC)\n *\n * Note: Short 3-digit format (#FFF) is NOT supported.\n */\nexport type StatusBarColor = `#${string}`;\n\nexport enum StatusBarAnimation {\n  NONE = 'none',\n  FADE = 'fade',\n  SLIDE = 'slide',\n}\n\ntype StatusBarStyleNoDefaultOptions = {\n  style: Style;\n};\n\ntype StatusBarStyleOptions =\n  | StatusBarStyleNoDefaultOptions\n  | {\n      style: Style.CUSTOM;\n      color: StatusBarColor;\n    };\n\nexport type StatusBarOptions = StatusBarStyleOptions;\n\nexport type StatusBarShowOptions = {\n  animated: boolean;\n};\n\nexport type StatusBarHideOptions = {\n  /**\n   * The animation type for hiding the status bar.\n   * - 'fade': Makes the background transparent without removing the status bar and navigation bar.\n   * - 'slide': Hides the status bar and navigation bar completely (default behavior).\n   */\n  animation: StatusBarAnimation;\n};\n\nexport type StatusBarSetOverlaysWebViewOptions = {\n  value: boolean;\n};\n\nexport type StatusBarSetBackgroundOptions = {\n  color: StatusBarColor;\n};\n\nexport type SafeAreaInsets = {\n  top: number;\n  bottom: number;\n  left: number;\n  right: number;\n};\n\nexport interface StatusBarPlugin {\n  /**\n   * Set the status bar and navigation bar style and color.\n   * @param options - The options to set the status bar style and color.\n   * @param options.style - The style of the status bar.\n   * @param options.color - The color of the status bar.\n   */\n  setStyle(options: StatusBarOptions): Promise<void>;\n  /**\n   * Show the status bar.\n   * @param options - The options to show the status bar.\n   * @param options.animated - Whether to animate the status bar.\n   */\n  show(options: StatusBarShowOptions): Promise<void>;\n  /**\n   * Hide the status bar.\n   * @param options - The options to hide the status bar.\n   * @param options.animation - The animation type: 'fade' makes background transparent, 'slide' hides bars completely.\n   */\n  hide(options: StatusBarHideOptions): Promise<void>;\n  /**\n   * Set whether the status bar overlays the web view.\n   *\n   * **iOS only** - On Android this is a no-op (resolves without error).\n   *\n   * - `true`: Web content extends behind the status bar (transparent background),\n   *   allowing content to be visible through the status bar area on scroll.\n   * - `false`: Restores the status bar background to the color set by `setStyle`\n   *   or falls back to the default style from Capacitor config.\n   *\n   * @param options - The options to set the status bar overlays web view.\n   * @param options.value - Whether the status bar overlays the web view (required).\n   */\n  setOverlaysWebView(options: StatusBarSetOverlaysWebViewOptions): Promise<void>;\n  /**\n   * Set the window background color.\n   * @param options - The options to set the window background color.\n   * @param options.color - The background color in HEX format.\n   */\n  setBackground(options: StatusBarSetBackgroundOptions): Promise<void>;\n  /**\n   * Get the safe area insets.\n   * Returns the insets for status bar, navigation bar, and notch areas.\n   * Values are in CSS pixels (dp) on all platforms.\n   */\n  getSafeAreaInsets(): Promise<SafeAreaInsets>;\n}\n"]}

package/ios/Sources/StatusBarPlugin/StatusBar.swift

@@ -230,13 +230,19 @@ import Capacitor
 
             if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
                let window = windowScene.windows.first {
+                // Use statusBarManager for accurate status bar height
+                let statusBarHeight = windowScene.statusBarManager?.statusBarFrame.height ?? 0
                 let safeAreaInsets = window.safeAreaInsets
-                insets["top"] = safeAreaInsets.top
+
+                // top: status bar height specifically
+                insets["top"] = statusBarHeight
+                // bottom: home indicator / navigation bar area
                 insets["bottom"] = safeAreaInsets.bottom
+                // left/right: safe area for landscape / display cutouts
                 insets["left"] = safeAreaInsets.left
                 insets["right"] = safeAreaInsets.right
 
-                print("StatusBar: getSafeAreaInsets - top=\(safeAreaInsets.top), bottom=\(safeAreaInsets.bottom), left=\(safeAreaInsets.left), right=\(safeAreaInsets.right)")
+                print("StatusBar: getSafeAreaInsets - top=\(statusBarHeight), bottom=\(safeAreaInsets.bottom), left=\(safeAreaInsets.left), right=\(safeAreaInsets.right)")
             } else {
                 print("StatusBar: getSafeAreaInsets - Unable to get window, returning zero insets")
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-plugin-status-bar",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "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",