testdriverai 7.9.10-test → 7.9.12-test

package/ai/agents/testdriver.md

@@ -566,8 +566,6 @@ await testdriver.pressKeys(["escape"]);
 
 // Now scroll
 await testdriver.scroll("down");
-await testdriver.scrollUntilText("Footer text");
-await testdriver.scrollUntilImage("Product image at bottom");
 
 // If scroll is not working, try using Page Down key directly
 await testdriver.pressKeys(["pagedown"]);

package/ai/skills/testdriver-find/SKILL.md

@@ -49,8 +49,8 @@ const element = await testdriver.find(description, options)
       - `"any"` — No wrapping, uses the description as-is (default behavior)
     </ParamField>
     
-    <ParamField path="zoom" type="boolean" default={true}>
-      Two-phase zoom mode for better precision in crowded UIs with many similar elements. Enabled by default.
+    <ParamField path="zoom" type="boolean" default={false}>
+      Two-phase zoom mode for better precision in crowded UIs with many similar elements. Disabled by default.
     </ParamField>
     
     <ParamField path="ai" type="object">
@@ -334,17 +334,17 @@ The `timeout` option:
 
 ## Zoom Mode
 
-Zoom mode is **enabled by default**. It uses a two-phase approach for better precision when locating elements, especially in crowded UIs with many similar elements.
+Zoom mode is **disabled by default**. It uses a two-phase approach for better precision when locating elements, especially in crowded UIs with many similar elements.
 
-To disable zoom for a specific find call, pass `zoom: false`:
+To enable zoom for a specific find call, pass `zoom: true`:
 
 ```javascript
-// Zoom is on by default — no option needed
-const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar');
+// Enable zoom for better precision in crowded UIs
+const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar', { zoom: true });
 await extensionsBtn.click();
 
-// Disable zoom for a specific call if needed
-const largeButton = await testdriver.find('big hero button', { zoom: false });
+// Without zoom (default)
+const largeButton = await testdriver.find('big hero button');
 ```
 
 ### How Zoom Mode Works
@@ -357,9 +357,9 @@ const largeButton = await testdriver.find('big hero button', { zoom: false });
 This two-phase approach gives the AI a higher-resolution view of the target area, improving accuracy when multiple similar elements are close together.
 
 <Tip>
-  You may want to disable zoom with `zoom: false` when:
-  - Targeting large, isolated elements where the extra precision isn't needed
-  - You want to speed up find calls in simple UIs
+  You may want to enable zoom with `zoom: true` when:
+  - Targeting small elements in crowded UIs with many similar elements
+  - You need extra precision for closely spaced UI elements
 </Tip>
 
 ## Cache Options

package/ai/skills/testdriver-performing-actions/SKILL.md

@@ -27,7 +27,6 @@ await testdriver.find('dropdown menu').hover();
 
 // Scrolling
 await testdriver.scroll('down', 500);
-await testdriver.scrollUntilText('Footer content');
 
 // Waiting
 await testdriver.wait(2000); // Wait 2 seconds for animation/state change

package/ai/skills/testdriver-screenshot/SKILL.md

@@ -153,7 +153,7 @@ Automatic screenshots are taken around these commands:
 - `find()` / `findAll()`
 - `click()` / `hover()` / `doubleClick()` / `rightClick()`
 - `type()` / `pressKeys()`
-- `scroll()` / `scrollUntilText()` / `scrollUntilImage()`
+- `scroll()`
 - `waitForText()` / `waitForImage()`
 - `focusApplication()`
 - `assert()` / `extract()` / `exec()`

package/ai/skills/testdriver-scroll/SKILL.md

@@ -35,8 +35,8 @@ await testdriver.scroll(direction, amount, method)
   Direction to scroll: `'up'`, `'down'`, `'left'`, `'right'`
 </ParamField>
 
