prowl-tools 0.1.7 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -384,7 +384,20 @@ macOS target (with a clear error), and `prowl login` / URL guardrails do not app
384
384
  | `assert: visible` / `notVisible` | `evalScript`, `runScript` |
385
385
  | `screenshot`, `assertScreenshot` | `onDialog`, `select` / `selectOption` |
386
386
  | `hover`, `scrollTo` | `setInputFiles`, `waitForDownload` |
387
- | `repeat`, `if`, `runHunt`, `copyText` | `scroll` (directional), `assert: urlIncludes` / `urlEquals` |
387
+ | `repeat`, `if`, `runHunt`, `copyText` | `scroll` (directional; see below) / `assert: urlIncludes` / `urlEquals` |
388
+
389
+ **Scroll steps** differ per verb across targets:
390
+
391
+ - **`scrollTo: { selector }`** is portable across **web, macOS, iOS, and Android**. macOS
392
+ resolves the element and calls **AXScrollToVisible**; iOS/Android run a bounded down/up
393
+ swipe probe until the element appears; web scrolls the element into view.
394
+ - **`scroll: { direction, amount? }`** (directional) runs on **web, iOS, and Android** but is
395
+ **rejected on macOS** — the mobile path synthesizes a touch swipe (no macOS accessibility
396
+ equivalent), so on macOS use `scrollTo` to bring a specific element into view instead. On
397
+ the mobile targets the swipe starts from the screen centre (direction semantics match the
398
+ web step; `amount` maps to the swipe distance in device points, defaulting to 75% of the
399
+ relevant screen axis; negative amounts reverse direction, matching the web target). An
400
+ explicit `swipe` step is a deferred follow-up.
388
401
 
389
402
  Notes: `press` accepts the same key vocabulary as the web target — single printable
390
403
  characters, `Enter`/`Return`/`Space`, `Tab`, `Escape`, `Backspace`, `Delete`, `Home`,