@capgo/capacitor-inappbrowser 8.12.1 → 8.12.2-beta.pr634.541.1

package/README.md

@@ -1540,7 +1540,7 @@ And in the AndroidManifest.xml file:
 | **`titleIcon`**                        | <code><a href="#toolbartitleiconoptions">ToolbarTitleIconOptions</a></code>                                                                                            | Native toolbar title icon displayed before the title text. For Android: - iconType can be "asset" for a bundled SVG asset or "vector" for a drawable resource - icon path should be in the public folder for assets (e.g. "brand.svg") - width and height are optional and default to 24dp For iOS: - iconType can be "sf-symbol" or "asset" - for sf-symbol, icon should be the symbol name - for asset, icon should be the asset name or bundled web asset path                                                                                                                                                                                                                                                                                                                                                                        |                                                               | 8.7.7  |
 | **`backgroundColor`**                  | <code><a href="#backgroundcolor">BackgroundColor</a></code>                                                                                                            | Background color of the browser                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <code>BackgroundColor.BLACK</code>                            | 0.1.0  |
 | **`activeNativeNavigationForWebview`** | <code>boolean</code>                                                                                                                                                   | If true, enables native navigation gestures within the webview. - Android: Native back button navigates within webview history - iOS: Enables swipe left/right gestures for back/forward navigation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>false (Android), true (iOS - enabled by default)</code> |        |
-| **`enableReloadGesture`**              | <code>boolean</code>                                                                                                                                                   | Enable pull-to-refresh (overscroll from top) to reload the current page. - iOS: Uses UIRefreshControl on the WebView scroll view - Android: Uses SwipeRefreshLayout around the WebView On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`, the reload gesture will not work.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>false</code>                                            | 8.10.8 |
+| **`enableReloadGesture`**              | <code>boolean</code>                                                                                                                                                   | Enable pull-to-refresh (overscroll from top) to reload the current page. - iOS: Uses UIRefreshControl on the WebView scroll view (reload commits on finger release) - Android: Uses SwipeRefreshLayout around the WebView On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`, the reload gesture will not work.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <code>false</code>                                            | 8.10.8 |
 | **`disableGoBackOnNativeApplication`** | <code>boolean</code>                                                                                                                                                   | Disable the possibility to go back on native application, useful to force user to stay on the webview, Android only                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>false</code>                                            |        |
 | **`isPresentAfterPageLoad`**           | <code>boolean</code>                                                                                                                                                   | Open url in a new window fullscreen isPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately. Promise timing: on Android, `openWebView()` resolves with the webview id when the webview is ready to be controlled (immediately for hidden/immediate presentation, after the first page load when `isPresentAfterPageLoad` is `true`). On iOS, the promise resolves with the id as soon as the native webview is created, even if presentation is deferred.                                                                                                                                                                                                                                                                                           | <code>false</code>                                            | 0.1.0  |
 | **`isInspectable`**                    | <code>boolean</code>                                                                                                                                                   | Whether the website in the webview is inspectable or not, ios only                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <code>false</code>                                            |        |
@@ -1577,10 +1577,10 @@ And in the AndroidManifest.xml file:
 | **`enableGooglePaySupport`**           | <code>boolean</code>                                                                                                                                                   | enableGooglePaySupport: if true, enables support for Google Pay popups and Payment Request API. This fixes OR_BIBED_15 errors by allowing popup windows and configuring Cross-Origin-Opener-Policy. Only enable this if you need Google Pay functionality as it allows popup windows. When enabled: - Allows popup windows for Google Pay authentication - Sets proper CORS headers for Payment Request API - Enables multiple window support in WebView - Configures secure context for payment processing                                                                                                                                                                                                                                                                                                                              | <code>false</code>                                            | 7.13.0 |
 | **`hiddenPopupWindow`**                | <code>boolean</code>                                                                                                                                                   | Opens popup windows created by the page in hidden mode. Hidden popup windows can still be controlled with `executeScript`, `postMessage`, `show`, and `close`. Listen to `popupWindowOpened` to capture the popup id, then call `show({ id })` only if you want to reveal it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <code>false</code>                                            | 8.6.0  |
 | **`blockedHosts`**                     | <code>string[]</code>                                                                                                                                                  | blockedHosts: List of host patterns that should be blocked from loading in the InAppBrowser's internal navigations. Any request inside WebView to a URL with a host matching any of these patterns will be blocked. Supports wildcard patterns like: - "*.example.com" to block all subdomains - "www.example.*" to block wildcard domain extensions                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | <code>[]</code>                                               | 7.17.0 |
-| **`width`**                            | <code>number</code>                                                                                                                                                    | Width of the webview in pixels. If not set, webview will be fullscreen width.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <code>undefined (fullscreen)</code>                           |        |
-| **`height`**                           | <code>number</code>                                                                                                                                                    | Height of the webview in pixels. If not set, webview will be fullscreen height.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <code>undefined (fullscreen)</code>                           |        |
-| **`x`**                                | <code>number</code>                                                                                                                                                    | X position of the webview in pixels from the left edge. Only effective when width is set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <code>0</code>                                                |        |
-| **`y`**                                | <code>number</code>                                                                                                                                                    | Y position of the webview in pixels from the top edge. Only effective when height is set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | <code>0</code>                                                |        |
+| **`width`**                            | <code>number</code>                                                                                                                                                    | Width of the webview in screen/window points. If not set, webview will be fullscreen width.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | <code>undefined (fullscreen)</code>                           |        |
+| **`height`**                           | <code>number</code>                                                                                                                                                    | Height of the webview in screen/window points. Required for custom-sized (non-fullscreen) webviews.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | <code>undefined (fullscreen)</code>                           |        |
+| **`x`**                                | <code>number</code>                                                                                                                                                    | X position of the webview in screen/window points from the left edge. Only effective when custom height is set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | <code>0</code>                                                |        |
+| **`y`**                                | <code>number</code>                                                                                                                                                    | Y position of the webview in screen/window points from the top edge. Only effective when custom height is set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | <code>0</code>                                                |        |
 | **`toBack`**                           | <code>boolean</code>                                                                                                                                                   | Places the native browser behind the Capacitor host WebView. Make the app background transparent to reveal it, or rely on `transparentBackground` to clear the host WebView.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <code>false</code>                                            |        |
 | **`transparentBackground`**            | <code>boolean</code>                                                                                                                                                   | When `toBack` is true, makes the Capacitor host WebView transparent so the native browser can be seen behind Ionic content. Ignored when the browser is in front.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | <code>true</code>                                             |        |
 | **`disableOverscroll`**                | <code>boolean</code>                                                                                                                                                   | Disables the bounce (overscroll) effect on iOS WebView. When enabled, prevents the rubber band scrolling effect when users scroll beyond content boundaries. This is useful for: - Creating a more native, app-like experience - Preventing accidental overscroll states - Avoiding issues when keyboard opens/closes Note: This option only affects iOS. Android does not have this bounce effect by default.                                                                                                                                                                                                                                                                                                                                                                                                                           | <code>false</code>                                            | 8.0.2  |

package/android/src/main/java/ee/forgr/capacitor_inappbrowser/WebViewDialog.java

@@ -330,6 +330,7 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
     }
 
     private SwipeRefreshLayout swipeRefreshLayout;
+    private boolean reloadFromGestureInProgress = false;
     private WebView _webView;
     private Toolbar _toolbar;
     private Options _options = null;
@@ -2177,7 +2178,10 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
         if (this.swipeRefreshLayout != null) {
             boolean enableReloadGesture = _options != null && _options.getEnableReloadGesture();
             this.swipeRefreshLayout.setEnabled(enableReloadGesture);
-            this.swipeRefreshLayout.setOnRefreshListener(() -> reload());
+            this.swipeRefreshLayout.setOnRefreshListener(() -> {
+                reloadFromGestureInProgress = true;
+                reload();
+            });
             this.swipeRefreshLayout.setOnChildScrollUpCallback((parent, child) -> _webView != null && _webView.canScrollVertically(-1));
         }
 
@@ -3844,9 +3848,30 @@ public class WebViewDialog extends Dialog implements ProxyResponseRouting.ProxyR
     }
 
     private void stopReloadGesture() {
+        boolean shouldResetScroll = reloadFromGestureInProgress;
+        reloadFromGestureInProgress = false;
+
         if (swipeRefreshLayout != null && swipeRefreshLayout.isRefreshing()) {
             swipeRefreshLayout.setRefreshing(false);
         }
+
+        // Only reset scroll after a gesture reload. Ordinary page loads / intercepted navigations
+        // also call stopReloadGesture and must not jump the WebView to the top.
+        if (!shouldResetScroll || _webView == null) {
+            return;
+        }
+
+        // Sticky scrollY after reload makes canScrollVertically(-1) true, which blocks the next pull
+        // via setOnChildScrollUpCallback until a full document navigation resets scroll state.
+        final WebView webView = _webView;
+        webView.post(() -> {
+            if (_webView != webView) {
+                return;
+            }
+            if (webView.getScrollY() != 0) {
+                webView.scrollTo(webView.getScrollX(), 0);
+            }
+        });
     }
 
     public void destroy() {

package/dist/docs.json

@@ -1772,7 +1772,7 @@
               "name": "example"
             }
           ],
-          "docs": "Enable pull-to-refresh (overscroll from top) to reload the current page.\n- iOS: Uses UIRefreshControl on the WebView scroll view\n- Android: Uses SwipeRefreshLayout around the WebView\n\nOn iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,\nthe reload gesture will not work.",
+          "docs": "Enable pull-to-refresh (overscroll from top) to reload the current page.\n- iOS: Uses UIRefreshControl on the WebView scroll view (reload commits on finger release)\n- Android: Uses SwipeRefreshLayout around the WebView\n\nOn iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,\nthe reload gesture will not work.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
@@ -2422,7 +2422,7 @@
               "name": "example"
             }
           ],
-          "docs": "Width of the webview in pixels.\nIf not set, webview will be fullscreen width.",
+          "docs": "Width of the webview in screen/window points.\nIf not set, webview will be fullscreen width.",
           "complexTypes": [],
           "type": "number | undefined"
         },
@@ -2438,7 +2438,7 @@
               "name": "example"
             }
           ],
-          "docs": "Height of the webview in pixels.\nIf not set, webview will be fullscreen height.",
+          "docs": "Height of the webview in screen/window points.\nRequired for custom-sized (non-fullscreen) webviews.",
           "complexTypes": [],
           "type": "number | undefined"
         },
@@ -2454,7 +2454,7 @@
               "name": "example"
             }
           ],
-          "docs": "X position of the webview in pixels from the left edge.\nOnly effective when width is set.",
+          "docs": "X position of the webview in screen/window points from the left edge.\nOnly effective when custom height is set.",
           "complexTypes": [],
           "type": "number | undefined"
         },
@@ -2470,7 +2470,7 @@
               "name": "example"
             }
           ],
-          "docs": "Y position of the webview in pixels from the top edge.\nOnly effective when height is set.",
+          "docs": "Y position of the webview in screen/window points from the top edge.\nOnly effective when custom height is set.",
           "complexTypes": [],
           "type": "number | undefined"
         },

package/dist/esm/definitions.d.ts