-<ParamField path="amount" type="number" default="300">
-  Amount to scroll in pixels
+<ParamField path="amount" type="number" default="3">
+  Amount to scroll in clicks (scroll wheel units). Each click is roughly 100px in a browser.
 </ParamField>
 
 <ParamField path="method" type="string" default="mouse">
@@ -55,95 +55,34 @@ await testdriver.scroll(direction, amount, method)
 // Scroll down (default)
 await testdriver.scroll();
 
-// Scroll down 500 pixels
-await testdriver.scroll('down', 500);
+// Scroll down 5 clicks
+await testdriver.scroll('down', 5);
 
 // Scroll up
 await testdriver.scroll('up');
 
-// Scroll up 200 pixels
-await testdriver.scroll('up', 200);
+// Scroll up 2 clicks
+await testdriver.scroll('up', 2);
 ```
 
 ### Horizontal Scrolling
 
 ```javascript
 // Scroll right
-await testdriver.scroll('right', 300);
+await testdriver.scroll('right', 3);
 
 // Scroll left
-await testdriver.scroll('left', 300);
+await testdriver.scroll('left', 3);
 ```
 
 ### Scroll Methods
 
 ```javascript
-// Mouse wheel scroll (smooth, pixel-precise)
-await testdriver.scroll('down', 300, 'mouse');
+// Mouse wheel scroll (smooth)
+await testdriver.scroll('down', 3, 'mouse');
 
 // Keyboard scroll (uses Page Down/Up, more compatible)
-await testdriver.scroll('down', 300, 'keyboard');
-```
-
-## Scroll Until Found
-
-### scrollUntilText()
-
-Scroll until specific text appears on screen.
-
-```javascript
-await testdriver.scrollUntilText(text, direction, maxDistance, textMatchMethod, method, invert)
-```
-
-**Parameters:**
-- `text` (string) - Text to find
-- `direction` (string) - Scroll direction (default: `'down'`)
-- `maxDistance` (number) - Max pixels to scroll (default: 10000)
-- `textMatchMethod` (string) - `'turbo'` or `'ai'` (default: `'turbo'`)
-- `method` (string) - `'keyboard'` or `'mouse'` (default: `'keyboard'`)
-- `invert` (boolean) - Scroll until text disappears (default: false)
-
-**Examples:**
-```javascript
-// Scroll down until "Contact Us" appears
-await testdriver.scrollUntilText('Contact Us');
-
-// Scroll up to find text
-await testdriver.scrollUntilText('Header', 'up');
-
-// Scroll until text disappears
-await testdriver.scrollUntilText('Loading...', 'down', 5000, 'turbo', 'keyboard', true);
-
-// Use AI matching for fuzzy text
-await testdriver.scrollUntilText('footer content', 'down', 10000, 'ai');
-```
-
-### scrollUntilImage()
-
-Scroll until a visual element appears.
-
-```javascript
-await testdriver.scrollUntilImage(description, direction, maxDistance, method, path, invert)
-```
-
-**Parameters:**
-- `description` (string) - Description of the image/element
-- `direction` (string) - Scroll direction (default: `'down'`)
-- `maxDistance` (number) - Max pixels to scroll (default: 10000)
-- `method` (string) - `'keyboard'` or `'mouse'` (default: `'keyboard'`)
-- `path` (string | null) - Path to image template (optional)
-- `invert` (boolean) - Scroll until image disappears (default: false)
-
-**Examples:**
-```javascript
-// Scroll until visual element appears
-await testdriver.scrollUntilImage('red subscribe button');
-
-// Scroll using image template
-await testdriver.scrollUntilImage('', 'down', 10000, 'keyboard', './footer-logo.png');
-
-// Scroll until image disappears
-await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', null, true);
+await testdriver.scroll('down', 3, 'keyboard');
 ```
 
 ## Best Practices
@@ -162,7 +101,7 @@ await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', n
   // await testdriver.find('page background').click();
   
   // Now scroll will work properly
-  await testdriver.scroll('down', 300);
+  await testdriver.scroll('down', 3);
   
   // If scroll still doesn't work, use Page Down directly
   // await testdriver.pressKeys(['pagedown']);
@@ -174,80 +113,27 @@ await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', n
   
   ```javascript
   // For web pages, mouse scroll is usually smoother
