detox 20.26.3-smoke.0 → 20.27.1

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

@@ -0,0 +1 @@
+6a7785c5beade116fb95f224126e3d94

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

@@ -0,0 +1 @@
+282a3d71cfb16689e484ad5b8cbdf8b4ffcc2fd4

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

@@ -0,0 +1 @@
+c3a3ba182f11c386c4ec93281f2cbf630a4315cad97289a0f002972c2fb234c9

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

@@ -0,0 +1 @@
+0babdde000779bbe81fbf61964e4578b2a23ddd8ae8f65aaa48f71e6d3cd1306d473501c44ba95f48416a99a2e5cad8a38ebe85d272616522a0bfe4e09e1878f

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

@@ -0,0 +1 @@
+14161501d9cf4606ee49296e14c047e4

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

@@ -0,0 +1 @@
+38e956edb72453c00c00ab752443f394389737bf

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

@@ -0,0 +1 @@
+0a76b1d5efeea5e83fa9e92e75bc29913b9e7db28b7b30652638966506299f90

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

@@ -0,0 +1 @@
+f3b3510a065744da054200cbcfb62549d469aa27068939879f07c64421cfef223aa34ed6346b6e9c5839a1a42cdc76699b16ad4395545abfb01cd611381df408

package/Detox-android/com/wix/detox/{20.26.3-smoke.0/detox-20.26.3-smoke.0.pom → 20.27.1/detox-20.27.1.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.26.3-smoke.0</version>
+  <version>20.27.1</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.27.1/detox-20.27.1.pom.md5

@@ -0,0 +1 @@
+4fbbcc9b1460bdaad46d32f629e3d589

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

@@ -0,0 +1 @@
+961629dada06b32a080e9abe7909bb91032de53a

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

@@ -0,0 +1 @@
+322e950b4d47c41096aa1525ae34d866e7955bd3d2d091f4b207158a6f622c9b

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

@@ -0,0 +1 @@
+3117059ac5711d3e06fea0be3a0fcea07f077bc6b7be465a26b7591784da214fadf299c3794eba97fb60bbebced3256943dbb211ac7702132ae9635665d5d788

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.26.3-smoke.0</latest>
-    <release>20.26.3-smoke.0</release>
+    <latest>20.27.1</latest>
+    <release>20.27.1</release>
     <versions>
-      <version>20.26.3-smoke.0</version>
+      <version>20.27.1</version>
     </versions>
-    <lastUpdated>20240917060539</lastUpdated>
+    <lastUpdated>20240923182824</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-c9dce87376b980841f7ebb597c4d759c
+b0663aafff90f42ece492a2bcaf7baec

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

@@ -1 +1 @@
-2dd1a860644b18bf605a33fe718665d6d57a0151
+1001cbc58bbfa8763defd8cef091b50046364d02

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

@@ -1 +1 @@
-0599d1d2468126edae8a46b7e31d1ec7431cdcf14adb67b4be2834296179c136
+07d7f8da49dbf7ab284acb34967da94bb84c6cea2c8ee0898811a775ae7450fe

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

@@ -1 +1 @@
-d154c9adc4d5d575bce804d4624fb5051270dcd9c04e924c34786b2d3d2c02bb7a74b6be25faba82078e1d85f5f199b7887548534dac62cdb19cf45f88671cfa
+2fb37d07f83c220fac552876664268022630f22a2b51cdb3392655832f3dd24bb712e0ebc2128dde7d72f3cd57599b80d0d021e86737ce69a28fab47bccb69a5

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

@@ -0,0 +1 @@
+d8fa6581305d5677dc8fc505c979afa4

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

@@ -0,0 +1 @@
+0bf9b98aede1b304cf57d489f1e043f6ac28ee84

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

@@ -0,0 +1 @@
+216378cc3328e66e3f7a236cfcdb3672f963f1db10b18499c1ffd8476bcd4b6a

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

@@ -0,0 +1 @@
+9756c8ae3a816b6285ee16774ea82237da03e24c3dd48f9e564c2251abf97afc6b36952df51de07795f78300d61f37c27b74c6c61477e029afb3068dc57ba8f4

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

@@ -0,0 +1 @@
+02d974914d78e64b365486e3369ae1e1

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

@@ -0,0 +1 @@
+173b898bfecd41c34b0ad24d7e1996c8d3b0621b

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

@@ -0,0 +1 @@
+8a30f740e17ad80816f17ceb61b354d7da12f651764e040ddf85b1c3609992a3

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

@@ -0,0 +1 @@
+90f61852b868773b3548daf4c04793cc0285df750cbfb8947375ec81f5882469cf6e6132295e3b115b27d61733c1bb5f4954a14e7246aa8da19e97bd28191c5f

package/Detox-android/com/wix/detox-legacy/{20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.pom → 20.27.1/detox-legacy-20.27.1.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox-legacy</artifactId>
-  <version>20.26.3-smoke.0</version>
+  <version>20.27.1</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.27.1/detox-legacy-20.27.1.pom.md5

@@ -0,0 +1 @@
+1d711e19c5856f3987b3f2821d591b68

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

@@ -0,0 +1 @@
+a522dde967fb79aed046806088ecb7457f0e938b

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

@@ -0,0 +1 @@
+7b9667b2fa6ca43e92d90c1b0e2c1054c11458fd4d72730edf45c793672f726c

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

@@ -0,0 +1 @@
+00d73fa19f105dc273bd44b52c02b73c8eeb70405f61b6bc3ad8a19c640f7b28c829ddbd34fd9c052ed9decec7d199855dcd2eb5f0a191fee2dfc789f1a8ae93

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.26.3-smoke.0</latest>
-    <release>20.26.3-smoke.0</release>
+    <latest>20.27.1</latest>
+    <release>20.27.1</release>
     <versions>
-      <version>20.26.3-smoke.0</version>
+      <version>20.27.1</version>
     </versions>
-    <lastUpdated>20240917060602</lastUpdated>
+    <lastUpdated>20240923182941</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-e9a6c64e815d221bb0a21ce15b8972b0
+fd1de26f13a6099dc0ea8653c61cd67d

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

@@ -1 +1 @@
-031b16bba0f2487ac5681ed586b23527218d7a0d
+ec4629f0d73e338d6ed23b0cad15f2e54b7ade64

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

@@ -1 +1 @@
-4391d7a2448d4994a33cdb28bf1379342a199be96b75c775d6f772f30c95b834
+84679287bb5c654b7ca9f5c860712d5d327f17670b89dfae4df2e686ee142899

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

@@ -1 +1 @@
-7592100e94a9574fc3b554f68055364cca63c1e70617ff16efed9298f804bef1b954df11df0c48f8aed10f7a17af26fc00b04e01f6e527f182ddeb54ab647d54
+1d231b1ce95ce6608a20498393cfc9c005598bcbe78da9c3595679e315b83a0c41bc93b54be0632a5183a8e233ebe758f1a1fa5d233c5e9b1f532b24e5ce9c7f

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

@@ -16,6 +16,9 @@
 
 -keep class kotlin.reflect.** { *; }
 -keep class kotlin.coroutines.CoroutineDispatcher { *; }
+-keep class kotlin.coroutines.CoroutineScope { *; }
+-keep class kotlin.coroutines.CoroutineContext { *; }
+-keep class kotlinx.coroutines.BuildersKt { *; }
 -keep class kotlin.jvm.** { *; }
 -keep class kotlin.collections.** { *; }
 -keep class kotlin.text.** { *; }

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

@@ -3,19 +3,53 @@ package com.wix.detox.espresso.hierarchy
 import android.util.Xml
 import android.view.View
 import android.view.ViewGroup
+import android.webkit.WebView
 import android.widget.TextView
 import com.wix.detox.reactnative.ui.getAccessibilityLabel
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.suspendCancellableCoroutine
+import kotlinx.coroutines.withContext
 import org.xmlpull.v1.XmlSerializer
 import java.io.StringWriter
+import kotlin.coroutines.resume
+
+
+private const val GET_HTML_SCRIPT = """
+    const blacklistedTags = ['script', 'style', 'head', 'meta'];
+    const blackListedTagsSelector = blacklistedTags.join(',');
+
+    (function() {
+    // Clone the entire document
+    var clonedDoc = document.documentElement.cloneNode(true);
+
+    // Remove all <script> and <style> tags from the cloned document
+    var scripts = clonedDoc.querySelectorAll(blackListedTagsSelector);
+    scripts.forEach(function(script) {
+        script.remove();
+    });
+
+    // Create an instance of XMLSerializer
+    var serializer = new XMLSerializer();
+
+    // Serialize the cloned DOM to a string
+    var serializedHtml = serializer.serializeToString(clonedDoc);
+
+    // Return the serialized HTML as a string
+    return serializedHtml;
+})();
+"""
 
 object ViewHierarchyGenerator {
     @JvmStatic
     fun generateXml(shouldInjectTestIds: Boolean): String {
-        val rootViews = RootViewsHelper.getRootViews()
-        return generateXmlFromViews(rootViews, shouldInjectTestIds)
+        return runBlocking {
+            val rootViews = RootViewsHelper.getRootViews()
+            generateXmlFromViews(rootViews, shouldInjectTestIds)
+        }
     }
 
-    private fun generateXmlFromViews(rootViews: List<View?>?, shouldInjectTestIds: Boolean): String {
+    private suspend fun generateXmlFromViews(rootViews: List<View?>?, shouldInjectTestIds: Boolean): String {
         return StringWriter().use { writer ->
             val serializer = Xml.newSerializer().apply {
                 setOutput(writer)
@@ -39,7 +73,7 @@ object ViewHierarchyGenerator {
         }
     }
 
-    private fun serializeViewHierarchy(
+    private suspend fun serializeViewHierarchy(
         view: View,
         serializer: XmlSerializer,
         shouldInjectTestIds: Boolean,
@@ -48,20 +82,59 @@ object ViewHierarchyGenerator {
         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
-                )
-            }
+        when (view) {
+            is WebView -> serializeWebView(view, serializer)
+            is ViewGroup -> serializeViewGroupChildren(view, serializer, shouldInjectTestIds, indexPath)
         }
 
         serializer.endTag("", view.javaClass.simpleName)
     }
 
+    private suspend fun serializeWebView(
+        webView: WebView,
+        serializer: XmlSerializer,
+    ) {
+        val html = getWebViewHtml(webView)
+        serializer.cdsect(html)
+    }
+
+    private suspend fun getWebViewHtml(webView: WebView): String = withContext(Dispatchers.Main) {
+        suspendCancellableCoroutine { cancellableContinuation ->
+            webView.evaluateJavascript(GET_HTML_SCRIPT) { html ->
+                cancellableContinuation.resume(html.unescapeUnicodeString())
+            }
+        }
+    }
+
+    private fun String.unescapeUnicodeString(): String {
+        // Replace all Unicode escape sequences (e.g., \u003C -> <)
+        return this
+            .replace("\\u003C", "<")
+            .replace("\\u003E", ">")
+            .replace("\\u0022", "\"")
+            .replace("\\u0027", "'")
+            .replace("\\u0026", "&")
+            .replace("\\u003D", "=")
+            .replace("\\u002F", "/")
+            .replace("\\n", "\n")
+    }
+
+    private suspend fun serializeViewGroupChildren(
+        view: ViewGroup,
+        serializer: XmlSerializer,
+        shouldInjectTestIds: Boolean,
+        indexPath: List<Int>
+    ) {
+        for (i in 0 until view.childCount) {
+            serializeViewHierarchy(
+                view.getChildAt(i),
+                serializer,
+                shouldInjectTestIds,
+                indexPath + i
+            )
+        }
+    }
+
     private fun serializeViewAttributes(
         view: View,
         serializer: XmlSerializer,
@@ -79,14 +152,6 @@ object ViewHierarchyGenerator {
             "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()

package/detox.d.ts

@@ -9,6 +9,7 @@
 // * Dor Ben Baruch <https://github.com/Dor256>
 
 import { BunyanDebugStreamOptions } from 'bunyan-debug-stream';
+import { CopilotFacade, PromptHandler } from "detox-copilot";
 
 declare global {
     namespace Detox {
@@ -445,6 +446,8 @@ declare global {
 
             readonly system: SystemFacade;
 
+            readonly copilot: DetoxCopilotFacade;
+
             readonly DetoxConstants: {
                 userNotificationTriggers: {
                     push: 'push';
@@ -1287,6 +1290,18 @@ declare global {
             element(systemMatcher: SystemMatcher): IndexableSystemElement;
         }
 
+        interface DetoxCopilotFacade extends Pick<CopilotFacade, "perform"> {
+            /**
+             * Initializes the Copilot with the given prompt handler.
+             * Must be called before any other Copilot methods.
+             * @note Copilot APIs are still in experimental phase and are subject to changes in the near future.
+             * @param promptHandler The prompt handler to use.
+             */
+            init: (promptHandler: DetoxCopilotPromptHandler) => void;
+        }
+
+        interface DetoxCopilotPromptHandler extends PromptHandler {}
+
         interface IndexableSystemElement extends SystemElement {
             /**
              * Choose from multiple elements matching the same matcher using index

package/globals.d.ts

@@ -9,6 +9,7 @@ declare global {
   const by: Detox.DetoxExportWrapper['by'];
   const web: Detox.DetoxExportWrapper['web'];
   const system: Detox.DetoxExportWrapper['system'];
+  const copilot: Detox.DetoxExportWrapper['copilot'];
 
   namespace NodeJS {
     interface Global {
@@ -20,6 +21,7 @@ declare global {
       by: Detox.DetoxExportWrapper['by'];
       web: Detox.DetoxExportWrapper['web'];
       system: Detox.DetoxExportWrapper['system'];
+      copilot: Detox.DetoxExportWrapper['copilot'];
     }
   }
 }

package/jest.config.js

@@ -75,6 +75,7 @@ module.exports = {
     'src/DetoxWorker.js',
     'src/logger/utils/streamUtils.js',
     'src/realms',
+    'src/copilot',
   ],
   resetMocks: true,
   resetModules: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.26.3-smoke.0",
+  "version": "20.27.1",
   "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.0",
+    "detox-copilot": "^0.0.8",
     "execa": "^5.1.1",
     "find-up": "^5.0.0",
     "fs-extra": "^11.0.0",
@@ -116,5 +116,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "812c9ff6178ce32f3098afaa9d7daab6f018fe4f"
+  "gitHead": "a45478f98e0ad2d64327923ce191c314d8c27596"
 }

package/src/DetoxWorker.js

@@ -2,6 +2,7 @@ const CAF = require('caf');
 const _ = require('lodash');
 
 const Client = require('./client/Client');
+const DetoxCopilot = require('./copilot/DetoxCopilot');
 const environmentFactory = require('./environmentFactory');
 const { DetoxRuntimeErrorComposer } = require('./errors');
 const { InvocationManager } = require('./invoke');
@@ -58,6 +59,8 @@ class DetoxWorker {
     this.by = null;
     /** @type {Detox.WebFacade} */
     this.web = null;
+    /** @type {Detox.DetoxCopilotFacade} */
+    this.copilot = null;
 
     this._deviceCookie = null;
 
@@ -121,6 +124,8 @@ class DetoxWorker {
       runtimeDeviceFactory,
     } = environmentFactory.createFactories(deviceConfig);
 
+    this.copilot = new DetoxCopilot();
+
     const envValidator = envValidatorFactory.createValidator();
     yield envValidator.validate();
 
@@ -157,6 +162,7 @@ class DetoxWorker {
       const injectedGlobals = {
         ...matchers,
         device: this.device,
+        copilot: this.copilot,
         detox: this,
       };
 
@@ -219,6 +225,9 @@ class DetoxWorker {
   };
 
   onTestStart = function* (_signal, testSummary) {
+    // Copilot is reset before each test to ensure a clean state
+    this.copilot.resetIfNeeded();
+
     this._validateTestSummary('beforeEach', testSummary);
 
     yield this._dumpUnhandledErrorsIfAny({

package/src/copilot/DetoxCopilot.js

@@ -0,0 +1,33 @@
+const copilot = require('detox-copilot').default;
+
+const detoxCopilotFrameworkDriver = require('./detoxCopilotFrameworkDriver');
+
+class DetoxCopilot {
+  constructor() {
+    this.isInitialized = false;
+  }
+
+  init(promptHandler) {
+    copilot.init({
+      frameworkDriver: detoxCopilotFrameworkDriver,
+      promptHandler: promptHandler
+    });
+
+    this.isInitialized = true;
+  }
+
+  resetIfNeeded() {
+    if (!this.isInitialized) {
+      // Copilot is not initialized, nothing to reset
+      return;
+    }
+
+    copilot.reset();
+  }
+
+  perform(intent) {
+    return copilot.perform(intent);
+  }
+}
+
+module.exports = DetoxCopilot;

package/src/copilot/detoxCopilotFrameworkDriver.js

@@ -0,0 +1,320 @@
+// eslint-disable-next-line node/no-extraneous-require
+const jestExpect = require('expect').default;
+
+const detox = require('../..');
+
+const detoxCopilotFrameworkDriver = {
+  apiCatalog: {
+    context: { ...detox, jestExpect },
+    categories: [
+      {
+        title: 'Matchers',
+        items: [
+          {
+            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.'],
+          },
+          {
+            signature: 'atIndex(index: number)',
+            description: 'Selects the element at the specified index from a set of matched elements.',
+            example: "element(by.id('listItem')).atIndex(2)",
+            guidelines: ['Use `atIndex` when multiple elements match the same matcher to select a specific one by index.'],
+          },
+        ],
+      },
+      {
+        title: 'Actions',
+        items: [
+          {
+            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.',
+              'Long-press should be called with the relevant params only, e.g. `longPress(2000)`, `longPress({ x: 100, y: 200 })` or `longPress({ x: 100, y: 200 }, 2000)`.',
+            ],
+          },
+          {
+            signature: 'multiTap(times: number)',
+            description: 'Simulates multiple taps on an element.',
+            example: "await element(by.id('tappable')).multiTap(3);",
+            guidelines: ['All taps are applied as part of the same gesture.'],
+          },
+          {
+            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('textField')).replaceText('new text');",
+            guidelines: ['Faster than `typeText()`, but may not trigger all text input callbacks.'],
+          },
+          {
+            signature: 'clearText()',
+            description: 'Clears text from a text field.',
+            example: "await element(by.id('textField')).clearText();",
+            guidelines: ['Use this to clear text from input fields.'],
+          },
+          {
+            signature: 'tapReturnKey()',
+            description: 'Simulates tapping the return key on the keyboard while the element is focused.',
+            example: "await element(by.id('textField')).tapReturnKey();",
+            guidelines: ['Use this to simulate pressing the return key while typing into a text input field.'],
+          },
+          {
+            signature: 'tapBackspaceKey()',
+            description: 'Simulates tapping the backspace key on the keyboard while the element is focused.',
+            example: "await element(by.id('textField')).tapBackspaceKey();",
+            guidelines: ['Use this to simulate deleting text by pressing the backspace key in a text input field.'],
+          },
+          {
+            signature: 'adjustSliderToPosition(normalizedPosition: number)',
+            description: 'Adjusts the slider to a specified position between its minimum and maximum values.',
+            example: "await element(by.id('slider')).adjustSliderToPosition(0.75);",
+            guidelines: ['The position is a normalized value between 0 and 1, where 0 is minimum and 1 is maximum.'],
+          },
+          {
+            signature: 'scroll(offset: number, direction: string, startPositionX?: number, startPositionY?: number)',
+            description: 'Scrolls an element.',
+            example: "await element(by.id('scrollView')).scroll(100, 'down');",
+            guidelines: ['Specify direction as "up", "down", "left", or "right".'],
+          },
+          {
+            signature: 'scrollTo(edge: string)',
+            description: 'Scrolls to an edge of the element.',
+            example: "await element(by.id('scrollView')).scrollTo('bottom');",
+            guidelines: ['Specify edge as "top", "bottom", "left", or "right".'],
+          },
+          {
+            signature: 'scrollToIndex(index: number)',
+            description: 'Scrolls the element to the specified index. (Android only)',
+            example: "await element(by.id('scrollView')).scrollToIndex(10);",
+            guidelines: ['Use this to scroll to a specific item in a list. Only available on Android.'],
+          },
+          {
+            signature: 'swipe(direction: string, speed?: string, normalizedOffset?: number)',
+            description: 'Simulates a swipe on the element.',
+            example: "await element(by.id('scrollView')).swipe('up', 'slow', 0.5);",
+            guidelines: [
+              'Specify direction as "up", "down", "left", or "right".',
+              'Speed can be "fast", "slow". default is "fast".',
+            ],
+          },
+          {
+            signature: 'setColumnToValue(column: number, value: string)',
+            description: 'Sets a picker column to a specific value (iOS only).',
+            example: "await element(by.id('pickerView')).setColumnToValue(1, '6');",
+            guidelines: ['Use this for picker views on iOS.'],
+          },
+          {
+            signature: 'setDatePickerDate(dateString: string, dateFormat: string)',
+            description: 'Sets a date picker to a specific date.',
+            example: "await element(by.id('datePicker')).setDatePickerDate('2023-05-25', 'yyyy-MM-dd');",
+            guidelines: ['Use ISO8601 format when possible.'],
+          },
+          {
+            signature: 'performAccessibilityAction(actionName: string)',
+            description: 'Triggers an accessibility action.',
+            example: "await element(by.id('scrollView')).performAccessibilityAction('activate');",
+            guidelines: ['Use this to trigger specific accessibility actions.'],
+          },
+          {
+            signature: 'pinch(scale: number, speed?: string, angle?: number)',
+            description: 'Simulates a pinch gesture.',
+            example: "await element(by.id('PinchableScrollView')).pinch(1.1);",
+            guidelines: ['Use scale < 1 to zoom out, > 1 to zoom in.'],
+          },
+
+          {
+            signature: 'getAttributes()',
+            description: `
+    Retrieves various attributes of the element.
+
+    **Attributes include:**
+    - **Common**: text (string), label (string), placeholder (string), enabled (boolean), identifier (string), visible (boolean), value (string | number | boolean), frame (object: x (number), y (number), width (number), height (number))
+    - **iOS-only**: activationPoint (object: x (number), y (number)), normalizedActivationPoint (object: x (number), y (number)), hittable (boolean), elementFrame (object: x (number), y (number), width (number), height (number)), elementBounds (object: x (number), y (number), width (number), height (number)), safeAreaInsets (object: top (number), bottom (number), left (number), right (number)), elementSafeBounds (object: x (number), y (number), width (number), height (number)), date (Date), normalizedSliderPosition (number), contentOffset (object: x (number), y (number)), contentInset (object: top (number), bottom (number), left (number), right (number)), adjustedContentInset (object: top (number), bottom (number), left (number), right (number)))
+    - **Android-only**: visibility (string: 'visible', 'invisible', 'gone'), width (number) *(deprecated)*, height (number) *(deprecated)*, elevation (number), alpha (number), focused (boolean), textSize (number), length (number)
+
+    *Note:* Attributes may vary based on the platform and element type. If an attribute's value is null or cannot be computed, the key might be absent or contain an empty string.
+  `,
+            example: `
+    // Retrieve attributes of an element
+    const attributes = await element(by.text('Tap Me')).getAttributes();
+    jestExpect(attributes.text).toBe('Tap Me');
+
+    // Numerical assertions with allowed error range
+    jestExpect(attributes.frame.x).toBeCloseTo(100, 1);
+    jestExpect(attributes.frame.y).toBeCloseTo(200, 1);
+
+    // Platform-specific attribute check
+    if (device.getPlatform() === 'ios') {
+      jestExpect(attributes.hittable).toBe(true);
+    } else if (device.getPlatform() === 'android') {
+      jestExpect(attributes.visibility).toBe('visible');
+    }
+  `,
+            guidelines: [
+              'Use this to get properties like text, value, visibility, etc., for assertions or debugging. But only if the regular matchers or assertions are not sufficient.',
+              'Note that numerical values like position or size may not be very accurate; consider allowing a small error range in assertions.',
+              'Check the platform using `device.getPlatform()` before using platform-specific attributes.',
+              'Attributes include text, label, placeholder, enabled, identifier, visible, value, frame (with x, y, width, height), and platform-specific attributes.',
+            ],
+          },
+          {
+            signature: 'takeScreenshot(name: string)',
+            description: 'Captures a screenshot of the element.',
+            example: "const imagePath = await element(by.id('menuRoot')).takeScreenshot('menu_screenshot');",
+            guidelines: ['Use this to capture screenshots of elements for documentation or debugging purposes.'],
+          },
+          {
+            signature: 'longPressAndDrag(duration: number, normalizedPositionX: number, normalizedPositionY: number, targetElement: NativeElement, normalizedTargetPositionX?: number, normalizedTargetPositionY?: number, speed?: string, holdDuration?: number)',
+            description: 'Simulates a long press on the element and then drags it to a target element.',
+            example: "await element(by.id('draggable')).longPressAndDrag(2000, NaN, NaN, element(by.id('target')), NaN, NaN, 'fast', 0);",
+            guidelines: ['Use this to simulate drag-and-drop interactions between elements.'],
+          },
+          {
+            signature: 'launchApp(params: object)',
+            description: 'Launches the app with specified parameters.',
+            example: 'await device.launchApp({newInstance: true});',
+            guidelines: ['Use this to launch the app with specific configurations.'],
+          },
+          {
+            signature: 'reloadReactNative()',
+            description: 'Reloads the React Native JS bundle.',
+            example: 'await device.reloadReactNative();',
+            guidelines: ['Faster than `launchApp()`, use when you just need to reset React Native state/logic.'],
+          },
+        ],
+      },
+      {
+        title: 'Assertions',
+        items: [
+          {
+            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.'],
+          },
+          {
+            signature: 'toBeFocused()',
+            description: 'Asserts that the element is focused.',
+            example: "await expect(element(by.id('emailInput'))).toBeFocused();",
+            guidelines: ['Use this to check if an element is currently focused.'],
+          },
+          {
+            signature: 'toHaveLabel(label: string)',
+            description: 'Asserts that the element has the specified accessibility label.',
+            example: "await expect(element(by.id('submitButton'))).toHaveLabel('Submit');",
+            guidelines: [
+              'Use this to check the accessibility label of an element. Note that in React Native, the `accessibilityLabel` prop may behave differently on iOS and Android.',
+            ],
+          },
+          {
+            signature: 'toHaveId(id: string)',
+            description: 'Asserts that the element has the specified accessibility identifier.',
+            example: "await expect(element(by.text('Submit'))).toHaveId('submitButton');",
+            guidelines: ['Use this to check the testID/accessibility identifier of an element.'],
+          },
+          {
+            signature: 'toHaveSliderPosition(normalizedPosition: number, tolerance?: number)',
+            description:
+              'Asserts that the slider element has the specified normalized position [0, 1], within an optional tolerance.',
+            example:
+              "await expect(element(by.id('slider'))).toHaveSliderPosition(0.75);\nawait expect(element(by.id('slider'))).toHaveSliderPosition(0.3113, 0.00001);",
+            guidelines: ['Use this to verify the slider\'s position. Normalized position is between 0 and 1.'],
+          },
+          {
+            signature: 'toHaveToggleValue(value: boolean)',
+            description: 'Asserts that a toggle-able element is on/checked or off/unchecked.',
+            example:
+              "await expect(element(by.id('switch'))).toHaveToggleValue(true);\nawait expect(element(by.id('checkbox'))).toHaveToggleValue(false);",
+            guidelines: ['Use this to check the state of toggleable elements.'],
+          },
+          {
+            signature: 'withTimeout(timeout: number)',
+            description:
+              'Waits until the expectation is resolved for the specified amount of time.',
+            example:
+              "await waitFor(element(by.id('bigButton'))).toBeVisible().withTimeout(2000);",
+            guidelines: ['Use this to set a custom timeout for an expectation.'],
+          },
+          {
+            signature: 'not',
+            description: 'Negates the expectation.',
+            example:
+              "await expect(element(by.id('tinyButton'))).not.toBeVisible();\nawait expect(element(by.id('tinyButton'))).not.toExist();",
+            guidelines: ["Use 'not' to negate an expectation."],
+          },
+        ],
+      },
+      {
+        title: 'Utilities',
+        items: [
+          {
+            signature: 'jestExpect',
+            description: 'Jest expect utility for jest-assisted assertions. It is already imported in the environment.',
+            example: `
+    // Use jestExpect for assertions
+    jestExpect(2 + 2).toBe(4);
+    jestExpect('hello').toBe('hello');
+    jestExpect(true).toBeTruthy();
+  `,
+            guidelines: ['Use jestExpect for assertions in tests, only when the default expect is not helpful for the specific case.'],
+          },
+        ],
+      }
+    ],
+  },
+
+  captureSnapshotImage: async function () {
+    const fileName = `snapshot_${Date.now()}.png`;
+    return await detox.device.takeScreenshot(fileName);
+  },
+
+  captureViewHierarchyString: async function () {
+    return detox.device.generateViewHierarchyXml();
+  },
+};
+
+module.exports = detoxCopilotFrameworkDriver;

package/src/realms/DetoxContext.js

@@ -81,6 +81,8 @@ class DetoxContext {
 
   web = funpermaproxy.callable(() => this[symbols.worker].web);
 
+  copilot = funpermaproxy.callable(() => this[symbols.worker].copilot);
+
   get DetoxConstants() {
     return DetoxConstants;
   }

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0-sources.jar.md5

@@ -1 +0,0 @@
-940ec659b88e4b038b31f9525577b142

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0-sources.jar.sha1

@@ -1 +0,0 @@
-f2c62acc0bf957056471cbeeda8ef61a2bda1d16

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0-sources.jar.sha256

@@ -1 +0,0 @@
-87a3c3959cbfdfe97752011c3d875be0cc8617a382d7413c44cbf54cfb8a9633

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0-sources.jar.sha512

@@ -1 +0,0 @@
-ed9fb83b4eb9c70641132da18c4c238263666f18dfe3d0dc67f7e3236b60637aec516aeebc7196af797f829c093dbf25167d5701d2a345422345bca7ec1bc0a9

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.aar.md5

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

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.aar.sha1

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

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.aar.sha256

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

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.aar.sha512

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

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.pom.md5

@@ -1 +0,0 @@
-cbd939ff8e445e0c1caa7a3d061e38d3

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.pom.sha1

@@ -1 +0,0 @@
-02aaa6639fc2adf1b17bdb38fc6dd3892ea16169

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.pom.sha256

@@ -1 +0,0 @@
-f7c5d3017f74d9864b679a1625710762cff073ac5c983af7f55473ddeec7c8f6

package/Detox-android/com/wix/detox/20.26.3-smoke.0/detox-20.26.3-smoke.0.pom.sha512

@@ -1 +0,0 @@
-95cfa1ae0feb18779349b53698e3678ae84319e68594b72ff582711fe936541ea8bb516ccc6636ebae7112b3987a8f85c915de81e802997c1ae3eaa0628798a6

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0-sources.jar.md5

@@ -1 +0,0 @@
-86db18d1e8a5094c69622facab32eef9

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0-sources.jar.sha1

@@ -1 +0,0 @@
-0dfb34c3b85a1e010a80b793cedce11e51ab8573

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0-sources.jar.sha256

@@ -1 +0,0 @@
-9c9e4ac76f9cdcbd566c81f83d58ec1d69f69b84312e31c807c7282d9fa275d0

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0-sources.jar.sha512

@@ -1 +0,0 @@
-be4c786c5eb41d54a0fcdad6f95390fa5bb20e9afff3bc48f351a03ad50ec745a1b0272d13b92893ece863906db0d548b5bfe5f352b86f0218b9d36bbce1f1ef

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.aar.md5

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

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.aar.sha1

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

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.aar.sha256

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

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.aar.sha512

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

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.pom.md5

@@ -1 +0,0 @@
-9ccc32612fad441bf3f312e701818c11

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.pom.sha1

@@ -1 +0,0 @@
-ba4c524ab26d96b548bb32a6bfe64ecb85fd07dd

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.pom.sha256

@@ -1 +0,0 @@
-f97b8cda1d0ea446e149e8981eb8d2be57e5bc342f73363dfeeca01ab1e1a354

package/Detox-android/com/wix/detox-legacy/20.26.3-smoke.0/detox-legacy-20.26.3-smoke.0.pom.sha512

@@ -1 +0,0 @@
-e9ae21b7bb4ea61356dd029c74e87a27513114889cd937bad8ae374211f3850425a821994c68b7db345c9de81bc955f50c6b2d245bacd007e1ae40a29ca2f816

package/src/copilot/CopilotDriver.js

@@ -1,140 +0,0 @@
-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;