craftdriver 0.2.1 → 1.0.0

package/docs/keyboard-mouse.md

@@ -98,22 +98,35 @@ await browser.keyboard.press('Backspace');
 
 ## Mouse
 
-Access the mouse API via `browser.mouse`.
+Access the mouse API via `browser.mouse`. `click()`, `move()`, and
+`dragAndDrop()` all accept a `Target`: a CSS selector string, a `By`
+locator, or `{ x, y }` coordinates.
 
-### click(x, y)
+### click(target, options?)
 
-Click at specific coordinates.
+Click at coordinates or on an element.
 
 ```typescript
-await browser.mouse.click(100, 200);
+await browser.mouse.click({ x: 100, y: 200 });
+await browser.mouse.click('#submit');
+await browser.mouse.click('#submit', { button: 'right', clickCount: 2 });
 ```
 
-### move(x, y)
+### dblclick(target, options?)
 
-Move the mouse to coordinates.
+Double-click at coordinates or on an element (shorthand for `click(target, { clickCount: 2 })`).
 
 ```typescript
-await browser.mouse.move(150, 300);
+await browser.mouse.dblclick('#item');
+```
+
+### move(target, options?)
+
+Move the mouse to coordinates or over an element.
+
+```typescript
+await browser.mouse.move({ x: 150, y: 300 });
+await browser.mouse.move('#target');
 ```
 
 ### down()

package/docs/session-management.md

@@ -213,7 +213,7 @@ async function testLoginPersistence() {
 | `includeCookies`        | `boolean`  | `true`  | Include cookies in saved state |
 | `includeLocalStorage`   | `boolean`  | `true`  | Include localStorage           |
 | `includeSessionStorage` | `boolean`  | `false` | Include sessionStorage         |
-| `origins`               | `string[]` | all     | Limit to specific origins      |
+| `origins`               | `string[]` | all     | Filter localStorage/sessionStorage capture by origin. Capture is always scoped to the page's *current* origin — this only decides whether that one origin is included, it does not collect storage from other origins the page hasn't visited. Cookies are unaffected by this option. |
 
 ### SessionStateManager (browser.storage)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "craftdriver",
-  "version": "0.2.1",
+  "version": "1.0.0",
   "description": "Modern WebDriver automation library for NodeJS",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,6 +17,8 @@
     "test:firefox": "BROWSER_NAME=firefox HEADLESS=true vitest run --maxWorkers=2",
     "test:chrome": "BROWSER_NAME=chrome vitest run",
     "test:chromium": "BROWSER_NAME=chromium vitest run",
+    "bench": "HEADLESS=true vitest run --config vitest.perf.config.ts",
+    "bench:realapp": "HEADLESS=true vitest run --config vitest.perf.realapp.config.ts",
     "clean": "rimraf dist",
     "serve": "http-server ./examples -a 127.0.0.1 -p 8080 -c-1 --cors",
     "examples:start": "npm run serve",
@@ -87,6 +89,7 @@
   "overrides": {
     "brace-expansion": "5.0.6",
     "ip-address": "10.1.1",
+    "npm": "^11.18.0",
     "undici": "7.28.0"
   }
 }

package/skills/craftdriver/SKILL.md

@@ -1,7 +1,8 @@
 # craftdriver — SKILL
 
-Modern BiDi-first WebDriver library for Node.js. Playwright ergonomics,
-WebDriver standards-compliance, no AI in the hot path.
+Modern WebDriver library for Node.js — picks the fastest correct protocol
+(Classic or BiDi) per command. Playwright ergonomics, WebDriver
+standards-compliance, no AI in the hot path.
 
 ## Core loop