@unotest/web 0.50.0 → 0.51.0

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/CHANGELOG.md CHANGED
@@ -1,9 +1,116 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.51.0] - 2026-10-15
4
+
5
+ ### Minor Changes
6
+
7
+ - c9dfb29: New: `animations(getByTestId('status'))` returns every animation of the element and its descendants as `[{name, kind, playState, currentTime?, infinite}]`, the typed read of what is moving and how. replaces: evaluateOnLocator with getAnimations. `name` is the keyframes name, the property a transition moves, or a script animation's id. Infinite and paused animations are listed too, marked by `infinite` and `playState`; `hasAnimation` and `waitForAnimations` count only the running ones that end by themselves, as before.
8
+ - 7ffd47b: New: `npx @unotest/web api [word...]` finds the DSL function for what you mean. replaces: searching the reference by a name you do not know yet. It prints one line per function: signature, the keys its options take, the release that added it, and when you need it. Search by the habit you know: `api wait animation` gives waitForAnimations, `api not appear` gives assertNeverAppears, `api sleep` gives pause; every word must match the name, a synonym or the description. Without a word it lists every function by section. The same index ships as `llms.txt` at the package root and as the first screen of the README, "What unotest can do".
9
+ - 81a97d6: New: `apiCall('POST', '/live/start', body, null, {timeoutMs: 150000})` gives one call a budget of its own, the reply body included. replaces: nothing (a call waited as long as the step and the test allowed, and `{timeout}` was refused). Past the budget the request is aborted and the step fails as a timeout naming the call by method and path, without the base or the query. Without `{timeoutMs}` a call behaves as before. It combines with `{base}` in the same options object.
10
+ - 17f4bc2: New: `assertFileLacks('logs', API_TOKEN)` and `assertFileHas('tmp/dump.sql', /v1:[A-Za-z0-9+\/=]{20,}/)` check that a string or a regex is absent from, or present in, a file or a whole directory tree. replaces: shell with grep after the run, outside the report. A string is searched as bytes, so binary files count; a regex reads files as UTF-8. `assertFileHas` waits up to `{timeoutMs}` (default 20 s). `assertFileLacks` searches once, or watches `{withinMs}`, and a path that does not exist fails rather than passes. A hit names the file and the line, with the matched bytes replaced by `‹match, N bytes›`, so a regex that catches an unregistered secret does not copy it into the report. Paths follow the same rules as `readFile`; symlinks inside a directory are not followed.
11
+ - 6ea4085: New: `assertNever(() => apiCall('GET', '/me').status == 200, {withinMs: 5000})`, a negative window for a condition, the pair of `assertNeverAppears` for anything that is not a locator. replaces: pause. The body (an expression, or a block that `return`s its value) is polled for the whole window; the step fails the moment it is truthy, naming the value and the time into the window, and passes when the window elapsed clean. `pause(ms)` followed by one assertion misses an event that came and went during the pause. `withinMs` is required, `intervalMs` defaults to 250. A malformed call is reported under the new validator rule `validator:assert-never-shape`. A suite function of its own named `assertNever` keeps running as before.
12
+ - 45dbd8b: New: `assertClipboard(/\/invite\/\d+$/)` waits until the clipboard holds the text a "copy" button wrote, and `clipboardRead()` returns that text. replaces: evaluate replacing navigator.clipboard.writeText in the page. A string is the whole text, a regex a match; `{timeoutMs}` defaults to 5 s. Works in Chromium and Firefox on an https or localhost page. WebKit does not let a page read the clipboard, and the call fails naming the engine instead of returning an empty string. In Chromium every new browser context now has clipboard read and write access, so a page's own copy button succeeds in a headless run, as it does for a person in desktop Chrome. The clipboard belongs to the browser, so tests running in parallel in one browser share it.
13
+ - ac8f70a: BREAKING: a DSL call now checks, when it runs, the kind of every argument lint could not see: a variable, a field of an API reply, a value built in a loop. One of another kind stops the step on its line with the sentence lint shows for a literal: `fill(): argument 2 (text) must be a string value, got number 42`, `click(): option timeoutMs must be a number, got a string "5000"`. Before, some functions refused such a value in words of their own and some coerced it: `getByText('Total', {exact: e})` with `e` holding the string `"no"` matched exactly and failed seconds later as `locator not visible within timeout`. A condition is still read by truthiness, so only a number, a string or a locator passed as one is refused. Where a client's suite relied on a coercion, the call still runs with a warning ending in `an error from 0.52.0`.
14
+
15
+ Migration: convert the value where it is made, `String(total)` for text, `Number(env('WAIT_MS'))` for a time limit, a comparison for a condition. Run the suite once and fix every line the run stops on or warns about.
16
+
17
+ Changed: lint now checks `setViewport` and `emulateMedia` arguments before the run, as the run already did: a misspelt key (`{heigth}`), a value `emulateMedia` does not take (`{colorScheme: 'blue'}`) or anything but a size or `null` for `setViewport` is named on its line. The editor types follow: `setViewport(size: {width, height} | null)`, and `emulateMedia` offers its values.
18
+
19
+ Signatures, the API index (`npx @unotest/web api`, `llms.txt`) and the DSL reference now name the time limit `timeoutMs`, the key the option lists and refusals already used. `timeout` still works as an alias; the index marks it once per function: `options {state?, timeoutMs?} (alias: timeout → timeoutMs)`. Signatures that missed keys their function takes now list them (`waitUntil` on goBack, goForward and waitForUrl; `force` on selectOption; `position` and `modifiers` on doubleClick), and `waitForText` no longer offers `first`, which has been refused since 0.50.0.
20
+
21
+ The DSL reference has a Signatures section: every function with the types it takes, generated from the same contract lint and the run check against, so it cannot drift from them.
22
+
23
+ Changed: `waitUntil` (goto, reload, goBack, goForward, waitForUrl) takes `'load'`, `'domcontentloaded'`, `'networkidle'` or `'commit'`, and lint and the run name a misspelt one on its line: `goto(): option waitUntil must be one of: load, domcontentloaded, networkidle, commit`. Before, it reached the browser, which failed the step with its own message. The reference now lists `'commit'` and the editor offers the four values.
24
+
25
+ `@unotest/dsl`: the argument kind `'null'`, for a slot that takes `null` as one member of a `{oneOf}`; `hint` on an argument, a sentence lint and the run append to a refused value (`round(): argument 1 (n) must be a number, got a string "2.5" — read text with toNumber(text) first`), and option notes appended the same way to a key's refused value; `canonicalOptionKeys`, the keys of an options schema without their aliases.
26
+
27
+ - 1c16eba: New: a `collection` run says how long it took. The summary line ends with the wall clock of the whole run, every worker at once — `collection regress: failed — pass=21, fail=1, time=252.3s` — and each test of a file of several gets its own time beside its name, as the file's line already had: `✓ test_checkout (812ms)`. replaces: wrapping the run in `time` and adding up the per-file lines. The collection's journal carries the same total on its last line (`durationMs`), and each test's time in the file's entry, for whatever reads the run afterwards.
28
+ - 809c738: New: MCP tool `dsl_lookup({task: 'wait until the dialog stops animating'})` answers "how do I" in plain words with the 1-3 DSL functions for it, best first: signature, option keys, the release that added it, one example line and where the shipped guide describes it. replaces: guessing a function name, or writing pause, page code or shell for a step the language already has. Words no function holds return none and a hint. It is part of the core toolset too. The answers come from the same index as `npx @unotest/web api`, which now also matches a longer form of a word (`animating` finds waitForAnimations).
29
+ - cb1161b: New: `lint:external-variable-no-value` reports a variable that only `unotest/.env.example` or `.secrets.example` declares while no file, overlay or the shell gives it a value. replaces: `lint:external-variable-undeclared` for that case, whose text sent the author to add a name that was already declared. The message names the template and where to set the value: `unotest/.env`, the active overlay, or the shell. A run reports it (`run_test`, the pre-run check of `e2e`); the `lint` command reads files alone and counts a template name as declared, so a value a CI runner exports does not turn it red. `lint:external-variable-undeclared` now means a name no file declares at all.
30
+
31
+ Fixed: the run header lists only the files values come from, in order, and names `.env.example` / `.secrets.example` apart as `declared names only`; a placeholder value in a template never reaches the run.
32
+
33
+ - 8b70693: New: config key `profile: "ios"` runs the suite in WebKit as an iPhone (the `"iPhone 15"` preset: size, scale, touch, mobile mode, user agent) launched from the home screen, in one line; `browsers` or `device` next to it is refused. replaces: `browsers: ["webkit"]` with `device` and a page-side `navigator.standalone` stub. Config key `displayMode: 'browser' | 'standalone' | 'minimal-ui' | 'fullscreen'` sets the launch mode the page's scripts see from the first document on: `matchMedia('(display-mode: standalone)')` answers for it, and in WebKit `navigator.standalone` is `true`. No engine emulates the feature itself, so CSS `@media (display-mode: …)` still sees a browser tab. Playwright WebKit is not Safari on iOS: no zoom on focus, no on-screen keyboard.
34
+ - 7630fbf: New: linter rule `lint:typed-step-available` (info) names the typed step for code a scenario wrote by hand, e.g. `pause(5000); assertHidden(getByText('Error'))` → `assertNeverAppears(getByText('Error'), {withinMs: 5000})`. replaces: pause before an absence check, pause to let an animation settle, evaluate with getComputedStyle, evaluate with naturalWidth.
35
+
36
+ It reports `getComputedStyle` in page code (use `computedStyle(locator, property)`), `naturalWidth` / `complete` (use `getImageSize(locator)`), a `pause` before `assertHidden` or `assertCount(…, 0)` (use `assertNeverAppears(locator, {withinMs})`), and a `pause` whose step label or comment mentions a fade, an animation or a control being enabled (use `waitForAnimations(locator)` or `waitFor(locator, {state: 'enabled'})`). Each message names the section of `node_modules/@unotest/web/guides/dsl-reference.md` that describes the step. Set the rule to `off` in `linter.rules` to silence it.
37
+
38
+ - 099b79f: New: MCP client steps — a scenario starts a stdio MCP server, calls its tools and waits for its notifications: `const srv = mcpStart('node', ['server.js']); mcpCall(srv, 'echo', {text: 'hi'}); mcpWaitNotification(srv, 'notifications/message', {match: {'data.echoed': 'hi'}})`. Every call, result and notification is a note in the run's report; a failing step (JSON-RPC error, timeout, a result marked `isError` unless `{allowError: true}`, the server exiting) quotes the server's last MCP message, so the failure bundle shows it. `mcpStop(srv)` is optional: a server the test leaves running is stopped when the test ends, passed or failed. `env` passed to `mcpStart` is named in the report, never its values. replaces: bun scripts next to the suite.
39
+ - 355f512: BREAKING: page code given to `evaluate`, `evaluateOnLocator` or `evaluateInServiceWorker` as a string is now parsed by the validator. A string that is not one JavaScript expression is refused before the run as `validator:page-code-syntax`, with the line and column inside the string, e.g. `evaluateOnLocator(locator('body'), '(b) => b.querySelectorAll("li").')`. Such a step used to fail only when the run reached it.
40
+
41
+ A string that parses gets an info, `validator:page-code-string`, with the rewrite to a function literal: a function in quotes loses the quotes, an expression becomes `() => …`. A function literal is checked with the file. Text built with `+` or held in a variable is not parsed.
42
+
43
+ Migration: fix the syntax the message points at, or write the page code as a function literal: `evaluateOnLocator(loc, (el) => el.textContent)`. A regular expression inside a backtick template is a common case: `\/` there reads as `/`, so `` `… /^a\/(b)/ …` `` reaches the page as an unterminated group — the step failed at run time already, now it is named before the run. Write `\\/` or use `` String.raw`…` ``. Set `validator:page-code-string` to `off` in `linter.rules` to silence the info.
44
+
45
+ - 10551d7: New: `setPageHidden(hidden, index?)` sends a tab to the background as the page's scripts see it, and brings it back. `setPageHidden(true)` makes `document.hidden` true and `visibilityState` `'hidden'`, `document.hasFocus()` false, and fires `blur` then `visibilitychange`; `setPageHidden(false)` fires `visibilitychange` then `focus`. The state holds across navigations and in frames until the tab is shown again. replaces: overriding `document.hidden` by hand in `evaluate`, or handing the check to a person.
46
+
47
+ It emulates visibility for the page's scripts in Chromium, Firefox and WebKit alike — no engine hides a tab of a headless browser. What the browser itself does to a background tab is not emulated: timers are not throttled, animation frames keep running, the page is not frozen, and a service worker's `clients.matchAll()` still reports it visible. `setPage` and `bringToFront` do not show a hidden tab.
48
+
49
+ - a081f17: New: `TestRuntimeManager.inspectState(id)` returns a runtime's snapshot without `vars` — state, last event, failure, result, rollback — and does not walk the scenario's variables. replaces: `inspect(id)` for callers that never read `vars`. Example: `manager.inspectState(id).lastResult`. `inspect(id)` is unchanged and still returns the whole snapshot. The runner's own polls now use it, so a paused or running test builds its variables once per tick instead of three times.
50
+ - c63e688: New: `selectOption(getByLabel('Folder'), {label: 'Archive'})` picks an option by its visible text, and `{index: 0}` by its position, next to the value forms (a string, `{value}`, or an array for a multi-select). replaces: evaluateOnLocator reading an option's value by its text. The call waits for the option; a label or index no option has fails naming the labels the element holds instead of a bare timeout. The validator now checks the value: a misspelt key such as `{lable}` is `validator:options`, before the run and during it, and a number is `validator:arg-kind`. The `explore_step` MCP tool takes the same forms for `select_option`.
51
+ - ceaf212: New: virtual machine steps over Tart — a scenario clones a ready image, boots it and reaches it by IP: `skip('no tart', !vmAvailable()); const vm = vmClone('clean-mac'); const ip = vmRun(vm);`. Each VM is named `unotest-<id>-<n>`, the id random per test, so parallel runs never meet; every VM the test cloned is stopped and deleted when it ends, passed or failed. `vmIp`, `vmStop` and `vmDelete` take only a name `vmClone` returned in the same test — other VMs on the machine are refused, never touched. A boot that fails errors `vmRun` at once with Tart's output instead of waiting out the timeout (default 180 s). Clone and boot are notes in the run's report. replaces: tart by hand.
52
+ - 9e742ac: New: terminal steps drive a real Terminal.app or iTerm2 window on macOS: real key events, the screen read as text, the window framed — `openTerminal('Terminal'); terminalType('my-cli'); terminalPress('Shift+Enter'); terminalWaitForText(/ready/)`. replaces: osascript and expect outside unotest.
53
+
54
+ `openTerminal(app, {host})` opens the window on this Mac, or on another Mac over ssh (`{host: 'admin@192.168.64.38'}`, a Tart VM) through a controller it starts in that Mac's logged-in session; the key comes from your ssh agent or `~/.ssh`. The steps: `openTerminal`, `setTerminal`, `closeTerminal`, `terminalType`, `terminalPress`, `terminalWaitForText`, `terminalAssertText`, `terminalResize`, `terminalScreenshot`. Each lands in the run report like a page step, and a failed test keeps the window's last frame, its screen text and its host in the failure bundle (`terminal.png`, `terminal.txt`, `terminal.json`). Every window a test opened is closed when it ends. A local run takes the keyboard while it types; keys are sent only while the terminal window is in front.
55
+
56
+ - 02e6384: New: `npx @unotest/web upgrade-hints` finds the places in `unotest/e2e/` that do by hand what a typed step does. replaces: reading `lint` info lines one file at a time. It prints the count per pattern, the step to write instead with its section in the DSL guide, and every file and line: a `pause` before checking that an element is absent (`assertNeverAppears`), a `pause` to let an animation settle (`waitForAnimations`) or a control become enabled (`waitFor {state: 'enabled'}`), `getComputedStyle` or `naturalWidth` in page code (`computedStyle`, `getImageSize`), and page code written as a string (a function literal). It shows these rows even when `linter.rules` turns their rule off; a line marked `// lint-ok` is not counted. The first run on a new version shows the counts once: `e2e` prints them, and the MCP `run_test` reply carries them as `upgradeHints` {state: "typed-steps-available", version, hints, next}.
57
+ - bff95c9: BREAKING: `waitForRequest` with a `ws://` or `wss://` mask is refused before the run as `validator:arg-kind`, and by the run, with `WebSockets are not requests: use waitForWebSocket`. A socket's upgrade is no request and the page's request events never see it, so such a wait used to spend its whole timeout and fail.
58
+
59
+ Migration: `waitForRequest('ws://…')` → `waitForWebSocket('ws://…')`.
60
+
61
+ - 52cf309: New: `waitForWebSocket(glob, {timeoutMs?}) → {url}` waits until the active page has opened a WebSocket whose URL matches the mask and returns its URL. A socket the page opened as it loaded counts, so the wait may come after it; a new document starts the list again. A timeout names the mask and the sockets the page did open. replaces: `waitForRequest` on a socket mask, which waited its whole timeout and never saw the socket.
62
+
63
+ Changed: `mockRoute` with a `ws://` or `wss://` mask runs as before and is named with a warning, since it has never had an effect. The reference no longer says a mask reaches WebSockets.
64
+
65
+ `@unotest/dsl`: `refuse` on an argument, strings of the right kind the slot still turns down by how they start, with a sentence and an error or warning level; `refusalMessage`, the text lint and the run give for one.
66
+
67
+ - 80ff1fa: New: `addVirtualAuthenticator()` gives the page a passkey with no person at a device: a virtual WebAuthn authenticator answers `navigator.credentials.create()` and `.get()`. `virtualCredentials(id)` lists what it holds, by base64url id, rpId and sign count, and `removeVirtualAuthenticator(id)` takes it off. replaces: signing in with a passkey by hand in your own browser. Chromium only; Firefox and WebKit fail the call naming the engine. New: `grantPermissions(['notifications'], {origin?})` grants browser permissions to the context; a name the engine does not know fails naming the engine, and earlier grants stay. `setOffline(true)` cuts the context off the network and `setOffline(false)` connects it again. replaces: nothing. Authenticators, permissions and offline are all undone when the context closes.
68
+
69
+ ### Patch Changes
70
+
71
+ - 85c9f78: New: `@unotest/dsl/validator` exports `chainReceiverIsArgument(contract)`: whether a chained call of a vocab method gets the receiver as its first argument. replaces: repeating the rule next to the validator. A chain step such as `filter` declares the receiver in its signature. A chainable builder such as `getByRole` keeps the arguments as written. The validator and tools that read a scenario line arguments up by this one rule.
72
+ - 6cd513a: Changed: `dsl_lookup` and `npx @unotest/web api` weigh each word of a query by how few functions hold it, so a rare word decides over common ones: "send the tab to the background and back" now finds `setPageHidden` first instead of `newPage`, `goBack` and `dragAndDrop`. A word that names an option key exactly (`hasNot`, `waitUntil`) counts for the functions that take it: "locator that contains a child element (has, hasNot)" finds `filter` and `locator`. New search words: `background`, `visibility` and `tab hidden` for `setPageHidden`, `faded in` for `waitForAnimations`.
73
+ - f136ad0: Fixed: the refusal of `new X(…)` names the constructors the library has — `new X(…) is not part of the scenario language — use new Map / new Set, the constructors the library has; for anything else …` — so `new Set([1])` running beside a refused `new Error('x')` reads as one rule. The DSL reference and the language page list the constructors from the library itself, and the check that keeps the editor typings fresh keeps that list fresh too.
74
+ - 8d7770d: Fixed: `validator:template-escape-changed` no longer warns on an escape already migrated. It now reports only a backslash escape JavaScript drops — `\s` reads as `s`, `\.` as `.` — the regex text a backtick template used to keep and now silently loses. `\\s`, `\n`, `A` and the other escapes JavaScript reads as meant stay quiet, so doubling the backslash clears the warning without `String.raw` or switching the rule off.
75
+ - 4dec5fc: Fixed: `openTerminal` on a freshly booted macOS VM no longer fails now and then with "Terminal.app cannot be opened … is someone logged in?". The VM answers ssh before its automatic login has made the GUI session; the step now waits for that session (up to 90 s) instead of a fixed 15 s for a single attempt. An image that logs no one in fails the step with what was waited for and how long.
76
+
77
+ Fixed: when `openTerminal(app, {host})` cannot log in to a VM with a key, the hint now gives the commands for the image the VM was cloned from (`tart run <image> &`, `ssh-copy-id admin@$(tart ip --wait 120 <image>)`, `tart stop <image>`) instead of an `ssh-copy-id` to the clone's address, which the run has already deleted, and says that `ssh-copy-id` asks for the image's password.
78
+
79
+ - 7770b39: Fixed: `terminalType` typed the letters of the Mac's current keyboard layout, so under a Russian or another non-US layout the terminal got different text (`clear` arrived as the Cyrillic letters on the same keys). Text now goes in as a paste, line by line with Return between the lines, and the clipboard is restored after. Each line must show on the screen within 2 s, or the step fails quoting the screen's last rows instead of typing on blind; `terminalType(password, {echo: false})` types input a program does not echo. `terminalPress` with a modifier (`Control+c`) presses that key of a US keyboard whatever the layout; a single character alone is pasted, and a character with a modifier but no US key of its own (`Control++`) is refused, naming the key to press (`Control+Shift+=`).
80
+ - bed0e59: Fixed: `openTerminal(app, {host})` on a VM whose image does not hold your ssh key failed with ssh's bare `Permission denied`. It now says that ssh could not log in with a key, and how to put the key in the image once (`ssh-copy-id admin@<ip>` on a booted clone, then stop it) or load it into the ssh agent. The DSL reference shows that one-time step under "Virtual machines": a clean Tart image takes a password only, and the run never passes one.
81
+ - 78ece21: Fixed: `throw new Error('x')` in a scenario is refused with the throw the language has — `throw 'x'` or `throw {message: 'x'}` — instead of the general `new X(…)` advice about object literals and regex literals, in `lint` and in the run alike.
82
+ - 5cfd9b1: Fixed: `lint:typed-step-available` reads page code written as a string too. `evaluate("getComputedStyle(document.body).color")` now gets the hint for `computedStyle(locator, property)` in the same pass as the `validator:page-code-string` info, instead of only after the string was rewritten as a function. Text that does not parse, or that is built at run time, is not read.
83
+ - b613552: New: `e2e` and `lint` in a project without `unotest/jsconfig.json` say once, in one line, to run `npx @unotest/web types`, which writes it so the editor completes the scenario functions. replaces: finding the `types` command on your own. A run still writes no jsconfig itself; the hint is not shown under CI or on a box (`UNOTEST_EDITOR_TYPES=0`), and the project's `.unotest/` remembers it was shown.
84
+ - 54fc118: Changed: the `waitUntil` reference and the Playwright migration guide say where state between tries lives. replaces: a counter declared at the top of the file, which never runs. A counter or the last value seen is a `let` inside the `test_` function or the step, and the body writes it; a top-level `let` is refused by the validator (`validator:unsupported-statement`) and the body then finds no such variable.
85
+ - Updated dependencies [6ea4085]
86
+ - Updated dependencies [ac8f70a]
87
+ - Updated dependencies [1c16eba]
88
+ - Updated dependencies [85c9f78]
89
+ - Updated dependencies [f136ad0]
90
+ - Updated dependencies [355f512]
91
+ - Updated dependencies [c63e688]
92
+ - Updated dependencies [8d7770d]
93
+ - Updated dependencies [78ece21]
94
+ - Updated dependencies [5cfd9b1]
95
+ - Updated dependencies [52cf309]
96
+ - @unotest/dsl@0.51.0
97
+ - @unotest/protocol@0.51.0
98
+ - @unotest/viewer@0.51.0
99
+ - @unotest/core@0.51.0
100
+ - @unotest/grounder-client@0.51.0
101
+
3
102
  ## [0.50.0] - 2026-10-14
