@capgo/capacitor-inappbrowser 8.21.1 → 8.22.0

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AA2EA,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;AASD,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B;;OAEG;IACH,sCAAe,CAAA;IACf;;OAEG;IACH,kCAAW,CAAA;AACb,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B","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/** A change to host-controlled fullscreen; independent of HTML/video fullscreen. */\nexport interface FullscreenChangeEvent {\n  /** Webview instance id. */\n  id: string;\n  /** Whether fullscreen is currently applied to the visible webview. */\n  enabled: boolean;\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\n/**\n * Web content rendering mode for managed WKWebViews on iOS.\n *\n * @since 8.18.0\n */\nexport type PreferredContentMode = 'recommended' | 'mobile' | 'desktop';\n\nexport enum CloseButtonPosition {\n  /**\n   * Leading edge of the toolbar (left in left-to-right layouts).\n   */\n  START = 'start',\n  /**\n   * Trailing edge of the toolbar (right in left-to-right layouts).\n   */\n  END = 'end',\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' | 'wallet';\n\n/**\n * Where managed downloads are previewed after saving.\n *\n * @since 8.19.0\n */\nexport type DownloadPreview = 'inAppBrowser' | 'systemPreview';\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   *\n   * Remote `http://` and `https://` URLs are loaded as-is. Relative bundled paths\n   * such as `/index.html` are not supported; use `openWebView()` instead.\n   *\n   * @since 0.1.0\n   * @example \"https://capgo.app\"\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   * Present this webview in immersive fullscreen from its first visible frame.\n   * Hides native navigation and system bars and provides a native exit-fullscreen button.\n   * The same webview, page state, cookies, and history are retained on entry and exit.\n   * Exiting restores the configured toolbar and safe-area settings.\n   *\n   * Applies before presentation, including when `isPresentAfterPageLoad` is true.\n   * With `hidden: true`, waits for the first `show()` without changing the host's system bars.\n   * Subsequent hide/show or background/resume cycles do not re-enter fullscreen automatically.\n   * Only supported on iOS and Android for full-size, frontmost `openWebView` presentations.\n   * Custom dimensions and `toBack: true` are unsupported. The Web implementation rejects `true`.\n   * Permission prompts, if needed, are the host application's responsibility.\n   *\n   * @default false\n   * @example\n   * fullscreen: true,\n   * toolbarType: ToolBarType.NAVIGATION // Restored when the user exits fullscreen\n   */\n  fullscreen?: boolean;\n  /**\n   * Target URL to load.\n   *\n   * Remote `http://` and `https://` URLs are loaded as-is.\n   *\n   * To open bundled web assets from the app bundle without running a local HTTP server,\n   * pass a relative path such as `/index.html` or `assets/page.html`. The plugin resolves it to\n   * the Capacitor local URL for the current platform (defaults: `capacitor://localhost/...` on iOS,\n   * `https://localhost/...` on Android; actual scheme and host follow the app's configured Capacitor\n   * local URL) and serves files from the packaged `public/` directory, or `www/` on iOS when `public/`\n   * is absent.\n   *\n   * @since 0.1.0\n   * @since 8.15.0 Relative bundled paths (`/index.html`, `assets/page.html`) are supported.\n   * @example \"https://capgo.app\"\n   * @example \"/index.html\"\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   * Custom User-Agent string for the webview.\n   *\n   * When set, replaces the system default webview User-Agent on iOS and Android.\n   * Takes precedence over a `User-Agent` entry in `headers`.\n   *\n   * @since 8.13.0\n   * @example\n   * customUserAgent: \"MyApp/1.0 (Capacitor)\"\n   * Test URL: https://www.whatismybrowser.com/detect/what-is-my-user-agent/\n   */\n  customUserAgent?: string;\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   * database storage where the system WebView supports it while keeping DOM storage available so\n   * SPAs can use `localStorage`. Android cookies use the shared WebView cookie store; clearing them\n   * also affects the host WebView, so prefer per-URL cookie helpers instead of relying on\n   * process-global wipes.\n   *\n   * @default true\n   * @since 8.6.36\n   */\n  persistWebViewData?: boolean;\n  /**\n   * Clear all cookies from the InAppBrowser data store before the first navigation of this webview.\n   *\n   * Cordova `clearcache: 'yes'` parity. On Android, uses process-global `CookieManager.removeAllCookies()`\n   * and starts the first navigation after the wipe callback (does not block the UI thread). On iOS, clears\n   * cookies from the webview's `WKWebsiteDataStore` (isolated plugin store by default). On Web this is a no-op.\n   *\n   * @default false\n   * @since 8.16.0\n   */\n  clearCookiesOnOpen?: boolean;\n  /**\n   * Clear cached website data before the first navigation of this webview.\n   *\n   * Cordova `cleardata: 'yes'` parity. On Android, calls `WebView.clearCache(true)` after the webview\n   * is created. On iOS, removes disk and memory cache from the webview's `WKWebsiteDataStore`.\n   * On Web this is a no-op.\n   *\n   * @default false\n   * @since 8.16.0\n   */\n  clearCacheOnOpen?: boolean;\n  /**\n   * Share the host Capacitor WebView's website data store (cookies, local storage, etc.).\n   *\n   * On iOS 17+, InAppBrowser uses an isolated plugin-owned `WKWebsiteDataStore` by default so host\n   * and browser data stay separate. Set this to `true` to use `WKWebsiteDataStore.default()` instead,\n   * which shares session cookies with the Capacitor host WebView. Useful for SSO / OIDC silent login\n   * when the IdP session was established in the main app WebView.\n   *\n   * Requires `persistWebViewData: true` (the default). When `persistWebViewData` is false, a\n   * non-persistent store is used and this option has no effect.\n   *\n   * On Android this is a no-op: cookies are already process-global via `CookieManager`.\n   * On Web this is a no-op.\n   *\n   * Warning: clearing cookies/cache for a webview opened with this flag can affect the host WebView\n   * on iOS, because both share the same store. `clearAllBrowsingData()` still skips the host store.\n   *\n   * @default false\n   * @since 8.13.6\n   */\n  useSharedDataStore?: 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 (see `downloadPreview`).\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   * Opens managed Apple Wallet pass downloads (`.pkpass`) in the Wallet add-pass sheet\n   * instead of the download preview.\n   *\n   * Falls back to the regular download preview when the device can't add passes. An invalid pass\n   * emits `downloadFailed`. A shown sheet emits `downloadCompleted` with `handledBy: 'wallet'`.\n   *\n   * Requires `handleDownloads: true`. iOS only; ignored on Android.\n   *\n   * @default false\n   * @since 8.21.0\n   */\n  openWalletPasses?: boolean;\n  /**\n   * Controls where managed downloads are previewed after saving.\n   *\n   * - `'inAppBrowser'` (default): Reopens previewable files (PDF, images, text, JSON) inside the same webview.\n   * - `'systemPreview'`: Opens the system Quick Look preview with share and Save to Files actions. iOS only; ignored on Android.\n   *\n   * Requires `handleDownloads: true`.\n   *\n   * @default \"inAppBrowser\"\n   * @since 8.19.0\n   */\n  downloadPreview?: DownloadPreview;\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   * Web content rendering mode for the managed WKWebView.\n   *\n   * Controls whether pages load with mobile or desktop layout on iPad.\n   * Matches Capacitor's `ios.preferredContentMode` behavior.\n   *\n   * Resolution order when opening a webview:\n   * 1. This per-open value\n   * 2. Plugin config `plugins.CapgoInAppBrowser.preferredContentMode`\n   * 3. Legacy plugin config `plugins.InAppBrowser.preferredContentMode`\n   * 4. Capacitor config `ios.preferredContentMode`\n   *\n   * When unset at all levels, the system default applies (device-recommended).\n   *\n   * **iOS only** — ignored on Android and Web.\n   *\n   * @since 8.18.0\n   * @example\n   * preferredContentMode: \"mobile\"\n   */\n  preferredContentMode?: PreferredContentMode;\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   * Where the native toolbar close button is placed.\n   *\n   * When omitted, each platform keeps its convention: Android places the close button at the\n   * start, iOS at the end (or at the start when `showArrow` is true). Setting this option\n   * overrides that placement on both platforms.\n   *\n   * @since 8.17.0\n   * @example\n   * closeButtonPosition: CloseButtonPosition.END\n   */\n  closeButtonPosition?: CloseButtonPosition;\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 is inset by the bottom system bar (navigation bar) so bottom-anchored\n   * content stays reachable. When false (default), the webView can extend behind the navigation bar\n   * and apps can use `env(safe-area-inset-*)` for layout, matching the main Capacitor WebView.\n   * On pre-API 30 devices with a transparent navigation bar, bottom padding may still be applied\n   * when the window lays out behind the navigation bar regardless of this option.\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   * On Android, when a toolbar is visible the toolbar itself provides that safe area; with\n   * `toolbarType: 'blank'` on Android 15+ the status bar inset is applied to the webView instead.\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 to the top of the WebView on Android even when\n   * the window is not edge-to-edge (before Android 15). Keeps the legacy 0px inset by default for\n   * apps that handle padding themselves. On Android 15+ this is not needed: without a visible\n   * toolbar the status bar inset already follows `enabledSafeTopMargin`.\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 InAppBrowser-managed webviews and the plugin-owned data store.\n   *\n   * This removes cookies, disk cache, memory cache, local storage, session storage, IndexedDB,\n   * WebSQL where supported, form data, and HTTP auth data for InAppBrowser only.\n   *\n   * It does **not** clear the Capacitor/Ionic host WebView stores. On iOS 17+, InAppBrowser uses a\n   * dedicated persistent `WKWebsiteDataStore` so host and browser data stay isolated (unless\n   * `useSharedDataStore: true` was set on `openWebView`). On Android, process-global `CookieManager`\n   * / `WebStorage` are shared with the host WebView and are not wiped by this method; open managed\n   * WebViews still clear per-view cache/history and page storage.\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 applied fullscreen changes, including startup entry, the native exit button,\n   * Android Back, and native lifecycle cleanup. Register before opening to observe startup entry.\n   * Repeated requests for the current state do not emit duplicate events.\n   * This event describes host-controlled fullscreen, not HTML/video fullscreen.\n   */\n  addListener(\n    eventName: 'fullscreenChange',\n    listenerFunc: (event: FullscreenChangeEvent) => void,\n  ): 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   * Enter or exit immersive fullscreen without recreating or reloading the webview.\n   * When `id` is omitted, targets the active webview. Repeated calls are idempotent.\n   * Entry requires a visible, frontmost, full-size `openWebView` on iOS or Android.\n   * Missing webviews, invalid arguments, custom dimensions, behind-host presentations,\n   * and the Web platform reject. Use the opening `fullscreen` option for an initially hidden webview.\n   * Disabling also cancels any pending fullscreen-at-launch request.\n   *\n   * Native exit controls, backgrounding, hiding, closing, cross-origin navigation, and renderer\n   * termination restore the original chrome even when host JavaScript cannot respond.\n   */\n  setFullscreen(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Read the applied host-controlled fullscreen state of an `openWebView`.\n   * When `id` is omitted, targets the active webview. Initially hidden fullscreen webviews\n   * report `false` until their first presentation. Missing webviews and Web usage reject.\n   * HTML/video fullscreen does not change this value.\n   */\n  getFullscreen(options?: { id?: string }): Promise<{ enabled: boolean }>;\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   *\n   * On web, the redirect page should post the final URL to a `BroadcastChannel` and close itself.\n   * On mobile, register a custom redirect URI scheme (for example `myapp://oauth_callback/`) in Info.plist and AndroidManifest.xml.\n   * See the README section \"openSecureWindow (OAuth)\" for full setup examples.\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":"AA2EA,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;AASD,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B;;OAEG;IACH,sCAAe,CAAA;IACf;;OAEG;IACH,kCAAW,CAAA;AACb,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B","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/** A change to host-controlled fullscreen; independent of HTML/video fullscreen. */\nexport interface FullscreenChangeEvent {\n  /** Webview instance id. */\n  id: string;\n  /** Whether fullscreen is currently applied to the visible webview. */\n  enabled: boolean;\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\n/**\n * Web content rendering mode for managed WKWebViews on iOS.\n *\n * @since 8.18.0\n */\nexport type PreferredContentMode = 'recommended' | 'mobile' | 'desktop';\n\nexport enum CloseButtonPosition {\n  /**\n   * Leading edge of the toolbar (left in left-to-right layouts).\n   */\n  START = 'start',\n  /**\n   * Trailing edge of the toolbar (right in left-to-right layouts).\n   */\n  END = 'end',\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' | 'wallet';\n\n/**\n * Where managed downloads are previewed after saving.\n *\n * @since 8.19.0\n */\nexport type DownloadPreview = 'inAppBrowser' | 'systemPreview';\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   *\n   * Remote `http://` and `https://` URLs are loaded as-is. Relative bundled paths\n   * such as `/index.html` are not supported; use `openWebView()` instead.\n   *\n   * @since 0.1.0\n   * @example \"https://capgo.app\"\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   * Present this webview in immersive fullscreen from its first visible frame.\n   * Hides native navigation and system bars and provides a native exit-fullscreen button.\n   * The same webview, page state, cookies, and history are retained on entry and exit.\n   * Exiting restores the configured toolbar and safe-area settings.\n   *\n   * Applies before presentation, including when `isPresentAfterPageLoad` is true.\n   * With `hidden: true`, waits for the first `show()` without changing the host's system bars.\n   * Subsequent hide/show or background/resume cycles do not re-enter fullscreen automatically.\n   * Only supported on iOS and Android for full-size, frontmost `openWebView` presentations.\n   * Custom dimensions and `toBack: true` are unsupported. The Web implementation rejects `true`.\n   * Permission prompts, if needed, are the host application's responsibility.\n   *\n   * @default false\n   * @example\n   * fullscreen: true,\n   * toolbarType: ToolBarType.NAVIGATION // Restored when the user exits fullscreen\n   */\n  fullscreen?: boolean;\n  /**\n   * Target URL to load.\n   *\n   * Remote `http://` and `https://` URLs are loaded as-is.\n   *\n   * To open bundled web assets from the app bundle without running a local HTTP server,\n   * pass a relative path such as `/index.html` or `assets/page.html`. The plugin resolves it to\n   * the Capacitor local URL for the current platform (defaults: `capacitor://localhost/...` on iOS,\n   * `https://localhost/...` on Android; actual scheme and host follow the app's configured Capacitor\n   * local URL) and serves files from the packaged `public/` directory, or `www/` on iOS when `public/`\n   * is absent.\n   *\n   * @since 0.1.0\n   * @since 8.15.0 Relative bundled paths (`/index.html`, `assets/page.html`) are supported.\n   * @example \"https://capgo.app\"\n   * @example \"/index.html\"\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   * Custom User-Agent string for the webview.\n   *\n   * When set, replaces the system default webview User-Agent on iOS and Android.\n   * Takes precedence over a `User-Agent` entry in `headers`.\n   *\n   * @since 8.13.0\n   * @example\n   * customUserAgent: \"MyApp/1.0 (Capacitor)\"\n   * Test URL: https://www.whatismybrowser.com/detect/what-is-my-user-agent/\n   */\n  customUserAgent?: string;\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   * database storage where the system WebView supports it while keeping DOM storage available so\n   * SPAs can use `localStorage`. Android cookies use the shared WebView cookie store; clearing them\n   * also affects the host WebView, so prefer per-URL cookie helpers instead of relying on\n   * process-global wipes.\n   *\n   * @default true\n   * @since 8.6.36\n   */\n  persistWebViewData?: boolean;\n  /**\n   * Clear all cookies from the InAppBrowser data store before the first navigation of this webview.\n   *\n   * Cordova `clearcache: 'yes'` parity. On Android, uses process-global `CookieManager.removeAllCookies()`\n   * and starts the first navigation after the wipe callback (does not block the UI thread). On iOS, clears\n   * cookies from the webview's `WKWebsiteDataStore` (isolated plugin store by default). On Web this is a no-op.\n   *\n   * @default false\n   * @since 8.16.0\n   */\n  clearCookiesOnOpen?: boolean;\n  /**\n   * Clear cached website data before the first navigation of this webview.\n   *\n   * Cordova `cleardata: 'yes'` parity. On Android, calls `WebView.clearCache(true)` after the webview\n   * is created. On iOS, removes disk and memory cache from the webview's `WKWebsiteDataStore`.\n   * On Web this is a no-op.\n   *\n   * @default false\n   * @since 8.16.0\n   */\n  clearCacheOnOpen?: boolean;\n  /**\n   * Share the host Capacitor WebView's website data store (cookies, local storage, etc.).\n   *\n   * On iOS 17+, InAppBrowser uses an isolated plugin-owned `WKWebsiteDataStore` by default so host\n   * and browser data stay separate. Set this to `true` to use `WKWebsiteDataStore.default()` instead,\n   * which shares session cookies with the Capacitor host WebView. Useful for SSO / OIDC silent login\n   * when the IdP session was established in the main app WebView.\n   *\n   * Requires `persistWebViewData: true` (the default). When `persistWebViewData` is false, a\n   * non-persistent store is used and this option has no effect.\n   *\n   * On Android this is a no-op: cookies are already process-global via `CookieManager`.\n   * On Web this is a no-op.\n   *\n   * Warning: clearing cookies/cache for a webview opened with this flag can affect the host WebView\n   * on iOS, because both share the same store. `clearAllBrowsingData()` still skips the host store.\n   *\n   * @default false\n   * @since 8.13.6\n   */\n  useSharedDataStore?: 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 (see `downloadPreview`).\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   * Opens managed Apple Wallet pass downloads (`.pkpass`) in the Wallet add-pass sheet\n   * instead of the download preview.\n   *\n   * Falls back to the regular download preview when the device can't add passes. An invalid pass\n   * emits `downloadFailed`. A shown sheet emits `downloadCompleted` with `handledBy: 'wallet'`.\n   *\n   * Requires `handleDownloads: true`. iOS only; ignored on Android.\n   *\n   * @default false\n   * @since 8.21.0\n   */\n  openWalletPasses?: boolean;\n  /**\n   * Controls where managed downloads are previewed after saving.\n   *\n   * - `'inAppBrowser'` (default): Reopens previewable files (PDF, images, text, JSON) inside the same webview.\n   * - `'systemPreview'`: Opens the system Quick Look preview with share and Save to Files actions. iOS only; ignored on Android.\n   *\n   * Requires `handleDownloads: true`.\n   *\n   * @default \"inAppBrowser\"\n   * @since 8.19.0\n   */\n  downloadPreview?: DownloadPreview;\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  /**\n   * Allow pages to enter HTML5 fullscreen (e.g. `requestFullscreen()` or a video player's fullscreen button).\n   * When `false`, fullscreen requests are rejected and the toolbar stays visible, so the user can always close the browser.\n   *\n   * Android only. On iOS, element fullscreen is not enabled by the plugin, so this option has no effect.\n   *\n   * @since 8.22.0\n   * @default true\n   * @example\n   * allowWebViewFullscreen: false\n   */\n  allowWebViewFullscreen?: 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   * Web content rendering mode for the managed WKWebView.\n   *\n   * Controls whether pages load with mobile or desktop layout on iPad.\n   * Matches Capacitor's `ios.preferredContentMode` behavior.\n   *\n   * Resolution order when opening a webview:\n   * 1. This per-open value\n   * 2. Plugin config `plugins.CapgoInAppBrowser.preferredContentMode`\n   * 3. Legacy plugin config `plugins.InAppBrowser.preferredContentMode`\n   * 4. Capacitor config `ios.preferredContentMode`\n   *\n   * When unset at all levels, the system default applies (device-recommended).\n   *\n   * **iOS only** — ignored on Android and Web.\n   *\n   * @since 8.18.0\n   * @example\n   * preferredContentMode: \"mobile\"\n   */\n  preferredContentMode?: PreferredContentMode;\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   * Where the native toolbar close button is placed.\n   *\n   * When omitted, each platform keeps its convention: Android places the close button at the\n   * start, iOS at the end (or at the start when `showArrow` is true). Setting this option\n   * overrides that placement on both platforms.\n   *\n   * @since 8.17.0\n   * @example\n   * closeButtonPosition: CloseButtonPosition.END\n   */\n  closeButtonPosition?: CloseButtonPosition;\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 is inset by the bottom system bar (navigation bar) so bottom-anchored\n   * content stays reachable. When false (default), the webView can extend behind the navigation bar\n   * and apps can use `env(safe-area-inset-*)` for layout, matching the main Capacitor WebView.\n   * On pre-API 30 devices with a transparent navigation bar, bottom padding may still be applied\n   * when the window lays out behind the navigation bar regardless of this option.\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   * On Android, when a toolbar is visible the toolbar itself provides that safe area; with\n   * `toolbarType: 'blank'` on Android 15+ the status bar inset is applied to the webView instead.\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 to the top of the WebView on Android even when\n   * the window is not edge-to-edge (before Android 15). Keeps the legacy 0px inset by default for\n   * apps that handle padding themselves. On Android 15+ this is not needed: without a visible\n   * toolbar the status bar inset already follows `enabledSafeTopMargin`.\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 InAppBrowser-managed webviews and the plugin-owned data store.\n   *\n   * This removes cookies, disk cache, memory cache, local storage, session storage, IndexedDB,\n   * WebSQL where supported, form data, and HTTP auth data for InAppBrowser only.\n   *\n   * It does **not** clear the Capacitor/Ionic host WebView stores. On iOS 17+, InAppBrowser uses a\n   * dedicated persistent `WKWebsiteDataStore` so host and browser data stay isolated (unless\n   * `useSharedDataStore: true` was set on `openWebView`). On Android, process-global `CookieManager`\n   * / `WebStorage` are shared with the host WebView and are not wiped by this method; open managed\n   * WebViews still clear per-view cache/history and page storage.\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 applied fullscreen changes, including startup entry, the native exit button,\n   * Android Back, and native lifecycle cleanup. Register before opening to observe startup entry.\n   * Repeated requests for the current state do not emit duplicate events.\n   * This event describes host-controlled fullscreen, not HTML/video fullscreen.\n   */\n  addListener(\n    eventName: 'fullscreenChange',\n    listenerFunc: (event: FullscreenChangeEvent) => void,\n  ): 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   * Enter or exit immersive fullscreen without recreating or reloading the webview.\n   * When `id` is omitted, targets the active webview. Repeated calls are idempotent.\n   * Entry requires a visible, frontmost, full-size `openWebView` on iOS or Android.\n   * Missing webviews, invalid arguments, custom dimensions, behind-host presentations,\n   * and the Web platform reject. Use the opening `fullscreen` option for an initially hidden webview.\n   * Disabling also cancels any pending fullscreen-at-launch request.\n   *\n   * Native exit controls, backgrounding, hiding, closing, cross-origin navigation, and renderer\n   * termination restore the original chrome even when host JavaScript cannot respond.\n   */\n  setFullscreen(options: { enabled: boolean; id?: string }): Promise<void>;\n\n  /**\n   * Read the applied host-controlled fullscreen state of an `openWebView`.\n   * When `id` is omitted, targets the active webview. Initially hidden fullscreen webviews\n   * report `false` until their first presentation. Missing webviews and Web usage reject.\n   * HTML/video fullscreen does not change this value.\n   */\n  getFullscreen(options?: { id?: string }): Promise<{ enabled: boolean }>;\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   *\n   * On web, the redirect page should post the final URL to a `BroadcastChannel` and close itself.\n   * On mobile, register a custom redirect URI scheme (for example `myapp://oauth_callback/`) in Info.plist and AndroidManifest.xml.\n   * See the README section \"openSecureWindow (OAuth)\" for full setup examples.\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

@@ -446,7 +446,7 @@ public class CapgoInAppBrowserPlugin: CAPPlugin, CAPBridgedPlugin {
         case aware = "AWARE"
         case fakeVisible = "FAKE_VISIBLE"
     }
-    private let pluginVersion: String = "8.21.1"
+    private let pluginVersion: String = "8.22.0"
     public let identifier = "CapgoInAppBrowserPlugin"
     public let jsName = "CapgoInAppBrowser"
     public let pluginMethods: [CAPPluginMethod] = [