@@ -837,7 +837,7 @@ export interface OpenWebViewOptions {
     activeNativeNavigationForWebview?: boolean;
     /**
      * Enable pull-to-refresh (overscroll from top) to reload the current page.
-     * - iOS: Uses UIRefreshControl on the WebView scroll view
+     * - iOS: Uses UIRefreshControl on the WebView scroll view (reload commits on finger release)
      * - Android: Uses SwipeRefreshLayout around the WebView
      *
      * On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,
@@ -1235,7 +1235,7 @@ export interface OpenWebViewOptions {
      */
     blockedHosts?: string[];
     /**
-     * Width of the webview in pixels.
+     * Width of the webview in screen/window points.
      * If not set, webview will be fullscreen width.
      * @default undefined (fullscreen)
      * @example
@@ -1243,24 +1243,24 @@ export interface OpenWebViewOptions {
      */
     width?: number;
     /**
-     * Height of the webview in pixels.
-     * If not set, webview will be fullscreen height.
+     * Height of the webview in screen/window points.
+     * Required for custom-sized (non-fullscreen) webviews.
      * @default undefined (fullscreen)
      * @example
      * height: 600
      */
     height?: number;
     /**
-     * X position of the webview in pixels from the left edge.
-     * Only effective when width is set.
+     * X position of the webview in screen/window points from the left edge.
+     * Only effective when custom height is set.
      * @default 0
      * @example
      * x: 50
      */
     x?: number;
     /**
-     * Y position of the webview in pixels from the top edge.
-     * Only effective when height is set.
+     * Y position of the webview in screen/window points from the top edge.
+     * Only effective when custom height is set.
      * @default 0
      * @example
      * y: 100

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAmEA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AACD,MAAM,CAAN,IAAY,WAqBX;AArBD,WAAY,WAAW;IACrB;;;OAGG;IACH,oCAAqB,CAAA;IACrB;;;OAGG;IACH,kCAAmB,CAAA;IACnB;;;OAGG;IACH,wCAAyB,CAAA;IACzB;;;OAGG;IACH,8BAAe,CAAA;AACjB,CAAC,EArBW,WAAW,KAAX,WAAW,QAqBtB;AAED,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,mCAAe,CAAA;IACf;;OAEG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B;AAED,MAAM,CAAN,IAAY,WASX;AATD,WAAY,WAAW;IACrB;;OAEG;IACH,8BAAe,CAAA;IACf;;OAEG;IACH,4BAAa,CAAA;AACf,CAAC,EATW,WAAW,KAAX,WAAW,QAStB","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface UrlEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when the url changes\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\n/**\n * Event emitted when the managed webview intercepts a non-standard custom scheme\n * and hands it to the operating system.\n *\n * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n *\n * @since 8.6.7\n */\nexport interface CustomSchemeInterceptedEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Intercepted URL.\n   */\n  url: string;\n  /**\n   * Whether the operating system accepted the URL handoff.\n   */\n  opened: boolean;\n}\nexport interface BtnEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when a button is clicked.\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\nexport interface ButtonNearDoneEvent {\n  /**\n   * Webview instance id.\n   *\n   * @since 8.6.36\n   */\n  id: string;\n}\n\nexport type UrlChangeListener = (state: UrlEvent) => void;\nexport type ConfirmBtnListener = (state: BtnEvent) => void;\nexport type ButtonNearListener = (state: ButtonNearDoneEvent) => void;\nexport type CustomSchemeInterceptedListener = (state: CustomSchemeInterceptedEvent) => void;\n\nexport type WebViewPointerInputEventType = 'click' | 'touchstart' | 'touchmove' | 'touchend' | 'touchcancel';\nexport type WebViewInputEventType = WebViewPointerInputEventType | 'scroll';\n\nexport enum BackgroundColor {\n  WHITE = 'white',\n  BLACK = 'black',\n}\nexport enum ToolBarType {\n  /**\n   * Shows a simple toolbar with just a close button and share button\n   * @since 0.1.0\n   */\n  ACTIVITY = 'activity',\n  /**\n   * Shows a simple toolbar with just a close button\n   * @since 7.6.8\n   */\n  COMPACT = 'compact',\n  /**\n   * Shows a full navigation toolbar with back/forward buttons\n   * @since 0.1.0\n   */\n  NAVIGATION = 'navigation',\n  /**\n   * Shows no toolbar\n   * @since 0.1.0\n   */\n  BLANK = 'blank',\n}\n\nexport enum InvisibilityMode {\n  /**\n   * WebView is aware it is hidden (dimensions may be zero).\n   */\n  AWARE = 'AWARE',\n  /**\n   * WebView is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   */\n  FAKE_VISIBLE = 'FAKE_VISIBLE',\n}\n\nexport enum CloseAction {\n  /**\n   * The toolbar close button closes and destroys the webview.\n   */\n  CLOSE = 'close',\n  /**\n   * The toolbar close button hides the webview so it can be shown again.\n   */\n  HIDE = 'hide',\n}\n\nexport interface ToolbarTitleIconOptions {\n  ios?: {\n    iconType: 'sf-symbol' | 'asset';\n    icon: string;\n  };\n  android?: {\n    iconType: 'asset' | 'vector';\n    icon: string;\n    width?: number;\n    height?: number;\n  };\n}\n\nexport interface Headers {\n  [key: string]: string;\n}\n\nexport interface GetCookieOptions {\n  url: string;\n  includeHttpOnly?: boolean;\n}\n\nexport interface ClearCookieOptions {\n  /**\n   * Target webview id.\n   * When omitted, applies to all open webviews.\n   */\n  id?: string;\n  url: string;\n}\n\nexport interface Credentials {\n  username: string;\n  password: string;\n}\n\nexport interface LayerOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Makes the Capacitor host WebView transparent while this native webview is behind it.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n}\n\nexport interface BringToFrontOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Whether bringing the webview to the front is animated on iOS.\n   *\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface DispatchPointerInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: WebViewPointerInputEventType;\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n}\n\nexport interface DispatchScrollInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: 'scroll';\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n  /**\n   * Horizontal scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaX: number;\n  /**\n   * Vertical scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaY: number;\n}\n\nexport type DispatchInputEventOptions = DispatchPointerInputEventOptions | DispatchScrollInputEventOptions;\n\n/**\n * Represents an intercepted HTTP request from the in-app browser webview.\n *\n * Request and response bodies are base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequest {\n  requestId: string;\n  phase: 'outbound' | 'inbound';\n  url: string;\n  method: string;\n  headers: Record<string, string>;\n  body: string | null;\n  status?: number;\n  responseHeaders?: Record<string, string>;\n  responseBody?: string | null;\n  webviewId: string;\n}\n\n/**\n * Response payload returned to native for a proxied request.\n *\n * The body must be base64-encoded.\n *\n * @since 8.6.0\n */\nexport interface ProxyResponse {\n  body: string;\n  status: number;\n  headers: Record<string, string>;\n}\n\n/**\n * Request override returned to native for an outbound proxied request.\n *\n * The body must be base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequestOverride {\n  url: string;\n  method?: string;\n  headers?: Record<string, string>;\n  body?: string | null;\n}\n\n/**\n * Event emitted when a web page opens a popup/new window.\n *\n * @since 8.6.0\n */\nexport interface PopupWindowEvent {\n  /**\n   * Popup webview instance id.\n   */\n  id: string;\n  /**\n   * Parent webview instance id.\n   */\n  parentId?: string;\n  /**\n   * Requested popup URL when available.\n   */\n  url?: string;\n  /**\n   * Whether the popup was presented immediately.\n   */\n  visible: boolean;\n}\n\n/**\n * Event emitted when JavaScript running inside the managed webview writes to the console.\n *\n * Enable this with `captureConsoleLogs: true` when opening the webview.\n *\n * @since 8.6.0\n */\nexport interface ConsoleMessageEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Console method or normalized severity.\n   */\n  level: 'log' | 'info' | 'warn' | 'error' | 'debug' | 'assert' | string;\n  /**\n   * Joined string representation of the console arguments.\n   */\n  message: string;\n  /**\n   * Script URL or page URL when available.\n   */\n  source?: string;\n  /**\n   * 1-based line number when available.\n   */\n  line?: number;\n  /**\n   * 1-based column number when available.\n   */\n  column?: number;\n  /**\n   * Optional subtype for runtime-originated errors on supported platforms.\n   */\n  kind?: string;\n}\n\n/**\n * Native handling mode used after a managed download finishes.\n *\n * @since 8.6.0\n */\nexport type DownloadHandledBy = 'inAppBrowser' | 'systemPreview' | 'external';\n\n/**\n * Event emitted after a managed download is saved locally.\n *\n * @since 8.6.0\n */\nexport interface DownloadCompletedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Saved filename.\n   */\n  fileName: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Absolute native filesystem path to the saved file.\n   */\n  path: string;\n  /**\n   * `file://` URL pointing at the saved file.\n   */\n  localUrl: string;\n  /**\n   * How native handled the downloaded file after saving it.\n   */\n  handledBy: DownloadHandledBy;\n}\n\n/**\n * Event emitted when managed download handling fails.\n *\n * @since 8.6.0\n */\nexport interface DownloadFailedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Intended filename when known.\n   */\n  fileName?: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Native error message.\n   */\n  error: string;\n}\n\n/**\n * Decision returned to native when handling a proxied request.\n *\n * @since 8.6.0\n */\nexport interface ProxyDecision {\n  request?: ProxyRequestOverride | null;\n  response?: ProxyResponse | null;\n  cancel?: boolean;\n}\n\n/**\n * Native-first proxy rule used on Android and iOS.\n *\n * Any regex property that is omitted is treated as a wildcard.\n *\n * @since 8.6.0\n */\nexport interface NativeProxyRule {\n  id?: string;\n  urlRegex?: string;\n  methodRegex?: string;\n  headerRegex?: string;\n  bodyRegex?: string;\n  statusRegex?: string;\n  responseHeaderRegex?: string;\n  responseBodyRegex?: string;\n  mainFrameOnly?: boolean;\n  action: 'continue' | 'cancel' | 'delegateToJs';\n}\n\nexport type ProxyHandlerResult = Response | ProxyResponse | ProxyRequestOverride | ProxyDecision | null;\n\n/**\n * JavaScript callback used to handle proxied requests.\n *\n * Return a `Response`, `ProxyResponse`, `ProxyRequestOverride`, `ProxyDecision`,\n * or `null` to let native continue unchanged.\n *\n * @since 8.6.0\n */\nexport type ProxyHandler = (request: ProxyRequest) => ProxyHandlerResult | Promise<ProxyHandlerResult>;\n\nexport interface OpenOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   */\n  url: string;\n  /**\n   * if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * @since 0.1.0\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * if true the deeplink will not be opened, if false the deeplink will be opened when clicked on the link\n   * @since 0.1.0\n   */\n  preventDeeplink?: boolean;\n\n  // --- Chrome Custom Tab customization (Android only, ignored on iOS) ---\n\n  /**\n   * Toolbar background color in hex format (e.g., \"#1A1A2E\").\n   * Applied to both light and dark color schemes.\n   * Also sets the navigation bar color to match.\n   * **Android only** — ignored on iOS.\n   * @since 8.2.0\n   */\n  toolbarColor?: string;\n\n  /**\n   * Whether the URL bar should auto-hide when the user scrolls down.\n   * The bar reappears on any upward scroll.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  urlBarHidingEnabled?: boolean;\n\n  /**\n   * Show the page's HTML <title> in the toolbar instead of the raw URL.\n   * The true URL is still visible when the user taps the title area.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showTitle?: boolean;\n\n  /**\n   * Replace the default \"X\" close icon with a back arrow.\n   * Makes the Custom Tab feel like a native navigation push rather than a modal overlay.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showArrow?: boolean;\n\n  /**\n   * Remove the share action from the overflow menu.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableShare?: boolean;\n\n  /**\n   * Hide the bookmark star icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableBookmark?: boolean;\n\n  /**\n   * Hide the download icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableDownload?: boolean;\n}\n\nexport interface OpenSecureWindowOptions {\n  /**\n   * The endpoint to open\n   */\n  authEndpoint: string;\n  /**\n   * The redirect URI to use for the openSecureWindow call.\n   * This will be checked to make sure it matches the redirect URI after the window finishes the redirection.\n   */\n  redirectUri: string;\n  /**\n   * The name of the broadcast channel to listen to, relevant only for web\n   */\n  broadcastChannelName?: string;\n  /**\n   * If true, the browser session will be ephemeral (no cookies or browsing data are shared with the system browser).\n   * On iOS, this sets `prefersEphemeralWebBrowserSession = true` on `ASWebAuthenticationSession`.\n   * On Android, this enables Custom Tabs ephemeral browsing via `setEphemeralBrowsingEnabled(true)`.\n   * @default false\n   * @since 6.6.0\n   */\n  prefersEphemeralWebBrowserSession?: boolean;\n}\n\nexport interface OpenSecureWindowResponse {\n  /**\n   * The result of the openSecureWindow call\n   */\n  redirectedUri: string;\n}\n\nexport interface DisclaimerOptions {\n  /**\n   * Title of the disclaimer dialog\n   * @default \"Title\"\n   */\n  title: string;\n  /**\n   * Message shown in the disclaimer dialog\n   * @default \"Message\"\n   */\n  message: string;\n  /**\n   * Text for the confirm button\n   * @default \"Confirm\"\n   */\n  confirmBtn: string;\n  /**\n   * Text for the cancel button\n   * @default \"Cancel\"\n   */\n  cancelBtn: string;\n}\n\nexport interface ScreenshotResult {\n  /**\n   * Image format used for the screenshot.\n   */\n  format: 'png';\n  /**\n   * MIME type of the generated screenshot.\n   */\n  mimeType: 'image/png';\n  /**\n   * Base64-encoded screenshot payload without the data URL prefix.\n   */\n  base64: string;\n  /**\n   * Data URL for direct use in HTML img tags or uploads.\n   */\n  dataUrl: string;\n  /**\n   * Screenshot width in pixels.\n   */\n  width: number;\n  /**\n   * Screenshot height in pixels.\n   */\n  height: number;\n}\n\nexport interface HideEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * URL active when the webview was hidden.\n   */\n  url: string;\n  /**\n   * Screenshot captured immediately before the toolbar close button hides the webview.\n   * Present only when `screenshotOnHide` is enabled and capture succeeds.\n   */\n  screenshot?: ScreenshotResult;\n}\n\nexport type HideListener = (state: HideEvent) => void;\n\nexport interface CloseWebviewOptions {\n  /**\n   * Target webview id to close. If omitted, closes the active webview.\n   */\n  id?: string;\n  /**\n   * Whether the webview closing is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface OpenWebViewOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   * @example \"https://capgo.app\"\n   */\n  url: string;\n  /**\n   * Headers to send with the request.\n   * @since 0.1.0\n   * @example\n   * headers: {\n   *   \"Custom-Header\": \"test-value\",\n   *   \"Authorization\": \"Bearer test-token\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  headers?: Headers;\n  /**\n   * Credentials to send with the request and all subsequent requests for the same host.\n   * @since 6.1.0\n   * @example\n   * credentials: {\n   *   username: \"test-user\",\n   *   password: \"test-pass\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  credentials?: Credentials;\n  /**\n   * HTTP method to use for the initial request.\n   *\n   * **Optional parameter - defaults to GET if not specified.**\n   * Existing code that doesn't provide this parameter will continue to work unchanged with standard GET requests.\n   *\n   * When specified with 'POST', 'PUT', or 'PATCH' methods that support a body,\n   * you can also provide a `body` parameter with the request payload.\n   *\n   * **Platform Notes:**\n   * - iOS: Full support for all HTTP methods with headers\n   * - Android: Custom headers may not be sent with POST/PUT/PATCH requests due to WebView limitations\n   *\n   * @since 8.2.0\n   * @default \"GET\"\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ token: \"auth-token\", data: \"value\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | string;\n  /**\n   * HTTP body to send with the request when using POST, PUT, or other methods that support a body.\n   * Should be a string (use JSON.stringify for JSON data).\n   *\n   * **Optional parameter - only used when `method` is specified and supports a request body.**\n   * Omitting this parameter (or using GET method) results in standard behavior without a request body.\n   *\n   * @since 8.2.0\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ username: \"user\", password: \"pass\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  body?: string;\n  /**\n   * materialPicker: if true, uses Material Design theme for date and time pickers on Android.\n   * This improves the appearance of HTML date inputs to use modern Material Design UI instead of the old style pickers.\n   * @since 7.4.1\n   * @default false\n   * @example\n   * materialPicker: true\n   * Test URL: https://show-picker.glitch.me/demo.html\n   */\n  materialPicker?: boolean;\n  /**\n   * JavaScript Interface:\n   * The webview automatically injects a JavaScript interface providing:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage(obj)`: Sends a message to the app (listen via \"messageFromWebview\" event)\n   * - `window.mobileApp.hide()` / `window.mobileApp.show()` when allowWebViewJsVisibilityControl is true in CapacitorConfig\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * @example\n   * // In your webpage loaded in the webview:\n   * document.getElementById(\"closeBtn\").addEventListener(\"click\", () => {\n   *   window.mobileApp.close();\n   * });\n   *\n   * // Send data to the app\n   * window.mobileApp.postMessage({ action: \"login\", data: { user: \"test\" }});\n   *\n   * @since 6.10.0\n   */\n  jsInterface?: never; // This property doesn't exist, it's just for documentation\n  /**\n   * Allows page JavaScript to call `window.mobileApp.takeScreenshot()`.\n   * Disabled by default so only the host app can trigger native screenshots through the plugin API.\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  allowScreenshotsFromWebPage?: boolean;\n  /**\n   * Emits `consoleMessage` events for JavaScript `console.*` output coming from the managed page.\n   * Useful when the webview stays hidden and you still need page-level diagnostics.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  captureConsoleLogs?: boolean;\n  /**\n   * Controls whether the webview should persist website data such as cache, cookies, local storage,\n   * IndexedDB, and session data.\n   *\n   * When false, iOS uses a non-persistent `WKWebsiteDataStore`. Android disables per-view cache and\n   * DOM/database storage where the system WebView supports it. Android cookies use the shared\n   * WebView cookie store, so call `clearAllBrowsingData()` to remove cookies and other global data.\n   *\n   * @default true\n   * @since 8.6.36\n   */\n  persistWebViewData?: boolean;\n  /**\n   * Controls Android TLS client certificate prompts during HTTPS handshakes.\n   * Use `prompt` to show the system certificate picker; omit or use `none` to cancel silently (default).\n   *\n   * @default \"none\"\n   * @since 8.7.5\n   */\n  clientCertificate?: 'none' | 'prompt';\n  /**\n   * @deprecated Use `clientCertificate: \"prompt\"` instead.\n   */\n  clientCertificatePrompt?: boolean;\n  /**\n   * Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge.\n   *\n   * When enabled:\n   * - Standard attachment responses are written to a temporary file.\n   * - `blob:` downloads are also captured when the platform supports them.\n   * - Previewable files reopen inside the in-app browser when possible.\n   * - Other files are handed off to the native preview or viewer flow.\n   * - `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  handleDownloads?: boolean;\n  /**\n   * Share options for the webview. When provided, shows a disclaimer dialog before sharing content.\n   * This is useful for:\n   * - Warning users about sharing sensitive information\n   * - Getting user consent before sharing\n   * - Explaining what will be shared\n   * - Complying with privacy regulations\n   *\n   * Note: shareSubject is required when using shareDisclaimer\n   * @since 0.1.0\n   * @example\n   * shareDisclaimer: {\n   *   title: \"Disclaimer\",\n   *   message: \"This is a test disclaimer\",\n   *   confirmBtn: \"Accept\",\n   *   cancelBtn: \"Decline\"\n   * }\n   * Test URL: https://capgo.app\n   */\n  shareDisclaimer?: DisclaimerOptions;\n  /**\n   * Toolbar type determines the appearance and behavior of the browser's toolbar\n   * - \"activity\": Shows a simple toolbar with just a close button and share button\n   * - \"navigation\": Shows a full navigation toolbar with back/forward buttons\n   * - \"blank\": Shows no toolbar\n   * - \"\": Default toolbar with close button\n   * @since 0.1.0\n   * @default ToolBarType.DEFAULT\n   * @example\n   * toolbarType: ToolBarType.ACTIVITY,\n   * title: \"Activity Toolbar Test\"\n   * Test URL: https://capgo.app\n   */\n  toolbarType?: ToolBarType;\n  /**\n   * Subject text for sharing. Required when using shareDisclaimer.\n   * This text will be used as the subject line when sharing content.\n   * @since 0.1.0\n   * @example \"Share this page\"\n   */\n  shareSubject?: string;\n  /**\n   * Title of the browser\n   * @since 0.1.0\n   * @default \"New Window\"\n   * @example \"Camera Test\"\n   */\n  title?: string;\n  /**\n   * Native toolbar title font family.\n   * On iOS, use the registered font family name. On Android, the plugin first tries a res/font resource name,\n   * then falls back to a system font family name.\n   *\n   * @since 8.7.7\n   * @example \"Inter\"\n   */\n  titleFontFamily?: string;\n  /**\n   * Native toolbar title icon displayed before the title text.\n   *\n   * For Android:\n   * - iconType can be \"asset\" for a bundled SVG asset or \"vector\" for a drawable resource\n   * - icon path should be in the public folder for assets (e.g. \"brand.svg\")\n   * - width and height are optional and default to 24dp\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name or bundled web asset path\n   *\n   * @since 8.7.7\n   * @example\n   * titleIcon: {\n   *   ios: { iconType: \"sf-symbol\", icon: \"lock.fill\" },\n   *   android: { iconType: \"vector\", icon: \"ic_lock\", width: 20, height: 20 }\n   * }\n   */\n  titleIcon?: ToolbarTitleIconOptions;\n  /**\n   * Background color of the browser\n   * @since 0.1.0\n   * @default BackgroundColor.BLACK\n   */\n  backgroundColor?: BackgroundColor;\n  /**\n   * If true, enables native navigation gestures within the webview.\n   * - Android: Native back button navigates within webview history\n   * - iOS: Enables swipe left/right gestures for back/forward navigation\n   * @default false (Android), true (iOS - enabled by default)\n   * @example\n   * activeNativeNavigationForWebview: true,\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  activeNativeNavigationForWebview?: boolean;\n\n  /**\n   * Enable pull-to-refresh (overscroll from top) to reload the current page.\n   * - iOS: Uses UIRefreshControl on the WebView scroll view\n   * - Android: Uses SwipeRefreshLayout around the WebView\n   *\n   * On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,\n   * the reload gesture will not work.\n   *\n   * @since 8.10.8\n   * @default false\n   * @example\n   * enableReloadGesture: true\n   */\n  enableReloadGesture?: boolean;\n  /**\n   * Disable the possibility to go back on native application,\n   * useful to force user to stay on the webview, Android only\n   * @default false\n   * @example\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  disableGoBackOnNativeApplication?: boolean;\n  /**\n   * Open url in a new window fullscreen\n   * isPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * Promise timing: on Android, `openWebView()` resolves with the webview id when the webview is ready to be controlled\n   * (immediately for hidden/immediate presentation, after the first page load when `isPresentAfterPageLoad` is `true`).\n   * On iOS, the promise resolves with the id as soon as the native webview is created, even if presentation is deferred.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * isPresentAfterPageLoad: true,\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * Whether the website in the webview is inspectable or not, ios only\n   * @default false\n   */\n  isInspectable?: boolean;\n  /**\n   * Whether the webview opening is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n  /**\n   * Shows a reload button that reloads the web page\n   * @since 1.0.15\n   * @default false\n   * @example\n   * showReloadButton: true\n   * Test URL: https://capgo.app\n   */\n  showReloadButton?: boolean;\n  /**\n   * closeAction controls what happens when the native toolbar close button is pressed.\n   * This does not change the behavior of close(), JavaScript window.mobileApp.close(), or native back navigation.\n   *\n   * @default CloseAction.CLOSE\n   * @since 8.7.7\n   * @example\n   * closeAction: CloseAction.HIDE\n   */\n  closeAction?: CloseAction;\n  /**\n   * Captures the visible webview and includes it as `screenshot` in `hideEvent`\n   * before the toolbar close button hides the webview.\n   *\n   * Only applies when `closeAction` is `CloseAction.HIDE`.\n   *\n   * On iOS, capture uses `WKWebView.takeSnapshot`. When testing through Apple's\n   * iPhone Mirroring app with the physical device locked, the snapshot can succeed\n   * with the correct dimensions but a fully transparent PNG. Capture works as\n   * expected on a normal unlocked device. This appears to be an Apple mirroring\n   * limitation rather than a plugin bug.\n   *\n   * @default false\n   * @since 8.7.10\n   */\n  screenshotOnHide?: boolean;\n  /**\n   * CloseModal: if true a confirm will be displayed when user clicks on close button, if false the browser will be closed immediately.\n   * @since 1.1.0\n   * @default false\n   * @example\n   * closeModal: true,\n   * closeModalTitle: \"Close Window\",\n   * closeModalDescription: \"Are you sure you want to close?\",\n   * closeModalOk: \"Yes, close\",\n   * closeModalCancel: \"No, stay\"\n   * Test URL: https://capgo.app\n   */\n  closeModal?: boolean;\n  /**\n   * CloseModalTitle: title of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalTitle?: string;\n  /**\n   * CloseModalDescription: description of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Are you sure you want to close this window?\"\n   */\n  closeModalDescription?: string;\n  /**\n   * CloseModalOk: text of the confirm button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalOk?: string;\n  /**\n   * CloseModalCancel: text of the cancel button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Cancel\"\n   */\n  closeModalCancel?: string;\n  /**\n   * closeModalURLPattern: a regex pattern to match against the current URL when the close button is pressed.\n   * When provided along with closeModal: true, the close confirmation modal is only shown if the current URL matches this pattern.\n   * If the current URL does not match, the browser closes immediately without showing the modal.\n   * Requires closeModal to be true.\n   * @since 7.2.0\n   * @example\n   * closeModal: true,\n   * closeModalURLPattern: \".*checkout.*\"\n   */\n  closeModalURLPattern?: string;\n  /**\n   * visibleTitle: if true the website title would be shown else shown empty\n   * @since 1.2.5\n   * @default true\n   */\n  visibleTitle?: boolean;\n  /**\n   * toolbarColor: color of the toolbar in hex format\n   * @since 1.2.5\n   * @default \"#ffffff\"\n   * @example\n   * toolbarColor: \"#FF5733\"\n   * Test URL: https://capgo.app\n   */\n  toolbarColor?: string;\n  /**\n   * toolbarTextColor: color of the buttons and title in the toolbar in hex format\n   * When set, it overrides the automatic light/dark mode detection for text color\n   * @since 6.10.0\n   * @default calculated based on toolbarColor brightness\n   * @example\n   * toolbarTextColor: \"#FFFFFF\"\n   * Test URL: https://capgo.app\n   */\n  toolbarTextColor?: string;\n  /**\n   * showArrow: if true an arrow would be shown instead of cross for closing the window\n   * @since 1.2.5\n   * @default false\n   * @example\n   * showArrow: true\n   * Test URL: https://capgo.app\n   */\n  showArrow?: boolean;\n  /**\n   * ignoreUntrustedSSLError: if true, the webview will ignore untrusted SSL errors allowing the user to view the website.\n   * @since 6.1.0\n   * @default false\n   */\n  ignoreUntrustedSSLError?: boolean;\n  /**\n   * preShowScript: if isPresentAfterPageLoad is true and this variable is set the plugin will inject a script before showing the browser.\n   * This script will be run in an async context. The plugin will wait for the script to finish (max 10 seconds)\n   * @since 6.6.0\n   * @example\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  preShowScript?: string;\n  /**\n   * preShowScriptInjectionTime: controls when the preShowScript is injected.\n   * - \"documentStart\": injects before any page JavaScript runs (good for polyfills like Firebase)\n   * - \"pageLoad\": injects after page load (default, original behavior)\n   * @since 7.26.0\n   * @default \"pageLoad\"\n   * @example\n   * preShowScriptInjectionTime: \"documentStart\"\n   */\n  preShowScriptInjectionTime?: 'documentStart' | 'pageLoad';\n  /**\n   * Proxy interception mode.\n   *\n   * - `true`: legacy blanket mode, delegates all HTTP/HTTPS requests to JavaScript.\n   * - `string`: Android-only regex mode kept for backward compatibility.\n   *\n   * Prefer `outboundProxyRules` and `inboundProxyRules` for native-first matching.\n   *\n   * @since 6.9.0\n   */\n  proxyRequests?: boolean | string;\n  /**\n   * Native-first outbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  outboundProxyRules?: NativeProxyRule[];\n  /**\n   * Native-first inbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  inboundProxyRules?: NativeProxyRule[];\n  /**\n   * buttonNearDone allows for a creation of a custom button near the done/close button.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * For Android:\n   * - iconType must be \"asset\"\n   * - icon path should be in the public folder (e.g. \"monkey.svg\")\n   * - width and height are optional, defaults to 48dp\n   * - button is positioned at the end of toolbar with 8dp margin\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name\n   * @since 6.7.0\n   * @example\n   * buttonNearDone: {\n   *   ios: {\n   *     iconType: \"sf-symbol\",\n   *     icon: \"star.fill\"\n   *   },\n   *   android: {\n   *     iconType: \"asset\",\n   *     icon: \"public/monkey.svg\",\n   *     width: 24,\n   *     height: 24\n   *   }\n   * }\n   * Test URL: https://capgo.app\n   */\n  buttonNearDone?: {\n    ios: {\n      iconType: 'sf-symbol' | 'asset';\n      icon: string;\n    };\n    android: {\n      iconType: 'asset' | 'vector';\n      icon: string;\n      width?: number;\n      height?: number;\n    };\n  };\n  /**\n   * Shows a native screenshot button near the done/close button.\n   * The button is hidden by default and captures the current viewport when tapped.\n   * This option uses the same toolbar slot as `buttonNearDone` and is therefore incompatible with it.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  showScreenshotButton?: boolean;\n  /**\n   * textZoom: sets the text zoom of the page in percent.\n   * Allows users to increase or decrease the text size for better readability.\n   * @since 7.6.0\n   * @default 100\n   * @example\n   * textZoom: 120\n   * Test URL: https://capgo.app\n   */\n  textZoom?: number;\n  /**\n   * enableZoom: enables pinch-to-zoom gestures in the Android WebView.\n   * When true, built-in zoom controls are enabled and the zoom buttons are hidden.\n   * **Android only** — ignored on iOS where zoom is enabled by default.\n   * @since 8.5.0\n   * @default false\n   * @example\n   * enableZoom: true\n   */\n  enableZoom?: boolean;\n  /**\n   * If true, deeplinks and external app hand-off are blocked and stay in the webview.\n   * If false (default), custom schemes such as `tel:`, `mailto:`, and `sms:` open natively.\n   * On iOS, listing a custom scheme under `LSApplicationQueriesSchemes` is only required when\n   * you rely on `canOpenURL` for that scheme (for example `instagram://`). It is not required\n   * for HTTPS `authorizedAppLinks`, and `mailto`/`tel`/`sms` open without that Info.plist entry.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * preventDeeplink: true\n   * Test URL: https://aasa-tester.capgo.app/\n   */\n  preventDeeplink?: boolean;\n\n  /**\n   * When true, HTTP and HTTPS links opened from `target=\"_blank\"` anchors stay in the current webview instead of spawning a popup or opening in the system browser.\n   * By default, blank-target HTTP(S) links stay inside the plugin as managed popups that share cookies with the opener; enabling this option keeps everything in the same tab.\n   * Custom schemes such as `tel:` and `mailto:` and authorized app links still prefer their native handlers unless `preventDeeplink` is enabled.\n   *\n   * @since 8.5.6\n   * @default false\n   * @example\n   * openBlankTargetInWebView: true\n   */\n  openBlankTargetInWebView?: boolean;\n\n  /**\n   * List of base URLs whose hosts are treated as authorized App Links (Android) and Universal Links (iOS).\n   *\n   * - On both platforms, only HTTP(S) links whose host matches any entry in this list\n   *   will attempt to leave the in-app browser for the native / system handler.\n   * - iOS tries a Universal Link first (`universalLinksOnly`), then falls back to a normal\n   *   system open (App Store, Safari, etc.). Only if both fail does the URL stay in-webview.\n   * - Android uses an `ACTION_VIEW` intent for matching hosts.\n   * - Matching is host-based (case-insensitive), ignoring the \"www.\" prefix.\n   * - HTTPS hosts do not need `LSApplicationQueriesSchemes`; that Info.plist key is for\n   *   custom schemes like `instagram://`, not `https://instagram.com`.\n   * - When `preventDeeplink` is enabled, all external handling is blocked regardless of this list.\n   *\n   * @example\n   * ```ts\n   * [\"https://example.com\", \"https://instagram.com\", \"https://apps.apple.com\"]\n   * ```\n   *\n   * @since 7.12.0\n   * @default []\n   */\n  authorizedAppLinks?: string[];\n\n  /**\n   * If true, the webView will not take the full height and will have a 20px margin at the bottom.\n   * This creates a safe margin area outside the browser view.\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enabledSafeBottomMargin: true\n   */\n  enabledSafeBottomMargin?: boolean;\n\n  /**\n   * If false, the webView will extend behind the status bar for true full-screen immersive content.\n   * When true (default), respects the safe area at the top of the screen.\n   * Works independently of toolbarType - use for full-screen video players, games, or immersive web apps.\n   * @since 8.2.0\n   * @default true\n   * @example\n   * enabledSafeTopMargin: false  // Full screen, extends behind status bar\n   */\n  enabledSafeTopMargin?: boolean;\n\n  /**\n   * When true, applies the system status bar inset as the WebView top margin on Android.\n   * Keeps the legacy 0px margin by default for apps that handle padding themselves.\n   * @default false\n   * @example\n   * useTopInset: true\n   */\n  useTopInset?: boolean;\n\n  /**\n   * enableGooglePaySupport: if true, enables support for Google Pay popups and Payment Request API.\n   * This fixes OR_BIBED_15 errors by allowing popup windows and configuring Cross-Origin-Opener-Policy.\n   * Only enable this if you need Google Pay functionality as it allows popup windows.\n   *\n   * When enabled:\n   * - Allows popup windows for Google Pay authentication\n   * - Sets proper CORS headers for Payment Request API\n   * - Enables multiple window support in WebView\n   * - Configures secure context for payment processing\n   *\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enableGooglePaySupport: true\n   * Test URL: https://developers.google.com/pay/api/web/guides/tutorial\n   */\n  enableGooglePaySupport?: boolean;\n\n  /**\n   * Opens popup windows created by the page in hidden mode.\n   * Hidden popup windows can still be controlled with `executeScript`, `postMessage`, `show`, and `close`.\n   * Listen to `popupWindowOpened` to capture the popup id, then call `show({ id })` only if you want to reveal it.\n   *\n   * @default false\n   * @since 8.6.0\n   * @example\n   * hiddenPopupWindow: true\n   */\n  hiddenPopupWindow?: boolean;\n\n  /**\n   * blockedHosts: List of host patterns that should be blocked from loading in the InAppBrowser's internal navigations.\n   * Any request inside WebView to a URL with a host matching any of these patterns will be blocked.\n   * Supports wildcard patterns like:\n   * - \"*.example.com\" to block all subdomains\n   * - \"www.example.*\" to block wildcard domain extensions\n   *\n   * @since 7.17.0\n   * @default []\n   * @example\n   * blockedHosts: [\"*.tracking.com\", \"ads.example.com\"]\n   */\n  blockedHosts?: string[];\n\n  /**\n   * Width of the webview in pixels.\n   * If not set, webview will be fullscreen width.\n   * @default undefined (fullscreen)\n   * @example\n   * width: 400\n   */\n  width?: number;\n\n  /**\n   * Height of the webview in pixels.\n   * If not set, webview will be fullscreen height.\n   * @default undefined (fullscreen)\n   * @example\n   * height: 600\n   */\n  height?: number;\n\n  /**\n   * X position of the webview in pixels from the left edge.\n   * Only effective when width is set.\n   * @default 0\n   * @example\n   * x: 50\n   */\n  x?: number;\n\n  /**\n   * Y position of the webview in pixels from the top edge.\n   * Only effective when height is set.\n   * @default 0\n   * @example\n   * y: 100\n   */\n  y?: number;\n\n  /**\n   * Places the native browser behind the Capacitor host WebView.\n   * Make the app background transparent to reveal it, or rely on `transparentBackground` to clear the host WebView.\n   *\n   * @default false\n   */\n  toBack?: boolean;\n\n  /**\n   * When `toBack` is true, makes the Capacitor host WebView transparent so the native browser can be seen behind Ionic content.\n   * Ignored when the browser is in front.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n\n  /**\n   * Disables the bounce (overscroll) effect on iOS WebView.\n   * When enabled, prevents the rubber band scrolling effect when users scroll beyond content boundaries.\n   * This is useful for:\n   * - Creating a more native, app-like experience\n   * - Preventing accidental overscroll states\n   * - Avoiding issues when keyboard opens/closes\n   *\n   * Note: This option only affects iOS. Android does not have this bounce effect by default.\n   *\n   * @since 8.0.2\n   * @default false\n   * @example\n   * disableOverscroll: true\n   */\n  disableOverscroll?: boolean;\n\n  /**\n   * Opens the webview in hidden mode (not visible to user but fully functional).\n   * When hidden, the webview loads and executes JavaScript but is not displayed.\n   * All control methods (executeScript, postMessage, setUrl, etc.) work while hidden.\n   * Use close() to clean up the hidden webview when done.\n   *\n   * @since 8.0.7\n   * @default false\n   * @example\n   * hidden: true\n   */\n  hidden?: boolean;\n\n  /**\n   * Controls how a hidden webview reports its visibility and size.\n   * - AWARE: webview is aware it's hidden (dimensions may be zero).\n   * - FAKE_VISIBLE: webview is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   *\n   * @default InvisibilityMode.AWARE\n   * @example\n   * invisibilityMode: InvisibilityMode.FAKE_VISIBLE\n   */\n  invisibilityMode?: InvisibilityMode;\n}\n\nexport interface DimensionOptions {\n  /**\n   * Width of the webview in pixels\n   */\n  width?: number;\n  /**\n   * Height of the webview in pixels\n   */\n  height?: number;\n  /**\n   * X position from the left edge in pixels\n   */\n  x?: number;\n  /**\n   * Y position from the top edge in pixels\n   */\n  y?: number;\n}\n\nexport interface InAppBrowserPlugin {\n  /**\n   * Navigates back in the WebView's history if possible\n   *\n   * @since 7.21.0\n   * @returns Promise that resolves with true if navigation was possible, false otherwise\n   */\n  goBack(options?: { id?: string }): Promise<{ canGoBack: boolean }>;\n\n  /**\n   * Open url in a new window fullscreen, on android it use chrome custom tabs, on ios it use SFSafariViewController\n   *\n   * @since 0.1.0\n   */\n  open(options: OpenOptions): Promise<any>;\n\n  /**\n   * Clear cookies of url\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 0.5.0\n   */\n  clearCookies(options: ClearCookieOptions): Promise<any>;\n  /**\n   * Clear all cookies\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearAllCookies(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear cache\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearCache(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear all browsing data from the default store and any opened managed webviews.\n   *\n   * This removes cookies, disk cache, memory cache, local storage, session storage, IndexedDB,\n   * WebSQL where supported, form data, and HTTP auth data where the platform exposes it.\n   *\n   * @since 8.6.36\n   */\n  clearAllBrowsingData(): Promise<any>;\n\n  /**\n   * Get cookies for a specific URL.\n   * @param options The options, including the URL to get cookies for.\n   * @returns A promise that resolves with the cookies.\n   */\n  getCookies(options: GetCookieOptions): Promise<Record<string, string>>;\n  /**\n   * Close the webview.\n   * When `id` is omitted, closes the active webview.\n   */\n  close(options?: CloseWebviewOptions): Promise<any>;\n  /**\n   * Hide the webview without closing it.\n   * Use show() to bring it back.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  hide(options?: { id?: string }): Promise<void>;\n  /**\n   * Show a previously hidden webview.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  show(options?: { id?: string }): Promise<void>;\n  /**\n   * Moves the native browser behind the Capacitor host WebView.\n   * Use `dispatchInputEvent()` to forward overlay gestures to the browser while it is behind the app UI.\n   */\n  sendToBack(options?: LayerOptions): Promise<void>;\n  /**\n   * Moves a browser that was behind the host WebView back to the front.\n   * On iOS, set `isAnimated` to `false` to skip the presentation animation.\n   * When `id` is omitted, targets the active webview.\n   */\n  bringToFront(options?: BringToFrontOptions): Promise<void>;\n  /**\n   * Dispatches a click, touch, or scroll event to a managed browser.\n   * Coordinates are relative to the browser viewport in CSS pixels.\n   */\n  dispatchInputEvent(options: DispatchInputEventOptions): Promise<void>;\n  /**\n   * Open url in a new webview with toolbars, and enhanced capabilities, like camera access, file access, listen events, inject javascript, bi directional communication, etc.\n   *\n   * JavaScript Interface:\n   * When you open a webview with this method, a JavaScript interface is automatically injected that provides:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage({detail: {message: \"myMessage\"}})`: Sends a message from the webview to the app, detail object is the data you want to send to the webview\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * Promise timing differs by platform when `isPresentAfterPageLoad` is used.\n   * Android resolves with `{ id }` after the dialog is ready to control, while iOS resolves with `{ id }` immediately after creating the native webview.\n   *\n   * @returns Promise that resolves with the created webview id.\n   * @since 0.1.0\n   */\n  openWebView(options: OpenWebViewOptions): Promise<{ id: string }>;\n  /**\n   * Injects JavaScript code into the InAppBrowser window.\n   * When `id` is omitted, executes in all open webviews.\n   */\n  executeScript(options: { code: string; id?: string }): Promise<void>;\n  /**\n   * Sends an event to the webview(inappbrowser). you can listen to this event in the inappbrowser JS with window.addEventListener(\"messageFromNative\", listenerFunc: (event: Record<string, any>) => void)\n   * detail is the data you want to send to the webview, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, so no functions or other non-JSON-serializable types are allowed.\n   * When `id` is omitted, broadcasts to all open webviews.\n   */\n  postMessage(options: { detail: Record<string, any>; id?: string }): Promise<void>;\n  /**\n   * Captures the current webview viewport as a PNG screenshot.\n   * When `id` is omitted, targets the active webview.\n   *\n   * On iOS, when testing through Apple's iPhone Mirroring app with the physical\n   * device locked, the snapshot can succeed with the correct dimensions but a\n   * fully transparent PNG. Capture works as expected on a normal unlocked device.\n   */\n  takeScreenshot(options?: { id?: string }): Promise<ScreenshotResult>;\n  /**\n   * Sets the URL of the webview.\n   * When `id` is omitted, targets the active webview.\n   */\n  setUrl(options: { url: string; id?: string }): Promise<any>;\n  /**\n   * Listen for url change, only for openWebView\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'urlChangeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for buttonNearDone clicks.\n   *\n   * The event payload contains the webview `id`.\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'buttonNearDoneClick', listenerFunc: ButtonNearListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for close click only for openWebView\n   *\n   * @since 0.4.0\n   */\n  addListener(eventName: 'closeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n  /**\n   * Listen for webviews hidden by the toolbar close button when closeAction is CloseAction.HIDE.\n   *\n   * @since 8.7.7\n   */\n  addListener(eventName: 'hideEvent', listenerFunc: HideListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when user clicks on confirm button when disclaimer is required,\n   * works with openWebView shareDisclaimer and closeModal\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'confirmBtnClicked', listenerFunc: ConfirmBtnListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when event is sent from webview(inappbrowser), to send an event to the main app use window.mobileApp.postMessage({ \"detail\": { \"message\": \"myMessage\" } })\n   * detail is the data you want to send to the main app, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, no functions or other non-JSON-serializable types are allowed.\n   *\n   * This method is inject at runtime in the webview\n   */\n  addListener(\n    eventName: 'messageFromWebview',\n    listenerFunc: (event: { id?: string; detail?: Record<string, any>; rawMessage?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered whenever a screenshot is captured from the plugin API,\n   * the native screenshot button, or the injected JavaScript bridge.\n   */\n  addListener(\n    eventName: 'screenshotTaken',\n    listenerFunc: (event: ScreenshotResult & { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page is loaded\n   */\n  addListener(\n    eventName: 'browserPageLoaded',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when a main-frame page load starts (link navigation, reload, etc.).\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadStart',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered as a main-frame page load progresses.\n   * `progress` is a value from `0` to `1`.\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadProgress',\n    listenerFunc: (event: { id?: string; progress: number }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page load error\n   */\n  addListener(\n    eventName: 'pageLoadError',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when the webview intercepts a non-standard custom scheme\n   * and hands it to the operating system.\n   *\n   * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n   *\n   * @since 8.6.7\n   */\n  addListener(\n    eventName: 'customSchemeIntercepted',\n    listenerFunc: CustomSchemeInterceptedListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered after native download handling saves a file locally.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadCompleted',\n    listenerFunc: (event: DownloadCompletedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when native download handling fails.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadFailed',\n    listenerFunc: (event: DownloadFailedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered whenever a page opens a popup/new window.\n   * Use the returned popup id with `executeScript`, `postMessage`, `show`, `hide`, and `close`.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'popupWindowOpened',\n    listenerFunc: (event: PopupWindowEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for proxied requests delegated by the native runtime.\n   * Prefer `addProxyHandler()` instead of calling this directly.\n   *\n   * @since 8.6.0\n   */\n  addListener(eventName: 'proxyRequest', listenerFunc: (event: ProxyRequest) => void): Promise<PluginListenerHandle>;\n  /**\n   * Listen for JavaScript console output emitted by the managed page.\n   * Enable this with `captureConsoleLogs: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'consoleMessage',\n    listenerFunc: (event: ConsoleMessageEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Internal method used by `addProxyHandler()` to send a proxy decision back to native.\n   * Forward the original `phase` when replying to a manual `proxyRequest` listener.\n   *\n   * @since 8.6.0\n   */\n  handleProxyRequest(options: {\n    requestId: string;\n    decision?: ProxyDecision | null;\n    response?: ProxyResponse | null;\n    webviewId?: string;\n    phase?: 'outbound' | 'inbound';\n  }): Promise<void>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Reload the current web page.\n   *\n   * @since 1.0.0\n   */\n  reload(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Update the dimensions of the webview.\n   * Allows changing the size and position of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @param options Dimension options (width, height, x, y)\n   * @returns Promise that resolves when dimensions are updated\n   */\n  updateDimensions(options: DimensionOptions & { id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe top margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeTopMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe bottom margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeBottomMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Opens a secured window for OAuth2 authentication.\n   * For web, you should have the code in the redirected page to use a broadcast channel to send the redirected url to the app\n   * Something like:\n   * ```html\n   * <html>\n   * <head></head>\n   * <body>\n   * <script>\n   *   const searchParams = new URLSearchParams(location.search)\n   *   if (searchParams.has(\"code\")) {\n   *     new BroadcastChannel(\"my-channel-name\").postMessage(location.href);\n   *     window.close();\n   *   }\n   * </script>\n   * </body>\n   * </html>\n   * ```\n   * For mobile, you should have a redirect uri that opens the app, something like: `myapp://oauth_callback/`\n   * And make sure to register it in the app's info.plist:\n   * ```xml\n   * <key>CFBundleURLTypes</key>\n   * <array>\n   *    <dict>\n   *       <key>CFBundleURLSchemes</key>\n   *       <array>\n   *          <string>myapp</string>\n   *       </array>\n   *    </dict>\n   * </array>\n   * ```\n   * And in the AndroidManifest.xml file:\n   * ```xml\n   * <activity>\n   *    <intent-filter>\n   *       <action android:name=\"android.intent.action.VIEW\" />\n   *       <category android:name=\"android.intent.category.DEFAULT\" />\n   *       <category android:name=\"android.intent.category.BROWSABLE\" />\n   *       <data android:host=\"oauth_callback\" android:scheme=\"myapp\" />\n   *    </intent-filter>\n   * </activity>\n   * ```\n   * @param options - the options for the openSecureWindow call\n   */\n  openSecureWindow(options: OpenSecureWindowOptions): Promise<OpenSecureWindowResponse>;\n}\n\n/**\n * JavaScript APIs available in the InAppBrowser WebView.\n *\n * These APIs are automatically injected into all webpages loaded in the InAppBrowser WebView.\n *\n * @example\n * // Closing the webview from JavaScript\n * window.mobileApp.close();\n *\n * // Sending a message from webview to the native app\n * window.mobileApp.postMessage({ key: \"value\" });\n *\n * @since 6.10.0\n */\nexport interface InAppBrowserWebViewAPIs {\n  /**\n   * mobileApp - Global object injected into the WebView providing communication with the native app\n   */\n  mobileApp: {\n    /**\n     * Close the WebView from JavaScript\n     *\n     * @example\n     * // Add a button to close the webview\n     * const closeButton = document.createElement(\"button\");\n     * closeButton.textContent = \"Close WebView\";\n     * closeButton.addEventListener(\"click\", () => {\n     *   window.mobileApp.close();\n     * });\n     * document.body.appendChild(closeButton);\n     *\n     * @since 6.10.0\n     */\n    close(): void;\n\n    /**\n     * Send a message from the WebView to the native app\n     * The native app can listen for these messages with the \"messageFromWebview\" event\n     *\n     * @param message Object to send to the native app\n     * @example\n     * // Send data to native app\n     * window.mobileApp.postMessage({\n     *   action: \"dataSubmitted\",\n     *   data: { username: \"test\", email: \"test@example.com\" }\n     * });\n     *\n     * @since 6.10.0\n     */\n    postMessage(message: Record<string, any>): void;\n\n    /**\n     * Hide the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    hide(): void;\n\n    /**\n     * Show the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    show(): void;\n\n    /**\n     * Capture the current WebView viewport as a PNG screenshot.\n     * Requires `allowScreenshotsFromWebPage` to be enabled when opening the webview.\n     *\n     * @since 8.4.0\n     */\n    takeScreenshot(): Promise<ScreenshotResult>;\n  };\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAmEA,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AACD,MAAM,CAAN,IAAY,WAqBX;AArBD,WAAY,WAAW;IACrB;;;OAGG;IACH,oCAAqB,CAAA;IACrB;;;OAGG;IACH,kCAAmB,CAAA;IACnB;;;OAGG;IACH,wCAAyB,CAAA;IACzB;;;OAGG;IACH,8BAAe,CAAA;AACjB,CAAC,EArBW,WAAW,KAAX,WAAW,QAqBtB;AAED,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,mCAAe,CAAA;IACf;;OAEG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B;AAED,MAAM,CAAN,IAAY,WASX;AATD,WAAY,WAAW;IACrB;;OAEG;IACH,8BAAe,CAAA;IACf;;OAEG;IACH,4BAAa,CAAA;AACf,CAAC,EATW,WAAW,KAAX,WAAW,QAStB","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\nexport interface UrlEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when the url changes\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\n/**\n * Event emitted when the managed webview intercepts a non-standard custom scheme\n * and hands it to the operating system.\n *\n * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n *\n * @since 8.6.7\n */\nexport interface CustomSchemeInterceptedEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Intercepted URL.\n   */\n  url: string;\n  /**\n   * Whether the operating system accepted the URL handoff.\n   */\n  opened: boolean;\n}\nexport interface BtnEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * Emit when a button is clicked.\n   *\n   * @since 0.0.1\n   */\n  url: string;\n}\n\nexport interface ButtonNearDoneEvent {\n  /**\n   * Webview instance id.\n   *\n   * @since 8.6.36\n   */\n  id: string;\n}\n\nexport type UrlChangeListener = (state: UrlEvent) => void;\nexport type ConfirmBtnListener = (state: BtnEvent) => void;\nexport type ButtonNearListener = (state: ButtonNearDoneEvent) => void;\nexport type CustomSchemeInterceptedListener = (state: CustomSchemeInterceptedEvent) => void;\n\nexport type WebViewPointerInputEventType = 'click' | 'touchstart' | 'touchmove' | 'touchend' | 'touchcancel';\nexport type WebViewInputEventType = WebViewPointerInputEventType | 'scroll';\n\nexport enum BackgroundColor {\n  WHITE = 'white',\n  BLACK = 'black',\n}\nexport enum ToolBarType {\n  /**\n   * Shows a simple toolbar with just a close button and share button\n   * @since 0.1.0\n   */\n  ACTIVITY = 'activity',\n  /**\n   * Shows a simple toolbar with just a close button\n   * @since 7.6.8\n   */\n  COMPACT = 'compact',\n  /**\n   * Shows a full navigation toolbar with back/forward buttons\n   * @since 0.1.0\n   */\n  NAVIGATION = 'navigation',\n  /**\n   * Shows no toolbar\n   * @since 0.1.0\n   */\n  BLANK = 'blank',\n}\n\nexport enum InvisibilityMode {\n  /**\n   * WebView is aware it is hidden (dimensions may be zero).\n   */\n  AWARE = 'AWARE',\n  /**\n   * WebView is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   */\n  FAKE_VISIBLE = 'FAKE_VISIBLE',\n}\n\nexport enum CloseAction {\n  /**\n   * The toolbar close button closes and destroys the webview.\n   */\n  CLOSE = 'close',\n  /**\n   * The toolbar close button hides the webview so it can be shown again.\n   */\n  HIDE = 'hide',\n}\n\nexport interface ToolbarTitleIconOptions {\n  ios?: {\n    iconType: 'sf-symbol' | 'asset';\n    icon: string;\n  };\n  android?: {\n    iconType: 'asset' | 'vector';\n    icon: string;\n    width?: number;\n    height?: number;\n  };\n}\n\nexport interface Headers {\n  [key: string]: string;\n}\n\nexport interface GetCookieOptions {\n  url: string;\n  includeHttpOnly?: boolean;\n}\n\nexport interface ClearCookieOptions {\n  /**\n   * Target webview id.\n   * When omitted, applies to all open webviews.\n   */\n  id?: string;\n  url: string;\n}\n\nexport interface Credentials {\n  username: string;\n  password: string;\n}\n\nexport interface LayerOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Makes the Capacitor host WebView transparent while this native webview is behind it.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n}\n\nexport interface BringToFrontOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Whether bringing the webview to the front is animated on iOS.\n   *\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface DispatchPointerInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: WebViewPointerInputEventType;\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n}\n\nexport interface DispatchScrollInputEventOptions {\n  /**\n   * Target webview id. If omitted, targets the active webview.\n   */\n  id?: string;\n  /**\n   * Input event to dispatch to the webview.\n   */\n  type: 'scroll';\n  /**\n   * X coordinate in CSS pixels from the webview's left edge.\n   */\n  x: number;\n  /**\n   * Y coordinate in CSS pixels from the webview's top edge.\n   */\n  y: number;\n  /**\n   * Horizontal scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaX: number;\n  /**\n   * Vertical scroll delta in CSS pixels. Used when `type` is `scroll`.\n   */\n  deltaY: number;\n}\n\nexport type DispatchInputEventOptions = DispatchPointerInputEventOptions | DispatchScrollInputEventOptions;\n\n/**\n * Represents an intercepted HTTP request from the in-app browser webview.\n *\n * Request and response bodies are base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequest {\n  requestId: string;\n  phase: 'outbound' | 'inbound';\n  url: string;\n  method: string;\n  headers: Record<string, string>;\n  body: string | null;\n  status?: number;\n  responseHeaders?: Record<string, string>;\n  responseBody?: string | null;\n  webviewId: string;\n}\n\n/**\n * Response payload returned to native for a proxied request.\n *\n * The body must be base64-encoded.\n *\n * @since 8.6.0\n */\nexport interface ProxyResponse {\n  body: string;\n  status: number;\n  headers: Record<string, string>;\n}\n\n/**\n * Request override returned to native for an outbound proxied request.\n *\n * The body must be base64-encoded when present.\n *\n * @since 8.6.0\n */\nexport interface ProxyRequestOverride {\n  url: string;\n  method?: string;\n  headers?: Record<string, string>;\n  body?: string | null;\n}\n\n/**\n * Event emitted when a web page opens a popup/new window.\n *\n * @since 8.6.0\n */\nexport interface PopupWindowEvent {\n  /**\n   * Popup webview instance id.\n   */\n  id: string;\n  /**\n   * Parent webview instance id.\n   */\n  parentId?: string;\n  /**\n   * Requested popup URL when available.\n   */\n  url?: string;\n  /**\n   * Whether the popup was presented immediately.\n   */\n  visible: boolean;\n}\n\n/**\n * Event emitted when JavaScript running inside the managed webview writes to the console.\n *\n * Enable this with `captureConsoleLogs: true` when opening the webview.\n *\n * @since 8.6.0\n */\nexport interface ConsoleMessageEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Console method or normalized severity.\n   */\n  level: 'log' | 'info' | 'warn' | 'error' | 'debug' | 'assert' | string;\n  /**\n   * Joined string representation of the console arguments.\n   */\n  message: string;\n  /**\n   * Script URL or page URL when available.\n   */\n  source?: string;\n  /**\n   * 1-based line number when available.\n   */\n  line?: number;\n  /**\n   * 1-based column number when available.\n   */\n  column?: number;\n  /**\n   * Optional subtype for runtime-originated errors on supported platforms.\n   */\n  kind?: string;\n}\n\n/**\n * Native handling mode used after a managed download finishes.\n *\n * @since 8.6.0\n */\nexport type DownloadHandledBy = 'inAppBrowser' | 'systemPreview' | 'external';\n\n/**\n * Event emitted after a managed download is saved locally.\n *\n * @since 8.6.0\n */\nexport interface DownloadCompletedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Saved filename.\n   */\n  fileName: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Absolute native filesystem path to the saved file.\n   */\n  path: string;\n  /**\n   * `file://` URL pointing at the saved file.\n   */\n  localUrl: string;\n  /**\n   * How native handled the downloaded file after saving it.\n   */\n  handledBy: DownloadHandledBy;\n}\n\n/**\n * Event emitted when managed download handling fails.\n *\n * @since 8.6.0\n */\nexport interface DownloadFailedEvent {\n  /**\n   * Source webview instance id.\n   */\n  id?: string;\n  /**\n   * Original URL that triggered the download when available.\n   */\n  sourceUrl?: string;\n  /**\n   * Intended filename when known.\n   */\n  fileName?: string;\n  /**\n   * Resolved MIME type when available.\n   */\n  mimeType?: string;\n  /**\n   * Native error message.\n   */\n  error: string;\n}\n\n/**\n * Decision returned to native when handling a proxied request.\n *\n * @since 8.6.0\n */\nexport interface ProxyDecision {\n  request?: ProxyRequestOverride | null;\n  response?: ProxyResponse | null;\n  cancel?: boolean;\n}\n\n/**\n * Native-first proxy rule used on Android and iOS.\n *\n * Any regex property that is omitted is treated as a wildcard.\n *\n * @since 8.6.0\n */\nexport interface NativeProxyRule {\n  id?: string;\n  urlRegex?: string;\n  methodRegex?: string;\n  headerRegex?: string;\n  bodyRegex?: string;\n  statusRegex?: string;\n  responseHeaderRegex?: string;\n  responseBodyRegex?: string;\n  mainFrameOnly?: boolean;\n  action: 'continue' | 'cancel' | 'delegateToJs';\n}\n\nexport type ProxyHandlerResult = Response | ProxyResponse | ProxyRequestOverride | ProxyDecision | null;\n\n/**\n * JavaScript callback used to handle proxied requests.\n *\n * Return a `Response`, `ProxyResponse`, `ProxyRequestOverride`, `ProxyDecision`,\n * or `null` to let native continue unchanged.\n *\n * @since 8.6.0\n */\nexport type ProxyHandler = (request: ProxyRequest) => ProxyHandlerResult | Promise<ProxyHandlerResult>;\n\nexport interface OpenOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   */\n  url: string;\n  /**\n   * if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * @since 0.1.0\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * if true the deeplink will not be opened, if false the deeplink will be opened when clicked on the link\n   * @since 0.1.0\n   */\n  preventDeeplink?: boolean;\n\n  // --- Chrome Custom Tab customization (Android only, ignored on iOS) ---\n\n  /**\n   * Toolbar background color in hex format (e.g., \"#1A1A2E\").\n   * Applied to both light and dark color schemes.\n   * Also sets the navigation bar color to match.\n   * **Android only** — ignored on iOS.\n   * @since 8.2.0\n   */\n  toolbarColor?: string;\n\n  /**\n   * Whether the URL bar should auto-hide when the user scrolls down.\n   * The bar reappears on any upward scroll.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  urlBarHidingEnabled?: boolean;\n\n  /**\n   * Show the page's HTML <title> in the toolbar instead of the raw URL.\n   * The true URL is still visible when the user taps the title area.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showTitle?: boolean;\n\n  /**\n   * Replace the default \"X\" close icon with a back arrow.\n   * Makes the Custom Tab feel like a native navigation push rather than a modal overlay.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  showArrow?: boolean;\n\n  /**\n   * Remove the share action from the overflow menu.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableShare?: boolean;\n\n  /**\n   * Hide the bookmark star icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableBookmark?: boolean;\n\n  /**\n   * Hide the download icon in the overflow menu.\n   * Uses an undocumented Chromium intent extra — may stop working on future Chrome updates.\n   * **Android only** — ignored on iOS.\n   * @default false\n   * @since 8.2.0\n   */\n  disableDownload?: boolean;\n}\n\nexport interface OpenSecureWindowOptions {\n  /**\n   * The endpoint to open\n   */\n  authEndpoint: string;\n  /**\n   * The redirect URI to use for the openSecureWindow call.\n   * This will be checked to make sure it matches the redirect URI after the window finishes the redirection.\n   */\n  redirectUri: string;\n  /**\n   * The name of the broadcast channel to listen to, relevant only for web\n   */\n  broadcastChannelName?: string;\n  /**\n   * If true, the browser session will be ephemeral (no cookies or browsing data are shared with the system browser).\n   * On iOS, this sets `prefersEphemeralWebBrowserSession = true` on `ASWebAuthenticationSession`.\n   * On Android, this enables Custom Tabs ephemeral browsing via `setEphemeralBrowsingEnabled(true)`.\n   * @default false\n   * @since 6.6.0\n   */\n  prefersEphemeralWebBrowserSession?: boolean;\n}\n\nexport interface OpenSecureWindowResponse {\n  /**\n   * The result of the openSecureWindow call\n   */\n  redirectedUri: string;\n}\n\nexport interface DisclaimerOptions {\n  /**\n   * Title of the disclaimer dialog\n   * @default \"Title\"\n   */\n  title: string;\n  /**\n   * Message shown in the disclaimer dialog\n   * @default \"Message\"\n   */\n  message: string;\n  /**\n   * Text for the confirm button\n   * @default \"Confirm\"\n   */\n  confirmBtn: string;\n  /**\n   * Text for the cancel button\n   * @default \"Cancel\"\n   */\n  cancelBtn: string;\n}\n\nexport interface ScreenshotResult {\n  /**\n   * Image format used for the screenshot.\n   */\n  format: 'png';\n  /**\n   * MIME type of the generated screenshot.\n   */\n  mimeType: 'image/png';\n  /**\n   * Base64-encoded screenshot payload without the data URL prefix.\n   */\n  base64: string;\n  /**\n   * Data URL for direct use in HTML img tags or uploads.\n   */\n  dataUrl: string;\n  /**\n   * Screenshot width in pixels.\n   */\n  width: number;\n  /**\n   * Screenshot height in pixels.\n   */\n  height: number;\n}\n\nexport interface HideEvent {\n  /**\n   * Webview instance id.\n   */\n  id?: string;\n  /**\n   * URL active when the webview was hidden.\n   */\n  url: string;\n  /**\n   * Screenshot captured immediately before the toolbar close button hides the webview.\n   * Present only when `screenshotOnHide` is enabled and capture succeeds.\n   */\n  screenshot?: ScreenshotResult;\n}\n\nexport type HideListener = (state: HideEvent) => void;\n\nexport interface CloseWebviewOptions {\n  /**\n   * Target webview id to close. If omitted, closes the active webview.\n   */\n  id?: string;\n  /**\n   * Whether the webview closing is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n}\n\nexport interface OpenWebViewOptions {\n  /**\n   * Target URL to load.\n   * @since 0.1.0\n   * @example \"https://capgo.app\"\n   */\n  url: string;\n  /**\n   * Headers to send with the request.\n   * @since 0.1.0\n   * @example\n   * headers: {\n   *   \"Custom-Header\": \"test-value\",\n   *   \"Authorization\": \"Bearer test-token\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  headers?: Headers;\n  /**\n   * Credentials to send with the request and all subsequent requests for the same host.\n   * @since 6.1.0\n   * @example\n   * credentials: {\n   *   username: \"test-user\",\n   *   password: \"test-pass\"\n   * }\n   * Test URL: https://www.whatismybrowser.com/detect/what-http-headers-is-my-browser-sending/\n   */\n  credentials?: Credentials;\n  /**\n   * HTTP method to use for the initial request.\n   *\n   * **Optional parameter - defaults to GET if not specified.**\n   * Existing code that doesn't provide this parameter will continue to work unchanged with standard GET requests.\n   *\n   * When specified with 'POST', 'PUT', or 'PATCH' methods that support a body,\n   * you can also provide a `body` parameter with the request payload.\n   *\n   * **Platform Notes:**\n   * - iOS: Full support for all HTTP methods with headers\n   * - Android: Custom headers may not be sent with POST/PUT/PATCH requests due to WebView limitations\n   *\n   * @since 8.2.0\n   * @default \"GET\"\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ token: \"auth-token\", data: \"value\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | string;\n  /**\n   * HTTP body to send with the request when using POST, PUT, or other methods that support a body.\n   * Should be a string (use JSON.stringify for JSON data).\n   *\n   * **Optional parameter - only used when `method` is specified and supports a request body.**\n   * Omitting this parameter (or using GET method) results in standard behavior without a request body.\n   *\n   * @since 8.2.0\n   * @example\n   * method: \"POST\",\n   * body: JSON.stringify({ username: \"user\", password: \"pass\" }),\n   * headers: { \"Content-Type\": \"application/json\" }\n   */\n  body?: string;\n  /**\n   * materialPicker: if true, uses Material Design theme for date and time pickers on Android.\n   * This improves the appearance of HTML date inputs to use modern Material Design UI instead of the old style pickers.\n   * @since 7.4.1\n   * @default false\n   * @example\n   * materialPicker: true\n   * Test URL: https://show-picker.glitch.me/demo.html\n   */\n  materialPicker?: boolean;\n  /**\n   * JavaScript Interface:\n   * The webview automatically injects a JavaScript interface providing:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage(obj)`: Sends a message to the app (listen via \"messageFromWebview\" event)\n   * - `window.mobileApp.hide()` / `window.mobileApp.show()` when allowWebViewJsVisibilityControl is true in CapacitorConfig\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * @example\n   * // In your webpage loaded in the webview:\n   * document.getElementById(\"closeBtn\").addEventListener(\"click\", () => {\n   *   window.mobileApp.close();\n   * });\n   *\n   * // Send data to the app\n   * window.mobileApp.postMessage({ action: \"login\", data: { user: \"test\" }});\n   *\n   * @since 6.10.0\n   */\n  jsInterface?: never; // This property doesn't exist, it's just for documentation\n  /**\n   * Allows page JavaScript to call `window.mobileApp.takeScreenshot()`.\n   * Disabled by default so only the host app can trigger native screenshots through the plugin API.\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  allowScreenshotsFromWebPage?: boolean;\n  /**\n   * Emits `consoleMessage` events for JavaScript `console.*` output coming from the managed page.\n   * Useful when the webview stays hidden and you still need page-level diagnostics.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  captureConsoleLogs?: boolean;\n  /**\n   * Controls whether the webview should persist website data such as cache, cookies, local storage,\n   * IndexedDB, and session data.\n   *\n   * When false, iOS uses a non-persistent `WKWebsiteDataStore`. Android disables per-view cache and\n   * DOM/database storage where the system WebView supports it. Android cookies use the shared\n   * WebView cookie store, so call `clearAllBrowsingData()` to remove cookies and other global data.\n   *\n   * @default true\n   * @since 8.6.36\n   */\n  persistWebViewData?: boolean;\n  /**\n   * Controls Android TLS client certificate prompts during HTTPS handshakes.\n   * Use `prompt` to show the system certificate picker; omit or use `none` to cancel silently (default).\n   *\n   * @default \"none\"\n   * @since 8.7.5\n   */\n  clientCertificate?: 'none' | 'prompt';\n  /**\n   * @deprecated Use `clientCertificate: \"prompt\"` instead.\n   */\n  clientCertificatePrompt?: boolean;\n  /**\n   * Automatically handles downloads triggered inside the webview without requiring a custom JavaScript bridge.\n   *\n   * When enabled:\n   * - Standard attachment responses are written to a temporary file.\n   * - `blob:` downloads are also captured when the platform supports them.\n   * - Previewable files reopen inside the in-app browser when possible.\n   * - Other files are handed off to the native preview or viewer flow.\n   * - `downloadCompleted` and `downloadFailed` events notify the host app about the saved file.\n   *\n   * @default false\n   * @since 8.6.0\n   */\n  handleDownloads?: boolean;\n  /**\n   * Share options for the webview. When provided, shows a disclaimer dialog before sharing content.\n   * This is useful for:\n   * - Warning users about sharing sensitive information\n   * - Getting user consent before sharing\n   * - Explaining what will be shared\n   * - Complying with privacy regulations\n   *\n   * Note: shareSubject is required when using shareDisclaimer\n   * @since 0.1.0\n   * @example\n   * shareDisclaimer: {\n   *   title: \"Disclaimer\",\n   *   message: \"This is a test disclaimer\",\n   *   confirmBtn: \"Accept\",\n   *   cancelBtn: \"Decline\"\n   * }\n   * Test URL: https://capgo.app\n   */\n  shareDisclaimer?: DisclaimerOptions;\n  /**\n   * Toolbar type determines the appearance and behavior of the browser's toolbar\n   * - \"activity\": Shows a simple toolbar with just a close button and share button\n   * - \"navigation\": Shows a full navigation toolbar with back/forward buttons\n   * - \"blank\": Shows no toolbar\n   * - \"\": Default toolbar with close button\n   * @since 0.1.0\n   * @default ToolBarType.DEFAULT\n   * @example\n   * toolbarType: ToolBarType.ACTIVITY,\n   * title: \"Activity Toolbar Test\"\n   * Test URL: https://capgo.app\n   */\n  toolbarType?: ToolBarType;\n  /**\n   * Subject text for sharing. Required when using shareDisclaimer.\n   * This text will be used as the subject line when sharing content.\n   * @since 0.1.0\n   * @example \"Share this page\"\n   */\n  shareSubject?: string;\n  /**\n   * Title of the browser\n   * @since 0.1.0\n   * @default \"New Window\"\n   * @example \"Camera Test\"\n   */\n  title?: string;\n  /**\n   * Native toolbar title font family.\n   * On iOS, use the registered font family name. On Android, the plugin first tries a res/font resource name,\n   * then falls back to a system font family name.\n   *\n   * @since 8.7.7\n   * @example \"Inter\"\n   */\n  titleFontFamily?: string;\n  /**\n   * Native toolbar title icon displayed before the title text.\n   *\n   * For Android:\n   * - iconType can be \"asset\" for a bundled SVG asset or \"vector\" for a drawable resource\n   * - icon path should be in the public folder for assets (e.g. \"brand.svg\")\n   * - width and height are optional and default to 24dp\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name or bundled web asset path\n   *\n   * @since 8.7.7\n   * @example\n   * titleIcon: {\n   *   ios: { iconType: \"sf-symbol\", icon: \"lock.fill\" },\n   *   android: { iconType: \"vector\", icon: \"ic_lock\", width: 20, height: 20 }\n   * }\n   */\n  titleIcon?: ToolbarTitleIconOptions;\n  /**\n   * Background color of the browser\n   * @since 0.1.0\n   * @default BackgroundColor.BLACK\n   */\n  backgroundColor?: BackgroundColor;\n  /**\n   * If true, enables native navigation gestures within the webview.\n   * - Android: Native back button navigates within webview history\n   * - iOS: Enables swipe left/right gestures for back/forward navigation\n   * @default false (Android), true (iOS - enabled by default)\n   * @example\n   * activeNativeNavigationForWebview: true,\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  activeNativeNavigationForWebview?: boolean;\n\n  /**\n   * Enable pull-to-refresh (overscroll from top) to reload the current page.\n   * - iOS: Uses UIRefreshControl on the WebView scroll view (reload commits on finger release)\n   * - Android: Uses SwipeRefreshLayout around the WebView\n   *\n   * On iOS, this requires overscroll bounce. If `disableOverscroll` is `true`,\n   * the reload gesture will not work.\n   *\n   * @since 8.10.8\n   * @default false\n   * @example\n   * enableReloadGesture: true\n   */\n  enableReloadGesture?: boolean;\n  /**\n   * Disable the possibility to go back on native application,\n   * useful to force user to stay on the webview, Android only\n   * @default false\n   * @example\n   * disableGoBackOnNativeApplication: true\n   * Test URL: https://capgo.app\n   */\n  disableGoBackOnNativeApplication?: boolean;\n  /**\n   * Open url in a new window fullscreen\n   * isPresentAfterPageLoad: if true, the browser will be presented after the page is loaded, if false, the browser will be presented immediately.\n   * Promise timing: on Android, `openWebView()` resolves with the webview id when the webview is ready to be controlled\n   * (immediately for hidden/immediate presentation, after the first page load when `isPresentAfterPageLoad` is `true`).\n   * On iOS, the promise resolves with the id as soon as the native webview is created, even if presentation is deferred.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * isPresentAfterPageLoad: true,\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  isPresentAfterPageLoad?: boolean;\n  /**\n   * Whether the website in the webview is inspectable or not, ios only\n   * @default false\n   */\n  isInspectable?: boolean;\n  /**\n   * Whether the webview opening is animated or not, ios only\n   * @default true\n   */\n  isAnimated?: boolean;\n  /**\n   * Shows a reload button that reloads the web page\n   * @since 1.0.15\n   * @default false\n   * @example\n   * showReloadButton: true\n   * Test URL: https://capgo.app\n   */\n  showReloadButton?: boolean;\n  /**\n   * closeAction controls what happens when the native toolbar close button is pressed.\n   * This does not change the behavior of close(), JavaScript window.mobileApp.close(), or native back navigation.\n   *\n   * @default CloseAction.CLOSE\n   * @since 8.7.7\n   * @example\n   * closeAction: CloseAction.HIDE\n   */\n  closeAction?: CloseAction;\n  /**\n   * Captures the visible webview and includes it as `screenshot` in `hideEvent`\n   * before the toolbar close button hides the webview.\n   *\n   * Only applies when `closeAction` is `CloseAction.HIDE`.\n   *\n   * On iOS, capture uses `WKWebView.takeSnapshot`. When testing through Apple's\n   * iPhone Mirroring app with the physical device locked, the snapshot can succeed\n   * with the correct dimensions but a fully transparent PNG. Capture works as\n   * expected on a normal unlocked device. This appears to be an Apple mirroring\n   * limitation rather than a plugin bug.\n   *\n   * @default false\n   * @since 8.7.10\n   */\n  screenshotOnHide?: boolean;\n  /**\n   * CloseModal: if true a confirm will be displayed when user clicks on close button, if false the browser will be closed immediately.\n   * @since 1.1.0\n   * @default false\n   * @example\n   * closeModal: true,\n   * closeModalTitle: \"Close Window\",\n   * closeModalDescription: \"Are you sure you want to close?\",\n   * closeModalOk: \"Yes, close\",\n   * closeModalCancel: \"No, stay\"\n   * Test URL: https://capgo.app\n   */\n  closeModal?: boolean;\n  /**\n   * CloseModalTitle: title of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalTitle?: string;\n  /**\n   * CloseModalDescription: description of the confirm when user clicks on close button\n   * @since 1.1.0\n   * @default \"Are you sure you want to close this window?\"\n   */\n  closeModalDescription?: string;\n  /**\n   * CloseModalOk: text of the confirm button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Close\"\n   */\n  closeModalOk?: string;\n  /**\n   * CloseModalCancel: text of the cancel button when user clicks on close button\n   * @since 1.1.0\n   * @default \"Cancel\"\n   */\n  closeModalCancel?: string;\n  /**\n   * closeModalURLPattern: a regex pattern to match against the current URL when the close button is pressed.\n   * When provided along with closeModal: true, the close confirmation modal is only shown if the current URL matches this pattern.\n   * If the current URL does not match, the browser closes immediately without showing the modal.\n   * Requires closeModal to be true.\n   * @since 7.2.0\n   * @example\n   * closeModal: true,\n   * closeModalURLPattern: \".*checkout.*\"\n   */\n  closeModalURLPattern?: string;\n  /**\n   * visibleTitle: if true the website title would be shown else shown empty\n   * @since 1.2.5\n   * @default true\n   */\n  visibleTitle?: boolean;\n  /**\n   * toolbarColor: color of the toolbar in hex format\n   * @since 1.2.5\n   * @default \"#ffffff\"\n   * @example\n   * toolbarColor: \"#FF5733\"\n   * Test URL: https://capgo.app\n   */\n  toolbarColor?: string;\n  /**\n   * toolbarTextColor: color of the buttons and title in the toolbar in hex format\n   * When set, it overrides the automatic light/dark mode detection for text color\n   * @since 6.10.0\n   * @default calculated based on toolbarColor brightness\n   * @example\n   * toolbarTextColor: \"#FFFFFF\"\n   * Test URL: https://capgo.app\n   */\n  toolbarTextColor?: string;\n  /**\n   * showArrow: if true an arrow would be shown instead of cross for closing the window\n   * @since 1.2.5\n   * @default false\n   * @example\n   * showArrow: true\n   * Test URL: https://capgo.app\n   */\n  showArrow?: boolean;\n  /**\n   * ignoreUntrustedSSLError: if true, the webview will ignore untrusted SSL errors allowing the user to view the website.\n   * @since 6.1.0\n   * @default false\n   */\n  ignoreUntrustedSSLError?: boolean;\n  /**\n   * preShowScript: if isPresentAfterPageLoad is true and this variable is set the plugin will inject a script before showing the browser.\n   * This script will be run in an async context. The plugin will wait for the script to finish (max 10 seconds)\n   * @since 6.6.0\n   * @example\n   * preShowScript: \"await import('https://unpkg.com/darkreader@4.9.89/darkreader.js');\\nDarkReader.enable({ brightness: 100, contrast: 90, sepia: 10 });\"\n   * Test URL: https://capgo.app\n   */\n  preShowScript?: string;\n  /**\n   * preShowScriptInjectionTime: controls when the preShowScript is injected.\n   * - \"documentStart\": injects before any page JavaScript runs (good for polyfills like Firebase)\n   * - \"pageLoad\": injects after page load (default, original behavior)\n   * @since 7.26.0\n   * @default \"pageLoad\"\n   * @example\n   * preShowScriptInjectionTime: \"documentStart\"\n   */\n  preShowScriptInjectionTime?: 'documentStart' | 'pageLoad';\n  /**\n   * Proxy interception mode.\n   *\n   * - `true`: legacy blanket mode, delegates all HTTP/HTTPS requests to JavaScript.\n   * - `string`: Android-only regex mode kept for backward compatibility.\n   *\n   * Prefer `outboundProxyRules` and `inboundProxyRules` for native-first matching.\n   *\n   * @since 6.9.0\n   */\n  proxyRequests?: boolean | string;\n  /**\n   * Native-first outbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  outboundProxyRules?: NativeProxyRule[];\n  /**\n   * Native-first inbound proxy rules.\n   *\n   * @since 8.6.0\n   */\n  inboundProxyRules?: NativeProxyRule[];\n  /**\n   * buttonNearDone allows for a creation of a custom button near the done/close button.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * For Android:\n   * - iconType must be \"asset\"\n   * - icon path should be in the public folder (e.g. \"monkey.svg\")\n   * - width and height are optional, defaults to 48dp\n   * - button is positioned at the end of toolbar with 8dp margin\n   *\n   * For iOS:\n   * - iconType can be \"sf-symbol\" or \"asset\"\n   * - for sf-symbol, icon should be the symbol name\n   * - for asset, icon should be the asset name\n   * @since 6.7.0\n   * @example\n   * buttonNearDone: {\n   *   ios: {\n   *     iconType: \"sf-symbol\",\n   *     icon: \"star.fill\"\n   *   },\n   *   android: {\n   *     iconType: \"asset\",\n   *     icon: \"public/monkey.svg\",\n   *     width: 24,\n   *     height: 24\n   *   }\n   * }\n   * Test URL: https://capgo.app\n   */\n  buttonNearDone?: {\n    ios: {\n      iconType: 'sf-symbol' | 'asset';\n      icon: string;\n    };\n    android: {\n      iconType: 'asset' | 'vector';\n      icon: string;\n      width?: number;\n      height?: number;\n    };\n  };\n  /**\n   * Shows a native screenshot button near the done/close button.\n   * The button is hidden by default and captures the current viewport when tapped.\n   * This option uses the same toolbar slot as `buttonNearDone` and is therefore incompatible with it.\n   * The button is only shown when toolbarType is not \"activity\", \"navigation\", or \"blank\".\n   *\n   * @default false\n   * @since 8.4.0\n   */\n  showScreenshotButton?: boolean;\n  /**\n   * textZoom: sets the text zoom of the page in percent.\n   * Allows users to increase or decrease the text size for better readability.\n   * @since 7.6.0\n   * @default 100\n   * @example\n   * textZoom: 120\n   * Test URL: https://capgo.app\n   */\n  textZoom?: number;\n  /**\n   * enableZoom: enables pinch-to-zoom gestures in the Android WebView.\n   * When true, built-in zoom controls are enabled and the zoom buttons are hidden.\n   * **Android only** — ignored on iOS where zoom is enabled by default.\n   * @since 8.5.0\n   * @default false\n   * @example\n   * enableZoom: true\n   */\n  enableZoom?: boolean;\n  /**\n   * If true, deeplinks and external app hand-off are blocked and stay in the webview.\n   * If false (default), custom schemes such as `tel:`, `mailto:`, and `sms:` open natively.\n   * On iOS, listing a custom scheme under `LSApplicationQueriesSchemes` is only required when\n   * you rely on `canOpenURL` for that scheme (for example `instagram://`). It is not required\n   * for HTTPS `authorizedAppLinks`, and `mailto`/`tel`/`sms` open without that Info.plist entry.\n   * @since 0.1.0\n   * @default false\n   * @example\n   * preventDeeplink: true\n   * Test URL: https://aasa-tester.capgo.app/\n   */\n  preventDeeplink?: boolean;\n\n  /**\n   * When true, HTTP and HTTPS links opened from `target=\"_blank\"` anchors stay in the current webview instead of spawning a popup or opening in the system browser.\n   * By default, blank-target HTTP(S) links stay inside the plugin as managed popups that share cookies with the opener; enabling this option keeps everything in the same tab.\n   * Custom schemes such as `tel:` and `mailto:` and authorized app links still prefer their native handlers unless `preventDeeplink` is enabled.\n   *\n   * @since 8.5.6\n   * @default false\n   * @example\n   * openBlankTargetInWebView: true\n   */\n  openBlankTargetInWebView?: boolean;\n\n  /**\n   * List of base URLs whose hosts are treated as authorized App Links (Android) and Universal Links (iOS).\n   *\n   * - On both platforms, only HTTP(S) links whose host matches any entry in this list\n   *   will attempt to leave the in-app browser for the native / system handler.\n   * - iOS tries a Universal Link first (`universalLinksOnly`), then falls back to a normal\n   *   system open (App Store, Safari, etc.). Only if both fail does the URL stay in-webview.\n   * - Android uses an `ACTION_VIEW` intent for matching hosts.\n   * - Matching is host-based (case-insensitive), ignoring the \"www.\" prefix.\n   * - HTTPS hosts do not need `LSApplicationQueriesSchemes`; that Info.plist key is for\n   *   custom schemes like `instagram://`, not `https://instagram.com`.\n   * - When `preventDeeplink` is enabled, all external handling is blocked regardless of this list.\n   *\n   * @example\n   * ```ts\n   * [\"https://example.com\", \"https://instagram.com\", \"https://apps.apple.com\"]\n   * ```\n   *\n   * @since 7.12.0\n   * @default []\n   */\n  authorizedAppLinks?: string[];\n\n  /**\n   * If true, the webView will not take the full height and will have a 20px margin at the bottom.\n   * This creates a safe margin area outside the browser view.\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enabledSafeBottomMargin: true\n   */\n  enabledSafeBottomMargin?: boolean;\n\n  /**\n   * If false, the webView will extend behind the status bar for true full-screen immersive content.\n   * When true (default), respects the safe area at the top of the screen.\n   * Works independently of toolbarType - use for full-screen video players, games, or immersive web apps.\n   * @since 8.2.0\n   * @default true\n   * @example\n   * enabledSafeTopMargin: false  // Full screen, extends behind status bar\n   */\n  enabledSafeTopMargin?: boolean;\n\n  /**\n   * When true, applies the system status bar inset as the WebView top margin on Android.\n   * Keeps the legacy 0px margin by default for apps that handle padding themselves.\n   * @default false\n   * @example\n   * useTopInset: true\n   */\n  useTopInset?: boolean;\n\n  /**\n   * enableGooglePaySupport: if true, enables support for Google Pay popups and Payment Request API.\n   * This fixes OR_BIBED_15 errors by allowing popup windows and configuring Cross-Origin-Opener-Policy.\n   * Only enable this if you need Google Pay functionality as it allows popup windows.\n   *\n   * When enabled:\n   * - Allows popup windows for Google Pay authentication\n   * - Sets proper CORS headers for Payment Request API\n   * - Enables multiple window support in WebView\n   * - Configures secure context for payment processing\n   *\n   * @since 7.13.0\n   * @default false\n   * @example\n   * enableGooglePaySupport: true\n   * Test URL: https://developers.google.com/pay/api/web/guides/tutorial\n   */\n  enableGooglePaySupport?: boolean;\n\n  /**\n   * Opens popup windows created by the page in hidden mode.\n   * Hidden popup windows can still be controlled with `executeScript`, `postMessage`, `show`, and `close`.\n   * Listen to `popupWindowOpened` to capture the popup id, then call `show({ id })` only if you want to reveal it.\n   *\n   * @default false\n   * @since 8.6.0\n   * @example\n   * hiddenPopupWindow: true\n   */\n  hiddenPopupWindow?: boolean;\n\n  /**\n   * blockedHosts: List of host patterns that should be blocked from loading in the InAppBrowser's internal navigations.\n   * Any request inside WebView to a URL with a host matching any of these patterns will be blocked.\n   * Supports wildcard patterns like:\n   * - \"*.example.com\" to block all subdomains\n   * - \"www.example.*\" to block wildcard domain extensions\n   *\n   * @since 7.17.0\n   * @default []\n   * @example\n   * blockedHosts: [\"*.tracking.com\", \"ads.example.com\"]\n   */\n  blockedHosts?: string[];\n\n  /**\n   * Width of the webview in screen/window points.\n   * If not set, webview will be fullscreen width.\n   * @default undefined (fullscreen)\n   * @example\n   * width: 400\n   */\n  width?: number;\n\n  /**\n   * Height of the webview in screen/window points.\n   * Required for custom-sized (non-fullscreen) webviews.\n   * @default undefined (fullscreen)\n   * @example\n   * height: 600\n   */\n  height?: number;\n\n  /**\n   * X position of the webview in screen/window points from the left edge.\n   * Only effective when custom height is set.\n   * @default 0\n   * @example\n   * x: 50\n   */\n  x?: number;\n\n  /**\n   * Y position of the webview in screen/window points from the top edge.\n   * Only effective when custom height is set.\n   * @default 0\n   * @example\n   * y: 100\n   */\n  y?: number;\n\n  /**\n   * Places the native browser behind the Capacitor host WebView.\n   * Make the app background transparent to reveal it, or rely on `transparentBackground` to clear the host WebView.\n   *\n   * @default false\n   */\n  toBack?: boolean;\n\n  /**\n   * When `toBack` is true, makes the Capacitor host WebView transparent so the native browser can be seen behind Ionic content.\n   * Ignored when the browser is in front.\n   *\n   * @default true\n   */\n  transparentBackground?: boolean;\n\n  /**\n   * Disables the bounce (overscroll) effect on iOS WebView.\n   * When enabled, prevents the rubber band scrolling effect when users scroll beyond content boundaries.\n   * This is useful for:\n   * - Creating a more native, app-like experience\n   * - Preventing accidental overscroll states\n   * - Avoiding issues when keyboard opens/closes\n   *\n   * Note: This option only affects iOS. Android does not have this bounce effect by default.\n   *\n   * @since 8.0.2\n   * @default false\n   * @example\n   * disableOverscroll: true\n   */\n  disableOverscroll?: boolean;\n\n  /**\n   * Opens the webview in hidden mode (not visible to user but fully functional).\n   * When hidden, the webview loads and executes JavaScript but is not displayed.\n   * All control methods (executeScript, postMessage, setUrl, etc.) work while hidden.\n   * Use close() to clean up the hidden webview when done.\n   *\n   * @since 8.0.7\n   * @default false\n   * @example\n   * hidden: true\n   */\n  hidden?: boolean;\n\n  /**\n   * Controls how a hidden webview reports its visibility and size.\n   * - AWARE: webview is aware it's hidden (dimensions may be zero).\n   * - FAKE_VISIBLE: webview is hidden but reports fullscreen dimensions (uses alpha=0 to remain invisible).\n   *\n   * @default InvisibilityMode.AWARE\n   * @example\n   * invisibilityMode: InvisibilityMode.FAKE_VISIBLE\n   */\n  invisibilityMode?: InvisibilityMode;\n}\n\nexport interface DimensionOptions {\n  /**\n   * Width of the webview in pixels\n   */\n  width?: number;\n  /**\n   * Height of the webview in pixels\n   */\n  height?: number;\n  /**\n   * X position from the left edge in pixels\n   */\n  x?: number;\n  /**\n   * Y position from the top edge in pixels\n   */\n  y?: number;\n}\n\nexport interface InAppBrowserPlugin {\n  /**\n   * Navigates back in the WebView's history if possible\n   *\n   * @since 7.21.0\n   * @returns Promise that resolves with true if navigation was possible, false otherwise\n   */\n  goBack(options?: { id?: string }): Promise<{ canGoBack: boolean }>;\n\n  /**\n   * Open url in a new window fullscreen, on android it use chrome custom tabs, on ios it use SFSafariViewController\n   *\n   * @since 0.1.0\n   */\n  open(options: OpenOptions): Promise<any>;\n\n  /**\n   * Clear cookies of url\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 0.5.0\n   */\n  clearCookies(options: ClearCookieOptions): Promise<any>;\n  /**\n   * Clear all cookies\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearAllCookies(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear cache\n   * When `id` is omitted, applies to all open webviews.\n   *\n   * @since 6.5.0\n   */\n  clearCache(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Clear all browsing data from the default store and any opened managed webviews.\n   *\n   * This removes cookies, disk cache, memory cache, local storage, session storage, IndexedDB,\n   * WebSQL where supported, form data, and HTTP auth data where the platform exposes it.\n   *\n   * @since 8.6.36\n   */\n  clearAllBrowsingData(): Promise<any>;\n\n  /**\n   * Get cookies for a specific URL.\n   * @param options The options, including the URL to get cookies for.\n   * @returns A promise that resolves with the cookies.\n   */\n  getCookies(options: GetCookieOptions): Promise<Record<string, string>>;\n  /**\n   * Close the webview.\n   * When `id` is omitted, closes the active webview.\n   */\n  close(options?: CloseWebviewOptions): Promise<any>;\n  /**\n   * Hide the webview without closing it.\n   * Use show() to bring it back.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  hide(options?: { id?: string }): Promise<void>;\n  /**\n   * Show a previously hidden webview.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @since 8.0.8\n   */\n  show(options?: { id?: string }): Promise<void>;\n  /**\n   * Moves the native browser behind the Capacitor host WebView.\n   * Use `dispatchInputEvent()` to forward overlay gestures to the browser while it is behind the app UI.\n   */\n  sendToBack(options?: LayerOptions): Promise<void>;\n  /**\n   * Moves a browser that was behind the host WebView back to the front.\n   * On iOS, set `isAnimated` to `false` to skip the presentation animation.\n   * When `id` is omitted, targets the active webview.\n   */\n  bringToFront(options?: BringToFrontOptions): Promise<void>;\n  /**\n   * Dispatches a click, touch, or scroll event to a managed browser.\n   * Coordinates are relative to the browser viewport in CSS pixels.\n   */\n  dispatchInputEvent(options: DispatchInputEventOptions): Promise<void>;\n  /**\n   * Open url in a new webview with toolbars, and enhanced capabilities, like camera access, file access, listen events, inject javascript, bi directional communication, etc.\n   *\n   * JavaScript Interface:\n   * When you open a webview with this method, a JavaScript interface is automatically injected that provides:\n   * - `window.mobileApp.close()`: Closes the webview from JavaScript\n   * - `window.mobileApp.postMessage({detail: {message: \"myMessage\"}})`: Sends a message from the webview to the app, detail object is the data you want to send to the webview\n   * - `window.mobileApp.takeScreenshot()` when `allowScreenshotsFromWebPage` is true\n   *\n   * Promise timing differs by platform when `isPresentAfterPageLoad` is used.\n   * Android resolves with `{ id }` after the dialog is ready to control, while iOS resolves with `{ id }` immediately after creating the native webview.\n   *\n   * @returns Promise that resolves with the created webview id.\n   * @since 0.1.0\n   */\n  openWebView(options: OpenWebViewOptions): Promise<{ id: string }>;\n  /**\n   * Injects JavaScript code into the InAppBrowser window.\n   * When `id` is omitted, executes in all open webviews.\n   */\n  executeScript(options: { code: string; id?: string }): Promise<void>;\n  /**\n   * Sends an event to the webview(inappbrowser). you can listen to this event in the inappbrowser JS with window.addEventListener(\"messageFromNative\", listenerFunc: (event: Record<string, any>) => void)\n   * detail is the data you want to send to the webview, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, so no functions or other non-JSON-serializable types are allowed.\n   * When `id` is omitted, broadcasts to all open webviews.\n   */\n  postMessage(options: { detail: Record<string, any>; id?: string }): Promise<void>;\n  /**\n   * Captures the current webview viewport as a PNG screenshot.\n   * When `id` is omitted, targets the active webview.\n   *\n   * On iOS, when testing through Apple's iPhone Mirroring app with the physical\n   * device locked, the snapshot can succeed with the correct dimensions but a\n   * fully transparent PNG. Capture works as expected on a normal unlocked device.\n   */\n  takeScreenshot(options?: { id?: string }): Promise<ScreenshotResult>;\n  /**\n   * Sets the URL of the webview.\n   * When `id` is omitted, targets the active webview.\n   */\n  setUrl(options: { url: string; id?: string }): Promise<any>;\n  /**\n   * Listen for url change, only for openWebView\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'urlChangeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for buttonNearDone clicks.\n   *\n   * The event payload contains the webview `id`.\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'buttonNearDoneClick', listenerFunc: ButtonNearListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for close click only for openWebView\n   *\n   * @since 0.4.0\n   */\n  addListener(eventName: 'closeEvent', listenerFunc: UrlChangeListener): Promise<PluginListenerHandle>;\n  /**\n   * Listen for webviews hidden by the toolbar close button when closeAction is CloseAction.HIDE.\n   *\n   * @since 8.7.7\n   */\n  addListener(eventName: 'hideEvent', listenerFunc: HideListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when user clicks on confirm button when disclaimer is required,\n   * works with openWebView shareDisclaimer and closeModal\n   *\n   * @since 0.0.1\n   */\n  addListener(eventName: 'confirmBtnClicked', listenerFunc: ConfirmBtnListener): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when event is sent from webview(inappbrowser), to send an event to the main app use window.mobileApp.postMessage({ \"detail\": { \"message\": \"myMessage\" } })\n   * detail is the data you want to send to the main app, it's a requirement of Capacitor we cannot send direct objects\n   * Your object has to be serializable to JSON, no functions or other non-JSON-serializable types are allowed.\n   *\n   * This method is inject at runtime in the webview\n   */\n  addListener(\n    eventName: 'messageFromWebview',\n    listenerFunc: (event: { id?: string; detail?: Record<string, any>; rawMessage?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered whenever a screenshot is captured from the plugin API,\n   * the native screenshot button, or the injected JavaScript bridge.\n   */\n  addListener(\n    eventName: 'screenshotTaken',\n    listenerFunc: (event: ScreenshotResult & { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page is loaded\n   */\n  addListener(\n    eventName: 'browserPageLoaded',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when a main-frame page load starts (link navigation, reload, etc.).\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadStart',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered as a main-frame page load progresses.\n   * `progress` is a value from `0` to `1`.\n   *\n   * @since 8.11.0\n   */\n  addListener(\n    eventName: 'browserPageLoadProgress',\n    listenerFunc: (event: { id?: string; progress: number }) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Will be triggered when page load error\n   */\n  addListener(\n    eventName: 'pageLoadError',\n    listenerFunc: (event: { id?: string }) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when the webview intercepts a non-standard custom scheme\n   * and hands it to the operating system.\n   *\n   * Standard OS-handled schemes such as `tel:`, `mailto:`, and `sms:` are excluded.\n   *\n   * @since 8.6.7\n   */\n  addListener(\n    eventName: 'customSchemeIntercepted',\n    listenerFunc: CustomSchemeInterceptedListener,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered after native download handling saves a file locally.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadCompleted',\n    listenerFunc: (event: DownloadCompletedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered when native download handling fails.\n   * Enable this with `handleDownloads: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'downloadFailed',\n    listenerFunc: (event: DownloadFailedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Will be triggered whenever a page opens a popup/new window.\n   * Use the returned popup id with `executeScript`, `postMessage`, `show`, `hide`, and `close`.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'popupWindowOpened',\n    listenerFunc: (event: PopupWindowEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Listen for proxied requests delegated by the native runtime.\n   * Prefer `addProxyHandler()` instead of calling this directly.\n   *\n   * @since 8.6.0\n   */\n  addListener(eventName: 'proxyRequest', listenerFunc: (event: ProxyRequest) => void): Promise<PluginListenerHandle>;\n  /**\n   * Listen for JavaScript console output emitted by the managed page.\n   * Enable this with `captureConsoleLogs: true` when opening the webview.\n   *\n   * @since 8.6.0\n   */\n  addListener(\n    eventName: 'consoleMessage',\n    listenerFunc: (event: ConsoleMessageEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Internal method used by `addProxyHandler()` to send a proxy decision back to native.\n   * Forward the original `phase` when replying to a manual `proxyRequest` listener.\n   *\n   * @since 8.6.0\n   */\n  handleProxyRequest(options: {\n    requestId: string;\n    decision?: ProxyDecision | null;\n    response?: ProxyResponse | null;\n    webviewId?: string;\n    phase?: 'outbound' | 'inbound';\n  }): Promise<void>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>;\n\n  /**\n   * Reload the current web page.\n   *\n   * @since 1.0.0\n   */\n  reload(options?: { id?: string }): Promise<any>;\n\n  /**\n   * Update the dimensions of the webview.\n   * Allows changing the size and position of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   *\n   * @param options Dimension options (width, height, x, y)\n   * @returns Promise that resolves when dimensions are updated\n   */\n  updateDimensions(options: DimensionOptions & { id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe top margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeTopMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Sets the enabled safe bottom margin of the webview at runtime.\n   * When `id` is omitted, targets the active webview.\n   * On Web, this method is a no-op and resolves without changing layout.\n   */\n  setEnabledSafeBottomMargin(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Opens a secured window for OAuth2 authentication.\n   * For web, you should have the code in the redirected page to use a broadcast channel to send the redirected url to the app\n   * Something like:\n   * ```html\n   * <html>\n   * <head></head>\n   * <body>\n   * <script>\n   *   const searchParams = new URLSearchParams(location.search)\n   *   if (searchParams.has(\"code\")) {\n   *     new BroadcastChannel(\"my-channel-name\").postMessage(location.href);\n   *     window.close();\n   *   }\n   * </script>\n   * </body>\n   * </html>\n   * ```\n   * For mobile, you should have a redirect uri that opens the app, something like: `myapp://oauth_callback/`\n   * And make sure to register it in the app's info.plist:\n   * ```xml\n   * <key>CFBundleURLTypes</key>\n   * <array>\n   *    <dict>\n   *       <key>CFBundleURLSchemes</key>\n   *       <array>\n   *          <string>myapp</string>\n   *       </array>\n   *    </dict>\n   * </array>\n   * ```\n   * And in the AndroidManifest.xml file:\n   * ```xml\n   * <activity>\n   *    <intent-filter>\n   *       <action android:name=\"android.intent.action.VIEW\" />\n   *       <category android:name=\"android.intent.category.DEFAULT\" />\n   *       <category android:name=\"android.intent.category.BROWSABLE\" />\n   *       <data android:host=\"oauth_callback\" android:scheme=\"myapp\" />\n   *    </intent-filter>\n   * </activity>\n   * ```\n   * @param options - the options for the openSecureWindow call\n   */\n  openSecureWindow(options: OpenSecureWindowOptions): Promise<OpenSecureWindowResponse>;\n}\n\n/**\n * JavaScript APIs available in the InAppBrowser WebView.\n *\n * These APIs are automatically injected into all webpages loaded in the InAppBrowser WebView.\n *\n * @example\n * // Closing the webview from JavaScript\n * window.mobileApp.close();\n *\n * // Sending a message from webview to the native app\n * window.mobileApp.postMessage({ key: \"value\" });\n *\n * @since 6.10.0\n */\nexport interface InAppBrowserWebViewAPIs {\n  /**\n   * mobileApp - Global object injected into the WebView providing communication with the native app\n   */\n  mobileApp: {\n    /**\n     * Close the WebView from JavaScript\n     *\n     * @example\n     * // Add a button to close the webview\n     * const closeButton = document.createElement(\"button\");\n     * closeButton.textContent = \"Close WebView\";\n     * closeButton.addEventListener(\"click\", () => {\n     *   window.mobileApp.close();\n     * });\n     * document.body.appendChild(closeButton);\n     *\n     * @since 6.10.0\n     */\n    close(): void;\n\n    /**\n     * Send a message from the WebView to the native app\n     * The native app can listen for these messages with the \"messageFromWebview\" event\n     *\n     * @param message Object to send to the native app\n     * @example\n     * // Send data to native app\n     * window.mobileApp.postMessage({\n     *   action: \"dataSubmitted\",\n     *   data: { username: \"test\", email: \"test@example.com\" }\n     * });\n     *\n     * @since 6.10.0\n     */\n    postMessage(message: Record<string, any>): void;\n\n    /**\n     * Hide the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    hide(): void;\n\n    /**\n     * Show the WebView from JavaScript (requires allowWebViewJsVisibilityControl: true in CapacitorConfig)\n     *\n     * @since 8.0.8\n     */\n    show(): void;\n\n    /**\n     * Capture the current WebView viewport as a PNG screenshot.\n     * Requires `allowScreenshotsFromWebPage` to be enabled when opening the webview.\n     *\n     * @since 8.4.0\n     */\n    takeScreenshot(): Promise<ScreenshotResult>;\n  };\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ id: string }>} an Promise with version for this device\n   * @throws An error if the something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n}\n"]}

