testdriverai 7.1.1 → 7.1.3

package/agent/lib/commands.js

@@ -283,6 +283,11 @@ const createCommands = (
    * @param {number} [options.redraw.diffThreshold=0.1] - Screen diff threshold percentage
    */
   const scroll = async (direction = 'down', options = {}) => {
+    // Convert number to object format
+    if (typeof options === 'number') {
+      options = { amount: options };
+    }
+    
     let { amount = 300 } = options;
     const redrawOptions = extractRedrawOptions(options);
     
@@ -1151,7 +1156,7 @@ const createCommands = (
             ),
             true,
           );
-          await scroll({ direction, amount: incrementDistance });
+          await scroll(direction, { amount: incrementDistance });
           scrollDistance = scrollDistance + incrementDistance;
         }
       }
@@ -1231,7 +1236,7 @@ const createCommands = (
             theme.dim(`scrolling ${direction} ${incrementDistance} pixels...`),
             true,
           );
-          await scroll({ direction, amount: incrementDistance });
+          await scroll(direction, { amount: incrementDistance });
           scrollDistance = scrollDistance + incrementDistance;
         }
       }

package/docs/docs.json

@@ -232,8 +232,28 @@
                   "/v7/presets/chrome",
                   "/v7/presets/chrome-extension",
                   "/v7/presets/vscode",
-                  "/v7/presets/electron",
-                  "/v7/presets/webapp"
+                  "/v7/presets/electron"
+                ]
+              },
+              {
+                "group": "Actions",
+                "icon": "bolt",
+                "pages": [
+                  "/v7/api/act",
+                  "/v7/api/assert",
+                  "/v7/api/assertions",
+                  "/v7/api/click",
+                  "/v7/api/doubleClick",
+                  "/v7/api/exec",
+                  "/v7/api/find",
+                  "/v7/api/focusApplication",
+                  "/v7/api/hover",
+                  "/v7/api/mouseDown",
+                  "/v7/api/mouseUp",
+                  "/v7/api/pressKeys",
+                  "/v7/api/rightClick",
+                  "/v7/api/type",
+                  "/v7/api/scroll"
                 ]
               },
               {
@@ -241,35 +261,8 @@
                 "icon": "book",
                 "pages": [
                   "/v7/api/client",
+                  "/v7/api/elements",
                   "/v7/api/sandbox",
-                  {
-                    "group": "Interactions",
-                    "icon": "bolt",
-                    "pages": [
-                      "/v7/api/find",
-                      "/v7/api/elements",
-                      "/v7/api/click",
-                      "/v7/api/doubleClick",
-                      "/v7/api/rightClick",
-                      "/v7/api/hover",
-                      "/v7/api/mouseDown",
-                      "/v7/api/mouseUp",
-                      "/v7/api/type",
-                      "/v7/api/pressKeys",
-                      "/v7/api/scroll",
-                      "/v7/api/focusApplication"
-                    ]
-                  },
-                  {
-                    "group": "AI & Assertions",
-                    "icon": "wand-magic-sparkles",
-                    "pages": [
-                      "/v7/api/act",
-                      "/v7/api/assert",
-                      "/v7/api/assertions"
-                    ]
-                  },
-                  "/v7/api/exec",
                   "/v7/api/dashcam"
                 ]
               }

package/docs/v7/getting-started/quickstart.mdx

@@ -44,14 +44,16 @@ TestDriver v7 lets you write AI-powered tests in JavaScript/TypeScript with full
       <Tab title="Fast">
         ```javascript test.test.js
         import { test } from 'vitest';
-        import { chrome } from 'testdriverai/presets';
+        import { TestDriver } from 'testdriverai/vitest/hooks';
 
         test('my first test', async (context) => {
-          const { testdriver } = await chrome(context, {
-            url: 'https://example.com',
+          const testdriver = TestDriver(context, {
+            headless: true,
             apiKey: 'tdai-1234567890abcdef' // Your API key from console.testdriver.ai
           });
           
+          await testdriver.provision.chrome({ url: 'https://example.com' });
+          
           await testdriver.find('More information link').click();
           await testdriver.assert('IANA page is visible');
         });
@@ -73,13 +75,13 @@ TestDriver v7 lets you write AI-powered tests in JavaScript/TypeScript with full
         
         ```javascript test.test.js
         import { test } from 'vitest';