4
103
 
5
104
  ### Minor Changes
6
105
 
106
+ - Breaking, added after the release: `apiCall` takes at most five arguments: method, path, body, headers and options. 0.49.2 dropped a sixth one without a word, so a call such as `apiCall('GET', '/status', null, {}, {base: 'API_BASE'}, {timeout: 120000})` ran as if the sixth were not there. 0.50.0 refuses it: `apiCall() takes at most 5 arguments, got 6 — remove the extra argument`, and the test ends errored.
107
+
108
+ Migration: remove the sixth argument. The call never read it, so it behaves as it did in 0.49.2. A per-call timeout for `apiCall` is a separate feature of a later release.
109
+
110
+ - Breaking, added after the release: a backslash escape in a backtick template now means what it means in JavaScript. Before 0.50.0 it was kept as written. The change is silent for page code: `` evaluateOnLocator(loc, `(el) => /\s+/.test(el.textContent)`) `` reaches the page as `/s+/`, the regex looks for the letter `s`, and the check gives a wrong answer with no error. The lint warning `template-escape-changed` marks every such template.
111
+
112
+ Migration: in a template, write a backslash meant for the page as `\\` (`/\\s+/`), or wrap the template in `String.raw` to keep the text as written. Better, pass the page code as a function, `evaluateOnLocator(loc, (el) => /\s+/.test(el.textContent))`: the validator reads it with the file and no escape is involved.
113
+
7
114
  - e176cb4: Scenarios are read by the new JavaScript parser and run by the new interpreter: `run`, `e2e`, `lint`, `explore_run_flow`, the viewer's editor and the bundle checks all go through it.
