@unotest/web 0.6.2 → 0.9.1

package/dist/dsl/index.d.ts

@@ -1,10 +1,13 @@
-import { h as LocatorValue, W as WebDriver, D as DriverContext, d as DriverPage } from '../interfaces-iTfjd1zT.js';
-export { i as LocatorStep, j as appendStep, k as describeLocator, l as isLocatorValue, r as rootedAt } from '../interfaces-iTfjd1zT.js';
+import { i as LocatorValue, W as WebDriver, D as DriverContext, d as DriverPage } from '../interfaces-dbZG10RS.js';
+export { j as LocatorStep, k as appendStep, l as describeLocator, m as isLocatorValue, r as rootedAt } from '../interfaces-dbZG10RS.js';
 import { Matcher, RegexLiteral } from '@unotest/protocol';
-import { Statement, BlockStatement } from '@unotest/dsl';
+import { ExecutionWalker, ExecutionEvent, RunResult, RunOptions } from '@unotest/dsl/executor';
+export { ExecutionError, ExecutionEvent, RunOptions, RunResult } from '@unotest/dsl/executor';
 import { SandboxConfig } from '../config/schema.js';
-export { L as LintDiagnostic, a as LintOptions, b as LintSeverity, l as lintAst } from '../linter-DzAzJpab.js';
+import { RuntimeExecState } from '@unotest/core';
+export { L as LintDiagnostic, b as LintOptions, a as LintSeverity, l as lintAst } from '../linter-CM2CpIyW.js';
 import 'zod';
