detox 20.27.3 → 20.27.4

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

@@ -0,0 +1 @@
+9ace4a96235511950308086f1d57d806

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

@@ -0,0 +1 @@
+22cc9e5934c1c0ba48217d81dc0a0403d6383378

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

@@ -0,0 +1 @@
+c4f49a1754ae4e50e6a32cd8f22a51cb920e2a58b8e9da6a5d443aa6715a59f5

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

@@ -0,0 +1 @@
+503797c9ab31332033756727a60af64c7797d51b731d88e6e841cba4c477f68ed1df2872602097587c91c5b357377007e7c9cb7e4f2b838172d1f99af52b5334

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

@@ -0,0 +1 @@
+05c87fc838b557d8c9537d4f432a9033

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

@@ -0,0 +1 @@
+acc5c69d438baaadcfe97fa1f168e2799c3ce03a

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

@@ -0,0 +1 @@
+9b9bb763d1adae07410c1057e4212277e5d1e3342afd286fbccd623511f86ce9

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

@@ -0,0 +1 @@
+507cda9204d0726835db6d44cb80d23dd7fe4765c9b6387e635c1ad9cf8849e5d3d799100796106e7fcdd7fe4b4adb6aeb582aaccbf1db85639ae6b81e8b552e

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

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

@@ -0,0 +1 @@
+69801cb935f0a63f247f867c28709f8d

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

@@ -0,0 +1 @@
+9605245c61fd0ea528dd0cd2eda73ac0866ba25f

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

@@ -0,0 +1 @@
+69e7b3363b16f075838fe56272dd13fd089b4d9b344ab4d4456a91d9444e0bbb

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

@@ -0,0 +1 @@
+9f3223915c0899fed72f86c5781ee7c1f6f9737f0a016224582372e7b5f29ec6672fd943163717465549159f3f75a11a2ee6eca488589b97bc29775c3cbc3fe5

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

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

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

@@ -1 +1 @@
-27e42826d06e4da1ec0844db0255a70c
+4e15390d4670f66357943485fa05acea

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

@@ -1 +1 @@
-8a719a4551a0fde056e3f53cd841131fe908fc4d
+3475202451a2cb5e3534b59b14612e32df033626

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

@@ -1 +1 @@
-ad19b8a5540aabca7a9ea07890509a1e9161848db2682d1c82274168fcf710ef
+d1b63410f852b05d5e00c1a0358fd61afe51474be017e2e78fef15e30cb09d44

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

@@ -1 +1 @@
-b4fcc3ee40ae9bb22b6c97fd768a3b52281ca32229fd3fc50d8512b81ccec8cbbc3c94f03be1e843016fe97de37a5042938ba549e512894d6c08686ebf2d43c2
+8b1cc9ffb3d076da45ed87bbaa606ccd89be6fc53dd5e57e8f3d3be5ed09eece128d7cbe4f398606441c1f837cf07268e0a35071c90894c2bd0f5f259b8865c7

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

@@ -0,0 +1 @@
+11e61e70a680b35bc8433c99dbe93fa7

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

@@ -0,0 +1 @@
+461391ec015ccc3107d8d1d1f4f90fdef1e89d4d

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

@@ -0,0 +1 @@
+37d6621cb43970a45655c142a2d3f87202228010f48c9359b1608f968fc29965

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

@@ -0,0 +1 @@
+f21f72c93ca515baebf73681a7406d25682550f537943a6f7b3933ba0bc318a3c83a243e7c7ac45372deb363a7dce7396132e101545a586c7b23ecaa6d3606e4

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

@@ -0,0 +1 @@
+af13b71ab208d17b33c1fc7a1ef4e529

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

@@ -0,0 +1 @@
+47dca63caffe4427b6fec3ab51e13ade0e234e6d

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

@@ -0,0 +1 @@
+22561e652905451c48ffb378b015ae046634e2efea239e6f08875ccbd179db3e

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

@@ -0,0 +1 @@
+46aa7c047bc8cbe7ad61270652a5bcc88955545e33c6d8338a9cc610e157d5cf6b2ecea224bacdb13cffc027d92617abecf0d1faa7eb89fb5b8c10cd7c410eb1

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

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

@@ -0,0 +1 @@
+07b3035704b21925bce075aa8ceaa610

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

@@ -0,0 +1 @@
+5369c9600c539c3142ab367ea81df17920762e86

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