8
115
 
9
116
  `evaluate` and `evaluateOnLocator` take a function as the page code: `evaluate((n) => document.querySelectorAll('li').length > n, 3)`, `evaluateOnLocator(loc, (el) => el.dataset.state)`. The page gets the function as it is written, like Playwright's `fn.toString()`, so it sees none of the scenario's variables: values go in as the arguments after it. The string form works as before, and the advice of 0.49.2 to pass the function as a quoted string no longer applies. A function anywhere else in a host call is still refused.
@@ -2104,7 +2211,7 @@ picker on` fetches this project's own access and writes the three grounder
2104
2211
 
2105
2212
  That screen named one command:
2106
2213
 
2107
- npx @unotest/web bundle push --run --env ENVIRONMENT
2214
+ npx @unotest/web bundle push --run --env ENVIRONMENT
2108
2215
 
2109
2216
  In a project that has just been created, the command refuses with `no box
2110
2217
  address` before it does anything: the project holds neither the box's address
@@ -2113,8 +2220,8 @@ address` before it does anything: the project holds neither the box's address
2113
2220
 
2114
2221
  The screen now names both steps, in the order they have to happen:
2115
2222
 
2116
- npx @unotest/web box access larch
2117
- npx @unotest/web bundle push --run --env ENVIRONMENT
2223
+ npx @unotest/web box access larch
2224
+ npx @unotest/web bundle push --run --env ENVIRONMENT
2118
2225
 