-        import { chrome } from 'testdriverai/presets';
+        import { TestDriver } from 'testdriverai/vitest/hooks';
 
         test('my first test', async (context) => {
-          const { testdriver } = await chrome(context, {
-            url: 'https://example.com'
-            // apiKey automatically read from process.env.TD_API_KEY
-          });
+          const testdriver = TestDriver(context, { headless: true });
+          // apiKey automatically read from process.env.TD_API_KEY
+          
+          await testdriver.provision.chrome({ url: 'https://example.com' });
           
           await testdriver.find('More information link').click();
           await testdriver.assert('IANA page is visible');
@@ -111,7 +113,7 @@ TestDriver v7 lets you write AI-powered tests in JavaScript/TypeScript with full
 
 ## What Just Happened?
 
-The `chrome()` preset automatically:
+The TestDriver hook with `provision.chrome()` automatically:
 1. ✅ Connected to a TestDriver sandbox
 2. ✅ Launched Chrome browser
 3. ✅ Navigated to your URL

package/docs/v7/getting-started/running-and-debugging.mdx

@@ -101,11 +101,12 @@ Every test automatically records a video replay:
   <Step title="Get Replay URL">
     ```javascript
     test('my test', async (context) => {
-      const { testdriver, dashcam } = await chrome(context, { url });
+      const testdriver = TestDriver(context, { headless: true });
+      await testdriver.provision.chrome({ url });
 
       // Your test code
 
-      console.log('Replay:', dashcam.url);
+      console.log('Replay:', testdriver.dashcam.url);
     });
     ```
 

package/docs/v7/getting-started/writing-tests.mdx

@@ -12,13 +12,12 @@ Every TestDriver test follows this simple pattern:
 
 ```javascript
 import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('descriptive test name', async (context) => {
   // 1. Setup: Launch and navigate
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com'
-  });
+  const testdriver = TestDriver(context, { headless: true });
+  await testdriver.provision.chrome({ url: 'https://myapp.com' });
 
   // 2. Act: Interact with your application
   await testdriver.find('email input').type('user@example.com');
@@ -30,7 +29,7 @@ test('descriptive test name', async (context) => {
 ```
 
 <Tip>
-  The preset handles all setup and cleanup automatically - no need for manual browser management!
+  The TestDriver hook handles all setup and cleanup automatically - no need for manual browser management!
 </Tip>
 
 ## Finding Elements

package/docs/v7/presets/chrome.mdx

@@ -16,7 +16,7 @@ The `chrome()` preset automatically sets up a Chrome browser with TestDriver and
   import { TestDriver } from 'testdriverai/vitest/hooks';
   
   test('my test', async (context) => {
-    const testdriver = TestDriver(context);
+    const testdriver = TestDriver(context, { headless: true });
     await testdriver.provision.chrome({ url: 'https://example.com' });
     // ...
   });
@@ -29,12 +29,12 @@ The `chrome()` preset automatically sets up a Chrome browser with TestDriver and
 
 ```javascript
 import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('login test', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com/login'
-  });
+  const testdriver = TestDriver(context, { headless: true });
+  
+  await testdriver.provision.chrome({ url: 'https://myapp.com/login' });
   
   await testdriver.find('email input').type('user@example.com');
   await testdriver.find('password input').type('password123');
@@ -98,12 +98,12 @@ chrome(context, options): Promise<ChromeResult>
 
 ```javascript
 import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('search functionality', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://example.com'
-  });
+  const testdriver = TestDriver(context, { headless: true });
+  
+  await testdriver.provision.chrome({ url: 'https://example.com' });
   
   await testdriver.find('search input').type('TestDriver');
   await testdriver.find('search button').click();
@@ -115,13 +115,12 @@ test('search functionality', async (context) => {
 
 ```javascript
 import { test, expect } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('checkout flow', async (context) => {
-  const { testdriver, dashcam } = await chrome(context, {
-    url: 'https://shop.example.com',
-    maximized: true
-  });
+  const testdriver = TestDriver(context, { headless: true });
+  
+  await testdriver.provision.chrome({ url: 'https://shop.example.com' });
   
   // Add items to cart
   await testdriver.find('Add to Cart button').click();
@@ -149,22 +148,20 @@ test('checkout flow', async (context) => {
 
 ```javascript
 import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('windows chrome test', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com',
-    os: 'windows'
-  });
+  const testdriver = TestDriver(context, { headless: true, os: 'windows' });
+  
+  await testdriver.provision.chrome({ url: 'https://myapp.com' });
   
   await testdriver.find('Start').click();
 });
 
 test('mac chrome test', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com',
-    os: 'mac'
-  });
+  const testdriver = TestDriver(context, { headless: true, os: 'mac' });
+  
+  await testdriver.provision.chrome({ url: 'https://myapp.com' });
   
   await testdriver.find('Start').click();
 });
@@ -174,13 +171,12 @@ test('mac chrome test', async (context) => {
 
 ```javascript
 import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('quick test without recording', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://example.com',
-    dashcam: false // Disable Dashcam for faster execution
-  });
+  const testdriver = TestDriver(context, { headless: true, dashcam: false });
+  
+  await testdriver.provision.chrome({ url: 'https://example.com' });
   
   await testdriver.find('button').click();
 });
@@ -190,13 +186,14 @@ test('quick test without recording', async (context) => {
 
 ```javascript
 import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
 test('chrome extension', async (context) => {
-  const { testdriver } = await chrome(context, {
+  const testdriver = TestDriver(context, { headless: true });
+  
+  await testdriver.provision.chrome({ 
     url: 'chrome://extensions',
-    guest: false, // Need profile for extensions
-    maximized: true
+    guest: false // Need profile for extensions
   });
   
   await testdriver.find('Developer mode toggle').click();
@@ -226,9 +223,9 @@ At test end:
 
 ```javascript
 test('user registration', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com/register'
-  });
+  const testdriver = TestDriver(context, { headless: true });
+  
+  await testdriver.provision.chrome({ url: 'https://myapp.com/register' });
   
   await testdriver.find('email field').type('user@example.com');
   await testdriver.find('password field').type('SecurePass123!');
@@ -244,9 +241,9 @@ test('user registration', async (context) => {
 
 ```javascript
 test('multi-page navigation', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com'
-  });
+  const testdriver = TestDriver(context, { headless: true });
+  
+  await testdriver.provision.chrome({ url: 'https://myapp.com' });
   
   // Navigate through pages
   await testdriver.find('About link').click();
@@ -265,9 +262,9 @@ test('multi-page navigation', async (context) => {
 ```javascript
 test('handles errors gracefully', async (context) => {
   try {
-    const { testdriver } = await chrome(context, {
-      url: 'https://myapp.com'
-    });
+    const testdriver = TestDriver(context, { headless: true });
+    
+    await testdriver.provision.chrome({ url: 'https://myapp.com' });
     
     await testdriver.find('non-existent element').click();
   } catch (error) {