@unotest/web 0.10.0 → 0.12.0

package/.claude/skills/write-e2e-test/SKILL.md

@@ -306,9 +306,11 @@ What's **not allowed** (parser / runtime will reject): `import` /
 `export` / `require`, top-level `await`, `class`, JSX, `while` /
 `do…while` / `continue` / `++`. Bounded `for (i = 0; i < N; i = i + 1)`
 loops ARE supported, and `break` is legal inside a loop body — poll with
-`for` + `if (…) { break; }` + `pause(ms) // reason: …`. Index access
+`for` + `if (…) { break; }` + `pause(ms) // lint-ok: …`. Index access
 reads data (`docs[0].count`, bare variable only, never a Locator);
-`arr[i] = v` stays rejected.
+`obj.prop[i]` does not parse — assign the member first:
+`m = state.matches; last = m[m.length - 1];`. `arr[i] = v` stays
+rejected.
 
 Navigation:
 - `goto(url, opts?)`, `reload(opts?)`, `getUrl()`, `goBack()`, `goForward()`.
@@ -377,7 +379,7 @@ Disambiguate with `.filter({hasText: '…'})` or `.filter({has: …})` —
 Waits:
 - `waitFor(loc, opts?)`, `waitForText(text, opts?)`,
   `waitForCount(loc, n, opts?)`, `waitForUrl(pattern)`, `pause(ms)` —
-  `pause` requires `// reason: <why>` comment immediately above (linter
+  `pause` requires a trailing `// lint-ok: <why>` comment on the same line (linter
   flags `lint:pause-explicit` otherwise).
 - `waitForText` waits for ≥1 VISIBLE occurrence (repeated text in a feed
   is fine); substring by default — `{exact: true}` or a regex
@@ -395,20 +397,22 @@ State reads:
   `getInputValue(loc)`.
 
 Sandbox primitives:
-- `shell("cmd", "arg", …)` — `execFile` style, no shell interpretation.
+- `shell("cmd", "arg", …, options?)` — `execFile` style, no shell interpretation. Non-zero exit fails the step; pass `{allowNonZero: true}` to inspect `res.code` yourself. Wall-clock budget `{timeoutMs}` (default 120s).
+- `waitForFile(path, pattern?, {timeoutMs})` — poll a file until it exists / matches; use it to await output of background processes started via `shell()`.
 - `dbQuery(sql, …params)`, `dbExec(sql, …params)` — parameterized.
 - `apiCall(method, path, body?, headers?, opts?)` — path-only against
   `sandbox.apiBaseUrl`; another host via `{base: 'API_BASE_X'}` — the
   NAME of a `unotest/.env` variable, never a URL. Multipart upload:
-  body of the exact shape `{file: 'fixtures/doc.pdf', field?, fields?}`
+  pass `upload('fixtures/doc.pdf', {field?, fields?})` as the body
   (relative path inside the project / `sandbox.uploadDir`; don't set
-  Content-Type yourself).
+  Content-Type yourself). A JSON body with a `file` key posts as plain
+  JSON — there is no key-name magic.
 
 Escape hatch:
 - `evaluate(\`js body\`, …args)` — raw backticks, no `${}`. Linter
   warns `lint:evaluate-discouraged`. Use only when nothing above fits.
 
-Time helpers: `nowMs()`, `today()`, `daysFromNow(n)`.
+Time helpers: `nowMs()`, `today()`, `daysFromNow(n)`. Marker helper: `randomWord(len)` — random lowercase letters, digit-free.
 
 ## Helpers convention
 

package/.claude/skills/write-e2e-test-ground/SKILL.md

@@ -437,9 +437,11 @@ What's **not allowed** (parser / runtime will reject): `import` /
 `export` / `require`, top-level `await`, `class`, JSX, `while` /
 `do…while` / `continue` / `++`. Bounded `for (i = 0; i < N; i = i + 1)`
 loops ARE supported, and `break` is legal inside a loop body — poll with
-`for` + `if (…) { break; }` + `pause(ms) // reason: …`. Index access
+`for` + `if (…) { break; }` + `pause(ms) // lint-ok: …`. Index access
 reads data (`docs[0].count`, bare variable only, never a Locator);
-`arr[i] = v` stays rejected.
+`obj.prop[i]` does not parse — assign the member first:
+`m = state.matches; last = m[m.length - 1];`. `arr[i] = v` stays
+rejected.
 
 Navigation:
 - `goto(url, opts?)`, `reload(opts?)`, `getUrl()`, `goBack()`, `goForward()`.
@@ -508,7 +510,7 @@ Disambiguate with `.filter({hasText: '…'})` or `.filter({has: …})` —
 Waits:
 - `waitFor(loc, opts?)`, `waitForText(text, opts?)`,
   `waitForCount(loc, n, opts?)`, `waitForUrl(pattern)`, `pause(ms)` —
-  `pause` requires `// reason: <why>` comment immediately above (linter
+  `pause` requires a trailing `// lint-ok: <why>` comment on the same line (linter
   flags `lint:pause-explicit` otherwise).
 - `waitForText` waits for ≥1 VISIBLE occurrence (repeated text in a feed
   is fine); substring by default — `{exact: true}` or a regex
@@ -526,20 +528,22 @@ State reads:
   `getInputValue(loc)`.
 
 Sandbox primitives:
-- `shell("cmd", "arg", …)` — `execFile` style, no shell interpretation.
+- `shell("cmd", "arg", …, options?)` — `execFile` style, no shell interpretation. Non-zero exit fails the step; pass `{allowNonZero: true}` to inspect `res.code` yourself. Wall-clock budget `{timeoutMs}` (default 120s).
+- `waitForFile(path, pattern?, {timeoutMs})` — poll a file until it exists / matches; use it to await output of background processes started via `shell()`.
 - `dbQuery(sql, …params)`, `dbExec(sql, …params)` — parameterized.
 - `apiCall(method, path, body?, headers?, opts?)` — path-only against
   `sandbox.apiBaseUrl`; another host via `{base: 'API_BASE_X'}` — the
   NAME of a `unotest/.env` variable, never a URL. Multipart upload:
-  body of the exact shape `{file: 'fixtures/doc.pdf', field?, fields?}`
+  pass `upload('fixtures/doc.pdf', {field?, fields?})` as the body
   (relative path inside the project / `sandbox.uploadDir`; don't set
-  Content-Type yourself).
+  Content-Type yourself). A JSON body with a `file` key posts as plain
+  JSON — there is no key-name magic.
 
 Escape hatch:
 - `evaluate(\`js body\`, …args)` — raw backticks, no `${}`. Linter
   warns `lint:evaluate-discouraged`. Use only when nothing above fits.
 
-Time helpers: `nowMs()`, `today()`, `daysFromNow(n)`.
+Time helpers: `nowMs()`, `today()`, `daysFromNow(n)`. Marker helper: `randomWord(len)` — random lowercase letters, digit-free.
 
 ## Helpers convention
 

package/CHANGELOG.md

