@unotest/web 0.46.0 → 0.48.0

package/dist/dsl/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LocatorValue, o as DriverDownload, D as DriverContext, W as WebDriver, h as DriverPage } from '../interfaces-CYoL4Taq.js';
-export { p as LocatorStep, q as appendStep, r as describeLocator, s as isLocatorValue, t as rootedAt } from '../interfaces-CYoL4Taq.js';
+import { L as LocatorValue, o as DriverDownload, D as DriverContext, W as WebDriver, h as DriverPage } from '../interfaces-CTMGjJIs.js';
+export { p as LocatorStep, q as appendStep, r as describeLocator, s as isLocatorValue, t as rootedAt } from '../interfaces-CTMGjJIs.js';
 import { Matcher, RegexLiteral, JudgeRequest, JudgeVerdict, VisualFailureRecord, SoftFailureRecord, TeardownStateRecord, TeardownFailureRecord } from '@unotest/protocol';
 import { ExecutionWalker, ExecutionEvent, RunResult, RunOptions } from '@unotest/dsl/executor';
 export { ExecutionError, ExecutionEvent, RunOptions, RunResult } from '@unotest/dsl/executor';
@@ -147,6 +147,11 @@ interface Judge {
     /** Produce a structured verdict. A clean `fail` is a RESULT (returned);
      *  infrastructure faults throw JudgeUnavailableError / ConfigError. */
     judge(request: JudgeRequest): Promise<JudgeVerdict>;
+    /** Resolve when judge() could run; throw the ConfigError /
+     *  JudgeUnavailableError the first judge() would. Asked once before a
+     *  run that reaches assertJudge, so a broken setup fails before the
+     *  browser instead of at the first verdict (#72). */
+    ready(): Promise<void>;
 }
 
 interface JudgeVerdictRecord extends JudgeVerdict {
@@ -344,6 +349,11 @@ declare class ContextSet {
     /** Open one more context, make it active, return its index. */
     open(): Promise<number>;
     select(index: unknown): void;
+    /** Put `next` in the active context's place — same index, so whatever is
+     *  bound to the index (teardowns, the journal's context number) follows —
+     *  and close the one it replaces. Listeners hear it as a switch: the
+     *  active context is a different one now. */
+    replaceActive(next: DriverContext): Promise<void>;
     onSwitch(listener: (index: number) => void): () => void;
     /** Close every context, newest first; the failures come back. */
     closeAll(): Promise<ContextCloseFailure[]>;
@@ -354,7 +364,7 @@ type DslPrimitive = string | number | boolean | null;
 type DslObject = {
     readonly [key: string]: DslValue;
 };
-type DslArray = readonly DslValue[];
+type DslArray = DslValue[];
 type DslValue = DslPrimitive | DslObject | DslArray;
 /** The browser contexts a runtime acts in: its own set, started from the
  *  context the runner opened — or one it SHARES with its host (a flow
@@ -367,10 +377,15 @@ type RuntimeContexts = {
     readonly openContext?: ContextFactory;
     /** Ceiling on contexts per entry (`config.maxContexts`). */
     readonly maxContexts?: number;
+    /** Opens the entry's context again with the same options on the real
+     *  window (`setViewport(null)`). Absent → it cannot be (a browser
+     *  profile fixes the window when it starts; an attached session). */
+    readonly openOnWindow?: ContextFactory;
     readonly contexts?: undefined;
 } | {
     readonly contexts: ContextSet;
     readonly context?: undefined;
+    readonly openOnWindow?: undefined;
 };
 type TestRuntimeDeps = RuntimeContexts & TestRuntimeServices;
 interface TestRuntimeServices {
@@ -426,6 +441,8 @@ declare class TestRuntime {
     readonly driver: WebDriver;
     /** Every browser context of this entry and which one is active. */
     readonly contexts: ContextSet;
+    /** See `RuntimeContexts.openOnWindow`. */
+    readonly openOnWindow?: ContextFactory;
     readonly logger: Logger;
     readonly sandbox: SandboxConfig;
     readonly baseUrl?: string;
@@ -503,6 +520,9 @@ declare class FunctionRegistry {
     has(name: string): boolean;
     get(name: string): DslFunction | undefined;
     names(): string[];
+    /** The run-time half of the validator's `suggestForUnknown`: the walker
+     *  quotes it in "Unknown DSL function", from the same table. */
+    suggestForUnknown(name: string): string | null;
 }
 
 declare class AstExecutor extends ExecutionWalker<TestRuntime> {