@capacitor/app 8.1.0 → 8.1.1-dev-2542-20260611T172948.0

package/Package.swift

@@ -10,14 +10,13 @@ let package = Package(
             targets: ["AppPlugin"])
     ],
     dependencies: [
-        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "9.0.0-alpha.0")
     ],
     targets: [
         .target(
             name: "AppPlugin",
             dependencies: [
-                .product(name: "Capacitor", package: "capacitor-swift-pm"),
-                .product(name: "Cordova", package: "capacitor-swift-pm")
+                .product(name: "Capacitor", package: "capacitor-swift-pm")
             ],
             path: "ios/Sources/AppPlugin"),
         .testTarget(

package/README.md

@@ -43,6 +43,9 @@ For being able to open the app from a custom scheme you need to register the sch
 
 `custom_url_scheme` value is stored in `strings.xml`. When the Android platform is added, `@capacitor/cli` adds the app's package name as default value, but can be replaced by editing the `strings.xml` file.
 
+## Android Predictive Back
+Android predictive back also requires `android:enableOnBackInvokedCallback="true"` on `<application>` in your `AndroidManifest.xml` (on Android 14; default on Android 15+).
+
 ## Example
 
 ```typescript
@@ -72,9 +75,10 @@ const checkAppLaunchUrl = async () => {
 <docgen-config>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-| Prop                           | Type                 | Description                                                                    | Default            | Since |
-| ------------------------------ | -------------------- | ------------------------------------------------------------------------------ | ------------------ | ----- |
-| **`disableBackButtonHandler`** | <code>boolean</code> | Disable the plugin's default back button handling. Only available for Android. | <code>false</code> | 7.1.0 |
+| Prop                           | Type                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Default            | Since |
+| ------------------------------ | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ----- |
+| **`disableBackButtonHandler`** | <code>boolean</code> | Disable the plugin's default back button handling. Only available for Android.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <code>false</code> | 7.1.0 |
+| **`enableEdgeGestureHandler`** | <code>boolean</code> | Enable the plugin's edge gesture handler at startup. When enabled, the plugin emits `edgeGesture` events for system edge swipes (iOS left/right screen-edge pans, Android predictive back). On Android, enabling this handler suppresses the default `backButton` handler for the duration that the edge gesture handler is active. The Android predictive-back integration requires API 34 (Android 14) or later; on earlier versions the configuration is accepted but no events will be emitted. Android predictive back also requires `android:enableOnBackInvokedCallback="true"` on `&lt;application&gt;` in your `AndroidManifest.xml` (on Android 14; default on Android 15+). | <code>false</code> | 9.0.0 |
 
 ### Examples
 
@@ -84,7 +88,8 @@ In `capacitor.config.json`:
 {
   "plugins": {
     "App": {
-      "disableBackButtonHandler": true
+      "disableBackButtonHandler": true,
+      "enableEdgeGestureHandler": true
     }
   }
 }
@@ -101,6 +106,7 @@ const config: CapacitorConfig = {
   plugins: {
     App: {
       disableBackButtonHandler: true,
+      enableEdgeGestureHandler: true,
     },
   },
 };
@@ -121,12 +127,14 @@ export default config;
 * [`minimizeApp()`](#minimizeapp)
 * [`getAppLanguage()`](#getapplanguage)
 * [`toggleBackButtonHandler(...)`](#togglebackbuttonhandler)
+* [`toggleEdgeGestureHandler(...)`](#toggleedgegesturehandler)
 * [`addListener('appStateChange', ...)`](#addlistenerappstatechange-)
 * [`addListener('pause', ...)`](#addlistenerpause-)
 * [`addListener('resume', ...)`](#addlistenerresume-)
 * [`addListener('appUrlOpen', ...)`](#addlistenerappurlopen-)
 * [`addListener('appRestoredResult', ...)`](#addlistenerapprestoredresult-)
 * [`addListener('backButton', ...)`](#addlistenerbackbutton-)
+* [`addListener('edgeGesture', ...)`](#addlisteneredgegesture-)
 * [`removeAllListeners()`](#removealllisteners)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -246,6 +254,36 @@ Only available for Android.
 --------------------
 
 
+### toggleEdgeGestureHandler(...)
+
+```typescript
+toggleEdgeGestureHandler(options: ToggleEdgeGestureHandlerOptions) => Promise<void>
+```
+
+Enables or disables the plugin's edge gesture handling at runtime.
+
+When enabled, the plugin installs platform edge-gesture recognizers
+and begins emitting `edgeGesture` events. When disabled, the
+recognizers are removed and no further events are emitted.
+
+On Android, enabling the edge gesture handler temporarily disables
+the default `backButton` handler; disabling it restores the previous
+back button handler state. The Android predictive-back integration
+requires API 34 (Android 14) or later; on earlier versions the call
+resolves but no events will be emitted. Android predictive back also
+requires `android:enableOnBackInvokedCallback="true"` on
+`&lt;application&gt;` in your `AndroidManifest.xml` (on Android 14; default
+on Android 15+).
+
+| Param         | Type                                                                                        |
+| ------------- | ------------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#toggleedgegesturehandleroptions">ToggleEdgeGestureHandlerOptions</a></code> |
+
+**Since:** 9.0.0
+
+--------------------
+
+
 ### addListener('appStateChange', ...)
 
 ```typescript
@@ -403,6 +441,38 @@ If you want to close the app, call `App.exitApp()`.
 --------------------
 
 
+### addListener('edgeGesture', ...)
+
+```typescript
+addListener(eventName: 'edgeGesture', listenerFunc: EdgeGestureListener) => Promise<PluginListenerHandle>
+```
+
+Listen for system edge-swipe gestures.
+
+On iOS this fires for left- and right-edge screen pans tracked by
+`UIScreenEdgePanGestureRecognizer`. On Android this fires for the
+predictive back gesture (requires Android 14 / API 34 or later).
+
+The edge gesture handler must be active for events to fire; enable
+it via the `enableEdgeGestureHandler` configuration option or at
+runtime via `toggleEdgeGestureHandler({ enabled: true })`.
+
+Each gesture produces a sequence of events: a single `start`, zero
+or more `progress`, and then either `commit` (the gesture completed)
+or `cancel` (the gesture was abandoned).
+
+| Param              | Type                                                                |
+| ------------------ | ------------------------------------------------------------------- |
+| **`eventName`**    | <code>'edgeGesture'</code>                                          |
+| **`listenerFunc`** | <code><a href="#edgegesturelistener">EdgeGestureListener</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 9.0.0
+
+--------------------
+
+
 ### removeAllListeners()
 
 ```typescript
@@ -457,6 +527,13 @@ Remove all native listeners for this plugin
 | **`enabled`** | <code>boolean</code> | Indicates whether to enable or disable default back button handling. | 7.1.0 |
 
 
+#### ToggleEdgeGestureHandlerOptions
+
+| Prop          | Type                 | Description                                                      | Since |
+| ------------- | -------------------- | ---------------------------------------------------------------- | ----- |
+| **`enabled`** | <code>boolean</code> | Whether to enable or disable the plugin's edge gesture handling. | 9.0.0 |
+
+
 #### PluginListenerHandle
 
 | Prop         | Type                                      |
@@ -491,6 +568,17 @@ Remove all native listeners for this plugin
 | **`canGoBack`** | <code>boolean</code> | Indicates whether the browser can go back in history. False when the history stack is on the first entry. | 1.0.0 |
 
 
+#### EdgeGestureListenerEvent
+
+| Prop            | Type                                                       | Description                                                                                                                                                                                                                                                                                                                                                                                      | Since |
+| --------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- |
+| **`phase`**     | <code>'start' \| 'progress' \| 'cancel' \| 'commit'</code> | The current phase of the edge gesture. - `start`: the user has initiated an edge swipe. - `progress`: the user is moving their finger; emitted continuously during the gesture. - `commit`: the user released the gesture and the system accepted it (for example, a back navigation should occur). - `cancel`: the user released the gesture without committing it, or the system cancelled it. | 9.0.0 |
+| **`progress`**  | <code>number</code>                                        | How far the gesture has progressed, normalized between `0` and `1`. On `start` this is the initial progress reported by the system. On `progress` it updates as the user drags. On `commit` and `cancel` it reports the last observed progress value.                                                                                                                                            | 9.0.0 |
+| **`swipeEdge`** | <code>'none' \| 'left' \| 'right'</code>                   | Which screen edge the gesture originated from. On iOS this is `'left'` or `'right'` (left/right screen-edge pans are tracked). On Android this reflects the value reported by the predictive-back system and may also be `'none'` when the platform does not report a specific edge.                                                                                                             | 9.0.0 |
+| **`touchX`**    | <code>number</code>                                        | X coordinate of the touch that initiated or is driving the gesture. On iOS the value is in points relative to the WebView. On Android the value is provided by the platform's `BackEvent.getTouchX()`.                                                                                                                                                                                           | 9.0.0 |
+| **`touchY`**    | <code>number</code>                                        | Y coordinate of the touch that initiated or is driving the gesture. On iOS the value is in points relative to the WebView. On Android the value is provided by the platform's `BackEvent.getTouchY()`.                                                                                                                                                                                           | 9.0.0 |
+
+
 ### Type Aliases
 
 
@@ -513,4 +601,9 @@ Remove all native listeners for this plugin
 
 <code>(event: <a href="#backbuttonlistenerevent">BackButtonListenerEvent</a>): void</code>
 
+
+#### EdgeGestureListener
+
+<code>(event: <a href="#edgegesturelistenerevent">EdgeGestureListenerEvent</a>): void</code>
+
 </docgen-api>

package/android/src/main/java/com/capacitorjs/plugins/app/AppPlugin.java

@@ -1,10 +1,19 @@
 package com.capacitorjs.plugins.app;
 
+import static android.window.BackEvent.EDGE_LEFT;
+import static android.window.BackEvent.EDGE_NONE;
+import static android.window.BackEvent.EDGE_RIGHT;
+
 import android.content.Intent;
 import android.content.pm.ApplicationInfo;
 import android.content.pm.PackageInfo;
 import android.net.Uri;
+import android.os.Build;
+import android.window.BackEvent;
+import android.window.OnBackAnimationCallback;
+import android.window.OnBackInvokedDispatcher;
 import androidx.activity.OnBackPressedCallback;
+import androidx.annotation.NonNull;
 import androidx.appcompat.app.AppCompatDelegate;
 import androidx.core.content.pm.PackageInfoCompat;
 import androidx.core.os.LocaleListCompat;
@@ -21,33 +30,40 @@ import java.util.Locale;
 public class AppPlugin extends Plugin {
 
     private static final String EVENT_BACK_BUTTON = "backButton";
+    private static final String EVENT_BACK_GESTURE = "edgeGesture";
     private static final String EVENT_URL_OPEN = "appUrlOpen";
     private static final String EVENT_STATE_CHANGE = "appStateChange";
     private static final String EVENT_RESTORED_RESULT = "appRestoredResult";
     private static final String EVENT_PAUSE = "pause";
     private static final String EVENT_RESUME = "resume";
     private boolean hasPausedEver = false;
+    private boolean backButtonHandlerEnabled = false;
+    private boolean edgeGestureHandlerEnabled = false;
 
     private OnBackPressedCallback onBackPressedCallback;
+    private OnBackAnimationCallback onBackAnimationCallback;
+
+    private String activeEdge = null;
+    private Float lastEdgeProgress = null;
+    private Float lastEdgeTouchX = null;
+    private Float lastEdgeTouchY = null;
 
     public void load() {
-        boolean disableBackButtonHandler = getConfig().getBoolean("disableBackButtonHandler", false);
-
-        bridge
-            .getApp()
-            .setStatusChangeListener((isActive) -> {
-                Logger.debug(getLogTag(), "Firing change: " + isActive);
-                JSObject data = new JSObject();
-                data.put("isActive", isActive);
-                notifyListeners(EVENT_STATE_CHANGE, data, false);
-            });
-        bridge
-            .getApp()
-            .setAppRestoredListener((result) -> {
-                Logger.debug(getLogTag(), "Firing restored result");
-                notifyListeners(EVENT_RESTORED_RESULT, result.getWrappedResult(), true);
-            });
-        this.onBackPressedCallback = new OnBackPressedCallback(!disableBackButtonHandler) {
+        this.backButtonHandlerEnabled = !getConfig().getBoolean("disableBackButtonHandler", false);
+        this.edgeGestureHandlerEnabled = getConfig().getBoolean("enableEdgeGestureHandler", false);
+
+        bridge.getApp().setStatusChangeListener((isActive) -> {
+            Logger.debug(getLogTag(), "Firing change: " + isActive);
+            JSObject data = new JSObject();
+            data.put("isActive", isActive);
+            notifyListeners(EVENT_STATE_CHANGE, data, false);
+        });
+        bridge.getApp().setAppRestoredListener((result) -> {
+            Logger.debug(getLogTag(), "Firing restored result");
+            notifyListeners(EVENT_RESTORED_RESULT, result.getWrappedResult(), true);
+        });
+
+        this.onBackPressedCallback = new OnBackPressedCallback(false) {
             @Override
             public void handleOnBackPressed() {
                 if (!hasListeners(EVENT_BACK_BUTTON)) {
@@ -64,6 +80,12 @@ public class AppPlugin extends Plugin {
         };
 
         getActivity().getOnBackPressedDispatcher().addCallback(getActivity(), this.onBackPressedCallback);
+
+        if (this.edgeGestureHandlerEnabled) {
+            this.setupBackGestureHandlers();
+        }
+
+        applyBackButtonHandlerState();
     }
 
     @PluginMethod
@@ -116,6 +138,15 @@ public class AppPlugin extends Plugin {
         call.resolve();
     }
 
+    @PluginMethod
+    public void getAppLanguage(PluginCall call) {
+        JSObject ret = new JSObject();
+        LocaleListCompat appLocales = AppCompatDelegate.getApplicationLocales();
+        Locale appLocale = !appLocales.isEmpty() ? appLocales.get(0) : null;
+        ret.put("value", appLocale != null ? appLocale.getLanguage() : Locale.getDefault().getLanguage());
+        call.resolve(ret);
+    }
+
     @PluginMethod
     public void toggleBackButtonHandler(PluginCall call) {
         if (this.onBackPressedCallback == null) {
@@ -123,19 +154,35 @@ public class AppPlugin extends Plugin {
             return;
         }
 
-        Boolean enabled = call.getBoolean("enabled");
+        backButtonHandlerEnabled = call.getBoolean("enabled", false);
 
-        this.onBackPressedCallback.setEnabled(enabled);
+        applyBackButtonHandlerState();
         call.resolve();
     }
 
     @PluginMethod
-    public void getAppLanguage(PluginCall call) {
-        JSObject ret = new JSObject();
-        LocaleListCompat appLocales = AppCompatDelegate.getApplicationLocales();
-        Locale appLocale = !appLocales.isEmpty() ? appLocales.get(0) : null;
-        ret.put("value", appLocale != null ? appLocale.getLanguage() : Locale.getDefault().getLanguage());
-        call.resolve(ret);
+    public void toggleEdgeGestureHandler(PluginCall call) {
+        if (getActivity() == null) {
+            call.reject("activity is null");
+            return;
+        }
+
+        edgeGestureHandlerEnabled = call.getBoolean("enabled", false);
+        applyBackButtonHandlerState();
+
+        if (edgeGestureHandlerEnabled) {
+            setupBackGestureHandlers();
+        } else {
+            teardownBackGestureHandlers();
+        }
+
+        call.resolve();
+    }
+
+    private void applyBackButtonHandlerState() {
+        if (this.onBackPressedCallback != null) {
+            this.onBackPressedCallback.setEnabled(backButtonHandlerEnabled && !edgeGestureHandlerEnabled);
+        }
     }
 
     /**
@@ -176,10 +223,120 @@ public class AppPlugin extends Plugin {
     @Override
     protected void handleOnDestroy() {
         unsetAppListeners();
+        teardownBackGestureHandlers();
     }
 
     private void unsetAppListeners() {
         bridge.getApp().setStatusChangeListener(null);
         bridge.getApp().setAppRestoredListener(null);
     }
+
+    private void setupBackGestureHandlers() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+            if (this.onBackAnimationCallback != null) {
+                return;
+            }
+
+            this.onBackAnimationCallback = new OnBackAnimationCallback() {
+                @Override
+                public void onBackInvoked() {
+                    if (hasListeners(EVENT_BACK_GESTURE)) {
+                        JSObject data = new JSObject();
+                        data.put("phase", "commit");
+                        data.put("progress", lastEdgeProgress);
+                        data.put("touchX", lastEdgeTouchX);
+                        data.put("touchY", lastEdgeTouchY);
+                        data.put("swipeEdge", activeEdge);
+
+                        notifyListeners(EVENT_BACK_GESTURE, data, true);
+
+                        lastEdgeProgress = null;
+                        lastEdgeTouchX = null;
+                        lastEdgeTouchY = null;
+                        activeEdge = null;
+                    }
+                }
+
+                @Override
+                public void onBackStarted(@NonNull BackEvent backEvent) {
+                    if (hasListeners(EVENT_BACK_GESTURE)) {
+                        JSObject data = new JSObject();
+                        data.put("phase", "start");
+                        data.put("progress", backEvent.getProgress());
+                        data.put("touchX", backEvent.getTouchX());
+                        data.put("touchY", backEvent.getTouchY());
+                        data.put("swipeEdge", getSwipeEdge(backEvent.getSwipeEdge()));
+
+                        notifyListeners(EVENT_BACK_GESTURE, data, true);
+
+                        lastEdgeProgress = backEvent.getProgress();
+                        lastEdgeTouchX = backEvent.getTouchX();
+                        lastEdgeTouchY = backEvent.getTouchY();
+                        activeEdge = getSwipeEdge(backEvent.getSwipeEdge());
+                    }
+                }
+
+                @Override
+                public void onBackProgressed(@NonNull BackEvent backEvent) {
+                    if (hasListeners(EVENT_BACK_GESTURE)) {
+                        JSObject data = new JSObject();
+                        data.put("phase", "progress");
+                        data.put("progress", backEvent.getProgress());
+                        data.put("touchX", backEvent.getTouchX());
+                        data.put("touchY", backEvent.getTouchY());
+                        data.put("swipeEdge", getSwipeEdge(backEvent.getSwipeEdge()));
+
+                        notifyListeners(EVENT_BACK_GESTURE, data, true);
+
+                        lastEdgeProgress = backEvent.getProgress();
+                        lastEdgeTouchX = backEvent.getTouchX();
+                        lastEdgeTouchY = backEvent.getTouchY();
+                        activeEdge = getSwipeEdge(backEvent.getSwipeEdge());
+                    }
+                }
+
+                @Override
+                public void onBackCancelled() {
+                    if (hasListeners(EVENT_BACK_GESTURE)) {
+                        JSObject data = new JSObject();
+                        data.put("phase", "cancel");
+                        data.put("progress", lastEdgeProgress);
+                        data.put("touchX", lastEdgeTouchX);
+                        data.put("touchY", lastEdgeTouchY);
+                        data.put("swipeEdge", activeEdge);
+
+                        notifyListeners(EVENT_BACK_GESTURE, data, true);
+
+                        lastEdgeProgress = null;
+                        lastEdgeTouchX = null;
+                        lastEdgeTouchY = null;
+                        activeEdge = null;
+                    }
+                }
+            };
+
+            getActivity()
+                .getOnBackInvokedDispatcher()
+                .registerOnBackInvokedCallback(OnBackInvokedDispatcher.PRIORITY_DEFAULT, this.onBackAnimationCallback);
+        }
+    }
+
+    private void teardownBackGestureHandlers() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+            if (this.onBackAnimationCallback == null) {
+                return;
+            }
+
+            getActivity().getOnBackInvokedDispatcher().unregisterOnBackInvokedCallback(this.onBackAnimationCallback);
+            this.onBackAnimationCallback = null;
+        }
+    }
+
+    private String getSwipeEdge(int edge) {
+        return switch (edge) {
+            case EDGE_LEFT -> "left";
+            case EDGE_RIGHT -> "right";
+            default -> "none";
+        };
+    }
 }

package/dist/esm/definitions.d.ts

@@ -12,6 +12,26 @@ declare module '@capacitor/cli' {
              * @example true
              */
             disableBackButtonHandler?: boolean;
+            /**
+             * Enable the plugin's edge gesture handler at startup.
+             *
+             * When enabled, the plugin emits `edgeGesture` events for system edge
+             * swipes (iOS left/right screen-edge pans, Android predictive back).
+             *
+             * On Android, enabling this handler suppresses the default
+             * `backButton` handler for the duration that the edge gesture handler
+             * is active. The Android predictive-back integration requires API 34
+             * (Android 14) or later; on earlier versions the configuration is
+             * accepted but no events will be emitted. Android predictive back
+             * also requires `android:enableOnBackInvokedCallback="true"` on
+             * `<application>` in your `AndroidManifest.xml` (on Android 14;
+             * default on Android 15+).
+             *
+             * @since 9.0.0
+             * @default false
+             * @example true
+             */
+            enableEdgeGestureHandler?: boolean;
         };
     }
 }
@@ -130,6 +150,61 @@ export interface BackButtonListenerEvent {
      */
     canGoBack: boolean;
 }
+export interface EdgeGestureListenerEvent {
+    /**
+     * The current phase of the edge gesture.
+     *
+     * - `start`: the user has initiated an edge swipe.
+     * - `progress`: the user is moving their finger; emitted continuously
+     *   during the gesture.
+     * - `commit`: the user released the gesture and the system accepted it
+     *   (for example, a back navigation should occur).
+     * - `cancel`: the user released the gesture without committing it, or
+     *   the system cancelled it.
+     *
+     * @since 9.0.0
+     */
+    phase: 'start' | 'progress' | 'cancel' | 'commit';
+    /**
+     * How far the gesture has progressed, normalized between `0` and `1`.
+     *
+     * On `start` this is the initial progress reported by the system. On
+     * `progress` it updates as the user drags. On `commit` and `cancel`
+     * it reports the last observed progress value.
+     *
+     * @since 9.0.0
+     */
+    progress?: number;
+    /**
+     * Which screen edge the gesture originated from.
+     *
+     * On iOS this is `'left'` or `'right'` (left/right screen-edge pans
+     * are tracked). On Android this reflects the value reported by the
+     * predictive-back system and may also be `'none'` when the platform
+     * does not report a specific edge.
+     *
+     * @since 9.0.0
+     */
+    swipeEdge?: 'left' | 'right' | 'none';
+    /**
+     * X coordinate of the touch that initiated or is driving the gesture.
+     *
+     * On iOS the value is in points relative to the WebView. On Android the
+     * value is provided by the platform's `BackEvent.getTouchX()`.
+     *
+     * @since 9.0.0
+     */
+    touchX?: number;
+    /**
+     * Y coordinate of the touch that initiated or is driving the gesture.
+     *
+     * On iOS the value is in points relative to the WebView. On Android the
+     * value is provided by the platform's `BackEvent.getTouchY()`.
+     *
+     * @since 9.0.0
+     */
+    touchY?: number;
+}
 export interface ToggleBackButtonHandlerOptions {
     /**
      * Indicates whether to enable or disable default back button handling.
@@ -138,10 +213,19 @@ export interface ToggleBackButtonHandlerOptions {
      */
     enabled: boolean;
 }
+export interface ToggleEdgeGestureHandlerOptions {
+    /**
+     * Whether to enable or disable the plugin's edge gesture handling.
+     *
+     * @since 9.0.0
+     */
+    enabled: boolean;
+}
 export type StateChangeListener = (state: AppState) => void;
 export type URLOpenListener = (event: URLOpenListenerEvent) => void;
 export type RestoredListener = (event: RestoredListenerEvent) => void;
 export type BackButtonListener = (event: BackButtonListenerEvent) => void;
+export type EdgeGestureListener = (event: EdgeGestureListenerEvent) => void;
 export interface AppLanguageCode {
     /**
      * Two or Three character language code.
@@ -200,6 +284,25 @@ export interface AppPlugin {
      * @since 7.1.0
      */
     toggleBackButtonHandler(options: ToggleBackButtonHandlerOptions): Promise<void>;
+    /**
+     * Enables or disables the plugin's edge gesture handling at runtime.
+     *
+     * When enabled, the plugin installs platform edge-gesture recognizers
+     * and begins emitting `edgeGesture` events. When disabled, the
+     * recognizers are removed and no further events are emitted.
+     *
+     * On Android, enabling the edge gesture handler temporarily disables
+     * the default `backButton` handler; disabling it restores the previous
+     * back button handler state. The Android predictive-back integration
+     * requires API 34 (Android 14) or later; on earlier versions the call
+     * resolves but no events will be emitted. Android predictive back also
+     * requires `android:enableOnBackInvokedCallback="true"` on
+     * `<application>` in your `AndroidManifest.xml` (on Android 14; default
+     * on Android 15+).
+     *
+     * @since 9.0.0
+     */
+    toggleEdgeGestureHandler(options: ToggleEdgeGestureHandlerOptions): Promise<void>;
     /**
      * Listen for changes in the app or the activity states.
      *
@@ -273,6 +376,24 @@ export interface AppPlugin {
      * @since 1.0.0
      */
     addListener(eventName: 'backButton', listenerFunc: BackButtonListener): Promise<PluginListenerHandle>;
+    /**
+     * Listen for system edge-swipe gestures.
+     *
+     * On iOS this fires for left- and right-edge screen pans tracked by
+     * `UIScreenEdgePanGestureRecognizer`. On Android this fires for the
+     * predictive back gesture (requires Android 14 / API 34 or later).
+     *
+     * The edge gesture handler must be active for events to fire; enable
+     * it via the `enableEdgeGestureHandler` configuration option or at
+     * runtime via `toggleEdgeGestureHandler({ enabled: true })`.
+     *
+     * Each gesture produces a sequence of events: a single `start`, zero
+     * or more `progress`, and then either `commit` (the gesture completed)
+     * or `cancel` (the gesture was abandoned).
+     *
+     * @since 9.0.0
+     */
+    addListener(eventName: 'edgeGesture', listenerFunc: EdgeGestureListener): Promise<PluginListenerHandle>;
     /**
      * Remove all native listeners for this plugin
      *

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PluginListenerHandle } from '@capacitor/core';\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    App?: {\n      /**\n       * Disable the plugin's default back button handling.\n       *\n       * Only available for Android.\n       *\n       * @since 7.1.0\n       * @default false\n       * @example true\n       */\n      disableBackButtonHandler?: boolean;\n    };\n  }\n}\n\nexport interface AppInfo {\n  /**\n   * The name of the app.\n   *\n   * @since 1.0.0\n   */\n  name: string;\n\n  /**\n   * The identifier of the app.\n   * On iOS it's the Bundle Identifier.\n   * On Android it's the Application ID\n   *\n   * @since 1.0.0\n   */\n  id: string;\n\n  /**\n   * The build version.\n   * On iOS it's the CFBundleVersion.\n   * On Android it's the versionCode.\n   *\n   * @since 1.0.0\n   */\n  build: string;\n\n  /**\n   * The app version.\n   * On iOS it's the CFBundleShortVersionString.\n   * On Android it's package's versionName.\n   *\n   * @since 1.0.0\n   */\n  version: string;\n}\n\nexport interface AppState {\n  /**\n   * Whether the app is active or not.\n   *\n   * @since 1.0.0\n   */\n  isActive: boolean;\n}\n\nexport interface URLOpenListenerEvent {\n  /**\n   * The URL the app was opened with.\n   *\n   * @since 1.0.0\n   */\n  url: string;\n\n  /**\n   * The source application opening the app (iOS only)\n   * https://developer.apple.com/documentation/uikit/uiapplicationopenurloptionskey/1623128-sourceapplication\n   *\n   * @since 1.0.0\n   */\n  iosSourceApplication?: any;\n  /**\n   * Whether the app should open the passed document in-place\n   * or must copy it first.\n   * https://developer.apple.com/documentation/uikit/uiapplicationopenurloptionskey/1623123-openinplace\n   *\n   * @since 1.0.0\n   */\n  iosOpenInPlace?: boolean;\n}\n\nexport interface AppLaunchUrl {\n  /**\n   * The url used to open the app.\n   *\n   * @since 1.0.0\n   */\n  url: string;\n}\n\nexport interface RestoredListenerEvent {\n  /**\n   * The pluginId this result corresponds to. For example, `Camera`.\n   *\n   * @since 1.0.0\n   */\n  pluginId: string;\n  /**\n   * The methodName this result corresponds to. For example, `getPhoto`\n   *\n   * @since 1.0.0\n   */\n  methodName: string;\n  /**\n   * The result data passed from the plugin. This would be the result you'd\n   * expect from normally calling the plugin method. For example, `CameraPhoto`\n   *\n   * @since 1.0.0\n   */\n  data?: any;\n  /**\n   * Boolean indicating if the plugin call succeeded.\n   *\n   * @since 1.0.0\n   */\n  success: boolean;\n  /**\n   * If the plugin call didn't succeed, it will contain the error message.\n   *\n   * @since 1.0.0\n   */\n  error?: {\n    message: string;\n  };\n}\n\nexport interface BackButtonListenerEvent {\n  /**\n   * Indicates whether the browser can go back in history.\n   * False when the history stack is on the first entry.\n   *\n   * @since 1.0.0\n   */\n  canGoBack: boolean;\n}\n\nexport interface ToggleBackButtonHandlerOptions {\n  /**\n   * Indicates whether to enable or disable default back button handling.\n   *\n   * @since 7.1.0\n   */\n  enabled: boolean;\n}\n\nexport type StateChangeListener = (state: AppState) => void;\nexport type URLOpenListener = (event: URLOpenListenerEvent) => void;\nexport type RestoredListener = (event: RestoredListenerEvent) => void;\nexport type BackButtonListener = (event: BackButtonListenerEvent) => void;\n\nexport interface AppLanguageCode {\n  /**\n   * Two or Three character language code.\n   *\n   * @since 8.1.0\n   */\n  value: string;\n}\n\nexport interface AppPlugin {\n  /**\n   * Force exit the app. This should only be used in conjunction with the `backButton` handler for Android to\n   * exit the app when navigation is complete.\n   *\n   * Ionic handles this itself so you shouldn't need to call this if using Ionic.\n   *\n   * @since 1.0.0\n   */\n  exitApp(): Promise<void>;\n\n  /**\n   * Return information about the app.\n   *\n   * @since 1.0.0\n   */\n  getInfo(): Promise<AppInfo>;\n\n  /**\n   * Gets the current app state.\n   *\n   * @since 1.0.0\n   */\n  getState(): Promise<AppState>;\n\n  /**\n   * Get the URL the app was launched with, if any.\n   *\n   * @since 1.0.0\n   */\n  getLaunchUrl(): Promise<AppLaunchUrl | undefined>;\n\n  /**\n   * Minimizes the application.\n   *\n   * Only available for Android.\n   *\n   * @since 1.1.0\n   */\n  minimizeApp(): Promise<void>;\n\n  /**\n   * Get the app specific language locale code.\n   *\n   * @since 8.1.0\n   */\n  getAppLanguage(): Promise<AppLanguageCode>;\n\n  /**\n   * Enables or disables the plugin's back button handling during runtime.\n   *\n   * Only available for Android.\n   *\n   * @since 7.1.0\n   */\n  toggleBackButtonHandler(options: ToggleBackButtonHandlerOptions): Promise<void>;\n\n  /**\n   * Listen for changes in the app or the activity states.\n   *\n   * On iOS it's fired when the native [UIApplication.willResignActiveNotification](https://developer.apple.com/documentation/uikit/uiapplication/1622973-willresignactivenotification) and\n   * [UIApplication.didBecomeActiveNotification](https://developer.apple.com/documentation/uikit/uiapplication/1622953-didbecomeactivenotification) events get fired.\n   * On Android it's fired when the Capacitor's Activity [onResume](https://developer.android.com/reference/android/app/Activity#onResume()) and [onStop](https://developer.android.com/reference/android/app/Activity#onStop()) methods gets called.\n   * On Web it's fired when the document's visibilitychange gets fired.\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'appStateChange', listenerFunc: StateChangeListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for when the app or the activity are paused.\n   *\n   * On iOS it's fired when the native [UIApplication.didEnterBackgroundNotification](https://developer.apple.com/documentation/uikit/uiapplication/1623071-didenterbackgroundnotification) event gets fired.\n   * On Android it's fired when the Capacitor's Activity [onPause](https://developer.android.com/reference/android/app/Activity#onPause()) method gets called.\n   * On Web it's fired when the document's visibilitychange gets fired and document.hidden is true.\n   *\n   * @since 4.1.0\n   */\n  addListener(eventName: 'pause', listenerFunc: () => void): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for when the app or activity are resumed.\n   *\n   * On iOS it's fired when the native [UIApplication.willEnterForegroundNotification](https://developer.apple.com/documentation/uikit/uiapplication/1622944-willenterforegroundnotification) event gets fired.\n   * On Android it's fired when the Capacitor's Activity [onResume](https://developer.android.com/reference/android/app/Activity#onResume()) method gets called,\n   * but only after resume has fired first.\n   * On Web it's fired when the document's visibilitychange gets fired and document.hidden is false.\n   *\n   * @since 4.1.0\n   */\n  addListener(eventName: 'resume', listenerFunc: () => void): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for url open events for the app. This handles both custom URL scheme links as well\n   * as URLs your app handles (Universal Links on iOS and App Links on Android)\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'appUrlOpen', listenerFunc: URLOpenListener): Promise<PluginListenerHandle>;\n\n  /**\n   * If the app was launched with previously persisted plugin call data, such as on Android\n   * when an activity returns to an app that was closed, this call will return any data\n   * the app was launched with, converted into the form of a result from a plugin call.\n   *\n   * On Android, due to memory constraints on low-end devices, it's possible\n   * that, if your app launches a new activity, your app will be terminated by\n   * the operating system in order to reduce memory consumption.\n   *\n   * For example, that means the Camera API, which launches a new Activity to\n   * take a photo, may not be able to return data back to your app.\n   *\n   * To avoid this, Capacitor stores all restored activity results on launch.\n   * You should add a listener for `appRestoredResult` in order to handle any\n   * plugin call results that were delivered when your app was not running.\n   *\n   * Once you have that result (if any), you can update the UI to restore a\n   * logical experience for the user, such as navigating or selecting the\n   * proper tab.\n   *\n   * We recommend every Android app using plugins that rely on external\n   * Activities (for example, Camera) to have this event and process handled.\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'appRestoredResult', listenerFunc: RestoredListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for the hardware back button event (Android only). Listening for this event will disable the\n   * default back button behaviour, so you might want to call `window.history.back()` manually.\n   * If you want to close the app, call `App.exitApp()`.\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'backButton', listenerFunc: BackButtonListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all native listeners for this plugin\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA,wCAAwC","sourcesContent":["/// <reference types=\"@capacitor/cli\" />\n\nimport type { PluginListenerHandle } from '@capacitor/core';\n\ndeclare module '@capacitor/cli' {\n  export interface PluginsConfig {\n    App?: {\n      /**\n       * Disable the plugin's default back button handling.\n       *\n       * Only available for Android.\n       *\n       * @since 7.1.0\n       * @default false\n       * @example true\n       */\n      disableBackButtonHandler?: boolean;\n\n      /**\n       * Enable the plugin's edge gesture handler at startup.\n       *\n       * When enabled, the plugin emits `edgeGesture` events for system edge\n       * swipes (iOS left/right screen-edge pans, Android predictive back).\n       *\n       * On Android, enabling this handler suppresses the default\n       * `backButton` handler for the duration that the edge gesture handler\n       * is active. The Android predictive-back integration requires API 34\n       * (Android 14) or later; on earlier versions the configuration is\n       * accepted but no events will be emitted. Android predictive back\n       * also requires `android:enableOnBackInvokedCallback=\"true\"` on\n       * `<application>` in your `AndroidManifest.xml` (on Android 14;\n       * default on Android 15+).\n       *\n       * @since 9.0.0\n       * @default false\n       * @example true\n       */\n      enableEdgeGestureHandler?: boolean;\n    };\n  }\n}\n\nexport interface AppInfo {\n  /**\n   * The name of the app.\n   *\n   * @since 1.0.0\n   */\n  name: string;\n\n  /**\n   * The identifier of the app.\n   * On iOS it's the Bundle Identifier.\n   * On Android it's the Application ID\n   *\n   * @since 1.0.0\n   */\n  id: string;\n\n  /**\n   * The build version.\n   * On iOS it's the CFBundleVersion.\n   * On Android it's the versionCode.\n   *\n   * @since 1.0.0\n   */\n  build: string;\n\n  /**\n   * The app version.\n   * On iOS it's the CFBundleShortVersionString.\n   * On Android it's package's versionName.\n   *\n   * @since 1.0.0\n   */\n  version: string;\n}\n\nexport interface AppState {\n  /**\n   * Whether the app is active or not.\n   *\n   * @since 1.0.0\n   */\n  isActive: boolean;\n}\n\nexport interface URLOpenListenerEvent {\n  /**\n   * The URL the app was opened with.\n   *\n   * @since 1.0.0\n   */\n  url: string;\n\n  /**\n   * The source application opening the app (iOS only)\n   * https://developer.apple.com/documentation/uikit/uiapplicationopenurloptionskey/1623128-sourceapplication\n   *\n   * @since 1.0.0\n   */\n  iosSourceApplication?: any;\n  /**\n   * Whether the app should open the passed document in-place\n   * or must copy it first.\n   * https://developer.apple.com/documentation/uikit/uiapplicationopenurloptionskey/1623123-openinplace\n   *\n   * @since 1.0.0\n   */\n  iosOpenInPlace?: boolean;\n}\n\nexport interface AppLaunchUrl {\n  /**\n   * The url used to open the app.\n   *\n   * @since 1.0.0\n   */\n  url: string;\n}\n\nexport interface RestoredListenerEvent {\n  /**\n   * The pluginId this result corresponds to. For example, `Camera`.\n   *\n   * @since 1.0.0\n   */\n  pluginId: string;\n  /**\n   * The methodName this result corresponds to. For example, `getPhoto`\n   *\n   * @since 1.0.0\n   */\n  methodName: string;\n  /**\n   * The result data passed from the plugin. This would be the result you'd\n   * expect from normally calling the plugin method. For example, `CameraPhoto`\n   *\n   * @since 1.0.0\n   */\n  data?: any;\n  /**\n   * Boolean indicating if the plugin call succeeded.\n   *\n   * @since 1.0.0\n   */\n  success: boolean;\n  /**\n   * If the plugin call didn't succeed, it will contain the error message.\n   *\n   * @since 1.0.0\n   */\n  error?: {\n    message: string;\n  };\n}\n\nexport interface BackButtonListenerEvent {\n  /**\n   * Indicates whether the browser can go back in history.\n   * False when the history stack is on the first entry.\n   *\n   * @since 1.0.0\n   */\n  canGoBack: boolean;\n}\n\nexport interface EdgeGestureListenerEvent {\n  /**\n   * The current phase of the edge gesture.\n   *\n   * - `start`: the user has initiated an edge swipe.\n   * - `progress`: the user is moving their finger; emitted continuously\n   *   during the gesture.\n   * - `commit`: the user released the gesture and the system accepted it\n   *   (for example, a back navigation should occur).\n   * - `cancel`: the user released the gesture without committing it, or\n   *   the system cancelled it.\n   *\n   * @since 9.0.0\n   */\n  phase: 'start' | 'progress' | 'cancel' | 'commit';\n\n  /**\n   * How far the gesture has progressed, normalized between `0` and `1`.\n   *\n   * On `start` this is the initial progress reported by the system. On\n   * `progress` it updates as the user drags. On `commit` and `cancel`\n   * it reports the last observed progress value.\n   *\n   * @since 9.0.0\n   */\n  progress?: number;\n\n  /**\n   * Which screen edge the gesture originated from.\n   *\n   * On iOS this is `'left'` or `'right'` (left/right screen-edge pans\n   * are tracked). On Android this reflects the value reported by the\n   * predictive-back system and may also be `'none'` when the platform\n   * does not report a specific edge.\n   *\n   * @since 9.0.0\n   */\n  swipeEdge?: 'left' | 'right' | 'none';\n\n  /**\n   * X coordinate of the touch that initiated or is driving the gesture.\n   *\n   * On iOS the value is in points relative to the WebView. On Android the\n   * value is provided by the platform's `BackEvent.getTouchX()`.\n   *\n   * @since 9.0.0\n   */\n  touchX?: number;\n\n  /**\n   * Y coordinate of the touch that initiated or is driving the gesture.\n   *\n   * On iOS the value is in points relative to the WebView. On Android the\n   * value is provided by the platform's `BackEvent.getTouchY()`.\n   *\n   * @since 9.0.0\n   */\n  touchY?: number;\n}\n\nexport interface ToggleBackButtonHandlerOptions {\n  /**\n   * Indicates whether to enable or disable default back button handling.\n   *\n   * @since 7.1.0\n   */\n  enabled: boolean;\n}\n\nexport interface ToggleEdgeGestureHandlerOptions {\n  /**\n   * Whether to enable or disable the plugin's edge gesture handling.\n   *\n   * @since 9.0.0\n   */\n  enabled: boolean;\n}\n\nexport type StateChangeListener = (state: AppState) => void;\nexport type URLOpenListener = (event: URLOpenListenerEvent) => void;\nexport type RestoredListener = (event: RestoredListenerEvent) => void;\nexport type BackButtonListener = (event: BackButtonListenerEvent) => void;\nexport type EdgeGestureListener = (event: EdgeGestureListenerEvent) => void;\n\nexport interface AppLanguageCode {\n  /**\n   * Two or Three character language code.\n   *\n   * @since 8.1.0\n   */\n  value: string;\n}\n\nexport interface AppPlugin {\n  /**\n   * Force exit the app. This should only be used in conjunction with the `backButton` handler for Android to\n   * exit the app when navigation is complete.\n   *\n   * Ionic handles this itself so you shouldn't need to call this if using Ionic.\n   *\n   * @since 1.0.0\n   */\n  exitApp(): Promise<void>;\n\n  /**\n   * Return information about the app.\n   *\n   * @since 1.0.0\n   */\n  getInfo(): Promise<AppInfo>;\n\n  /**\n   * Gets the current app state.\n   *\n   * @since 1.0.0\n   */\n  getState(): Promise<AppState>;\n\n  /**\n   * Get the URL the app was launched with, if any.\n   *\n   * @since 1.0.0\n   */\n  getLaunchUrl(): Promise<AppLaunchUrl | undefined>;\n\n  /**\n   * Minimizes the application.\n   *\n   * Only available for Android.\n   *\n   * @since 1.1.0\n   */\n  minimizeApp(): Promise<void>;\n\n  /**\n   * Get the app specific language locale code.\n   *\n   * @since 8.1.0\n   */\n  getAppLanguage(): Promise<AppLanguageCode>;\n\n  /**\n   * Enables or disables the plugin's back button handling during runtime.\n   *\n   * Only available for Android.\n   *\n   * @since 7.1.0\n   */\n  toggleBackButtonHandler(options: ToggleBackButtonHandlerOptions): Promise<void>;\n\n  /**\n   * Enables or disables the plugin's edge gesture handling at runtime.\n   *\n   * When enabled, the plugin installs platform edge-gesture recognizers\n   * and begins emitting `edgeGesture` events. When disabled, the\n   * recognizers are removed and no further events are emitted.\n   *\n   * On Android, enabling the edge gesture handler temporarily disables\n   * the default `backButton` handler; disabling it restores the previous\n   * back button handler state. The Android predictive-back integration\n   * requires API 34 (Android 14) or later; on earlier versions the call\n   * resolves but no events will be emitted. Android predictive back also\n   * requires `android:enableOnBackInvokedCallback=\"true\"` on\n   * `<application>` in your `AndroidManifest.xml` (on Android 14; default\n   * on Android 15+).\n   *\n   * @since 9.0.0\n   */\n  toggleEdgeGestureHandler(options: ToggleEdgeGestureHandlerOptions): Promise<void>;\n\n  /**\n   * Listen for changes in the app or the activity states.\n   *\n   * On iOS it's fired when the native [UIApplication.willResignActiveNotification](https://developer.apple.com/documentation/uikit/uiapplication/1622973-willresignactivenotification) and\n   * [UIApplication.didBecomeActiveNotification](https://developer.apple.com/documentation/uikit/uiapplication/1622953-didbecomeactivenotification) events get fired.\n   * On Android it's fired when the Capacitor's Activity [onResume](https://developer.android.com/reference/android/app/Activity#onResume()) and [onStop](https://developer.android.com/reference/android/app/Activity#onStop()) methods gets called.\n   * On Web it's fired when the document's visibilitychange gets fired.\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'appStateChange', listenerFunc: StateChangeListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for when the app or the activity are paused.\n   *\n   * On iOS it's fired when the native [UIApplication.didEnterBackgroundNotification](https://developer.apple.com/documentation/uikit/uiapplication/1623071-didenterbackgroundnotification) event gets fired.\n   * On Android it's fired when the Capacitor's Activity [onPause](https://developer.android.com/reference/android/app/Activity#onPause()) method gets called.\n   * On Web it's fired when the document's visibilitychange gets fired and document.hidden is true.\n   *\n   * @since 4.1.0\n   */\n  addListener(eventName: 'pause', listenerFunc: () => void): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for when the app or activity are resumed.\n   *\n   * On iOS it's fired when the native [UIApplication.willEnterForegroundNotification](https://developer.apple.com/documentation/uikit/uiapplication/1622944-willenterforegroundnotification) event gets fired.\n   * On Android it's fired when the Capacitor's Activity [onResume](https://developer.android.com/reference/android/app/Activity#onResume()) method gets called,\n   * but only after resume has fired first.\n   * On Web it's fired when the document's visibilitychange gets fired and document.hidden is false.\n   *\n   * @since 4.1.0\n   */\n  addListener(eventName: 'resume', listenerFunc: () => void): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for url open events for the app. This handles both custom URL scheme links as well\n   * as URLs your app handles (Universal Links on iOS and App Links on Android)\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'appUrlOpen', listenerFunc: URLOpenListener): Promise<PluginListenerHandle>;\n\n  /**\n   * If the app was launched with previously persisted plugin call data, such as on Android\n   * when an activity returns to an app that was closed, this call will return any data\n   * the app was launched with, converted into the form of a result from a plugin call.\n   *\n   * On Android, due to memory constraints on low-end devices, it's possible\n   * that, if your app launches a new activity, your app will be terminated by\n   * the operating system in order to reduce memory consumption.\n   *\n   * For example, that means the Camera API, which launches a new Activity to\n   * take a photo, may not be able to return data back to your app.\n   *\n   * To avoid this, Capacitor stores all restored activity results on launch.\n   * You should add a listener for `appRestoredResult` in order to handle any\n   * plugin call results that were delivered when your app was not running.\n   *\n   * Once you have that result (if any), you can update the UI to restore a\n   * logical experience for the user, such as navigating or selecting the\n   * proper tab.\n   *\n   * We recommend every Android app using plugins that rely on external\n   * Activities (for example, Camera) to have this event and process handled.\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'appRestoredResult', listenerFunc: RestoredListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for the hardware back button event (Android only). Listening for this event will disable the\n   * default back button behaviour, so you might want to call `window.history.back()` manually.\n   * If you want to close the app, call `App.exitApp()`.\n   *\n   * @since 1.0.0\n   */\n  addListener(eventName: 'backButton', listenerFunc: BackButtonListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for system edge-swipe gestures.\n   *\n   * On iOS this fires for left- and right-edge screen pans tracked by\n   * `UIScreenEdgePanGestureRecognizer`. On Android this fires for the\n   * predictive back gesture (requires Android 14 / API 34 or later).\n   *\n   * The edge gesture handler must be active for events to fire; enable\n   * it via the `enableEdgeGestureHandler` configuration option or at\n   * runtime via `toggleEdgeGestureHandler({ enabled: true })`.\n   *\n   * Each gesture produces a sequence of events: a single `start`, zero\n   * or more `progress`, and then either `commit` (the gesture completed)\n   * or `cancel` (the gesture was abandoned).\n   *\n   * @since 9.0.0\n   */\n  addListener(eventName: 'edgeGesture', listenerFunc: EdgeGestureListener): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all native listeners for this plugin\n   *\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -8,6 +8,7 @@ export declare class AppWeb extends WebPlugin implements AppPlugin {
     getState(): Promise<AppState>;
     minimizeApp(): Promise<void>;
     toggleBackButtonHandler(): Promise<void>;
+    toggleEdgeGestureHandler(): Promise<void>;
     private handleVisibilityChange;
     getAppLanguage(): Promise<AppLanguageCode>;
 }

package/dist/esm/web.js

@@ -34,6 +34,9 @@ export class AppWeb extends WebPlugin {
     async toggleBackButtonHandler() {
         throw this.unimplemented('Not implemented on web.');
     }
+    async toggleEdgeGestureHandler() {
+        throw this.unimplemented('Not implemented on web.');
+    }
     async getAppLanguage() {
         return {
             value: navigator.language.split('-')[0].toLowerCase(),

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnC;QACE,KAAK,EAAE,CAAC;QA4BF,2BAAsB,GAAG,GAAG,EAAE;YACpC,MAAM,IAAI,GAAG;gBACX,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;aACnC,CAAC;YAEF,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YAC7C,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;QAtCA,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IACpF,CAAC;IAED,OAAO;QACL,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,uBAAuB;QAC3B,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAeD,KAAK,CAAC,cAAc;QAClB,OAAO;YACL,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;SACtD,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { AppInfo, AppPlugin, AppLaunchUrl, AppState, AppLanguageCode } from './definitions';\n\nexport class AppWeb extends WebPlugin implements AppPlugin {\n  constructor() {\n    super();\n    document.addEventListener('visibilitychange', this.handleVisibilityChange, false);\n  }\n\n  exitApp(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getInfo(): Promise<AppInfo> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getLaunchUrl(): Promise<AppLaunchUrl> {\n    return { url: '' };\n  }\n\n  async getState(): Promise<AppState> {\n    return { isActive: document.hidden !== true };\n  }\n\n  async minimizeApp(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async toggleBackButtonHandler(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  private handleVisibilityChange = () => {\n    const data = {\n      isActive: document.hidden !== true,\n    };\n\n    this.notifyListeners('appStateChange', data);\n    if (document.hidden) {\n      this.notifyListeners('pause', null);\n    } else {\n      this.notifyListeners('resume', null);\n    }\n  };\n\n  async getAppLanguage(): Promise<AppLanguageCode> {\n    return {\n      value: navigator.language.split('-')[0].toLowerCase(),\n    };\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,OAAO,MAAO,SAAQ,SAAS;IACnC;QACE,KAAK,EAAE,CAAC;QAgCF,2BAAsB,GAAG,GAAG,EAAE;YACpC,MAAM,IAAI,GAAG;gBACX,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;aACnC,CAAC;YAEF,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YAC7C,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC;QA1CA,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IACpF,CAAC;IAED,OAAO;QACL,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,uBAAuB;QAC3B,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC5B,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;IAeD,KAAK,CAAC,cAAc;QAClB,OAAO;YACL,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;SACtD,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { AppInfo, AppPlugin, AppLaunchUrl, AppState, AppLanguageCode } from './definitions';\n\nexport class AppWeb extends WebPlugin implements AppPlugin {\n  constructor() {\n    super();\n    document.addEventListener('visibilitychange', this.handleVisibilityChange, false);\n  }\n\n  exitApp(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getInfo(): Promise<AppInfo> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async getLaunchUrl(): Promise<AppLaunchUrl> {\n    return { url: '' };\n  }\n\n  async getState(): Promise<AppState> {\n    return { isActive: document.hidden !== true };\n  }\n\n  async minimizeApp(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async toggleBackButtonHandler(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  async toggleEdgeGestureHandler(): Promise<void> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n\n  private handleVisibilityChange = () => {\n    const data = {\n      isActive: document.hidden !== true,\n    };\n\n    this.notifyListeners('appStateChange', data);\n    if (document.hidden) {\n      this.notifyListeners('pause', null);\n    } else {\n      this.notifyListeners('resume', null);\n    }\n  };\n\n  async getAppLanguage(): Promise<AppLanguageCode> {\n    return {\n      value: navigator.language.split('-')[0].toLowerCase(),\n    };\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -41,6 +41,9 @@ class AppWeb extends core.WebPlugin {
     async toggleBackButtonHandler() {
         throw this.unimplemented('Not implemented on web.');
     }
+    async toggleEdgeGestureHandler() {
+        throw this.unimplemented('Not implemented on web.');
+    }
     async getAppLanguage() {
         return {
             value: navigator.language.split('-')[0].toLowerCase(),

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst App = registerPlugin('App', {\n    web: () => import('./web').then((m) => new m.AppWeb()),\n});\nexport * from './definitions';\nexport { App };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AppWeb extends WebPlugin {\n    constructor() {\n        super();\n        this.handleVisibilityChange = () => {\n            const data = {\n                isActive: document.hidden !== true,\n            };\n            this.notifyListeners('appStateChange', data);\n            if (document.hidden) {\n                this.notifyListeners('pause', null);\n            }\n            else {\n                this.notifyListeners('resume', null);\n            }\n        };\n        document.addEventListener('visibilitychange', this.handleVisibilityChange, false);\n    }\n    exitApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getInfo() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getLaunchUrl() {\n        return { url: '' };\n    }\n    async getState() {\n        return { isActive: document.hidden !== true };\n    }\n    async minimizeApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async toggleBackButtonHandler() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getAppLanguage() {\n        return {\n            value: navigator.language.split('-')[0].toLowerCase(),\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK,EAAE;AAClC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC;;ACFM,MAAM,MAAM,SAASC,cAAS,CAAC;AACtC,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,EAAE;AACf,QAAQ,IAAI,CAAC,sBAAsB,GAAG,MAAM;AAC5C,YAAY,MAAM,IAAI,GAAG;AACzB,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;AAClD,aAAa;AACb,YAAY,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,IAAI,CAAC;AACxD,YAAY,IAAI,QAAQ,CAAC,MAAM,EAAE;AACjC,gBAAgB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC;AACnD,YAAY;AACZ,iBAAiB;AACjB,gBAAgB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC;AACpD,YAAY;AACZ,QAAQ,CAAC;AACT,QAAQ,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC;AACzF,IAAI;AACJ,IAAI,OAAO,GAAG;AACd,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,OAAO,GAAG;AACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;AAC1B,IAAI;AACJ,IAAI,MAAM,QAAQ,GAAG;AACrB,QAAQ,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE;AACrD,IAAI;AACJ,IAAI,MAAM,WAAW,GAAG;AACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,uBAAuB,GAAG;AACpC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,cAAc,GAAG;AAC3B,QAAQ,OAAO;AACf,YAAY,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;AACjE,SAAS;AACT,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst App = registerPlugin('App', {\n    web: () => import('./web').then((m) => new m.AppWeb()),\n});\nexport * from './definitions';\nexport { App };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AppWeb extends WebPlugin {\n    constructor() {\n        super();\n        this.handleVisibilityChange = () => {\n            const data = {\n                isActive: document.hidden !== true,\n            };\n            this.notifyListeners('appStateChange', data);\n            if (document.hidden) {\n                this.notifyListeners('pause', null);\n            }\n            else {\n                this.notifyListeners('resume', null);\n            }\n        };\n        document.addEventListener('visibilitychange', this.handleVisibilityChange, false);\n    }\n    exitApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getInfo() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getLaunchUrl() {\n        return { url: '' };\n    }\n    async getState() {\n        return { isActive: document.hidden !== true };\n    }\n    async minimizeApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async toggleBackButtonHandler() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async toggleEdgeGestureHandler() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getAppLanguage() {\n        return {\n            value: navigator.language.split('-')[0].toLowerCase(),\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK,EAAE;AAClC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;AAC1D,CAAC;;ACFM,MAAM,MAAM,SAASC,cAAS,CAAC;AACtC,IAAI,WAAW,GAAG;AAClB,QAAQ,KAAK,EAAE;AACf,QAAQ,IAAI,CAAC,sBAAsB,GAAG,MAAM;AAC5C,YAAY,MAAM,IAAI,GAAG;AACzB,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;AAClD,aAAa;AACb,YAAY,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,IAAI,CAAC;AACxD,YAAY,IAAI,QAAQ,CAAC,MAAM,EAAE;AACjC,gBAAgB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC;AACnD,YAAY;AACZ,iBAAiB;AACjB,gBAAgB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC;AACpD,YAAY;AACZ,QAAQ,CAAC;AACT,QAAQ,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC;AACzF,IAAI;AACJ,IAAI,OAAO,GAAG;AACd,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,OAAO,GAAG;AACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;AAC1B,IAAI;AACJ,IAAI,MAAM,QAAQ,GAAG;AACrB,QAAQ,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE;AACrD,IAAI;AACJ,IAAI,MAAM,WAAW,GAAG;AACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,uBAAuB,GAAG;AACpC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,wBAAwB,GAAG;AACrC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ,IAAI,MAAM,cAAc,GAAG;AAC3B,QAAQ,OAAO;AACf,YAAY,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;AACjE,SAAS;AACT,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -40,6 +40,9 @@ var capacitorApp = (function (exports, core) {
         async toggleBackButtonHandler() {
             throw this.unimplemented('Not implemented on web.');
         }
+        async toggleEdgeGestureHandler() {
+            throw this.unimplemented('Not implemented on web.');
+        }
         async getAppLanguage() {
             return {
                 value: navigator.language.split('-')[0].toLowerCase(),

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst App = registerPlugin('App', {\n    web: () => import('./web').then((m) => new m.AppWeb()),\n});\nexport * from './definitions';\nexport { App };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AppWeb extends WebPlugin {\n    constructor() {\n        super();\n        this.handleVisibilityChange = () => {\n            const data = {\n                isActive: document.hidden !== true,\n            };\n            this.notifyListeners('appStateChange', data);\n            if (document.hidden) {\n                this.notifyListeners('pause', null);\n            }\n            else {\n                this.notifyListeners('resume', null);\n            }\n        };\n        document.addEventListener('visibilitychange', this.handleVisibilityChange, false);\n    }\n    exitApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getInfo() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getLaunchUrl() {\n        return { url: '' };\n    }\n    async getState() {\n        return { isActive: document.hidden !== true };\n    }\n    async minimizeApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async toggleBackButtonHandler() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getAppLanguage() {\n        return {\n            value: navigator.language.split('-')[0].toLowerCase(),\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK,EAAE;IAClC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1D,CAAC;;ICFM,MAAM,MAAM,SAASC,cAAS,CAAC;IACtC,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,EAAE;IACf,QAAQ,IAAI,CAAC,sBAAsB,GAAG,MAAM;IAC5C,YAAY,MAAM,IAAI,GAAG;IACzB,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;IAClD,aAAa;IACb,YAAY,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,IAAI,CAAC;IACxD,YAAY,IAAI,QAAQ,CAAC,MAAM,EAAE;IACjC,gBAAgB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC;IACnD,YAAY;IACZ,iBAAiB;IACjB,gBAAgB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC;IACpD,YAAY;IACZ,QAAQ,CAAC;IACT,QAAQ,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC;IACzF,IAAI;IACJ,IAAI,OAAO,GAAG;IACd,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,OAAO,GAAG;IACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;IAC1B,IAAI;IACJ,IAAI,MAAM,QAAQ,GAAG;IACrB,QAAQ,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE;IACrD,IAAI;IACJ,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,uBAAuB,GAAG;IACpC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,cAAc,GAAG;IAC3B,QAAQ,OAAO;IACf,YAAY,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;IACjE,SAAS;IACT,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst App = registerPlugin('App', {\n    web: () => import('./web').then((m) => new m.AppWeb()),\n});\nexport * from './definitions';\nexport { App };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class AppWeb extends WebPlugin {\n    constructor() {\n        super();\n        this.handleVisibilityChange = () => {\n            const data = {\n                isActive: document.hidden !== true,\n            };\n            this.notifyListeners('appStateChange', data);\n            if (document.hidden) {\n                this.notifyListeners('pause', null);\n            }\n            else {\n                this.notifyListeners('resume', null);\n            }\n        };\n        document.addEventListener('visibilitychange', this.handleVisibilityChange, false);\n    }\n    exitApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getInfo() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getLaunchUrl() {\n        return { url: '' };\n    }\n    async getState() {\n        return { isActive: document.hidden !== true };\n    }\n    async minimizeApp() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async toggleBackButtonHandler() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async toggleEdgeGestureHandler() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n    async getAppLanguage() {\n        return {\n            value: navigator.language.split('-')[0].toLowerCase(),\n        };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK,EAAE;IAClC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1D,CAAC;;ICFM,MAAM,MAAM,SAASC,cAAS,CAAC;IACtC,IAAI,WAAW,GAAG;IAClB,QAAQ,KAAK,EAAE;IACf,QAAQ,IAAI,CAAC,sBAAsB,GAAG,MAAM;IAC5C,YAAY,MAAM,IAAI,GAAG;IACzB,gBAAgB,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI;IAClD,aAAa;IACb,YAAY,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE,IAAI,CAAC;IACxD,YAAY,IAAI,QAAQ,CAAC,MAAM,EAAE;IACjC,gBAAgB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC;IACnD,YAAY;IACZ,iBAAiB;IACjB,gBAAgB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC;IACpD,YAAY;IACZ,QAAQ,CAAC;IACT,QAAQ,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC;IACzF,IAAI;IACJ,IAAI,OAAO,GAAG;IACd,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,OAAO,GAAG;IACpB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;IAC1B,IAAI;IACJ,IAAI,MAAM,QAAQ,GAAG;IACrB,QAAQ,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE;IACrD,IAAI;IACJ,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,uBAAuB,GAAG;IACpC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,wBAAwB,GAAG;IACrC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ,IAAI,MAAM,cAAc,GAAG;IAC3B,QAAQ,OAAO;IACf,YAAY,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;IACjE,SAAS;IACT,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/AppPlugin/AppPlugin.swift

@@ -12,11 +12,20 @@ public class AppPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "getLaunchUrl", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "getState", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "minimizeApp", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "toggleBackButtonHandler", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "toggleBackButtonHandler", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "toggleEdgeGestureHandler", returnType: CAPPluginReturnPromise)
     ]
     private var observers: [NSObjectProtocol] = []
+    private var leftEdgePanRecognizer: UIScreenEdgePanGestureRecognizer?
+    private var rightEdgePanRecognizer: UIScreenEdgePanGestureRecognizer?
 
     override public func load() {
+        if getConfig().getBoolean("enableEdgeGestureHandler", false) {
+            DispatchQueue.main.async { [weak self] in
+                self?.loadGestureRecognizers()
+            }
+        }
+
         NotificationCenter.default.addObserver(self, selector: #selector(self.handleUrlOpened(notification:)), name: Notification.Name.capacitorOpenURL, object: nil)
         NotificationCenter.default.addObserver(self, selector: #selector(self.handleUniversalLink(notification:)), name: Notification.Name.capacitorOpenUniversalLink, object: nil)
         observers.append(NotificationCenter.default.addObserver(forName: UIApplication.didBecomeActiveNotification, object: nil, queue: OperationQueue.main) { [weak self] (_) in
@@ -125,4 +134,104 @@ public class AppPlugin: CAPPlugin, CAPBridgedPlugin {
     @objc func toggleBackButtonHandler(_ call: CAPPluginCall) {
         call.unimplemented()
     }
+
+    @objc func toggleEdgeGestureHandler(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            if call.getBool("enabled", false) {
+                self.loadGestureRecognizers()
+            } else {
+                self.destroyGestureRecognizers()
+            }
+
+            call.resolve()
+        }
+    }
+
+    @objc func handleEdgePan(_ recognizer: UIScreenEdgePanGestureRecognizer) {
+        guard let view = bridge?.webView else { return }
+
+        let translation = recognizer.translation(in: view)
+        let touch = recognizer.location(in: view)
+        let viewWidth = view.bounds.width
+        let viewHeight = view.bounds.height
+
+        var data: [String: Any] = [:]
+
+        data["touchX"] = touch.x
+        data["touchY"] = touch.y
+
+        switch recognizer.edges {
+        case .left:
+            let progress = translation.x / viewWidth
+            data["swipeEdge"] = "left"
+            data["progress"] = max(0, min(1, progress))
+        case .right:
+            let progress = -translation.x / viewWidth
+            data["swipeEdge"] = "right"
+            data["progress"] = max(0, min(1, progress))
+        default:
+            break
+        }
+
+        switch recognizer.state {
+        case .began:
+            data["phase"] = "start"
+        case .changed:
+            data["phase"] = "progress"
+        case .ended:
+            data["phase"] = "commit"
+        case .cancelled:
+            data["phase"] = "cancel"
+        case .failed:
+            data["phase"] = "cancel"
+        case .possible:
+            break
+        @unknown default:
+            break
+        }
+
+        // dont notify if there is no phase
+        guard data["phase"] != nil else { return }
+
+        if hasListeners("edgeGesture") {
+            notifyListeners("edgeGesture", data: data)
+        }
+    }
+
+    private func loadGestureRecognizers() {
+        guard self.leftEdgePanRecognizer == nil, self.rightEdgePanRecognizer == nil else { return }
+        guard let window = bridge?.viewController?.view.window else { return }
+
+        let leftEdgePanRecognizer = UIScreenEdgePanGestureRecognizer(target: self, action: #selector(self.handleEdgePan(_:)))
+        leftEdgePanRecognizer.delegate = self
+        leftEdgePanRecognizer.edges = .left
+
+        let rightEdgePanRecognizer = UIScreenEdgePanGestureRecognizer(target: self, action: #selector(self.handleEdgePan(_:)))
+        rightEdgePanRecognizer.delegate = self
+        rightEdgePanRecognizer.edges = .right
+
+        window.addGestureRecognizer(leftEdgePanRecognizer)
+        window.addGestureRecognizer(rightEdgePanRecognizer)
+
+        self.leftEdgePanRecognizer = leftEdgePanRecognizer
+        self.rightEdgePanRecognizer = rightEdgePanRecognizer
+    }
+
+    private func destroyGestureRecognizers() {
+        guard let leftEdgePanRecognizer = self.leftEdgePanRecognizer,
+              let rightEdgePanRecognizer = self.rightEdgePanRecognizer
+        else { return }
+
+        leftEdgePanRecognizer.view?.removeGestureRecognizer(leftEdgePanRecognizer)
+        rightEdgePanRecognizer.view?.removeGestureRecognizer(rightEdgePanRecognizer)
+
+        self.leftEdgePanRecognizer = nil
+        self.rightEdgePanRecognizer = nil
+    }
+}
+
+extension AppPlugin: UIGestureRecognizerDelegate {
+    public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
+        return gestureRecognizer === leftEdgePanRecognizer || gestureRecognizer === rightEdgePanRecognizer
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capacitor/app",
-  "version": "8.1.0",
+  "version": "8.1.1-dev-2542-20260611T172948.0",
   "description": "The App API handles high level App state and events.For example, this API emits events when the app enters and leaves the foreground, handles deeplinks, opens other apps, and manages persisted plugin state.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -47,11 +47,11 @@
     "publish:cocoapod": "pod trunk push ./CapacitorApp.podspec --allow-warnings"
   },
   "devDependencies": {
-    "@capacitor/android": "^8.0.0",
-    "@capacitor/cli": "^8.0.0",
-    "@capacitor/core": "^8.0.0",
+    "@capacitor/android": "next",
+    "@capacitor/cli": "next",
+    "@capacitor/core": "next",
     "@capacitor/docgen": "0.3.0",
-    "@capacitor/ios": "^8.0.0",
+    "@capacitor/ios": "next",
     "@ionic/eslint-config": "^0.4.0",
     "@ionic/prettier-config": "^4.0.0",
     "@ionic/swiftlint-config": "^2.0.0",
@@ -64,7 +64,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@capacitor/core": ">=8.0.0"
+    "@capacitor/core": ">=9.0.0-alpha.0"
   },
   "prettier": "@ionic/prettier-config",
   "swiftlint": "@ionic/swiftlint-config",
@@ -81,6 +81,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "gitHead": "3678f5063762e8d9857ddb4f41aae5f65ead91fa"
+  }
 }