-  await testdriver.scroll('down', 300, 'mouse');
+  await testdriver.scroll('down', 3, 'mouse');
   
   // For desktop apps or when mouse doesn't work
-  await testdriver.scroll('down', 300, 'keyboard');
-  ```
-</Check>
-
-<Check>
-  **Use scrollUntil for dynamic content**
-  
-  ```javascript
-  // Instead of guessing scroll amount
-  await testdriver.scrollUntilText('Load More button');
-  
-  const loadMoreBtn = await testdriver.find('Load More button');
-  await loadMoreBtn.click();
-  ```
-</Check>
-
-<Check>
-  **Set reasonable max distance**
-  
-  ```javascript
-  // Avoid infinite scrolling
-  await testdriver.scrollUntilText('Footer', 'down', 5000); // Max 5000px
+  await testdriver.scroll('down', 3, 'keyboard');
   ```
 </Check>
 
 <Warning>
   **Keyboard scroll uses Page Down/Up**
   
-  Keyboard scrolling typically moves by one "page" at a time, which may be more than the specified pixel amount. It's more compatible but less precise than mouse scrolling.
+  Keyboard scrolling typically moves by one "page" at a time, which may be more than the specified click amount. It's more compatible but less precise than mouse scrolling.
 </Warning>
 
 ## Use Cases
 
 <AccordionGroup>
-  <Accordion title="Navigate to Footer">
-    ```javascript
-    // Scroll to bottom of page
-    await testdriver.scrollUntilText('Contact Us');
-    
-    const contactLink = await testdriver.find('Contact Us link');
-    await contactLink.click();
-    ```
-  </Accordion>
-  
-  <Accordion title="Load More Results">
-    ```javascript
-    // Scroll to load more button
-    await testdriver.scrollUntilText('Load More');
-    
-    const loadBtn = await testdriver.find('Load More button');
-    await loadBtn.click();
-    
-    await new Promise(r => setTimeout(r, 2000));
-    ```
-  </Accordion>
-  
-  <Accordion title="Find Element in Long List">
-    ```javascript
-    // Scroll through list to find item
-    await testdriver.scrollUntilText('Product #42');
-    
-    const product = await testdriver.find('Product #42');
-    await product.click();
-    ```
-  </Accordion>
-  
   <Accordion title="Infinite Scroll">
     ```javascript
     // Scroll multiple times for infinite scroll
     for (let i = 0; i < 5; i++) {
-      await testdriver.scroll('down', 500);
+      await testdriver.scroll('down', 5);
       await new Promise(r => setTimeout(r, 1000)); // Wait for load
     }
     ```
@@ -256,7 +142,7 @@ await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', n
   <Accordion title="Horizontal Gallery">
     ```javascript
     // Navigate horizontal carousel
-    await testdriver.scroll('right', 300);
+    await testdriver.scroll('right', 3);
     await new Promise(r => setTimeout(r, 500));
     
     const nextImage = await testdriver.find('next image in carousel');