2119
2226
  The box's own name is filled in when its licence carries one. `box access`
2120
2227
  with no name refuses, and its refusal offers to create a box — to somebody who
package/README.md CHANGED
@@ -12,6 +12,31 @@ Full documentation — manuals, the box, CI, the judge — lives at
12
12
  tour; the package ships only `guides/dsl-reference.md` and
13
13
  `guides/agent-integration.md` alongside it.
14
14
 
15
+ <!-- generated:api-index — generated from the DSL vocabulary (pnpm build:api-index), do not edit -->
16
+ ## What unotest can do
17
+
18
+ Scenarios are JavaScript calling these functions. `npx @unotest/web api <word>`
19
+ prints one line per function — signature, options, the release that added it,
20
+ when you need it — and finds it by the habit you know: `api sleep`,
21
+ `api clipboard`, `api not appear`. The same index ships as `llms.txt` in the
22
+ package; the full reference is at https://docs.unotest.com/reference/dsl/.
23
+
24
+ - **Navigation** — `goto`, `reload`, `goBack`, `goForward`, `waitForUrl`, `waitForNavigation`
25
+ - **Locators** — `locator`, `getByRole`, `getByText`, `getByLabel`, `getByPlaceholder`, `getByAltText`, `getByTitle`, `getByTestId`, `contentFrame`
26
+ - **Refining a locator** — `filter`, `first`, `last`, `nth`, `randomNth`
27
+ - **Actions** — `click`, `doubleClick`, `check`, `uncheck`, `hover`, `scrollIntoView`, `fill`, `press`, `selectOption`, `dragAndDrop`, `uploadFile`, `clipboardPaste`
28
+ - **Waits and the page clock** — `waitFor`, `waitForText`, `waitForCount`, `waitForAnimations`, `pause`, `waitForDownload`, `clockFreeze`, `clockTick`, `clockRun`
29
+ - **Assertions** — `assertText`, `assertTexts`, `assertAttribute`, `assertVisible`, `assertHidden`, `assertNeverAppears`, `assertValue`, `assertCount`, `assertUrl`, `assertJudge`, `assertScreenshot`, `assertEqual`, `assertTrue`, `assertSchema`, `assertFileHas`, `assertFileLacks`, `skip`, `setTestTimeout`
30
+ - **Reading the page and values** — `clipboardRead`, `assertClipboard`, `count`, `textContent`, `texts`, `inputValue`, `isVisible`, `isChecked`, `isDisabled`, `isEnabled`, `hasAttribute`, `computedStyle`, `getImageSize`, `hasAnimation`, `animations`, `randomFirstName`, `randomLastName`, `randomEmail`, `randomText`, `randomWord`, `json`, `textContains`, `textJoin`, `nowMs`, `today`, `daysFromNow`, `textMatches`, `parseJson`, `urlParam`, `toNumber`, `round`, `formatNumber`, `env`
31
+ - **Page state** — `getAttribute`, `getInnerText`, `getInputValue`, `boundingBox`, `getTitle`, `getUrl`, `log`
32
+ - **Storage and cookies** — `setLocalStorage`, `getLocalStorage`, `setCookie`, `getCookie`
33
+ - **Tabs, frames, contexts, extensions** — `setPage`, `waitForPage`, `bringToFront`, `setPageHidden`, `newPage`, `closePage`, `setViewport`, `emulateMedia`, `newContext`, `setContext`, `enterFrame`, `exitFrame`, `addVirtualAuthenticator`, `virtualCredentials`, `removeVirtualAuthenticator`, `grantPermissions`, `setOffline`, `waitForServiceWorker`, `extensionId`, `evaluateInServiceWorker`
34
+ - **Data, files, network, processes** — `shell`, `waitForFile`, `assertNoFile`, `waitForJsonLine`, `assertNoJsonLine`, `readJsonLine`, `readJson`, `readFile`, `readFileInfo`, `waitForFileCount`, `assertFileCount`, `dbQuery`, `dbExec`, `apiCall`, `upload`, `mockRoute`, `unmockRoute`, `waitForRequest`, `waitForWebSocket`, `assertNoRequest`, `openTerminal`, `setTerminal`, `closeTerminal`, `terminalType`, `terminalPress`, `terminalWaitForText`, `terminalAssertText`, `terminalResize`, `terminalScreenshot`, `mcpStart`, `mcpCall`, `mcpWaitNotification`, `mcpStop`, `vmAvailable`, `vmClone`, `vmRun`, `vmIp`, `vmStop`, `vmDelete`
35
+ - **Diagnostics** — `screenshot`, `note`, `consoleEntries`, `pageErrors`, `assertNoConsoleErrors`
36
+ - **Structure** — `step`, `teardown`, `waitUntil`, `assertNever`
37
+ - **Page code (last resort)** — `evaluate`, `evaluateOnLocator`
38
+ <!-- /generated:api-index -->
39
+
15
40
  ---
