@capgo/capacitor-inappbrowser 8.10.2 → 8.10.3

package/ios/Sources/InAppBrowserPlugin/InAppBrowserPlugin.swift

@@ -115,6 +115,42 @@ enum ProxyResponseRoutingSupport {
     }
 }
 
+
+enum StatusBarBackgroundLayoutSupport {
+    enum Placement: Equatable {
+        case skip
+        case host(pinToNavigationBar: Bool)
+    }
+
+    /// Decide where/how to pin the status-bar chrome without painting a PassThroughView gap.
+    static func placement(
+        isPassThroughOverlay: Bool,
+        blankNavigationTab: Bool,
+        navigationBarInHostHierarchy: Bool
+    ) -> Placement {
+        if isPassThroughOverlay && blankNavigationTab {
+            // Custom-frame blank overlays must stay transparent in the y-offset gap.
+            return .skip
+        }
+
+        if blankNavigationTab || !navigationBarInHostHierarchy {
+            return .host(pinToNavigationBar: false)
+        }
+
+        return .host(pinToNavigationBar: true)
+    }
+
+    static func hostView(
+        navigationControllerView: UIView,
+        framedContentView: UIView?
+    ) -> UIView? {
+        if let passThrough = navigationControllerView as? PassThroughView {
+            return framedContentView ?? passThrough.framedContentView
+        }
+        return navigationControllerView
+    }
+}
+
 enum CustomWebViewFrameSupport {
     static func resolvedFrame(
         width: CGFloat?,
@@ -162,7 +198,7 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
         case aware = "AWARE"
         case fakeVisible = "FAKE_VISIBLE"
     }
-    private let pluginVersion: String = "8.10.2"
+    private let pluginVersion: String = "8.10.3"
     public let identifier = "CapgoInAppBrowserPlugin"
     public let jsName = "CapgoInAppBrowser"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -1583,14 +1619,10 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
                     // Apply status bar background color via the special view
                     webViewController.setupStatusBarBackground(color: color)
 
-                    // Apply background color to whole view to ensure no gaps
+                    // Color the webview controller only — never paint PassThroughView or the
+                    // y-offset gap would hide the host Capacitor app.
                     webViewController.view.backgroundColor = color
-                    self.navigationWebViewController?.view.backgroundColor = color
-
-                    // Apply status bar background color
-                    if let navController = self.navigationWebViewController {
-                        navController.view.backgroundColor = color
-                    }
+                    self.applyBlankToolbarBackground(color, to: self.navigationWebViewController)
                 } else {
                     // Follow system appearance if no specific color
                     let isDarkMode = UITraitCollection.current.userInterfaceStyle == .dark
@@ -1601,10 +1633,7 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
                     // Apply status bar background color via the special view
                     webViewController.setupStatusBarBackground(color: backgroundColor)
 
-                    // Set appropriate background color
-                    if let navController = self.navigationWebViewController {
-                        navController.view.backgroundColor = backgroundColor
-                    }
+                    self.applyBlankToolbarBackground(backgroundColor, to: self.navigationWebViewController)
                 }
 
             }
@@ -2052,6 +2081,20 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
         }
     }
 
