detox 20.34.5 → 20.35.1

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

@@ -0,0 +1 @@
+e3226500b003cc27b7f4bc0bc8243bc5

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

@@ -0,0 +1 @@
+d642fd124d246aba966e01eeede0913ad73c12ca

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

@@ -0,0 +1 @@
+9068b93dce4da1d43316cf688a92538c478f29662bdd25da202c924bc77ccc30

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

@@ -0,0 +1 @@
+d83a8916edbb21d0e1a979fbdc2b46c6099b4810b73ccf3384c8c7a0f9cd41670695657a52d21114d6d66209b793c769d57bf0640f45df0ca2524c3e499791a2

package/Detox-android/com/wix/detox/{20.34.5/detox-20.34.5.pom → 20.35.1/detox-20.35.1.pom}

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
-  <version>20.34.5</version>
+  <version>20.35.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.35.1/detox-20.35.1.pom.md5

@@ -0,0 +1 @@
+8dd88226651075c2d0e5060455f8ceeb

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

@@ -0,0 +1 @@
+da5df4bc14940dd8abecc10b5ed55995d7363ecb

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

@@ -0,0 +1 @@
+954cd12e5219568664424f1bff533636278ba644370c850f8b9fa19a418d26cd

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

@@ -0,0 +1 @@
+704632d25f72b81388b3606ba5b98b75fe107ec4096f8f1a1f0ca94fb982a45545d206a330b51013182d7a1c7ed5c3cc185b00cc16caadf28abc0677f8a72d4d

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

@@ -3,11 +3,11 @@
   <groupId>com.wix</groupId>
   <artifactId>detox</artifactId>
   <versioning>
-    <latest>20.34.5</latest>
-    <release>20.34.5</release>
+    <latest>20.35.1</latest>
+    <release>20.35.1</release>
     <versions>
-      <version>20.34.5</version>
+      <version>20.35.1</version>
     </versions>
-    <lastUpdated>20250311134145</lastUpdated>
+    <lastUpdated>20250323102355</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-124aa88e915e9b18fd8a733a6b941d15
+2410bf1198dd0b83c799471e210f0734

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

@@ -1 +1 @@
-9049aefa5e582d75a4f797598a69c570698aa159
+8f5b95d484a8bfc4160e619dc92463ac18de6ba9

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

@@ -1 +1 @@
-ac5eced7982a7c3f738b02c2431dadc151c7c34ca8bc5ad543fb8ab44133501a
+ddcad5d44a4f583e715d4888d2262567d269ac93f060d5f07362852f412ea8bf

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

@@ -1 +1 @@
-a11b2a21800e4ea7748f5cb337929eba7c3e1070057306ea31821d6f18c256522c46262370f85f07d5e098d6bd4eb4f2c5ac23c0752c06f53a891f0cd6e9cdc4
+81f718f2022c141466e5794af41292d33156eab610bcc68d16fc12a5b80a29f97090f5519b3113be79f6ed8d32d7c2fdb24db71b5404aa904dffd102495181da

package/detox.d.ts

@@ -9,7 +9,7 @@
 // * Dor Ben Baruch <https://github.com/Dor256>
 
 import { BunyanDebugStreamOptions } from 'bunyan-debug-stream';
