detox 20.27.6 → 20.28.0

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0-sources.jar.md5

@@ -0,0 +1 @@
+5f9c61888ac541880ca966b9cf54f996

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0-sources.jar.sha1

@@ -0,0 +1 @@
+905d3c70363af1ef378373c1337b2a02fb085847

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0-sources.jar.sha256

@@ -0,0 +1 @@
+9da6d1b24a67e2c3f54e4f85b76d2f308df4f4783a2ead715cacae4078d54198

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0-sources.jar.sha512

@@ -0,0 +1 @@
+488ca79bd9330a788fe0659818e9256d06908d3c9ff765ddf9ee41e253b78dbbb0db1409f794532019fa39ca3395c8a27396398cbe56d203989afb258c31f1b8

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.aar.md5

@@ -0,0 +1 @@
+2d6e006f6dc0428fd9be3efb971433cf

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.aar.sha1

@@ -0,0 +1 @@
+7e71f1e0bd4e0beea5f2c8db164c560255332a30

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.aar.sha256

@@ -0,0 +1 @@
+d0d12c5ecb2c4d760332b168a9237aa1948ac10ea1736a4b75067de6ebaaf6cb

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.aar.sha512

@@ -0,0 +1 @@
+1ebe46cd76b0bcfdcab9fc6b1a863b257da71ee05bac63f538fab1351f55ba858d97b81aba1d040d5db74c9e27508b12dbeb6ae2e6c09ef469a184516fc82c00