@@ -5,6 +5,204 @@ All notable changes to `@unotest/web` are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.12.0] - 2026-08-14
+
+### Minor Changes
+
+- 479aa25: The active variable environment is now agent-visible instead of
+  docs-only. `explore_start` and `run_test` replies carry an
+  `environment` field: the active env name (`UNOTEST_ENV`, `null` = base)
+  plus every `.env` / `.secrets` layer file with an `exists` flag. A
+  missing external variable error now also lists the searched layers
+  (`Looked in environment "dev" (UNOTEST_ENV): unotest/.env,
+unotest/.env.dev (no such file)`). Tool descriptions for `run_test` /
+  `explore_start` explain the env mechanism — MCP sessions inherit
+  `UNOTEST_ENV` from the server process (set it in the client's `env`
+  block); CLI runs take `--env <name>`. The shipped agent guide gains a
+  "Variable environments" section.
+- 479aa25: Feedback batch from a real-world integration (bot-service): shell()
+  safety, run diagnostics, boolean-attribute probes, linter ergonomics.
+
+  **BREAKING — `shell()` fails the step on a non-zero exit code.**
+  Previously a non-zero exit resolved silently and a forgotten `res.code`
+  check produced false-green tests. Migration: calls where non-zero is
+  expected (probes, `grep -q`) pass `{allowNonZero: true}` as the last
+  argument and keep checking `res.code`; calls that asserted
+  `assertTrue(out.code == 0, ...)` can drop the assert. More shell()
+  hardening: a missing binary is a distinct "failed to start" error (was a
+  fake `code: 1`), output over 10 MiB fails loudly (was silent
+  truncation), and every call has a wall-clock budget
+  (`sandbox.shellTimeoutMs`, default 120 s, or per-call `{timeoutMs}`) —
+  a detached grandchild holding the stdio pipes no longer hangs the
+  scenario forever; the timeout error explains the detach recipe.
+
+  New capabilities:
+
+  - `waitForFile(path, pattern?, {timeoutMs})` — poll a file until it
+    exists / contains a substring or regex; the file-side `waitForText`
+    for background processes. Returns the content.
+  - `sandbox.exportSecrets: [names]` — explicit allowlist of `.secrets*`
+    variables exported into `shell()` subprocess env (still masked in
+    logs). Secrets stay out of `process.env` otherwise.
+  - `isDisabled(loc)` / `isEnabled(loc)` — honest disabled probe (native
+    `:disabled` incl. fieldset inheritance, or `aria-disabled`);
+    `hasAttribute(loc, name)` — presence probe for boolean attributes
+    (`getAttribute` reads `""` for present and absent alike).
+  - Generators: `randomWord(len)` (letters only — digit-free markers),
+    `nowMs()`, `today()`, `daysFromNow(n)` (previously documented in the
+    skills but not implemented).
+  - Failed runs report the enclosing step: `✗ test: … in step "…"` in the
+    console, `stepLabel` in the failure bundle and `inspect_runtime`.
+  - Every CLI run prints a one-line header: active environment, layer
+    files (missing ones flagged) and effective `baseUrl`; `run_test` /
+    `explore_start` replies echo `baseUrl` next to `environment`.
+  - `run_test` accepts per-call `env` — the spawned runner child gets
+    `UNOTEST_ENV=<env>` for that run only.
+  - Linter: `// lint-ok: <reason>` silences warning/info diagnostics on
+    its line (reason required; errors never suppressible); new
+    `lint:echo-assert` warns when `waitForText`/`assertText` overlaps a
+    value the scenario itself filled (chat echo trap);
+    `lint:goto-concat` / `lint:regex-invalid` are now configurable in
+    `linter.rules` (they were emitted but missing from the config schema).
+  - A `_helpers` file that fails to parse is reported as the root cause in
+    `unotest-web lint` (and explore replies list `unparsableHelperFiles`)
+    instead of silently cascading into "Unknown function" at every call
+    site. The viewer logs the same condition (patch).
+
+### Patch Changes
+
+- Updated dependencies [40300d3]
+- Updated dependencies [479aa25]
+- Updated dependencies [5dd59af]
+- Updated dependencies [7069d24]
+  - @unotest/dsl@0.12.0
+  - @unotest/viewer@0.12.0
+  - @unotest/core@0.12.0
+  - @unotest/grounder-client@0.12.0
+  - @unotest/protocol@0.12.0
+
+## [0.11.0] - 2026-08-13
+
+### Minor Changes
+
+- eb568a6: `e2e` CLI argument diagnostics: extra positional arguments are rejected
+  instead of silently ignored (with a "did you mean: unotest-web e2e <name>"
+  hint for a duplicated subcommand); an argument that resolves to a
+  directory gets its own message instead of the misleading ".js extension"
+  error; unknown scenario names now suggest close matches from
+  `unotest/e2e/**` (new `suggestClosest` / `levenshteinDistance` utilities
+  in `@unotest/core`). The `collection` command also rejects extra
+  positionals.
+- a195713: Failure artifacts are always on, and steps can carry screenshots.
+
+  - On any scenario failure the runner writes `screenshot.png` +
+    `page.html` (runtime DOM, open shadow roots included, secrets
+    redacted) to `unotest/.runs/<runId>/failure/` — no `UNOTEST_DEBUG`
+    needed. The `.unotest/failures/` bundle gains the same `page.html`;
+    its screenshot keeps honouring `failureBundle.tier2`.
+  - New env flag `UNOTEST_STEP_SCREENSHOTS=1` captures a PNG after every
+    executed step into `unotest/.runs/<runId>/screenshot/`.
+  - Protocol: `screenshot` events may carry the step's `file`/`line`/`col`.
+  - Viewer: a step row with a captured screenshot shows a camera icon and
+    toggles an inline preview on click (both `screenshot()` DSL captures
+    and per-step ones).
+
+- d0ae620: Parse errors now carry an exact position and a caret code frame.
+
+  - Every lexer failure is a `ParseError` with `line`/`column` (previously
+    bare `Error` with no position).
+  - New `formatCodeFrame(source, line, column)` / `formatParseError`
+    exports in `@unotest/dsl`.
+  - The web runner's "parse error in <file>" message now includes
+    `<file>:<line>:<col>` plus the code frame — no more hunting for an
+    "unexpected LBRACKET" by eye.
+  - Token columns are now uniformly 1-based at the token start.
+    Previously identifier/number/string tokens were 0-based while
+    operators were 1-based, so carets and editor squiggles missed by one.
+    Migration note: `line:col` breakpoint keys stored in
+    `.debugger[-suffix].json` against word-initial statements shift by
+    +1 — re-set those breakpoints once.
+
+- 98b0736: BREAKING: multipart uploads in `apiCall` are now opted into explicitly
+  with the new `upload(path, {field?, fields?})` DSL function — the
+  `{file, field?, fields?}` body-shape magic is removed.
+
+  A JSON body containing a `file` key now always posts as JSON (the old
+  key-name detection broke JSON APIs with a legitimate `file` field —
+  `{file: 'x.jsonl'}` tried to read a file from disk and died with
+  ENOENT).
+
+  Migration:
+
+  ```js
+  // before
+  apiCall("POST", "/documents", {
+    file: "fixtures/doc.pdf",
+    fields: { source: "e2e" },
+  });
+  // after
+  apiCall(
+    "POST",
+    "/documents",
+    upload("fixtures/doc.pdf", { fields: { source: "e2e" } })
+  );
+  ```
+
+  `upload()` must be the body itself (a nested `{doc: upload(...)}` is
+  rejected with a pointer to the correct usage). Path containment in
+  `sandbox.uploadDir` and the Content-Type rules are unchanged.
+
+### Patch Changes
+
+- ce25926: Fixes and DX follow-ups from the real-time-polls field check:
+
+  - **Fix: `unotest/.runs/<runId>/failure/` was never written.** The
+    runner derived the run dir from its internal runtime id (`r-N…`)
+    while the on-disk dir is named by `makeRunId(scenario)`, so the
+    always-on failure artifacts silently skipped. The CLI now passes its
+    run dir into the runner (`RunJsScenarioOptions.runDir`), and the
+    failure screenshot + page.html land where documented.
+  - **`init` re-syncs tool-owned skill copies.** `.claude/skills/*` and
+    `.claude/hooks/*` shipped by the package are overwritten on a plain
+    `init` re-run when they diverge from the installed version (status
+    `updated`) — stale skills after a package upgrade no longer require
+    `--force`. User-scaffolded files keep the skip-unless-`--force`
+    behaviour.
+  - The MCP `agent-test-author` prompt caught up with the runtime:
+    multipart via `upload(...)` and the `obj.prop[i]` workaround are now
+    documented there too, and both facts are enforced by
+    `check-skill-prompt-sync`.
+
+- 7ac23d5: Screenshots are no longer saved as blank white PNGs. `goto()` resolves
+  on the `load` event, which on any client-rendered app fires before the
+  first frame carries content — so a per-step capture
+  (`UNOTEST_STEP_SCREENSHOTS=1`) of a step that ended on `goto()`, or a
+  `screenshot()` call placed right after one, froze the pre-render frame.
+  Both paths now settle first: wait for the network to go quiet, then for
+  a painted frame, capped at 2s total. A page that never goes quiet
+  (polling, live feeds) spends the cap once per capture and is then shot
+  as-is; the wait never fails a run. The failure screenshot deliberately
+  skips the settle — it must show the page as it was at the failure.
+
+  Adds `DriverPage.waitForLoadState(state, opts?)` — diagnostics-only,
+  backing the settle. It is not exposed to the DSL: a test that waits on
+  "the network went quiet" instead of on visible app state is the flaky
+  pattern the linter rejects.
+
+- Updated dependencies [eb568a6]
+- Updated dependencies [a195713]
+- Updated dependencies [ce25926]
+- Updated dependencies [5a8e92b]
+- Updated dependencies [d0ae620]
+- Updated dependencies [2a68997]
+- Updated dependencies [c01b72f]
+- Updated dependencies [dea90e9]
+  - @unotest/core@0.11.0
+  - @unotest/protocol@0.11.0
+  - @unotest/viewer@0.11.0
+  - @unotest/dsl@0.11.0
+  - @unotest/grounder-client@0.11.0
+
 ## [0.10.0] - 2026-08-06
 
 ### Minor Changes

