@unotest/web 0.9.1 → 0.11.0

package/dist/dsl/index.d.ts

@@ -1,5 +1,5 @@
-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 { i as LocatorValue, W as WebDriver, D as DriverContext, d as DriverPage } from '../interfaces-MxHi1Air.js';
+export { j as LocatorStep, k as appendStep, l as describeLocator, m as isLocatorValue, r as rootedAt } from '../interfaces-MxHi1Air.js';
 import { Matcher, RegexLiteral } from '@unotest/protocol';
 import { ExecutionWalker, ExecutionEvent, RunResult, RunOptions } from '@unotest/dsl/executor';
 export { ExecutionError, ExecutionEvent, RunOptions, RunResult } from '@unotest/dsl/executor';
@@ -46,6 +46,7 @@ declare function filter(loc: LocatorValue, options: {
 declare function first(loc: LocatorValue): LocatorValue;
 declare function last(loc: LocatorValue): LocatorValue;
 declare function nth(loc: LocatorValue, index: number): LocatorValue;
+declare function randomNth(loc: LocatorValue): LocatorValue;
 declare function contentFrame(loc: LocatorValue): LocatorValue;
 declare function chainGetByRole(loc: LocatorValue, role: string, options?: {
     name?: Matcher;
@@ -83,6 +84,12 @@ interface Logger {
     child(prefix: string): Logger;
 }
 
+interface ScreenshotSink {
+    /** Persist one PNG capture. Returns the project-relative path the
+     *  artifact landed at. */
+    save(name: string, png: Buffer): Promise<string>;
+}
+
 type DslPrimitive = string | number | boolean | null;
 type DslObject = {
     readonly [key: string]: DslValue;
@@ -107,6 +114,10 @@ interface TestRuntimeDeps {
     readonly baseUrl?: string;
     /** Injectable clock — defaults to Date.now. Tests pass a fake. */
     readonly nowFn?: () => number;
+    /** Sink for on-demand `screenshot()` captures. Wired by the CLI runner
+     *  to the run dir; absent in ad-hoc / explore runtimes (the DSL
+     *  function then logs and skips). */
+    readonly screenshots?: ScreenshotSink;
 }
 declare class TestRuntime {
     readonly runId: string;
@@ -115,6 +126,7 @@ declare class TestRuntime {
     readonly logger: Logger;
     readonly sandbox: SandboxConfig;
     readonly baseUrl?: string;
+    readonly screenshots?: ScreenshotSink;
     private readonly variables;
     private readonly nowFn;
     private readonly scope;
@@ -254,6 +266,10 @@ declare class TestRuntimeManager {
      *  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;
+    /** Every open page of the runtime's context (debug picker arms its overlay
+     *  on all of them at once, Playwright-codegen style). Empty when the runtime
+     *  is gone or has no context yet. */
+    pages(id: string): readonly DriverPage[];
     /** The runtime's driver context (for capture artifacts — console/network).
      *  Null when the runtime isn't registered. */
     currentContext(id: string): DriverContext | null;
@@ -266,4 +282,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, 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 };
+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, randomNth, re };