package/Detox-android/com/wix/detox/{20.27.6/detox-20.27.6.pom → 20.28.0/detox-20.28.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.27.6</version>
+  <version>20.28.0</version>
   <packaging>aar</packaging>
   <name>Detox</name>
   <description>Gray box end-to-end testing and automation library for mobile apps</description>

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.pom.md5

@@ -0,0 +1 @@
+72dd9fb9e071a00dfb6b7731da5a8268

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.pom.sha1

@@ -0,0 +1 @@
+5ea89a7c06c7d3e3ebee78b290422c25471ffccf

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.pom.sha256

@@ -0,0 +1 @@
+48839af705f5ce69be3f8075367e012c822f2cb9b4d5d66d1466c718f7adecd4

package/Detox-android/com/wix/detox/20.28.0/detox-20.28.0.pom.sha512

@@ -0,0 +1 @@
+01b1f663413f39c8f25e81f70669ddce75f2f332f154c531cb5289a646d25e3cc80120580202da5bc3cf1e4fd865a61b0551126be9da37b61eeec6f75fc2b9cf

package/Detox-android/com/wix/detox/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.27.6</latest>
-    <release>20.27.6</release>
+    <latest>20.28.0</latest>
+    <release>20.28.0</release>
     <versions>
-      <version>20.27.6</version>
+      <version>20.28.0</version>
     </versions>
-    <lastUpdated>20241028085405</lastUpdated>
+    <lastUpdated>20241114182711</lastUpdated>
   </versioning>
 </metadata>

package/Detox-android/com/wix/detox/maven-metadata.xml.md5

@@ -1 +1 @@
-c6048a4804a00c640dd27f84e2452c46
+4409ef64d1213179048bfd9fed283361

package/Detox-android/com/wix/detox/maven-metadata.xml.sha1

@@ -1 +1 @@
-6d5a74fb04b17b1bcf036c6bef0cc9e89c149b96
+112cd653d1f7777391df1fb10e9a33619f5d0c1b

package/Detox-android/com/wix/detox/maven-metadata.xml.sha256

@@ -1 +1 @@
-27ca3908ac60eb0dbb4345d0cf06eb099cda5bf717bea60add2a0fc7b9a66d3f
+2177b496977ac272c3b7333fa2a4505f8756dca0bc265970801d60985a6a8dfd

package/Detox-android/com/wix/detox/maven-metadata.xml.sha512

@@ -1 +1 @@
-f3c8e726366163a7fac72e38412cd55257d21b3927305a2210851e4bc70d83298aa30a830a2d1ece614e2aeee3bb68065f8964442a1e5125d82bb5b6ca8a88bd
+da830892bc25886891e341fe7e167f4aa1138c8fc2c28246d31409c39e82aa64f13c0a0a39bb6394a260ee2f449bf16e5378be6026cf1862759d57cec40fd053

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0-sources.jar.md5

@@ -0,0 +1 @@
+d01d2e826e3b99f843a7e444d309d6d2

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0-sources.jar.sha1

@@ -0,0 +1 @@
+3cf94f158d84d98241e421c64cc5c06142fbf4c0

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0-sources.jar.sha256

@@ -0,0 +1 @@
+cb302fd2cd81b8ba3a03115ab529d073bb8f223af0088e89e22af90120117412

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0-sources.jar.sha512

@@ -0,0 +1 @@
+37109f12c35e795d76f25a7c462c143dcedbbd0cb66bdde25364f237754da179307e87b73fae67e5432b7724903abe485c5105ac5667a7f6f26806b6c5229d88

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.aar.md5

@@ -0,0 +1 @@
+f3e0e6447e243a7a93b9425d8ca2c34d

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.aar.sha1

@@ -0,0 +1 @@
+135215a6c872a80b0020ecface42fd07fde6e8a2

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.aar.sha256

@@ -0,0 +1 @@
+67f6e9df85d01f17887b135aa64b3db8b10afce941b70314fa1cc15580699102

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.aar.sha512

@@ -0,0 +1 @@
+a71be556721d9c7b600914bcbeaff171d0d959a3dbb816d4467c8f52caa5703d9b241c0a76c13e4010c57036fff63b0c157eb126c58a96fe593ef1a71dcd3778

package/Detox-android/com/wix/detox-legacy/{20.27.6/detox-legacy-20.27.6.pom → 20.28.0/detox-legacy-20.28.0.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox-legacy</artifactId>
-  <version>20.27.6</version>
+  <version>20.28.0</version>
   <packaging>aar</packaging>
   <name>Detox</name>
   <description>Gray box end-to-end testing and automation library for mobile apps</description>

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.pom.md5

@@ -0,0 +1 @@
+2c9a5efdc4cc9949403de29543d189c3

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.pom.sha1

@@ -0,0 +1 @@
+dd1b295394376809aa40565060e7f0068758476d

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.pom.sha256

@@ -0,0 +1 @@
+28a059a24a50d3e94b75af039c1aee8dd403bb862525cce01876a4a188313eb1

package/Detox-android/com/wix/detox-legacy/20.28.0/detox-legacy-20.28.0.pom.sha512

@@ -0,0 +1 @@
+252cf3d47cd05805ab38367c8b33793b5b7e210a5f7f88717b1439127f168181bd5b3a05fa020c4c444aad0dfb6ad81547a7bc05ce6dc5f8043aff2eea3096f1

package/Detox-android/com/wix/detox-legacy/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox-legacy</artifactId>
   <versioning>
-    <latest>20.27.6</latest>
-    <release>20.27.6</release>
+    <latest>20.28.0</latest>
+    <release>20.28.0</release>
     <versions>
-      <version>20.27.6</version>
+      <version>20.28.0</version>
     </versions>
-    <lastUpdated>20241028085440</lastUpdated>
+    <lastUpdated>20241114182808</lastUpdated>
   </versioning>
 </metadata>

package/Detox-android/com/wix/detox-legacy/maven-metadata.xml.md5

@@ -1 +1 @@
-13ddd43ad56b9aa278e0c66d15b01b24
+dbb9351f570b2e9f79cd97583cda0e41

package/Detox-android/com/wix/detox-legacy/maven-metadata.xml.sha1

@@ -1 +1 @@
-80895bf7ff050aecd0f6952aa5515e30efc99ad2
+e043135169acc282528cb1990f80ae8be7fd89b2

package/Detox-android/com/wix/detox-legacy/maven-metadata.xml.sha256

@@ -1 +1 @@
-9bbe583005a3408878ff88161454adbde91024cabbccc59fbc76a88afcafca75
+723c473ca26e2ced79ca5d707aa4e96f068d3bb86577a66d54ae5c41231127f2

package/Detox-android/com/wix/detox-legacy/maven-metadata.xml.sha512

@@ -1 +1 @@
-a753957dcc440153f8fed723cd0520cb38f04d8ae87e491d92d09fe93b4f95602d3d07dea0ee145e18ae4621b33e42fa9f248e8c7586b77154d224b157879782
+5061e8696bf7b07237dd2b8fc02f65054eaaa87884723ca0f706b3b1de63e153e636db8077c6fdfd29ad8d0ca67433ff6a327bf6ffaddf040e671a2cafb4106e

package/android/detox/src/full/java/com/wix/detox/espresso/EspressoDetox.java

@@ -21,12 +21,11 @@ import java.util.ArrayList;
 
 import androidx.test.espresso.UiController;
 import androidx.test.espresso.ViewAction;
-import androidx.test.espresso.ViewInteraction;
-import androidx.test.espresso.NoMatchingViewException;
 import androidx.test.platform.app.InstrumentationRegistry;
 
 import static androidx.test.espresso.Espresso.onView;
 import static androidx.test.espresso.matcher.ViewMatchers.isRoot;
+import static com.wix.detox.espresso.UiAutomatorHelper.getStatusBarHeightDps;
 
 /**
  * Created by rotemm on 26/12/2016.
@@ -34,6 +33,10 @@ import static androidx.test.espresso.matcher.ViewMatchers.isRoot;
 public class EspressoDetox {
     private static final String LOG_TAG = "detox";
 
+    private static int calculateAdjustedY(View view, Integer y, boolean shouldIgnoreStatusBar) {
+        return shouldIgnoreStatusBar ? y + getStatusBarHeightDps(view) : y;
+    }
+
     public static Object perform(Matcher<View> matcher, ViewAction action) {
         ViewActionPerformer performer = ViewActionPerformer.forAction(action);
         return performer.performOn(matcher);
@@ -121,5 +124,53 @@ public class EspressoDetox {
             }
         });
     }
+
+    public static void tap(Integer x, Integer y, boolean shouldIgnoreStatusBar) {
+        onView(isRoot()).perform(new ViewAction() {
+            @Override
+            public Matcher<View> getConstraints() {
+                return isRoot();
+            }
+
+            @Override
+            public String getDescription() {
+                return "tap on screen";
+            }
+
+            @Override
+            public void perform(UiController uiController, View view) {
+                int adjustedY = calculateAdjustedY(view, y, shouldIgnoreStatusBar);
+                ViewAction action = DetoxAction.tapAtLocation(x, adjustedY);
+                action.perform(uiController, view);
+                uiController.loopMainThreadUntilIdle();
+            }
+        });
+    }
+
+    public static void longPress(Integer x, Integer y, boolean shouldIgnoreStatusBar) {
+        longPress(x, y, null, shouldIgnoreStatusBar);
+    }
+
+    public static void longPress(Integer x, Integer y, Integer duration, boolean shouldIgnoreStatusBar) {
+        onView(isRoot()).perform(new ViewAction() {
+            @Override
+            public Matcher<View> getConstraints() {
+                return isRoot();
+            }
+
+            @Override
+            public String getDescription() {
+                return "long press on screen";
+            }
+
+            @Override
+            public void perform(UiController uiController, View view) {
+                int adjustedY = calculateAdjustedY(view, y, shouldIgnoreStatusBar);
+                ViewAction action = DetoxAction.longPress(x, adjustedY, duration);
+                action.perform(uiController, view);
+                uiController.loopMainThreadUntilIdle();
+            }
+        });
+    }
 }
 

package/android/detox/src/full/java/com/wix/detox/espresso/UiAutomatorHelper.java

@@ -1,8 +1,13 @@
 package com.wix.detox.espresso;
 
+import android.annotation.SuppressLint;
+import android.content.Context;
 import android.os.Handler;
+import android.util.DisplayMetrics;
 import android.util.Log;
+import android.util.TypedValue;
 import android.view.Choreographer;
+import android.view.View;
 
 import com.wix.detox.common.UIThread;
 import com.wix.detox.espresso.action.common.utils.UiControllerUtils;
@@ -111,4 +116,10 @@ public class UiAutomatorHelper {
         }
     }
 
+    @SuppressLint({"DiscouragedApi", "InternalInsetResource"})
+    public static int getStatusBarHeightDps(View view) {
+        Context context = view.getContext();
+        int resourceId = context.getResources().getIdentifier("status_bar_height", "dimen", "android");
+        return (int) (context.getResources().getDimensionPixelSize(resourceId) / ((float) context.getResources().getDisplayMetrics().densityDpi / DisplayMetrics.DENSITY_DEFAULT));
+    }
 }

package/android/detox/src/full/java/com/wix/detox/espresso/matcher/IsDisplayingAtLeastDetoxMatcher.kt

@@ -120,7 +120,7 @@ class IsDisplayingAtLeastDetoxMatcher(private val areaPercentage: Int) : TypeSaf
             .defaultDisplay
             .getMetrics(m)
 
-        val statusBarHeight = getStatusBarHeight(view)
+        val statusBarHeight = getStatusBarHeightPixels(view)
         val actionBarHeight = getActionBarHeight(view)
         return Rect(0, 0, m.widthPixels, m.heightPixels - (statusBarHeight + actionBarHeight))
     }
@@ -138,7 +138,7 @@ class IsDisplayingAtLeastDetoxMatcher(private val areaPercentage: Int) : TypeSaf
     }
 
     @SuppressLint("InternalInsetResource", "DiscouragedApi")
-    private fun getStatusBarHeight(view: View): Int {
+    private fun getStatusBarHeightPixels(view: View): Int {
         val resourceId = view.context.resources.getIdentifier("status_bar_height", "dimen", "android")
         return if (resourceId > 0) view.context.resources.getDimensionPixelSize(resourceId) else 0
     }

package/detox.d.ts

@@ -784,6 +784,45 @@ declare global {
              */
             setOrientation(orientation: Orientation): Promise<void>;
 
+            /**
+             * Perform a tap at arbitrary coordinates on the device's screen.
+             * @param point Coordinates in the element's coordinate space. Optional. defaults: x: 100, y: 100
+             * @param shouldIgnoreStatusBar Coordinates will be measured starting from under the status bar. this param will affect only in Android tests. Optional. default: true
+             * @example await device.tap();
+             * @example await device.tap({ x: 100, y: 150 }, false);
+             * @example await device.tap({ x: 100, y: 150 });
+             * @example await device.tap(false);
+             */
+            tap(): Promise<void>;
+            tap(point: Point2D): Promise<void>;
+            tap(point: Point2D, shouldIgnoreStatusBar: boolean): Promise<void>;
+            tap(shouldIgnoreStatusBar: boolean): Promise<void>;
+
+            /**
+             * Perform a long press at arbitrary coordinates on the device's screen. Custom press duration if needed.
+             * @param point Coordinates in the device's coordinate space. Optional. defaults: x: 100, y: 100
+             * @param duration Custom press duration time, in milliseconds. Optional (defaults to the standard long-press duration for Android and 1000 milliseconds for ios).
+             *      Custom durations should be used cautiously, as they can affect test consistency and user experience expectations.
+             *      They are typically necessary when testing components that behave differently from the platform's defaults or when simulating unique user interactions.
+             * @param shouldIgnoreStatusBar Coordinates will be measured starting from under the status bar. this param will affect only in Android tests. Optional. default: true
+             * @example await device.longPress();
+             * @example await device.longPress({ x: 100, y: 150 }, 2000, false);
+             * @example await device.longPress({ x: 100, y: 150 }, 2000);
+             * @example await device.longPress(2000, false);
+             * @example await device.longPress({ x: 100, y: 150 }, false);
+             * @example await device.longPress({ x: 100, y: 150 });
+             * @example await device.longPress(2000);
+             * @example await device.longPress(false);
+             */
+            longPress(): Promise<void>;
+            longPress(point: Point2D, duration: number, shouldIgnoreStatusBar: boolean): Promise<void>;
+            longPress(point: Point2D, duration: number): Promise<void>;
+            longPress(duration: number, shouldIgnoreStatusBar: boolean): Promise<void>;
+            longPress(point: Point2D, shouldIgnoreStatusBar: boolean): Promise<void>;
+            longPress(point: Point2D): Promise<void>;
+            longPress(duration: number): Promise<void>;
+            longPress(shouldIgnoreStatusBar: boolean): Promise<void>;
+
             /**
              * Sets the simulator/emulator location to the given latitude and longitude.
              *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.27.6",
+  "version": "20.28.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -71,7 +71,7 @@
     "caf": "^15.0.1",
     "chalk": "^4.0.0",
     "child-process-promise": "^2.2.0",
-    "detox-copilot": "^0.0.23",
+    "detox-copilot": "^0.0.24",
     "execa": "^5.1.1",
     "find-up": "^5.0.0",
     "fs-extra": "^11.0.0",
@@ -116,5 +116,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "620d20c813b0d5507d1a415a0efd8be59ea5b691"
+  "gitHead": "c97e583d7e33ad9472d5b3e68dda724f1300c83c"
 }

package/src/android/espressoapi/EspressoDetox.js

@@ -73,6 +73,89 @@ class EspressoDetox {
     };
   }
 
+  static tap(x, y, shouldIgnoreStatusBar) {
+    if (typeof x !== "number") throw new Error("x should be a number, but got " + (x + (" (" + (typeof x + ")"))));
+    if (typeof y !== "number") throw new Error("y should be a number, but got " + (y + (" (" + (typeof y + ")"))));
+    if (typeof shouldIgnoreStatusBar !== "boolean") throw new Error("shouldIgnoreStatusBar should be a boolean, but got " + (shouldIgnoreStatusBar + (" (" + (typeof shouldIgnoreStatusBar + ")"))));
+    return {
+      target: {
+        type: "Class",
+        value: "com.wix.detox.espresso.EspressoDetox"
+      },
+      method: "tap",
+      args: [{
+        type: "Integer",
+        value: x
+      }, {
+        type: "Integer",
+        value: y
+      }, {
+        type: "boolean",
+        value: shouldIgnoreStatusBar
+      }]
+    };
+  }
+
+  static longPress(x, y, shouldIgnoreStatusBar) {
+    function longPress3(x, y, shouldIgnoreStatusBar) {
+      if (typeof x !== "number") throw new Error("x should be a number, but got " + (x + (" (" + (typeof x + ")"))));
+      if (typeof y !== "number") throw new Error("y should be a number, but got " + (y + (" (" + (typeof y + ")"))));
+      if (typeof shouldIgnoreStatusBar !== "boolean") throw new Error("shouldIgnoreStatusBar should be a boolean, but got " + (shouldIgnoreStatusBar + (" (" + (typeof shouldIgnoreStatusBar + ")"))));
+      return {
+        target: {
+          type: "Class",
+          value: "com.wix.detox.espresso.EspressoDetox"
+        },
+        method: "longPress",
+        args: [{
+          type: "Integer",
+          value: x
+        }, {
+          type: "Integer",
+          value: y
+        }, {
+          type: "boolean",
+          value: shouldIgnoreStatusBar
+        }]
+      };
+    }
+
+    function longPress4(x, y, duration, shouldIgnoreStatusBar) {
+      if (typeof x !== "number") throw new Error("x should be a number, but got " + (x + (" (" + (typeof x + ")"))));
+      if (typeof y !== "number") throw new Error("y should be a number, but got " + (y + (" (" + (typeof y + ")"))));
+      if (typeof duration !== "number") throw new Error("duration should be a number, but got " + (duration + (" (" + (typeof duration + ")"))));
+      if (typeof shouldIgnoreStatusBar !== "boolean") throw new Error("shouldIgnoreStatusBar should be a boolean, but got " + (shouldIgnoreStatusBar + (" (" + (typeof shouldIgnoreStatusBar + ")"))));
+      return {
+        target: {
+          type: "Class",
+          value: "com.wix.detox.espresso.EspressoDetox"
+        },
+        method: "longPress",
+        args: [{
+          type: "Integer",
+          value: x
+        }, {
+          type: "Integer",
+          value: y
+        }, {
+          type: "Integer",
+          value: duration
+        }, {
+          type: "boolean",
+          value: shouldIgnoreStatusBar
+        }]
+      };
+    }
+
+    if (arguments.length === 3) {
+      return longPress3.apply(null, arguments);
+    }
+
+    if (arguments.length === 4) {
+      return longPress4.apply(null, arguments);
+    }
+  }
+
 }
 
 module.exports = EspressoDetox;

package/src/copilot/detoxCopilotFrameworkDriver.js

@@ -18,7 +18,7 @@ const detoxCopilotFrameworkDriver = {
           },
           {
             signature: 'by.text(text: string)',
-            description: 'Matches elements by their text.',
+            description: 'Matches elements by their text (value).',
             example: "element(by.text('Login'))",
             guidelines: ['Prefer test IDs over text matchers when possible.'],
           },
@@ -34,6 +34,12 @@ const detoxCopilotFrameworkDriver = {
             example: "element(by.id('listItem')).atIndex(2)",
             guidelines: ['Use when multiple elements match the same matcher.'],
           },
+          {
+            signature: 'by.label(label: string)',
+            description: 'Match elements with the specified label.',
+            example: "element(by.label('Tuesday, 1 October'));",
+            guidelines: ['Use when there are no other identifiers, such as for date pickers to select specific days.'],
+          },
         ],
       },
       {
@@ -106,7 +112,7 @@ const detoxCopilotFrameworkDriver = {
             ],
           },
           {
-            signature: 'waitFor(element: Matcher)..toBeVisible().whileElement(element: Matcher).scroll(offset: number, direction: string)',
+            signature: 'waitFor(element: Matcher).toBeVisible(percent?: number).whileElement(element: Matcher).scroll(offset: number, direction: string)',
             description: 'Continuously performs an action while waiting for an expectation to be fulfilled.',
             example: `
 await waitFor(element(by.text('Load More')))
@@ -185,9 +191,13 @@ jestExpect(attributes.text).toBe('Tap Me');`,
         title: 'Assertions',
         items: [
           {
-            signature: 'toBeVisible()',
-            description: 'Asserts that the element is visible.',
-            example: "await expect(element(by.id('loginButton'))).toBeVisible();",
+            signature: 'toBeVisible(percent?: number)',
+            description: 'Asserts that the element is visible with at-least the specified percentage. Default percent is 75%.',
+            example: "await expect(element(by.id('loginButton'))).toBeVisible(38);",
+            guidelines: [
+              'Use the default visibility percent unless a different percentage is required.',
+              'If a percentage value is provided, use the exact percentage required for the test.',
+            ],
           },
           {
             signature: 'toExist()',
@@ -377,8 +387,8 @@ await device.launchApp({ launchArgs: { someLaunchArg: 1234 } });`,
         items: [
           {
             signature: 'web.element(matcher: Matcher)',
-            description: 'Selects an element within a web view. Use when there is only one web view on the screen.',
-            example: `    
+            description: 'Selects an element within a web view (`WKWebView` or `RNCWebView`). Use when there is only one web view on the screen.',
+            example: `
 await web.element(by.web.id('email')).typeText('test@example.com');
 await web.element(by.web.id('password')).typeText('password123');
 await web.element(by.web.id('login-button')).tap();
@@ -387,19 +397,20 @@ await web.element(by.web.id('login-button')).tap();
               'The web view may take time to load; add a delay using `await new Promise(resolve => setTimeout(resolve, milliseconds));` before the first interaction. This wait should happen only once.',
               'After the initial wait, you can interact with web elements without additional delays.',
               'Use `by.web.id` matcher when possible for matching web elements, as it is the most reliable.',
-              'Web APIs can only be used with web elements (within web views). Avoid using web APIs for native elements or native APIs for web elements.',
+              'Web APIs can only be used with web elements (within web views). Do not use web APIs for native elements or native APIs for web elements!',
+              'Confirm that you are targeting a web view before using this method.'
             ],
           },
           {
             signature: 'web(nativeMatcher: NativeMatcher).element(matcher: Matcher)',
-            description: 'Selects an element within a specific web view matched by a native matcher. Use when there are multiple web views on the screen.',
+            description: 'Selects an element within a specific web view (`WKWebView` or `RNCWebView`) matched by a native matcher. Use when there are multiple web views on the screen.',
             example: `
 // Wait for the specific web view to appear and load (only once before interacting)
 await expect(element(by.id('checkout-webview'))).toBeVisible();
 
 // Interact with elements within a specific web view
 const specificWebView = web(by.id('checkout-webview'));
-    
+
 await specificWebView.element(by.web.id('credit-card-number')).typeText('4111111111111111');
 await specificWebView.element(by.web.id('expiration-date')).typeText('12/25');
 await specificWebView.element(by.web.id('cvv')).typeText('123');
@@ -411,6 +422,7 @@ await specificWebView.element(by.web.id('pay-button')).tap();
               'After the initial wait, you can interact with elements within the web view without additional delays.',
               'Webview must be matched with `web(nativeMatcher)` (e.g., `web(by.id(..))` instead of `element(by.id(..))`).',
               'Prefer the basic `web.element()` if only one web view is present on the screen.',
+              'Confirm that you are targeting a web view before using this method.'
             ],
           },
           {
@@ -485,8 +497,8 @@ await secondWebView.element(by.web.id('search-button')).tap();
             example: `await web.element(by.web.label('Next')).tap();`,
             guidelines: [
               'Available on iOS only.',
-              'Use when the element has a unique label or aria-label.',
-              'Can be used to match buttons and input elements by their inner text content.',
+              'Use when the inner web element has a unique label or aria-label.',
+              'Can be used to match buttons and input elements inside a web view, by their inner text content.',
             ],
           },
           {
@@ -567,13 +579,13 @@ await web.element(by.web.id('email-input')).focus();
 await web.element(by.web.id('email-input')).typeText('user@example.com');
             `,
             guidelines: [
-              'Useful for input fields that require focus before typing.',
+              'Useful for input fields in a web view that require focus before typing.',
               'No need for secured interactions on iOS.',
             ]
           },
           {
             signature: 'moveCursorToEnd()',
-            description: 'Moves the input cursor to the end of the element\'s content.',
+            description: 'Moves the input cursor in a web view to the end of the element\'s content.',
             example: `
 await web.element(by.web.id('message-box')).moveCursorToEnd();
 await web.element(by.web.id('message-box')).typeText(' Adding more text.');
@@ -581,7 +593,7 @@ await web.element(by.web.id('message-box')).typeText(' Adding more text.');
           },
           {
             signature: 'runScript(script: string, args?: any[])',
-            description: 'Runs a JavaScript function on the element.',
+            description: 'Runs a JavaScript function on the web view element.',
             example: `
 // Click an element using a custom script
 await web.element(by.web.id('hidden-button')).runScript('el => el.click()');

package/src/devices/runtime/RuntimeDevice.js

@@ -1,6 +1,7 @@
 const DetoxRuntimeError = require('../../errors/DetoxRuntimeError');
 const debug = require('../../utils/debug'); // debug utils, leave here even if unused
 const log = require('../../utils/logger').child({ cat: 'device' });
+const mapDeviceLongPressArguments = require('../../utils/mapDeviceLongPressArguments');
 const traceMethods = require('../../utils/traceMethods');
 const wrapWithStackTraceCutter = require('../../utils/wrapWithStackTraceCutter');
 
@@ -283,6 +284,16 @@ class RuntimeDevice {
     await this.deviceDriver.setOrientation(orientation);
   }
 
+  async tap(point, shouldIgnoreStatusBar) {
+    await this.deviceDriver.tap(point, shouldIgnoreStatusBar, this._bundleId);
+  }
+
+  async longPress(arg1, arg2, arg3) {
+    let { point, duration, shouldIgnoreStatusBar } = mapDeviceLongPressArguments(arg1, arg2, arg3);
+
+    await this.deviceDriver.longPress(point, duration, shouldIgnoreStatusBar, this._bundleId);
+  }
+
   async setLocation(lat, lon) {
     lat = String(lat);
     lon = String(lon);

package/src/devices/runtime/drivers/DeviceDriverBase.js

@@ -51,6 +51,14 @@ class DeviceDriverBase {
     return '';
   }
 
+  async tap(_bundleId) {
+    return '';
+  }
+
+  async longPress(_bundleId) {
+    return '';
+  }
+
   async sendToHome() {
     return '';
   }

package/src/devices/runtime/drivers/android/AndroidDriver.js

@@ -245,6 +245,22 @@ class AndroidDriver extends DeviceDriverBase {
     await this.invocationManager.execute(call);
   }
 
+  async tap(point, shouldIgnoreStatusBar) {
+    let x = point?.x ?? 100;
+    let y = point?.y ?? 100;
+    let _shouldIgnoreStatusBar = shouldIgnoreStatusBar ?? true;
+    const call = EspressoDetoxApi.tap(x, y, _shouldIgnoreStatusBar);
+    await this.invocationManager.execute(call);
+  }
+
+  async longPress(point, duration, shouldIgnoreStatusBar) {
+    let x = point?.x ?? 100;
+    let y = point?.y ?? 100;
+    let _shouldIgnoreStatusBar = shouldIgnoreStatusBar ?? true;
+    const call = duration ? EspressoDetoxApi.longPress(x, y, duration, _shouldIgnoreStatusBar): EspressoDetoxApi.longPress(x, y, _shouldIgnoreStatusBar);
+    await this.invocationManager.execute(call);
+  }
+  
   async generateViewHierarchyXml(shouldInjectTestIds) {
     const hierarchy = await this.invocationManager.execute(DetoxApi.generateViewHierarchyXml(shouldInjectTestIds));
     return hierarchy.result;

package/src/devices/runtime/drivers/ios/SimulatorDriver.js

@@ -6,12 +6,17 @@ const _ = require('lodash');
 
 const temporaryPath = require('../../../../artifacts/utils/temporaryPath');
 const DetoxRuntimeError = require('../../../../errors/DetoxRuntimeError');
+const XCUITestRunner = require('../../../../ios/XCUITestRunner');
+const { assertTraceDescription } = require('../../../../utils/assertArgument');
 const getAbsoluteBinaryPath = require('../../../../utils/getAbsoluteBinaryPath');
+const { actionDescription } = require('../../../../utils/invocationTraceDescriptions');
 const log = require('../../../../utils/logger').child({ cat: 'device' });
 const pressAnyKey = require('../../../../utils/pressAnyKey');
+const traceInvocationCall = require('../../../../utils/traceInvocationCall').bind(null, log);
 
 const IosDriver = require('./IosDriver');
 
+
 /**
  * @typedef SimulatorDriverDeps { DeviceDriverDeps }
  * @property applesimutils { AppleSimUtils }
@@ -40,6 +45,19 @@ class SimulatorDriver extends IosDriver {
     this._applesimutils = deps.applesimutils;
   }
 
+  withAction(xcuitestRunner, action, traceDescription, ...params) {
+    assertTraceDescription(traceDescription);
+
+    const invocation = {
+      ...(params.length !== 0 && { params }),
+      type: 'systemAction',
+      ...(this.index !== undefined && { systemAtIndex: this.index }),
+      systemAction: action
+    };
+
+    return traceInvocationCall(traceDescription, invocation, xcuitestRunner.execute(invocation));
+  }
+
   getExternalId() {
     return this.udid;
   }
@@ -111,6 +129,23 @@ class SimulatorDriver extends IosDriver {
     await this.emitter.emit('terminateApp', { deviceId: udid, bundleId });
   }
 
+  async tap(point, shouldIgnoreStatusBar, _bundleId) {
+    const xcuitestRunner = new XCUITestRunner({ runtimeDevice: { id: this.getExternalId(), _bundleId } });
+    let x = point?.x ?? 100;
+    let y = point?.y ?? 100;
+    const traceDescription = actionDescription.tap({ x, y });
+    return this.withAction(xcuitestRunner, 'coordinateTap', traceDescription, x.toString(), y.toString());
+  }
+
+  async longPress(point, pressDuration, shouldIgnoreStatusBar, _bundleId) {
+    const xcuitestRunner = new XCUITestRunner({ runtimeDevice: { id: this.getExternalId(), _bundleId } });
+    let x = point?.x ?? 100;
+    let y = point?.y ?? 100;
+    let _pressDuration = pressDuration ? (pressDuration / 1000) : 1;
+    const traceDescription = actionDescription.longPress({ x, y }, _pressDuration);
+    return this.withAction(xcuitestRunner, 'coordinateLongPress', traceDescription, x.toString(), y.toString(), _pressDuration.toString());
+  }
+
   async setBiometricEnrollment(yesOrNo) {
     await this._applesimutils.setBiometricEnrollment(this.udid, yesOrNo);
   }

package/src/utils/assertArgument.js

@@ -52,6 +52,14 @@ function assertPoint(point) {
   throw new DetoxRuntimeError(`point should be an object with x and y properties, but got ${JSON.stringify(point)}`);
 }
 
+function assertShouldIgnoreStatusBar(shouldIgnoreStatusBar) {
+  if (typeof shouldIgnoreStatusBar === 'boolean') {
+    return true;
+  }
+
+  throw new DetoxRuntimeError('shouldIgnoreStatusBar should be a boolean, but got ' + (shouldIgnoreStatusBar + (' (' + (typeof shouldIgnoreStatusBar + ')'))));
+}
+
 function assertUndefined(arg) {
   if (arg === undefined) {
     return true;
@@ -76,6 +84,7 @@ module.exports = {
   assertString,
   assertDuration,
   assertPoint,
+  assertShouldIgnoreStatusBar,
   assertUndefined,
   assertTraceDescription
 };

package/src/utils/invocationTraceDescriptions.js

@@ -3,6 +3,7 @@ module.exports = {
     adjustSliderToPosition: (newPosition) => `adjust slider to position ${newPosition}`,
     clearText: () => 'clear input text',
     getAttributes: () => 'get element attributes',
+    tap: (point) => `tap at ${JSON.stringify(point)}`,
     longPress: (point, duration) => `long press${duration !== null ? ` for ${duration}ms` : ''}${point !== null ? ` at ${JSON.stringify(point)}` : ''}`,
     longPressAndDrag: (duration, startX, startY, targetElement, endX, endY, speed, holdDuration) =>
       `long press and drag from ${startX}, ${startY} to ${endX}, ${endY} with speed ${speed} and hold duration ${holdDuration}`,

package/src/utils/mapDeviceLongPressArguments.js

@@ -0,0 +1,56 @@
+const { DetoxRuntimeError } = require('../errors');
+
+const { assertPoint, assertDuration, assertUndefined, assertShouldIgnoreStatusBar } = require('./assertArgument');
+
+function mapDeviceLongPressArguments(optionalAllParams, optionalDurationOrIgnoreStatusBar, optionalIgnoreStatusBar) {
+    let point = null;
+    let duration = null;
+    let shouldIgnoreStatusBar = null;
+
+    try {
+      if (optionalAllParams === undefined) {
+        // Do nothing.
+      } else if (typeof optionalAllParams === 'number') {
+        duration = optionalAllParams;
+        if (typeof optionalDurationOrIgnoreStatusBar === 'boolean') {
+            shouldIgnoreStatusBar = optionalDurationOrIgnoreStatusBar;
+        } else {
+            assertUndefined(optionalDurationOrIgnoreStatusBar);
+        }
+        assertUndefined(optionalIgnoreStatusBar);
+      } else if (typeof optionalAllParams === 'boolean') {
+        shouldIgnoreStatusBar = optionalAllParams;
+        assertUndefined(optionalDurationOrIgnoreStatusBar);
+        assertUndefined(optionalIgnoreStatusBar);
+      } else {
+        assertPoint(optionalAllParams);
+        point = optionalAllParams;
+
+        if (typeof optionalDurationOrIgnoreStatusBar === 'number') {
+          assertDuration(optionalDurationOrIgnoreStatusBar);
+          duration = optionalDurationOrIgnoreStatusBar;
+        } else if (typeof optionalDurationOrIgnoreStatusBar === 'boolean') {
+          assertShouldIgnoreStatusBar(optionalDurationOrIgnoreStatusBar);
+          shouldIgnoreStatusBar = optionalDurationOrIgnoreStatusBar;
+          assertUndefined(optionalIgnoreStatusBar);
+        } else if (optionalDurationOrIgnoreStatusBar !== undefined) {
+            assertDuration(optionalDurationOrIgnoreStatusBar);
+        } else {
+          assertUndefined(optionalDurationOrIgnoreStatusBar);
+          assertUndefined(optionalIgnoreStatusBar);
+        }
+
+        if (optionalIgnoreStatusBar !== undefined) {
+          assertShouldIgnoreStatusBar(optionalIgnoreStatusBar);
+          shouldIgnoreStatusBar = optionalIgnoreStatusBar;
+        }
+      }
+    } catch (e) {
+      throw new DetoxRuntimeError(`longPress accepts either a duration (number) or a point ({x: number, y: number}) as ` +
+        `its first argument, optionally a duration (number) as its second argument, and optionally a ignoreStatusBar (boolean) as its third argument. Error: ${e.message}`);
+    }
+
+    return { point, duration, shouldIgnoreStatusBar };
+  }
+
+module.exports = mapDeviceLongPressArguments;

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6-sources.jar.md5

@@ -1 +0,0 @@
-c517cf62a949c264ce5aa29dbe7eb0b3

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6-sources.jar.sha1

@@ -1 +0,0 @@
-0fd30160288562361e27f4dae15e88dd8c063321

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6-sources.jar.sha256

@@ -1 +0,0 @@
-43af12e399f647d3c726f03f03c6d5e9953ab473bc565018672c1dd6f9c23fa6

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6-sources.jar.sha512

@@ -1 +0,0 @@
-7eb38a3cfc446ee433478167eefe863d2faacfa5b2102685702d83d0b944236d3e4be9d89ad653134402872945bb122db884470d327bf99f7ecd769dacf437bc

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.aar.md5

@@ -1 +0,0 @@
-cf8dd3a0b09c20f6536c73bb9b643c19

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.aar.sha1

@@ -1 +0,0 @@
-087bb87ec12653d348901f95966ed16f46f870b2

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.aar.sha256

@@ -1 +0,0 @@
-77ee8830fdf301ef8a7895575a4f0f3b76db9614b61942979b73d3b5001fac57

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.aar.sha512

@@ -1 +0,0 @@
-3eb1ffc33ecae7c14b6ff36a525abacb4aa05f6d05083d2dc79bad26b63badecc5d22d45bf7dc97cc90804e4245db826e14c86d86fa49540be209708a6f854d1

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.pom.md5

@@ -1 +0,0 @@
-b1fa5d53cea5a7597921246ec09f437f

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.pom.sha1

@@ -1 +0,0 @@
-d28ba67e5c3648d25e9c592b78803d33a1805ed8

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.pom.sha256

@@ -1 +0,0 @@
-9563aa36da9534de48b62cdfc7ff3b14782e260a29fbbff7189a220e1d74eaf7

package/Detox-android/com/wix/detox/20.27.6/detox-20.27.6.pom.sha512

@@ -1 +0,0 @@
-ff322f7d952260e532f7678a490b6672136925f9d77420203d6038cde5a38a2fa2af2db6fbe5ba8005fe3668074228efdca4ea8f2f3e8077fc9386ded37e1642

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6-sources.jar.md5

@@ -1 +0,0 @@
-367dd3d7936f459a3d2b84a90a4d4277

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6-sources.jar.sha1

@@ -1 +0,0 @@
-bc18b82a4beeee1569c3cfae9ccbbd11ab133d21

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6-sources.jar.sha256

@@ -1 +0,0 @@
-31152c35e9eac0a236cb5d016c3200ecd5181f7639c376f02d04289a06c76930

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6-sources.jar.sha512

@@ -1 +0,0 @@
-7a911e94257c299c2d560fe6d84ddc2d5264bec7953e39ae64bcafbe5041e43ffbb5bffcfd6c04bcbf62e62b4b764e609e35d37d5e4903266ace32fa214a0726

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.aar.md5

@@ -1 +0,0 @@
-768c2187e364924f92a9b6ccf3c7d0a2

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.aar.sha1

@@ -1 +0,0 @@
-7e17fc60050feb2ea5e7dc9a93bf8b2fba13486d

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.aar.sha256

@@ -1 +0,0 @@
-a64ce40bbbf3b827d598206f3829f34072b1d6bcd0115d930e7aabadf7477534

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.aar.sha512

@@ -1 +0,0 @@
-60d8f60ededcfdd91034b452971b511a40a99a5a4afb42ae6fa88261cf5d29b8493b824eb2e8f453653bf723668b417943177f02fb0dcc9d58501563e7c10b54

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.pom.md5

@@ -1 +0,0 @@
-acec75d4c28b08969fcdf94aff6253d3

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.pom.sha1

@@ -1 +0,0 @@
-c9739dec1a97e33efb975a87083b618963b98ed7

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.pom.sha256

@@ -1 +0,0 @@
-652c04a47a8ffb644d3e6085070a0b7401f2cb5ab5bc09d5a7a73f21d4a9fb9d

package/Detox-android/com/wix/detox-legacy/20.27.6/detox-legacy-20.27.6.pom.sha512

@@ -1 +0,0 @@
-913e879197e5d3622aee6c3db2444ce453912f3ab383bebae3b0fd09e518b8c301e377666a13a3359f841307e895094b5a82e6eafda83e69abd43c3f10eec484