@capgo/capacitor-updater 8.47.10 → 8.47.11

package/README.md

@@ -323,8 +323,9 @@ CapacitorUpdater can be configured with these options:
 | **`keepUrlPathAfterReload`**    | <code>boolean</code>                                                                                       | Configure the plugin to keep the URL path after a reload. WARNING: When a reload is triggered, 'window.history' will be cleared.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <code>false</code>                                                            | 6.8.0   |
 | **`disableJSLogging`**          | <code>boolean</code>                                                                                       | Disable the JavaScript logging of the plugin. if true, the plugin will not log to the JavaScript console. only the native log will be done                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | <code>false</code>                                                            | 7.3.0   |
 | **`osLogging`**                 | <code>boolean</code>                                                                                       | Enable OS-level logging. When enabled, logs are written to the system log which can be inspected in production builds. - **iOS**: Uses os_log instead of Swift.print, logs accessible via Console.app or Instruments - **Android**: Logs to Logcat (android.util.Log) When set to false, system logging is disabled on both platforms (only JavaScript console logging will occur if enabled). This is useful for debugging production apps (App Store/TestFlight builds on iOS, or production APKs on Android).                                                                                                                                                                                                                                                                                                                                                                                                       | <code>true</code>                                                             | 8.42.0  |
-| **`shakeMenu`**                 | <code>boolean</code>                                                                                       | Enable the shake gesture while a preview session is active. Outside preview sessions this preview menu is ignored, unless {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | <code>false</code>                                                            | 7.5.0   |
-| **`allowShakeChannelSelector`** | <code>boolean</code>                                                                                       | Enable the shake gesture to show a channel selector menu for switching between update channels. If {@link PluginsConfig.CapacitorUpdater.shakeMenu} is also enabled while a preview session is active, the shake menu includes both preview actions and channel switching. Only available for Android and iOS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | <code>false</code>                                                            | 8.43.0  |
+| **`shakeMenu`**                 | <code>boolean</code>                                                                                       | Enable the native preview menu gesture while a preview session is active. Outside preview sessions this preview menu is ignored, unless {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <code>false</code>                                                            | 7.5.0   |
+| **`shakeMenuGesture`**          | <code><a href="#shakemenugesture">ShakeMenuGesture</a></code>                                              | Choose which native gesture opens the preview/channel menu. This applies to both {@link PluginsConfig.CapacitorUpdater.shakeMenu} and {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}. Only available for Android and iOS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | <code>'shake'</code>                                                          | 8.48.0  |
+| **`allowShakeChannelSelector`** | <code>boolean</code>                                                                                       | Enable the native menu gesture to show a channel selector menu for switching between update channels. If {@link PluginsConfig.CapacitorUpdater.shakeMenu} is also enabled while a preview session is active, the shake menu includes both preview actions and channel switching. The native gesture can be changed with {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}. Only available for Android and iOS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | <code>false</code>                                                            | 8.43.0  |
 
 ### Examples
 
@@ -370,6 +371,7 @@ In `capacitor.config.json`:
       "disableJSLogging": undefined,
       "osLogging": undefined,
       "shakeMenu": undefined,
+      "shakeMenuGesture": undefined,
       "allowShakeChannelSelector": undefined
     }
   }
@@ -422,6 +424,7 @@ const config: CapacitorConfig = {
       disableJSLogging: undefined,
       osLogging: undefined,
       shakeMenu: undefined,
+      shakeMenuGesture: undefined,
       allowShakeChannelSelector: undefined,
     },
   },
@@ -1826,9 +1829,9 @@ Use this to:
 setShakeMenu(options: SetShakeMenuOptions) => Promise<void>
 ```
 
-Enable or disable the shake gesture menu.
+Enable or disable the native preview menu gesture.
 
-During preview sessions, users can shake their device to:
+During preview sessions, users can use the configured native gesture to:
 - Reload the current preview
 - Leave the test app and return to the fallback bundle
 - Switch update channel, when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is also enabled
@@ -1838,7 +1841,9 @@ shown outside preview sessions when {@link PluginsConfig.CapacitorUpdater.allowS
 
 **Important:** Disable this in production builds or only enable for internal testers.
 
-Can also be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.
+This can also be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.
+The native gesture can be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}
+or `options.gesture`.
 
 | Param         | Type                                                                |
 | ------------- | ------------------------------------------------------------------- |
@@ -1855,7 +1860,7 @@ Can also be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.
 isShakeMenuEnabled() => Promise<ShakeMenuEnabled>
 ```
 
