detox 20.27.1 → 20.27.3

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

@@ -0,0 +1 @@
+8cd2f48786d004ff90fcc48db9b9e69a

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

@@ -0,0 +1 @@
+4afea56e335fc27ee2b92be48673dea8a05185aa

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

@@ -0,0 +1 @@
+0568be3312760e3a3a4259cc771a7253074502547e8eb3350213cde9f8db6165

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

@@ -0,0 +1 @@
+2287316f0b862561456bef92c561598fcff17e286f17bc262470ef25cc6f71e84b16a8058e37f7f1536fc3a0433df990ba20173dd132b4c561c71e62a07e2fe6

package/Detox-android/com/wix/detox/{20.27.1/detox-20.27.1.pom → 20.27.3/detox-20.27.3.pom}

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

@@ -0,0 +1 @@
+2d7e0ca8745e2abb2087e946367c0538

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

@@ -0,0 +1 @@
+071d2ecd2ac499ecef2bff9c5b3f830c613709ca

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

@@ -0,0 +1 @@
+865a27d4ce918936ef0a629b2eb2c21dedc9e21629710732b2eb8ae9fd4374df

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

@@ -0,0 +1 @@
+58f3c7bc9e6bbc5885f03460545c4832bab2c29490afcbc003d5ee0acb3cf6975f0d890292d4ac587d73c986a42e1c67624617f6fee6da9163ccf76ee5d730ab

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

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

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

@@ -1 +1 @@
-b0663aafff90f42ece492a2bcaf7baec
+27e42826d06e4da1ec0844db0255a70c

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

@@ -1 +1 @@
-1001cbc58bbfa8763defd8cef091b50046364d02
+8a719a4551a0fde056e3f53cd841131fe908fc4d

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

@@ -1 +1 @@
-07d7f8da49dbf7ab284acb34967da94bb84c6cea2c8ee0898811a775ae7450fe
+ad19b8a5540aabca7a9ea07890509a1e9161848db2682d1c82274168fcf710ef

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

@@ -1 +1 @@
-2fb37d07f83c220fac552876664268022630f22a2b51cdb3392655832f3dd24bb712e0ebc2128dde7d72f3cd57599b80d0d021e86737ce69a28fab47bccb69a5
+b4fcc3ee40ae9bb22b6c97fd768a3b52281ca32229fd3fc50d8512b81ccec8cbbc3c94f03be1e843016fe97de37a5042938ba549e512894d6c08686ebf2d43c2

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

@@ -0,0 +1 @@
+b4efad81e134dacbb7d81b566aed6d89

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

@@ -0,0 +1 @@
+e994e4dad3f2dce5f5fde279bc6cd917ee6b2f07

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

@@ -0,0 +1 @@
+7e9153002e13fa5ffeef31eeda43b00e38bacbcba46640ce59fb42220a51c22a

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

@@ -0,0 +1 @@
+818984bbddf7bf9561bc6bc9e646cb2f89d5cd83c863aef37c5bf1a3911d08c6a4dc04b8251a85208c7ae308b11e6970a94d33fb2293dbd8bf3c6df6cd55d3ab

package/Detox-android/com/wix/detox-legacy/{20.27.1/detox-legacy-20.27.1.pom → 20.27.3/detox-legacy-20.27.3.pom}

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

@@ -0,0 +1 @@
+965972ea4b2739cb5d958a329b9bcc3d

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

@@ -0,0 +1 @@
+b6d5cfb02046495791ca031d12b9f2310f799a0e

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

@@ -0,0 +1 @@
+b27221155e7cfcfab8c62c949d47cd71967e19b243c001e53ac518e4cf900769

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

@@ -0,0 +1 @@
+d9c28fba54e53d5546f30c9b43326175f6ac8cf3194a8d0faea4d97b487198eb994f06249994c579b0f82f7ab0c7685689fe605887668dc2eaa5e659892e388a

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.27.1</latest>
-    <release>20.27.1</release>
+    <latest>20.27.3</latest>
+    <release>20.27.3</release>
     <versions>