+import '@unotest/dsl';
 
 /** Test/codegen convenience: build a RegexLiteral inline. The DSL
  *  parser produces these for `/pattern/flags` literals at runtime;
@@ -65,83 +68,6 @@ declare function chainGetByTitle(loc: LocatorValue, text: Matcher, options?: {
     exact?: boolean;
 }): LocatorValue;
 
-interface ExecutionError {
-    message: string;
-    /** Error class name (e.g. "AssertionError", "LocatorError"). Lets consumers
-     *  classify failure vs. infra error without parsing the message. */
-    name?: string;
-    stack?: string;
-    /** Path to a screenshot saved on failure (driver-side). */
-    screenshotPath?: string;
-    /** Path to the a11y / semantic-dom snapshot saved on failure. */
-    snapshotPath?: string;
-    /** Optional rich detail (top-3 NearMisses, etc.). Free-form for the explainer. */
-    details?: unknown;
-}
-type ExecutionEvent = {
-    kind: 'step-start';
-    node: Statement;
-    file: string;
-    line: number;
-    col: number;
-    callStack?: readonly string[];
-} | {
-    kind: 'step-end';
-    node: Statement;
-    file: string;
-    line: number;
-    col: number;
-    ok: true;
-    callStack?: readonly string[];
-} | {
-    kind: 'step-end';
-    node: Statement;
-    file: string;
-    line: number;
-    col: number;
-    ok: false;
-    error: ExecutionError;
-    callStack?: readonly string[];
-} | {
-    kind: 'paused';
-    reason: 'step' | 'failure' | 'breakpoint';
-    file: string;
-    line: number;
-    col: number;
-};
-interface RunOptions {
-    /** "auto" = run until completion / failure. "step" = pause after each statement. */
-    mode: 'auto' | 'step';
-    /** When true, on uncaught error we emit `paused: 'failure'` instead of throwing. */
-    pauseOnFailure: boolean;
-    /** Safety budget — abort with synthetic failure if exceeded. */
-    maxSteps?: number;
-    /** Wall-clock budget — same semantics. */
-    maxDurationMs?: number;
-    /** Maximum user-function nesting depth. Default 32. Guards against runaway
-     *  recursion that wouldn't trip `maxSteps` (deep expression-tree calls). */
-    maxCallDepth?: number;
-    /** Mutable set of "line:col" keys. Executor checks membership before each
-     *  statement; on hit, emits `paused: 'breakpoint'`. set-bp/clear-bp commands
-     *  from the debug-commands-watcher mutate this set in place — same instance
-     *  reference is shared with the watcher. */
-    breakpoints?: Set<string>;
-    /** Ref-object atomic flag for "pause on next statement". The pause-command
-     *  watcher sets `value = true`; the executor reads it at every step-start,
-     *  yields `paused: 'step'` if set, and resets to false. Ref-object (not raw
-     *  boolean) so the watcher's mutation is visible to the executor without
-     *  re-passing options. */
-    pauseRequested?: {
-        value: boolean;
-    };
-}
-interface RunResult {
-    outcome: 'completed' | 'failed' | 'aborted';
-    stepsExecuted: number;
-    durationMs: number;
-    error?: ExecutionError;
-}
-
 /** Read-only lookup over external scenario variables. */
 interface VariableStore {
     has(name: string): boolean;
@@ -175,6 +101,10 @@ interface TestRuntimeDeps {
     /** External variable store (`unotest/.env` + `.secrets`). Resolves bare
      *  UPPER_SNAKE identifiers. Defaults to an empty store when omitted. */
     readonly variables?: VariableStore;
+    /** Resolved base URL (`config.baseUrl`, auto-wired from APP_BASE_URL). Used
+     *  to fail a relative `goto('/path')` with a clear message when no base is
+     *  configured, instead of an opaque Playwright "invalid URL". */
+    readonly baseUrl?: string;
     /** Injectable clock — defaults to Date.now. Tests pass a fake. */
     readonly nowFn?: () => number;
 }
@@ -184,6 +114,7 @@ declare class TestRuntime {
     readonly context: DriverContext;
     readonly logger: Logger;
     readonly sandbox: SandboxConfig;
+    readonly baseUrl?: string;
     private readonly variables;
     private readonly nowFn;
     private readonly scope;
@@ -232,34 +163,11 @@ declare class FunctionRegistry {
     names(): string[];
 }
 
-declare class AstExecutor {
-    private readonly registry;
+declare class AstExecutor extends ExecutionWalker<TestRuntime> {
     constructor(registry: FunctionRegistry);
-    private entryFile;
-    private fnFile;
-    /** Project-root-relative posix file the current step lives in: origin of
-     *  the innermost user-function frame, else the entry file. `callStack`
-     *  only ever holds user-function names (pushed in callUserFunction), so
-     *  every frame has a `fnFile` entry; the `?? entryFile` is a defensive
-     *  fallback, not a normal path. */
-    private fileForStack;
-    run(program: BlockStatement, testName: string, runtime: TestRuntime, opts: RunOptions, helpers?: BlockStatement[], entryFile?: string, fnFile?: ReadonlyMap<string, string>): AsyncGenerator<ExecutionEvent, RunResult>;
-    private runBlock;
-    private runStatement;
-    private execStatement;
-    private evalExpression;
-    private callUserFunction;
-    private runLoop;
-    /** Run one loop-body pass. Returns `true` if a `break` fired (caller stops
-     *  the loop), `false` for normal completion or `continue` (both end this
-     *  iteration the same way). Each pass counts as a step so an empty-bodied
-     *  infinite loop still trips `maxSteps`; `checkBudgets` enforces wall-clock. */
-    private runLoopIteration;
-    private applyIncrement;
-    private checkBudgets;
 }
 
-type RuntimeState = 'starting' | 'running' | 'paused-step' | 'paused-failure' | 'completed' | 'failed' | 'aborted';
+type RuntimeState = RuntimeExecState;
 interface ActiveRuntime {
     id: string;
     scenarioName: string;
@@ -317,6 +225,14 @@ interface TestRuntimeManagerDeps {
 declare class TestRuntimeManager {
     private readonly deps;
     private readonly runtimes;
+    /** Final snapshot of recently-aborted runtimes. `abort()` removes the live
+     *  runtime from `runtimes`, so a trailing `inspect()` (the runtime-state
+     *  writer's final flush, or the agent reading after `abort_runtime`) would
+     *  otherwise miss the terminal `aborted` state and report the stale pre-abort
+     *  `paused-*`. We keep the captured terminal snapshot here so inspect reflects
+     *  `aborted`. Bounded — only the last few matter (a writer flushes once). */
+    private readonly terminalTombstones;
+    private static readonly MAX_TOMBSTONES;
     private nextId;
     constructor(deps: TestRuntimeManagerDeps);
     register(opts: {
@@ -330,7 +246,17 @@ declare class TestRuntimeManager {
     step(id: string): Promise<ExecutionEvent | RunResult>;
     resume(id: string): Promise<ExecutionEvent | RunResult>;
     abort(id: string): Promise<void>;
+    /** Snapshot a just-aborted (still-live) runtime into the tombstone map so a
+     *  later inspect() reflects `aborted`. Bounded LRU; best-effort. */
+    private rememberTombstone;
     inspect(id: string): RuntimeSnapshot;
+    /** The live active page of a runtime — used by the locator picker to
+     *  attach its overlay to the page held open during a debug pause.
+     *  Returns null when the runtime is gone or has no page yet. */
+    currentPage(id: string): DriverPage | null;
+    /** The runtime's driver context (for capture artifacts — console/network).
+     *  Null when the runtime isn't registered. */
+    currentContext(id: string): DriverContext | null;
     list(): RuntimeSummary[];
     private armTtl;
     private clearTtl;
@@ -340,4 +266,4 @@ declare class TestRuntimeManager {
 /** Build a fully-populated FunctionRegistry. */
 declare function buildDefaultRegistry(): FunctionRegistry;
 
-export { AstExecutor, type DslArg, type DslArray, type DslFunction, type DslObject, type DslValue, type ExecutionError, type ExecutionEvent, FunctionRegistry, LocatorValue, type RunOptions, type RunResult, TestRuntime, TestRuntimeManager, buildDefaultRegistry, chainGetByAltText, chainGetByLabel, chainGetByPlaceholder, chainGetByRole, chainGetByTestId, chainGetByText, chainGetByTitle, contentFrame, filter, first, getByAltText, getByLabel, getByPlaceholder, getByRole, getByTestId, getByText, getByTitle, last, locator, nth, re };
+export { AstExecutor, type DslArg, type DslArray, type DslFunction, type DslObject, type DslValue, FunctionRegistry, LocatorValue, TestRuntime, TestRuntimeManager, buildDefaultRegistry, chainGetByAltText, chainGetByLabel, chainGetByPlaceholder, chainGetByRole, chainGetByTestId, chainGetByText, chainGetByTitle, contentFrame, filter, first, getByAltText, getByLabel, getByPlaceholder, getByRole, getByTestId, getByText, getByTitle, last, locator, nth, re };