-Check if the shake gesture debug menu is currently enabled.
+Check if the native preview menu gesture is currently enabled.
 
 Returns the current state of the shake menu feature that can be toggled via
 {@link setShakeMenu} or configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.
@@ -1878,13 +1883,15 @@ Use this to:
 setShakeChannelSelector(options: SetShakeChannelSelectorOptions) => Promise<void>
 ```
 
-Enable or disable the shake channel selector at runtime.
+Enable or disable the channel selector menu gesture at runtime.
 
-When enabled, shaking the device can show a channel selector, including outside preview sessions.
+When enabled, the configured native gesture can show a channel selector, including outside preview sessions.
 If {@link setShakeMenu} is also enabled while a preview session is active, the shake menu includes
 both preview actions and channel switching.
 
-Can also be configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.
+This can also be configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.
+The native gesture can be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}
+or {@link setShakeMenu}.
 
 | Param         | Type                                                                                      |
 | ------------- | ----------------------------------------------------------------------------------------- |
@@ -2547,16 +2554,18 @@ State information for flexible update progress (Android only).
 
 ##### SetShakeMenuOptions
 
-| Prop          | Type                 |
-| ------------- | -------------------- |
-| **`enabled`** | <code>boolean</code> |
+| Prop          | Type                                                          | Description                                           | Default              |
+| ------------- | ------------------------------------------------------------- | ----------------------------------------------------- | -------------------- |
+| **`enabled`** | <code>boolean</code>                                          |                                                       |                      |
+| **`gesture`** | <code><a href="#shakemenugesture">ShakeMenuGesture</a></code> | Native gesture used to open the preview/channel menu. | <code>'shake'</code> |
 
 
 ##### ShakeMenuEnabled
 
-| Prop          | Type                 |
-| ------------- | -------------------- |
-| **`enabled`** | <code>boolean</code> |
+| Prop          | Type                                                          | Description                                                                                                                                                        | Since  |
+| ------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
+| **`enabled`** | <code>boolean</code>                                          |                                                                                                                                                                    |        |
+| **`gesture`** | <code><a href="#shakemenugesture">ShakeMenuGesture</a></code> | The currently configured native gesture used to open the preview/channel menu. Undefined means consumers should treat the gesture as the default `shake` behavior. | 8.48.0 |
 
 
 ##### SetShakeChannelSelectorOptions
@@ -2669,6 +2678,15 @@ Payload emitted by {@link CapacitorUpdaterPlugin.addListener} with `breakingAvai
 <code><a href="#majoravailableevent">MajorAvailableEvent</a></code>
 
 
+##### ShakeMenuGesture
+
+Native gesture options that open the shake menu.
+
+Supported values are `shake` and `threeFingerPinch`.
+
+<code>'shake' | 'threeFingerPinch'</code>
+
+
 #### Enums
 
 

package/android/src/main/java/ee/forgr/capacitor_updater/CapacitorUpdaterPlugin.java

