doc-detective-common 4.23.0 → 4.24.0

package/dist/types/generated/test_v3.d.ts

@@ -108,7 +108,7 @@ export type Routing3 = {
 /**
  * A step in a test.
  */
-export type Step = (Common & CheckLink) | (Common1 & Click) | (Common2 & Find) | (Common3 & GoTo) | (Common4 & HttpRequest) | (Common5 & RunShell) | (Common6 & RunCode) | (Common7 & RunBrowserScript) | (Common8 & Type) | (Common9 & Screenshot) | (Common10 & SaveCookie) | (Common11 & Record) | (Common12 & StopRecord) | (Common13 & CloseSurface) | (Common14 & StartSurface) | (Common15 & LoadVariables) | (Common16 & DragAndDrop) | (Common17 & LoadCookie) | (Common18 & Wait);
+export type Step = (Common & CheckLink) | (Common1 & Click) | (Common2 & Find) | (Common3 & GoTo) | (Common4 & HttpRequest) | (Common5 & RunShell) | (Common6 & RunCode) | (Common7 & RunBrowserScript) | (Common8 & Type) | (Common9 & Screenshot) | (Common10 & SaveCookie) | (Common11 & Record) | (Common12 & StopRecord) | (Common13 & CloseSurface) | (Common14 & StartSurface) | (Common15 & LoadVariables) | (Common16 & DragAndDrop) | (Common17 & LoadCookie) | (Common18 & Swipe) | (Common19 & Wait);
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -2043,6 +2043,162 @@ export type Routing79 = {
 } | {
     [k: string]: unknown;
 };
+/**
+ * Swipe (or scroll) a surface in a direction or between two points. The direction is the virtual finger's motion: swiping up moves content up, revealing content further down the page. Works on app and browser surfaces.
+ */
+export type Swipe1 = SwipeSimple | SwipeDirectional | SwipePointToPoint;
+/**
+ * Direction the virtual finger moves. `up` reveals content below; `left` reveals content to the right (for example, the next carousel card).
+ */
+export type SwipeSimple = "up" | "down" | "left" | "right";
+/**
+ * Direction the virtual finger moves. `up` reveals content below; `left` reveals content to the right (for example, the next carousel card).
+ */
+export type SwipeSimple1 = "up" | "down" | "left" | "right";
+/**
+ * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
+ */
+export type SurfaceByBrowserEngine5 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+/**
+ * Which window to act on. Omit to use the active window.
+ */
+export type WindowTabSelector16 = ByIndex20 | ByName20 | ByCriteria20;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex20 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName20 = string;
+/**
+ * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
+ */
+export type WindowTabSelector17 = ByIndex21 | ByName21 | ByCriteria21;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex21 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName21 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector4 = ByIndex22 | ByName22 | ByCriteria22;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex22 = number;
+/**
+ * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName22 = string;
+/**
+ * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
+ */
+export type SurfaceByBrowserEngine6 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+/**
+ * Which window to act on. Omit to use the active window.
+ */
+export type WindowTabSelector18 = ByIndex23 | ByName23 | ByCriteria23;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex23 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName23 = string;
+/**
+ * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
+ */
+export type WindowTabSelector19 = ByIndex24 | ByName24 | ByCriteria24;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex24 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName24 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector5 = ByIndex25 | ByName25 | ByCriteria25;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex25 = number;
+/**
+ * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName25 = string;
+/**
+ * A condition expression, or an array of expressions combined with logical AND.
+ */
+export type Condition39 = string | [string, ...string[]];
+/**
+ * A condition expression, or an array of expressions combined with logical AND.
+ */
+export type Condition40 = string | [string, ...string[]];
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing80 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing81 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing82 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing83 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
 /**
  * Pause (in milliseconds) before performing the next action.
  */
@@ -2059,19 +2215,19 @@ export type OpenApi1 = {
 /**
  * A step in a test.
  */
-export type Step1 = (Common19 & CheckLink2) | (Common20 & Click2) | (Common21 & Find2) | (Common22 & GoTo2) | (Common23 & HttpRequest2) | (Common24 & RunShell2) | (Common25 & RunCode2) | (Common26 & RunBrowserScript2) | (Common27 & Type1) | (Common28 & Screenshot2) | (Common29 & SaveCookie2) | (Common30 & Record2) | (Common31 & StopRecord2) | (Common32 & CloseSurface2) | (Common33 & StartSurface2) | (Common34 & LoadVariables2) | (Common35 & DragAndDrop2) | (Common36 & LoadCookie2) | (Common37 & Wait2);
+export type Step1 = (Common20 & CheckLink2) | (Common21 & Click2) | (Common22 & Find2) | (Common23 & GoTo2) | (Common24 & HttpRequest2) | (Common25 & RunShell2) | (Common26 & RunCode2) | (Common27 & RunBrowserScript2) | (Common28 & Type1) | (Common29 & Screenshot2) | (Common30 & SaveCookie2) | (Common31 & Record2) | (Common32 & StopRecord2) | (Common33 & CloseSurface2) | (Common34 & StartSurface2) | (Common35 & LoadVariables2) | (Common36 & DragAndDrop2) | (Common37 & LoadCookie2) | (Common38 & Swipe2) | (Common39 & Wait2);
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition39 = string | [string, ...string[]];
+export type Condition41 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition40 = string | [string, ...string[]];
+export type Condition42 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing80 = {
+export type Routing84 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2085,7 +2241,7 @@ export type Routing80 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing81 = {
+export type Routing85 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2099,7 +2255,7 @@ export type Routing81 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing82 = {
+export type Routing86 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2113,7 +2269,7 @@ export type Routing82 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing83 = {
+export type Routing87 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2137,15 +2293,15 @@ export type RequestHeadersString1 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition41 = string | [string, ...string[]];
+export type Condition43 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition42 = string | [string, ...string[]];
+export type Condition44 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing84 = {
+export type Routing88 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2159,7 +2315,7 @@ export type Routing84 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing85 = {
+export type Routing89 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2173,7 +2329,7 @@ export type Routing85 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing86 = {
+export type Routing90 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2187,7 +2343,7 @@ export type Routing86 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing87 = {
+export type Routing91 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2224,15 +2380,15 @@ export type ClickElementDetailed1 = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition43 = string | [string, ...string[]];
+export type Condition45 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition44 = string | [string, ...string[]];
+export type Condition46 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing88 = {
+export type Routing92 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2246,7 +2402,7 @@ export type Routing88 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing89 = {
+export type Routing93 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2260,7 +2416,7 @@ export type Routing89 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing90 = {
+export type Routing94 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2274,7 +2430,7 @@ export type Routing90 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing91 = {
+export type Routing95 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2311,15 +2467,15 @@ export type FindElementDetailed1 = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition45 = string | [string, ...string[]];
+export type Condition47 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition46 = string | [string, ...string[]];
+export type Condition48 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing92 = {
+export type Routing96 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2333,7 +2489,7 @@ export type Routing92 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing93 = {
+export type Routing97 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2347,7 +2503,7 @@ export type Routing93 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing94 = {
+export type Routing98 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2361,7 +2517,7 @@ export type Routing94 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing95 = {
+export type Routing99 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2384,7 +2540,7 @@ export type GoToURLDetailed1 = {
     /**
      * The browser window/tab to navigate. Omit to navigate the active tab. With `newTab`, selects the window the tab opens in.
      */
-    surface?: SurfaceByBrowserEngine5 | BrowserSurface8;
+    surface?: SurfaceByBrowserEngine7 | BrowserSurface10;
     /**
      * Open the URL in a new tab of the target window and make it active. `true` opens an anonymous tab; a string (or `{ name }`) names the tab so later steps can select it with a `tab` selector. `false` disables. Mutually exclusive with `newWindow`.
      */
@@ -2460,43 +2616,43 @@ export type GoToURLDetailed1 = {
 /**
  * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
-export type SurfaceByBrowserEngine5 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+export type SurfaceByBrowserEngine7 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector16 = ByIndex20 | ByName20 | ByCriteria20;
+export type WindowTabSelector20 = ByIndex26 | ByName26 | ByCriteria26;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex20 = number;
+export type ByIndex26 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName20 = string;
+export type ByName26 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector17 = ByIndex21 | ByName21 | ByCriteria21;
+export type WindowTabSelector21 = ByIndex27 | ByName27 | ByCriteria27;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex21 = number;
+export type ByIndex27 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName21 = string;
+export type ByName27 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition47 = string | [string, ...string[]];
+export type Condition49 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition48 = string | [string, ...string[]];
+export type Condition50 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing96 = {
+export type Routing100 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2510,7 +2666,7 @@ export type Routing96 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing97 = {
+export type Routing101 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2524,7 +2680,7 @@ export type Routing97 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing98 = {
+export type Routing102 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2538,7 +2694,7 @@ export type Routing98 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing99 = {
+export type Routing103 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2565,15 +2721,15 @@ export type HTTPRequestDetailed1 = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition49 = string | [string, ...string[]];
+export type Condition51 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition50 = string | [string, ...string[]];
+export type Condition52 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing100 = {
+export type Routing104 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2587,7 +2743,7 @@ export type Routing100 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing101 = {
+export type Routing105 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2601,7 +2757,7 @@ export type Routing101 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing102 = {
+export type Routing106 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2615,7 +2771,7 @@ export type Routing102 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing103 = {
+export type Routing107 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2637,15 +2793,15 @@ export type RunShellCommandSimple1 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition51 = string | [string, ...string[]];
+export type Condition53 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition52 = string | [string, ...string[]];
+export type Condition54 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing104 = {
+export type Routing108 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2659,7 +2815,7 @@ export type Routing104 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing105 = {
+export type Routing109 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2673,7 +2829,7 @@ export type Routing105 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing106 = {
+export type Routing110 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2687,7 +2843,7 @@ export type Routing106 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing107 = {
+export type Routing111 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2705,15 +2861,15 @@ export type RunCode3 = RunCodeDetailed1;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition53 = string | [string, ...string[]];
+export type Condition55 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition54 = string | [string, ...string[]];
+export type Condition56 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing108 = {
+export type Routing112 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2727,7 +2883,7 @@ export type Routing108 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing109 = {
+export type Routing113 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2741,7 +2897,7 @@ export type Routing109 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing110 = {
+export type Routing114 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2755,7 +2911,7 @@ export type Routing110 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing111 = {
+export type Routing115 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2777,43 +2933,43 @@ export type RunBrowserScriptSimple1 = string;
 /**
  * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
-export type SurfaceByBrowserEngine6 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+export type SurfaceByBrowserEngine8 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector18 = ByIndex22 | ByName22 | ByCriteria22;
+export type WindowTabSelector22 = ByIndex28 | ByName28 | ByCriteria28;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex22 = number;
+export type ByIndex28 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName22 = string;
+export type ByName28 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector19 = ByIndex23 | ByName23 | ByCriteria23;
+export type WindowTabSelector23 = ByIndex29 | ByName29 | ByCriteria29;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex23 = number;
+export type ByIndex29 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName23 = string;
+export type ByName29 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition55 = string | [string, ...string[]];
+export type Condition57 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition56 = string | [string, ...string[]];
+export type Condition58 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing112 = {
+export type Routing116 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2827,7 +2983,7 @@ export type Routing112 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing113 = {
+export type Routing117 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2841,7 +2997,7 @@ export type Routing113 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing114 = {
+export type Routing118 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2855,7 +3011,7 @@ export type Routing114 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing115 = {
+export type Routing119 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -2927,7 +3083,7 @@ export type TypeKeysSimple3 = string | string[];
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface3 = SurfaceByName3 | ProcessSurface3 | BrowserSurface10 | AppSurface4;
+export type Surface3 = SurfaceByName3 | ProcessSurface3 | BrowserSurface12 | AppSurface6;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -2935,39 +3091,39 @@ export type SurfaceByName3 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector20 = ByIndex24 | ByName24 | ByCriteria24;
+export type WindowTabSelector24 = ByIndex30 | ByName30 | ByCriteria30;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex24 = number;
+export type ByIndex30 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName24 = string;
+export type ByName30 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector21 = ByIndex25 | ByName25 | ByCriteria25;
+export type WindowTabSelector25 = ByIndex31 | ByName31 | ByCriteria31;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex25 = number;
+export type ByIndex31 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName25 = string;
+export type ByName31 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector4 = ByIndex26 | ByName26 | ByCriteria26;
+export type AppWindowSelector6 = ByIndex32 | ByName32 | ByCriteria32;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex26 = number;
+export type ByIndex32 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName26 = string;
+export type ByName32 = string;
 /**
  * Wait for a specific element to be present. At least one finding field must be specified.
  */
@@ -3007,15 +3163,15 @@ export type ElementCriteria4 = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition57 = string | [string, ...string[]];
+export type Condition59 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition58 = string | [string, ...string[]];
+export type Condition60 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing116 = {
+export type Routing120 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3029,7 +3185,7 @@ export type Routing116 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing117 = {
+export type Routing121 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3043,7 +3199,7 @@ export type Routing117 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing118 = {
+export type Routing122 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3057,7 +3213,7 @@ export type Routing118 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing119 = {
+export type Routing123 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3080,43 +3236,43 @@ export type CaptureScreenshotDetailed1 = CaptureScreenshotFields1 & AppCapturesD
 /**
  * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
-export type SurfaceByBrowserEngine7 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+export type SurfaceByBrowserEngine9 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector22 = ByIndex27 | ByName27 | ByCriteria27;
+export type WindowTabSelector26 = ByIndex33 | ByName33 | ByCriteria33;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex27 = number;
+export type ByIndex33 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName27 = string;
+export type ByName33 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector23 = ByIndex28 | ByName28 | ByCriteria28;
+export type WindowTabSelector27 = ByIndex34 | ByName34 | ByCriteria34;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex28 = number;
+export type ByIndex34 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName28 = string;
+export type ByName34 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector5 = ByIndex29 | ByName29 | ByCriteria29;
+export type AppWindowSelector7 = ByIndex35 | ByName35 | ByCriteria35;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex29 = number;
+export type ByIndex35 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName29 = string;
+export type ByName35 = string;
 /**
  * File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.
  */
@@ -3150,15 +3306,15 @@ export type CaptureScreenshot1 = boolean;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition59 = string | [string, ...string[]];
+export type Condition61 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition60 = string | [string, ...string[]];
+export type Condition62 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing120 = {
+export type Routing124 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3172,7 +3328,7 @@ export type Routing120 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing121 = {
+export type Routing125 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3186,7 +3342,7 @@ export type Routing121 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing122 = {
+export type Routing126 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3200,7 +3356,7 @@ export type Routing122 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing123 = {
+export type Routing127 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3227,15 +3383,15 @@ export type SaveCookieDetailed1 = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition61 = string | [string, ...string[]];
+export type Condition63 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition62 = string | [string, ...string[]];
+export type Condition64 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing124 = {
+export type Routing128 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3249,7 +3405,7 @@ export type Routing124 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing125 = {
+export type Routing129 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3263,7 +3419,7 @@ export type Routing125 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing126 = {
+export type Routing130 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3277,7 +3433,7 @@ export type Routing126 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing127 = {
+export type Routing131 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3299,31 +3455,31 @@ export type RecordSimple1 = string;
 /**
  * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
-export type SurfaceByBrowserEngine8 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+export type SurfaceByBrowserEngine10 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector24 = ByIndex30 | ByName30 | ByCriteria30;
+export type WindowTabSelector28 = ByIndex36 | ByName36 | ByCriteria36;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex30 = number;
+export type ByIndex36 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName30 = string;
+export type ByName36 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector25 = ByIndex31 | ByName31 | ByCriteria31;
+export type WindowTabSelector29 = ByIndex37 | ByName37 | ByCriteria37;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex31 = number;
+export type ByIndex37 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName31 = string;
+export type ByName37 = string;
 /**
  * Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.
  */
@@ -3339,15 +3495,15 @@ export type RecordBoolean1 = boolean;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition63 = string | [string, ...string[]];
+export type Condition65 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition64 = string | [string, ...string[]];
+export type Condition66 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing128 = {
+export type Routing132 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3361,7 +3517,7 @@ export type Routing128 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing129 = {
+export type Routing133 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3375,7 +3531,7 @@ export type Routing129 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing130 = {
+export type Routing134 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3389,7 +3545,7 @@ export type Routing130 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing131 = {
+export type Routing135 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3419,15 +3575,15 @@ export type StopRecordName1 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition65 = string | [string, ...string[]];
+export type Condition67 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition66 = string | [string, ...string[]];
+export type Condition68 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing132 = {
+export type Routing136 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3441,7 +3597,7 @@ export type Routing132 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing133 = {
+export type Routing137 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3455,7 +3611,7 @@ export type Routing133 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing134 = {
+export type Routing138 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3469,7 +3625,7 @@ export type Routing134 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing135 = {
+export type Routing139 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3487,7 +3643,7 @@ export type CloseSurface3 = Surface4 | [Surface5, ...Surface5[]];
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface4 = SurfaceByName4 | ProcessSurface4 | BrowserSurface13 | AppSurface6;
+export type Surface4 = SurfaceByName4 | ProcessSurface4 | BrowserSurface15 | AppSurface8;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -3495,43 +3651,43 @@ export type SurfaceByName4 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector26 = ByIndex32 | ByName32 | ByCriteria32;
+export type WindowTabSelector30 = ByIndex38 | ByName38 | ByCriteria38;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex32 = number;
+export type ByIndex38 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName32 = string;
+export type ByName38 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector27 = ByIndex33 | ByName33 | ByCriteria33;
+export type WindowTabSelector31 = ByIndex39 | ByName39 | ByCriteria39;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex33 = number;
+export type ByIndex39 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName33 = string;
+export type ByName39 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector6 = ByIndex34 | ByName34 | ByCriteria34;
+export type AppWindowSelector8 = ByIndex40 | ByName40 | ByCriteria40;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex34 = number;
+export type ByIndex40 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName34 = string;
+export type ByName40 = string;
 /**
  * The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.
  */
-export type Surface5 = SurfaceByName5 | ProcessSurface5 | BrowserSurface14 | AppSurface7;
+export type Surface5 = SurfaceByName5 | ProcessSurface5 | BrowserSurface16 | AppSurface9;
 /**
  * Name of the surface. A browser engine keyword (chrome|firefox|safari|webkit|edge) targets that browser; any other string names a background process. To target a browser window or tab, use the object form ({ "browser": …, "window": …, "tab": … }) — a plain string is never a window/tab name.
  */
@@ -3539,51 +3695,51 @@ export type SurfaceByName5 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector28 = ByIndex35 | ByName35 | ByCriteria35;
+export type WindowTabSelector32 = ByIndex41 | ByName41 | ByCriteria41;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex35 = number;
+export type ByIndex41 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName35 = string;
+export type ByName41 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector29 = ByIndex36 | ByName36 | ByCriteria36;
+export type WindowTabSelector33 = ByIndex42 | ByName42 | ByCriteria42;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex36 = number;
+export type ByIndex42 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName36 = string;
+export type ByName42 = string;
 /**
  * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
  */
-export type AppWindowSelector7 = ByIndex37 | ByName37 | ByCriteria37;
+export type AppWindowSelector9 = ByIndex43 | ByName43 | ByCriteria43;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
  */
-export type ByIndex37 = number;
+export type ByIndex43 = number;
 /**
  * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName37 = string;
+export type ByName43 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition67 = string | [string, ...string[]];
+export type Condition69 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition68 = string | [string, ...string[]];
+export type Condition70 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing136 = {
+export type Routing140 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3597,7 +3753,7 @@ export type Routing136 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing137 = {
+export type Routing141 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3611,7 +3767,7 @@ export type Routing137 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing138 = {
+export type Routing142 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3625,7 +3781,7 @@ export type Routing138 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing139 = {
+export type Routing143 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3658,15 +3814,15 @@ export type ElementCriteria5 = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition69 = string | [string, ...string[]];
+export type Condition71 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition70 = string | [string, ...string[]];
+export type Condition72 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing140 = {
+export type Routing144 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3680,7 +3836,7 @@ export type Routing140 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing141 = {
+export type Routing145 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3694,7 +3850,7 @@ export type Routing141 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing142 = {
+export type Routing146 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3708,7 +3864,7 @@ export type Routing142 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing143 = {
+export type Routing147 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3726,15 +3882,15 @@ export type LoadVariables3 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition71 = string | [string, ...string[]];
+export type Condition73 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition72 = string | [string, ...string[]];
+export type Condition74 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing144 = {
+export type Routing148 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3748,7 +3904,7 @@ export type Routing144 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing145 = {
+export type Routing149 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3762,7 +3918,7 @@ export type Routing145 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing146 = {
+export type Routing150 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3776,7 +3932,7 @@ export type Routing146 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing147 = {
+export type Routing151 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3828,43 +3984,43 @@ export type ElementDetailed3 = {
 /**
  * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
-export type SurfaceByBrowserEngine9 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+export type SurfaceByBrowserEngine11 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector30 = ByIndex38 | ByName38 | ByCriteria38;
+export type WindowTabSelector34 = ByIndex44 | ByName44 | ByCriteria44;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex38 = number;
+export type ByIndex44 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName38 = string;
+export type ByName44 = string;
 /**
  * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
  */
-export type WindowTabSelector31 = ByIndex39 | ByName39 | ByCriteria39;
+export type WindowTabSelector35 = ByIndex45 | ByName45 | ByCriteria45;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex39 = number;
+export type ByIndex45 = number;
 /**
  * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
  */
-export type ByName39 = string;
+export type ByName45 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition73 = string | [string, ...string[]];
+export type Condition75 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition74 = string | [string, ...string[]];
+export type Condition76 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing148 = {
+export type Routing152 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3878,7 +4034,7 @@ export type Routing148 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing149 = {
+export type Routing153 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3892,7 +4048,7 @@ export type Routing149 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing150 = {
+export type Routing154 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3906,7 +4062,7 @@ export type Routing150 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing151 = {
+export type Routing155 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3933,15 +4089,15 @@ export type LoadCookieDetailed1 = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition75 = string | [string, ...string[]];
+export type Condition77 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition76 = string | [string, ...string[]];
+export type Condition78 = string | [string, ...string[]];
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing152 = {
+export type Routing156 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3955,7 +4111,7 @@ export type Routing152 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing153 = {
+export type Routing157 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3969,7 +4125,7 @@ export type Routing153 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing154 = {
+export type Routing158 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3983,7 +4139,7 @@ export type Routing154 = {
 /**
  * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
  */
-export type Routing155 = {
+export type Routing159 = {
     [k: string]: unknown;
 } | {
     [k: string]: unknown;
@@ -3995,70 +4151,226 @@ export type Routing155 = {
     [k: string]: unknown;
 };
 /**
- * Pause (in milliseconds) before performing the next action.
+ * Swipe (or scroll) a surface in a direction or between two points. The direction is the virtual finger's motion: swiping up moves content up, revealing content further down the page. Works on app and browser surfaces.
  */
-export type Wait3 = WaitSimple1 | WaitEnvironmentVariable1 | WaitBoolean1;
-export type WaitSimple1 = number;
-export type WaitEnvironmentVariable1 = string;
-export type WaitBoolean1 = boolean;
+export type Swipe3 = SwipeSimple2 | SwipeDirectional1 | SwipePointToPoint1;
 /**
- * Resolved contexts to run the test in. This is a resolved version of the `runOn` property. It is not user-defined and should not be used in test specifications.
+ * Direction the virtual finger moves. `up` reveals content below; `left` reveals content to the right (for example, the next carousel card).
  */
-export type ResolvedContexts = ResolvedContext[];
+export type SwipeSimple2 = "up" | "down" | "left" | "right";
 /**
- * A context in which to perform tests. If no contexts are specified but a context is required by one or more tests, Doc Detective attempts to identify a supported context in the current environment and run tests against it. For example, if a browser isn't specified but is required by steps in the test, Doc Detective will search for and use a supported browser available in the current environment.
+ * Direction the virtual finger moves. `up` reveals content below; `left` reveals content to the right (for example, the next carousel card).
  */
-export interface Context {
-    /**
-     * JSON Schema for this object.
-     */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/context_v3.schema.json";
-    /**
-     * Unique identifier for the context.
-     */
-    contextId?: string;
-    /**
-     * Platforms to run tests on.
-     */
-    platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
-    /**
-     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
-     */
-    browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
-    /**
-     * Per-context override for the config-level [`browserFallback`](config) policy that governs whether a context whose browser can't start a driver session falls back to another available browser. Accepts the same values — `auto`, `explicit`, `off` — and, when set, takes precedence over the config-level value for the contexts this entry expands into. Omit it to inherit the config-level policy (which itself defaults to `auto`).
-     */
-    browserFallback?: "auto" | "explicit" | "off";
-    /**
-     * Capabilities the environment must provide for this context to run. A string names a required command; an array names several; the object form checks commands (on PATH), files (paths, with `$VAR`/`$HOME` expansion), and environment variables. All entries are AND-ed. Any unmet requirement marks the context as SKIPPED — the same non-failing outcome as a `platforms` mismatch.
-     */
-    requires?: string | [string, ...string[]] | Requirements;
-    /**
-     * Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.
-     */
-    device?: DeviceByName | DeviceDescriptor;
-}
+export type SwipeSimple3 = "up" | "down" | "left" | "right";
 /**
- * Browser configuration.
+ * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
  */
-export interface Browser {
-    /**
-     * Name of the browser.
-     */
-    name: "chrome" | "firefox" | "safari" | "webkit";
-    /**
-     * Set automatically during context resolution: `true` when the author explicitly requested this browser (as opposed to it being auto-selected as the default). The runner's cross-browser fallback uses it to decide whether substituting another engine reports `PASS` (auto-selected) or `WARNING` (explicitly pinned).
-     */
-    explicit?: boolean;
-    /**
-     * If `true`, runs the browser in headless mode.
-     */
-    headless?: boolean;
-    window?: BrowserWindow;
-    viewport?: BrowserViewport;
-}
+export type SurfaceByBrowserEngine12 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
 /**
- * Browser dimensions.
+ * Which window to act on. Omit to use the active window.
+ */
+export type WindowTabSelector36 = ByIndex46 | ByName46 | ByCriteria46;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex46 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName46 = string;
+/**
+ * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
+ */
+export type WindowTabSelector37 = ByIndex47 | ByName47 | ByCriteria47;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex47 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName47 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector10 = ByIndex48 | ByName48 | ByCriteria48;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex48 = number;
+/**
+ * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName48 = string;
+/**
+ * Browser engine keyword. Targets that browser. Steps that can only ever act on a browser (not a background process) restrict the bare-string form to this enum, so a process name here is rejected at validation time instead of failing at runtime.
+ */
+export type SurfaceByBrowserEngine13 = "chrome" | "firefox" | "safari" | "webkit" | "edge";
+/**
+ * Which window to act on. Omit to use the active window.
+ */
+export type WindowTabSelector38 = ByIndex49 | ByName49 | ByCriteria49;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex49 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName49 = string;
+/**
+ * Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order — including tabs the page opened itself.
+ */
+export type WindowTabSelector39 = ByIndex50 | ByName50 | ByCriteria50;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest.
+ */
+export type ByIndex50 = number;
+/**
+ * Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName50 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector11 = ByIndex51 | ByName51 | ByCriteria51;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex51 = number;
+/**
+ * Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes — string-first would coerce integer indexes into name strings.
+ */
+export type ByName51 = string;
+/**
+ * A condition expression, or an array of expressions combined with logical AND.
+ */
+export type Condition79 = string | [string, ...string[]];
+/**
+ * A condition expression, or an array of expressions combined with logical AND.
+ */
+export type Condition80 = string | [string, ...string[]];
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing160 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing161 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing162 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * A single dynamic-routing entry: an optional condition (`if`) plus exactly one routing action. Attached to a step or test handler (`onPass`, `onFail`, `onWarning`, `onSkip`). For step-level handlers, `continue`, `stop`, `retry`, and `goToStep` are evaluated at runtime; `goToTest` is validated but not yet executed (deferred at step scope). For test-level handlers, `continue`, `stop`, and `goToTest` are evaluated at runtime (test scope; `goToTest` jumps to a test within the spec), while `retry` and `goToStep` are not applicable at test scope.
+ */
+export type Routing163 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * Pause (in milliseconds) before performing the next action.
+ */
+export type Wait3 = WaitSimple1 | WaitEnvironmentVariable1 | WaitBoolean1;
+export type WaitSimple1 = number;
+export type WaitEnvironmentVariable1 = string;
+export type WaitBoolean1 = boolean;
+/**
+ * Resolved contexts to run the test in. This is a resolved version of the `runOn` property. It is not user-defined and should not be used in test specifications.
+ */
+export type ResolvedContexts = ResolvedContext[];
+/**
+ * A context in which to perform tests. If no contexts are specified but a context is required by one or more tests, Doc Detective attempts to identify a supported context in the current environment and run tests against it. For example, if a browser isn't specified but is required by steps in the test, Doc Detective will search for and use a supported browser available in the current environment.
+ */
+export interface Context {
+    /**
+     * JSON Schema for this object.
+     */
+    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/context_v3.schema.json";
+    /**
+     * Unique identifier for the context.
+     */
+    contextId?: string;
+    /**
+     * Platforms to run tests on.
+     */
+    platforms?: ("linux" | "mac" | "windows" | "android" | "ios") | ("linux" | "mac" | "windows" | "android" | "ios")[];
+    /**
+     * Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display — control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.
+     */
+    browsers?: ("chrome" | "firefox" | "safari" | "webkit") | Browser | (("chrome" | "firefox" | "safari" | "webkit") | Browser1)[];
+    /**
+     * Per-context override for the config-level [`browserFallback`](config) policy that governs whether a context whose browser can't start a driver session falls back to another available browser. Accepts the same values — `auto`, `explicit`, `off` — and, when set, takes precedence over the config-level value for the contexts this entry expands into. Omit it to inherit the config-level policy (which itself defaults to `auto`).
+     */
+    browserFallback?: "auto" | "explicit" | "off";
+    /**
+     * Capabilities the environment must provide for this context to run. A string names a required command; an array names several; the object form checks commands (on PATH), files (paths, with `$VAR`/`$HOME` expansion), and environment variables. All entries are AND-ed. Any unmet requirement marks the context as SKIPPED — the same non-failing outcome as a `platforms` mismatch.
+     */
+    requires?: string | [string, ...string[]] | Requirements;
+    /**
+     * Default device for a mobile (`android`/`ios`) context. A string references a device by name; an object refines it. The `platform` is implied by the context, so it is not required here. When the named device doesn't already exist, Doc Detective creates it with defaults (see `deviceType`/`osVersion`), provided the toolchain is installed (`doc-detective install android` or `doc-detective install ios`). Same shape as `startSurface.device`.
+     */
+    device?: DeviceByName | DeviceDescriptor;
+}
+/**
+ * Browser configuration.
+ */
+export interface Browser {
+    /**
+     * Name of the browser.
+     */
+    name: "chrome" | "firefox" | "safari" | "webkit";
+    /**
+     * Set automatically during context resolution: `true` when the author explicitly requested this browser (as opposed to it being auto-selected as the default). The runner's cross-browser fallback uses it to decide whether substituting another engine reports `PASS` (auto-selected) or `WARNING` (explicitly pinned).
+     */
+    explicit?: boolean;
+    /**
+     * If `true`, runs the browser in headless mode.
+     */
+    headless?: boolean;
+    window?: BrowserWindow;
+    viewport?: BrowserViewport;
+}
+/**
+ * Browser dimensions.
  */
 export interface BrowserWindow {
     /**
@@ -7772,88 +8084,216 @@ export interface SourceLocation18 {
      */
     endIndex: number;
 }
-export interface Wait {
-    wait: Wait1;
+export interface Swipe {
+    swipe: Swipe1;
     [k: string]: unknown;
 }
-export interface ResolvedContext {
+export interface SwipeDirectional {
+    direction: SwipeSimple1;
     /**
-     * Platform to run the test on. This is a resolved version of the `platforms` property.
+     * How far to swipe, as a fraction of the surface's height (for up/down) or width (for left/right).
      */
-    platform?: string;
-    browser?: Browser2;
-    openApi?: (OpenApi1 & OpenAPIDescriptionTest1)[];
+    distance?: number;
     /**
-     * Steps to perform as part of the test. Performed in the sequence defined. If one or more actions fail, the test fails. By default, if a step fails, the test stops and the remaining steps are not executed.
-     *
-     * @minItems 1
+     * Duration of the swipe movement in milliseconds.
      */
-    steps?: [Step1, ...Step1[]];
-    [k: string]: unknown;
-}
-/**
- * Browser configuration.
- */
-export interface Browser2 {
+    duration?: number;
     /**
-     * Name of the browser.
+     * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
      */
-    name: "chrome" | "firefox" | "safari" | "webkit";
+    surface?: SurfaceByBrowserEngine5 | BrowserSurface8 | AppSurface4;
+}
+export interface BrowserSurface8 {
     /**
-     * Set automatically during context resolution: `true` when the author explicitly requested this browser (as opposed to it being auto-selected as the default). The runner's cross-browser fallback uses it to decide whether substituting another engine reports `PASS` (auto-selected) or `WARNING` (explicitly pinned).
+     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
      */
-    explicit?: boolean;
+    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
     /**
-     * If `true`, runs the browser in headless mode.
+     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
      */
-    headless?: boolean;
-    window?: BrowserWindow2;
-    viewport?: BrowserViewport2;
+    name?: string;
+    window?: WindowTabSelector16;
+    tab?: WindowTabSelector17;
 }
-/**
- * Browser dimensions.
- */
-export interface BrowserWindow2 {
+export interface ByCriteria20 {
     /**
-     * Width of the browser window in pixels.
+     * Name assigned when the window/tab was opened.
      */
-    width?: number;
+    name?: string;
     /**
-     * Height of the browser window in pixels.
+     * Index in creation order. Negative counts from the end.
      */
-    height?: number;
-}
-/**
- * Viewport dimensions.
- */
-export interface BrowserViewport2 {
+    index?: number;
     /**
-     * Width of the viewport in pixels.
+     * Page title to match. Substring, or /regex/.
      */
-    width?: number;
+    title?: string;
     /**
-     * Height of the viewport in pixels.
+     * Page URL to match. Substring, or /regex/.
      */
-    height?: number;
-}
-export interface OpenAPIDescriptionTest1 {
-    [k: string]: unknown;
+    url?: string;
 }
-export interface Common19 {
+export interface ByCriteria21 {
     /**
-     * JSON Schema for this object.
+     * Name assigned when the window/tab was opened.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    name?: string;
     /**
-     * ID of the step.
+     * Index in creation order. Negative counts from the end.
      */
-    stepId?: string;
+    index?: number;
     /**
-     * Description of the step.
+     * Page title to match. Substring, or /regex/.
      */
-    description?: string;
+    title?: string;
     /**
-     * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface AppSurface4 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector4;
+}
+export interface ByCriteria22 {
+    /**
+     * Assigned window name.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Window title to match. Substring, or /regex/.
+     */
+    title?: string;
+}
+export interface SwipePointToPoint {
+    from: Point;
+    to: Point1;
+    /**
+     * Duration of the swipe movement in milliseconds.
+     */
+    duration?: number;
+    /**
+     * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
+     */
+    surface?: SurfaceByBrowserEngine6 | BrowserSurface9 | AppSurface5;
+}
+/**
+ * A pixel coordinate on the surface, measured from its top-left corner (0, 0).
+ */
+export interface Point {
+    /**
+     * Horizontal position in pixels from the left edge of the surface (the app window, or the browser viewport).
+     */
+    x: number;
+    /**
+     * Vertical position in pixels from the top edge of the surface (the app window, or the browser viewport).
+     */
+    y: number;
+}
+/**
+ * A pixel coordinate on the surface, measured from its top-left corner (0, 0).
+ */
+export interface Point1 {
+    /**
+     * Horizontal position in pixels from the left edge of the surface (the app window, or the browser viewport).
+     */
+    x: number;
+    /**
+     * Vertical position in pixels from the top edge of the surface (the app window, or the browser viewport).
+     */
+    y: number;
+}
+export interface BrowserSurface9 {
+    /**
+     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
+     */
+    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
+    /**
+     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
+     */
+    name?: string;
+    window?: WindowTabSelector18;
+    tab?: WindowTabSelector19;
+}
+export interface ByCriteria23 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface ByCriteria24 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface AppSurface5 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector5;
+}
+export interface ByCriteria25 {
+    /**
+     * Assigned window name.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Window title to match. Substring, or /regex/.
+     */
+    title?: string;
+}
+export interface Common19 {
+    /**
+     * JSON Schema for this object.
+     */
+    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    /**
+     * ID of the step.
+     */
+    stepId?: string;
+    /**
+     * Description of the step.
+     */
+    description?: string;
+    /**
+     * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
      */
     unsafe?: boolean;
     outputs?: OutputsStep19;
@@ -7972,42 +8412,72 @@ export interface SourceLocation19 {
      */
     endIndex: number;
 }
-export interface CheckLink2 {
-    checkLink: CheckLink3;
+export interface Wait {
+    wait: Wait1;
+    [k: string]: unknown;
+}
+export interface ResolvedContext {
+    /**
+     * Platform to run the test on. This is a resolved version of the `platforms` property.
+     */
+    platform?: string;
+    browser?: Browser2;
+    openApi?: (OpenApi1 & OpenAPIDescriptionTest1)[];
+    /**
+     * Steps to perform as part of the test. Performed in the sequence defined. If one or more actions fail, the test fails. By default, if a step fails, the test stops and the remaining steps are not executed.
+     *
+     * @minItems 1
+     */
+    steps?: [Step1, ...Step1[]];
     [k: string]: unknown;
 }
 /**
- * Check if an HTTP or HTTPS URL returns an acceptable status code from a GET request.
+ * Browser configuration.
  */
-export interface CheckLinkDetailed3 {
+export interface Browser2 {
     /**
-     * URL to check. Can be a full URL or a path. If a path is provided, `origin` must be specified.
+     * Name of the browser.
      */
-    url: string;
+    name: "chrome" | "firefox" | "safari" | "webkit";
     /**
-     * Protocol and domain to navigate to. Prepended to `url`.
+     * Set automatically during context resolution: `true` when the author explicitly requested this browser (as opposed to it being auto-selected as the default). The runner's cross-browser fallback uses it to decide whether substituting another engine reports `PASS` (auto-selected) or `WARNING` (explicitly pinned).
      */
-    origin?: string;
+    explicit?: boolean;
     /**
-     * Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.
+     * If `true`, runs the browser in headless mode.
      */
-    params?: {
-        [k: string]: string;
-    };
+    headless?: boolean;
+    window?: BrowserWindow2;
+    viewport?: BrowserViewport2;
+}
+/**
+ * Browser dimensions.
+ */
+export interface BrowserWindow2 {
     /**
-     * Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.
+     * Width of the browser window in pixels.
      */
-    statusCodes?: number | number[];
+    width?: number;
     /**
-     * Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).
+     * Height of the browser window in pixels.
      */
-    headers?: RequestHeadersObject1 | RequestHeadersString1;
+    height?: number;
 }
 /**
- * Headers to include in the HTTP request, in key/value format. Values must be strings.
+ * Viewport dimensions.
  */
-export interface RequestHeadersObject1 {
-    [k: string]: string;
+export interface BrowserViewport2 {
+    /**
+     * Width of the viewport in pixels.
+     */
+    width?: number;
+    /**
+     * Height of the viewport in pixels.
+     */
+    height?: number;
+}
+export interface OpenAPIDescriptionTest1 {
+    [k: string]: unknown;
 }
 export interface Common20 {
     /**
@@ -8142,10 +8612,43 @@ export interface SourceLocation20 {
      */
     endIndex: number;
 }
-export interface Click2 {
-    click: Click3;
+export interface CheckLink2 {
+    checkLink: CheckLink3;
     [k: string]: unknown;
 }
+/**
+ * Check if an HTTP or HTTPS URL returns an acceptable status code from a GET request.
+ */
+export interface CheckLinkDetailed3 {
+    /**
+     * URL to check. Can be a full URL or a path. If a path is provided, `origin` must be specified.
+     */
+    url: string;
+    /**
+     * Protocol and domain to navigate to. Prepended to `url`.
+     */
+    origin?: string;
+    /**
+     * Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.
+     */
+    params?: {
+        [k: string]: string;
+    };
+    /**
+     * Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.
+     */
+    statusCodes?: number | number[];
+    /**
+     * Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).
+     */
+    headers?: RequestHeadersObject1 | RequestHeadersString1;
+}
+/**
+ * Headers to include in the HTTP request, in key/value format. Values must be strings.
+ */
+export interface RequestHeadersObject1 {
+    [k: string]: string;
+}
 export interface Common21 {
     /**
      * JSON Schema for this object.
@@ -8279,8 +8782,8 @@ export interface SourceLocation21 {
      */
     endIndex: number;
 }
-export interface Find2 {
-    find: Find3;
+export interface Click2 {
+    click: Click3;
     [k: string]: unknown;
 }
 export interface Common22 {
@@ -8416,76 +8919,19 @@ export interface SourceLocation22 {
      */
     endIndex: number;
 }
-export interface GoTo2 {
-    goTo: GoTo3;
+export interface Find2 {
+    find: Find3;
     [k: string]: unknown;
 }
-export interface BrowserSurface8 {
+export interface Common23 {
     /**
-     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
+     * JSON Schema for this object.
      */
-    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
+    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
     /**
-     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
+     * ID of the step.
      */
-    name?: string;
-    window?: WindowTabSelector16;
-    tab?: WindowTabSelector17;
-}
-export interface ByCriteria20 {
-    /**
-     * Name assigned when the window/tab was opened.
-     */
-    name?: string;
-    /**
-     * Index in creation order. Negative counts from the end.
-     */
-    index?: number;
-    /**
-     * Page title to match. Substring, or /regex/.
-     */
-    title?: string;
-    /**
-     * Page URL to match. Substring, or /regex/.
-     */
-    url?: string;
-}
-export interface ByCriteria21 {
-    /**
-     * Name assigned when the window/tab was opened.
-     */
-    name?: string;
-    /**
-     * Index in creation order. Negative counts from the end.
-     */
-    index?: number;
-    /**
-     * Page title to match. Substring, or /regex/.
-     */
-    title?: string;
-    /**
-     * Page URL to match. Substring, or /regex/.
-     */
-    url?: string;
-}
-export interface NewTabAndNewWindowAreMutuallyExclusive1 {
-    [k: string]: unknown;
-}
-export interface NewTabConflictsWithASurfaceTabSelector1 {
-    [k: string]: unknown;
-}
-export interface NewWindowConflictsWithASurfaceWindowOrTabSelector1 {
-    [k: string]: unknown;
-}
-export interface Common23 {
-    /**
-     * JSON Schema for this object.
-     */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
-    /**
-     * ID of the step.
-     */
-    stepId?: string;
+    stepId?: string;
     /**
      * Description of the step.
      */
@@ -8610,8 +9056,65 @@ export interface SourceLocation23 {
      */
     endIndex: number;
 }
-export interface HttpRequest2 {
-    httpRequest: HttpRequest3;
+export interface GoTo2 {
+    goTo: GoTo3;
+    [k: string]: unknown;
+}
+export interface BrowserSurface10 {
+    /**
+     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
+     */
+    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
+    /**
+     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
+     */
+    name?: string;
+    window?: WindowTabSelector20;
+    tab?: WindowTabSelector21;
+}
+export interface ByCriteria26 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface ByCriteria27 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface NewTabAndNewWindowAreMutuallyExclusive1 {
+    [k: string]: unknown;
+}
+export interface NewTabConflictsWithASurfaceTabSelector1 {
+    [k: string]: unknown;
+}
+export interface NewWindowConflictsWithASurfaceWindowOrTabSelector1 {
     [k: string]: unknown;
 }
 export interface Common24 {
@@ -8747,87 +9250,10 @@ export interface SourceLocation24 {
      */
     endIndex: number;
 }
-export interface RunShell2 {
-    runShell: RunShell3;
+export interface HttpRequest2 {
+    httpRequest: HttpRequest3;
     [k: string]: unknown;
 }
-export interface RunShellCommandDetailed1 {
-    /**
-     * Command to perform in the machine's default shell.
-     */
-    command: string;
-    /**
-     * Arguments for the command.
-     */
-    args?: string[];
-    /**
-     * Working directory for the command.
-     */
-    workingDirectory?: string;
-    /**
-     * Expected exit codes of the command. If the command's actual exit code isn't in this list, the step fails.
-     */
-    exitCodes?: number[];
-    /**
-     * Content expected in the command's stdout or stderr. If the expected content can't be found in the command's stdout or stderr, the step fails. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/^hello-world.* /`.
-     */
-    stdio?: string;
-    /**
-     * File path to save the command's output, relative to `directory`.
-     */
-    path?: string;
-    /**
-     * Directory to save the command's output. If the directory doesn't exist, creates the directory. If not specified, the directory is your media directory.
-     */
-    directory?: string;
-    /**
-     * Allowed variation as a fraction (0 to 1) of text different between the current output and previously saved output. For example, 0.1 means 10%. If the difference between the current output and the previous output is greater than `maxVariation`, the step fails. If output doesn't exist at `path`, this value is ignored.
-     */
-    maxVariation?: number;
-    /**
-     * If `true`, overwrites the existing output at `path` if it exists.
-     * If `aboveVariation`, overwrites the existing output at `path` if the difference between the new output and the existing output is greater than `maxVariation`.
-     */
-    overwrite?: "true" | "false" | "aboveVariation";
-    /**
-     * Max time in milliseconds the command is allowed to run. If the command runs longer than this, the step fails. When `background` is set, this is instead the max time to wait for `background.waitUntil` to be satisfied before the step fails.
-     */
-    timeout?: number;
-    /**
-     * Start the command as a long-running background process and return as soon as it is ready, instead of waiting for it to exit. When set, `exitCodes`, `stdio`, and output saving (`path`, `directory`, `maxVariation`, `overwrite`) are ignored, and `timeout` is the max time to wait for `waitUntil`. The process is owned by the run and is stopped by a `closeSurface` step or automatically when the run finishes.
-     */
-    background?: {
-        /**
-         * Unique identifier for this background process within the run. Reference it from a `closeSurface` step to stop it.
-         */
-        name: string;
-        /**
-         * Conditions that must all be met before the process is considered ready and the step proceeds. Omit to consider the process ready as soon as it is spawned. Specify any combination; every condition given must pass before `timeout` elapses. Note: a process that forks a daemon and then exits (common for some Docker images and databases) is treated as having exited before becoming ready and the step fails — use `port`, `httpGet`, or `delayMs` for those rather than a condition that depends on the foreground process staying alive.
-         */
-        waitUntil?: {
-            /**
-             * Wait until this TCP port accepts connections on localhost.
-             */
-            port?: number;
-            /**
-             * Wait until the process's output contains this content. Searches both stdout and stderr. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/ready on \d+/`.
-             */
-            stdio?: string;
-            /**
-             * Wait until an HTTP GET request to this URL returns a 2xx status.
-             */
-            httpGet?: string;
-            /**
-             * Wait at least this many milliseconds.
-             */
-            delayMs?: number;
-        };
-        /**
-         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
-         */
-        tty?: boolean;
-    };
-}
 export interface Common25 {
     /**
      * JSON Schema for this object.
@@ -8961,19 +9387,15 @@ export interface SourceLocation25 {
      */
     endIndex: number;
 }
-export interface RunCode2 {
-    runCode: RunCode3;
+export interface RunShell2 {
+    runShell: RunShell3;
     [k: string]: unknown;
 }
-export interface RunCodeDetailed1 {
-    /**
-     * Language of the code to run.
-     */
-    language: "python" | "bash" | "javascript";
+export interface RunShellCommandDetailed1 {
     /**
-     * Code to run.
+     * Command to perform in the machine's default shell.
      */
-    code: string;
+    command: string;
     /**
      * Arguments for the command.
      */
@@ -8987,7 +9409,7 @@ export interface RunCodeDetailed1 {
      */
     exitCodes?: number[];
     /**
-     * Content expected in the command's output. If the expected content can't be found in the command's output (either stdout or stderr), the step fails. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/^hello-world.* /`.
+     * Content expected in the command's stdout or stderr. If the expected content can't be found in the command's stdout or stderr, the step fails. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/^hello-world.* /`.
      */
     stdio?: string;
     /**
@@ -9012,7 +9434,7 @@ export interface RunCodeDetailed1 {
      */
     timeout?: number;
     /**
-     * Start the code as a long-running background process and return as soon as it is ready, instead of waiting for it to exit. When set, `exitCodes`, `stdio`, and output saving (`path`, `directory`, `maxVariation`, `overwrite`) are ignored, and `timeout` is the max time to wait for `waitUntil`. The process is owned by the run and is stopped by a `closeSurface` step or automatically when the run finishes.
+     * Start the command as a long-running background process and return as soon as it is ready, instead of waiting for it to exit. When set, `exitCodes`, `stdio`, and output saving (`path`, `directory`, `maxVariation`, `overwrite`) are ignored, and `timeout` is the max time to wait for `waitUntil`. The process is owned by the run and is stopped by a `closeSurface` step or automatically when the run finishes.
      */
     background?: {
         /**
@@ -9045,7 +9467,6 @@ export interface RunCodeDetailed1 {
          */
         tty?: boolean;
     };
-    [k: string]: unknown;
 }
 export interface Common26 {
     /**
@@ -9180,37 +9601,45 @@ export interface SourceLocation26 {
      */
     endIndex: number;
 }
-export interface RunBrowserScript2 {
-    runBrowserScript: RunBrowserScript3;
+export interface RunCode2 {
+    runCode: RunCode3;
     [k: string]: unknown;
 }
-export interface RunBrowserScriptDetailed1 {
+export interface RunCodeDetailed1 {
     /**
-     * The browser window/tab the script runs in. Omit to run in the active tab. The targeted tab stays focused afterward.
+     * Language of the code to run.
      */
-    surface?: SurfaceByBrowserEngine6 | BrowserSurface9;
+    language: "python" | "bash" | "javascript";
     /**
-     * JavaScript to evaluate in the browser page context. Supports `return` to capture a value into `outputs.result`. The script reads arguments supplied in `args` through the `arguments` object (`arguments[0]`, `arguments[1]`, and so on).
+     * Code to run.
      */
-    script: string;
+    code: string;
     /**
-     * Arguments passed positionally to the script and exposed through the `arguments` object. Each item may be any JSON-serializable value (string, number, boolean, null, object, or array), matching what `executeScript` accepts.
+     * Arguments for the command.
      */
-    args?: unknown[];
+    args?: string[];
     /**
-     * Content expected in the script's serialized return value. Doc Detective serializes non-string return values to JSON before matching. If the serialized return value doesn't contain the expected content, the step fails. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/^hello-world.* /`.
+     * Working directory for the command.
      */
-    output?: string;
+    workingDirectory?: string;
     /**
-     * File path to save the script's serialized return value, relative to `directory`.
+     * Expected exit codes of the command. If the command's actual exit code isn't in this list, the step fails.
+     */
+    exitCodes?: number[];
+    /**
+     * Content expected in the command's output. If the expected content can't be found in the command's output (either stdout or stderr), the step fails. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/^hello-world.* /`.
+     */
+    stdio?: string;
+    /**
+     * File path to save the command's output, relative to `directory`.
      */
     path?: string;
     /**
-     * Directory to save the script's return value. If the directory doesn't exist, creates the directory. If not specified, the directory is your media directory.
+     * Directory to save the command's output. If the directory doesn't exist, creates the directory. If not specified, the directory is your media directory.
      */
     directory?: string;
     /**
-     * Allowed variation as a fraction (0 to 1) of text different between the current return value and previously saved value. For example, 0.1 means 10%. If the difference between the current value and the previous value is greater than `maxVariation`, the step returns a warning. If no output exists at `path`, Doc Detective ignores this value.
+     * Allowed variation as a fraction (0 to 1) of text different between the current output and previously saved output. For example, 0.1 means 10%. If the difference between the current output and the previous output is greater than `maxVariation`, the step fails. If output doesn't exist at `path`, this value is ignored.
      */
     maxVariation?: number;
     /**
@@ -9219,57 +9648,44 @@ export interface RunBrowserScriptDetailed1 {
      */
     overwrite?: "true" | "false" | "aboveVariation";
     /**
-     * Maximum time in milliseconds the script may run. If the script runs longer than this, the step fails.
+     * Max time in milliseconds the command is allowed to run. If the command runs longer than this, the step fails. When `background` is set, this is instead the max time to wait for `background.waitUntil` to be satisfied before the step fails.
      */
     timeout?: number;
-}
-export interface BrowserSurface9 {
     /**
-     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
+     * Start the code as a long-running background process and return as soon as it is ready, instead of waiting for it to exit. When set, `exitCodes`, `stdio`, and output saving (`path`, `directory`, `maxVariation`, `overwrite`) are ignored, and `timeout` is the max time to wait for `waitUntil`. The process is owned by the run and is stopped by a `closeSurface` step or automatically when the run finishes.
      */
-    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
-    /**
-     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
-     */
-    name?: string;
-    window?: WindowTabSelector18;
-    tab?: WindowTabSelector19;
-}
-export interface ByCriteria22 {
-    /**
-     * Name assigned when the window/tab was opened.
-     */
-    name?: string;
-    /**
-     * Index in creation order. Negative counts from the end.
-     */
-    index?: number;
-    /**
-     * Page title to match. Substring, or /regex/.
-     */
-    title?: string;
-    /**
-     * Page URL to match. Substring, or /regex/.
-     */
-    url?: string;
-}
-export interface ByCriteria23 {
-    /**
-     * Name assigned when the window/tab was opened.
-     */
-    name?: string;
-    /**
-     * Index in creation order. Negative counts from the end.
-     */
-    index?: number;
-    /**
-     * Page title to match. Substring, or /regex/.
-     */
-    title?: string;
-    /**
-     * Page URL to match. Substring, or /regex/.
-     */
-    url?: string;
+    background?: {
+        /**
+         * Unique identifier for this background process within the run. Reference it from a `closeSurface` step to stop it.
+         */
+        name: string;
+        /**
+         * Conditions that must all be met before the process is considered ready and the step proceeds. Omit to consider the process ready as soon as it is spawned. Specify any combination; every condition given must pass before `timeout` elapses. Note: a process that forks a daemon and then exits (common for some Docker images and databases) is treated as having exited before becoming ready and the step fails — use `port`, `httpGet`, or `delayMs` for those rather than a condition that depends on the foreground process staying alive.
+         */
+        waitUntil?: {
+            /**
+             * Wait until this TCP port accepts connections on localhost.
+             */
+            port?: number;
+            /**
+             * Wait until the process's output contains this content. Searches both stdout and stderr. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/ready on \d+/`.
+             */
+            stdio?: string;
+            /**
+             * Wait until an HTTP GET request to this URL returns a 2xx status.
+             */
+            httpGet?: string;
+            /**
+             * Wait at least this many milliseconds.
+             */
+            delayMs?: number;
+        };
+        /**
+         * Run the process in a pseudo-terminal (PTY) instead of a pipe, so full-screen/interactive TUIs (those that check `isTTY`) render and accept keystrokes. Requires the PTY backend `@homebridge/node-pty-prebuilt-multiarch` to be installed (`npm install @homebridge/node-pty-prebuilt-multiarch`); it is not bundled, and if it is unavailable the step is skipped. `stdout` and `stderr` are merged into one stream in PTY mode. PTY output includes raw ANSI escape sequences (colors, cursor movement); `waitUntil.stdio` patterns should target text that renders without interleaved control codes, or use a regex that tolerates them.
+         */
+        tty?: boolean;
+    };
+    [k: string]: unknown;
 }
 export interface Common27 {
     /**
@@ -9404,17 +9820,50 @@ export interface SourceLocation27 {
      */
     endIndex: number;
 }
-export interface Type1 {
-    type: TypeKeys1;
+export interface RunBrowserScript2 {
+    runBrowserScript: RunBrowserScript3;
     [k: string]: unknown;
 }
-export interface ProcessSurface3 {
+export interface RunBrowserScriptDetailed1 {
     /**
-     * Name of a background process started by a runShell/runCode `background` step.
+     * The browser window/tab the script runs in. Omit to run in the active tab. The targeted tab stays focused afterward.
      */
-    process: string;
+    surface?: SurfaceByBrowserEngine8 | BrowserSurface11;
+    /**
+     * JavaScript to evaluate in the browser page context. Supports `return` to capture a value into `outputs.result`. The script reads arguments supplied in `args` through the `arguments` object (`arguments[0]`, `arguments[1]`, and so on).
+     */
+    script: string;
+    /**
+     * Arguments passed positionally to the script and exposed through the `arguments` object. Each item may be any JSON-serializable value (string, number, boolean, null, object, or array), matching what `executeScript` accepts.
+     */
+    args?: unknown[];
+    /**
+     * Content expected in the script's serialized return value. Doc Detective serializes non-string return values to JSON before matching. If the serialized return value doesn't contain the expected content, the step fails. Supports strings and regular expressions. To use a regular expression, the string must start and end with a forward slash, like in `/^hello-world.* /`.
+     */
+    output?: string;
+    /**
+     * File path to save the script's serialized return value, relative to `directory`.
+     */
+    path?: string;
+    /**
+     * Directory to save the script's return value. If the directory doesn't exist, creates the directory. If not specified, the directory is your media directory.
+     */
+    directory?: string;
+    /**
+     * Allowed variation as a fraction (0 to 1) of text different between the current return value and previously saved value. For example, 0.1 means 10%. If the difference between the current value and the previous value is greater than `maxVariation`, the step returns a warning. If no output exists at `path`, Doc Detective ignores this value.
+     */
+    maxVariation?: number;
+    /**
+     * If `true`, overwrites the existing output at `path` if it exists.
+     * If `aboveVariation`, overwrites the existing output at `path` if the difference between the new output and the existing output is greater than `maxVariation`.
+     */
+    overwrite?: "true" | "false" | "aboveVariation";
+    /**
+     * Maximum time in milliseconds the script may run. If the script runs longer than this, the step fails.
+     */
+    timeout?: number;
 }
-export interface BrowserSurface10 {
+export interface BrowserSurface11 {
     /**
      * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
      */
@@ -9423,10 +9872,10 @@ export interface BrowserSurface10 {
      * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
      */
     name?: string;
-    window?: WindowTabSelector20;
-    tab?: WindowTabSelector21;
+    window?: WindowTabSelector22;
+    tab?: WindowTabSelector23;
 }
-export interface ByCriteria24 {
+export interface ByCriteria28 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -9444,7 +9893,7 @@ export interface ByCriteria24 {
      */
     url?: string;
 }
-export interface ByCriteria25 {
+export interface ByCriteria29 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -9462,73 +9911,6 @@ export interface ByCriteria25 {
      */
     url?: string;
 }
-export interface AppSurface4 {
-    /**
-     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
-     */
-    app: string;
-    window?: AppWindowSelector4;
-}
-export interface ByCriteria26 {
-    /**
-     * Assigned window name.
-     */
-    name?: string;
-    /**
-     * Index in creation order. Negative counts from the end.
-     */
-    index?: number;
-    /**
-     * Window title to match. Substring, or /regex/.
-     */
-    title?: string;
-}
-export interface ProcessReadiness1 {
-    /**
-     * Wait until combined stdout+stderr matches. Substring, or /regex/.
-     */
-    stdio?: string;
-    /**
-     * Fixed delay (ms).
-     */
-    delayMs?: number;
-}
-export interface BrowserReadiness1 {
-    /**
-     * Wait for network activity to be idle (no new requests) for this duration in milliseconds.
-     */
-    networkIdleTime?: number;
-    /**
-     * Wait for DOM mutations to stop for this duration in milliseconds.
-     */
-    domIdleTime?: number;
-    find?: ElementCriteria3;
-}
-export interface AppReadiness2 {
-    /**
-     * Fixed delay (ms).
-     */
-    delayMs?: number;
-    find?: ElementCriteria4;
-}
-export interface WaitUntilRequiresASurface1 {
-    [k: string]: unknown;
-}
-export interface AProcessSurfaceForbidsElementTargeting1 {
-    [k: string]: unknown;
-}
-export interface AProcessSurfaceTakesProcessReadiness1 {
-    [k: string]: unknown;
-}
-export interface ABrowserSurfaceTakesBrowserReadiness1 {
-    [k: string]: unknown;
-}
-export interface AnAppSurfaceTakesAppReadiness1 {
-    [k: string]: unknown;
-}
-export interface ABrowserEngineStringSurfaceTakesBrowserReadiness1 {
-    [k: string]: unknown;
-}
 export interface Common28 {
     /**
      * JSON Schema for this object.
@@ -9662,33 +10044,17 @@ export interface SourceLocation28 {
      */
     endIndex: number;
 }
-export interface Screenshot2 {
-    screenshot: Screenshot3;
+export interface Type1 {
+    type: TypeKeys1;
     [k: string]: unknown;
 }
-export interface CaptureScreenshotFields1 {
-    /**
-     * The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }). App captures don't support `crop` yet.
-     */
-    surface?: SurfaceByBrowserEngine7 | BrowserSurface11 | AppSurface5;
-    path?: ScreenshotSimple3;
-    /**
-     * Directory of the PNG file. If the directory doesn't exist, creates the directory.
-     */
-    directory?: string;
-    /**
-     * Allowed variation in percentage of pixels between the new screenshot and the existing screenshot at `path`. If the difference between the new screenshot and the existing screenshot is greater than `maxVariation`, the step fails. If a screenshot doesn't exist at `path`, this value is ignored.
-     */
-    maxVariation?: number;
+export interface ProcessSurface3 {
     /**
-     * If `true`, overwrites the existing screenshot at `path` if it exists.
-     * If `aboveVariation`, overwrites the existing screenshot at `path` if the difference between the new screenshot and the existing screenshot is greater than `maxVariation`.
+     * Name of a background process started by a runShell/runCode `background` step.
      */
-    overwrite?: "true" | "false" | "aboveVariation";
-    crop?: CropByElementSimple1 | CropByElementDetailed1;
-    sourceIntegration?: SourceIntegration1;
+    process: string;
 }
-export interface BrowserSurface11 {
+export interface BrowserSurface12 {
     /**
      * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
      */
@@ -9697,10 +10063,10 @@ export interface BrowserSurface11 {
      * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
      */
     name?: string;
-    window?: WindowTabSelector22;
-    tab?: WindowTabSelector23;
+    window?: WindowTabSelector24;
+    tab?: WindowTabSelector25;
 }
-export interface ByCriteria27 {
+export interface ByCriteria30 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -9718,7 +10084,7 @@ export interface ByCriteria27 {
      */
     url?: string;
 }
-export interface ByCriteria28 {
+export interface ByCriteria31 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -9736,14 +10102,14 @@ export interface ByCriteria28 {
      */
     url?: string;
 }
-export interface AppSurface5 {
+export interface AppSurface6 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector5;
+    window?: AppWindowSelector6;
 }
-export interface ByCriteria29 {
+export interface ByCriteria32 {
     /**
      * Assigned window name.
      */
@@ -9757,32 +10123,50 @@ export interface ByCriteria29 {
      */
     title?: string;
 }
-/**
- * Information about the source integration for this screenshot, enabling upload of changed files back to the source CMS. Set automatically during test resolution for files from integrations.
- */
-export interface SourceIntegration1 {
+export interface ProcessReadiness1 {
     /**
-     * The type of integration. Currently supported: 'heretto'. Additional types may be added in the future.
+     * Wait until combined stdout+stderr matches. Substring, or /regex/.
      */
-    type: "heretto";
+    stdio?: string;
     /**
-     * The name of the integration configuration in the config file. Used to look up authentication credentials.
+     * Fixed delay (ms).
      */
-    integrationName: string;
+    delayMs?: number;
+}
+export interface BrowserReadiness1 {
     /**
-     * The unique identifier (UUID) of the file in the source CMS. If not provided, the file will be looked up by path.
+     * Wait for network activity to be idle (no new requests) for this duration in milliseconds.
      */
-    fileId?: string;
+    networkIdleTime?: number;
     /**
-     * The path of the file in the source CMS. Used for lookup if fileId is not available.
+     * Wait for DOM mutations to stop for this duration in milliseconds.
      */
-    filePath?: string;
+    domIdleTime?: number;
+    find?: ElementCriteria3;
+}
+export interface AppReadiness2 {
     /**
-     * The local path to the file that references this source. Used for resolving relative paths.
+     * Fixed delay (ms).
      */
-    contentPath?: string;
+    delayMs?: number;
+    find?: ElementCriteria4;
 }
-export interface AppCapturesDonTSupportCropYet1 {
+export interface WaitUntilRequiresASurface1 {
+    [k: string]: unknown;
+}
+export interface AProcessSurfaceForbidsElementTargeting1 {
+    [k: string]: unknown;
+}
+export interface AProcessSurfaceTakesProcessReadiness1 {
+    [k: string]: unknown;
+}
+export interface ABrowserSurfaceTakesBrowserReadiness1 {
+    [k: string]: unknown;
+}
+export interface AnAppSurfaceTakesAppReadiness1 {
+    [k: string]: unknown;
+}
+export interface ABrowserEngineStringSurfaceTakesBrowserReadiness1 {
     [k: string]: unknown;
 }
 export interface Common29 {
@@ -9918,8 +10302,127 @@ export interface SourceLocation29 {
      */
     endIndex: number;
 }
-export interface SaveCookie2 {
-    saveCookie: SaveCookie3;
+export interface Screenshot2 {
+    screenshot: Screenshot3;
+    [k: string]: unknown;
+}
+export interface CaptureScreenshotFields1 {
+    /**
+     * The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }). App captures don't support `crop` yet.
+     */
+    surface?: SurfaceByBrowserEngine9 | BrowserSurface13 | AppSurface7;
+    path?: ScreenshotSimple3;
+    /**
+     * Directory of the PNG file. If the directory doesn't exist, creates the directory.
+     */
+    directory?: string;
+    /**
+     * Allowed variation in percentage of pixels between the new screenshot and the existing screenshot at `path`. If the difference between the new screenshot and the existing screenshot is greater than `maxVariation`, the step fails. If a screenshot doesn't exist at `path`, this value is ignored.
+     */
+    maxVariation?: number;
+    /**
+     * If `true`, overwrites the existing screenshot at `path` if it exists.
+     * If `aboveVariation`, overwrites the existing screenshot at `path` if the difference between the new screenshot and the existing screenshot is greater than `maxVariation`.
+     */
+    overwrite?: "true" | "false" | "aboveVariation";
+    crop?: CropByElementSimple1 | CropByElementDetailed1;
+    sourceIntegration?: SourceIntegration1;
+}
+export interface BrowserSurface13 {
+    /**
+     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
+     */
+    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
+    /**
+     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
+     */
+    name?: string;
+    window?: WindowTabSelector26;
+    tab?: WindowTabSelector27;
+}
+export interface ByCriteria33 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface ByCriteria34 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface AppSurface7 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector7;
+}
+export interface ByCriteria35 {
+    /**
+     * Assigned window name.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Window title to match. Substring, or /regex/.
+     */
+    title?: string;
+}
+/**
+ * Information about the source integration for this screenshot, enabling upload of changed files back to the source CMS. Set automatically during test resolution for files from integrations.
+ */
+export interface SourceIntegration1 {
+    /**
+     * The type of integration. Currently supported: 'heretto'. Additional types may be added in the future.
+     */
+    type: "heretto";
+    /**
+     * The name of the integration configuration in the config file. Used to look up authentication credentials.
+     */
+    integrationName: string;
+    /**
+     * The unique identifier (UUID) of the file in the source CMS. If not provided, the file will be looked up by path.
+     */
+    fileId?: string;
+    /**
+     * The path of the file in the source CMS. Used for lookup if fileId is not available.
+     */
+    filePath?: string;
+    /**
+     * The local path to the file that references this source. Used for resolving relative paths.
+     */
+    contentPath?: string;
+}
+export interface AppCapturesDonTSupportCropYet1 {
     [k: string]: unknown;
 }
 export interface Common30 {
@@ -10055,96 +10558,10 @@ export interface SourceLocation30 {
      */
     endIndex: number;
 }
-export interface Record2 {
-    record: Record3;
-    [k: string]: unknown;
-}
-export interface RecordDetailed1 {
-    /**
-     * The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.
-     */
-    surface?: SurfaceByBrowserEngine8 | BrowserSurface12;
-    /**
-     * File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.
-     */
-    path?: string;
-    /**
-     * Directory of the file. If the directory doesn't exist, creates the directory.
-     */
-    directory?: string;
-    /**
-     * If `true`, overwrites the existing recording at `path` if it exists.
-     */
-    overwrite?: "true" | "false";
-    /**
-     * Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.
-     */
-    name?: string;
-    engine?: RecordingEngine1;
+export interface SaveCookie2 {
+    saveCookie: SaveCookie3;
     [k: string]: unknown;
 }
-export interface BrowserSurface12 {
-    /**
-     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
-     */
-    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
-    /**
-     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
-     */
-    name?: string;
-    window?: WindowTabSelector24;
-    tab?: WindowTabSelector25;
-}
-export interface ByCriteria30 {
-    /**
-     * Name assigned when the window/tab was opened.
-     */
-    name?: string;
-    /**
-     * Index in creation order. Negative counts from the end.
-     */
-    index?: number;
-    /**
-     * Page title to match. Substring, or /regex/.
-     */
-    title?: string;
-    /**
-     * Page URL to match. Substring, or /regex/.
-     */
-    url?: string;
-}
-export interface ByCriteria31 {
-    /**
-     * Name assigned when the window/tab was opened.
-     */
-    name?: string;
-    /**
-     * Index in creation order. Negative counts from the end.
-     */
-    index?: number;
-    /**
-     * Page title to match. Substring, or /regex/.
-     */
-    title?: string;
-    /**
-     * Page URL to match. Substring, or /regex/.
-     */
-    url?: string;
-}
-export interface RecordingEngineDetailed1 {
-    /**
-     * Recording engine. `browser` records the Chrome viewport (concurrency-safe); `ffmpeg` records the screen and supports any application.
-     */
-    name: "browser" | "ffmpeg";
-    /**
-     * What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).
-     */
-    target?: "display" | "window" | "viewport";
-    /**
-     * Capture frame rate for the `ffmpeg` engine.
-     */
-    fps?: number;
-}
 export interface Common31 {
     /**
      * JSON Schema for this object.
@@ -10278,25 +10695,105 @@ export interface SourceLocation31 {
      */
     endIndex: number;
 }
-export interface StopRecord2 {
-    stopRecord: StopRecord3;
+export interface Record2 {
+    record: Record3;
     [k: string]: unknown;
 }
-export interface StopRecordDetailed1 {
+export interface RecordDetailed1 {
     /**
-     * Name of the recording to stop. Matches the `name` given to a `record` step.
+     * The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.
      */
-    name: string;
-}
-export interface Common32 {
+    surface?: SurfaceByBrowserEngine10 | BrowserSurface14;
     /**
-     * JSON Schema for this object.
+     * File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    path?: string;
     /**
-     * ID of the step.
+     * Directory of the file. If the directory doesn't exist, creates the directory.
      */
-    stepId?: string;
+    directory?: string;
+    /**
+     * If `true`, overwrites the existing recording at `path` if it exists.
+     */
+    overwrite?: "true" | "false";
+    /**
+     * Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.
+     */
+    name?: string;
+    engine?: RecordingEngine1;
+    [k: string]: unknown;
+}
+export interface BrowserSurface14 {
+    /**
+     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
+     */
+    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
+    /**
+     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
+     */
+    name?: string;
+    window?: WindowTabSelector28;
+    tab?: WindowTabSelector29;
+}
+export interface ByCriteria36 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface ByCriteria37 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
+    /**
+     * Page URL to match. Substring, or /regex/.
+     */
+    url?: string;
+}
+export interface RecordingEngineDetailed1 {
+    /**
+     * Recording engine. `browser` records the Chrome viewport (concurrency-safe); `ffmpeg` records the screen and supports any application.
+     */
+    name: "browser" | "ffmpeg";
+    /**
+     * What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).
+     */
+    target?: "display" | "window" | "viewport";
+    /**
+     * Capture frame rate for the `ffmpeg` engine.
+     */
+    fps?: number;
+}
+export interface Common32 {
+    /**
+     * JSON Schema for this object.
+     */
+    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    /**
+     * ID of the step.
+     */
+    stepId?: string;
     /**
      * Description of the step.
      */
@@ -10421,6 +10918,149 @@ export interface SourceLocation32 {
      */
     endIndex: number;
 }
+export interface StopRecord2 {
+    stopRecord: StopRecord3;
+    [k: string]: unknown;
+}
+export interface StopRecordDetailed1 {
+    /**
+     * Name of the recording to stop. Matches the `name` given to a `record` step.
+     */
+    name: string;
+}
+export interface Common33 {
+    /**
+     * JSON Schema for this object.
+     */
+    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    /**
+     * ID of the step.
+     */
+    stepId?: string;
+    /**
+     * Description of the step.
+     */
+    description?: string;
+    /**
+     * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
+     */
+    unsafe?: boolean;
+    outputs?: OutputsStep33;
+    variables?: VariablesStep33;
+    /**
+     * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
+     */
+    breakpoint?: boolean;
+    if?: Condition67;
+    /**
+     * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
+     */
+    assertions?: Condition68 | Assertion33[];
+    /**
+     * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onPass?: Routing136[];
+    /**
+     * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onFail?: Routing137[];
+    /**
+     * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onWarning?: Routing138[];
+    /**
+     * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
+     */
+    onSkip?: Routing139[];
+    location?: SourceLocation33;
+    /**
+     * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
+     */
+    autoScreenshot?: string;
+    /**
+     * Total number of times this step ran (the initial attempt plus retries) when a routing `retry` action re-ran it. Present only in test results, and only when the step was retried at least once (so the value is always >= 2). This is system-populated metadata and should not be set manually.
+     */
+    attempts?: number;
+    /**
+     * Which visit of this step produced this report, when a routing goToStep re-ran it (the first visit omits this field). Present only in test results; system-populated.
+     */
+    visit?: number;
+    [k: string]: unknown;
+}
+/**
+ * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
+ */
+export interface OutputsStep33 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `OutputsStep33`'s JSON-Schema definition
+     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     */
+    [k: string]: string;
+}
+/**
+ * Environment variables to set from user-defined expressions.
+ */
+export interface VariablesStep33 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `VariablesStep33`'s JSON-Schema definition
+     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     */
+    [k: string]: string;
+}
+/**
+ * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
+ */
+export interface Assertion33 {
+    /**
+     * Human-readable articulation of the check, e.g. `exitCode in [0]`.
+     */
+    statement: string;
+    /**
+     * Who defined the assertion: `implicit` (runner-defined) or `custom` (user-defined).
+     */
+    source: "implicit" | "custom";
+    /**
+     * Outcome of evaluating the assertion.
+     */
+    result: "PASS" | "FAIL" | "WARNING" | "SKIPPED";
+    /**
+     * The value (or values) the assertion expected. Optional.
+     */
+    expected?: unknown[] | boolean | number | null | number | {
+        [k: string]: unknown;
+    } | string;
+    /**
+     * The value actually observed. Optional.
+     */
+    actual?: unknown[] | boolean | number | null | number | {
+        [k: string]: unknown;
+    } | string;
+    /**
+     * Human-readable explanation of the outcome. Optional.
+     */
+    description?: string;
+}
+/**
+ * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
+ */
+export interface SourceLocation33 {
+    /**
+     * 1-indexed line number in the source file where the step was detected.
+     */
+    line: number;
+    /**
+     * 0-indexed character offset from the start of the source file where the step begins.
+     */
+    startIndex: number;
+    /**
+     * 0-indexed character offset from the start of the source file where the step ends (exclusive).
+     */
+    endIndex: number;
+}
 export interface CloseSurface2 {
     closeSurface: CloseSurface3;
     [k: string]: unknown;
@@ -10431,7 +11071,7 @@ export interface ProcessSurface4 {
      */
     process: string;
 }
-export interface BrowserSurface13 {
+export interface BrowserSurface15 {
     /**
      * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
      */
@@ -10440,10 +11080,10 @@ export interface BrowserSurface13 {
      * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
      */
     name?: string;
-    window?: WindowTabSelector26;
-    tab?: WindowTabSelector27;
+    window?: WindowTabSelector30;
+    tab?: WindowTabSelector31;
 }
-export interface ByCriteria32 {
+export interface ByCriteria38 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10461,7 +11101,7 @@ export interface ByCriteria32 {
      */
     url?: string;
 }
-export interface ByCriteria33 {
+export interface ByCriteria39 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10479,14 +11119,14 @@ export interface ByCriteria33 {
      */
     url?: string;
 }
-export interface AppSurface6 {
+export interface AppSurface8 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector6;
+    window?: AppWindowSelector8;
 }
-export interface ByCriteria34 {
+export interface ByCriteria40 {
     /**
      * Assigned window name.
      */
@@ -10506,7 +11146,7 @@ export interface ProcessSurface5 {
      */
     process: string;
 }
-export interface BrowserSurface14 {
+export interface BrowserSurface16 {
     /**
      * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
      */
@@ -10515,10 +11155,10 @@ export interface BrowserSurface14 {
      * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
      */
     name?: string;
-    window?: WindowTabSelector28;
-    tab?: WindowTabSelector29;
+    window?: WindowTabSelector32;
+    tab?: WindowTabSelector33;
 }
-export interface ByCriteria35 {
+export interface ByCriteria41 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10536,7 +11176,7 @@ export interface ByCriteria35 {
      */
     url?: string;
 }
-export interface ByCriteria36 {
+export interface ByCriteria42 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -10554,14 +11194,14 @@ export interface ByCriteria36 {
      */
     url?: string;
 }
-export interface AppSurface7 {
+export interface AppSurface9 {
     /**
      * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
     app: string;
-    window?: AppWindowSelector7;
+    window?: AppWindowSelector9;
 }
-export interface ByCriteria37 {
+export interface ByCriteria43 {
     /**
      * Assigned window name.
      */
@@ -10575,7 +11215,7 @@ export interface ByCriteria37 {
      */
     title?: string;
 }
-export interface Common33 {
+export interface Common34 {
     /**
      * JSON Schema for this object.
      */
@@ -10592,34 +11232,34 @@ export interface Common33 {
      * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
      */
     unsafe?: boolean;
-    outputs?: OutputsStep33;
-    variables?: VariablesStep33;
+    outputs?: OutputsStep34;
+    variables?: VariablesStep34;
     /**
      * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
      */
     breakpoint?: boolean;
-    if?: Condition67;
+    if?: Condition69;
     /**
      * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
      */
-    assertions?: Condition68 | Assertion33[];
+    assertions?: Condition70 | Assertion34[];
     /**
      * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onPass?: Routing136[];
+    onPass?: Routing140[];
     /**
      * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onFail?: Routing137[];
+    onFail?: Routing141[];
     /**
      * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onWarning?: Routing138[];
+    onWarning?: Routing142[];
     /**
      * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
      */
-    onSkip?: Routing139[];
-    location?: SourceLocation33;
+    onSkip?: Routing143[];
+    location?: SourceLocation34;
     /**
      * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
      */
@@ -10637,11 +11277,11 @@ export interface Common33 {
 /**
  * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
  */
-export interface OutputsStep33 {
+export interface OutputsStep34 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `OutputsStep33`'s JSON-Schema definition
+     * This interface was referenced by `OutputsStep34`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -10649,11 +11289,11 @@ export interface OutputsStep33 {
 /**
  * Environment variables to set from user-defined expressions.
  */
-export interface VariablesStep33 {
+export interface VariablesStep34 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `VariablesStep33`'s JSON-Schema definition
+     * This interface was referenced by `VariablesStep34`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -10661,7 +11301,7 @@ export interface VariablesStep33 {
 /**
  * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
  */
-export interface Assertion33 {
+export interface Assertion34 {
     /**
      * Human-readable articulation of the check, e.g. `exitCode in [0]`.
      */
@@ -10694,7 +11334,7 @@ export interface Assertion33 {
 /**
  * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
  */
-export interface SourceLocation33 {
+export interface SourceLocation34 {
     /**
      * 1-indexed line number in the source file where the step was detected.
      */
@@ -10780,37 +11420,381 @@ export interface DeviceDescriptor2 {
     /**
      * Platform version used when creating a device; must match an installed image/runtime for the target platform (install more with `doc-detective install android` or `doc-detective install ios`). Ignored when `name` already matches an existing device. Default: the newest installed version.
      */
-    osVersion?: string;
+    osVersion?: string;
+    /**
+     * Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable.
+     */
+    headless?: boolean;
+    /**
+     * Initial orientation. Reserved; validated now, not yet implemented.
+     */
+    orientation?: "portrait" | "landscape";
+    /**
+     * Pin a specific device/emulator instance by UDID. Reserved; validated now, not yet implemented.
+     */
+    udid?: string;
+    /**
+     * Cloud device farm configuration, keyed by provider. Reserved; validated now, not yet implemented.
+     */
+    provider?: {
+        [k: string]: unknown;
+    };
+}
+/**
+ * Startup readiness: a fixed delay and/or an element that must exist before the surface is considered open. No condition applies by default.
+ */
+export interface AppReadiness3 {
+    /**
+     * Fixed delay (ms).
+     */
+    delayMs?: number;
+    find?: ElementCriteria5;
+}
+export interface Common35 {
+    /**
+     * JSON Schema for this object.
+     */
+    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    /**
+     * ID of the step.
+     */
+    stepId?: string;
+    /**
+     * Description of the step.
+     */
+    description?: string;
+    /**
+     * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
+     */
+    unsafe?: boolean;
+    outputs?: OutputsStep35;
+    variables?: VariablesStep35;
+    /**
+     * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
+     */
+    breakpoint?: boolean;
+    if?: Condition71;
+    /**
+     * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
+     */
+    assertions?: Condition72 | Assertion35[];
+    /**
+     * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onPass?: Routing144[];
+    /**
+     * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onFail?: Routing145[];
+    /**
+     * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onWarning?: Routing146[];
+    /**
+     * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
+     */
+    onSkip?: Routing147[];
+    location?: SourceLocation35;
+    /**
+     * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
+     */
+    autoScreenshot?: string;
+    /**
+     * Total number of times this step ran (the initial attempt plus retries) when a routing `retry` action re-ran it. Present only in test results, and only when the step was retried at least once (so the value is always >= 2). This is system-populated metadata and should not be set manually.
+     */
+    attempts?: number;
+    /**
+     * Which visit of this step produced this report, when a routing goToStep re-ran it (the first visit omits this field). Present only in test results; system-populated.
+     */
+    visit?: number;
+    [k: string]: unknown;
+}
+/**
+ * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
+ */
+export interface OutputsStep35 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `OutputsStep35`'s JSON-Schema definition
+     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     */
+    [k: string]: string;
+}
+/**
+ * Environment variables to set from user-defined expressions.
+ */
+export interface VariablesStep35 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `VariablesStep35`'s JSON-Schema definition
+     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     */
+    [k: string]: string;
+}
+/**
+ * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
+ */
+export interface Assertion35 {
+    /**
+     * Human-readable articulation of the check, e.g. `exitCode in [0]`.
+     */
+    statement: string;
+    /**
+     * Who defined the assertion: `implicit` (runner-defined) or `custom` (user-defined).
+     */
+    source: "implicit" | "custom";
+    /**
+     * Outcome of evaluating the assertion.
+     */
+    result: "PASS" | "FAIL" | "WARNING" | "SKIPPED";
+    /**
+     * The value (or values) the assertion expected. Optional.
+     */
+    expected?: unknown[] | boolean | number | null | number | {
+        [k: string]: unknown;
+    } | string;
+    /**
+     * The value actually observed. Optional.
+     */
+    actual?: unknown[] | boolean | number | null | number | {
+        [k: string]: unknown;
+    } | string;
+    /**
+     * Human-readable explanation of the outcome. Optional.
+     */
+    description?: string;
+}
+/**
+ * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
+ */
+export interface SourceLocation35 {
+    /**
+     * 1-indexed line number in the source file where the step was detected.
+     */
+    line: number;
+    /**
+     * 0-indexed character offset from the start of the source file where the step begins.
+     */
+    startIndex: number;
+    /**
+     * 0-indexed character offset from the start of the source file where the step ends (exclusive).
+     */
+    endIndex: number;
+}
+export interface LoadVariables2 {
+    loadVariables: LoadVariables3;
+    [k: string]: unknown;
+}
+export interface Common36 {
+    /**
+     * JSON Schema for this object.
+     */
+    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    /**
+     * ID of the step.
+     */
+    stepId?: string;
+    /**
+     * Description of the step.
+     */
+    description?: string;
+    /**
+     * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
+     */
+    unsafe?: boolean;
+    outputs?: OutputsStep36;
+    variables?: VariablesStep36;
+    /**
+     * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
+     */
+    breakpoint?: boolean;
+    if?: Condition73;
+    /**
+     * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
+     */
+    assertions?: Condition74 | Assertion36[];
+    /**
+     * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onPass?: Routing148[];
+    /**
+     * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onFail?: Routing149[];
+    /**
+     * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     */
+    onWarning?: Routing150[];
+    /**
+     * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
+     */
+    onSkip?: Routing151[];
+    location?: SourceLocation36;
+    /**
+     * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
+     */
+    autoScreenshot?: string;
+    /**
+     * Total number of times this step ran (the initial attempt plus retries) when a routing `retry` action re-ran it. Present only in test results, and only when the step was retried at least once (so the value is always >= 2). This is system-populated metadata and should not be set manually.
+     */
+    attempts?: number;
+    /**
+     * Which visit of this step produced this report, when a routing goToStep re-ran it (the first visit omits this field). Present only in test results; system-populated.
+     */
+    visit?: number;
+    [k: string]: unknown;
+}
+/**
+ * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
+ */
+export interface OutputsStep36 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `OutputsStep36`'s JSON-Schema definition
+     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     */
+    [k: string]: string;
+}
+/**
+ * Environment variables to set from user-defined expressions.
+ */
+export interface VariablesStep36 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `VariablesStep36`'s JSON-Schema definition
+     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     */
+    [k: string]: string;
+}
+/**
+ * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
+ */
+export interface Assertion36 {
+    /**
+     * Human-readable articulation of the check, e.g. `exitCode in [0]`.
+     */
+    statement: string;
+    /**
+     * Who defined the assertion: `implicit` (runner-defined) or `custom` (user-defined).
+     */
+    source: "implicit" | "custom";
+    /**
+     * Outcome of evaluating the assertion.
+     */
+    result: "PASS" | "FAIL" | "WARNING" | "SKIPPED";
+    /**
+     * The value (or values) the assertion expected. Optional.
+     */
+    expected?: unknown[] | boolean | number | null | number | {
+        [k: string]: unknown;
+    } | string;
+    /**
+     * The value actually observed. Optional.
+     */
+    actual?: unknown[] | boolean | number | null | number | {
+        [k: string]: unknown;
+    } | string;
+    /**
+     * Human-readable explanation of the outcome. Optional.
+     */
+    description?: string;
+}
+/**
+ * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
+ */
+export interface SourceLocation36 {
+    /**
+     * 1-indexed line number in the source file where the step was detected.
+     */
+    line: number;
+    /**
+     * 0-indexed character offset from the start of the source file where the step begins.
+     */
+    startIndex: number;
+    /**
+     * 0-indexed character offset from the start of the source file where the step ends (exclusive).
+     */
+    endIndex: number;
+}
+export interface DragAndDrop2 {
+    dragAndDrop: DragAndDrop3;
+    [k: string]: unknown;
+}
+/**
+ * Drag and drop an element from source to target.
+ */
+export interface DragAndDrop3 {
+    /**
+     * The element to drag.
+     */
+    source: ElementSimple2 | ElementDetailed2;
+    /**
+     * The target location to drop the element.
+     */
+    target: ElementSimple3 | ElementDetailed3;
+    /**
+     * Duration of the drag operation in milliseconds.
+     */
+    duration?: number;
+    /**
+     * The browser window/tab the source and target elements live in. Omit to act on the active tab. The targeted tab stays focused afterward.
+     */
+    surface?: SurfaceByBrowserEngine11 | BrowserSurface17;
+    [k: string]: unknown;
+}
+export interface BrowserSurface17 {
+    /**
+     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
+     */
+    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
+    /**
+     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
+     */
+    name?: string;
+    window?: WindowTabSelector34;
+    tab?: WindowTabSelector35;
+}
+export interface ByCriteria44 {
+    /**
+     * Name assigned when the window/tab was opened.
+     */
+    name?: string;
+    /**
+     * Index in creation order. Negative counts from the end.
+     */
+    index?: number;
+    /**
+     * Page title to match. Substring, or /regex/.
+     */
+    title?: string;
     /**
-     * Run the Android emulator without a window. No-op on iOS (simulators boot without the Simulator UI on CI) and ignored where not applicable.
+     * Page URL to match. Substring, or /regex/.
      */
-    headless?: boolean;
+    url?: string;
+}
+export interface ByCriteria45 {
     /**
-     * Initial orientation. Reserved; validated now, not yet implemented.
+     * Name assigned when the window/tab was opened.
      */
-    orientation?: "portrait" | "landscape";
+    name?: string;
     /**
-     * Pin a specific device/emulator instance by UDID. Reserved; validated now, not yet implemented.
+     * Index in creation order. Negative counts from the end.
      */
-    udid?: string;
+    index?: number;
     /**
-     * Cloud device farm configuration, keyed by provider. Reserved; validated now, not yet implemented.
+     * Page title to match. Substring, or /regex/.
      */
-    provider?: {
-        [k: string]: unknown;
-    };
-}
-/**
- * Startup readiness: a fixed delay and/or an element that must exist before the surface is considered open. No condition applies by default.
- */
-export interface AppReadiness3 {
+    title?: string;
     /**
-     * Fixed delay (ms).
+     * Page URL to match. Substring, or /regex/.
      */
-    delayMs?: number;
-    find?: ElementCriteria5;
+    url?: string;
 }
-export interface Common34 {
+export interface Common37 {
     /**
      * JSON Schema for this object.
      */
@@ -10827,34 +11811,34 @@ export interface Common34 {
      * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
      */
     unsafe?: boolean;
-    outputs?: OutputsStep34;
-    variables?: VariablesStep34;
+    outputs?: OutputsStep37;
+    variables?: VariablesStep37;
     /**
      * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
      */
     breakpoint?: boolean;
-    if?: Condition69;
+    if?: Condition75;
     /**
      * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
      */
-    assertions?: Condition70 | Assertion34[];
+    assertions?: Condition76 | Assertion37[];
     /**
      * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onPass?: Routing140[];
+    onPass?: Routing152[];
     /**
      * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onFail?: Routing141[];
+    onFail?: Routing153[];
     /**
      * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onWarning?: Routing142[];
+    onWarning?: Routing154[];
     /**
      * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
      */
-    onSkip?: Routing143[];
-    location?: SourceLocation34;
+    onSkip?: Routing155[];
+    location?: SourceLocation37;
     /**
      * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
      */
@@ -10872,11 +11856,11 @@ export interface Common34 {
 /**
  * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
  */
-export interface OutputsStep34 {
+export interface OutputsStep37 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `OutputsStep34`'s JSON-Schema definition
+     * This interface was referenced by `OutputsStep37`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -10884,11 +11868,11 @@ export interface OutputsStep34 {
 /**
  * Environment variables to set from user-defined expressions.
  */
-export interface VariablesStep34 {
+export interface VariablesStep37 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `VariablesStep34`'s JSON-Schema definition
+     * This interface was referenced by `VariablesStep37`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -10896,7 +11880,7 @@ export interface VariablesStep34 {
 /**
  * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
  */
-export interface Assertion34 {
+export interface Assertion37 {
     /**
      * Human-readable articulation of the check, e.g. `exitCode in [0]`.
      */
@@ -10929,7 +11913,7 @@ export interface Assertion34 {
 /**
  * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
  */
-export interface SourceLocation34 {
+export interface SourceLocation37 {
     /**
      * 1-indexed line number in the source file where the step was detected.
      */
@@ -10943,11 +11927,11 @@ export interface SourceLocation34 {
      */
     endIndex: number;
 }
-export interface LoadVariables2 {
-    loadVariables: LoadVariables3;
+export interface LoadCookie2 {
+    loadCookie: LoadCookie3;
     [k: string]: unknown;
 }
-export interface Common35 {
+export interface Common38 {
     /**
      * JSON Schema for this object.
      */
@@ -10964,34 +11948,34 @@ export interface Common35 {
      * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
      */
     unsafe?: boolean;
-    outputs?: OutputsStep35;
-    variables?: VariablesStep35;
+    outputs?: OutputsStep38;
+    variables?: VariablesStep38;
     /**
      * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
      */
     breakpoint?: boolean;
-    if?: Condition71;
+    if?: Condition77;
     /**
      * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
      */
-    assertions?: Condition72 | Assertion35[];
+    assertions?: Condition78 | Assertion38[];
     /**
      * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onPass?: Routing144[];
+    onPass?: Routing156[];
     /**
      * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onFail?: Routing145[];
+    onFail?: Routing157[];
     /**
      * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onWarning?: Routing146[];
+    onWarning?: Routing158[];
     /**
      * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
      */
-    onSkip?: Routing147[];
-    location?: SourceLocation35;
+    onSkip?: Routing159[];
+    location?: SourceLocation38;
     /**
      * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
      */
@@ -11009,11 +11993,11 @@ export interface Common35 {
 /**
  * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
  */
-export interface OutputsStep35 {
+export interface OutputsStep38 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `OutputsStep35`'s JSON-Schema definition
+     * This interface was referenced by `OutputsStep38`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -11021,11 +12005,11 @@ export interface OutputsStep35 {
 /**
  * Environment variables to set from user-defined expressions.
  */
-export interface VariablesStep35 {
+export interface VariablesStep38 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `VariablesStep35`'s JSON-Schema definition
+     * This interface was referenced by `VariablesStep38`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -11033,7 +12017,7 @@ export interface VariablesStep35 {
 /**
  * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
  */
-export interface Assertion35 {
+export interface Assertion38 {
     /**
      * Human-readable articulation of the check, e.g. `exitCode in [0]`.
      */
@@ -11066,7 +12050,7 @@ export interface Assertion35 {
 /**
  * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
  */
-export interface SourceLocation35 {
+export interface SourceLocation38 {
     /**
      * 1-indexed line number in the source file where the step was detected.
      */
@@ -11080,33 +12064,26 @@ export interface SourceLocation35 {
      */
     endIndex: number;
 }
-export interface DragAndDrop2 {
-    dragAndDrop: DragAndDrop3;
+export interface Swipe2 {
+    swipe: Swipe3;
     [k: string]: unknown;
 }
-/**
- * Drag and drop an element from source to target.
- */
-export interface DragAndDrop3 {
-    /**
-     * The element to drag.
-     */
-    source: ElementSimple2 | ElementDetailed2;
+export interface SwipeDirectional1 {
+    direction: SwipeSimple3;
     /**
-     * The target location to drop the element.
+     * How far to swipe, as a fraction of the surface's height (for up/down) or width (for left/right).
      */
-    target: ElementSimple3 | ElementDetailed3;
+    distance?: number;
     /**
-     * Duration of the drag operation in milliseconds.
+     * Duration of the swipe movement in milliseconds.
      */
     duration?: number;
     /**
-     * The browser window/tab the source and target elements live in. Omit to act on the active tab. The targeted tab stays focused afterward.
+     * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
      */
-    surface?: SurfaceByBrowserEngine9 | BrowserSurface15;
-    [k: string]: unknown;
+    surface?: SurfaceByBrowserEngine12 | BrowserSurface18 | AppSurface10;
 }
-export interface BrowserSurface15 {
+export interface BrowserSurface18 {
     /**
      * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
      */
@@ -11115,10 +12092,10 @@ export interface BrowserSurface15 {
      * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
      */
     name?: string;
-    window?: WindowTabSelector30;
-    tab?: WindowTabSelector31;
+    window?: WindowTabSelector36;
+    tab?: WindowTabSelector37;
 }
-export interface ByCriteria38 {
+export interface ByCriteria46 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -11136,7 +12113,7 @@ export interface ByCriteria38 {
      */
     url?: string;
 }
-export interface ByCriteria39 {
+export interface ByCriteria47 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -11154,144 +12131,135 @@ export interface ByCriteria39 {
      */
     url?: string;
 }
-export interface Common36 {
+export interface AppSurface10 {
     /**
-     * JSON Schema for this object.
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
-    $schema?: "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json";
+    app: string;
+    window?: AppWindowSelector10;
+}
+export interface ByCriteria48 {
     /**
-     * ID of the step.
+     * Assigned window name.
      */
-    stepId?: string;
+    name?: string;
     /**
-     * Description of the step.
+     * Index in creation order. Negative counts from the end.
      */
-    description?: string;
+    index?: number;
     /**
-     * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
+     * Window title to match. Substring, or /regex/.
      */
-    unsafe?: boolean;
-    outputs?: OutputsStep36;
-    variables?: VariablesStep36;
+    title?: string;
+}
+export interface SwipePointToPoint1 {
+    from: Point2;
+    to: Point3;
     /**
-     * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
+     * Duration of the swipe movement in milliseconds.
      */
-    breakpoint?: boolean;
-    if?: Condition73;
+    duration?: number;
     /**
-     * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
+     * The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": … }).
      */
-    assertions?: Condition74 | Assertion36[];
+    surface?: SurfaceByBrowserEngine13 | BrowserSurface19 | AppSurface11;
+}
+/**
+ * A pixel coordinate on the surface, measured from its top-left corner (0, 0).
+ */
+export interface Point2 {
     /**
-     * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     * Horizontal position in pixels from the left edge of the surface (the app window, or the browser viewport).
      */
-    onPass?: Routing148[];
+    x: number;
     /**
-     * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     * Vertical position in pixels from the top edge of the surface (the app window, or the browser viewport).
      */
-    onFail?: Routing149[];
+    y: number;
+}
+/**
+ * A pixel coordinate on the surface, measured from its top-left corner (0, 0).
+ */
+export interface Point3 {
     /**
-     * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
+     * Horizontal position in pixels from the left edge of the surface (the app window, or the browser viewport).
      */
-    onWarning?: Routing150[];
+    x: number;
     /**
-     * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
+     * Vertical position in pixels from the top edge of the surface (the app window, or the browser viewport).
      */
-    onSkip?: Routing151[];
-    location?: SourceLocation36;
+    y: number;
+}
+export interface BrowserSurface19 {
     /**
-     * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
+     * Browser engine. Selects the browser surface with that engine (or the one named by `name`). A goTo step opens the browser if it isn't open yet; other steps require it to already be open.
      */
-    autoScreenshot?: string;
+    browser: "chrome" | "firefox" | "safari" | "webkit" | "edge";
     /**
-     * Total number of times this step ran (the initial attempt plus retries) when a routing `retry` action re-ran it. Present only in test results, and only when the step was retried at least once (so the value is always >= 2). This is system-populated metadata and should not be set manually.
+     * Name of the browser surface. Defaults to the engine name (the context's default browser registers under its engine). Assign distinct names to drive multiple browsers at once, including several of the same engine.
      */
-    attempts?: number;
+    name?: string;
+    window?: WindowTabSelector38;
+    tab?: WindowTabSelector39;
+}
+export interface ByCriteria49 {
     /**
-     * Which visit of this step produced this report, when a routing goToStep re-ran it (the first visit omits this field). Present only in test results; system-populated.
+     * Name assigned when the window/tab was opened.
      */
-    visit?: number;
-    [k: string]: unknown;
-}
-/**
- * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
- */
-export interface OutputsStep36 {
+    name?: string;
     /**
-     * Runtime expression for a user-defined output value.
-     *
-     * This interface was referenced by `OutputsStep36`'s JSON-Schema definition
-     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     * Index in creation order. Negative counts from the end.
      */
-    [k: string]: string;
-}
-/**
- * Environment variables to set from user-defined expressions.
- */
-export interface VariablesStep36 {
+    index?: number;
     /**
-     * Runtime expression for a user-defined output value.
-     *
-     * This interface was referenced by `VariablesStep36`'s JSON-Schema definition
-     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     * Page title to match. Substring, or /regex/.
      */
-    [k: string]: string;
-}
-/**
- * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
- */
-export interface Assertion36 {
+    title?: string;
     /**
-     * Human-readable articulation of the check, e.g. `exitCode in [0]`.
+     * Page URL to match. Substring, or /regex/.
      */
-    statement: string;
+    url?: string;
+}
+export interface ByCriteria50 {
     /**
-     * Who defined the assertion: `implicit` (runner-defined) or `custom` (user-defined).
+     * Name assigned when the window/tab was opened.
      */
-    source: "implicit" | "custom";
+    name?: string;
     /**
-     * Outcome of evaluating the assertion.
+     * Index in creation order. Negative counts from the end.
      */
-    result: "PASS" | "FAIL" | "WARNING" | "SKIPPED";
+    index?: number;
     /**
-     * The value (or values) the assertion expected. Optional.
+     * Page title to match. Substring, or /regex/.
      */
-    expected?: unknown[] | boolean | number | null | number | {
-        [k: string]: unknown;
-    } | string;
+    title?: string;
     /**
-     * The value actually observed. Optional.
+     * Page URL to match. Substring, or /regex/.
      */
-    actual?: unknown[] | boolean | number | null | number | {
-        [k: string]: unknown;
-    } | string;
+    url?: string;
+}
+export interface AppSurface11 {
     /**
-     * Human-readable explanation of the outcome. Optional.
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
      */
-    description?: string;
+    app: string;
+    window?: AppWindowSelector11;
 }
-/**
- * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
- */
-export interface SourceLocation36 {
+export interface ByCriteria51 {
     /**
-     * 1-indexed line number in the source file where the step was detected.
+     * Assigned window name.
      */
-    line: number;
+    name?: string;
     /**
-     * 0-indexed character offset from the start of the source file where the step begins.
+     * Index in creation order. Negative counts from the end.
      */
-    startIndex: number;
+    index?: number;
     /**
-     * 0-indexed character offset from the start of the source file where the step ends (exclusive).
+     * Window title to match. Substring, or /regex/.
      */
-    endIndex: number;
-}
-export interface LoadCookie2 {
-    loadCookie: LoadCookie3;
-    [k: string]: unknown;
+    title?: string;
 }
-export interface Common37 {
+export interface Common39 {
     /**
      * JSON Schema for this object.
      */
@@ -11308,34 +12276,34 @@ export interface Common37 {
      * Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.
      */
     unsafe?: boolean;
-    outputs?: OutputsStep37;
-    variables?: VariablesStep37;
+    outputs?: OutputsStep39;
+    variables?: VariablesStep39;
     /**
      * Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.
      */
     breakpoint?: boolean;
-    if?: Condition75;
+    if?: Condition79;
     /**
      * Assertions for this step. As authored input, a custom condition expression (or array of expressions, combined with logical AND). In a test result, the runner replaces this with the array of articulated assertion records it evaluated (implicit then custom).
      */
-    assertions?: Condition76 | Assertion37[];
+    assertions?: Condition80 | Assertion39[];
     /**
      * Routing entries evaluated when this step passes. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onPass?: Routing152[];
+    onPass?: Routing160[];
     /**
      * Routing entries evaluated when this step fails. The first entry whose `if` matches applies; the default when none is set stops the test. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onFail?: Routing153[];
+    onFail?: Routing161[];
     /**
      * Routing entries evaluated when this step produces a warning. The first entry whose `if` matches applies. `continue`, `stop`, `retry`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed.
      */
-    onWarning?: Routing154[];
+    onWarning?: Routing162[];
     /**
      * Routing entries evaluated when this step is skipped (reached but not run — unsafe-blocked or guard-`if` false). The first entry whose `if` matches applies. `continue`, `stop`, and `goToStep` are honored at runtime; `goToTest` is validated but not yet executed. (`retry` is a no-op here — a step that never ran cannot be re-run.)
      */
-    onSkip?: Routing155[];
-    location?: SourceLocation37;
+    onSkip?: Routing163[];
+    location?: SourceLocation39;
     /**
      * Path, relative to the run's artifact directory (the report's `runDir`), of the screenshot captured automatically after this step. Always a non-empty, forward-slash, relative path. Present only in test results, when `autoScreenshot` is enabled and the capture succeeded. This is system-populated metadata and should not be set manually.
      */
@@ -11353,11 +12321,11 @@ export interface Common37 {
 /**
  * Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.
  */
-export interface OutputsStep37 {
+export interface OutputsStep39 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `OutputsStep37`'s JSON-Schema definition
+     * This interface was referenced by `OutputsStep39`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -11365,11 +12333,11 @@ export interface OutputsStep37 {
 /**
  * Environment variables to set from user-defined expressions.
  */
-export interface VariablesStep37 {
+export interface VariablesStep39 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `VariablesStep37`'s JSON-Schema definition
+     * This interface was referenced by `VariablesStep39`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -11377,7 +12345,7 @@ export interface VariablesStep37 {
 /**
  * An articulated assertion record produced by the runner for a step result. Each record names a single verification check, whether it passed, and the values it compared. The step's result is the roll-up of its assertion results (FAIL > WARNING > all-SKIPPED > PASS). System-populated; appears in test results, not in authored specs.
  */
-export interface Assertion37 {
+export interface Assertion39 {
     /**
      * Human-readable articulation of the check, e.g. `exitCode in [0]`.
      */
@@ -11410,7 +12378,7 @@ export interface Assertion37 {
 /**
  * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
  */
-export interface SourceLocation37 {
+export interface SourceLocation39 {
     /**
      * 1-indexed line number in the source file where the step was detected.
      */