@@ -0,0 +1 @@
+675cf33b02458dfa9d2c997a5d51f70a138d6e05cc2a1794c530ded4be481f48

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

@@ -0,0 +1 @@
+8f6bf9c98b0d80bec51af79d562411dc85ac6fb11ee7cb952f1875abd43ac73df3ffb90dc426485fe8e21dc0200b27a0ad646fbc8edc89576502690eaa817ca3

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.3</latest>
-    <release>20.27.3</release>
+    <latest>20.27.4</latest>
+    <release>20.27.4</release>
     <versions>
-      <version>20.27.3</version>
+      <version>20.27.4</version>
     </versions>
-    <lastUpdated>20241009154624</lastUpdated>
+    <lastUpdated>20241019191405</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-6ddea16ac39ebcaa72590d9b50ca41a1
+06da87cac17d41b217b1204e3baac71c

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

@@ -1 +1 @@
-1ad379b7c3de738b8adebc19d859742fdbf6797a
+3260642fbd27ef17b3f677a27b9060f29ecddd68

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

@@ -1 +1 @@
-61f5bf7772111546173237486ddc5909ee6bc7053595adc3305c0ccfeb927736
+7aaa8a6d2ea4aed57f4c789a4d2229070c7619b8466e959fe73d930c6d2f09c5

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

@@ -1 +1 @@
-03e8049bdb4784b4c54b25e9a14b30012ee6212ae6b7329d61ea357ed97f485d1e88a8f2e0d573046020c07fd7681ac9cd84189d195598b867401ef83e97b1e9
+437e4f341f9a2a317ff3fc9c8ad606d36974f884172e105b36c2eb256d3245791fc0dabad87c8c23ea76fc9995528af1b6d6b9a5a28f389afe158b0d8318e6da

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