+
+    /// Keep PassThroughView clear so custom y-offsets show the host app behind the gap.
+    private func applyBlankToolbarBackground(_ color: UIColor, to navigationController: UINavigationController?) {
+        guard let navigationController else { return }
+
+        if let passThrough = navigationController.view as? PassThroughView {
+            passThrough.backgroundColor = .clear
+            passThrough.framedContentView?.backgroundColor = color
+            return
+        }
+
+        navigationController.view.backgroundColor = color
+    }
+
     private func normalizedAuthorizedHosts(from links: [String]) -> [String] {
         links.compactMap { link in
             guard let host = URLComponents(string: link)?.host?.lowercased() else {

package/ios/Sources/InAppBrowserPlugin/WKWebViewController.swift

@@ -1101,7 +1101,7 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
     open var statusBarStyle: UIStatusBarStyle = .default
 
     // Status bar background view
-    private var statusBarBackgroundView: UIView?
+    var statusBarBackgroundView: UIView?
 
     // Status bar height
     private var statusBarHeight: CGFloat {
@@ -1151,25 +1151,60 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
     // Make status bar background with colored view underneath
     open func setupStatusBarBackground(color: UIColor) {
         statusBarBackgroundView?.removeFromSuperview()
-        statusBarBackgroundView = UIView()
+        statusBarBackgroundView = nil
 
-        guard let navController = navigationController,
-              let navView = navController.view,
-              let statusBarBackgroundView else {
+        guard let navController = navigationController else {
             return
         }
-        navView.insertSubview(statusBarBackgroundView, at: 0)
-        statusBarBackgroundView.translatesAutoresizingMaskIntoConstraints = false
-        statusBarBackgroundView.backgroundColor = color
 
-        NSLayoutConstraint.activate([
-            statusBarBackgroundView.topAnchor.constraint(equalTo: navView.topAnchor),
-            statusBarBackgroundView.leadingAnchor.constraint(equalTo: navView.leadingAnchor),
-            statusBarBackgroundView.trailingAnchor.constraint(equalTo: navView.trailingAnchor),
-            statusBarBackgroundView.bottomAnchor.constraint(equalTo: navController.navigationBar.bottomAnchor, constant: 1)
-        ])
+        if let passThrough = navController.view as? PassThroughView {
+            // Never paint the full-screen overlay — that fills the custom y-offset gap.
+            passThrough.backgroundColor = .clear
+        }
+
+        let navigationBar = navController.navigationBar
+        let hostCandidate = StatusBarBackgroundLayoutSupport.hostView(
+            navigationControllerView: navController.view,
+            framedContentView: (navController.view as? PassThroughView)?.framedContentView
+        )
+        let navigationBarInHost = hostCandidate.map { navigationBar.isDescendant(of: $0) } ?? false
+        let placement = StatusBarBackgroundLayoutSupport.placement(
+            isPassThroughOverlay: navController.view is PassThroughView,
+            blankNavigationTab: blankNavigationTab,
+            navigationBarInHostHierarchy: navigationBarInHost
+        )
+
+        guard case .host(let pinToNavigationBar) = placement,
+              let hostView = hostCandidate else {
+            return
+        }
+
+        let backgroundView = UIView()
+        statusBarBackgroundView = backgroundView
+        hostView.insertSubview(backgroundView, at: 0)
+        backgroundView.translatesAutoresizingMaskIntoConstraints = false
+        backgroundView.backgroundColor = color
+
+        var constraints = [
+            backgroundView.topAnchor.constraint(equalTo: hostView.topAnchor),
+            backgroundView.leadingAnchor.constraint(equalTo: hostView.leadingAnchor),
+            backgroundView.trailingAnchor.constraint(equalTo: hostView.trailingAnchor)
+        ]
+
+        if pinToNavigationBar {
+            constraints.append(
+                backgroundView.bottomAnchor.constraint(equalTo: navigationBar.bottomAnchor, constant: 1)
+            )
+            applyNavigationBarBackground(color: color)
+        } else {
+            // Blank toolbar / detached nav bar: cover status-bar height only.
+            // Avoid pinning to a hidden UINavigationBar (removed from hierarchy → crash).
+            constraints.append(
+                backgroundView.heightAnchor.constraint(equalToConstant: max(statusBarHeight, 20))
+            )
+        }
 
-        applyNavigationBarBackground(color: color)
+        NSLayoutConstraint.activate(constraints)
     }
 
     // Override to use our custom status bar style

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-inappbrowser",
-  "version": "8.10.2",
+  "version": "8.10.3",
   "description": "Capacitor plugin in app browser",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",