detox 20.26.2 → 20.27.0

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

@@ -0,0 +1 @@
+79e88d1742382204b44c103b700a3955

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

@@ -0,0 +1 @@
+00febe099b40a8cfbfe63256e7dfcbfdc2ef1e01

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

@@ -0,0 +1 @@
+624acc61a54549d741cadf827c87a952ea65f4d71342b21c0bc78e4dba8f0bab

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

@@ -0,0 +1 @@
+84a8966526c12615b67ddb97618cfba60275eab2dbc6babe2fa8828f681d6cdc838a2f43f5fe34e3190390d4aff46fa583b27c512ab0c7881d8e5e75f74428f8

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

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

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

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

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

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

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

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

package/Detox-android/com/wix/detox/{20.26.2/detox-20.26.2.pom → 20.27.0/detox-20.27.0.pom}

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

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

@@ -0,0 +1 @@
+5c6bf656a59d5647008990b67f1b4e81

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

@@ -0,0 +1 @@
+85d02ca3eda8e1ce5c153b48ac70b616f22463ba

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

@@ -0,0 +1 @@
+9c73feb5baf2a9735096e31d94461bbe307d0ba1d1f1d0f0f2648ecf5ab249e4

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

@@ -0,0 +1 @@
+ea0529ec2403df8b8067c11470980b0b6cde32394df212b2f0ce32cbf7df7c744b0a0c4af342362f5a8429b4cb177fd25035b2eb55f887d5e7148d579a23312d

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.26.2</latest>
-    <release>20.26.2</release>
+    <latest>20.27.0</latest>
+    <release>20.27.0</release>
     <versions>
-      <version>20.26.2</version>
+      <version>20.27.0</version>
     </versions>
-    <lastUpdated>20240905213155</lastUpdated>
+    <lastUpdated>20240922114824</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-9e3e8a8d05fd018af3b4b1cecac85ceb
+166e0211e3c8ebd2b2b6605fb99d6a07

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

@@ -1 +1 @@
-49a5d3258b3a4b18d55c0c803f65e9c7bb470c8e
+d513122237af950d971097b9847eff9e6823c2d7

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

@@ -1 +1 @@
-f8b05715aaf9d675552325c062d5509e983560df36e2c0964bf858aac906be06
+086f6a6208ab027feb7a6cccc199bba56fc325e21f8ac890f16d2c8eaebfa385

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

@@ -1 +1 @@
-9f65c4a4e108884baa631feba8abcc34372ee88b3d194b4eb9f94c88162e262fd8a0ed62f4ec94162c3891ea6ca085ba737892d73709ac2ec3b32e1d1e22ae69
+75146105b8ffcd9f6c54ccecab07fe38ec76f37368521d6d3b4d7c1f82115a9b8d22a9377de901c860c411bc47a275225e312c5e1c6f13ae36a5ad39ac3bd1bb

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

@@ -0,0 +1 @@
+22d037b8bca358792d7de28a6a963bba

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

@@ -0,0 +1 @@
+d1b241b7df98a2c353cc824f73a659d0dc57a3e6

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

@@ -0,0 +1 @@
+50afa0349c83682fc243fae98cb13e6565a4e2124cdba82715d53892c96fae90

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

@@ -0,0 +1 @@
+0d774c88ba641c7d463f19ccbf61fcf47db714f2435bd1cecdf96ef7f772bd26513bf4a44b2e65c170b63978c5d8ec2026bd9c7461550176e544361b4591b9af

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

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

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

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

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

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

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

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

package/Detox-android/com/wix/detox-legacy/{20.26.2/detox-legacy-20.26.2.pom → 20.27.0/detox-legacy-20.27.0.pom}

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

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

@@ -0,0 +1 @@
+01a5760f91440cf467f45061196c119b

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

@@ -0,0 +1 @@
+7ed4037d9d36d59e2f3553f356f6a8493de47557

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

@@ -0,0 +1 @@
+adf8a669ed45ec95add12cdaa62aaa21b2f99cce73a7681e8ec0652614782f9c

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

@@ -0,0 +1 @@
+62aa84c10e18fa5db598cb5d88d197c09b4502648f946fe1ae18571e63a7292c8d48532d897fb866f9dd01ec261379bf2c5334fcdb56795f3df13dc3b3115b33

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

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

@@ -1 +1 @@
-7d1e75f8073d7e8507484042d83103e1
+63612a5f5bdbb48d5e1f3ff4e5cd200f

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

@@ -1 +1 @@
-f106fa7fa6ca0ecff78f8b6c7094118a0266de5a
+c52523453872dead27e35540c753721d94d9a9cd

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

@@ -1 +1 @@
-8d88d3608dc25dd1305f93cb629d308c3167f6e4ea232efbbc54f309288d5bba
+9158a9b035b7a341f654d02b939a8140531208e0b2814779156779c40390039a

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

@@ -1 +1 @@
-ce63462b86b96e3ee62a7817f56fb3f91d30801e93c41e0a9b8e8a0300a3bae285d17c1bd7a07054bc45557f9c1b16da338dcce8ef8197c7957088c327ea4b4d
+95157a82c725185c7ef2f908de02e89beebd86595763f7218596b7982dad2ad742900c52088e0b2276ddf108443e30a334a46e95e5f830fb699e566e5b3d29a7

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.2",
+  "version": "20.27.0",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -71,7 +71,7 @@
     "caf": "^15.0.1",
     "chalk": "^4.0.0",
     "child-process-promise": "^2.2.0",
-    "detox-copilot": "^0.0.0",
+    "detox-copilot": "^0.0.5",
     "execa": "^5.1.1",
     "find-up": "^5.0.0",
     "fs-extra": "^11.0.0",
@@ -116,5 +116,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "e0a1fefeeec0382b5dc75613a2076d0f6a05e97f"
+  "gitHead": "17d3f122836a7e5fe6861e2827ecb00556e69ff8"
 }

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.2/detox-20.26.2-sources.jar.md5

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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;