detox 20.25.6 → 20.26.2

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

@@ -0,0 +1 @@
+ea98a7bac84cd877ac7a13aa5b9d3cc1

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

@@ -0,0 +1 @@
+a67071d6d4bdcd041e91bc9f58d5d57637532cb9

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

@@ -0,0 +1 @@
+9e325d7b0b5b8dab384773bcf96df7a44e7a76f5375b1afba2e29b9a53c60e7b

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

@@ -0,0 +1 @@
+4ca91364a087ff16bd38d1721163b47f3d6435552605e1c2cba38138739e42bf45161458e997bc14be075b0bfa9df2ac8a311c79dc21e67216726b3f8a920db1

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

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

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

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

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

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

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

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

package/Detox-android/com/wix/detox/{20.25.6/detox-20.25.6.pom → 20.26.2/detox-20.26.2.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.2</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,13 +69,13 @@
     <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>
@@ -78,12 +84,6 @@
       <version>2.2.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.2/detox-20.26.2.pom.md5

@@ -0,0 +1 @@
+f5574f4b81f29bd42c5da2cbaae85003

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

@@ -0,0 +1 @@
+65101d817b9185e67e3d5fb396107ad252a6ade7

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

@@ -0,0 +1 @@
+8830fd9064558962e2d7195512f9db4aae71801865f20b240a17ba4cebc21ab4

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

@@ -0,0 +1 @@
+d026c556f62910b4728822cea8b03745bf74617c2bf3df7d97b29eb0007a1ace87a00af9aec32fa1798f0345e551ed62abd9be7e16f96b59ae56a88950ea46ce

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.2</latest>
+    <release>20.26.2</release>
     <versions>
-      <version>20.25.6</version>
+      <version>20.26.2</version>
     </versions>
-    <lastUpdated>20240825174403</lastUpdated>
+    <lastUpdated>20240905213155</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-3ebd487874d7ca9ea9e79f14ae8b2228
+9e3e8a8d05fd018af3b4b1cecac85ceb

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

@@ -1 +1 @@
-22de2239bc50b05a3d10d735a8435b281aa5aa77
+49a5d3258b3a4b18d55c0c803f65e9c7bb470c8e

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

@@ -1 +1 @@
-85fa4bb20d12f08cbc7ea2dfcd7245707cd1b7ba6047bd9f3b45582bceef0227
+f8b05715aaf9d675552325c062d5509e983560df36e2c0964bf858aac906be06

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

@@ -1 +1 @@
-7a948085b3d47fb26694edba0bfe6fef3805bf069873bd4273e57fa11ee49e36b2cf61e9f74cdd953c9763945b8666c4cd72b2bb3f450eadc0d2bf608f26f29d
+9f65c4a4e108884baa631feba8abcc34372ee88b3d194b4eb9f94c88162e262fd8a0ed62f4ec94162c3891ea6ca085ba737892d73709ac2ec3b32e1d1e22ae69

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

@@ -0,0 +1 @@
+5fe1ece0c6f59a509e44c153a67c0aad

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

@@ -0,0 +1 @@
+af24ad68bc24fda67b522b4853d47193de81fb59

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

@@ -0,0 +1 @@
+56e2fc034e270dd194fbfa0a8fe24e1b95fb298564cfa6a31c1b79d5eeb5f3f2

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

@@ -0,0 +1 @@
+109252b02fbd404778467ad18d611ebbb1a442dde9dca1d8e3feb469d81a0d6aff4a5285fb3677dc219b23acc78c88a134f3f3ef5f19487b7b7d3fb06049a4c8

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

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

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

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

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

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

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

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

package/Detox-android/com/wix/detox-legacy/{20.25.6/detox-legacy-20.25.6.pom → 20.26.2/detox-legacy-20.26.2.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.2</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,13 +69,13 @@
     <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>
@@ -78,12 +84,6 @@
       <version>2.2.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.2/detox-legacy-20.26.2.pom.md5

@@ -0,0 +1 @@
+817a01b2f72e4cc9ee814d9aa83a6898

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

@@ -0,0 +1 @@
+5ab9e6d2bf60cc87c07b26d73ded613cc4692fe4

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

@@ -0,0 +1 @@
+26768c504f24bc35eee880bfe2fcc6c062aac63e5eee306d2196d27c989dbc40

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

@@ -0,0 +1 @@
+af66500c5a4d075c5d9c739439fc49bcdebe5a7b2f8d364b7e8b1f879fc0901184b928d33ed66b59f3b5d7b89050acc3b6d4e1bfd151e114561ba975c9ca6e59

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.2</latest>
+    <release>20.26.2</release>
     <versions>
-      <version>20.25.6</version>
+      <version>20.26.2</version>
     </versions>
-    <lastUpdated>20240825174441</lastUpdated>
+    <lastUpdated>20240905213242</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-e8677f5e1ebc2db6a82900c05f8d79dc
+7d1e75f8073d7e8507484042d83103e1

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

@@ -1 +1 @@
-12b4921860e458ca7333620fec5ca94bec62c05b
+f106fa7fa6ca0ecff78f8b6c7094118a0266de5a

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

@@ -1 +1 @@
-74491490f648f58107b92765dd805167f3187b42ebf3a94408c017e654c46334
+8d88d3608dc25dd1305f93cb629d308c3167f6e4ea232efbbc54f309288d5bba

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

@@ -1 +1 @@
-7ce4eab1a1b798a283d6c22884823a9dfd7aa06b177889c1a7c305661fd3b2095703b8f9d3311907a6652d78763ece4aada1353f70b5f9b71bfd525981d93b70
+ce63462b86b96e3ee62a7817f56fb3f91d30801e93c41e0a9b8e8a0300a3bae285d17c1bd7a07054bc45557f9c1b16da338dcce8ef8197c7957088c327ea4b4d

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,26 +123,25 @@ 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') {

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.2",
   "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": "e0a1fefeeec0382b5dc75613a2076d0f6a05e97f"
 }

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