16
41
 
17
42
  ## 1. Setup
@@ -19,6 +19,10 @@ declare const SYSTEM_BROWSER_CHANNELS: readonly ["chrome", "msedge", "chrome-bet
19
19
  declare const BROWSER_CHANNEL_WORDS: readonly ["chrome", "msedge", "chrome-beta", "chromium", "bundled"];
20
20
  declare const BrowserChannelSchema: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["chrome", "msedge", "chrome-beta", "chromium"]>, z.ZodEffects<z.ZodLiteral<"bundled">, null, "bundled">, z.ZodNull]>>;
21
21
  type BrowserChannel = z.infer<typeof BrowserChannelSchema>;
22
+ /** How the app was launched, as `(display-mode: …)` names it: `standalone`
23
+ * for one added to the home screen. */
24
+ declare const DisplayModeSchema: z.ZodEnum<["browser", "standalone", "minimal-ui", "fullscreen"]>;
25
+ type DisplayMode = z.infer<typeof DisplayModeSchema>;
22
26
  declare const ViewportSchema: z.ZodObject<{
23
27
  width: z.ZodOptional<z.ZodNumber>;
24
28
  height: z.ZodOptional<z.ZodNumber>;
@@ -116,19 +120,19 @@ declare const FailureBundleConfigSchema: z.ZodObject<{
116
120
  type FailureBundleConfig = z.infer<typeof FailureBundleConfigSchema>;
117
121
  declare const DialogPolicySchema: z.ZodEnum<["accept", "dismiss", "manual"]>;
118
122
  type DialogPolicy = z.infer<typeof DialogPolicySchema>;
119
- declare const LinterRuleIdSchema: z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "lint:filter-unknown-option", "lint:role-unknown-option", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format", "validator:const-assign", "validator:teardown-shape", "validator:teardown-name-conflict", "validator:wait-until-shape", "validator:locator-index-access", "validator:chain-receiver", "validator:top-level-const", "validator:string-member-receiver", "validator:unsupported-string-member", "validator:array-member-receiver", "validator:options", "validator:out-of-language", "validator:implicit-declaration", "validator:evaluate-interpolation", "validator:page-code-closure", "validator:template-escape-changed", "validator:library-member", "validator:unknown-member"]>;
123
+ declare const LinterRuleIdSchema: z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:external-variable-no-value", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "lint:filter-unknown-option", "lint:role-unknown-option", "lint:typed-step-available", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format", "validator:const-assign", "validator:teardown-shape", "validator:teardown-name-conflict", "validator:wait-until-shape", "validator:assert-never-shape", "validator:locator-index-access", "validator:chain-receiver", "validator:top-level-const", "validator:string-member-receiver", "validator:unsupported-string-member", "validator:array-member-receiver", "validator:options", "validator:out-of-language", "validator:implicit-declaration", "validator:evaluate-interpolation", "validator:page-code-closure", "validator:page-code-syntax", "validator:page-code-string", "validator:template-escape-changed", "validator:library-member", "validator:unknown-member"]>;
120
124
  type LinterRuleId = z.infer<typeof LinterRuleIdSchema>;
121
125
  declare const LinterSeveritySchema: z.ZodEnum<["off", "warn", "error"]>;
122
126
  type LinterSeverity = z.infer<typeof LinterSeveritySchema>;
123
127
  declare const LinterConfigSchema: z.ZodObject<{
124
128
  enabled: z.ZodBoolean;
125
- rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "lint:filter-unknown-option", "lint:role-unknown-option", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format", "validator:const-assign", "validator:teardown-shape", "validator:teardown-name-conflict", "validator:wait-until-shape", "validator:locator-index-access", "validator:chain-receiver", "validator:top-level-const", "validator:string-member-receiver", "validator:unsupported-string-member", "validator:array-member-receiver", "validator:options", "validator:out-of-language", "validator:implicit-declaration", "validator:evaluate-interpolation", "validator:page-code-closure", "validator:template-escape-changed", "validator:library-member", "validator:unknown-member"]>, z.ZodEnum<["off", "warn", "error"]>>;
129
+ rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:external-variable-no-value", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "lint:filter-unknown-option", "lint:role-unknown-option", "lint:typed-step-available", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format", "validator:const-assign", "validator:teardown-shape", "validator:teardown-name-conflict", "validator:wait-until-shape", "validator:assert-never-shape", "validator:locator-index-access", "validator:chain-receiver", "validator:top-level-const", "validator:string-member-receiver", "validator:unsupported-string-member", "validator:array-member-receiver", "validator:options", "validator:out-of-language", "validator:implicit-declaration", "validator:evaluate-interpolation", "validator:page-code-closure", "validator:page-code-syntax", "validator:page-code-string", "validator:template-escape-changed", "validator:library-member", "validator:unknown-member"]>, z.ZodEnum<["off", "warn", "error"]>>;
126
130
  }, "strict", z.ZodTypeAny, {
127
131
  enabled: boolean;
128
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
132
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
129
133
  }, {
130
134
  enabled: boolean;
131
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
135
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
132
136
  }>;
