detox 20.27.3 → 20.27.5

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

@@ -0,0 +1 @@
+ed8055755410772bb4b04e209912264a

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

@@ -0,0 +1 @@
+b8a7e192a47c0ba31fd4124af9a45c26fcb85f25

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

@@ -0,0 +1 @@
+69ce4a9d22f85708fe320bab219a49f1e9f14de5230a3fb3f77a29cba8a4cadf

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

@@ -0,0 +1 @@
+d39e3765fd3397f48c60d8e985c2335f72490b034cb684c6149a5b442a848bebedc396e6fe852f41429075eb2256163078c1f425379f3dda6c74e6c056934626

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

@@ -0,0 +1 @@
+cf8dd3a0b09c20f6536c73bb9b643c19

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

@@ -0,0 +1 @@
+087bb87ec12653d348901f95966ed16f46f870b2

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

@@ -0,0 +1 @@
+77ee8830fdf301ef8a7895575a4f0f3b76db9614b61942979b73d3b5001fac57

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

@@ -0,0 +1 @@
+3eb1ffc33ecae7c14b6ff36a525abacb4aa05f6d05083d2dc79bad26b63badecc5d22d45bf7dc97cc90804e4245db826e14c86d86fa49540be209708a6f854d1

package/Detox-android/com/wix/detox/{20.27.3/detox-20.27.3.pom → 20.27.5/detox-20.27.5.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.5</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.5/detox-20.27.5.pom.md5

@@ -0,0 +1 @@
+677c6313b77ecca3283152fe3cb5178d

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

@@ -0,0 +1 @@
+37e01b076ec27c02c8d839485afcd93eeb207a6a

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

@@ -0,0 +1 @@
+937e332ef0ae5be7d6023cde1703d1f3d794e4576f10ce604fd0bd479cad4598

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

@@ -0,0 +1 @@
+a78f01ffb28775259e201cb33a533ac51361d20308c92a850cb3fecc7d270ded2e529a97b980c717419e3f2167555d761393462cb05a78b733274394eb6467ec

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.5</latest>
+    <release>20.27.5</release>
     <versions>
-      <version>20.27.3</version>
+      <version>20.27.5</version>
     </versions>
-    <lastUpdated>20241009154552</lastUpdated>
+    <lastUpdated>20241021102505</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-27e42826d06e4da1ec0844db0255a70c
+59a5e503c5276ab3654c1c5e91dddca0

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

@@ -1 +1 @@
-8a719a4551a0fde056e3f53cd841131fe908fc4d
+69010ae47c2305a6da9461fbe7d70fb62fa6aa46

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

@@ -1 +1 @@
-ad19b8a5540aabca7a9ea07890509a1e9161848db2682d1c82274168fcf710ef
+3010d27fd8153242243d8290bab50a3e57fa675f08bfa30c71696c7b87cd0702

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

@@ -1 +1 @@
-b4fcc3ee40ae9bb22b6c97fd768a3b52281ca32229fd3fc50d8512b81ccec8cbbc3c94f03be1e843016fe97de37a5042938ba549e512894d6c08686ebf2d43c2
+d92976d783515910151721f930922bfffb84b57271fe6658110ff97cf08e64f2be0e984f8f7135ad2aea2e3cf8d56e7a816fcd4372ac789d27835bf44d167121

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

@@ -0,0 +1 @@
+f816c44298ef1e7ad846ca912016193d

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

@@ -0,0 +1 @@
+4ce1719c63d147c18f0ed5bea8754063b07b2263

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

@@ -0,0 +1 @@
+97abc1e3087f173b1ede28d948a1a6f05a5ec708a602ec89bbb10bea97e890ef

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

@@ -0,0 +1 @@
+99b24c91ac32ff6148553845a6b56ba37c9f7e77717eb59c779e78deea5d8047769b19bc5f6ecae23f63963c8bdfcc69f1fe21038e07a31262e41a7eae4b7cac

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

@@ -0,0 +1 @@
+768c2187e364924f92a9b6ccf3c7d0a2

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

@@ -0,0 +1 @@
+7e17fc60050feb2ea5e7dc9a93bf8b2fba13486d

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

@@ -0,0 +1 @@
+a64ce40bbbf3b827d598206f3829f34072b1d6bcd0115d930e7aabadf7477534

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

@@ -0,0 +1 @@
+60d8f60ededcfdd91034b452971b511a40a99a5a4afb42ae6fa88261cf5d29b8493b824eb2e8f453653bf723668b417943177f02fb0dcc9d58501563e7c10b54

package/Detox-android/com/wix/detox-legacy/{20.27.3/detox-legacy-20.27.3.pom → 20.27.5/detox-legacy-20.27.5.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.5</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.5/detox-legacy-20.27.5.pom.md5

@@ -0,0 +1 @@
+d734cbe76dacc5b8e6377537eac7277a

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

@@ -0,0 +1 @@
+f0cd51ba37626811bb74d3f2c02e01e63c8806fc

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

@@ -0,0 +1 @@
+613e6c3b82393253f42ddfaef259500c2fe2e6fdead2dd8581fd5bf26a4bccd3

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

@@ -0,0 +1 @@
+a1cce202047d5da041dfce87deeeadec90037990fdac8cc04012d9cc29ad922ebc0fcc012a7cb24c74d296f7e2889e4e8fde922c03ebfc6d66b197bfe4f0190d

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.5</latest>
+    <release>20.27.5</release>
     <versions>
-      <version>20.27.3</version>
+      <version>20.27.5</version>
     </versions>
-    <lastUpdated>20241009154624</lastUpdated>
+    <lastUpdated>20241021102531</lastUpdated>
   </versioning>
 </metadata>

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

@@ -1 +1 @@
-6ddea16ac39ebcaa72590d9b50ca41a1
+28a0f07347c8a70ef8460c287fc4a1f4

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

@@ -1 +1 @@
-1ad379b7c3de738b8adebc19d859742fdbf6797a
+be027c7c90f5b5426b006b5b7d8948a2388b2e0a

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

@@ -1 +1 @@
-61f5bf7772111546173237486ddc5909ee6bc7053595adc3305c0ccfeb927736
+2768186ce8120f9497e83054da9fb5d30a363955e86b5a784906105d6f4dde40

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

@@ -1 +1 @@
-03e8049bdb4784b4c54b25e9a14b30012ee6212ae6b7329d61ea357ed97f485d1e88a8f2e0d573046020c07fd7681ac9cd84189d195598b867401ef83e97b1e9
+af46bb04692fb0cc9d1fea51b5343c1af71626314a19ad09b3efbf6e4ddb08e4a88ea6b26e68cd6a2cda03f371471f4493e9a0420bcace48ec23cb9cf9c68914

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/android/detox/src/full/java/com/wix/detox/espresso/web/WebElement.java

@@ -10,6 +10,7 @@ import androidx.test.espresso.web.webdriver.DriverAtoms;
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.concurrent.TimeUnit;
 
 public class WebElement {
 
@@ -28,7 +29,7 @@ public class WebElement {
     }
 
     ElementReference get() {
-        List<ElementReference> elements = getWebViewInteraction().perform(matcherAtom).get();
+        List<ElementReference> elements = getWebViewInteraction().withTimeout(30, TimeUnit.SECONDS).perform(matcherAtom).get();
 
         if (elements == null || elements.size() == 0 || index >= elements.size()) {
             throw new RuntimeException(String.format("element was not found at index: %d", index));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "detox",
   "description": "E2E tests and automation for mobile",
-  "version": "20.27.3",
+  "version": "20.27.5",
   "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": "dd2ee8ea3ff52c1184cbb9fbe159adf85ba87a09"
 }

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