@@ -16,10 +16,10 @@ import kotlin.coroutines.resume
 
 
 private const val GET_HTML_SCRIPT = """
+(function() {
     const blacklistedTags = ['script', 'style', 'head', 'meta'];
     const blackListedTagsSelector = blacklistedTags.join(',');
 
-    (function() {
     // Clone the entire document
     var clonedDoc = document.documentElement.cloneNode(true);
 
@@ -170,9 +170,9 @@ object ViewHierarchyGenerator {
         if (shouldInjectNewTestId) {
             val newTestId = "${injectedPrefix}${indexPath.joinToString("_")}"
             view.tag = newTestId
-            attributes["testID"] = newTestId
+            attributes["id"] = newTestId
         } else {
-            attributes["testID"] = currentTestId
+            attributes["id"] = currentTestId
         }
 
         attributes

package/package.json

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

package/src/copilot/detoxCopilotFrameworkDriver.js

@@ -106,7 +106,7 @@ const detoxCopilotFrameworkDriver = {
             ],
           },
           {
-            signature: 'whileElement(element: Matcher)',
+            signature: 'waitFor(element: Matcher)..toBeVisible().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')))
@@ -335,14 +335,20 @@ await device.launchApp({ launchArgs: { someLaunchArg: 1234 } });`,
             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 label.',
+            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)',
@@ -357,12 +363,12 @@ await device.launchApp({ launchArgs: { someLaunchArg: 1234 } });`,
           {
             signature: 'toExist()',
             description: 'Asserts that the system element exists.',
-            example: "await system.element(by.system.label('Allow')).toExist();",
+            example: "await expect(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();",
+            example: "await expect(system.element(by.system.label('Allow'))).not.toExist();",
           },
         ],
       },
@@ -372,99 +378,121 @@ await device.launchApp({ launchArgs: { someLaunchArg: 1234 } });`,
           {
             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'));",
+            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: [
-              '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.',
+              '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). Avoid using web APIs for native elements or native APIs for web elements.',
             ],
           },
           {
-            signature: 'web(nativeMatcher).element(matcher: Matcher)',
+            signature: 'web(nativeMatcher: 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'));",
+            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.',
-              'Prefer `web.element` if only one web view is present on the screen.',
+              '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.',
             ],
           },
           {
-            signature: 'web(nativeMatcher).atIndex(index: number).element(matcher: Matcher)',
+            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: "const element = web(by.id('webview')).atIndex(1).element(by.web.id('password'));",
+            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 matcher is available for iOS only.',
+              '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: "web.element(by.web.id('submit_button'));",
+            description: 'Matches web elements by their "id" attribute.',
+            example: `await web.element(by.web.id('search')).tap();`,
             guidelines: [
-              'Use for web elements with unique IDs.',
-              'This is the best-practice matcher for web elements.',
+              '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: "web.element(by.web.className('btn-primary'));",
+            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: "web.element(by.web.cssSelector('.container > .item'));",
+            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: "web.element(by.web.name('email'));",
+            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: "web.element(by.web.xpath('//*[@id=\"submit\"]'));",
-            guidelines: [
-              'Use when `by.web.id` is not available.',
-              'XPath matchers can be less performant.',
-            ],
+            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: "web.element(by.web.href('https://example.com'));",
+            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: "web.element(by.web.hrefContains('example.com'));",
+            example: `await web.element(by.web.hrefContains('/about')).tap();`,
           },
           {
             signature: 'by.web.tag(tag: string)',
             description: 'Matches web elements by their tag name.',
-            example: "web.element(by.web.tag('h1'));",
+            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: "web.element(by.web.value('Submit'));",
-            guidelines: ['Available on 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 accessibility label (iOS only, supports `asSecured()`).',
-            example: "web.element(by.web.label('Submit')).asSecured();",
+            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 element has a unique label.',
+              'Use when the element has a unique label or aria-label.',
+              'Can be used to match buttons and input elements by their inner text content.',
             ],
           },
           {
             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();",
+            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".',
@@ -473,163 +501,166 @@ await device.launchApp({ launchArgs: { someLaunchArg: 1234 } });`,
           {
             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.'],
+            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.id('link')).tap();",
+            example: `await web.element(by.web.label('Submit')).tap();`,
             guidelines: [
               'Supports `asSecured()` on iOS.',
-              'Use `asSecured()` when interacting with secured web views.',
             ],
           },
           {
-            signature: 'typeText(text: string, isContentEditable?: boolean)',
+            signature: 'typeText(text: string)',
             description: 'Types text into a web element.',
-            example: "await web.element(by.web.name('search')).typeText('Detox');",
+            example: `await web.element(by.web.id('rich-text-editor')).typeText('This is a test message');`,
             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');",
+            example: `await web.element(by.web.id('username')).replaceText('new_user');`,
             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();",
+            example: `await web.element(by.web.id('comments')).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.',
-            ],
+            example: `await web.element(by.web.id('notes')).selectAllText();`,
           },
           {
             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!');
-`,
+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.',
-              '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();",
+            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('search')).focus();",
+            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 that require focus before typing.',
+              'No need for secured interactions on iOS.',
+            ]
           },
           {
             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.',
-            ],
+            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 element.',
             example: `
-const webElement = web.element(by.web.id('identifier'));
-await webElement.runScript('(el) => el.click()');
+// Click an element using a custom script
+await web.element(by.web.id('hidden-button')).runScript('el => el.click()');
 
-// With arguments
-await webElement.runScript('(el, args) => el.setAttribute("value", args[0])', ['Detox']);
+// 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']);
 
-// Using function syntax
-const fontSize = await webElement.runScript(function get(element) {
-  return element.style.fontSize;
+// Get the color of an element
+const color = await web.element(by.web.id('header')).runScript(function(el) {
+  return window.getComputedStyle(el).color;
 });
-jestExpect(fontSize).toBe('16px');
+jestExpect(color).toBe('rgb(0, 0, 0)');
 
-// Scrolling to the bottom of a scrollable web-element
-await webElement.runScript('el => el.scrollTop = el.scrollHeight');
-`,
+// 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: `
-const url = await web.element(by.web.id('identifier')).getCurrentUrl();
-jestExpect(url).toBe('https://example.com');
-`,
+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.',
-              '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');
-`,
+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.',
-            example: "await expect(web.element(by.web.tag('h1'))).toHaveText('Welcome');",
+            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.',
-            example: "await expect(web.element(by.web.xpath('//*[@id=\"main\"]'))).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('error'))).not.toExist();",
+            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('Submit')).asSecured().tap();",
+            example: `await web.element(by.web.label('Confirm')).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.',
+              'Applicable on iOS only with specific APIs.',
             ],
           },
         ],
@@ -638,7 +669,7 @@ jestExpect(title).toBe('Welcome Page');
   },
 
   captureSnapshotImage: async function () {
-    const fileName = `snapshot_${Date.now()}.png`;
+const fileName = `snapshot_${Date.now()}.png`;
     try {
       return await detox.device.takeScreenshot(fileName);
     } catch (_error) {

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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