133
137
  type LinterConfig = z.infer<typeof LinterConfigSchema>;
134
138
  declare const QueueConfigSchema: z.ZodObject<{
@@ -479,6 +483,16 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
479
483
  * driver when a context opens — the list is Playwright's, and this
480
484
  * schema is imported where Playwright is not installed. */
481
485
  device: z.ZodOptional<z.ZodString>;
486
+ /** Browser, device and launch mode in one line (`"ios"`: WebKit, an
487
+ * iPhone preset, standalone). Written out by the loader before the
488
+ * defaults (`config/profile.ts`); `browsers` or `device` next to it is
489
+ * refused. */
490
+ profile: z.ZodOptional<z.ZodEnum<["ios", ..."ios"[]]>>;
491
+ /** What the page's scripts see as the launch mode: `matchMedia` on
492
+ * `(display-mode: …)` and, in WebKit, `navigator.standalone`. CSS
493
+ * `@media (display-mode)` is not emulated by any engine. Unset → the
494
+ * browser's own (`browser`). */
495
+ displayMode: z.ZodOptional<z.ZodEnum<["browser", "standalone", "minimal-ui", "fullscreen"]>>;
482
496
  /** IANA time zone of every page (`"Europe/Madrid"`): `Date#toString`,
483
497
  * `Intl` and `getTimezoneOffset` answer in it. Unset → the machine's.
484
498
  * `UNOTEST_TIMEZONE` overrides it. */
@@ -499,12 +513,12 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
499
513
  profile: z.ZodOptional<z.ZodLiteral<"per-test">>;
500
514
  args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
501
515
  }, "strict", z.ZodTypeAny, {
502
- userDataDir?: string | undefined;
503
516
  profile?: "per-test" | undefined;
517
+ userDataDir?: string | undefined;
504
518
  args?: string[] | undefined;
505
519
  }, {
506
- userDataDir?: string | undefined;
507
520
  profile?: "per-test" | undefined;
521
+ userDataDir?: string | undefined;
508
522
  args?: string[] | undefined;
509
523
  }>>;