package/dist/config/schema.d.ts

@@ -90,19 +90,19 @@ declare const FailureBundleConfigSchema: z.ZodObject<{
 type FailureBundleConfig = z.infer<typeof FailureBundleConfigSchema>;
 declare const DialogPolicySchema: z.ZodEnum<["accept", "dismiss", "manual"]>;
 type DialogPolicy = z.infer<typeof DialogPolicySchema>;
-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", "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"]>;
+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:lint-ok-missing-reason", "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"]>;
 type LinterRuleId = z.infer<typeof LinterRuleIdSchema>;
 declare const LinterSeveritySchema: z.ZodEnum<["off", "warn", "error"]>;
 type LinterSeverity = z.infer<typeof LinterSeveritySchema>;
 declare const LinterConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
-    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", "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"]>, z.ZodEnum<["off", "warn", "error"]>>;
+    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:lint-ok-missing-reason", "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"]>, z.ZodEnum<["off", "warn", "error"]>>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
-    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" | "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", "off" | "warn" | "error">>;
+    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:lint-ok-missing-reason" | "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", "off" | "warn" | "error">>;
 }, {
     enabled: boolean;
-    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" | "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", "off" | "warn" | "error">>;
+    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:lint-ok-missing-reason" | "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", "off" | "warn" | "error">>;
 }>;
 type LinterConfig = z.infer<typeof LinterConfigSchema>;
 declare const McpConfigSchema: z.ZodObject<{
@@ -116,6 +116,17 @@ type McpConfig = z.infer<typeof McpConfigSchema>;
 declare const SandboxConfigSchema: z.ZodObject<{
     /** Default cwd for `shell(cmd, ...args)`. Defaults to `process.cwd()`. */
     shellCwd: z.ZodOptional<z.ZodString>;
+    /** Wall-clock budget for one `shell()` call, ms. Default 120 000. A call
+     *  that exceeds it fails the step (the child gets SIGTERM, then SIGKILL) —
+     *  without this, a grandchild process inheriting stdio pipes hangs the
+     *  scenario forever. Per-call override: `shell(..., {timeoutMs})`. */
+    shellTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    /** Names of `.secrets*` variables exported into `shell()` subprocess env.
+     *  Secrets are deliberately kept OUT of process.env (see
+     *  scenario-variables.ts) — this is the explicit opt-in for the listener /
+     *  seeder subprocess that genuinely needs a token. Values are still
+     *  masked in logs by the SecretRegistry. */
+    exportSecrets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Database connection string consumed by `dbQuery` / `dbExec`. URL form
      *  picks the dialect: `postgres://`, `mysql://`, `sqlite:`. */
     database: z.ZodOptional<z.ZodString>;
@@ -124,17 +135,21 @@ declare const SandboxConfigSchema: z.ZodObject<{
      *  URLs are rejected at runtime. Additional bases come from env
      *  variables via `apiCall(..., {base: "API_BASE_X"})`. */
     apiBaseUrl: z.ZodOptional<z.ZodString>;
-    /** Root for `apiCall` multipart `{file}` fixtures. Relative upload
-     *  paths resolve against it and may not escape it. Defaults to the
-     *  project root (the runner's cwd). */
+    /** Root for `upload()` fixtures. Relative upload paths resolve
+     *  against it and may not escape it. Defaults to the project root
+     *  (the runner's cwd). */
     uploadDir: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     shellCwd?: string | undefined;
+    shellTimeoutMs?: number | undefined;
+    exportSecrets?: string[] | undefined;
     database?: string | undefined;
     apiBaseUrl?: string | undefined;
     uploadDir?: string | undefined;
 }, {
     shellCwd?: string | undefined;
+    shellTimeoutMs?: number | undefined;
+    exportSecrets?: string[] | undefined;
     database?: string | undefined;
     apiBaseUrl?: string | undefined;
     uploadDir?: string | undefined;
@@ -158,14 +173,14 @@ declare const WebServerConfigSchema: z.ZodObject<{
     timeoutMs: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     url: string;
+    timeoutMs: number;
     command: string;
     reuseExistingServer: boolean;
-    timeoutMs: number;
 }, {
     url: string;
     command: string;
-    reuseExistingServer?: boolean | undefined;
     timeoutMs?: number | undefined;
+    reuseExistingServer?: boolean | undefined;
 }>;
 type WebServerConfig = z.infer<typeof WebServerConfigSchema>;
 declare const UnotestConfigSchema: z.ZodObject<{
@@ -192,14 +207,14 @@ declare const UnotestConfigSchema: z.ZodObject<{
         timeoutMs: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         url: string;
+        timeoutMs: number;
         command: string;
         reuseExistingServer: boolean;
-        timeoutMs: number;
     }, {
         url: string;
         command: string;
-        reuseExistingServer?: boolean | undefined;
         timeoutMs?: number | undefined;
+        reuseExistingServer?: boolean | undefined;
     }>>;
     browsers: z.ZodArray<z.ZodEnum<["chromium", "firefox", "webkit"]>, "many">;
     channel: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"chrome">, z.ZodLiteral<"msedge">, z.ZodLiteral<"chrome-beta">, z.ZodNull]>>;
@@ -297,13 +312,13 @@ declare const UnotestConfigSchema: z.ZodObject<{
     defaultNavigationTimeoutMs: z.ZodNumber;
     linter: z.ZodObject<{
         enabled: z.ZodBoolean;
-        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", "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"]>, z.ZodEnum<["off", "warn", "error"]>>;
+        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:lint-ok-missing-reason", "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"]>, z.ZodEnum<["off", "warn", "error"]>>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
-        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" | "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", "off" | "warn" | "error">>;
+        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:lint-ok-missing-reason" | "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", "off" | "warn" | "error">>;
     }, {
         enabled: boolean;
-        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" | "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", "off" | "warn" | "error">>;
+        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:lint-ok-missing-reason" | "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", "off" | "warn" | "error">>;
     }>;
     mcp: z.ZodObject<{
         transport: z.ZodLiteral<"stdio">;
@@ -315,6 +330,17 @@ declare const UnotestConfigSchema: z.ZodObject<{
     sandbox: z.ZodObject<{
         /** Default cwd for `shell(cmd, ...args)`. Defaults to `process.cwd()`. */
         shellCwd: z.ZodOptional<z.ZodString>;
+        /** Wall-clock budget for one `shell()` call, ms. Default 120 000. A call
+         *  that exceeds it fails the step (the child gets SIGTERM, then SIGKILL) —
+         *  without this, a grandchild process inheriting stdio pipes hangs the
+         *  scenario forever. Per-call override: `shell(..., {timeoutMs})`. */
+        shellTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        /** Names of `.secrets*` variables exported into `shell()` subprocess env.
+         *  Secrets are deliberately kept OUT of process.env (see
+         *  scenario-variables.ts) — this is the explicit opt-in for the listener /
+         *  seeder subprocess that genuinely needs a token. Values are still
+         *  masked in logs by the SecretRegistry. */
+        exportSecrets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         /** Database connection string consumed by `dbQuery` / `dbExec`. URL form
          *  picks the dialect: `postgres://`, `mysql://`, `sqlite:`. */
         database: z.ZodOptional<z.ZodString>;
@@ -323,17 +349,21 @@ declare const UnotestConfigSchema: z.ZodObject<{
          *  URLs are rejected at runtime. Additional bases come from env
          *  variables via `apiCall(..., {base: "API_BASE_X"})`. */
         apiBaseUrl: z.ZodOptional<z.ZodString>;
-        /** Root for `apiCall` multipart `{file}` fixtures. Relative upload
-         *  paths resolve against it and may not escape it. Defaults to the
-         *  project root (the runner's cwd). */
+        /** Root for `upload()` fixtures. Relative upload paths resolve
+         *  against it and may not escape it. Defaults to the project root
+         *  (the runner's cwd). */
         uploadDir: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         shellCwd?: string | undefined;
+        shellTimeoutMs?: number | undefined;
+        exportSecrets?: string[] | undefined;
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
     }, {
         shellCwd?: string | undefined;
+        shellTimeoutMs?: number | undefined;
+        exportSecrets?: string[] | undefined;
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
@@ -368,13 +398,15 @@ declare const UnotestConfigSchema: z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        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" | "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", "off" | "warn" | "error">>;
+        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:lint-ok-missing-reason" | "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", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";
     };
     sandbox: {
         shellCwd?: string | undefined;
+        shellTimeoutMs?: number | undefined;
+        exportSecrets?: string[] | undefined;
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
@@ -382,9 +414,9 @@ declare const UnotestConfigSchema: z.ZodObject<{
     baseUrl?: string | undefined;
     webServer?: {
         url: string;
+        timeoutMs: number;
         command: string;
         reuseExistingServer: boolean;
-        timeoutMs: number;
     } | undefined;
     channel?: "chrome" | "msedge" | "chrome-beta" | null | undefined;
     storageState?: string | undefined;
@@ -418,13 +450,15 @@ declare const UnotestConfigSchema: z.ZodObject<{
     defaultNavigationTimeoutMs: number;
     linter: {
         enabled: boolean;
-        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" | "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", "off" | "warn" | "error">>;
+        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:lint-ok-missing-reason" | "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", "off" | "warn" | "error">>;
     };
     mcp: {
         transport: "stdio";
     };
     sandbox: {
         shellCwd?: string | undefined;
+        shellTimeoutMs?: number | undefined;
+        exportSecrets?: string[] | undefined;
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
@@ -433,8 +467,8 @@ declare const UnotestConfigSchema: z.ZodObject<{
     webServer?: {
         url: string;
         command: string;
-        reuseExistingServer?: boolean | undefined;
         timeoutMs?: number | undefined;
+        reuseExistingServer?: boolean | undefined;
     } | undefined;
     channel?: "chrome" | "msedge" | "chrome-beta" | null | undefined;
     storageState?: string | undefined;

package/dist/config/schema.js

@@ -1 +1 @@
-var _0x2e344b=_0x8977;(function(_0x274a7d,_0xfc8b9d){var _0x244ac2={_0x4ac5bb:0xdd,_0x4ff88e:0xe4,_0x286156:0xe0,_0x4f3327:0xe8,_0x58371b:0xe1},_0x41182f=_0x8977,_0x5b93a8=_0x274a7d();while(!![]){try{var _0x1d56a7=-parseInt(_0x41182f(0xdf))/0x1*(-parseInt(_0x41182f(_0x244ac2._0x4ac5bb))/0x2)+-parseInt(_0x41182f(_0x244ac2._0x4ff88e))/0x3*(-parseInt(_0x41182f(0xc7))/0x4)+parseInt(_0x41182f(0xea))/0x5+parseInt(_0x41182f(_0x244ac2._0x286156))/0x6+-parseInt(_0x41182f(0xcc))/0x7+parseInt(_0x41182f(_0x244ac2._0x4f3327))/0x8*(parseInt(_0x41182f(0xfc))/0x9)+-parseInt(_0x41182f(_0x244ac2._0x58371b))/0xa;if(_0x1d56a7===_0xfc8b9d)break;else _0x5b93a8['push'](_0x5b93a8['shift']());}catch(_0x35c23d){_0x5b93a8['push'](_0x5b93a8['shift']());}}}(_0x19a6,0x37d44));import{z}from'zod';var BrowserSchema=z[_0x2e344b(0xfa)]([_0x2e344b(0xe3),_0x2e344b(0xcf),_0x2e344b(0xf9)]),BrowserChannelSchema=z[_0x2e344b(0xf3)]([z['literal'](_0x2e344b(0xca)),z[_0x2e344b(0xc6)](_0x2e344b(0xc9)),z[_0x2e344b(0xc6)](_0x2e344b(0xf5)),z[_0x2e344b(0xe9)]()])[_0x2e344b(0xec)](),ViewportSchema=z[_0x2e344b(0xd7)]({'width':z['number']()[_0x2e344b(0xee)]()[_0x2e344b(0xcb)](),'height':z[_0x2e344b(0xd1)]()[_0x2e344b(0xee)]()[_0x2e344b(0xcb)]()}),RetryReasonSchema=z[_0x2e344b(0xfa)](['transient',_0x2e344b(0xd6),_0x2e344b(0xef)]),RetryConfigSchema=z[_0x2e344b(0xd7)]({'count':z[_0x2e344b(0xd1)]()[_0x2e344b(0xee)]()[_0x2e344b(0x103)](0x0)['max'](0xa),'on':z[_0x2e344b(0xed)](RetryReasonSchema)}),FailureBundleConfigSchema=z[_0x2e344b(0xd7)]({'tier1':z[_0x2e344b(0xc6)](!![])[_0x2e344b(0xc5)](!![]),'tier2':z[_0x2e344b(0xdc)](),'tier3':z[_0x2e344b(0xd7)]({'network':z[_0x2e344b(0xdc)](),'video':z[_0x2e344b(0xdc)]()}),'retention':z['object']({'runs':z[_0x2e344b(0xd1)]()['int']()[_0x2e344b(0xcb)](),'days':z['number']()[_0x2e344b(0xee)]()['positive']()}),'storageDir':z[_0x2e344b(0x104)]()[_0x2e344b(0x103)](0x1)}),DialogPolicySchema=z[_0x2e344b(0xfa)]([_0x2e344b(0xd0),_0x2e344b(0xf1),_0x2e344b(0xde)]),LinterRuleIdSchema=z[_0x2e344b(0xfa)]([_0x2e344b(0xd5),'lint:xpath',_0x2e344b(0xf6),_0x2e344b(0xff),_0x2e344b(0xeb),_0x2e344b(0xfd),_0x2e344b(0xfb),_0x2e344b(0xe5),_0x2e344b(0xd4),_0x2e344b(0xf2),_0x2e344b(0xd2),_0x2e344b(0xe2),_0x2e344b(0xd3),'validator:meta-shape',_0x2e344b(0xc8),_0x2e344b(0xf0),_0x2e344b(0x100),_0x2e344b(0x101),_0x2e344b(0x102),_0x2e344b(0xcd),'validator:string-concat',_0x2e344b(0xc4),_0x2e344b(0xf7),'validator:wrapped-format']),LinterSeveritySchema=z[_0x2e344b(0xfa)]([_0x2e344b(0xe6),'warn','error']),LinterConfigSchema=z[_0x2e344b(0xd7)]({'enabled':z[_0x2e344b(0xdc)](),'rules':z[_0x2e344b(0xf4)](LinterRuleIdSchema,LinterSeveritySchema)}),McpConfigSchema=z[_0x2e344b(0xd7)]({'transport':z[_0x2e344b(0xc6)](_0x2e344b(0xce))}),SandboxConfigSchema=z[_0x2e344b(0xd7)]({'shellCwd':z[_0x2e344b(0x104)]()[_0x2e344b(0xec)](),'database':z['string']()['optional'](),'apiBaseUrl':z[_0x2e344b(0x104)]()[_0x2e344b(0xda)]()[_0x2e344b(0xec)](),'uploadDir':z['string']()[_0x2e344b(0xec)]()}),WebServerConfigSchema=z[_0x2e344b(0xd7)]({'command':z[_0x2e344b(0x104)]()[_0x2e344b(0x103)](0x1),'url':z[_0x2e344b(0x104)]()['url'](),'reuseExistingServer':z[_0x2e344b(0xdc)]()[_0x2e344b(0xc5)](!![]),'timeoutMs':z[_0x2e344b(0xd1)]()[_0x2e344b(0xee)]()[_0x2e344b(0xcb)]()[_0x2e344b(0xc5)](0xea60)}),UnotestConfigSchema=z['object']({'baseUrl':z[_0x2e344b(0x104)]()['url']()[_0x2e344b(0xec)](),'webServer':WebServerConfigSchema[_0x2e344b(0xec)](),'browsers':z[_0x2e344b(0xed)](BrowserSchema)[_0x2e344b(0x103)](0x1),'channel':BrowserChannelSchema,'viewport':ViewportSchema,'retry':RetryConfigSchema,'failureBundle':FailureBundleConfigSchema,'dialogPolicy':DialogPolicySchema,'storageState':z[_0x2e344b(0x104)]()[_0x2e344b(0xec)](),'testDir':z[_0x2e344b(0x104)]()['min'](0x1),'helpersDir':z['string']()[_0x2e344b(0x103)](0x1),'defaultTimeoutMs':z[_0x2e344b(0xd1)]()[_0x2e344b(0xee)]()['positive'](),'defaultNavigationTimeoutMs':z['number']()[_0x2e344b(0xee)]()[_0x2e344b(0xcb)](),'linter':LinterConfigSchema,'mcp':McpConfigSchema,'sandbox':SandboxConfigSchema}),DEFAULT_CONFIG={'browsers':['chromium'],'viewport':{'width':0x500,'height':0x2d0},'retry':{'count':0x0,'on':[_0x2e344b(0xdb)]},'failureBundle':{'tier1':!![],'tier2':!![],'tier3':{'network':![],'video':![]},'retention':{'runs':0x14,'days':0x7},'storageDir':_0x2e344b(0xd9)},'dialogPolicy':'accept','testDir':_0x2e344b(0xe7),'helpersDir':_0x2e344b(0xf8),'defaultTimeoutMs':0xbb8,'defaultNavigationTimeoutMs':0x7530,'linter':{'enabled':!![],'rules':{'lint:deep-css':_0x2e344b(0xd8),'lint:xpath':'warn','lint:obfuscated-class':_0x2e344b(0xd8),'lint:pause-explicit':'warn','lint:disambig-by-index':_0x2e344b(0xe6),'lint:evaluate-discouraged':_0x2e344b(0xd8),'lint:scenario-in-root':_0x2e344b(0xfe),'lint:mustache-in-dsl':_0x2e344b(0xfe),'validator:unknown-function':_0x2e344b(0xfe)}},'mcp':{'transport':_0x2e344b(0xce)},'sandbox':{}};function _0x8977(_0x3a774f,_0x1b39aa){_0x3a774f=_0x3a774f-0xc4;var _0x19a653=_0x19a6();var _0x89776=_0x19a653[_0x3a774f];if(_0x8977['fRpWih']===undefined){var _0x38d7ef=function(_0x26bdbc){var _0x3caffa='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0xda4aa0='',_0x563661='';for(var _0x305f13=0x0,_0x3d29c0,_0x481c1e,_0x19b0ec=0x0;_0x481c1e=_0x26bdbc['charAt'](_0x19b0ec++);~_0x481c1e&&(_0x3d29c0=_0x305f13%0x4?_0x3d29c0*0x40+_0x481c1e:_0x481c1e,_0x305f13++%0x4)?_0xda4aa0+=String['fromCharCode'](0xff&_0x3d29c0>>(-0x2*_0x305f13&0x6)):0x0){_0x481c1e=_0x3caffa['indexOf'](_0x481c1e);}for(var _0x4792b1=0x0,_0x49dbb6=_0xda4aa0['length'];_0x4792b1<_0x49dbb6;_0x4792b1++){_0x563661+='%'+('00'+_0xda4aa0['charCodeAt'](_0x4792b1)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x563661);};_0x8977['wyEdtR']=_0x38d7ef,_0x8977['cHKdQs']={},_0x8977['fRpWih']=!![];}var _0x1354e5=_0x19a653[0x0],_0x16a4bb=_0x3a774f+_0x1354e5,_0x9c7c53=_0x8977['cHKdQs'][_0x16a4bb];return!_0x9c7c53?(_0x89776=_0x8977['wyEdtR'](_0x89776),_0x8977['cHKdQs'][_0x16a4bb]=_0x89776):_0x89776=_0x9c7c53,_0x89776;}export{BrowserChannelSchema,BrowserSchema,DEFAULT_CONFIG,DialogPolicySchema,FailureBundleConfigSchema,LinterConfigSchema,LinterRuleIdSchema,LinterSeveritySchema,McpConfigSchema,RetryConfigSchema,RetryReasonSchema,SandboxConfigSchema,UnotestConfigSchema,ViewportSchema,WebServerConfigSchema};function _0x19a6(){var _0x1434f7=['DMfSAwrHDg9YoMXPC3qTyxjN','Dw5VDgvZDc9LmMuVx2HLBhbLCNm','D2vIA2L0','zw51Bq','BgLUDdPZy2vUyxjPBY1PBI1YB290','mtG3nduYCKHJsuHS','BgLUDdPLDMfSDwf0zs1KAxnJB3vYywDLza','zxjYB3i','BgLUDdPWyxvZzs1LEhbSAwnPDa','DMfSAwrHDg9YoMLMlxnOyxbL','DMfSAwrHDg9YoNzHCI1ZAgfWzq','DMfSAwrHDg9YoNvUC3vWCg9YDgvKlxn0yxrLBwvUDa','BwLU','C3rYAw5N','DMfSAwrHDg9YoNnLBwfUDgLJlwXVC3m','zgvMyxvSDa','BgL0zxjHBa','mJyYmdrzrev4q0K','DMfSAwrHDg9YoMz1BMn0Aw9UlxnOyxbL','BxnLzgDL','y2HYB21L','Cg9ZAxrPDMu','mtq3nZa0mLfMrgnerW','DMfSAwrHDg9YoNvUC3vWCg9YDgvKlwv4ChjLC3nPB24','C3rKAw8','zMLYzwzVEa','ywnJzxb0','BNvTyMvY','DMfSAwrHDg9YoMfYzY1RAw5K','DMfSAwrHDg9YoNn0zxaTC2HHCgu','DMfSAwrHDg9YoNvUA25VD24TzNvUy3rPB24','BgLUDdPKzwvWlwnZCW','BMv0D29YAW','B2jQzwn0','D2fYBG','lNvUB3rLC3qVzMfPBhvYzxm','DxjS','DhjHBNnPzw50','yM9VBgvHBG','mLPiC0XWDq','BwfUDwfS','mZy5ntm1tgPYrKfu','mtqWntu0offSrgvtBG','nti5mdiZmgLwwwnRDG','DMfSAwrHDg9YoNn0zxaTy292zxjHz2u','y2HYB21PDw0','m1LeDg1LzG','BgLUDdPTDxn0ywnOzs1PBI1KC2W','B2zM','Dw5VDgvZDc9LmMu','odHXD3bdzNq','BNvSBa','nJq2mJy1seL0CvP3','BgLUDdPKAxnHBwjPzY1IEs1PBMrLEa','B3b0Aw9UywW','yxjYyxK','Aw50','y3jHC2G','DMfSAwrHDg9YoMzVCI1ZAgfWzq','zgLZBwLZCW','DMfSAwrHDg9YoMfYAxr5','Dw5PB24','CMvJB3jK','y2HYB21LlwjLDge','BgLUDdPVyMz1C2nHDgvKlwnSyxnZ'];_0x19a6=function(){return _0x1434f7;};return _0x19a6();}
+var _0x24740a=_0x202c;(function(_0x2e7bfe,_0x17cbeb){var _0x5d30b8={_0x2648ae:0x193,_0x5ea1b9:0x19f,_0x1fb823:0x19d,_0x2f0413:0x1a8,_0x2e20ee:0x192},_0x482484=_0x202c,_0x3038a0=_0x2e7bfe();while(!![]){try{var _0x3f2fa8=-parseInt(_0x482484(0x189))/0x1+-parseInt(_0x482484(_0x5d30b8._0x2648ae))/0x2+-parseInt(_0x482484(_0x5d30b8._0x5ea1b9))/0x3*(-parseInt(_0x482484(0x1b3))/0x4)+-parseInt(_0x482484(_0x5d30b8._0x1fb823))/0x5+parseInt(_0x482484(_0x5d30b8._0x2f0413))/0x6+-parseInt(_0x482484(_0x5d30b8._0x2e20ee))/0x7+parseInt(_0x482484(0x1a5))/0x8;if(_0x3f2fa8===_0x17cbeb)break;else _0x3038a0['push'](_0x3038a0['shift']());}catch(_0x3f5318){_0x3038a0['push'](_0x3038a0['shift']());}}}(_0x4907,0x97be5));function _0x4907(){var _0x351a15=['B2jQzwn0','otK0otG5Ewr1EeHv','BgLUDdPYzwDLEc1PBNzHBgLK','Dw5VDgvZDc9LmMuVx2HLBhbLCNm','Dw5PB24','lNvUB3rLC3qVzMfPBhvYzxm','y3jHC2G','BgLUDdPKAxnHBwjPzY1IEs1PBMrLEa','DMfSAwrHDg9YoMXPC3qTyxjN','BgLUDdPLDMfSDwf0zs1KAxnJB3vYywDLza','mJyZmdGYnfLUr2HSuG','mJe4mZq0nKPorhLkuG','DxjS','DMfSAwrHDg9YoNvUA25VD24TzNvUy3rPB24','BNvSBa','DMfSAwrHDg9YoNnLBwfUDgLJlwXVC3m','DMfSAwrHDg9YoMLMlxnOyxbL','D2vIA2L0','BwfUDwfS','CMvJB3jK','DMfSAwrHDg9YoNn0CMLUzY1JB25Jyxq','mJe0odCWmgnHCwXHCa','BgL0zxjHBa','ntKXDfrWzhPP','BgLUDdPNB3rVlwnVBMnHDa','DMfSAwrHDg9YoNn0zxaTC2HHCgu','y2HYB21L','zxjYB3i','yxjYyxK','mtmWodC3mJHItgfuB3m','DMfSAwrHDg9YoNvUC3vWCg9YDgvKlwv4ChjLC3nPB24','zw51Bq','nJa5ntKWnhnNDvbezG','C3rKAw8','BMv0D29YAW','DMfSAwrHDg9YoMfYzY1RAw5K','BgLUDdP4Cgf0Aa','BNvTyMvY','DhjHBNnPzw50','B3b0Aw9UywW','DMfSAwrHDg9YoMzVCI1ZAgfWzq','BgLUDdPLy2HVlwfZC2vYDa','BgLUDdPTDxn0ywnOzs1PBI1KC2W','mtC1mdbcD3zWrLm','BgLUDdPSAw50lw9Rlw1PC3nPBMCTCMvHC29U','DMfSAwrHDg9YoNvUC3vWCg9YDgvKlxn0yxrLBwvUDa','Cg9ZAxrPDMu','yM9VBgvHBG','BxnLzgDL','Aw50','zgvMyxvSDa','zMLYzwzVEa','BwLU','DMfSAwrHDg9YoNzHCI1ZAgfWzq','Dw5VDgvZDc9LmMu','DMfSAwrHDg9YoM1LDgeTC2HHCgu','DMfSAwrHDg9YoMfYAxr5','y2HYB21LlwjLDge','C3rYAw5N','D2fYBG','y2HYB21PDw0','BgLUDdPKzwvWlwnZCW','zgLZBwLZCW'];_0x4907=function(){return _0x351a15;};return _0x4907();}import{z}from'zod';var BrowserSchema=z[_0x24740a(0x1a7)](['chromium',_0x24740a(0x17c),_0x24740a(0x199)]),BrowserChannelSchema=z[_0x24740a(0x18c)]([z[_0x24740a(0x19e)](_0x24740a(0x1a2)),z[_0x24740a(0x19e)](_0x24740a(0x1b8)),z[_0x24740a(0x19e)](_0x24740a(0x182)),z[_0x24740a(0x196)]()])[_0x24740a(0x1af)](),ViewportSchema=z[_0x24740a(0x188)]({'width':z[_0x24740a(0x1ad)]()[_0x24740a(0x1b9)]()[_0x24740a(0x1b6)](),'height':z[_0x24740a(0x1ad)]()[_0x24740a(0x1b9)]()[_0x24740a(0x1b6)]()}),RetryReasonSchema=z[_0x24740a(0x1a7)]([_0x24740a(0x1ae),_0x24740a(0x1aa),_0x24740a(0x18e)]),RetryConfigSchema=z[_0x24740a(0x188)]({'count':z[_0x24740a(0x1ad)]()['int']()['min'](0x0)['max'](0xa),'on':z[_0x24740a(0x1a4)](RetryReasonSchema)}),FailureBundleConfigSchema=z['object']({'tier1':z['literal'](!![])['default'](!![]),'tier2':z[_0x24740a(0x1b7)](),'tier3':z[_0x24740a(0x188)]({'network':z[_0x24740a(0x1b7)](),'video':z['boolean']()}),'retention':z['object']({'runs':z[_0x24740a(0x1ad)]()[_0x24740a(0x1b9)]()[_0x24740a(0x1b6)](),'days':z[_0x24740a(0x1ad)]()['int']()[_0x24740a(0x1b6)]()}),'storageDir':z[_0x24740a(0x183)]()[_0x24740a(0x17d)](0x1)}),DialogPolicySchema=z['enum'](['accept',_0x24740a(0x187),_0x24740a(0x19a)]),LinterRuleIdSchema=z[_0x24740a(0x1a7)]([_0x24740a(0x186),_0x24740a(0x1ac),'lint:obfuscated-class','lint:pause-explicit',_0x24740a(0x18f),_0x24740a(0x191),'lint:scenario-in-root',_0x24740a(0x1b2),_0x24740a(0x1a0),_0x24740a(0x18a),_0x24740a(0x1b1),_0x24740a(0x1b4),_0x24740a(0x195),_0x24740a(0x181),_0x24740a(0x1ab),'validator:step-coverage',_0x24740a(0x1a1),_0x24740a(0x180),'validator:function-shape',_0x24740a(0x1b0),_0x24740a(0x198),_0x24740a(0x17e),_0x24740a(0x1b5),_0x24740a(0x1a6),_0x24740a(0x19c),_0x24740a(0x197),_0x24740a(0x190),'validator:wrapped-format']),LinterSeveritySchema=z[_0x24740a(0x1a7)](['off',_0x24740a(0x184),'error']),LinterConfigSchema=z[_0x24740a(0x188)]({'enabled':z[_0x24740a(0x1b7)](),'rules':z[_0x24740a(0x19b)](LinterRuleIdSchema,LinterSeveritySchema)}),McpConfigSchema=z['object']({'transport':z[_0x24740a(0x19e)](_0x24740a(0x1a9))}),SandboxConfigSchema=z[_0x24740a(0x188)]({'shellCwd':z['string']()['optional'](),'shellTimeoutMs':z[_0x24740a(0x1ad)]()['int']()[_0x24740a(0x1b6)]()[_0x24740a(0x1af)](),'exportSecrets':z['array'](z['string']())[_0x24740a(0x1af)](),'database':z[_0x24740a(0x183)]()['optional'](),'apiBaseUrl':z[_0x24740a(0x183)]()[_0x24740a(0x194)]()[_0x24740a(0x1af)](),'uploadDir':z[_0x24740a(0x183)]()['optional']()}),WebServerConfigSchema=z[_0x24740a(0x188)]({'command':z[_0x24740a(0x183)]()[_0x24740a(0x17d)](0x1),'url':z[_0x24740a(0x183)]()[_0x24740a(0x194)](),'reuseExistingServer':z[_0x24740a(0x1b7)]()['default'](!![]),'timeoutMs':z[_0x24740a(0x1ad)]()[_0x24740a(0x1b9)]()['positive']()[_0x24740a(0x1ba)](0xea60)}),UnotestConfigSchema=z[_0x24740a(0x188)]({'baseUrl':z[_0x24740a(0x183)]()[_0x24740a(0x194)]()[_0x24740a(0x1af)](),'webServer':WebServerConfigSchema[_0x24740a(0x1af)](),'browsers':z[_0x24740a(0x1a4)](BrowserSchema)[_0x24740a(0x17d)](0x1),'channel':BrowserChannelSchema,'viewport':ViewportSchema,'retry':RetryConfigSchema,'failureBundle':FailureBundleConfigSchema,'dialogPolicy':DialogPolicySchema,'storageState':z['string']()[_0x24740a(0x1af)](),'testDir':z[_0x24740a(0x183)]()[_0x24740a(0x17d)](0x1),'helpersDir':z[_0x24740a(0x183)]()[_0x24740a(0x17d)](0x1),'defaultTimeoutMs':z[_0x24740a(0x1ad)]()[_0x24740a(0x1b9)]()[_0x24740a(0x1b6)](),'defaultNavigationTimeoutMs':z[_0x24740a(0x1ad)]()[_0x24740a(0x1b9)]()[_0x24740a(0x1b6)](),'linter':LinterConfigSchema,'mcp':McpConfigSchema,'sandbox':SandboxConfigSchema}),DEFAULT_CONFIG={'browsers':[_0x24740a(0x185)],'viewport':{'width':0x500,'height':0x2d0},'retry':{'count':0x0,'on':['transient']},'failureBundle':{'tier1':!![],'tier2':!![],'tier3':{'network':![],'video':![]},'retention':{'runs':0x14,'days':0x7},'storageDir':_0x24740a(0x18d)},'dialogPolicy':'accept','testDir':_0x24740a(0x17f),'helpersDir':_0x24740a(0x18b),'defaultTimeoutMs':0xbb8,'defaultNavigationTimeoutMs':0x7530,'linter':{'enabled':!![],'rules':{'lint:deep-css':'warn','lint:xpath':_0x24740a(0x184),'lint:obfuscated-class':_0x24740a(0x184),'lint:pause-explicit':_0x24740a(0x184),'lint:disambig-by-index':'off','lint:evaluate-discouraged':'warn','lint:scenario-in-root':_0x24740a(0x1a3),'lint:mustache-in-dsl':'error','lint:goto-concat':_0x24740a(0x184),'lint:regex-invalid':_0x24740a(0x1a3),'lint:echo-assert':_0x24740a(0x184),'lint:lint-ok-missing-reason':_0x24740a(0x184),'validator:unknown-function':_0x24740a(0x1a3)}},'mcp':{'transport':_0x24740a(0x1a9)},'sandbox':{}};function _0x202c(_0x5b55f0,_0x1e1548){_0x5b55f0=_0x5b55f0-0x17c;var _0x49075b=_0x4907();var _0x202c4b=_0x49075b[_0x5b55f0];if(_0x202c['tyZDFh']===undefined){var _0xe49ede=function(_0x401a06){var _0x337267='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x3744b8='',_0x98677e='';for(var _0x5d0a3c=0x0,_0x50befd,_0x1f34a4,_0x56a82f=0x0;_0x1f34a4=_0x401a06['charAt'](_0x56a82f++);~_0x1f34a4&&(_0x50befd=_0x5d0a3c%0x4?_0x50befd*0x40+_0x1f34a4:_0x1f34a4,_0x5d0a3c++%0x4)?_0x3744b8+=String['fromCharCode'](0xff&_0x50befd>>(-0x2*_0x5d0a3c&0x6)):0x0){_0x1f34a4=_0x337267['indexOf'](_0x1f34a4);}for(var _0x2145f6=0x0,_0xfee7e3=_0x3744b8['length'];_0x2145f6<_0xfee7e3;_0x2145f6++){_0x98677e+='%'+('00'+_0x3744b8['charCodeAt'](_0x2145f6)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x98677e);};_0x202c['pPVuVN']=_0xe49ede,_0x202c['TGtDoY']={},_0x202c['tyZDFh']=!![];}var _0x95650d=_0x49075b[0x0],_0x58923e=_0x5b55f0+_0x95650d,_0x39365d=_0x202c['TGtDoY'][_0x58923e];return!_0x39365d?(_0x202c4b=_0x202c['pPVuVN'](_0x202c4b),_0x202c['TGtDoY'][_0x58923e]=_0x202c4b):_0x202c4b=_0x39365d,_0x202c4b;}export{BrowserChannelSchema,BrowserSchema,DEFAULT_CONFIG,DialogPolicySchema,FailureBundleConfigSchema,LinterConfigSchema,LinterRuleIdSchema,LinterSeveritySchema,McpConfigSchema,RetryConfigSchema,RetryReasonSchema,SandboxConfigSchema,UnotestConfigSchema,ViewportSchema,WebServerConfigSchema};

package/dist/driver/index.d.ts

@@ -1,5 +1,5 @@
-import { E as ElementHint, N as NetworkEntry, W as WebDriver, L as LaunchOptions, C as ContextOptions, D as DriverContext } from '../interfaces-BxviHxnr.js';
-export { A as ActionTimeout, a as CheckOptions, b as ClickOptions, c as CookieOptions, d as DriverPage, F as FillOptions, G as GotoOptions, H as HoverOptions, e as NavigationOptions, P as PressOptions, R as ReloadOptions, S as ScreenshotOptions, f as SelectOptions, V as Viewport, g as WaitOptions, h as WaitState } from '../interfaces-BxviHxnr.js';
+import { E as ElementHint, N as NetworkEntry, W as WebDriver, L as LaunchOptions, C as ContextOptions, D as DriverContext } from '../interfaces-XvuefHHC.js';
+export { A as ActionTimeout, a as CheckOptions, b as ClickOptions, c as CookieOptions, d as DriverPage, F as FillOptions, G as GotoOptions, H as HoverOptions, e as NavigationOptions, P as PressOptions, R as ReloadOptions, S as ScreenshotOptions, f as SelectOptions, V as Viewport, g as WaitOptions, h as WaitState } from '../interfaces-XvuefHHC.js';
 import '@unotest/protocol';
 import '../config/schema.js';
 import 'zod';
@@ -27,6 +27,8 @@ interface FakeBehavior {
     inputValueByDefault?: string;
     /** Default isVisible() response. Default: true. */
     isVisibleByDefault?: boolean;
+    /** Default isDisabled() response. Default: false. */
+    isDisabledByDefault?: boolean;
     /** Default checkedState() response — null = "not a checkable element",
      *  the shape a plain <input type=text> reports. Default: null. */
     checkedStateByDefault?: boolean | null;