detox 20.25.6 → 20.26.1

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

@@ -0,0 +1 @@
+cb52b8177078355afc457f45e128853d

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

@@ -0,0 +1 @@
+df0ecd8aa3bd60c9f5d237dd729f579ba8a575db

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

@@ -0,0 +1 @@
+df6bea449ff58dd7dac14039b07c04397365c255939def9242266e2272de1ea3

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

@@ -0,0 +1 @@
+f55327a87712ff17a9d0ee1f606bc5c593b3ffb6c56245fa4d831c9f4ea0e7f25534c306f7529e8b0f34adbc60428ed019de1af58d0a67cf89e3d16fd6a2eb22

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

@@ -0,0 +1 @@
+19245568a5b1fc7e18eae4c34019b2d0

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

@@ -0,0 +1 @@
+dfb1a4d4b6a06bbe8952fe821ab3278364fc3cf2

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

@@ -0,0 +1 @@
+294b99bfcfc4acf89c10c76c4cfb07b61dec92d8f45a2ed137092aa766d7e215

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

@@ -0,0 +1 @@
+546fa7e195d2c2077d9e41f2b003ead174c820ce45027752e86a366e673023cc41d09b5b5ccd3bdb693f403e6c8b65567af12208ece66e65d85937e9a65f677d

package/Detox-android/com/wix/detox/{20.25.6/detox-20.25.6.pom → 20.26.1/detox-20.26.1.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.25.6</version>
+  <version>20.26.1</version>
   <packaging>aar</packaging>
   <name>Detox</name>
   <description>Gray box end-to-end testing and automation library for mobile apps</description>
@@ -30,22 +30,28 @@
     <url>https://github.com/wix/detox</url>
   </scm>
   <dependencies>
+    <dependency>
+      <groupId>org.jetbrains.kotlin</groupId>
+      <artifactId>kotlin-stdlib-jdk8</artifactId>
+      <version>1.8.0</version>
+      <scope>compile</scope>
+    </dependency>
     <dependency>
       <groupId>androidx.test.espresso</groupId>
       <artifactId>espresso-core</artifactId>
-      <version>3.5.1</version>
+      <version>3.6.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.espresso</groupId>
       <artifactId>espresso-web</artifactId>
-      <version>3.5.1</version>
+      <version>3.6.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.espresso</groupId>
       <artifactId>espresso-contrib</artifactId>
-      <version>3.5.1</version>
+      <version>3.6.1</version>
       <scope>compile</scope>
       <exclusions>
         <exclusion>
@@ -63,27 +69,21 @@
     <dependency>
       <groupId>androidx.test</groupId>
       <artifactId>rules</artifactId>
-      <version>1.5.0</version>
+      <version>1.6.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.ext</groupId>
       <artifactId>junit</artifactId>
-      <version>1.1.5</version>
+      <version>1.2.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.uiautomator</groupId>
       <artifactId>uiautomator</artifactId>
-      <version>2.2.0</version>
+      <version>2.3.0</version>
       <scope>compile</scope>
     </dependency>
-    <dependency>
-      <groupId>org.jetbrains.kotlin</groupId>
-      <artifactId>kotlin-stdlib-jdk8</artifactId>
-      <version>1.2.0</version>
-      <scope>runtime</scope>
-    </dependency>
     <dependency>
       <groupId>org.apache.commons</groupId>
       <artifactId>commons-lang3</artifactId>

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

@@ -0,0 +1 @@
+1bf631450249797e4ccaea1f57c7099b

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

@@ -0,0 +1 @@
+1dd770221e2a3611ee8c5c37c6b9b4c2f1bb760d

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

@@ -0,0 +1 @@
+17c6e7dc49f3b473f36510392b4e130717ef2f575f4b8d886062e09e6b0264e7

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

@@ -0,0 +1 @@
+6912f590491521686d812a294e692cb66c7c0342abd07cdab313f6c610b33f5e45eaa32466ed285f6a1b2e9f0b9aa9f030017803acb6775db1f8c89d54690ddc

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.25.6</latest>
-    <release>20.25.6</release>
+    <latest>20.26.1</latest>
+    <release>20.26.1</release>
     <versions>
-      <version>20.25.6</version>
+      <version>20.26.1</version>
     </versions>
-    <lastUpdated>20240825174403</lastUpdated>
+    <lastUpdated>20240905072123</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-3ebd487874d7ca9ea9e79f14ae8b2228
+0eaed4043597835de00d112c3743048e

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

@@ -1 +1 @@
-22de2239bc50b05a3d10d735a8435b281aa5aa77
+48836958569a492b65d2563d763a6530d661b78e

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

@@ -1 +1 @@
-85fa4bb20d12f08cbc7ea2dfcd7245707cd1b7ba6047bd9f3b45582bceef0227
+40c848b9199cc3579c5293dcb4e883c87cad72531deff2c90fe525c814740589

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

@@ -1 +1 @@
-7a948085b3d47fb26694edba0bfe6fef3805bf069873bd4273e57fa11ee49e36b2cf61e9f74cdd953c9763945b8666c4cd72b2bb3f450eadc0d2bf608f26f29d
+2a1e04c9c77232761a933190ac00b1155cf3f14df3abbacdb9b83c5963d2c40acfdff9a65fadfb5b7390d3b8577a6c0d192a825961b83876ad7e64a3a7c2c8e1

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

@@ -0,0 +1 @@
+0bd84ca1c587091c54ac240c0709623f

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

@@ -0,0 +1 @@
+908cc092b39693c1df99e58cdadc5220d2fcea44

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

@@ -0,0 +1 @@
+c18e176a31e4f4e887c8be495579ac034933e2211aaf6a8fa16cf370fe71adcb

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

@@ -0,0 +1 @@
+0c0a7610c6abfcb512506ec97ed33074b814bf42f2323e5ce4e462108c0a55dd1b8febe0731cb6d46c60345efae3aa544773a9d66a657debb4567d0c9b25d7be

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

@@ -0,0 +1 @@
+0dd6f951f83bfb1c258c09e57291b5f3

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

@@ -0,0 +1 @@
+54212838677b6cf72c2eb964dc911a9a80cf54a7

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

@@ -0,0 +1 @@
+c2452ceba0cb3a2a6517086d81a0e990d82ab263395a0e1166b8178769cd8a51

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

@@ -0,0 +1 @@
+3d71f12171376fcf35b46ebc6a6cf942e0a7151a8f26287b41b6e2807f4bd8d37704aeaa89b7b0231c2286a301ebbfa3ff77a0a9cee92c02463c0085a4190085

package/Detox-android/com/wix/detox-legacy/{20.25.6/detox-legacy-20.25.6.pom → 20.26.1/detox-legacy-20.26.1.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox-legacy</artifactId>
-  <version>20.25.6</version>
+  <version>20.26.1</version>
   <packaging>aar</packaging>
   <name>Detox</name>
   <description>Gray box end-to-end testing and automation library for mobile apps</description>
@@ -30,22 +30,28 @@
     <url>https://github.com/wix/detox</url>
   </scm>
   <dependencies>
+    <dependency>
+      <groupId>org.jetbrains.kotlin</groupId>
+      <artifactId>kotlin-stdlib-jdk8</artifactId>
+      <version>1.8.0</version>
+      <scope>compile</scope>
+    </dependency>
     <dependency>
       <groupId>androidx.test.espresso</groupId>
       <artifactId>espresso-core</artifactId>
-      <version>3.5.1</version>
+      <version>3.6.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.espresso</groupId>
       <artifactId>espresso-web</artifactId>
-      <version>3.5.1</version>
+      <version>3.6.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.espresso</groupId>
       <artifactId>espresso-contrib</artifactId>
-      <version>3.5.1</version>
+      <version>3.6.1</version>
       <scope>compile</scope>
       <exclusions>
         <exclusion>
@@ -63,27 +69,21 @@
     <dependency>
       <groupId>androidx.test</groupId>
       <artifactId>rules</artifactId>
-      <version>1.5.0</version>
+      <version>1.6.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.ext</groupId>
       <artifactId>junit</artifactId>
-      <version>1.1.5</version>
+      <version>1.2.1</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>androidx.test.uiautomator</groupId>
       <artifactId>uiautomator</artifactId>
-      <version>2.2.0</version>
+      <version>2.3.0</version>
       <scope>compile</scope>
     </dependency>
-    <dependency>
-      <groupId>org.jetbrains.kotlin</groupId>
-      <artifactId>kotlin-stdlib-jdk8</artifactId>
-      <version>1.2.0</version>
-      <scope>runtime</scope>
-    </dependency>
     <dependency>
       <groupId>org.apache.commons</groupId>
       <artifactId>commons-lang3</artifactId>

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

@@ -0,0 +1 @@
+6c50ab9fc402621ed054130c3ad29a50

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

@@ -0,0 +1 @@
+cc1f5ce71a739209519424cd42dea3ec6c243d83

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

@@ -0,0 +1 @@
+22cab0ab0bc66e1faf2358620a6503287a55820a8b596a6b8ff47fd1f229e44d

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

@@ -0,0 +1 @@
+9b889b0af531796d582ccf4627756e259473f78ed04a7d687f9454048938f70bec5f5a4b2ab11a6236f618ec06e4ae3c34d0909a61258842a19509eb0544b1ff

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.25.6</latest>
-    <release>20.25.6</release>
+    <latest>20.26.1</latest>
+    <release>20.26.1</release>
     <versions>
-      <version>20.25.6</version>
+      <version>20.26.1</version>
     </versions>
-    <lastUpdated>20240825174441</lastUpdated>
+    <lastUpdated>20240905072150</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-e8677f5e1ebc2db6a82900c05f8d79dc
+4910f1ba303df535a12b451a5276bf85

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

@@ -1 +1 @@
-12b4921860e458ca7333620fec5ca94bec62c05b
+49ee8cead5fee31eafaa5d6ca61e63ca6be3c519

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

@@ -1 +1 @@
-74491490f648f58107b92765dd805167f3187b42ebf3a94408c017e654c46334
+9ec37c0d1a6cb2e02bbeec7e772e2af0b409dc9e4634b70d2b42d673983fe56f

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

@@ -1 +1 @@
-7ce4eab1a1b798a283d6c22884823a9dfd7aa06b177889c1a7c305661fd3b2095703b8f9d3311907a6652d78763ece4aada1353f70b5f9b71bfd525981d93b70
+45e71b04bff51637e1bf1528b9ef2c70b0fd4b060851a9c3f06272a1d4574af330914d45fd62f5d3001f1e7154107d0f618b5261305167f8b632f03c8bc691f0

package/android/detox/build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'com.android.library'
 apply plugin: 'kotlin-android'
 apply from: '../rninfo.gradle'
 
-def _kotlinMinVersion = '1.2.0'
+def _kotlinMinVersion = '1.8.0'
 def _materialMinVersion = '1.11.0'
 
 def _ext = rootProject.ext
@@ -111,7 +111,7 @@ android {
 
 // Fundamental deps.
 dependencies {
-    implementation "org.jetbrains.kotlin:$_kotlinStdlib:$_kotlinMinVersion"
+    api "org.jetbrains.kotlin:$_kotlinStdlib:$_kotlinVersion"
 
     compileOnly "${_rnNativeArtifact}"
 }
@@ -123,29 +123,28 @@ dependencies {
     // Versions are in-sync with the 'androidx-test-1.4.0' release/tag of the android-test github repo,
     // used by the Detox generator. See https://github.com/android/android-test/releases/tag/androidx-test-1.4.0
     // Important: Should remain so when generator tag is replaced!
-    api('androidx.test.espresso:espresso-core:3.5.1') {
+    api('androidx.test.espresso:espresso-core:3.6.1') {
         because 'Needed all across Detox but also makes Espresso seamlessly provided to Detox users with hybrid apps/E2E-tests.'
     }
-    api('androidx.test.espresso:espresso-web:3.5.1') {
+    api('androidx.test.espresso:espresso-web:3.6.1') {
         because 'Web-View testing'
     }
-    api('androidx.test.espresso:espresso-contrib:3.5.1') {
+    api('androidx.test.espresso:espresso-contrib:3.6.1') {
         because 'Android datepicker support'
         exclude group: "org.checkerframework", module: "checker"
     }
     api('org.hamcrest:hamcrest:2.2') {
         because 'See https://github.com/wix/Detox/issues/3920. Need to force hamcrest 2.2 win in battle of 2.2 vs. 1.3 (specified by Espresso).'
     }
-    api('androidx.test:rules:1.5.0') {
+    api('androidx.test:rules:1.6.1') {
         because 'of ActivityTestRule. Needed by users *and* internally used by Detox.'
     }
-    api('androidx.test.ext:junit:1.1.5') {
+    api('androidx.test.ext:junit:1.2.1') {
         because 'Needed so as to seamlessly provide AndroidJUnit4 to Detox users. Depends on junit core.'
     }
-
     // Version is the latest; Cannot sync with the Github repo (e.g. android/android-test) because the androidx
     // packaging version of associated classes is simply not there...
-    api('androidx.test.uiautomator:uiautomator:2.2.0') {
+    api('androidx.test.uiautomator:uiautomator:2.3.0') {
         because 'Needed by Detox but also makes UIAutomator seamlessly provided to Detox users with hybrid apps/E2E-tests.'
     }
 }

package/android/detox/proguard-rules-app.pro

@@ -14,11 +14,14 @@
 -keep class com.reactnativecommunity.slider.** { *; }
 -keep class com.reactnativecommunity.asyncstorage.** { *; }
 
+-keep class kotlin.reflect.** { *; }
+-keep class kotlin.coroutines.CoroutineDispatcher { *; }
 -keep class kotlin.jvm.** { *; }
 -keep class kotlin.collections.** { *; }
 -keep class kotlin.text.** { *; }
 -keep class kotlin.io.** { *; }
 -keep class okhttp3.** { *; }
+-keep class kotlin.LazyKt { *; }
 
 -keep class androidx.concurrent.futures.** { *; }
 

package/android/detox/src/full/java/com/wix/detox/Detox.java

@@ -7,6 +7,7 @@ import androidx.test.platform.app.InstrumentationRegistry;
 import androidx.test.rule.ActivityTestRule;
 
 import com.wix.detox.config.DetoxConfig;
+import com.wix.detox.espresso.hierarchy.ViewHierarchyGenerator;
 
 /**
  * <p>Static class.</p>
@@ -141,4 +142,8 @@ public final class Detox {
     private static Context getAppContext() {
         return InstrumentationRegistry.getInstrumentation().getTargetContext().getApplicationContext();
     }
+
+    public static String generateViewHierarchyXml(boolean shouldInjectTestIds) {
+        return ViewHierarchyGenerator.generateXml(shouldInjectTestIds);
+    }
 }

package/android/detox/src/full/java/com/wix/detox/espresso/assertion/ViewAssertions.java

@@ -1,16 +1,15 @@
 package com.wix.detox.espresso.assertion;
 
-import androidx.annotation.NonNull;
-import android.view.View;
+import static androidx.test.espresso.matcher.ViewMatchers.assertThat;
 
-import org.hamcrest.Matcher;
-import org.hamcrest.StringDescription;
+import android.view.View;
 
+import androidx.annotation.NonNull;
 import androidx.test.espresso.NoMatchingViewException;
 import androidx.test.espresso.ViewAssertion;
 
-import static androidx.test.espresso.core.internal.deps.guava.base.Preconditions.checkNotNull;
-import static androidx.test.espresso.matcher.ViewMatchers.assertThat;
+import org.hamcrest.Matcher;
+import org.hamcrest.StringDescription;
 
 /**
  * A custom extension of {@link androidx.test.espresso.assertion.ViewAssertions}.
@@ -24,9 +23,8 @@ public class ViewAssertions {
      * which is more suitable for Detox' separated interaction-matcher architecture.
      * See {@link MatchesViewAssertion} for more details.
      */
-    @SuppressWarnings("unchecked")
     public static ViewAssertion matches(final Matcher<? super View> viewMatcher) {
-        return new MatchesViewAssertion((Matcher<? super View>) checkNotNull(viewMatcher));
+        return new MatchesViewAssertion(viewMatcher);
     }
 
     /**

package/android/detox/src/full/java/com/wix/detox/espresso/hierarchy/RootViewsHelper.kt

@@ -0,0 +1,51 @@
+package com.wix.detox.espresso.hierarchy
+
+import android.annotation.SuppressLint
+import android.view.View
+import java.lang.reflect.Field
+import java.lang.reflect.Method
+
+object RootViewsHelper {
+
+    /**
+     * Get rootviews from RootViewImpl instances that are stored in WindowManagerGlobal.
+     */
+    fun getRootViews(): List<View?>? {
+        val rootViewsReflectedObjects = getAllViewRootObjects()
+        val rootViews = rootViewsReflectedObjects?.map {
+            // Root View is stored in the ViewRootImpl instance
+            val getViewMethod = it.javaClass.getDeclaredMethod("getView")
+            getViewMethod.isAccessible = true
+
+            // Invoke the method to get the root View
+            getViewMethod.invoke(it) as? View
+        }
+        return rootViews
+    }
+
+    @SuppressLint("PrivateApi", "DiscouragedPrivateApi")
+    private fun getAllViewRootObjects(): List<Any>? {
+        return try {
+            // Get the WindowManagerGlobal class
+            val windowManagerGlobalClass = Class.forName("android.view.WindowManagerGlobal")
+
+            // Get the getInstance method
+            val getInstanceMethod: Method = windowManagerGlobalClass.getDeclaredMethod("getInstance")
+            getInstanceMethod.isAccessible = true
+
+            // Get the single instance of WindowManagerGlobal
+            val windowManagerGlobal = getInstanceMethod.invoke(null)
+
+            // Get the mRoots field, which is a list of ViewRootImpl instances
+            val mRootsField: Field = windowManagerGlobalClass.getDeclaredField("mRoots")
+            mRootsField.isAccessible = true
+
+            // Return the list of ViewRootImpl instances
+            @Suppress("UNCHECKED_CAST")
+            mRootsField.get(windowManagerGlobal) as? List<Any>
+        } catch (e: Exception) {
+            e.printStackTrace()
+            null
+        }
+    }
+}

package/android/detox/src/full/java/com/wix/detox/espresso/hierarchy/ViewHierarchyGenerator.kt

@@ -0,0 +1,128 @@
+package com.wix.detox.espresso.hierarchy
+
+import android.util.Xml
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import com.wix.detox.reactnative.ui.getAccessibilityLabel
+import org.xmlpull.v1.XmlSerializer
+import java.io.StringWriter
+
+object ViewHierarchyGenerator {
+    @JvmStatic
+    fun generateXml(shouldInjectTestIds: Boolean): String {
+        val rootViews = RootViewsHelper.getRootViews()
+        return generateXmlFromViews(rootViews, shouldInjectTestIds)
+    }
+
+    private fun generateXmlFromViews(rootViews: List<View?>?, shouldInjectTestIds: Boolean): String {
+        return StringWriter().use { writer ->
+            val serializer = Xml.newSerializer().apply {
+                setOutput(writer)
+                startDocument(Xml.Encoding.UTF_8.name, true)
+                setFeature("http://xmlpull.org/v1/doc/features.html#indent-output", true)
+                startTag("", "ViewHierarchy")
+            }
+
+            rootViews?.forEach { rootView ->
+                rootView?.let {
+                    serializeViewHierarchy(it, serializer, shouldInjectTestIds, emptyList())
+                }
+            }
+
+            serializer.apply {
+                endTag("", "ViewHierarchy")
+                endDocument()
+            }
+
+            writer.toString()
+        }
+    }
+
+    private fun serializeViewHierarchy(
+        view: View,
+        serializer: XmlSerializer,
+        shouldInjectTestIds: Boolean,
+        indexPath: List<Int>
+    ) {
+        serializer.startTag("", view.javaClass.simpleName)
+        serializeViewAttributes(view, serializer, shouldInjectTestIds, indexPath)
+
+        if (view is ViewGroup) {
+            for (i in 0 until view.childCount) {
+                serializeViewHierarchy(
+                    view.getChildAt(i),
+                    serializer,
+                    shouldInjectTestIds,
+                    indexPath + i
+                )
+            }
+        }
+
+        serializer.endTag("", view.javaClass.simpleName)
+    }
+
+    private fun serializeViewAttributes(
+        view: View,
+        serializer: XmlSerializer,
+        shouldInjectTestIds: Boolean,
+        indexPath: List<Int>
+    ) {
+        val attributes = mutableMapOf(
+            "class" to view.javaClass.name,
+            "width" to view.width.toString(),
+            "height" to view.height.toString(),
+            "visibility" to view.visibilityToString(),
+            "alpha" to view.alpha.toString(),
+            "focused" to view.isFocused.toString(),
+            "value" to (view.contentDescription?.toString() ?: ""),
+            "label" to (view.getAccessibilityLabel()?.toString() ?: "")
+        )
+
+        view.id.takeIf { it != View.NO_ID }?.let {
+            attributes["id"] = try {
+                view.resources.getResourceName(it)
+            } catch (e: Exception) {
+                it.toString()
+            }
+        }
+
+        val location = IntArray(2).apply { view.getLocationInWindow(this) }
+        attributes["x"] = location[0].toString()
+        attributes["y"] = location[1].toString()
+
+        if (view is TextView) {
+            attributes["text"] = view.text.toString()
+        }
+
+        val currentTestId = view.tag?.toString() ?: ""
+
+        val injectedPrefix = "detox_temp_"
+        val isTestIdEmpty = currentTestId.isEmpty()
+        val isTestIdInjected = currentTestId.startsWith(injectedPrefix)
+        val shouldInjectNewTestId = shouldInjectTestIds && (isTestIdEmpty || isTestIdInjected)
+
+        if (shouldInjectNewTestId) {
+            val newTestId = "${injectedPrefix}${indexPath.joinToString("_")}"
+            view.tag = newTestId
+            attributes["testID"] = newTestId
+        } else {
+            attributes["testID"] = currentTestId
+        }
+
+        attributes
+            .filter { (_, value) ->
+                !value.isNullOrEmpty()
+            }
+            .forEach { (key, value) ->
+                serializer.attribute("", key, value)
+            }
+    }
+
+    private fun View.visibilityToString() = when (visibility) {
+        View.VISIBLE -> "visible"
+        View.INVISIBLE -> "invisible"
+        View.GONE -> "gone"
+        else -> "unknown"
+    }
+}

package/detox.d.ts

@@ -917,6 +917,18 @@ declare global {
              */
             captureViewHierarchy(name?: string): Promise<string>;
 
+            /**
+             * Dump the current view hierarchy of the app as an XML string.
+             * @param [shouldInjectTestIds=false] whether to inject testIDs into the view hierarchy when missing,
+             * to provide an identifiable reference for each element.
+             * @returns a string containing the XML representation of the view hierarchy.
+             * @example
+             * const viewHierarchy = await device.generateViewHierarchyXml();
+             * const viewHierarchyWithInjectedTestIds = await device.generateViewHierarchyXml(true);
+             * @note enabling shouldInjectTestIds changes the actual elements during the test run, use with caution.
+             */
+            generateViewHierarchyXml(shouldInjectTestIds?: boolean): Promise<string>;
+
             /**
              * Simulate shake (iOS Only)
              */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.25.6",
+  "version": "20.26.1",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -71,6 +71,7 @@
     "caf": "^15.0.1",
     "chalk": "^4.0.0",
     "child-process-promise": "^2.2.0",
+    "detox-copilot": "^0.0.0",
     "execa": "^5.1.1",
     "find-up": "^5.0.0",
     "fs-extra": "^11.0.0",
@@ -115,5 +116,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "0aa62157767805969e43dfe997f49d65652f76d2"
+  "gitHead": "deb90d069fcbbdb068602764465a2b77c443214a"
 }

package/src/android/espressoapi/Detox.js

@@ -69,6 +69,21 @@ class Detox {
     };
   }
 
+  static generateViewHierarchyXml(shouldInjectTestIds) {
+    if (typeof shouldInjectTestIds !== "boolean") throw new Error("shouldInjectTestIds should be a boolean, but got " + (shouldInjectTestIds + (" (" + (typeof shouldInjectTestIds + ")"))));
+    return {
+      target: {
+        type: "Class",
+        value: "com.wix.detox.Detox"
+      },
+      method: "generateViewHierarchyXml",
+      args: [{
+        type: "boolean",
+        value: shouldInjectTestIds
+      }]
+    };
+  }
+
 }
 
 module.exports = Detox;

package/src/client/Client.js

@@ -225,6 +225,12 @@ class Client {
     }));
   }
 
+  async generateViewHierarchyXml({ shouldInjectTestIds }) {
+    return await this.sendAction(new actions.GenerateViewHierarchyXml({
+      shouldInjectTestIds
+    }));
+  }
+
   async currentStatus() {
     return await this.sendAction(new actions.CurrentStatus());
   }

package/src/client/actions/actions.js

@@ -292,6 +292,25 @@ class SetInstrumentsRecordingState extends Action {
   }
 }
 
+class GenerateViewHierarchyXml extends Action {
+  constructor(params) {
+    super('generateViewHierarchyXml', params);
+  }
+
+  get isAtomic() {
+    return false;
+  }
+
+  get timeout() {
+    return 0;
+  }
+
+  async handle(response) {
+    this.expectResponseOfType(response, 'generateViewHierarchyXmlResult');
+    return response.params.viewHierarchy;
+  }
+}
+
 class CaptureViewHierarchy extends Action {
   constructor(params) {
     super('captureViewHierarchy', params);
@@ -312,7 +331,7 @@ class CaptureViewHierarchy extends Action {
     if (captureViewHierarchyError) {
       throw new DetoxRuntimeError({
         message: 'Failed to capture view hierarchy. Reason:\n',
-        debugInfo: captureViewHierarchyError,
+        debugInfo: captureViewHierarchyError
       });
     }
 
@@ -336,4 +355,5 @@ module.exports = {
   SetOrientation,
   SetInstrumentsRecordingState,
   CaptureViewHierarchy,
+  GenerateViewHierarchyXml
 };

package/src/copilot/CopilotDriver.js

@@ -0,0 +1,140 @@
+const { device } = require('../..');
+
+class DetoxDriver {
+  constructor() {
+    this.availableAPI = {
+      matchers: [
+        {
+          signature: 'by.id(id: string)',
+          description: 'Matches elements by their test ID.',
+          example: "element(by.id('loginButton'))",
+          guidelines: ['Always use test-ids (accessibility identifiers) from the UI hierarchy to identify elements.']
+        },
+        {
+          signature: 'by.text(text: string)',
+          description: 'Matches elements by their text.',
+          example: "element(by.text('Login'))",
+          guidelines: ['Avoid using text matchers when possible, prefer test-ids.']
+        },
+        {
+          signature: 'by.type(type: string)',
+          description: 'Matches elements by their type.',
+          example: "element(by.type('RCTTextInput'))",
+          guidelines: ['Use type matchers as a last resort, prefer test-ids.']
+        }
+      ],
+      actions: [
+        {
+          signature: 'tap(point?: Point2D)',
+          description: 'Simulates tap on an element',
+          example: "await element(by.id('loginButton')).tap();",
+          guidelines: ['Use element(by.id(\'testID\')) to locate elements.']
+        },
+        {
+          signature: 'longPress(point?: Point2D, duration?: number)',
+          description: 'Simulates long press on an element',
+          example: "await element(by.id('menuItem')).longPress();",
+          guidelines: ['If the target element is not accessible, interact with its container or the most relevant parent element.']
+        },
+        {
+          signature: 'typeText(text: string)',
+          description: 'Types text into a text field',
+          example: "await element(by.id('usernameInput')).typeText('myusername');",
+          guidelines: ['Typing can only be done on text field elements.']
+        },
+        {
+          signature: 'replaceText(text: string)',
+          description: 'Replaces text in a text field',
+          example: "await element(by.id('usernameInput')).replaceText('newusername');",
+          guidelines: ['Use this to replace existing text in a field.']
+        },
+        {
+          signature: 'clearText()',
+          description: 'Clears text from a text field',
+          example: "await element(by.id('usernameInput')).clearText();",
+          guidelines: ['Use this to clear existing text from a field.']
+        },
+        {
+          signature: 'scrollTo(edge: Direction, startPositionX?: number, startPositionY?: number)',
+          description: 'Scrolls to an edge',
+          example: "await element(by.id('scrollView')).scrollTo('bottom');",
+          guidelines: ['Scrolling must be done only on scroll-view elements.']
+        },
+        {
+          signature: 'scrollToIndex(index: Number)',
+          description: 'Scrolls to a specific index',
+          example: "await element(by.id('flatList')).scrollToIndex(5);",
+          guidelines: ['Use this for scrolling to a specific item in a list.']
+        },
+        {
+          signature: 'adjustSliderToPosition(newPosition: number)',
+          description: 'Adjusts slider to a position',
+          example: "await element(by.id('slider')).adjustSliderToPosition(0.75);",
+          guidelines: ['The position should be a number between 0 and 1.']
+        },
+        {
+          signature: 'setColumnToValue(column: number, value: string)',
+          description: 'Sets picker view column to a value (iOS only)',
+          example: "await element(by.id('datePicker')).setColumnToValue(1, '2023');",
+          guidelines: ['This is only available on iOS.']
+        },
+        {
+          signature: 'performAccessibilityAction(actionName: string)',
+          description: 'Triggers an accessibility action',
+          example: "await element(by.id('button')).performAccessibilityAction('longpress');",
+          guidelines: ['Use the provided value from the intent and do not change it.']
+        },
+        {
+          signature: 'swipe(direction: Direction, speed?: Speed, percentage?: number)',
+          description: 'Swipes in the specified direction',
+          example: "await element(by.id('card')).swipe('left', 'fast');",
+          guidelines: ['Use this for swiping gestures on elements.']
+        },
+        {
+          signature: 'pinch(scale: number, speed?: Speed, angle?: number)',
+          description: 'Performs a pinch gesture (iOS only)',
+          example: "await element(by.id('image')).pinch(0.5);",
+          guidelines: ['This is only available on iOS. Scale < 1 zooms out, scale > 1 zooms in.']
+        }
+      ],
+      assertions: [
+        {
+          signature: 'toBeVisible()',
+          description: 'Asserts that the element is visible',
+          example: "await expect(element(by.id('loginButton'))).toBeVisible();",
+          guidelines: ['Use this to check if an element is visible on the screen.']
+        },
+        {
+          signature: 'toExist()',
+          description: 'Asserts that the element exists',
+          example: "await expect(element(by.id('username'))).toExist();",
+          guidelines: ['Use this to check if an element exists in the hierarchy, even if not visible.']
+        },
+        {
+          signature: 'toHaveText(text: string)',
+          description: 'Asserts that the element has the specified text',
+          example: "await expect(element(by.id('label'))).toHaveText('Hello, World!');",
+          guidelines: ['Use this to check the text content of an element.']
+        },
+        {
+          signature: 'toHaveValue(value: string)',
+          description: 'Asserts that the element has the specified value',
+          example: "await expect(element(by.id('slider'))).toHaveValue('0.5');",
+          guidelines: ['Use this to check the value of an element.']
+        }
+      ]
+    };
+  }
+
+  async captureSnapshotImage() {
+    const fileName = `snapshot_${Date.now()}.png`;
+    await device.takeScreenshot(fileName);
+    return fileName;
+  }
+
+  async captureViewHierarchyString() {
+    return device.generateViewHierarchyXml();
+  }
+}
+
+module.exports = DetoxDriver;

package/src/devices/runtime/RuntimeDevice.js

@@ -20,6 +20,7 @@ class RuntimeDevice {
       'clearKeychain',
       'disableSynchronization',
       'enableSynchronization',
+      'generateViewHierarchyXml',
       'installApp',
       'installUtilBinaries',
       'launchApp',
@@ -195,6 +196,10 @@ class RuntimeDevice {
     return this.deviceDriver.captureViewHierarchy(name);
   }
 
+  async generateViewHierarchyXml(shouldInjectTestIds = false) {
+    return await this.deviceDriver.generateViewHierarchyXml(shouldInjectTestIds);
+  }
+
   async sendToHome() {
     await this.deviceDriver.sendToHome();
     await this.deviceDriver.waitForBackground();

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

@@ -222,6 +222,10 @@ class DeviceDriverBase {
   async captureViewHierarchy() {
     return '';
   }
+
+  async generateViewHierarchyXml(_shouldInjectTestIds) {
+    return '';
+  }
 }
 
 module.exports = DeviceDriverBase;

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

@@ -245,6 +245,11 @@ class AndroidDriver extends DeviceDriverBase {
     await this.invocationManager.execute(call);
   }
 
+  async generateViewHierarchyXml(shouldInjectTestIds) {
+    const hierarchy = await this.invocationManager.execute(DetoxApi.generateViewHierarchyXml(shouldInjectTestIds));
+    return hierarchy.result;
+  }
+
   _getAppInstallPaths(_appBinaryPath, _testBinaryPath) {
     const appBinaryPath = getAbsoluteBinaryPath(_appBinaryPath);
     const testBinaryPath = _testBinaryPath ? getAbsoluteBinaryPath(_testBinaryPath) : this._getTestApkPath(appBinaryPath);

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

@@ -194,6 +194,10 @@ class SimulatorDriver extends IosDriver {
     return viewHierarchyURL;
   }
 
+  async generateViewHierarchyXml(shouldInjectTestIds) {
+    return await this.client.generateViewHierarchyXml({ shouldInjectTestIds });
+  }
+
   async setStatusBar(flags) {
     await this._applesimutils.statusBarOverride(this.udid, flags);
   }

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

@@ -1 +0,0 @@
-94c7ef8a28dc964b657eea2fe3b976a0

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

@@ -1 +0,0 @@
-b7253a70da80514f9fb458066ba45f5aeda16686

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

@@ -1 +0,0 @@
-21b3215e69149679168a08bfa855a0089455f54ba9ab883ef1b268c001ce2216

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

@@ -1 +0,0 @@
-a119637d941ad18e51e753ea1ee6a3cd6d068166cafb54cb0474373f48e84647875c742c4c54670af01f8d3f055c3e1907945b8811c5c1206aec0152c4186460

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

@@ -1 +0,0 @@
-f8f2a2bd622fadc1baf0d5be4f21622f

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

@@ -1 +0,0 @@
-3ce2c636fb75e7758525c444e9b19f7a69ff7aa2

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

@@ -1 +0,0 @@
-b6d5ba6221494632ff63d50785be381add4d688d167e1696d3f027d76a768042

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

@@ -1 +0,0 @@
-0b22922e5fb5f7c8d8851661cf96982870f7a942939f5648ad4f72da1711515be0a6198fd9d789c2d45deedb0129452a6167f7068ab68b92c39d890fd2e467aa

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

@@ -1 +0,0 @@
-48e491ac5e2166bc14b836ac291d9a10

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

@@ -1 +0,0 @@
-874588e8c8d28d2cf1ef211ece43cb92dd4dd0ba

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

@@ -1 +0,0 @@
-69b0bb114b00a7419670658bc0326c64dde8b2b4a4ec49c540de1f9186d8c324

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

@@ -1 +0,0 @@
-472e53824831f47311d2848f3b6093d269f5dab58e01bded5ce08b3421e80916336d4f5001e8b9e1409b1a1e214023fc62de45d46931647aaee268af3c858947

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

@@ -1 +0,0 @@
-208d53855f5405b6ca2ec1a57b08aa8a

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

@@ -1 +0,0 @@
-4039b32649b959622a11f2da5640e3cd05d257da

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

@@ -1 +0,0 @@
-1f35717c6a33f825af51b62048b2d63c8a8f9d1de927f8226af66b33f38ee0ea

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

@@ -1 +0,0 @@
-2ffecf597779fcbe167e95d8bd43ae895f3484fe4f755624894f1be22e840242b8d6a57edb20996d36276757ea11a41c22cc892517e3a70a5f6952726b6c7032

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

@@ -1 +0,0 @@
-d271489c0570c8529c634b79843bc0a0

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

@@ -1 +0,0 @@
-e0bceb0063fccfb5b5a0c173587a33720eca9d8d

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

@@ -1 +0,0 @@
-328f2d83c0c54a3ac3e8cc0aadadd27f622c79d5c6f4490c2852ca8ef5f76b8f

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

@@ -1 +0,0 @@
-22fe1aa0a7686ab99c4c5cb81bbf8c16e35c79039fc2dc070c9c6c14687042cd3182cc554ee0da4c48b5ec8330fa98b9887a8e7cf06f04c66f30612e919cbc2a

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

@@ -1 +0,0 @@
-3e46d6dfb8ac381ce01685ebc04694e4

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

@@ -1 +0,0 @@
-08e1e7773a8fb58ce4acac2310157b186767b361

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

@@ -1 +0,0 @@
-29a7dee48d0b9f065ae740b3da5e2b5f57d208ac7ad856947f8b94db980d431a

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

@@ -1 +0,0 @@
-ad4d04e5db6c1f7d4430107cdbf7a52c3f9da6e5b53c3111288bf328ea8c0598a9fc481681781a7119994457bc0a1ff3968b5fdf38d5d1a36e40363be4cbbbe7