510
524
  retry: z.ZodObject<{
@@ -620,13 +634,13 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
620
634
  }>;
621
635
  linter: z.ZodObject<{
622
636
  enabled: z.ZodBoolean;
623
- rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "lint:filter-unknown-option", "lint:role-unknown-option", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format", "validator:const-assign", "validator:teardown-shape", "validator:teardown-name-conflict", "validator:wait-until-shape", "validator:locator-index-access", "validator:chain-receiver", "validator:top-level-const", "validator:string-member-receiver", "validator:unsupported-string-member", "validator:array-member-receiver", "validator:options", "validator:out-of-language", "validator:implicit-declaration", "validator:evaluate-interpolation", "validator:page-code-closure", "validator:template-escape-changed", "validator:library-member", "validator:unknown-member"]>, z.ZodEnum<["off", "warn", "error"]>>;
637
+ rules: z.ZodRecord<z.ZodEnum<["lint:deep-css", "lint:xpath", "lint:obfuscated-class", "lint:pause-explicit", "lint:disambig-by-index", "lint:evaluate-discouraged", "lint:scenario-in-root", "lint:mustache-in-dsl", "lint:goto-concat", "lint:regex-invalid", "lint:echo-assert", "lint:api-call-file-body", "lint:lint-ok-missing-reason", "lint:flow-returns-value", "lint:legacy-layout", "lint:external-variable-undeclared", "lint:external-variable-no-value", "lint:env-host-from-base", "lint:one-test-per-file", "lint:shadows-dsl-function", "lint:skip-outside-test", "lint:set-test-timeout-outside-test", "lint:filter-unknown-option", "lint:role-unknown-option", "lint:typed-step-available", "validator:unknown-function", "validator:arity", "validator:arg-kind", "validator:step-coverage", "validator:step-shape", "validator:meta-shape", "validator:function-shape", "validator:for-shape", "validator:if-shape", "validator:var-shape", "validator:unsupported-statement", "validator:unsupported-expression", "validator:string-concat", "validator:semantic-loss", "validator:list-arg", "validator:wrapped-format", "validator:const-assign", "validator:teardown-shape", "validator:teardown-name-conflict", "validator:wait-until-shape", "validator:assert-never-shape", "validator:locator-index-access", "validator:chain-receiver", "validator:top-level-const", "validator:string-member-receiver", "validator:unsupported-string-member", "validator:array-member-receiver", "validator:options", "validator:out-of-language", "validator:implicit-declaration", "validator:evaluate-interpolation", "validator:page-code-closure", "validator:page-code-syntax", "validator:page-code-string", "validator:template-escape-changed", "validator:library-member", "validator:unknown-member"]>, z.ZodEnum<["off", "warn", "error"]>>;
624
638
  }, "strict", z.ZodTypeAny, {
625
639
  enabled: boolean;
626
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
640
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
627
641
  }, {
628
642
  enabled: boolean;
629
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
643
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
630
644
  }>;