-import { CopilotFacade, PromptHandler } from "detox-copilot";
+import type { Pilot, PromptHandler as _PromptHandler } from '@wix-pilot/core'
 
 declare global {
     namespace Detox {
@@ -446,7 +446,13 @@ declare global {
 
             readonly system: SystemFacade;
 
-            readonly copilot: DetoxCopilotFacade;
+            readonly pilot: PilotFacade;
+
+          /**
+           * @deprecated This API is deprecated and will be removed in the next major version.
+           * Please use `pilot` instead of `pilot`.
+           */
+            readonly copilot: PilotFacade;
 
             readonly DetoxConstants: {
                 userNotificationTriggers: {
@@ -1329,17 +1335,17 @@ declare global {
             element(systemMatcher: SystemMatcher): IndexableSystemElement;
         }
 
-        interface DetoxCopilotFacade extends Pick<CopilotFacade, "perform"> {
+        interface PilotFacade extends Pick<Pilot, "perform" | "autopilot" | "extendAPICatalog"> {
             /**
-             * 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.
+             * Initializes the Pilot with the given prompt handler.
+             * Must be called before any other Pilot methods.
+             * @note Wix-Pilot 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;
+            init: (promptHandler: PromptHandler) => void;
         }
 
-        interface DetoxCopilotPromptHandler extends PromptHandler {}
+        type PromptHandler = _PromptHandler;
 
         interface IndexableSystemElement extends SystemElement {
             /**

package/globals.d.ts

@@ -10,6 +10,7 @@ declare global {
   const web: Detox.DetoxExportWrapper['web'];
   const system: Detox.DetoxExportWrapper['system'];
   const copilot: Detox.DetoxExportWrapper['copilot'];
+  const pilot: Detox.DetoxExportWrapper['pilot'];
 
   namespace NodeJS {
     interface Global {
@@ -22,6 +23,7 @@ declare global {
       web: Detox.DetoxExportWrapper['web'];
       system: Detox.DetoxExportWrapper['system'];
       copilot: Detox.DetoxExportWrapper['copilot'];
+      pilot: Detox.DetoxExportWrapper['pilot'];
     }
   }
 }

package/jest.config.js

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.34.5",
+  "version": "20.35.1",
   "bin": {
     "detox": "local-cli/cli.js"
   },
@@ -68,12 +68,13 @@
     "wtfnode": "^0.9.1"
   },
   "dependencies": {
+    "@wix-pilot/core": "^3.1.4",
+    "@wix-pilot/detox": "^1.0.8",
     "ajv": "^8.6.3",
     "bunyan": "^1.8.12",
     "bunyan-debug-stream": "^3.1.0",
     "caf": "^15.0.1",
     "chalk": "^4.0.0",
-    "detox-copilot": "^0.0.27",
     "execa": "^5.1.1",
     "find-up": "^5.0.0",
     "fs-extra": "^11.0.0",
@@ -119,5 +120,5 @@
   "browserslist": [
     "node 14"
   ],
-  "gitHead": "3ad6fc5da870368e43d5b09b72c4d844b8342ace"
+  "gitHead": "ac0a00f69943dff669c1fb67b8b740292d7a4a7b"
 }

package/src/DetoxWorker.js

@@ -1,12 +1,11 @@
 const CAF = require('caf');
-const copilot = require('detox-copilot').default;
 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');
+const DetoxPilot = require('./pilot/DetoxPilot');
 const symbols = require('./realms/symbols');
 const AsyncEmitter = require('./utils/AsyncEmitter');
 const uuid = require('./utils/uuid');
@@ -62,8 +61,8 @@ class DetoxWorker {
     this.web = null;
     /** @type {Detox.SystemFacade} */
     this.system = null;
-    /** @type {Detox.DetoxCopilotFacade} */
-    this.copilot = new DetoxCopilot();
+    /** @type {Detox.PilotFacade} */
+    this.pilot = null;
 
     this._deviceCookie = null;
 
@@ -103,7 +102,6 @@ class DetoxWorker {
     // @ts-ignore
     this._sessionConfig.sessionId = sessionConfig.sessionId || uuid.UUID();
     this._runtimeErrorComposer.appsConfig = this._appsConfig;
-
     this._client = new Client(sessionConfig);
     this._client.terminateApp = async () => {
       // @ts-ignore
@@ -111,6 +109,7 @@ class DetoxWorker {
         await this.device.terminateApp();
       }
     };
+    this.pilot = new DetoxPilot();
 
     yield this._client.connect();
 
@@ -163,12 +162,19 @@ class DetoxWorker {
       const injectedGlobals = {
         ...matchers,
         device: this.device,
-        copilot: this.copilot,
+        pilot: this.pilot,
         detox: this,
       };
 
       this._injectedGlobalProperties = Object.keys(injectedGlobals);
       Object.assign(DetoxWorker.global, injectedGlobals);
+      Object.defineProperty(DetoxWorker.global, 'copilot', {
+        get: () => {
+          console.warn('Warning: "copilot" is deprecated. Please use "pilot" instead.');
+          return this.pilot;
+        },
+        configurable: true,
+      });
     }
 
     // @ts-ignore
@@ -226,8 +232,8 @@ class DetoxWorker {
   };
 
   onTestStart = function* (_signal, testSummary){
-    if (copilot.isInitialized()) {
-      copilot.start();
+    if (this.pilot.isInitialized()) {
+      this.pilot.start();
     }
 
     this._validateTestSummary('beforeEach', testSummary);
@@ -258,8 +264,8 @@ class DetoxWorker {
       testName: testSummary.fullName,
     });
 
-    if (copilot.isInitialized()) {
-      copilot.end(testSummary.status !== 'passed');
+    if (this.pilot.isInitialized()) {
+      this.pilot.end(testSummary.status === 'passed');
     }
   };
 

package/src/pilot/DetoxPilot.js

@@ -0,0 +1,49 @@
+const { Pilot } = require('@wix-pilot/core');
+const { DetoxFrameworkDriver }  = require('@wix-pilot/detox');
+
+const detox = require('../..');
+
+/** @type {Detox.PilotFacade} */
+class DetoxPilot {
+  init(promptHandler) {
+     this.pilot = new Pilot({
+      frameworkDriver: new DetoxFrameworkDriver(detox),
+      promptHandler: promptHandler
+    });
+  }
+
+  start(){
+    if (!this.isInitialized()) {
+      throw new Error('DetoxPilot is not initialized');
+    }
+    return this.pilot.start();
+  }
+
+  perform(...steps){
+    if (!this.isInitialized()) {
+      throw new Error('DetoxPilot is not initialized');
+    }
+    return this.pilot.perform(...steps);
+  }
+
+  autopilot(goal) {
+    return this.pilot.autopilot(goal);
+  }
+
+  extendAPICatalog(categories, context) {
+    return this.pilot.extendAPICatalog(categories, context);
+  }
+
+  end(shouldSaveInCache){
+    if(!this.isInitialized()){
+      throw new Error('DetoxPilot is not initialized');
+    }
+    return this.pilot.end(shouldSaveInCache);
+  }
+
+  isInitialized(){
+    return !!this.pilot;
+  }
+}
+
+module.exports = DetoxPilot;

package/src/realms/DetoxContext.js

@@ -83,6 +83,8 @@ class DetoxContext {
 
   system = funpermaproxy.callable(() => this[symbols.worker].system);
 
+  pilot = funpermaproxy.callable(() => this[symbols.worker].pilot);
+
   copilot = funpermaproxy.callable(() => this[symbols.worker].copilot);
 
   get DetoxConstants() {

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

@@ -1 +0,0 @@
-bd14839975954a26f5a5de90ea5db58d

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

@@ -1 +0,0 @@
-4a95b5deea127463d33a0082724efa15c0219b7b

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

@@ -1 +0,0 @@
-334fcb0435039628b166d5d24a9bc16d548458acdbace630b63a64f8e8392cf5

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

@@ -1 +0,0 @@
-7e465d127ecc42d3dd2f3965cccecbf9925daaca5f1aef7e91004d14fa3b6ab0e7853fa7343b75123c75b6a803734f8ca5ac9d7441e1c69e310aa76637d3f3fd

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

@@ -1 +0,0 @@
-a21b9bbeda17018156da809bbd4ad378

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

@@ -1 +0,0 @@
-e6fd98f4bd1aa47112a571668f6848d2c3c242bd

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

@@ -1 +0,0 @@
-6e9772775917f0c4dfb8b7da2399efd534c54bbfd83c356bcf8b888936b73bed

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

@@ -1 +0,0 @@
-b850844b3cacf4524dba60a84d81dbc2630bc028b29aa3a22822ae79986ec47879e9f32ad3492b13a5a86943a388854f0b3f437985d33a730f2fc5418fe021bc

package/src/copilot/DetoxCopilot.js

@@ -1,21 +0,0 @@
-const copilot = require('detox-copilot').default;
-
-const detoxCopilotFrameworkDriver = require('./detoxCopilotFrameworkDriver');
-
-/**
- * @typedef {Object} Detox.DetoxCopilotFacade
- */
-class DetoxCopilot {
-  init(promptHandler) {
-    copilot.init({
-      frameworkDriver: detoxCopilotFrameworkDriver,
-      promptHandler: promptHandler
-    });
-  }
-
-  perform(...steps) {
-    return copilot.perform(...steps);
-  }
-}
-
-module.exports = DetoxCopilot;

package/src/copilot/detoxCopilotFrameworkDriver.js

@@ -1,703 +0,0 @@
-// 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: ['Use test IDs (accessibility identifiers) to uniquely identify elements. This is the best-practice matcher.'],
-          },
-          {
-            signature: 'by.text(text: string)',
-            description: 'Matches elements by their text (value).',
-            example: "element(by.text('Login'))",
-            guidelines: ['Prefer test IDs over text matchers when possible.'],
-          },
-          {
-            signature: 'by.type(type: string)',
-            description: 'Matches elements by their type.',
-            example: "element(by.type('RCTTextInput'))",
-            guidelines: ['Use type matchers as a last resort.'],
-          },
-          {
-            signature: 'atIndex(index: number)',
-            description: 'Selects the element at the specified index from matched elements.',
-            example: "element(by.id('listItem')).atIndex(2)",
-            guidelines: ['Use when multiple elements match the same matcher.'],
-          },
-          {
-            signature: 'by.label(label: string)',
-            description: 'Match elements with the specified label.',
-            example: "element(by.label('Tuesday, 1 October'));",
-            guidelines: ['Use when there are no other identifiers, such as for date pickers to select specific days.'],
-          },
-        ],
-      },
-      {
-        title: 'Actions',
-        items: [
-          {
-            signature: 'tap(point?: Point2D)',
-            description: 'Simulates tap on an element.',
-            example: "await element(by.id('loginButton')).tap();",
-          },
-          {
-            signature: 'longPress(point?: Point2D, duration?: number)',
-            description: 'Simulates long press on an element.',
-            example: "await element(by.id('menuItem')).longPress();",
-            guidelines: ['Tapping on edges of elements might work better when adding a small offset to the point.'],
-          },
-          {
-            signature: 'multiTap(times: number)',
-            description: 'Simulates multiple taps on an element.',
-            example: "await element(by.id('tappable')).multiTap(3);",
-          },
-          {
-            signature: 'typeText(text: string)',
-            description: 'Types text into a text field.',
-            example: "await element(by.id('usernameInput')).typeText('myusername');",
-            guidelines: ['Element must be a text input field.'],
-          },
-          {
-            signature: 'replaceText(text: string)',
-            description: 'Replaces text in a text field.',
-            example: "await element(by.id('textField')).replaceText('new text');",
-          },
-          {
-            signature: 'clearText()',
-            description: 'Clears text from a text field.',
-            example: "await element(by.id('textField')).clearText();",
-          },
-          {
-            signature: 'tapReturnKey()',
-            description: 'Simulates tapping the return key on the keyboard while the element is focused.',
-            example: "await element(by.id('textField')).tapReturnKey();",
-          },
-          {
-            signature: 'tapBackspaceKey()',
-            description: 'Simulates tapping the backspace key on the keyboard while the element is focused.',
-            example: "await element(by.id('textField')).tapBackspaceKey();",
-          },
-          {
-            signature: 'adjustSliderToPosition(normalizedPosition: number)',
-            description: 'Adjusts slider to a normalized position between 0 and 1.',
-            example: "await element(by.id('slider')).adjustSliderToPosition(0.75);",
-          },
-          {
-            signature: 'scroll(offset: number, direction: string, startPositionX?: number, startPositionY?: number)',
-            description: 'Scrolls an element by an offset in a direction.',
-            example: "await element(by.id('scrollView')).scroll(100, 'down');",
-            guidelines: [
-              'Direction can be "up", "down", "left", or "right".',
-              'Use `startPositionX` and `startPositionY` to specify the starting point of the scroll gesture.',
-              '`startPositionX` and `startPositionY` are relative to the element\'s width and height, respectively. with values between 0 and 1.',
-              'If multiple scroll actions are needed while waiting for an element, use `whileElement()` in conjunction with `waitFor()`.',
-            ],
-          },
-          {
-            signature: 'scrollTo(edge: string, startPositionX?: number, startPositionY?: number)',
-            description: 'Scrolls to an edge of the element.',
-            example: "await element(by.id('scrollView')).scrollTo('bottom');",
-            guidelines: [
-              'Edge can be "top", "bottom", "left", or "right".',
-              'Use `startPositionX` and `startPositionY` to specify the starting point of the scroll gesture.',
-              '`startPositionX` and `startPositionY` are relative to the element\'s width and height, respectively. with values between 0 and 1.',
-            ],
-          },
-          {
-            signature: 'waitFor(element: Matcher).toBeVisible(percent?: number).whileElement(element: Matcher).scroll(offset: number, direction: string)',
-            description: 'Continuously performs an action while waiting for an expectation to be fulfilled.',
-            example: `
-await waitFor(element(by.text('Load More')))
-  .toBeVisible()
-  .whileElement(by.id('scrollView'))
-  .scroll(50, 'down');`,
-            guidelines: [
-              'Used in conjunction with `waitFor()` to perform actions like scrolling while waiting for an element to meet the expectation.',
-              'The action (e.g., `scroll`) is performed on the element specified in `whileElement()`.',
-            ],
-          },
-          {
-            signature: 'scrollToIndex(index: number)',
-            description: 'Scrolls to the specified index (Android only).',
-            example: "await element(by.id('scrollView')).scrollToIndex(10);",
-          },
-          {
-            signature: 'swipe(direction: string, speed?: string, normalizedOffset?: number)',
-            description: 'Simulates a swipe gesture.',
-            example: "await element(by.id('scrollView')).swipe('up');",
-            guidelines: [
-              'Speed can be "fast" or "slow"; default is "fast".',
-              'Direction can be "up", "down", "left", or "right".',
-              'Up swipe scrolls down, left swipe scrolls right.',
-            ],
-          },
-          {
-            signature: 'setColumnToValue(column: number, value: string)',
-            description: 'Sets picker column to a value (iOS only).',
-            example: "await element(by.id('pickerView')).setColumnToValue(1, '6');",
-          },
-          {
-            signature: 'setDatePickerDate(dateString: string, dateFormat: string)',
-            description: 'Sets date picker to a specific date.',
-            example: "await element(by.id('datePicker')).setDatePickerDate('2023-05-25', 'yyyy-MM-dd');",
-          },
-          {
-            signature: 'performAccessibilityAction(actionName: string)',
-            description: 'Performs an accessibility action.',
-            example: "await element(by.id('scrollView')).performAccessibilityAction('activate');",
-          },
-          {
-            signature: 'pinch(scale: number, speed?: string, angle?: number)',
-            description: 'Simulates a pinch gesture.',
-            example: "await element(by.id('pinchableView')).pinch(1.1);",
-            guidelines: ['Scale >1 to zoom in, <1 to zoom out.'],
-          },
-          {
-            signature: 'getAttributes()',
-            description: 'Retrieves attributes of the element.',
-            example: `
-const attributes = await element(by.text('Tap Me')).getAttributes();
-jestExpect(attributes.text).toBe('Tap Me');`,
-          },
-          {
-            signature: 'takeScreenshot(name: string)',
-            description: 'Captures a screenshot of the element.',
-            example: "const imagePath = await element(by.id('menuRoot')).takeScreenshot('menu_screenshot');",
-          },
-          {
-            signature: 'longPressAndDrag(duration, normalizedPositionX, normalizedPositionY, targetElement, normalizedTargetPositionX, normalizedTargetPositionY, speed, holdDuration)',
-            description: `Performs a long press and drags to a target element.
-  - \`duration\` — the duration to press for, in ms (required)
-  - \`normalizedPositionX\` — X coordinate of the starting point, relative to the element width (required, a number between 0.0 and 1.0, NaN — choose an optimal value automatically)
-  - \`normalizedPositionY\` — Y coordinate of the starting point, relative to the element height (required, a number between 0.0 and 1.0, NaN — choose an optimal value automatically)
-  - \`targetElement\` — the target element to drag to (required)
-  - \`normalizedTargetPositionX\` — X coordinate of the ending point, relative to the target element width (optional, a number between 0.0 and 1.0, NaN — choose an optimal value automatically)
-  - \`normalizedTargetPositionY\` — Y coordinate of the ending point, relative to the target element height (optional, a number between 0.0 and 1.0, NaN — choose an optimal value automatically)
-  - \`speed\` — the speed of the drag (optional, valid input: "fast"/"slow" , default is "fast")
-  - \`holdDuration\` — the duration before releasing at the end, in ms (optional, default is 1000)`,
-            example: "await element(by.id('cellId_1')).longPressAndDrag(2000, 0.9, NaN, element(by.id('cellId_6')), 0.9, NaN, 'slow', 0);",
-          },
-        ],
-      },
-      {
-        title: 'Assertions',
-        items: [
-          {
-            signature: 'toBeVisible(percent?: number)',
-            description: 'Asserts that the element is visible with at-least the specified percentage. Default percent is 75%.',
-            example: "await expect(element(by.id('loginButton'))).toBeVisible(38);",
-            guidelines: [
-              'Use the default visibility percent unless a different percentage is required.',
-              'If a percentage value is provided, use the exact percentage required for the test.',
-            ],
-          },
-          {
-            signature: 'toExist()',
-            description: 'Asserts that the element exists.',
-            example: "await expect(element(by.id('username'))).toExist();",
-          },
-          {
-            signature: 'toHaveText(text: string)',
-            description: 'Asserts that the element has the specified text.',
-            example: "await expect(element(by.id('label'))).toHaveText('Hello, World!');",
-          },
-          {
-            signature: 'toHaveValue(value: string)',
-            description: 'Asserts that the element has the specified value.',
-            example: "await expect(element(by.id('slider'))).toHaveValue('0.5');",
-          },
-          {
-            signature: 'toBeFocused()',
-            description: 'Asserts that the element is focused.',
-            example: "await expect(element(by.id('emailInput'))).toBeFocused();",
-          },
-          {
-            signature: 'toHaveLabel(label: string)',
-            description: 'Asserts that the element has the specified accessibility label.',
-            example: "await expect(element(by.id('submitButton'))).toHaveLabel('Submit');",
-          },
-          {
-            signature: 'toHaveId(id: string)',
-            description: 'Asserts that the element has the specified accessibility identifier.',
-            example: "await expect(element(by.text('Submit'))).toHaveId('submitButton');",
-          },
-          {
-            signature: 'toHaveSliderPosition(normalizedPosition: number, tolerance?: number)',
-            description: 'Asserts that the slider is at a normalized position.',
-            example: "await expect(element(by.id('slider'))).toHaveSliderPosition(0.75);",
-          },
-          {
-            signature: 'toHaveToggleValue(value: boolean)',
-            description: 'Asserts that a toggle element is on or off.',
-            example: "await expect(element(by.id('switch'))).toHaveToggleValue(true);",
-          },
-          {
-            signature: 'withTimeout(timeout: number)',
-            description: 'Waits until the expectation is resolved or timeout occurs.',
-            example: "await waitFor(element(by.id('bigButton'))).toBeVisible().withTimeout(2000);",
-          },
-          {
-            signature: 'not',
-            description: 'Negates the expectation.',
-            example: "await expect(element(by.id('tinyButton'))).not.toBeVisible();",
-          },
-        ],
-      },
-      {
-        title: 'Utilities',
-        items: [
-          {
-            signature: 'jestExpect',
-            description: 'Jest expect utility for additional assertions.',
-            example: `
-jestExpect(2 + 2).toBe(4);
-jestExpect('hello').toBe('hello');`,
-          },
-        ],
-      },
-      {
-        title: 'Device APIs',
-        items: [
-          {
-            signature: 'device.launchApp(params?: object)',
-            description: `
-Launches the app with specified parameters.
-
-**Parameters:**
-- \`newInstance\` (boolean): If \`true\`, terminates the app and launches a new instance.
-- \`delete\` (boolean): If \`true\`, deletes the app data before launching.
-- \`launchArgs\` (object): Additional launch arguments as key-value pairs.
-- \`url\` (string): URL to open in the app.
-- \`permissions\` (object): Permissions to grant the app. Supported permissions are:
-| Permission      | Values                     |
-|-----------------|----------------------------|
-| **location**    | always / inuse / never / unset |
-| **contacts**    | YES / NO / unset / limited     |
-| **photos**      | YES / NO / unset / limited     |
-| **calendar**    | YES / NO / unset               |
-| **camera**      | YES / NO / unset               |
-| **medialibrary**| YES / NO / unset               |
-| **microphone**  | YES / NO / unset               |
-| **motion**      | YES / NO / unset               |
-| **reminders**   | YES / NO / unset               |
-| **siri**        | YES / NO / unset               |
-| **notifications**| YES / NO / unset              |
-| **health**      | YES / NO / unset               |
-| **homekit**     | YES / NO / unset               |
-| **speech**      | YES / NO / unset               |
-| **faceid**      | YES / NO / unset               |
-| **userTracking**| YES / NO / unset               |
-`,
-            example: `
-await device.launchApp({ newInstance: true });
-await device.launchApp({ newInstance: true, permissions: { notifications: 'YES' } });
-await device.launchApp({ launchArgs: { someLaunchArg: 1234 } });`,
-            guidelines: ['Use minimal parameters necessary for your launch scenario.'],
-          },
-          {
-            signature: 'device.reloadReactNative()',
-            description: 'Reloads the React Native JS bundle.',
-            example: 'await device.reloadReactNative();',
-          },
-          {
-            signature: 'device.setOrientation(orientation: string)',
-            description: 'Rotates the device to the specified orientation.',
-            example: 'await device.setOrientation("landscape");',
-            guidelines: ['Orientation can be "portrait" or "landscape".'],
-          },
-          {
-            signature: 'device.setLocation(lat: number, lon: number)',
-            description: 'Sets the device location.',
-            example: 'await device.setLocation(37.7749, -122.4194);',
-          },
-          {
-            signature: 'device.takeScreenshot(name?: string)',
-            description: 'Captures a screenshot of the device.',
-            example: 'const path = await device.takeScreenshot("home_screen");',
-          },
-          {
-            signature: 'device.getPlatform()',
-            description: 'Returns the current device platform ("ios" or "android").',
-            example: 'const platform = device.getPlatform();',
-            guidelines: ['Use to conditionally execute platform-specific code.'],
-          },
-          {
-            signature: 'device.openURL(url: string)',
-            description: 'Opens a deeplink within the app, or a URL in the browser.',
-            example: 'await device.openURL("app://home");',
-          }
-        ],
-      },
-      {
-        title: 'System APIs (iOS)',
-        items: [
-          {
-            signature: 'system.element(matcher: Matcher)',
-            description: 'Selects an element within the system UI.',
-            example: "system.element(by.system.label('Allow')).tap();",
-            guidelines: [
-              'Can be used for iOS system alerts and permissions dialogs',
-              'Always use `system.element()` to interact with system dialog elements (alerts, permission requests).',
-              'Check the platform with `device.getPlatform()` before using, as it is iOS-specific',
-              'Permission alerts are part of the system UI, not the app UI. Therefore should be matched with `system.element()`.',
-              'System dialogs are not part of the app, so they won\'t be found in the app\'s view hierarchy. Identify the relevant system element from the snapshot.',
-            ]
-          },
-          {
-            signature: 'by.system.label(label: string)',
-            description: 'Matches system elements by their label (text).',
-            example: "system.element(by.system.label('Dismiss'));",
-            guidelines: [
-              'System elements will not be found in the app\'s view hierarchy. Read the text from the snapshot.',
-              'If no system dialog can be found, throw an error with the relevant message.',
-            ],
-          },
-          {
-            signature: 'by.system.type(type: string)',
-            description: 'Matches system elements by type.',
-            example: "system.element(by.system.type('button'));",
-          },
-          {
-            signature: 'tap()',
-            description: 'Taps on a system element.',
-            example: "system.element(by.system.label('Allow')).tap();",
-          },
-          {
-            signature: 'toExist()',
-            description: 'Asserts that the system element exists.',
-            example: "await expect(system.element(by.system.label('Allow'))).toExist();",
-          },
-          {
-            signature: 'not',
-            description: 'Negates the expectation for system elements.',
-            example: "await expect(system.element(by.system.label('Allow'))).not.toExist();",
-          },
-        ],
-      },
-      {
-        title: 'Web APIs',
-        items: [
-          {
-            signature: 'web.element(matcher: Matcher)',
-            description: 'Selects an element within a web view (`WKWebView` or `RNCWebView`). Use when there is only one web view on the screen.',
-            example: `
-await web.element(by.web.id('email')).typeText('test@example.com');
-await web.element(by.web.id('password')).typeText('password123');
-await web.element(by.web.id('login-button')).tap();
-            `,
-            guidelines: [
-              'The web view may take time to load; add a delay using `await new Promise(resolve => setTimeout(resolve, milliseconds));` before the first interaction. This wait should happen only once.',
-              'After the initial wait, you can interact with web elements without additional delays.',
-              'Use `by.web.id` matcher when possible for matching web elements, as it is the most reliable.',
-              'Web APIs can only be used with web elements (within web views). Do not use web APIs for native elements or native APIs for web elements!',
-              'Confirm that you are targeting a web view before using this method.'
-            ],
-          },
-          {
-            signature: 'web(nativeMatcher: NativeMatcher).element(matcher: Matcher)',
-            description: 'Selects an element within a specific web view (`WKWebView` or `RNCWebView`) matched by a native matcher. Use when there are multiple web views on the screen.',
-            example: `
-// Wait for the specific web view to appear and load (only once before interacting)
-await expect(element(by.id('checkout-webview'))).toBeVisible();
-
-// Interact with elements within a specific web view
-const specificWebView = web(by.id('checkout-webview'));
-
-await specificWebView.element(by.web.id('credit-card-number')).typeText('4111111111111111');
-await specificWebView.element(by.web.id('expiration-date')).typeText('12/25');
-await specificWebView.element(by.web.id('cvv')).typeText('123');
-await specificWebView.element(by.web.id('pay-button')).tap();
-            `,
-            guidelines: [
-              'Use this method when multiple web views are present.',
-              'Ensure the web view is visible and its content is loaded before interacting. This wait should happen only once.',
-              'After the initial wait, you can interact with elements within the web view without additional delays.',
-              'Webview must be matched with `web(nativeMatcher)` (e.g., `web(by.id(..))` instead of `element(by.id(..))`).',
-              'Prefer the basic `web.element()` if only one web view is present on the screen.',
-              'Confirm that you are targeting a web view before using this method.'
-            ],
-          },
-          {
-            signature: 'web(nativeMatcher: NativeMatcher).atIndex(index: number).element(matcher: Matcher)',
-            description: 'Selects an element within a specific web view at a given index (iOS only).',
-            example: `
-// Interact with an element within the second web view (index starts from 0)
-const secondWebView = web(by.id('webview')).atIndex(1);
-await secondWebView.element(by.web.id('search-input')).typeText('Detox Testing');
-await secondWebView.element(by.web.id('search-button')).tap();
-            `,
-            guidelines: [
-              'Use when multiple web views with the same identifier are present on iOS.',
-              'This method is available for iOS only.',
-              'Check the platform with `device.getPlatform()` before using.',
-            ],
-          },
-          {
-            signature: 'by.web.id(id: string)',
-            description: 'Matches web elements by their "id" attribute.',
-            example: `await web.element(by.web.id('search')).tap();`,
-            guidelines: [
-              'Prefer `by.web.id` over any other matchers when available.',
-            ],
-          },
-          {
-            signature: 'by.web.className(className: string)',
-            description: 'Matches web elements by their CSS class name.',
-            example: `await web.element(by.web.className('btn-login')).tap();`,
-          },
-          {
-            signature: 'by.web.cssSelector(cssSelector: string)',
-            description: 'Matches web elements using a CSS selector.',
-            example: `await web.element(by.web.cssSelector('#product-list .product-item[data-id="123"]')).scrollToView();`,
-          },
-          {
-            signature: 'by.web.name(name: string)',
-            description: 'Matches web elements by their name attribute.',
-            example: `await web.element(by.web.name('firstName')).typeText('John');`,
-          },
-          {
-            signature: 'by.web.xpath(xpath: string)',
-            description: 'Matches web elements using an XPath expression.',
-            example: `await web.element(by.web.xpath('//button[text()="Continue"]')).tap();`,
-          },
-          {
-            signature: 'by.web.href(href: string)',
-            description: 'Matches web elements by their href attribute.',
-            example: `await web.element(by.web.href('https://www.example.com/contact')).tap();`,
-          },
-          {
-            signature: 'by.web.hrefContains(href: string)',
-            description: 'Matches web elements whose href attribute contains the specified string.',
-            example: `await web.element(by.web.hrefContains('/about')).tap();`,
-          },
-          {
-            signature: 'by.web.tag(tag: string)',
-            description: 'Matches web elements by their tag name.',
-            example: `await expect(web.element(by.web.tag('h1'))).toHaveText('Welcome to Our Site');`,
-          },
-          {
-            signature: 'by.web.value(value: string)',
-            description: 'Matches web elements by their value attribute (iOS only).',
-            example: `await web.element(by.web.value('Sign In')).tap();`,
-            guidelines: [
-              'Available on iOS only.',
-            ],
-          },
-          {
-            signature: 'by.web.label(label: string)',
-            description: 'Matches web elements by their label (iOS only, supports `asSecured()`).',
-            example: `await web.element(by.web.label('Next')).tap();`,
-            guidelines: [
-              'Available on iOS only.',
-              'Use when the inner web element has a unique label or aria-label.',
-              'Can be used to match buttons and input elements inside a web view, by their inner text content.',
-            ],
-          },
-          {
-            signature: 'by.web.type(accessibilityType: string)',
-            description: 'Matches web elements by accessibility type (iOS only, `asSecured()` only).',
-            example: `await web.element(by.web.type('textField')).asSecured().typeText('Sample Text');`,
-            guidelines: [
-              'Available on iOS only and used with `asSecured()`.',
-              'Type can be any XCUIElement.ElementType, e.g., "button", "textField".',
-            ],
-          },
-          {
-            signature: 'atIndex(index: number)',
-            description: 'Selects the web element at the specified index from matched elements.',
-            example: `await expect(web.element(by.web.tag('h2')).atIndex(1)).toHaveText('Features');`,
-            guidelines: [
-              'Use when multiple web elements match the same matcher.',
-            ],
-          },
-          {
-            signature: 'tap()',
-            description: 'Taps on a web element.',
-            example: `await web.element(by.web.label('Submit')).tap();`,
-            guidelines: [
-              'Supports `asSecured()` on iOS.',
-            ],
-          },
-          {
-            signature: 'typeText(text: string)',
-            description: 'Types text into a web element.',
-            example: `await web.element(by.web.id('rich-text-editor')).typeText('This is a test message');`,
-            guidelines: [
-              'Supports `asSecured()` on iOS.',
-            ],
-          },
-          {
-            signature: 'replaceText(text: string)',
-            description: 'Replaces text in a web element.',
-            example: `await web.element(by.web.id('username')).replaceText('new_user');`,
-            guidelines: [
-              'Supports `asSecured()` on iOS.',
-            ],
-          },
-          {
-            signature: 'clearText()',
-            description: 'Clears text from a web element.',
-            example: `await web.element(by.web.id('comments')).clearText();`,
-            guidelines: [
-              'Supports `asSecured()` on iOS.',
-            ],
-          },
-          {
-            signature: 'selectAllText()',
-            description: 'Selects all text in a web element.',
-            example: `await web.element(by.web.id('notes')).selectAllText();`,
-          },
-          {
-            signature: 'getText()',
-            description: 'Retrieves the text content of a web element.',
-            example: `
-const description = await web.element(by.web.id('product-description')).getText();
-jestExpect(description).toContain('This product is made from the finest materials.');
-            `,
-            guidelines: [
-              'Use for assertions on the element\'s text content.',
-            ],
-          },
-          {
-            signature: 'scrollToView()',
-            description: 'Scrolls the web view to bring the element into view.',
-            example: `await web.element(by.web.id('contact-section')).scrollToView();`,
-          },
-          {
-            signature: 'focus()',
-            description: 'Focuses on a web element.',
-            example: `
-await web.element(by.web.id('email-input')).focus();
-await web.element(by.web.id('email-input')).typeText('user@example.com');
-            `,
-            guidelines: [
-              'Useful for input fields in a web view that require focus before typing.',
-              'No need for secured interactions on iOS.',
-            ]
-          },
-          {
-            signature: 'moveCursorToEnd()',
-            description: 'Moves the input cursor in a web view to the end of the element\'s content.',
-            example: `
-await web.element(by.web.id('message-box')).moveCursorToEnd();
-await web.element(by.web.id('message-box')).typeText(' Adding more text.');
-            `,
-          },
-          {
-            signature: 'runScript(script: string, args?: any[])',
-            description: 'Runs a JavaScript function on the web view element.',
-            example: `
-// Click an element using a custom script
-await web.element(by.web.id('hidden-button')).runScript('el => el.click()');
-
-// Set the value of an input field using a custom script
-await web.element(by.web.id('username')).runScript('(el, args) => el.value = args[0]', ['new_user']);
-
-// Get the color of an element
-const color = await web.element(by.web.id('header')).runScript(function(el) {
-  return window.getComputedStyle(el).color;
-});
-jestExpect(color).toBe('rgb(0, 0, 0)');
-
-// Scroll an element into view if not visible
-await web.element(by.web.id('lazy-image')).runScript('el => el.scrollIntoView()');
-            `,
-            guidelines: [
-              'The script can accept additional arguments and return a value.',
-              'Ensure that arguments and return values are serializable.',
-              'Useful for custom interactions or retrieving properties.',
-              'Avoid using this method for simple interactions like tapping or typing.',
-            ],
-          },
-          {
-            signature: 'getCurrentUrl()',
-            description: 'Retrieves the current URL of the web view.',
-            example: `
-await web.element(by.web.id('link-to-page')).tap();
-const currentUrl = await web.element(by.web.tag('body')).getCurrentUrl();
-jestExpect(currentUrl).toBe('https://www.example.com/target-page');
-            `,
-            guidelines: [
-              'Must be called from an inner element, not the root web view.',
-            ],
-          },
-          {
-            signature: 'getTitle()',
-            description: 'Retrieves the title of the web view.',
-            example: `
-const pageTitle = await web.element(by.web.tag('body')).getTitle();
-jestExpect(pageTitle).toBe('Dashboard - MyApp');
-            `,
-            guidelines: [
-              'Must be called from an inner element, not the root web view.',
-            ],
-          },
-          {
-            signature: 'toHaveText(text: string)',
-            description: 'Asserts that the web element has the specified text. Used with `expect()`.',
-            example: `await expect(web.element(by.web.name('submit-button'))).toHaveText('Submit');`,
-            guidelines: [
-              'For web views, the text is the inner text of the element, e.g., `<h1>Welcome to the webpage!</h1>`.',
-            ],
-          },
-          {
-            signature: 'toExist()',
-            description: 'Asserts that the web element exists. Used with `expect()`.',
-            example: `await expect(web.element(by.web.id('error-message'))).toExist();`,
-            guidelines: [
-              'Verifies the presence of a web element in the DOM.',
-              'Supports `asSecured()` on iOS.',
-            ],
-          },
-          {
-            signature: 'not',
-            description: 'Negates the expectation for web elements.',
-            example: `await expect(web.element(by.web.id('loading-spinner'))).not.toExist();`,
-            guidelines: [
-              'Use `not` to assert that an element should not be present.',
-              'Supports `asSecured()` on iOS.',
-            ],
-          },
-          {
-            signature: 'asSecured()',
-            description: 'Interacts with secured web views (iOS only).',
-            example: `await web.element(by.web.label('Confirm')).asSecured().tap();`,
-            guidelines: [
-              'Use for web pages with secured protocols when regular interactions fail.',
-              'Applicable on iOS only with specific APIs.',
-            ],
-          },
-        ],
-      },
-    ],
-  },
-
-  captureSnapshotImage: async function () {
-const fileName = `snapshot_${Date.now()}.png`;
-    try {
-      return await detox.device.takeScreenshot(fileName);
-    } catch (_error) {
-      return null;
-    }
-  },
-
-  captureViewHierarchyString: async function () {
-    try {
-      return detox.device.generateViewHierarchyXml();
-    } catch (_error) {
-      return 'Unavailable, app is probably not launched yet';
-    }
-  },
-};
-
-module.exports = detoxCopilotFrameworkDriver;