@@ -287,8 +173,8 @@ describe('Scrolling', () => {
   it('should scroll to find elements', async () => {
     await testdriver.focusApplication('Google Chrome');
     
-    // Scroll to footer
-    await testdriver.scrollUntilText('Contact Information');
+    // Scroll down the page
+    await testdriver.scroll('down', 5);
     
     // Click footer link
     const privacyLink = await testdriver.find('Privacy Policy link');
@@ -302,29 +188,13 @@ describe('Scrolling', () => {
     
     // Scroll multiple times to load content
     for (let i = 0; i < 3; i++) {
-      await testdriver.scroll('down', 500);
+      await testdriver.scroll('down', 5);
       await new Promise(r => setTimeout(r, 1500)); // Wait for load
     }
     
     // Verify content loaded
     await testdriver.assert('more than 10 items are visible');
   });
-
-  it('should scroll until loading completes', async () => {
-    // Scroll until loading spinner disappears
-    await testdriver.scrollUntilImage(
-      'loading spinner', 
-      'down', 
-      5000, 
-      'keyboard', 
-      null, 
-      true // invert - wait for it to disappear
-    );
-    
-    // Now interact with loaded content
-    const firstResult = await testdriver.find('first search result');
-    await firstResult.click();
-  });
 });
 ```
 

package/ai/skills/testdriver-test-writer/SKILL.md

@@ -392,8 +392,6 @@ await element.click();
 
 ```javascript
 await testdriver.scroll("down");
-await testdriver.scrollUntilText("Footer text");
-await testdriver.scrollUntilImage("Product image at bottom");
 ```
 
 ### Executing Code in Sandbox

package/ai/skills/testdriver-testdriver/SKILL.md

@@ -556,8 +556,6 @@ await testdriver.pressKeys(["escape"]);
 
 // Now scroll
 await testdriver.scroll("down");
-await testdriver.scrollUntilText("Footer text");
-await testdriver.scrollUntilImage("Product image at bottom");
 
 // If scroll is not working, try using Page Down key directly
 await testdriver.pressKeys(["pagedown"]);

package/docs/_data/examples-manifest.json

@@ -2,16 +2,16 @@
   "$schema": "./examples-manifest.schema.json",
   "examples": {
     "assert.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68b0f6a1c5774e805b31",
-      "lastUpdated": "2026-04-01T00:51:43.773Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f7248d4e274f31c128",
+      "lastUpdated": "2026-04-02T00:49:48.926Z"
     },
     "drag-and-drop.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42fc0ac3cc632a918b",
       "lastUpdated": "2026-03-03T00:32:25.275Z"
     },
     "exec-pwsh.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68a2f6a1c5774e805b25",
-      "lastUpdated": "2026-04-01T00:37:55.050Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e1248d4e274f31c11c",
+      "lastUpdated": "2026-04-02T00:33:08.610Z"
     },
     "match-image.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c8738c14b73310c783941d",
@@ -22,84 +22,84 @@
       "lastUpdated": "2026-03-03T00:32:25.282Z"
     },
     "hover-text-with-description.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68a4f6a1c5774e805b26",
-      "lastUpdated": "2026-04-01T00:36:52.167Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e4248d4e274f31c11d",
+      "lastUpdated": "2026-04-02T00:31:31.665Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68a7f6a1c5774e805b29",
-      "lastUpdated": "2026-04-01T00:37:59.577Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e8248d4e274f31c120",
+      "lastUpdated": "2026-04-02T00:33:15.383Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68a8f6a1c5774e805b2a",
-      "lastUpdated": "2026-04-01T00:38:00.948Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8eb248d4e274f31c121",
+      "lastUpdated": "2026-04-02T00:33:18.021Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68a1f6a1c5774e805b24",
-      "lastUpdated": "2026-04-01T00:37:21.547Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8df248d4e274f31c11b",
+      "lastUpdated": "2026-04-02T00:32:16.921Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68a5f6a1c5774e805b27",
-      "lastUpdated": "2026-04-01T00:42:55.421Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e6248d4e274f31c11e",
+      "lastUpdated": "2026-04-02T00:38:43.485Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68aaf6a1c5774e805b2b",
-      "lastUpdated": "2026-04-01T00:37:30.348Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8ed248d4e274f31c122",
+      "lastUpdated": "2026-04-02T00:32:29.925Z"
     },
     "installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68abf6a1c5774e805b2c",
-      "lastUpdated": "2026-04-01T00:36:59.750Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f0248d4e274f31c123",
+      "lastUpdated": "2026-04-02T00:31:43.411Z"
     },
     "type.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68adf6a1c5774e805b2f",
-      "lastUpdated": "2026-04-01T00:37:33.578Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f2248d4e274f31c126",
+      "lastUpdated": "2026-04-02T00:32:35.729Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68aff6a1c5774e805b30",
-      "lastUpdated": "2026-04-01T00:50:27.244Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f5248d4e274f31c127",
+      "lastUpdated": "2026-04-02T00:48:38.124Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68b3f6a1c5774e805b33",
-      "lastUpdated": "2026-04-01T00:38:11.893Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8fc248d4e274f31c12a",
+      "lastUpdated": "2026-04-02T00:33:33.877Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68b9f6a1c5774e805b37",
-      "lastUpdated": "2026-04-01T00:56:46.559Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb905248d4e274f31c12e",
+      "lastUpdated": "2026-04-02T00:56:49.118Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68b5f6a1c5774e805b34",
-      "lastUpdated": "2026-04-01T00:37:09.297Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8fe248d4e274f31c12b",
+      "lastUpdated": "2026-04-02T00:31:58.929Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68b6f6a1c5774e805b35",
-      "lastUpdated": "2026-04-01T00:38:14.684Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb900248d4e274f31c12c",
+      "lastUpdated": "2026-04-02T00:33:38.547Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68b8f6a1c5774e805b36",
-      "lastUpdated": "2026-04-01T00:37:12.144Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb902248d4e274f31c12d",
+      "lastUpdated": "2026-04-02T00:32:03.120Z"
     },
     "captcha-api.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698f7df69e27ce1528d7d087/698f7fb0d3b320ad547d9d44",
       "lastUpdated": "2026-02-13T19:55:05.951Z"
     },
     "element-not-found.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68bbf6a1c5774e805b38",
-      "lastUpdated": "2026-04-01T00:38:19.040Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb907248d4e274f31c12f",
+      "lastUpdated": "2026-04-02T00:33:44.522Z"
     },
     "formatted-logging.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c873a714b73310c7839450",
       "lastUpdated": "2026-03-29T00:36:10.628Z"
     },
     "hover-text.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68bef6a1c5774e805b3a",
-      "lastUpdated": "2026-04-01T00:37:18.214Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb90c248d4e274f31c131",
+      "lastUpdated": "2026-04-02T00:32:11.939Z"
     },
     "no-provision.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b7706a177a05bccd1cf",
       "lastUpdated": "2026-03-03T00:32:25.279Z"
     },
     "ai.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68bcf6a1c5774e805b39",
-      "lastUpdated": "2026-04-01T01:00:32.812Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb90a248d4e274f31c130",
+      "lastUpdated": "2026-04-02T01:00:30.163Z"
     },
     "popup-loading.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698bc89f7140c3fa7daaca8d/698bca7f7140c3fa7daacbf7",
@@ -134,12 +134,12 @@
       "lastUpdated": "2026-02-13T19:55:05.953Z"
     },
     "findall-coffee-icons.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68b2f6a1c5774e805b32",
-      "lastUpdated": "2026-04-01T00:37:38.507Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8fa248d4e274f31c129",
+      "lastUpdated": "2026-04-02T00:32:43.247Z"
     },
     "parse.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cc689ff6a1c5774e805b23/69cc68bff6a1c5774e805b3b",
-      "lastUpdated": "2026-04-01T00:38:23.690Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb90e248d4e274f31c132",
+      "lastUpdated": "2026-04-02T00:33:51.354Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

package/docs/snippets/tests/scroll-yaml.mdx

@@ -14,7 +14,7 @@ steps:
       - command: press-keys
         keys:
           - enter
-  - prompt: scroll down with the mouse 1000 pixels
+  - prompt: scroll down with the mouse 10 clicks
     commands:
       - command: hover-text
         text: "HTML: HyperText Markup Language"
@@ -22,7 +22,7 @@ steps:
         action: click
       - command: scroll
         direction: down
-        amount: 1000
+        amount: 10
   - prompt: assert the page is scrolled
     commands:
       - command: assert

package/docs/v6/commands/scroll-until-image.mdx

@@ -22,7 +22,7 @@ The `scroll-until-image` command is used to scroll the screen in a specified dir
 | :-----------: | :-------: | :---------------------------------------------------------------------------------------------------------------------- |
 | `description` | `string`  | A description of the image and what it represents.                                                                      |
 |  `direction`  | `string`  | (Optional) The direction to scroll. Available directions are: `up`, `down`, `left`, `right`. Defaults to `down`.        |
-|  `distance`   | `number`  | (Optional) The maximum number of pixels to scroll before giving up. Default is `10000`.                                 |
+|  `distance`   | `number`  | (Optional) The maximum number of scroll clicks before giving up. Default is `100`.                                 |
 |   `method`    | `string`  | (Optional) The method to use to scroll the page. Available methods are: `mouse` and `keyboard`. Defaults to `keyboard`. |
 |    `path`     | `string`  | (Optional) The relative path to the image file that needs to be matched on the screen.                                  |
 |   `invert`    | `boolean` | (Optional) If set to `true`, the command will scroll until the specified image is NOT detected. Default is `false`.     |

package/docs/v6/commands/scroll-until-text.mdx

@@ -23,7 +23,7 @@ The `scroll-until-text` command is used to scroll the screen in a specified dire
 |   `text`    | `string`  | The text to find on the screen. Longer and unique are better. Note this is **case sensitive**                           |
 | `direction` | `string`  | (Optional) The direction to scroll. Available directions are: `up`, `down`, `left`, `right`. Defaults to `down`.        |
 |  `method`   | `string`  | (Optional) The method to use to scroll the page. Available methods are: `mouse` and `keyboard`. Defaults to `keyboard`. |
-| `distance`  | `number`  | (Optional) The maximum number of pixels to scroll before giving up. Default is `10000`.                                 |
+| `distance`  | `number`  | (Optional) The maximum number of scroll clicks before giving up. Default is `100`.                                 |
 |  `invert`   | `boolean` | (Optional) If set to `true`, the command will scroll until the specified text is NOT detected. Default is `false`.      |
 
 <Note>
@@ -47,7 +47,7 @@ distance: 1000
 
 - Use unique and specific text to improve detection accuracy.
 - Adjust the `distance` value to control how far the command scrolls before giving up.
-- If you don't specify a `distance`, the command will scroll 300 pixels at a time, giving up after 5 attempts.
+- If you don't specify a `distance`, the command will scroll 5 clicks at a time, giving up after reaching 100 clicks.
 
 ## Gotchas
 

package/docs/v6/commands/scroll.mdx

@@ -22,7 +22,7 @@ The `scroll` command is used to scroll the screen in a specified direction using
 | :---------: | :------: | :------------------------------------------------------------------------------------ |
 | `direction` | `string` | The direction to scroll. Available directions are: `up`, `down`, `left`, `right`.     |
 |  `method`   | `string` | The method to scroll. Available methods are: `mouse`, `keyboard`. Defaults to `mouse` |
-|  `amount`   | `number` | (Optional) Pixels to scroll. If not specified, a default amount of 300 is used.       |
+|  `amount`   | `number` | (Optional) Clicks (scroll wheel units) to scroll. If not specified, a default of 3 is used. |
 
 <Warning>
   The `amount` should only be used when the `method` is mouse. If the `method`
@@ -36,7 +36,7 @@ The `scroll` command is used to scroll the screen in a specified direction using
 - command: scroll
   direction: down
   method: mouse
-  amount: 100
+  amount: 3
 ```
 
 ## Protips

package/docs/v7/_drafts/agents.mdx

@@ -364,10 +364,6 @@ await testdriver.scroll('left', 300);
 // Scroll methods
 await testdriver.scroll('down', 300, 'mouse');    // Mouse wheel (smooth)
 await testdriver.scroll('down', 300, 'keyboard'); // Page Down key
-
-// Scroll until text appears
-await testdriver.scrollUntilText('Contact Us');
-await testdriver.scrollUntilText('Footer', 'down', 5000);
 ```
 
 ### exec(language, code, timeout, silent) - Execute Code

package/docs/v7/_drafts/commands/scroll-until-image.mdx

@@ -22,7 +22,7 @@ The `scroll-until-image` command is used to scroll the screen in a specified dir
 | :-----------: | :-------: | :---------------------------------------------------------------------------------------------------------------------- |
 | `description` | `string`  | A description of the image and what it represents.                                                                      |
 |  `direction`  | `string`  | (Optional) The direction to scroll. Available directions are: `up`, `down`, `left`, `right`. Defaults to `down`.        |
-|  `distance`   | `number`  | (Optional) The maximum number of pixels to scroll before giving up. Default is `10000`.                                 |
+|  `distance`   | `number`  | (Optional) The maximum number of scroll clicks before giving up. Default is `100`.                                 |
 |   `method`    | `string`  | (Optional) The method to use to scroll the page. Available methods are: `mouse` and `keyboard`. Defaults to `keyboard`. |
 |    `path`     | `string`  | (Optional) The relative path to the image file that needs to be matched on the screen.                                  |
 |   `invert`    | `boolean` | (Optional) If set to `true`, the command will scroll until the specified image is NOT detected. Default is `false`.     |

package/docs/v7/_drafts/commands/scroll-until-text.mdx

@@ -23,7 +23,7 @@ The `scroll-until-text` command is used to scroll the screen in a specified dire
 |   `text`    | `string`  | The text to find on the screen. Longer and unique are better. Note this is **case sensitive**                           |
 | `direction` | `string`  | (Optional) The direction to scroll. Available directions are: `up`, `down`, `left`, `right`. Defaults to `down`.        |
 |  `method`   | `string`  | (Optional) The method to use to scroll the page. Available methods are: `mouse` and `keyboard`. Defaults to `keyboard`. |
-| `distance`  | `number`  | (Optional) The maximum number of pixels to scroll before giving up. Default is `10000`.                                 |
+| `distance`  | `number`  | (Optional) The maximum number of scroll clicks before giving up. Default is `100`.                                 |
 |  `invert`   | `boolean` | (Optional) If set to `true`, the command will scroll until the specified text is NOT detected. Default is `false`.      |
 
 <Note>
@@ -47,7 +47,7 @@ distance: 1000
 
 - Use unique and specific text to improve detection accuracy.
 - Adjust the `distance` value to control how far the command scrolls before giving up.
-- If you don't specify a `distance`, the command will scroll 300 pixels at a time, giving up after 5 attempts.
+- If you don't specify a `distance`, the command will scroll 5 clicks at a time, giving up after reaching 100 clicks.
 
 ## Gotchas
 

package/docs/v7/_drafts/commands/scroll.mdx

@@ -22,7 +22,7 @@ The `scroll` command is used to scroll the screen in a specified direction using
 | :---------: | :------: | :------------------------------------------------------------------------------------ |
 | `direction` | `string` | The direction to scroll. Available directions are: `up`, `down`, `left`, `right`.     |
 |  `method`   | `string` | The method to scroll. Available methods are: `mouse`, `keyboard`. Defaults to `mouse` |
-|  `amount`   | `number` | (Optional) Pixels to scroll. If not specified, a default amount of 300 is used.       |
+|  `amount`   | `number` | (Optional) Scroll clicks (wheel units). If not specified, a default amount of 3 is used.       |
 
 <Warning>
   The `amount` should only be used when the `method` is mouse. If the `method`