-      <version>20.27.1</version>
+      <version>20.27.3</version>
     </versions>
-    <lastUpdated>20240923182941</lastUpdated>
+    <lastUpdated>20241009154624</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-fd1de26f13a6099dc0ea8653c61cd67d
+6ddea16ac39ebcaa72590d9b50ca41a1

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

@@ -1 +1 @@
-ec4629f0d73e338d6ed23b0cad15f2e54b7ade64
+1ad379b7c3de738b8adebc19d859742fdbf6797a

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

@@ -1 +1 @@
-84679287bb5c654b7ca9f5c860712d5d327f17670b89dfae4df2e686ee142899
+61f5bf7772111546173237486ddc5909ee6bc7053595adc3305c0ccfeb927736

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

@@ -1 +1 @@
-1d231b1ce95ce6608a20498393cfc9c005598bcbe78da9c3595679e315b83a0c41bc93b54be0632a5183a8e233ebe758f1a1fa5d233c5e9b1f532b24e5ce9c7f
+03e8049bdb4784b4c54b25e9a14b30012ee6212ae6b7329d61ea357ed97f485d1e88a8f2e0d573046020c07fd7681ac9cd84189d195598b867401ef83e97b1e9

package/package.json

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

package/src/DetoxWorker.js

@@ -59,6 +59,8 @@ class DetoxWorker {
     this.by = null;
     /** @type {Detox.WebFacade} */
     this.web = null;
+    /** @type {Detox.SystemFacade} */
+    this.system = null;
     /** @type {Detox.DetoxCopilotFacade} */
     this.copilot = null;
 

package/src/copilot/DetoxCopilot.js

@@ -25,8 +25,8 @@ class DetoxCopilot {
     copilot.reset();
   }
 
-  perform(intent) {
-    return copilot.perform(intent);
+  perform(...steps) {
+    return copilot.perform(...steps);
   }
 }
 

package/src/copilot/detoxCopilotFrameworkDriver.js

@@ -14,25 +14,25 @@ const detoxCopilotFrameworkDriver = {
             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.'],
+            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.',
             example: "element(by.text('Login'))",
-            guidelines: ['Avoid using text matchers when possible; prefer test-ids.'],
+            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; prefer test-ids.'],
+            guidelines: ['Use type matchers as a last resort.'],
           },
           {
             signature: 'atIndex(index: number)',
-            description: 'Selects the element at the specified index from a set of matched elements.',
+            description: 'Selects the element at the specified index from 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.'],
+            guidelines: ['Use when multiple elements match the same matcher.'],
           },
         ],
       },
@@ -43,169 +43,141 @@ const detoxCopilotFrameworkDriver = {
             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)`.',
-            ],
+            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);",
-            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.'],
+            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');",
-            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.',
+            description: 'Adjusts slider to a normalized position between 0 and 1.',
             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.',
+            description: 'Scrolls an element by an offset in a direction.',
             example: "await element(by.id('scrollView')).scroll(100, 'down');",
-            guidelines: ['Specify direction as "up", "down", "left", or "right".'],
+            guidelines: [
+              'Direction can be "up", "down", "left", or "right".',
+              'Use `startPositionX` and `startPositionY` to specify the starting point of the scroll gesture.',
+              'If multiple scroll actions are needed while waiting for an element, use `whileElement()` in conjunction with `waitFor()`.',
+            ],
           },
           {
-            signature: 'scrollTo(edge: string)',
+            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: ['Specify edge as "top", "bottom", "left", or "right".'],
+            guidelines: [
+              'Edge can be "top", "bottom", "left", or "right".',
+              'Use `startPositionX` and `startPositionY` to specify the starting point of the scroll gesture.',
+            ],
+          },
+          {
+            signature: 'whileElement(element: Matcher)',
+            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 the element to the specified index. (Android only)',
+            description: 'Scrolls 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);",
+            description: 'Simulates a swipe gesture.',
+            example: "await element(by.id('scrollView')).swipe('up');",
             guidelines: [
-              'Specify direction as "up", "down", "left", or "right".',
-              'Speed can be "fast", "slow". default is "fast".',
+              '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 a picker column to a specific value (iOS only).',
+            description: 'Sets picker column to a 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.',
+            description: 'Sets 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.',
+            description: 'Performs 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.'],
+            example: "await element(by.id('pinchableView')).pinch(1.1);",
+            guidelines: ['Scale >1 to zoom in, <1 to zoom out.'],
           },
-
           {
             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.
-  `,
+            description: 'Retrieves attributes of the element.',
             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.',
