@unotest/web 0.44.0 → 0.46.0

package/dist/config/schema.d.ts

@@ -42,10 +42,10 @@ declare const RetryConfigSchema: z.ZodObject<{
     on: z.ZodArray<z.ZodEnum<["transient", "network", "crash"]>, "many">;
 }, "strict", z.ZodTypeAny, {
     count: number;
-    on: ("network" | "transient" | "crash")[];
+    on: ("transient" | "network" | "crash")[];
 }, {
     count: number;
-    on: ("network" | "transient" | "crash")[];
+    on: ("transient" | "network" | "crash")[];
 }>;
 type RetryConfig = z.infer<typeof RetryConfigSchema>;
 declare const FailureBundleConfigSchema: z.ZodObject<{
@@ -109,19 +109,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", "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", "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: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", "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", "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", "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: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", "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"]>>;
 }, "strict", 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" | "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" | "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: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" | "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" | "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" | "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: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" | "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 QueueConfigSchema: z.ZodObject<{
@@ -201,6 +201,11 @@ declare const SandboxConfigSchema: z.ZodObject<{
      *  against it and may not escape it. Defaults to the project root
      *  (the runner's cwd). */
     uploadDir: z.ZodOptional<z.ZodString>;
+    /** More directories a scenario may read files from, beside the project
+     *  and the run's downloads: `readFile`, `waitForFile` and the other file
+     *  oracles. For a file a background process writes outside the project.
+     *  Relative entries resolve against `shellCwd`. */
+    readRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
     shellCwd?: string | undefined;
     shellTimeoutMs?: number | undefined;
@@ -208,6 +213,7 @@ declare const SandboxConfigSchema: z.ZodObject<{
     database?: string | undefined;
     apiBaseUrl?: string | undefined;
     uploadDir?: string | undefined;
+    readRoots?: string[] | undefined;
 }, {
     shellCwd?: string | undefined;
     shellTimeoutMs?: number | undefined;
@@ -215,6 +221,7 @@ declare const SandboxConfigSchema: z.ZodObject<{
     database?: string | undefined;
     apiBaseUrl?: string | undefined;
     uploadDir?: string | undefined;
+    readRoots?: string[] | undefined;
 }>;
 type SandboxConfig = z.infer<typeof SandboxConfigSchema>;
 declare const WebServerConfigSchema: z.ZodObject<{
@@ -234,17 +241,104 @@ declare const WebServerConfigSchema: z.ZodObject<{
     /** How long to wait for the URL to come up after spawning. */
     timeoutMs: z.ZodDefault<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
+    command: string;
+    url: string;
+    reuseExistingServer: boolean;
+    timeoutMs: number;
+}, {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}>;
+type WebServerConfig = z.infer<typeof WebServerConfigSchema>;
+/** `webServer`: one server, or several (a front and its fake backends),
+ *  each with its own readiness URL. Always a list once parsed, so no
+ *  consumer asks which form it got. Two entries on one URL would probe
+ *  the same server twice and start neither for sure — refused. */
+declare const WebServersConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
+    /** Shell command that starts the app under test (`npm run dev`,
+     *  `python manage.py runserver`, …). Runs in the user's shell from the
+     *  project root. */
+    command: z.ZodString;
+    /** URL probed for readiness — any HTTP response counts as up. Usually
+     *  equals `baseUrl`; declared explicitly because a dev server may
+     *  answer on a different path/port than the tests navigate to. */
+    url: z.ZodString;
+    /** When the URL is already up, reuse that server instead of spawning a
+     *  second one (default true — covers a dev server the user or the
+     *  viewer already started). `false` makes an occupied URL an error,
+     *  Playwright-style for CI strictness. */
+    reuseExistingServer: z.ZodDefault<z.ZodBoolean>;
+    /** How long to wait for the URL to come up after spawning. */
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    command: string;
     url: string;
+    reuseExistingServer: boolean;
     timeoutMs: number;
+}, {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}>, z.ZodArray<z.ZodObject<{
+    /** Shell command that starts the app under test (`npm run dev`,
+     *  `python manage.py runserver`, …). Runs in the user's shell from the
+     *  project root. */
+    command: z.ZodString;
+    /** URL probed for readiness — any HTTP response counts as up. Usually
+     *  equals `baseUrl`; declared explicitly because a dev server may
+     *  answer on a different path/port than the tests navigate to. */
+    url: z.ZodString;
+    /** When the URL is already up, reuse that server instead of spawning a
+     *  second one (default true — covers a dev server the user or the
+     *  viewer already started). `false` makes an occupied URL an error,
+     *  Playwright-style for CI strictness. */
+    reuseExistingServer: z.ZodDefault<z.ZodBoolean>;
+    /** How long to wait for the URL to come up after spawning. */
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
     command: string;
+    url: string;
     reuseExistingServer: boolean;
+    timeoutMs: number;
 }, {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}>, "many">]>, {
+    command: string;
+    url: string;
+    reuseExistingServer: boolean;
+    timeoutMs: number;
+}[], {
+    command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+} | {
+    command: string;
     url: string;
+    reuseExistingServer?: boolean | undefined;
+    timeoutMs?: number | undefined;
+}[]>, {
+    command: string;
+    url: string;
+    reuseExistingServer: boolean;
+    timeoutMs: number;
+}[], {
     command: string;
+    url: string;
+    reuseExistingServer?: boolean | undefined;
     timeoutMs?: number | undefined;
+} | {
+    command: string;
+    url: string;
     reuseExistingServer?: boolean | undefined;
-}>;
-type WebServerConfig = z.infer<typeof WebServerConfigSchema>;
+    timeoutMs?: number | undefined;
+}[]>;
 declare const EnvConfigSchema: z.ZodObject<{
     /** Variable names whose base `.env` value is deliberately shared by
      *  every environment. Only names that become a HOST are checked, so
@@ -256,13 +350,13 @@ declare const EnvConfigSchema: z.ZodObject<{
     shared?: string[] | undefined;
 }>;
 type EnvConfig = z.infer<typeof EnvConfigSchema>;
-declare const UnotestConfigSchema: z.ZodObject<{
+declare const UnotestConfigSchema: z.ZodEffects<z.ZodObject<{
     baseUrl: z.ZodOptional<z.ZodString>;
     /** Dev-server lifecycle for the app under test (M-12). Unset → the app
      *  is expected to be running already (current behaviour). When set, the
      *  CLI ensures it per run; `npx @unotest/web app-server` / the viewer
      *  hold a long-lived instance and runs then reuse it. */
-    webServer: z.ZodOptional<z.ZodObject<{
+    webServer: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         /** Shell command that starts the app under test (`npm run dev`,
          *  `python manage.py runserver`, …). Runs in the user's shell from the
          *  project root. */
@@ -279,19 +373,75 @@ declare const UnotestConfigSchema: z.ZodObject<{
         /** How long to wait for the URL to come up after spawning. */
         timeoutMs: z.ZodDefault<z.ZodNumber>;
     }, "strict", z.ZodTypeAny, {
+        command: string;
         url: string;
+        reuseExistingServer: boolean;
         timeoutMs: number;
+    }, {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }>, z.ZodArray<z.ZodObject<{
+        /** Shell command that starts the app under test (`npm run dev`,
+         *  `python manage.py runserver`, …). Runs in the user's shell from the
+         *  project root. */
+        command: z.ZodString;
+        /** URL probed for readiness — any HTTP response counts as up. Usually
+         *  equals `baseUrl`; declared explicitly because a dev server may
+         *  answer on a different path/port than the tests navigate to. */
+        url: z.ZodString;
+        /** When the URL is already up, reuse that server instead of spawning a
+         *  second one (default true — covers a dev server the user or the
+         *  viewer already started). `false` makes an occupied URL an error,
+         *  Playwright-style for CI strictness. */
+        reuseExistingServer: z.ZodDefault<z.ZodBoolean>;
+        /** How long to wait for the URL to come up after spawning. */
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
         command: string;
+        url: string;
         reuseExistingServer: boolean;
+        timeoutMs: number;
     }, {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }>, "many">]>, {
+        command: string;
         url: string;
+        reuseExistingServer: boolean;
+        timeoutMs: number;
+    }[], {
         command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
         timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        url: string;
         reuseExistingServer?: boolean | undefined;
-    }>>;
+        timeoutMs?: number | undefined;
+    }[]>, {
+        command: string;
+        url: string;
+        reuseExistingServer: boolean;
+        timeoutMs: number;
+    }[], {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }[]>>;
     browsers: z.ZodArray<z.ZodEnum<["chromium", "firefox", "webkit"]>, "many">;
     channel: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["chrome", "msedge", "chrome-beta", "chromium"]>, z.ZodEffects<z.ZodLiteral<"bundled">, null, "bundled">, z.ZodNull]>>;
-    viewport: z.ZodOptional<z.ZodObject<{
+    viewport: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         width: z.ZodOptional<z.ZodNumber>;
         height: z.ZodOptional<z.ZodNumber>;
         /** CSS pixel → device pixel ratio: 2 makes a 390×844 page a 780×1688
@@ -305,7 +455,7 @@ declare const UnotestConfigSchema: z.ZodObject<{
         width?: number | undefined;
         height?: number | undefined;
         deviceScaleFactor?: number | undefined;
-    }>>;
+    }>>>;
     /** A device preset by its Playwright name (`"iPhone 14"`, `"Pixel 7"`):
      *  size, scale, touch, mobile mode and user agent at once. `viewport`
      *  next to it overrides the preset's size. The name is checked by the
@@ -329,23 +479,26 @@ declare const UnotestConfigSchema: z.ZodObject<{
      *  context per scenario. */
     launch: z.ZodOptional<z.ZodObject<{
         userDataDir: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodLiteral<"per-test">>;
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strict", z.ZodTypeAny, {
-        args?: string[] | undefined;
         userDataDir?: string | undefined;
-    }, {
+        profile?: "per-test" | undefined;
         args?: string[] | undefined;
+    }, {
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
+        args?: string[] | undefined;
     }>>;
     retry: z.ZodObject<{
         count: z.ZodNumber;
         on: z.ZodArray<z.ZodEnum<["transient", "network", "crash"]>, "many">;
     }, "strict", z.ZodTypeAny, {
         count: number;
-        on: ("network" | "transient" | "crash")[];
+        on: ("transient" | "network" | "crash")[];
     }, {
         count: number;
-        on: ("network" | "transient" | "crash")[];
+        on: ("transient" | "network" | "crash")[];
     }>;
     failureBundle: z.ZodObject<{
         /** Tier 1 is always on by D-16. Schema lock — not user-toggleable. */
@@ -432,6 +585,11 @@ declare const UnotestConfigSchema: z.ZodObject<{
      *  Unset → 60000. A pass cut by it leaves the rest of the stand as the
      *  test set it, and the run result says which blocks did not finish. */
     teardownTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    /** Wall-clock budget of one test, a deadline: an action still running
+     *  when it runs out is cut there and the test fails, its teardown blocks
+     *  still play. Unset → 300000. `UNOTEST_MAX_DURATION_MS` overrides it for
+     *  a run; `setTestTimeout(ms)` inside a test overrides both for that test. */
+    testTimeoutMs: z.ZodOptional<z.ZodNumber>;
     /** Cross-environment declarations (`.env.<name>` overlays). */
     env: z.ZodObject<{
         /** Variable names whose base `.env` value is deliberately shared by
@@ -445,13 +603,13 @@ declare const UnotestConfigSchema: z.ZodObject<{
     }>;
     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", "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", "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: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", "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"]>>;
     }, "strict", 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" | "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" | "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: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" | "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" | "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" | "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: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" | "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">;
@@ -528,6 +686,11 @@ declare const UnotestConfigSchema: z.ZodObject<{
          *  against it and may not escape it. Defaults to the project root
          *  (the runner's cwd). */
         uploadDir: z.ZodOptional<z.ZodString>;
+        /** More directories a scenario may read files from, beside the project
+         *  and the run's downloads: `readFile`, `waitForFile` and the other file
+         *  oracles. For a file a background process writes outside the project.
+         *  Relative entries resolve against `shellCwd`. */
+        readRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strict", z.ZodTypeAny, {
         shellCwd?: string | undefined;
         shellTimeoutMs?: number | undefined;
@@ -535,6 +698,7 @@ declare const UnotestConfigSchema: z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     }, {
         shellCwd?: string | undefined;
         shellTimeoutMs?: number | undefined;
@@ -542,14 +706,16 @@ declare const UnotestConfigSchema: z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
-    defaultTimeoutMs: number;
-    defaultNavigationTimeoutMs: number;
+    env: {
+        shared: string[];
+    };
     browsers: ("chromium" | "firefox" | "webkit")[];
     retry: {
         count: number;
-        on: ("network" | "transient" | "crash")[];
+        on: ("transient" | "network" | "crash")[];
     };
     failureBundle: {
         tier1: true;
@@ -568,12 +734,11 @@ declare const UnotestConfigSchema: z.ZodObject<{
     dialogPolicy: "accept" | "dismiss" | "manual";
     testDir: string;
     helpersDir: string;
-    env: {
-        shared: string[];
-    };
+    defaultTimeoutMs: number;
+    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" | "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" | "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: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" | "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";
@@ -595,39 +760,128 @@ declare const UnotestConfigSchema: z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     };
-    locale?: string | undefined;
-    timezone?: string | undefined;
     baseUrl?: string | undefined;
     webServer?: {
-        url: string;
-        timeoutMs: number;
         command: string;
+        url: string;
         reuseExistingServer: boolean;
-    } | undefined;
-    channel?: "chrome" | "msedge" | "chrome-beta" | "chromium" | null | undefined;
+        timeoutMs: number;
+    }[] | undefined;
+    channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | null | undefined;
     viewport?: {
         width?: number | undefined;
         height?: number | undefined;
         deviceScaleFactor?: number | undefined;
-    } | undefined;
+    } | null | undefined;
     device?: string | undefined;
+    timezone?: string | undefined;
+    locale?: string | undefined;
     maxContexts?: number | undefined;
     launch?: {
-        args?: string[] | undefined;
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
+        args?: string[] | undefined;
     } | undefined;
     storageState?: string | undefined;
     teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
 }, {
+    env: {
+        shared?: string[] | undefined;
+    };
+    browsers: ("chromium" | "firefox" | "webkit")[];
+    retry: {
+        count: number;
+        on: ("transient" | "network" | "crash")[];
+    };
+    failureBundle: {
+        tier2: boolean;
+        tier3: {
+            network: boolean;
+            video: boolean;
+        };
+        retention: {
+            runs: number;
+            days: number;
+        };
+        storageDir: string;
+        pageHtml: "redacted" | "full";
+        tier1?: true | undefined;
+    };
+    dialogPolicy: "accept" | "dismiss" | "manual";
+    testDir: string;
+    helpersDir: string;
     defaultTimeoutMs: number;
     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" | "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" | "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";
+    };
+    queue: {
+        enabled?: boolean | undefined;
+        concurrency?: number | undefined;
+    };
+    sandbox: {
+        shellCwd?: string | undefined;
+        shellTimeoutMs?: number | undefined;
+        exportSecrets?: string[] | undefined;
+        database?: string | undefined;
+        apiBaseUrl?: string | undefined;
+        uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
+    };
+    baseUrl?: string | undefined;
+    webServer?: {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
+        timeoutMs?: number | undefined;
+    }[] | undefined;
+    channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | "bundled" | null | undefined;
+    viewport?: {
+        width?: number | undefined;
+        height?: number | undefined;
+        deviceScaleFactor?: number | undefined;
+    } | null | undefined;
+    device?: string | undefined;
+    timezone?: string | undefined;
+    locale?: string | undefined;
+    maxContexts?: number | undefined;
+    launch?: {
+        userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
+        args?: string[] | undefined;
+    } | undefined;
+    storageState?: string | undefined;
+    teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
+    schedules?: {
+        collection: string;
+        cron: string;
+        env?: string | undefined;
+        prepare?: string | undefined;
+    }[] | undefined;
+}>, {
+    env: {
+        shared: string[];
+    };
     browsers: ("chromium" | "firefox" | "webkit")[];
     retry: {
         count: number;
-        on: ("network" | "transient" | "crash")[];
+        on: ("transient" | "network" | "crash")[];
     };
     failureBundle: {
+        tier1: true;
         tier2: boolean;
         tier3: {
             network: boolean;
@@ -639,17 +893,94 @@ declare const UnotestConfigSchema: z.ZodObject<{
         };
         storageDir: string;
         pageHtml: "redacted" | "full";
-        tier1?: true | undefined;
     };
     dialogPolicy: "accept" | "dismiss" | "manual";
     testDir: string;
     helpersDir: string;
+    defaultTimeoutMs: number;
+    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" | "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" | "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";
+    };
+    queue: {
+        enabled: boolean;
+        concurrency: number;
+    };
+    schedules: {
+        collection: string;
+        cron: string;
+        env?: string | undefined;
+        prepare?: string | undefined;
+    }[];
+    sandbox: {
+        shellCwd?: string | undefined;
+        shellTimeoutMs?: number | undefined;
+        exportSecrets?: string[] | undefined;
+        database?: string | undefined;
+        apiBaseUrl?: string | undefined;
+        uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
+    };
+    baseUrl?: string | undefined;
+    webServer?: {
+        command: string;
+        url: string;
+        reuseExistingServer: boolean;
+        timeoutMs: number;
+    }[] | undefined;
+    channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | null | undefined;
+    viewport?: {
+        width?: number | undefined;
+        height?: number | undefined;
+        deviceScaleFactor?: number | undefined;
+    } | null | undefined;
+    device?: string | undefined;
+    timezone?: string | undefined;
+    locale?: string | undefined;
+    maxContexts?: number | undefined;
+    launch?: {
+        userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
+        args?: string[] | undefined;
+    } | undefined;
+    storageState?: string | undefined;
+    teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
+}, {
     env: {
         shared?: string[] | undefined;
     };
+    browsers: ("chromium" | "firefox" | "webkit")[];
+    retry: {
+        count: number;
+        on: ("transient" | "network" | "crash")[];
+    };
+    failureBundle: {
+        tier2: boolean;
+        tier3: {
+            network: boolean;
+            video: boolean;
+        };
+        retention: {
+            runs: number;
+            days: number;
+        };
+        storageDir: string;
+        pageHtml: "redacted" | "full";
+        tier1?: true | undefined;
+    };
+    dialogPolicy: "accept" | "dismiss" | "manual";
+    testDir: string;
+    helpersDir: string;
+    defaultTimeoutMs: number;
+    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" | "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" | "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: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" | "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";
@@ -665,30 +996,38 @@ declare const UnotestConfigSchema: z.ZodObject<{
         database?: string | undefined;
         apiBaseUrl?: string | undefined;
         uploadDir?: string | undefined;
+        readRoots?: string[] | undefined;
     };
-    locale?: string | undefined;
-    timezone?: string | undefined;
     baseUrl?: string | undefined;
     webServer?: {
-        url: string;
         command: string;
+        url: string;
+        reuseExistingServer?: boolean | undefined;
         timeoutMs?: number | undefined;
+    } | {
+        command: string;
+        url: string;
         reuseExistingServer?: boolean | undefined;
-    } | undefined;
-    channel?: "chrome" | "msedge" | "chrome-beta" | "chromium" | "bundled" | null | undefined;
+        timeoutMs?: number | undefined;
+    }[] | undefined;
+    channel?: "chromium" | "chrome" | "msedge" | "chrome-beta" | "bundled" | null | undefined;
     viewport?: {
         width?: number | undefined;
         height?: number | undefined;
         deviceScaleFactor?: number | undefined;
-    } | undefined;
+    } | null | undefined;
     device?: string | undefined;
+    timezone?: string | undefined;
+    locale?: string | undefined;
     maxContexts?: number | undefined;
     launch?: {
-        args?: string[] | undefined;
         userDataDir?: string | undefined;
+        profile?: "per-test" | undefined;
+        args?: string[] | undefined;
     } | undefined;
     storageState?: string | undefined;
     teardownTimeoutMs?: number | undefined;
+    testTimeoutMs?: number | undefined;
     schedules?: {
         collection: string;
         cron: string;
@@ -700,4 +1039,4 @@ type UnotestConfig = z.infer<typeof UnotestConfigSchema>;
 type UnotestConfigInput = z.input<typeof UnotestConfigSchema>;
 declare const DEFAULT_CONFIG: UnotestConfig;
 
-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 };
+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 };