@@ -79,6 +79,9 @@ import org.json.JSONObject;
 @CapacitorPlugin(name = "CapacitorUpdater")
 public class CapacitorUpdaterPlugin extends Plugin {
 
+    static final String SHAKE_MENU_GESTURE_SHAKE = "shake";
+    static final String SHAKE_MENU_GESTURE_THREE_FINGER_PINCH = "threeFingerPinch";
+
     private static final String AUTO_UPDATE_MODE_OFF = "off";
     private static final String AUTO_UPDATE_MODE_BACKGROUND = "atBackground";
     private static final String AUTO_UPDATE_MODE_INSTALL = "atInstall";
@@ -160,6 +163,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
     private volatile boolean onLaunchDirectUpdateUsed = false;
     Boolean shakeMenuEnabled = false;
     Boolean shakeChannelSelectorEnabled = false;
+    String shakeMenuGesture = SHAKE_MENU_GESTURE_SHAKE;
     volatile Boolean previewSessionEnabled = false;
     private Boolean previewSessionAlertPending = false;
     private volatile Boolean isLeavingPreviewForIncomingLink = false;
@@ -526,6 +530,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
         this.implementation.timeout = this.getConfig().getInt("responseTimeout", 20) * 1000;
         this.shakeMenuEnabled = this.getConfig().getBoolean("shakeMenu", false);
         this.shakeChannelSelectorEnabled = this.getConfig().getBoolean("allowShakeChannelSelector", false);
+        this.shakeMenuGesture = normalizedShakeMenuGesture(this.getConfig().getString("shakeMenuGesture", SHAKE_MENU_GESTURE_SHAKE));
         this.previewSessionEnabled = Boolean.TRUE.equals(this.allowPreview) && this.prefs.getBoolean(PREVIEW_SESSION_PREF_KEY, false);
         if (!Boolean.TRUE.equals(this.allowPreview) && this.prefs.getBoolean(PREVIEW_SESSION_PREF_KEY, false)) {
             this.clearPreviewSessionBecauseDisabled();
@@ -1504,6 +1509,28 @@ public class CapacitorUpdaterPlugin extends Plugin {
         }
     }
 
+    static String normalizedShakeMenuGesture(final String value) {
+        if (value == null || value.trim().isEmpty()) {
+            return SHAKE_MENU_GESTURE_SHAKE;
+        }
+        final String normalized = value.trim();
+        if (SHAKE_MENU_GESTURE_THREE_FINGER_PINCH.equals(normalized)) {
+            return SHAKE_MENU_GESTURE_THREE_FINGER_PINCH;
+        }
+        return SHAKE_MENU_GESTURE_SHAKE;
+    }
+
+    static boolean isSupportedShakeMenuGesture(final String value) {
+        if (value == null) {
+            return true;
+        }
+        final String normalized = value.trim();
+        if (normalized.isEmpty()) {
+            return false;
+        }
+        return SHAKE_MENU_GESTURE_SHAKE.equals(normalized) || SHAKE_MENU_GESTURE_THREE_FINGER_PINCH.equals(normalized);
+    }
+
     static String autoUpdateModeForLegacyDirectUpdateMode(final String directUpdateMode) {
         switch (directUpdateMode) {
             case AUTO_UPDATE_MODE_INSTALL:
@@ -2736,6 +2763,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
         this.hidePreviewTransitionLoader("preview-session-disabled");
         this.shakeMenuEnabled = this.getConfig().getBoolean("shakeMenu", false);
         this.shakeChannelSelectorEnabled = this.getConfig().getBoolean("allowShakeChannelSelector", false);
+        this.shakeMenuGesture = normalizedShakeMenuGesture(this.getConfig().getString("shakeMenuGesture", SHAKE_MENU_GESTURE_SHAKE));
         this.syncShakeMenuLifecycle();
         this.clearPreviewSessionPreferences();
     }
@@ -2959,6 +2987,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
         this.implementation.previewSession = false;
         this.shakeMenuEnabled = this.getConfig().getBoolean("shakeMenu", false);
         this.shakeChannelSelectorEnabled = this.getConfig().getBoolean("allowShakeChannelSelector", false);
+        this.shakeMenuGesture = normalizedShakeMenuGesture(this.getConfig().getString("shakeMenuGesture", SHAKE_MENU_GESTURE_SHAKE));
         this.syncShakeMenuLifecycle();
         this.restorePreviewPreviousAppId();
         this.restorePreviewPreviousDefaultChannel();
@@ -2982,14 +3011,26 @@ public class CapacitorUpdaterPlugin extends Plugin {
     private void ensureShakeMenuStarted() {
         if (getActivity() instanceof com.getcapacitor.BridgeActivity && shakeMenu == null) {
             try {
-                shakeMenu = new ShakeMenu(this, (com.getcapacitor.BridgeActivity) getActivity(), logger);
-                logger.info("Shake menu initialized");
+                shakeMenu = new ShakeMenu(this, (com.getcapacitor.BridgeActivity) getActivity(), logger, this.shakeMenuGesture);
+                logger.info("Shake menu initialized with " + this.shakeMenuGesture + " gesture");
             } catch (Exception e) {
                 logger.error("Failed to initialize shake menu: " + e.getMessage());
             }
         }
     }
 
+    private void restartShakeMenuListener() {
+        if (shakeMenu != null) {
+            try {
+                shakeMenu.stop();
+            } catch (Exception e) {
+                logger.error("Failed to restart shake menu listener: " + e.getMessage());
+            }
+            shakeMenu = null;
+        }
+        this.syncShakeMenuLifecycle();
+    }
+
     private void syncShakeMenuLifecycle() {
         if (this.shouldListenForShake()) {
             this.ensureShakeMenuStarted();
@@ -4423,10 +4464,29 @@ public class CapacitorUpdaterPlugin extends Plugin {
             return;
         }
 
+        final String gesture = call.getString("gesture", null);
+        final boolean gestureChanged;
+        if (gesture != null) {
+            if (!isSupportedShakeMenuGesture(gesture)) {
+                logger.error("Unsupported shake menu gesture: " + gesture);
+                call.reject("Unsupported shake menu gesture. Use \"shake\" or \"threeFingerPinch\".");
+                return;
+            }
+            final String normalizedGesture = normalizedShakeMenuGesture(gesture);
+            gestureChanged = !normalizedGesture.equals(this.shakeMenuGesture);
+            this.shakeMenuGesture = normalizedGesture;
+        } else {
+            gestureChanged = false;
+        }
+
         this.shakeMenuEnabled = enabled;
-        logger.info("Shake menu " + (enabled ? "enabled" : "disabled"));
+        logger.info("Shake menu " + (enabled ? "enabled" : "disabled") + " with " + this.shakeMenuGesture + " gesture");
 
-        this.syncShakeMenuLifecycle();
+        if (gestureChanged) {
+            this.restartShakeMenuListener();
+        } else {
+            this.syncShakeMenuLifecycle();
+        }
 
         call.resolve();
     }
@@ -4436,6 +4496,7 @@ public class CapacitorUpdaterPlugin extends Plugin {
         try {
             final JSObject ret = new JSObject();
             ret.put("enabled", this.shakeMenuEnabled);
+            ret.put("gesture", this.shakeMenuGesture);
             call.resolve(ret);
         } catch (final Exception e) {
             logger.error("Could not get shake menu status " + e.getMessage());

package/android/src/main/java/ee/forgr/capacitor_updater/ShakeMenu.java

@@ -24,7 +24,7 @@ import java.util.List;
 import java.util.Map;
 import org.json.JSONArray;
 
-public class ShakeMenu implements ShakeDetector.Listener {
+public class ShakeMenu implements ShakeDetector.Listener, ThreeFingerPinchDetector.Listener {
 
     private interface PreviewMenuAction {
         boolean run();
@@ -33,28 +33,46 @@ public class ShakeMenu implements ShakeDetector.Listener {
     private CapacitorUpdaterPlugin plugin;
     private BridgeActivity activity;
     private ShakeDetector shakeDetector;
+    private ThreeFingerPinchDetector pinchDetector;
     private boolean isShowing = false;
     private Logger logger;
 
-    public ShakeMenu(CapacitorUpdaterPlugin plugin, BridgeActivity activity, Logger logger) {
+    public ShakeMenu(CapacitorUpdaterPlugin plugin, BridgeActivity activity, Logger logger, String gesture) {
         this.plugin = plugin;
         this.activity = activity;
         this.logger = logger;
 
-        SensorManager sensorManager = (SensorManager) activity.getSystemService(Activity.SENSOR_SERVICE);
-        this.shakeDetector = new ShakeDetector(this);
-        this.shakeDetector.start(sensorManager);
+        if (CapacitorUpdaterPlugin.SHAKE_MENU_GESTURE_THREE_FINGER_PINCH.equals(gesture)) {
+            this.pinchDetector = new ThreeFingerPinchDetector(this, logger);
+            this.pinchDetector.start(activity);
+        } else {
+            SensorManager sensorManager = (SensorManager) activity.getSystemService(Activity.SENSOR_SERVICE);
+            this.shakeDetector = new ShakeDetector(this);
+            this.shakeDetector.start(sensorManager);
+        }
     }
 
     public void stop() {
         if (shakeDetector != null) {
             shakeDetector.stop();
         }
+        if (pinchDetector != null) {
+            pinchDetector.stop();
+        }
     }
 
     @Override
     public void onShakeDetected() {
-        logger.info("Shake detected");
+        onMenuGestureDetected("Shake");
+    }
+
+    @Override
+    public void onThreeFingerPinchDetected() {
+        onMenuGestureDetected("Three finger pinch");
+    }
+
+    private void onMenuGestureDetected(String gestureName) {
+        logger.info(gestureName + " detected");
 
         boolean canShowPreviewMenu = Boolean.TRUE.equals(plugin.shakeMenuEnabled) && plugin.hasActivePreviewSession();
         boolean canShowChannelSelector = Boolean.TRUE.equals(plugin.shakeChannelSelectorEnabled);

package/android/src/main/java/ee/forgr/capacitor_updater/ThreeFingerPinchDetector.java

@@ -0,0 +1,169 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package ee.forgr.capacitor_updater;
+
+import android.view.MotionEvent;
+import android.view.View;
+import com.getcapacitor.Bridge;
+import com.getcapacitor.BridgeActivity;
+import java.lang.reflect.Field;
+
+public class ThreeFingerPinchDetector implements View.OnTouchListener {
+
+    public interface Listener {
+        void onThreeFingerPinchDetected();
+    }
+
+    private static final int REQUIRED_POINTER_COUNT = 3;
+    private static final float MIN_SCALE_DELTA = 0.30f;
+    private static final long PINCH_TIMEOUT = 1000;
+
+    private final Listener listener;
+    private final Logger logger;
+    private View targetView;
+    private View.OnTouchListener previousOnTouchListener;
+    private boolean touchListenerInstalled = false;
+    private float initialSpan = 0;
+    private boolean tracking = false;
+    private boolean triggered = false;
+    private long lastPinchTime = 0;
+
+    public ThreeFingerPinchDetector(Listener listener, Logger logger) {
+        this.listener = listener;
+        this.logger = logger;
+    }
+
+    public void start(BridgeActivity activity) {
+        if (targetView != null) {
+            stop();
+        }
+
+        View view = null;
+        Bridge bridge = activity.getBridge();
+        if (bridge != null && bridge.getWebView() != null) {
+            view = bridge.getWebView();
+        }
+        if (view == null && activity.getWindow() != null) {
+            view = activity.getWindow().getDecorView().getRootView();
+        }
+        if (view == null) {
+            logger.warn("Three finger pinch detector could not find a target view");
+            return;
+        }
+
+        this.targetView = view;
+        this.previousOnTouchListener = getCurrentOnTouchListener(view);
+        if (this.previousOnTouchListener != this) {
+            this.targetView.setOnTouchListener(this);
+            this.touchListenerInstalled = true;
+        }
+    }
+
+    public void stop() {
+        if (targetView != null) {
+            View.OnTouchListener currentOnTouchListener = getCurrentOnTouchListener(targetView);
+            if (touchListenerInstalled && (currentOnTouchListener == this || currentOnTouchListener == null)) {
+                targetView.setOnTouchListener(previousOnTouchListener);
+            }
+            targetView = null;
+            previousOnTouchListener = null;
+            touchListenerInstalled = false;
+        }
+        reset();
+    }
+
+    @Override
+    public boolean onTouch(View view, MotionEvent event) {
+        boolean consumedByPreviousListener = false;
+        if (previousOnTouchListener != null && previousOnTouchListener != this) {
+            consumedByPreviousListener = previousOnTouchListener.onTouch(view, event);
+        }
+
+        int action = event.getActionMasked();
+        if (action == MotionEvent.ACTION_CANCEL || action == MotionEvent.ACTION_UP || action == MotionEvent.ACTION_POINTER_UP) {
+            reset();
+            return consumedByPreviousListener;
+        }
+
+        if (event.getPointerCount() != REQUIRED_POINTER_COUNT) {
+            if (action == MotionEvent.ACTION_POINTER_DOWN) {
+                reset();
+            }
+            return consumedByPreviousListener;
+        }
+
+        float span = calculateSpan(event);
+        if (span <= 0) {
+            return consumedByPreviousListener;
+        }
+
+        if (!tracking || action == MotionEvent.ACTION_POINTER_DOWN) {
+            initialSpan = span;
+            tracking = true;
+            triggered = false;
+            return consumedByPreviousListener;
+        }
+
+        if (!triggered && Math.abs(span - initialSpan) / initialSpan >= MIN_SCALE_DELTA) {
+            long currentTime = System.currentTimeMillis();
+            if (currentTime - lastPinchTime > PINCH_TIMEOUT) {
+                triggered = true;
+                lastPinchTime = currentTime;
+                if (listener != null) {
+                    listener.onThreeFingerPinchDetected();
+                }
+            }
+        }
+
+        return consumedByPreviousListener;
+    }
+
+    private float calculateSpan(MotionEvent event) {
+        float centerX = 0;
+        float centerY = 0;
+        for (int i = 0; i < REQUIRED_POINTER_COUNT; i++) {
+            centerX += event.getX(i);
+            centerY += event.getY(i);
+        }
+        centerX /= REQUIRED_POINTER_COUNT;
+        centerY /= REQUIRED_POINTER_COUNT;
+
+        float totalDistance = 0;
+        for (int i = 0; i < REQUIRED_POINTER_COUNT; i++) {
+            float dx = event.getX(i) - centerX;
+            float dy = event.getY(i) - centerY;
+            totalDistance += Math.sqrt(dx * dx + dy * dy);
+        }
+        return totalDistance / REQUIRED_POINTER_COUNT;
+    }
+
+    private View.OnTouchListener getCurrentOnTouchListener(View view) {
+        try {
+            Field listenerInfoField = View.class.getDeclaredField("mListenerInfo");
+            listenerInfoField.setAccessible(true);
+            Object listenerInfo = listenerInfoField.get(view);
+            if (listenerInfo == null) {
+                return null;
+            }
+            Field onTouchListenerField = listenerInfo.getClass().getDeclaredField("mOnTouchListener");
+            onTouchListenerField.setAccessible(true);
+            Object listener = onTouchListenerField.get(listenerInfo);
+            if (listener instanceof View.OnTouchListener) {
+                return (View.OnTouchListener) listener;
+            }
+        } catch (ReflectiveOperationException | RuntimeException exception) {
+            logger.warn("Three finger pinch detector could not inspect the current touch listener: " + exception.getMessage());
+        }
+        return null;
+    }
+
+    private void reset() {
+        initialSpan = 0;
+        tracking = false;
+        triggered = false;
+    }
+}

package/dist/docs.json

@@ -1431,7 +1431,7 @@
             "text": "7.5.0"
           }
         ],
-        "docs": "Enable or disable the shake gesture menu.\n\nDuring preview sessions, users can shake their device to:\n- Reload the current preview\n- Leave the test app and return to the fallback bundle\n- Switch update channel, when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is also enabled\n\nOutside preview sessions, this preview menu is ignored. The channel selector can still be\nshown outside preview sessions when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.\n\n**Important:** Disable this in production builds or only enable for internal testers.\n\nCan also be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.",
+        "docs": "Enable or disable the native preview menu gesture.\n\nDuring preview sessions, users can use the configured native gesture to:\n- Reload the current preview\n- Leave the test app and return to the fallback bundle\n- Switch update channel, when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is also enabled\n\nOutside preview sessions, this preview menu is ignored. The channel selector can still be\nshown outside preview sessions when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.\n\n**Important:** Disable this in production builds or only enable for internal testers.\n\nThis can also be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.\nThe native gesture can be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}\nor `options.gesture`.",
         "complexTypes": [
           "SetShakeMenuOptions"
         ],
@@ -1445,7 +1445,7 @@
         "tags": [
           {
             "name": "returns",
-            "text": "Object with `enabled: true` or `enabled: false`."
+            "text": "Object with the current enabled state and gesture."
           },
           {
             "name": "throws",
@@ -1456,7 +1456,7 @@
             "text": "7.5.0"
           }
         ],
-        "docs": "Check if the shake gesture debug menu is currently enabled.\n\nReturns the current state of the shake menu feature that can be toggled via\n{@link setShakeMenu} or configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.\n\nUse this to:\n- Check if debug features are enabled\n- Show/hide debug settings UI\n- Verify configuration during testing",
+        "docs": "Check if the native preview menu gesture is currently enabled.\n\nReturns the current state of the shake menu feature that can be toggled via\n{@link setShakeMenu} or configured via {@link PluginsConfig.CapacitorUpdater.shakeMenu}.\n\nUse this to:\n- Check if debug features are enabled\n- Show/hide debug settings UI\n- Verify configuration during testing",
         "complexTypes": [
           "ShakeMenuEnabled"
         ],
@@ -1495,7 +1495,7 @@
             "text": "8.43.0"
           }
         ],
-        "docs": "Enable or disable the shake channel selector at runtime.\n\nWhen enabled, shaking the device can show a channel selector, including outside preview sessions.\nIf {@link setShakeMenu} is also enabled while a preview session is active, the shake menu includes\nboth preview actions and channel switching.\n\nCan also be configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.",
+        "docs": "Enable or disable the channel selector menu gesture at runtime.\n\nWhen enabled, the configured native gesture can show a channel selector, including outside preview sessions.\nIf {@link setShakeMenu} is also enabled while a preview session is active, the shake menu includes\nboth preview actions and channel switching.\n\nThis can also be configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.\nThe native gesture can be configured via {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}\nor {@link setShakeMenu}.",
         "complexTypes": [
           "SetShakeChannelSelectorOptions"
         ],
@@ -3442,6 +3442,20 @@
           "docs": "",
           "complexTypes": [],
           "type": "boolean"
+        },
+        {
+          "name": "gesture",
+          "tags": [
+            {
+              "text": "'shake'",
+              "name": "default"
+            }
+          ],
+          "docs": "Native gesture used to open the preview/channel menu.",
+          "complexTypes": [
+            "ShakeMenuGesture"
+          ],
+          "type": "ShakeMenuGesture"
         }
       ]
     },
@@ -3458,6 +3472,20 @@
           "docs": "",
           "complexTypes": [],
           "type": "boolean"
+        },
+        {
+          "name": "gesture",
+          "tags": [
+            {
+              "text": "8.48.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The currently configured native gesture used to open the preview/channel menu.\nUndefined means consumers should treat the gesture as the default `shake` behavior.",
+          "complexTypes": [
+            "ShakeMenuGesture"
+          ],
+          "type": "ShakeMenuGesture"
         }
       ]
     },
@@ -3986,6 +4014,21 @@
           ]
         }
       ]
+    },
+    {
+      "name": "ShakeMenuGesture",
+      "slug": "shakemenugesture",
+      "docs": "Native gesture options that open the shake menu.\n\nSupported values are `shake` and `threeFingerPinch`.",
+      "types": [
+        {
+          "text": "'shake'",
+          "complexTypes": []
+        },
+        {
+          "text": "'threeFingerPinch'",
+          "complexTypes": []
+        }
+      ]
     }
   ],
   "pluginConfigs": [
@@ -4573,10 +4616,28 @@
               "name": "since"
             }
           ],