package/ios/Sources/InAppBrowserPlugin/InAppBrowserPlugin.swift

@@ -154,14 +154,16 @@ enum StatusBarBackgroundLayoutSupport {
         case host(pinToNavigationBar: Bool)
     }
 
-    /// Decide where/how to pin the status-bar chrome without painting a PassThroughView gap.
+    /// Decide where/how to pin the status-bar chrome without painting a custom-frame gap.
     static func placement(
         isPassThroughOverlay: Bool,
         blankNavigationTab: Bool,
-        navigationBarInHostHierarchy: Bool
+        navigationBarInHostHierarchy: Bool,
+        isFramedCustomOverlay: Bool = false
     ) -> Placement {
-        if isPassThroughOverlay && blankNavigationTab {
-            // Custom-frame blank overlays must stay transparent in the y-offset gap.
+        // Pre-#629 custom frames used PassThroughView; #629 switched front frames to child
+        // overlays. Both must skip blank status-bar chrome so y/height stay screen-accurate.
+        if (isPassThroughOverlay || isFramedCustomOverlay) && blankNavigationTab {
             return .skip
         }
 
@@ -184,6 +186,7 @@ enum StatusBarBackgroundLayoutSupport {
 }
 
 enum CustomWebViewFrameSupport {
+    /// Resolve openWebView width/height/x/y in screen/window points (Android window attrs).
     static func resolvedFrame(
         width: CGFloat?,
         height: CGFloat?,
@@ -202,6 +205,88 @@ enum CustomWebViewFrameSupport {
             height: height
         )
     }
+
+    static func screenSize(for view: UIView?) -> CGSize {
+        if let window = view?.window {
+            return window.bounds.size
+        }
+        return UIScreen.main.bounds.size
+    }
+
+    static func hostOriginInScreen(for host: UIView) -> CGPoint {
+        if let window = host.window {
+            return host.convert(.zero, to: window)
+        }
+        // Outside a window (unit tests / early layout): treat frame.origin as screen-space.
+        return host.frame.origin
+    }
+
+    /// Convert a screen-space custom frame into the host view's coordinate space.
+    static func frameInHost(
+        width: CGFloat?,
+        height: CGFloat?,
+        x positionX: CGFloat?,
+        y positionY: CGFloat?,
+        screenSize: CGSize,
+        hostOriginInScreen: CGPoint
+    ) -> CGRect? {
+        guard let screenFrame = resolvedFrame(
+            width: width,
+            height: height,
+            x: positionX,
+            y: positionY,
+            fallbackSize: screenSize
+        ) else {
+            return nil
+        }
+
+        return CGRect(
+            x: screenFrame.origin.x - hostOriginInScreen.x,
+            y: screenFrame.origin.y - hostOriginInScreen.y,
+            width: screenFrame.width,
+            height: screenFrame.height
+        )
+    }
+}
+
+enum ReloadGestureSupport {
+    /// UIRefreshControl may fire valueChanged while the finger is still down.
+    /// Match browser UX: commit reload only after touch end.
+    static func shouldDeferReloadUntilTouchEnd(isTracking: Bool, isDragging: Bool) -> Bool {
+        isTracking || isDragging
+    }
+
+    /// Pull distance below the resting top (adjusted inset). Positive when overscrolling down.
+    static func pullDistance(contentOffsetY: CGFloat, adjustedContentInsetTop: CGFloat) -> CGFloat {
+        max(0, -(contentOffsetY + adjustedContentInsetTop))
+    }
+
+    /// After intentional touch end, reload only if still near the activation pull distance
+    /// captured when UIRefreshControl fired `.valueChanged` (not a fixed constant).
+    static func shouldReloadOnTouchEnd(
+        pendingReload: Bool,
+        currentPullDistance: CGFloat,
+        armedPullDistance: CGFloat
+    ) -> Bool {
+        guard pendingReload, armedPullDistance > 0 else { return false }
+        // Allow slight finger jitter below the exact activation point.
+        return currentPullDistance >= armedPullDistance * 0.9
+    }
+
+    /// Resting offset for the current adjusted top inset (safe-area aware).
+    /// - forceToRestingTop: after gesture reload, always snap to resting top (fixes clipped header).
+    ///   Otherwise only un-overscroll after a cancelled pull.
+    static func contentOffsetYAfterReloadReset(
+        currentY: CGFloat,
+        adjustedContentInsetTop: CGFloat,
+        forceToRestingTop: Bool = false
+    ) -> CGFloat {
+        let restingY = -adjustedContentInsetTop
+        if forceToRestingTop {
+            return restingY
+        }
+        return currentY < restingY ? restingY : currentY
+    }
 }
 
 extension UIColor {
@@ -230,7 +315,7 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
         case aware = "AWARE"
         case fakeVisible = "FAKE_VISIBLE"
     }
-    private let pluginVersion: String = "8.12.1"
+    private let pluginVersion: String = "8.12.2"
     public let identifier = "CapgoInAppBrowserPlugin"
     public let jsName = "CapgoInAppBrowser"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -2575,14 +2660,16 @@ extension CapgoInAppBrowserPlugin: SFSafariViewControllerDelegate {
 
 
 extension CapgoInAppBrowserPlugin {
-    private func targetFrame(for webViewController: WKWebViewController, in hostWebView: UIView) -> CGRect {
-        return CustomWebViewFrameSupport.resolvedFrame(
+    private func targetFrame(for webViewController: WKWebViewController, in hostView: UIView) -> CGRect {
+        // Keep pre-#629 screen-space semantics, then convert into the host's coordinates.
+        return CustomWebViewFrameSupport.frameInHost(
             width: webViewController.customWidth,
             height: webViewController.customHeight,
             x: webViewController.customX,
             y: webViewController.customY,
-            fallbackSize: hostWebView.bounds.size
-        ) ?? hostWebView.bounds
+            screenSize: CustomWebViewFrameSupport.screenSize(for: hostView),
+            hostOriginInScreen: CustomWebViewFrameSupport.hostOriginInScreen(for: hostView)
+        ) ?? hostView.bounds
     }
 
     @discardableResult
@@ -2661,6 +2748,7 @@ extension CapgoInAppBrowserPlugin {
 
         navigationController.view.frame = frame
         navigationController.view.autoresizingMask = []
+        navigationController.view.clipsToBounds = true
         navigationController.view.isUserInteractionEnabled = true
         parent.view.bringSubviewToFront(navigationController.view)
         navigationController.view.setNeedsLayout()

package/ios/Sources/InAppBrowserPlugin/WKWebViewController+ReloadGesture.swift

@@ -0,0 +1,156 @@
+import UIKit
+import WebKit
+
+extension WKWebViewController {
+    func configureReloadGesture(for targetWebView: WKWebView) {
+        if let existing = targetWebView.scrollView.refreshControl {
+            existing.endRefreshing()
+            existing.removeTarget(nil, action: nil, for: .allEvents)
+            targetWebView.scrollView.refreshControl = nil
+        }
+
+        guard enableReloadGesture, !disableOverscroll else {
+            pendingReloadFromGesture = false
+            reloadGestureArmedPullDistance = 0
+            return
+        }
+
+        targetWebView.scrollView.alwaysBounceVertical = true
+        let refreshControl = UIRefreshControl()
+        refreshControl.addTarget(self, action: #selector(handleReloadGesture(_:)), for: .valueChanged)
+        targetWebView.scrollView.refreshControl = refreshControl
+
+        if !reloadPanObserverInstalled {
+            targetWebView.scrollView.panGestureRecognizer.addTarget(
+                self,
+                action: #selector(handleReloadPanGesture(_:))
+            )
+            reloadPanObserverInstalled = true
+        }
+    }
+
+    @objc func handleReloadGesture(_: UIRefreshControl) {
+        guard let scrollView = self.capableWebView?.scrollView else {
+            performReloadFromGesture()
+            return
+        }
+
+        // Defer until finger leaves so a pull past threshold then cancel does not reload.
+        if ReloadGestureSupport.shouldDeferReloadUntilTouchEnd(
+            isTracking: scrollView.isTracking,
+            isDragging: scrollView.isDragging
+        ) {
+            pendingReloadFromGesture = true
+            // Capture the real activation pull distance from UIRefreshControl.
+            reloadGestureArmedPullDistance = ReloadGestureSupport.pullDistance(
+                contentOffsetY: scrollView.contentOffset.y,
+                adjustedContentInsetTop: scrollView.adjustedContentInset.top
+            )
+            return
+        }
+
+        performReloadFromGesture()
+    }
+
+    @objc func handleReloadPanGesture(_ gesture: UIPanGestureRecognizer) {
+        guard enableReloadGesture else { return }
+        guard let scrollView = self.capableWebView?.scrollView else { return }
+
+        switch gesture.state {
+        case .ended:
+            let pullDistance = ReloadGestureSupport.pullDistance(
+                contentOffsetY: scrollView.contentOffset.y,
+                adjustedContentInsetTop: scrollView.adjustedContentInset.top
+            )
+            let shouldReload = ReloadGestureSupport.shouldReloadOnTouchEnd(
+                pendingReload: pendingReloadFromGesture,
+                currentPullDistance: pullDistance,
+                armedPullDistance: reloadGestureArmedPullDistance
+            )
+            pendingReloadFromGesture = false
+            reloadGestureArmedPullDistance = 0
+
+            if shouldReload {
+                performReloadFromGesture()
+            } else if !reloadFromGestureInProgress,
+                      scrollView.refreshControl?.isRefreshing == true {
+                scrollView.refreshControl?.endRefreshing()
+                resetReloadGestureScrollState(on: scrollView, forceToRestingTop: false)
+            }
+
+        case .cancelled, .failed:
+            // System interruption — never commit a reload.
+            pendingReloadFromGesture = false
+            reloadGestureArmedPullDistance = 0
+            // Don't touch an in-flight gesture reload's spinner / scroll.
+            guard !reloadFromGestureInProgress else { break }
+            if scrollView.refreshControl?.isRefreshing == true {
+                scrollView.refreshControl?.endRefreshing()
+                resetReloadGestureScrollState(on: scrollView, forceToRestingTop: false)
+            }
+
+        default:
+            break
+        }
+    }
+
+    private func performReloadFromGesture() {
+        pendingReloadFromGesture = false
+        reloadGestureArmedPullDistance = 0
+        reloadFromGestureInProgress = true
+        // Track this navigation so cancelled prior loads don't clear gesture state early.
+        reloadGestureNavigation = self.capableWebView?.reload()
+        if reloadGestureNavigation == nil {
+            stopReloadGesture()
+        }
+    }
+
+    private func resetReloadGestureScrollState(on scrollView: UIScrollView, forceToRestingTop: Bool) {
+        let resetY = ReloadGestureSupport.contentOffsetYAfterReloadReset(
+            currentY: scrollView.contentOffset.y,
+            adjustedContentInsetTop: scrollView.adjustedContentInset.top,
+            forceToRestingTop: forceToRestingTop
+        )
+        if resetY != scrollView.contentOffset.y {
+            scrollView.setContentOffset(CGPoint(x: scrollView.contentOffset.x, y: resetY), animated: false)
+        }
+    }
+
+    func stopReloadGesture(for navigation: WKNavigation? = nil) {
+        pendingReloadFromGesture = false
+
+        // Ignore unrelated navigation callbacks while a gesture reload is in flight.
+        if reloadFromGestureInProgress,
+           let expected = reloadGestureNavigation,
+           let navigation,
+           expected !== navigation {
+            return
+        }
+
+        let shouldResetScroll = reloadFromGestureInProgress
+        reloadFromGestureInProgress = false
+        reloadGestureNavigation = nil
+        reloadGestureArmedPullDistance = 0
+
+        guard let activeWebView = self.capableWebView else { return }
+        let scrollView = activeWebView.scrollView
+        scrollView.refreshControl?.endRefreshing()
+
+        guard shouldResetScroll else { return }
+
+        // UIRefreshControl + WKWebView.reload() often leave offset at 0 instead of
+        // -adjustedContentInset.top (clips header ~safe-area) and block the next pull.
+        DispatchQueue.main.async { [weak self] in
+            guard let self, let activeWebView = self.capableWebView else { return }
+            let scrollView = activeWebView.scrollView
+            scrollView.refreshControl?.endRefreshing()
+            self.resetReloadGestureScrollState(on: scrollView, forceToRestingTop: true)
+            self.configureReloadGesture(for: activeWebView)
+            // Rebind can change adjusted insets; snap again to the new resting top.
+            self.resetReloadGestureScrollState(
+                on: activeWebView.scrollView,
+                forceToRestingTop: true
+            )
+        }
+    }
+}

package/ios/Sources/InAppBrowserPlugin/WKWebViewController.swift

@@ -472,6 +472,11 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
     var authorizedAppLinks: [String] = []
     var activeNativeNavigationForWebview: Bool = true
     var enableReloadGesture: Bool = false
+    var pendingReloadFromGesture = false
+    var reloadFromGestureInProgress = false
+    var reloadGestureNavigation: WKNavigation?
+    var reloadGestureArmedPullDistance: CGFloat = 0
+    var reloadPanObserverInstalled = false
     var disableOverscroll: Bool = false
     var proxyRequests: Bool = false
     var proxySchemeHandler: ProxySchemeHandler?
@@ -1206,7 +1211,8 @@ open class WKWebViewController: UIViewController, WKScriptMessageHandler {
         let placement = StatusBarBackgroundLayoutSupport.placement(
             isPassThroughOverlay: navController.view is PassThroughView,
             blankNavigationTab: blankNavigationTab,
-            navigationBarInHostHierarchy: navigationBarInHost
+            navigationBarInHostHierarchy: navigationBarInHost,
+            isFramedCustomOverlay: shouldPresentAsFramedOverlay
         )
 
         guard case .host(let pinToNavigationBar) = placement,
@@ -2561,36 +2567,20 @@ public extension WKWebViewController {
         self.webView?.allowsBackForwardNavigationGestures = self.activeNativeNavigationForWebview
     }
 
-    private func configureReloadGesture(for webView: WKWebView) {
-        if let existing = webView.scrollView.refreshControl {
-            existing.endRefreshing()
-            existing.removeTarget(nil, action: nil, for: .allEvents)
-            webView.scrollView.refreshControl = nil
-        }
-
-        guard enableReloadGesture, !disableOverscroll else {
-            return
-        }
-
-        webView.scrollView.alwaysBounceVertical = true
-        let refreshControl = UIRefreshControl()
-        refreshControl.addTarget(self, action: #selector(handleReloadGesture(_:)), for: .valueChanged)
-        webView.scrollView.refreshControl = refreshControl
-    }
-
-    @objc private func handleReloadGesture(_ sender: UIRefreshControl) {
-        reload()
-    }
-
-    private func stopReloadGesture() {
-        webView?.scrollView.refreshControl?.endRefreshing()
-    }
-
     func cleanupWebView() {
         guard let webView = self.webView else { return }
         webView.stopLoading()
         previewItemURL = nil
 
+        if reloadPanObserverInstalled {
+            webView.scrollView.panGestureRecognizer.removeTarget(self, action: #selector(handleReloadPanGesture(_:)))
+            reloadPanObserverInstalled = false
+        }
+        pendingReloadFromGesture = false
+        reloadFromGestureInProgress = false
+        reloadGestureNavigation = nil
+        reloadGestureArmedPullDistance = 0
+
         // Remove KVO observers FIRST, before any operation that could trigger them
         webView.removeObserver(self, forKeyPath: estimatedProgressKeyPath)
         if websiteTitleInNavigationBar {
@@ -3536,7 +3526,7 @@ extension WKWebViewController: WKNavigationDelegate {
         lastInjectedSafeAreaInsets = nil
         syncWebViewSafeAreaLayout()
         emit("browserPageLoaded")
-        stopReloadGesture()
+        stopReloadGesture(for: navigation)
     }
 
     public func webView(_ webView: WKWebView, didFailProvisionalNavigation navigation: WKNavigation!, withError error: Error) {
@@ -3546,7 +3536,7 @@ extension WKWebViewController: WKNavigationDelegate {
             self.url = url
             delegate?.webViewController?(self, didFail: url, withError: error)
         }
-        stopReloadGesture()
+        stopReloadGesture(for: navigation)
         emit("pageLoadError")
     }
 
@@ -3557,7 +3547,7 @@ extension WKWebViewController: WKNavigationDelegate {
             self.url = url
             delegate?.webViewController?(self, didFail: url, withError: error)
         }
-        stopReloadGesture()
+        stopReloadGesture(for: navigation)
         emit("pageLoadError")
     }
 
@@ -3695,33 +3685,47 @@ extension WKWebViewController: WKNavigationDelegate {
 
     // MARK: - Dimension Management
 
-    /// Apply custom dimensions to the view if specified
     func applyCustomDimensions() {
         guard let navigationController = navigationController else {
             return
         }
 
-        let fallbackSize = navigationController.view.superview?.bounds.size ?? UIScreen.main.bounds.size
-        guard let targetFrame = CustomWebViewFrameSupport.resolvedFrame(
+        let hostView = navigationController.view.superview
+        let screenSize = CustomWebViewFrameSupport.screenSize(for: hostView ?? navigationController.view)
+        guard let screenFrame = CustomWebViewFrameSupport.resolvedFrame(
             width: customWidth,
             height: customHeight,
             x: customX,
             y: customY,
-            fallbackSize: fallbackSize
+            fallbackSize: screenSize
         ) else {
             return
         }
 
         if let passThroughView = navigationController.view as? PassThroughView {
-            passThroughView.targetFrame = targetFrame
+            // PassThroughView is full-screen; content stays in screen-space coordinates.
+            passThroughView.targetFrame = screenFrame
             let contentView = passThroughView.framedContentView ?? passThroughView.subviews.first
-            contentView?.frame = targetFrame
+            contentView?.frame = screenFrame
             contentView?.setNeedsLayout()
             contentView?.layoutIfNeeded()
             passThroughView.setNeedsLayout()
             passThroughView.layoutIfNeeded()
+        } else if let hostView {
+            let frameInHost = CustomWebViewFrameSupport.frameInHost(
+                width: customWidth,
+                height: customHeight,
+                x: customX,
+                y: customY,
+                screenSize: screenSize,
+                hostOriginInScreen: CustomWebViewFrameSupport.hostOriginInScreen(for: hostView)
+            ) ?? screenFrame
+            navigationController.view.frame = frameInHost
+            navigationController.view.clipsToBounds = true
+            navigationController.view.setNeedsLayout()
+            navigationController.view.layoutIfNeeded()
         } else {
-            navigationController.view.frame = targetFrame
+            navigationController.view.frame = screenFrame
             navigationController.view.setNeedsLayout()
             navigationController.view.layoutIfNeeded()
         }

package/package.json

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