631
645
  mcp: z.ZodObject<{
632
646
  transport: z.ZodLiteral<"stdio">;
@@ -755,7 +769,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
755
769
  defaultNavigationTimeoutMs: number;
756
770
  linter: {
757
771
  enabled: boolean;
758
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
772
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
759
773
  };
760
774
  mcp: {
761
775
  transport: "stdio";
@@ -794,12 +808,14 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
794
808
  deviceScaleFactor?: number | undefined;
795
809
  } | null | undefined;
796
810
  device?: string | undefined;
811
+ profile?: "ios" | undefined;
812
+ displayMode?: "browser" | "standalone" | "minimal-ui" | "fullscreen" | undefined;
797
813
  timezone?: string | undefined;
798
814
  locale?: string | undefined;
799
815
  maxContexts?: number | undefined;
800
816
  launch?: {
801
- userDataDir?: string | undefined;
802
817
  profile?: "per-test" | undefined;
818
+ userDataDir?: string | undefined;
803
819
  args?: string[] | undefined;
804
820
  } | undefined;
805
821
  storageState?: string | undefined;
@@ -835,7 +851,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
835
851
  defaultNavigationTimeoutMs: number;
836
852
  linter: {
837
853
  enabled: boolean;
838
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
854
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
839
855
  };
840
856
  mcp: {
841
857
  transport: "stdio";
@@ -873,12 +889,14 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
873
889
  deviceScaleFactor?: number | undefined;
874
890
  } | null | undefined;
875
891
  device?: string | undefined;
892
+ profile?: "ios" | undefined;
893
+ displayMode?: "browser" | "standalone" | "minimal-ui" | "fullscreen" | undefined;
876
894
  timezone?: string | undefined;
877
895
  locale?: string | undefined;
878
896
  maxContexts?: number | undefined;
879
897
  launch?: {
880
- userDataDir?: string | undefined;
881
898
  profile?: "per-test" | undefined;
899
+ userDataDir?: string | undefined;
882
900
  args?: string[] | undefined;
883
901
  } | undefined;
884
902
  storageState?: string | undefined;
@@ -920,7 +938,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
920
938
  defaultNavigationTimeoutMs: number;
921
939
  linter: {
922
940
  enabled: boolean;
923
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
941
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
924
942
  };
925
943
  mcp: {
926
944
  transport: "stdio";
@@ -959,12 +977,14 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
959
977
  deviceScaleFactor?: number | undefined;
960
978
  } | null | undefined;
961
979
  device?: string | undefined;
980
+ profile?: "ios" | undefined;
981
+ displayMode?: "browser" | "standalone" | "minimal-ui" | "fullscreen" | undefined;
962
982
  timezone?: string | undefined;
963
983
  locale?: string | undefined;
964
984
  maxContexts?: number | undefined;
965
985
  launch?: {
966
- userDataDir?: string | undefined;
967
986
  profile?: "per-test" | undefined;
987
+ userDataDir?: string | undefined;
968
988
  args?: string[] | undefined;
969
989
  } | undefined;
970
990
  storageState?: string | undefined;
@@ -1000,7 +1020,7 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
1000
1020
  defaultNavigationTimeoutMs: number;
1001
1021
  linter: {
1002
1022
  enabled: boolean;
1003
- rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
1023
+ rules: Partial<Record<"lint:deep-css" | "lint:xpath" | "lint:obfuscated-class" | "lint:pause-explicit" | "lint:disambig-by-index" | "lint:evaluate-discouraged" | "lint:scenario-in-root" | "lint:mustache-in-dsl" | "lint:goto-concat" | "lint:regex-invalid" | "lint:echo-assert" | "lint:api-call-file-body" | "lint:lint-ok-missing-reason" | "lint:flow-returns-value" | "lint:legacy-layout" | "lint:external-variable-undeclared" | "lint:external-variable-no-value" | "lint:env-host-from-base" | "lint:one-test-per-file" | "lint:shadows-dsl-function" | "lint:skip-outside-test" | "lint:set-test-timeout-outside-test" | "lint:filter-unknown-option" | "lint:role-unknown-option" | "lint:typed-step-available" | "validator:unknown-function" | "validator:arity" | "validator:arg-kind" | "validator:step-coverage" | "validator:step-shape" | "validator:meta-shape" | "validator:function-shape" | "validator:for-shape" | "validator:if-shape" | "validator:var-shape" | "validator:unsupported-statement" | "validator:unsupported-expression" | "validator:string-concat" | "validator:semantic-loss" | "validator:list-arg" | "validator:wrapped-format" | "validator:const-assign" | "validator:teardown-shape" | "validator:teardown-name-conflict" | "validator:wait-until-shape" | "validator:assert-never-shape" | "validator:locator-index-access" | "validator:chain-receiver" | "validator:top-level-const" | "validator:string-member-receiver" | "validator:unsupported-string-member" | "validator:array-member-receiver" | "validator:options" | "validator:out-of-language" | "validator:implicit-declaration" | "validator:evaluate-interpolation" | "validator:page-code-closure" | "validator:page-code-syntax" | "validator:page-code-string" | "validator:template-escape-changed" | "validator:library-member" | "validator:unknown-member", "off" | "warn" | "error">>;
1004
1024
  };
1005
1025
  mcp: {
1006
1026
  transport: "stdio";
@@ -1038,12 +1058,14 @@ declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
1038
1058
  deviceScaleFactor?: number | undefined;
1039
1059
  } | null | undefined;
1040
1060
  device?: string | undefined;
1061
+ profile?: "ios" | undefined;
1062
+ displayMode?: "browser" | "standalone" | "minimal-ui" | "fullscreen" | undefined;
1041
1063
  timezone?: string | undefined;
1042
1064
  locale?: string | undefined;
1043
1065
  maxContexts?: number | undefined;
1044
1066
  launch?: {
1045
- userDataDir?: string | undefined;
1046
1067
  profile?: "per-test" | undefined;
1068
+ userDataDir?: string | undefined;
1047
1069
  args?: string[] | undefined;
1048
1070
  } | undefined;
1049
1071
  storageState?: string | undefined;
@@ -1060,4 +1082,4 @@ type UnotestConfig = z.infer<typeof UnotestConfigSchema>;
1060
1082
  type UnotestConfigInput = z.input<typeof UnotestConfigSchema>;
1061
1083
  declare const DEFAULT_CONFIG: UnotestConfig;
1062
1084
 
1063
- export { BROWSER_CHANNEL_WORDS, type Browser, type BrowserChannel, BrowserChannelSchema, BrowserSchema, DEFAULT_CONFIG, type DialogPolicy, DialogPolicySchema, type EnvConfig, EnvConfigSchema, type FailureBundleConfig, FailureBundleConfigSchema, type LinterConfig, LinterConfigSchema, type LinterRuleId, LinterRuleIdSchema, type LinterSeverity, LinterSeveritySchema, type McpConfig, McpConfigSchema, type QueueConfig, QueueConfigSchema, type RetryConfig, RetryConfigSchema, type RetryReason, RetryReasonSchema, SYSTEM_BROWSER_CHANNELS, type SandboxConfig, SandboxConfigSchema, type ScheduleConfig, ScheduleSchema, type UnotestConfig, type UnotestConfigInput, UnotestConfigSchema, type Viewport, ViewportSchema, type WebServerConfig, WebServerConfigSchema, WebServersConfigSchema, viewportDeviceConflict };
1085
+ export { BROWSER_CHANNEL_WORDS, type Browser, type BrowserChannel, BrowserChannelSchema, BrowserSchema, DEFAULT_CONFIG, type DialogPolicy, DialogPolicySchema, type DisplayMode, DisplayModeSchema, type EnvConfig, EnvConfigSchema, type FailureBundleConfig, FailureBundleConfigSchema, type LinterConfig, LinterConfigSchema, type LinterRuleId, LinterRuleIdSchema, type LinterSeverity, LinterSeveritySchema, type McpConfig, McpConfigSchema, type QueueConfig, QueueConfigSchema, type RetryConfig, RetryConfigSchema, type RetryReason, RetryReasonSchema, SYSTEM_BROWSER_CHANNELS, type SandboxConfig, SandboxConfigSchema, type ScheduleConfig, ScheduleSchema, type UnotestConfig, type UnotestConfigInput, UnotestConfigSchema, type Viewport, ViewportSchema, type WebServerConfig, WebServerConfigSchema, WebServersConfigSchema, viewportDeviceConflict };