@unotest/web 0.5.0 → 0.6.1

package/dist/dsl/index.d.ts

@@ -3,6 +3,7 @@ export { i as LocatorStep, j as appendStep, k as describeLocator, l as isLocator
 import { Matcher, RegexLiteral } from '@unotest/protocol';
 import { Statement, BlockStatement } from '@unotest/dsl';
 import { SandboxConfig } from '../config/schema.js';
+export { L as LintDiagnostic, a as LintOptions, b as LintSeverity, l as lintAst } from '../linter-DzAzJpab.js';
 import 'zod';
 
 /** Test/codegen convenience: build a RegexLiteral inline. The DSL
@@ -80,12 +81,14 @@ interface ExecutionError {
 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;
@@ -93,6 +96,7 @@ type ExecutionEvent = {
 } | {
     kind: 'step-end';
     node: Statement;
+    file: string;
     line: number;
     col: number;
     ok: false;
@@ -101,6 +105,7 @@ type ExecutionEvent = {
 } | {
     kind: 'paused';
     reason: 'step' | 'failure' | 'breakpoint';
+    file: string;
     line: number;
     col: number;
 };
@@ -137,6 +142,12 @@ interface RunResult {
     error?: ExecutionError;
 }
 
+/** Read-only lookup over external scenario variables. */
+interface VariableStore {
+    has(name: string): boolean;
+    get(name: string): string | undefined;
+}
+
 interface Logger {
     info(msg: string, ...rest: unknown[]): void;
     warn(msg: string, ...rest: unknown[]): void;
@@ -161,6 +172,9 @@ interface TestRuntimeDeps {
      *  `dbQuery`/`dbExec`, `apiCall` read these — scenarios can NOT pass a
      *  database connection or absolute URL through arguments. */
     readonly sandbox?: SandboxConfig;
+    /** External variable store (`unotest/.env` + `.secrets`). Resolves bare
+     *  UPPER_SNAKE identifiers. Defaults to an empty store when omitted. */
+    readonly variables?: VariableStore;
     /** Injectable clock — defaults to Date.now. Tests pass a fake. */
     readonly nowFn?: () => number;
 }
@@ -170,6 +184,7 @@ declare class TestRuntime {
     readonly context: DriverContext;
     readonly logger: Logger;
     readonly sandbox: SandboxConfig;
+    private readonly variables;
     private readonly nowFn;
     private readonly scope;
     private _callDepth;
@@ -220,7 +235,15 @@ declare class FunctionRegistry {
 declare class AstExecutor {
     private readonly registry;
     constructor(registry: FunctionRegistry);
-    run(program: BlockStatement, testName: string, runtime: TestRuntime, opts: RunOptions, helpers?: BlockStatement[]): AsyncGenerator<ExecutionEvent, RunResult>;
+    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;
@@ -317,22 +340,4 @@ declare class TestRuntimeManager {
 /** Build a fully-populated FunctionRegistry. */
 declare function buildDefaultRegistry(): FunctionRegistry;
 
-type LintSeverity = 'error' | 'warning' | 'info';
-interface LintDiagnostic {
-    rule: string;
-    severity: LintSeverity;
-    message: string;
-    line: number;
-    col: number;
-}
-interface LintOptions {
-    /** Per-rule severity override. Default severities live with each rule. */
-    ruleSeverity?: Partial<Record<string, LintSeverity>>;
-    /** Pass through if the agent provided documented justification — e.g. a
-     *  `// reason:` comment immediately above the line. The lexer doesn't
-     *  preserve comments today; for v1 we accept a flag from the caller. */
-    allowDisambigByIndex?: boolean;
-}
-declare function lintAst(ast: BlockStatement, opts?: LintOptions): LintDiagnostic[];
-
-export { AstExecutor, type DslArg, type DslArray, type DslFunction, type DslObject, type DslValue, type ExecutionError, type ExecutionEvent, FunctionRegistry, type LintDiagnostic, type LintOptions, type LintSeverity, 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, lintAst, locator, nth, re };
+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 };