-            ],
+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');",
-            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.'],
+            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);",
           },
         ],
       },
@@ -216,75 +188,56 @@ const detoxCopilotFrameworkDriver = {
             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.'],
+            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-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.'],
+            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 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.'],
+            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();\nawait expect(element(by.id('tinyButton'))).not.toExist();",
-            guidelines: ["Use 'not' to negate an expectation."],
+            example: "await expect(element(by.id('tinyButton'))).not.toBeVisible();",
           },
         ],
       },
@@ -293,27 +246,412 @@ const detoxCopilotFrameworkDriver = {
         items: [
           {
             signature: 'jestExpect',
-            description: 'Jest expect utility for jest-assisted assertions. It is already imported in the environment.',
+            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: `
-    // 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.'],
+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',
+              'Check the platform with `device.getPlatform()` before using, as it is iOS-specific',
+              '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 label.',
+            example: "system.element(by.system.label('Dismiss'));",
+          },
+          {
+            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 system.element(by.system.label('Allow')).toExist();",
+          },
+          {
+            signature: 'not',
+            description: 'Negates the expectation for system elements.',
+            example: "await 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. Use when there is only one web view on the screen.',
+            example: "const element = web.element(by.web.id('username'));",
+            guidelines: [
+              'Web APIs can only be used with web elements (within web views).',
+              'Avoid using web APIs for native elements or native APIs for web elements.',
+              'Always prefer the `by.web.id` matcher when possible.',
+            ],
+          },
+          {
+            signature: 'web(nativeMatcher).element(matcher: Matcher)',
+            description: 'Selects an element within a specific web view matched by a native matcher. Use when there are multiple web views on the screen.',
+            example: "const element = web(by.id('webview')).element(by.web.id('password'));",
+            guidelines: [
+              'Use this method when multiple web views are present.',
+              'Prefer `web.element` if only one web view is present on the screen.',
+            ],
+          },
+          {
+            signature: 'web(nativeMatcher).atIndex(index: number).element(matcher: Matcher)',
+            description: 'Selects an element within a specific web view at a given index (iOS only).',
+            example: "const element = web(by.id('webview')).atIndex(1).element(by.web.id('password'));",
+            guidelines: [
+              'Use when multiple web views with the same identifier are present on iOS.',
+              'This matcher 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: "web.element(by.web.id('submit_button'));",
+            guidelines: [
+              'Use for web elements with unique IDs.',
+              'This is the best-practice matcher for web elements.',
+            ],
+          },
+          {
+            signature: 'by.web.className(className: string)',
+            description: 'Matches web elements by their CSS class name.',
+            example: "web.element(by.web.className('btn-primary'));",
+          },
+          {
+            signature: 'by.web.cssSelector(cssSelector: string)',
+            description: 'Matches web elements using a CSS selector.',
+            example: "web.element(by.web.cssSelector('.container > .item'));",
+          },
+          {
+            signature: 'by.web.name(name: string)',
+            description: 'Matches web elements by their name attribute.',
+            example: "web.element(by.web.name('email'));",
+          },
+          {
+            signature: 'by.web.xpath(xpath: string)',
+            description: 'Matches web elements using an XPath expression.',
+            example: "web.element(by.web.xpath('//*[@id=\"submit\"]'));",
+            guidelines: [
+              'Use when `by.web.id` is not available.',
+              'XPath matchers can be less performant.',
+            ],
+          },
+          {
+            signature: 'by.web.href(href: string)',
+            description: 'Matches web elements by their href attribute.',
+            example: "web.element(by.web.href('https://example.com'));",
+          },
+          {
+            signature: 'by.web.hrefContains(href: string)',
+            description: 'Matches web elements whose href attribute contains the specified string.',
+            example: "web.element(by.web.hrefContains('example.com'));",
+          },
+          {
+            signature: 'by.web.tag(tag: string)',
+            description: 'Matches web elements by their tag name.',
+            example: "web.element(by.web.tag('h1'));",
+          },
+          {
+            signature: 'by.web.value(value: string)',
+            description: 'Matches web elements by their value attribute (iOS only).',
+            example: "web.element(by.web.value('Submit'));",
+            guidelines: ['Available on iOS only.'],
+          },
+          {
+            signature: 'by.web.label(label: string)',
+            description: 'Matches web elements by their accessibility label (iOS only, supports `asSecured()`).',
+            example: "web.element(by.web.label('Submit')).asSecured();",
+            guidelines: [
+              'Available on iOS only.',
+              'Use when the element has a unique label.',
+            ],
+          },
+          {
+            signature: 'by.web.type(accessibilityType: string)',
+            description: 'Matches web elements by accessibility type (iOS only, with `asSecured()`).',
+            example: "web.element(by.web.type('textField')).asSecured();",
+            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: "web.element(by.web.tag('h1')).atIndex(1);",
+            guidelines: ['Use when multiple web elements match the same matcher.'],
+          },
+          {
+            signature: 'tap()',
+            description: 'Taps on a web element.',
+            example: "await web.element(by.web.id('link')).tap();",
+            guidelines: [
+              'Supports `asSecured()` on iOS.',
+              'Use `asSecured()` when interacting with secured web views.',
+            ],
+          },
+          {
+            signature: 'typeText(text: string, isContentEditable?: boolean)',
+            description: 'Types text into a web element.',
+            example: "await web.element(by.web.name('search')).typeText('Detox');",
+            guidelines: [
+              'Set `isContentEditable` to `true` for content-editable elements on Android.',
+              'On iOS, content-editable elements are automatically detected.',
+              'Supports `asSecured()` on iOS.',
+            ],
+          },
+          {
+            signature: 'replaceText(text: string)',
+            description: 'Replaces text in a web element.',
+            example: "await web.element(by.web.name('search')).replaceText('Detox');",
+            guidelines: [
+              'Currently not supported for content-editable elements on Android.',
+              'Supports `asSecured()` on iOS.',
+            ],
+          },
+          {
+            signature: 'clearText()',
+            description: 'Clears text from a web element.',
+            example: "await web.element(by.web.name('search')).clearText();",
+            guidelines: [
+              'Currently not supported for content-editable elements on Android.',
+              'Supports `asSecured()` on iOS.',
+            ],
+          },
+          {
+            signature: 'selectAllText()',
+            description: 'Selects all text in a web element.',
+            example: "await web.element(by.web.id('editor')).selectAllText();",
+            guidelines: [
+              'Supported for content-editable elements only on Android.',
+              'On iOS, Detox can select all text of any element that supports it.',
+            ],
+          },
+          {
+            signature: 'getText()',
+            description: 'Retrieves the text content of a web element.',
+            example: `
+const text = await web.element(by.web.id('identifier')).getText();
+jestExpect(text).toBe('Hello World!');
+`,
+            guidelines: [
+              'Use for assertions on the element\'s text content.',
+              'Requires importing `jestExpect` for assertions.',
+            ],
+          },
+          {
+            signature: 'scrollToView()',
+            description: 'Scrolls the web view to bring the element into view.',
+            example: "await web.element(by.web.id('footer')).scrollToView();",
+          },
+          {
+            signature: 'focus()',
+            description: 'Focuses on a web element.',
+            example: "await web.element(by.web.id('search')).focus();",
+          },
+          {
+            signature: 'moveCursorToEnd()',
+            description: 'Moves the input cursor to the end of the element\'s content.',
+            example: "await web.element(by.web.id('editor')).moveCursorToEnd();",
+            guidelines: [
+              'Supported for content-editable elements only on Android.',
+              'On iOS, Detox can move the cursor to the end of any element that supports it.',
+            ],
+          },
+          {
+            signature: 'runScript(script: string, args?: any[])',
+            description: 'Runs a JavaScript function on the element.',
+            example: `
+const webElement = web.element(by.web.id('identifier'));
+await webElement.runScript('(el) => el.click()');
+
+// With arguments
+await webElement.runScript('(el, args) => el.setAttribute("value", args[0])', ['Detox']);
+
+// Using function syntax
+const fontSize = await webElement.runScript(function get(element) {
+  return element.style.fontSize;
+});
+jestExpect(fontSize).toBe('16px');
+
+// Scrolling to the bottom of a scrollable web-element
+await webElement.runScript('el => el.scrollTop = el.scrollHeight');
+`,
+            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.',
+            ],
+          },
+          {
+            signature: 'getCurrentUrl()',
+            description: 'Retrieves the current URL of the web view.',
+            example: `
+const url = await web.element(by.web.id('identifier')).getCurrentUrl();
+jestExpect(url).toBe('https://example.com');
+`,
+            guidelines: [
+              'Must be called from an inner element, not the root web view.',
+              'May have issues on Android; check relevant GitHub issues.',
+            ],
+          },
+          {
+            signature: 'getTitle()',
+            description: 'Retrieves the title of the web view.',
+            example: `
+const title = await web.element(by.web.id('identifier')).getTitle();
+jestExpect(title).toBe('Welcome Page');
+`,
+            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.',
+            example: "await expect(web.element(by.web.tag('h1'))).toHaveText('Welcome');",
+          },
+          {
+            signature: 'toExist()',
+            description: 'Asserts that the web element exists.',
+            example: "await expect(web.element(by.web.xpath('//*[@id=\"main\"]'))).toExist();",
+            guidelines: [
+              'Supports `asSecured()` on iOS.',
+            ],
+          },
+          {
+            signature: 'not',
+            description: 'Negates the expectation for web elements.',
+            example: "await expect(web.element(by.web.id('error'))).not.toExist();",
+            guidelines: [
+              'Supports `asSecured()` on iOS.',
+            ],
+          },
+          {
+            signature: 'asSecured()',
+            description: 'Interacts with secured web views (iOS only).',
+            example: "await web.element(by.web.label('Submit')).asSecured().tap();",
+            guidelines: [
+              'Use for web pages with secured protocols when regular interactions fail.',
+              'Available on iOS only and currently experimental.',
+              'Less performant and has fewer APIs.',
+            ],
+          },
+        ],
+      },
     ],
   },
 
   captureSnapshotImage: async function () {
     const fileName = `snapshot_${Date.now()}.png`;
-    return await detox.device.takeScreenshot(fileName);
+    try {
+      return await detox.device.takeScreenshot(fileName);
+    } catch (_error) {
+      return null;
+    }
   },
 
   captureViewHierarchyString: async function () {
-    return detox.device.generateViewHierarchyXml();
+    try {
+      return detox.device.generateViewHierarchyXml();
+    } catch (_error) {
+      return 'Unavailable, app is probably not launched yet';
+    }
   },
 };
 

package/src/realms/DetoxContext.js

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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