@swmansion/argent 0.32.1-next.1 → 0.32.1-next.10

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@swmansion/argent",
3
- "version": "0.32.1-next.1",
3
+ "version": "0.32.1-next.10",
4
4
  "mcpName": "io.github.software-mansion/argent",
5
5
  "description": "MCP server for iOS Simulator and Android Emulator control",
6
6
  "license": "Apache-2.0",
@@ -38,10 +38,14 @@ executionPrerequisite: User is signed in and viewing Settings
38
38
  steps: []
39
39
  ```
40
40
 
41
+ The recorder also writes `version: 1`, the file format version. Keep it. A file without it is version 1, and a version newer than the installed Argent reads is refused.
42
+
41
43
  E2E tests never store a device id. The runner binds the device. `launch:` restarts the process but does not clear app, account, or backend data.
42
44
 
43
45
  The one exception is a device _scope_ rather than a target: `stop-all-simulator-servers`' `devices` list **is** kept in the YAML, because without it the step means the machine-wide sweep and would tear down devices other agents are mid-session on. Replay rebinds a recorded scope only when you pass `device` explicitly: an auto-detected device would retarget the teardown at a device the test never named. So the recorded ids are what run when you replay without `device`; on another host they reap nothing and come back in `unmatched`, so re-record the cleanup test there or pass `device`. A step that recorded no scope is narrowed onto the run's device **only when the run resolved one**. A cleanup test whose only step is that teardown needs no device, so with none or several booted it resolves none, replays as the machine-wide sweep, and still reports a pass. Record the scope, or pass `device` at replay, whenever the sweep must stay confined.
44
46
 
47
+ A top-level `requires:` block limits the targets a test runs on: `platform` (`ios`, `android`, `chromium`, `vega`, or a list; `ios` covers a remote simulator) and `runtimeKind` (`tv` or `mobile`). Add it for a platform-specific or TV-specific scenario. A directory run skips a test whose target does not match; a `run:` fragment that does not match fails its step.
48
+
45
49
  ## Selectors
46
50
 
47
51
  Use values that meet the [stable-selector definition](../SKILL.md#stable-selectors). Always write explicit maps:
@@ -195,6 +195,7 @@ e2e-finish-recording { TEST }
195
195
  After meaning-preserving conversion:
196
196
 
197
197
  ```yaml
198
+ version: 1
198
199
  steps:
199
200
  - echo: Restart Acme Notes. Expect Home
200
201
  - launch: com.acme.notes
@@ -15,9 +15,9 @@ description: Control and inspect TV apps via argent, Apple TV (tvOS), Android TV
15
15
 
16
16
  ## The navigation loop
17
17
 
18
- 1. `describe`: find the cursor and your target (returns the focused element + all focusable ones, not a tap tree).
19
- 2. `tv-remote`: move focus toward the target. Prefer **one** call with a path ending in `select`, e.g. `{button:["down","right","select"]}`; count rows/columns from the frames to build the path.
20
- 3. `describe` again to confirm. On a miss, repeat.
18
+ 1. `describe`: find the cursor and your target.
19
+ 2. `tv-remote`: move focus toward the target. Prefer **one** call with a path ending in `select`, e.g. `{button:["down","right","select"]}`; count rows/columns from the list order.
20
+ 3. `describe` again to confirm, or on Apple TV `await-ui-element {condition:"exists", selector:{text:"X", role:"focused"}}`. On a miss, repeat.
21
21
 
22
22
  ## Tools
23
23
 
@@ -29,7 +29,7 @@ description: Control and inspect TV apps via argent, Apple TV (tvOS), Android TV
29
29
 
30
30
  ### Apple TV (tvOS simulator)
31
31
 
32
- - Boot like any iOS sim (`boot-device`); the AX + HID daemons auto-start on the first `describe` / `tv-remote` (first call may take a few seconds).
32
+ - Boot like any iOS sim (`boot-device`); the first `describe` / `tv-remote` starts the AX + HID daemons (a few seconds).
33
33
  - Dev build: `open-url {udid, url:"<scheme>://expo-development-client/?url=http%3A%2F%2F<HOST_IP>%3A8081"}` (`<HOST_IP>` = your Mac's LAN IP, shown on the launcher).
34
34
 
35
35
  ### Android TV (leanback emulator)