-          "docs": "Enable the shake gesture while a preview session is active.\nOutside preview sessions this preview menu is ignored, unless\n{@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.",
+          "docs": "Enable the native preview menu gesture while a preview session is active.\nOutside preview sessions this preview menu is ignored, unless\n{@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.",
           "complexTypes": [],
           "type": "boolean | undefined"
         },
+        {
+          "name": "shakeMenuGesture",
+          "tags": [
+            {
+              "text": "'shake'",
+              "name": "default"
+            },
+            {
+              "text": "8.48.0",
+              "name": "since"
+            }
+          ],
+          "docs": "Choose which native gesture opens the preview/channel menu.\nThis applies to both {@link PluginsConfig.CapacitorUpdater.shakeMenu}\nand {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.\n\nOnly available for Android and iOS.",
+          "complexTypes": [
+            "ShakeMenuGesture"
+          ],
+          "type": "ShakeMenuGesture"
+        },
         {
           "name": "allowShakeChannelSelector",
           "tags": [
@@ -4589,7 +4650,7 @@
               "name": "since"
             }
           ],
-          "docs": "Enable the shake gesture to show a channel selector menu for switching between update channels.\nIf {@link PluginsConfig.CapacitorUpdater.shakeMenu} is also enabled while a preview session is active,\nthe shake menu includes both preview actions and channel switching.\n\nOnly available for Android and iOS.",
+          "docs": "Enable the native menu gesture to show a channel selector menu for switching between update channels.\nIf {@link PluginsConfig.CapacitorUpdater.shakeMenu} is also enabled while a preview session is active,\nthe shake menu includes both preview actions and channel switching.\nThe native gesture can be changed with {@link PluginsConfig.CapacitorUpdater.shakeMenuGesture}.\n\nOnly available for Android and iOS.",
           "complexTypes": [],
           "type": "boolean | undefined"
         }