doc-detective-common 4.19.0 → 4.20.0

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

@@ -5,7 +5,7 @@
 /**
  * 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 & LoadVariables) | (Common15 & DragAndDrop) | (Common16 & LoadCookie) | (Common17 & 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 & Wait);
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -497,14 +497,14 @@ export type TypeKeysSimple = string | string[];
 export type TypeKeysDetailed = {
     keys: TypeKeysSimple1;
     /**
-     * Delay in milliseconds between each key press during a recording, and between each keystroke sent to a process surface.
+     * Delay in milliseconds between each key press during a recording, and between each keystroke sent to a process surface. Not applied on app surfaces in this phase — the native driver types the value atomically.
      */
     inputDelay?: number;
     surface?: Surface;
     /**
-     * After sending the keys, wait until the surface is ready. Requires a `surface`; the allowed conditions depend on the surface kind: a process surface accepts `stdio`/`delayMs`, a browser surface accepts `networkIdleTime`/`domIdleTime`/`find`. No condition applies by default.
+     * After sending the keys, wait until the surface is ready. Requires a `surface`; the allowed conditions depend on the surface kind: a process surface accepts `stdio`/`delayMs`, a browser surface accepts `networkIdleTime`/`domIdleTime`/`find`, an app surface accepts `delayMs`/`find`. No condition applies by default.
      */
-    waitUntil?: ProcessReadiness | BrowserReadiness;
+    waitUntil?: ProcessReadiness | BrowserReadiness | AppReadiness;
     /**
      * Maximum time in milliseconds to wait for `waitUntil` after sending the keys.
      */
@@ -539,15 +539,15 @@ export type TypeKeysDetailed = {
      * Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.
      */
     elementAria?: string;
-} & WaitUntilRequiresASurface & AProcessSurfaceForbidsElementTargeting & AProcessSurfaceTakesProcessReadiness & ABrowserSurfaceTakesBrowserReadiness & ABrowserEngineStringSurfaceTakesBrowserReadiness;
+} & WaitUntilRequiresASurface & AProcessSurfaceForbidsElementTargeting & AProcessSurfaceTakesProcessReadiness & ABrowserSurfaceTakesBrowserReadiness & AnAppSurfaceTakesAppReadiness & ABrowserEngineStringSurfaceTakesBrowserReadiness;
 /**
  * Sequence of keys to enter.
  */
 export type TypeKeysSimple1 = string | string[];
 /**
- * The surface a step acts on. Omit to act on the active surface. Supports background processes and browser windows/tabs; app surfaces are added in a later phase.
+ * 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 Surface = SurfaceByName | ProcessSurface | BrowserSurface2;
+export type Surface = SurfaceByName | ProcessSurface | BrowserSurface2 | AppSurface;
 /**
  * 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.
  */
@@ -576,6 +576,30 @@ export type ByIndex5 = 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 ByName5 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector = ByIndex6 | ByName6 | ByCriteria6;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex6 = 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 ByName6 = string;
+/**
+ * Wait for a specific element to be present. At least one finding field must be specified.
+ */
+export type ElementCriteria = {
+    [k: string]: unknown;
+};
+/**
+ * Wait for a specific element to be present. At least one finding field must be specified.
+ */
+export type ElementCriteria1 = {
+    [k: string]: unknown;
+};
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -616,6 +640,7 @@ export type Screenshot1 = ScreenshotSimple | CaptureScreenshotDetailed | Capture
  * 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.
  */
 export type ScreenshotSimple = string;
+export type CaptureScreenshotDetailed = CaptureScreenshotFields & AppCapturesDonTSupportCropYet;
 /**
  * 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.
  */
@@ -623,27 +648,39 @@ export type SurfaceByBrowserEngine2 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector6 = ByIndex6 | ByName6 | ByCriteria6;
+export type WindowTabSelector6 = ByIndex7 | ByName7 | ByCriteria7;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex6 = number;
+export type ByIndex7 = 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 ByName6 = string;
+export type ByName7 = 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 WindowTabSelector7 = ByIndex7 | ByName7 | ByCriteria7;
+export type WindowTabSelector7 = ByIndex8 | ByName8 | ByCriteria8;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex7 = number;
+export type ByIndex8 = 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 ByName7 = string;
+export type ByName8 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector1 = ByIndex9 | ByName9 | ByCriteria9;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex9 = 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 ByName9 = 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.
  */
@@ -752,27 +789,27 @@ export type SurfaceByBrowserEngine3 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector8 = ByIndex8 | ByName8 | ByCriteria8;
+export type WindowTabSelector8 = ByIndex10 | ByName10 | ByCriteria10;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex8 = number;
+export type ByIndex10 = 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 ByName8 = string;
+export type ByName10 = 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 WindowTabSelector9 = ByIndex9 | ByName9 | ByCriteria9;
+export type WindowTabSelector9 = ByIndex11 | ByName11 | ByCriteria11;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex9 = number;
+export type ByIndex11 = 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 ByName9 = string;
+export type ByName11 = 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.
  */
@@ -866,13 +903,13 @@ export type Routing55 = {
     [k: string]: unknown;
 };
 /**
- * Close one or more surfaces: background processes, or browser windows/tabs. A browser reference with a `tab` selector closes that tab; with a `window` selector it closes the window and its tabs. Closing a surface that is not open is a no-op (PASS). Renames `stopProcess`.
+ * Close one or more surfaces: background processes, browser windows/tabs or whole browser sessions, and native app surfaces. A browser reference with a `tab` selector closes that tab; with a `window` selector it closes the window and its tabs; with neither it closes the whole browser session. An app reference ({ "app": … }) closes the app surface, terminating the app when Doc Detective launched it. Closing a surface that is not open is a no-op (PASS). Renames `stopProcess`.
  */
 export type CloseSurface1 = Surface1 | [Surface2, ...Surface2[]];
 /**
- * The surface a step acts on. Omit to act on the active surface. Supports background processes and browser windows/tabs; app surfaces are added in a later phase.
+ * 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 Surface1 = SurfaceByName1 | ProcessSurface1 | BrowserSurface5;
+export type Surface1 = SurfaceByName1 | ProcessSurface1 | BrowserSurface5 | AppSurface2;
 /**
  * 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.
  */
@@ -880,31 +917,43 @@ export type SurfaceByName1 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector10 = ByIndex10 | ByName10 | ByCriteria10;
+export type WindowTabSelector10 = ByIndex12 | ByName12 | ByCriteria12;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex10 = number;
+export type ByIndex12 = 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 ByName10 = string;
+export type ByName12 = 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 WindowTabSelector11 = ByIndex11 | ByName11 | ByCriteria11;
+export type WindowTabSelector11 = ByIndex13 | ByName13 | ByCriteria13;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex11 = number;
+export type ByIndex13 = 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 ByName11 = string;
+export type ByName13 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector2 = ByIndex14 | ByName14 | ByCriteria14;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex14 = number;
 /**
- * The surface a step acts on. Omit to act on the active surface. Supports background processes and browser windows/tabs; app surfaces are added in a later phase.
+ * 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 Surface2 = SurfaceByName2 | ProcessSurface2 | BrowserSurface6;
+export type ByName14 = 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 Surface2 = SurfaceByName2 | ProcessSurface2 | BrowserSurface6 | AppSurface3;
 /**
  * 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.
  */
@@ -912,27 +961,39 @@ export type SurfaceByName2 = string;
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector12 = ByIndex12 | ByName12 | ByCriteria12;
+export type WindowTabSelector12 = ByIndex15 | ByName15 | ByCriteria15;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex12 = number;
+export type ByIndex15 = 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 ByName12 = string;
+export type ByName15 = 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 WindowTabSelector13 = ByIndex13 | ByName13 | ByCriteria13;
+export type WindowTabSelector13 = ByIndex16 | ByName16 | ByCriteria16;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex13 = number;
+export type ByIndex16 = 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 ByName13 = string;
+export type ByName16 = string;
+/**
+ * Which app window to act on. Omit to use the active window. Apps have windows, no tabs.
+ */
+export type AppWindowSelector3 = ByIndex17 | ByName17 | ByCriteria17;
+/**
+ * Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened).
+ */
+export type ByIndex17 = 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 ByName17 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -965,10 +1026,13 @@ export type Routing58 = {
 export type Routing59 = {
     [k: string]: unknown;
 };
+export type DeviceByName = string;
 /**
- * Load environment variables from the specified `.env` file.
+ * Wait for a specific element to be present. At least one finding field must be specified.
  */
-export type LoadVariables1 = string;
+export type ElementCriteria2 = {
+    [k: string]: unknown;
+};
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
@@ -1001,6 +1065,42 @@ export type Routing62 = {
 export type Routing63 = {
     [k: string]: unknown;
 };
+/**
+ * Load environment variables from the specified `.env` file.
+ */
+export type LoadVariables1 = string;
+/**
+ * A condition expression, or an array of expressions combined with logical AND.
+ */
+export type Condition32 = string | [string, ...string[]];
+/**
+ * A condition expression, or an array of expressions combined with logical AND.
+ */
+export type Condition33 = 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 Routing64 = {
+    [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 Routing65 = {
+    [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 Routing66 = {
+    [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 Routing67 = {
+    [k: string]: unknown;
+};
 /**
  * Display text, selector, or regex pattern (enclosed in forward slashes) of the element.
  */
@@ -1022,57 +1122,57 @@ export type SurfaceByBrowserEngine4 = "chrome" | "firefox" | "safari" | "webkit"
 /**
  * Which window to act on. Omit to use the active window.
  */
-export type WindowTabSelector14 = ByIndex14 | ByName14 | ByCriteria14;
+export type WindowTabSelector14 = ByIndex18 | ByName18 | ByCriteria18;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex14 = number;
+export type ByIndex18 = 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 ByName14 = string;
+export type ByName18 = 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 WindowTabSelector15 = ByIndex15 | ByName15 | ByCriteria15;
+export type WindowTabSelector15 = ByIndex19 | ByName19 | ByCriteria19;
 /**
  * Index in creation order. Negative counts from the end; `-1` is the newest.
  */
-export type ByIndex15 = number;
+export type ByIndex19 = 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 ByName15 = string;
+export type ByName19 = string;
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition32 = string | [string, ...string[]];
+export type Condition34 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition33 = string | [string, ...string[]];
+export type Condition35 = 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 Routing64 = {
+export type Routing68 = {
     [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 Routing65 = {
+export type Routing69 = {
     [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 Routing66 = {
+export type Routing70 = {
     [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 Routing67 = {
+export type Routing71 = {
     [k: string]: unknown;
 };
 /**
@@ -1089,33 +1189,33 @@ export type LoadCookieDetailed = {
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition34 = string | [string, ...string[]];
+export type Condition36 = string | [string, ...string[]];
 /**
  * A condition expression, or an array of expressions combined with logical AND.
  */
-export type Condition35 = string | [string, ...string[]];
+export type Condition37 = 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 Routing68 = {
+export type Routing72 = {
     [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 Routing69 = {
+export type Routing73 = {
     [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 Routing70 = {
+export type Routing74 = {
     [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 Routing71 = {
+export type Routing75 = {
     [k: string]: unknown;
 };
 /**
@@ -2748,6 +2848,27 @@ export interface ByCriteria5 {
      */
     url?: string;
 }
+export interface AppSurface {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector;
+}
+export interface ByCriteria6 {
+    /**
+     * 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 ProcessReadiness {
     /**
      * Wait until combined stdout+stderr matches. Substring, or /regex/.
@@ -2767,12 +2888,14 @@ export interface BrowserReadiness {
      * Wait for DOM mutations to stop for this duration in milliseconds.
      */
     domIdleTime?: number;
+    find?: ElementCriteria;
+}
+export interface AppReadiness {
     /**
-     * Wait for a specific element to be present in the DOM. At least one finding field must be specified.
+     * Fixed delay (ms).
      */
-    find?: {
-        [k: string]: unknown;
-    };
+    delayMs?: number;
+    find?: ElementCriteria1;
 }
 export interface WaitUntilRequiresASurface {
     [k: string]: unknown;
@@ -2786,6 +2909,9 @@ export interface AProcessSurfaceTakesProcessReadiness {
 export interface ABrowserSurfaceTakesBrowserReadiness {
     [k: string]: unknown;
 }
+export interface AnAppSurfaceTakesAppReadiness {
+    [k: string]: unknown;
+}
 export interface ABrowserEngineStringSurfaceTakesBrowserReadiness {
     [k: string]: unknown;
 }
@@ -2926,11 +3052,11 @@ export interface Screenshot {
     screenshot: Screenshot1;
     [k: string]: unknown;
 }
-export interface CaptureScreenshotDetailed {
+export interface CaptureScreenshotFields {
     /**
-     * The browser window/tab to capture. Omit to capture the active tab. The targeted tab stays focused afterward.
+     * 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?: SurfaceByBrowserEngine2 | BrowserSurface3;
+    surface?: SurfaceByBrowserEngine2 | BrowserSurface3 | AppSurface1;
     path?: ScreenshotSimple1;
     /**
      * Directory of the PNG file. If the directory doesn't exist, creates the directory.
@@ -2960,7 +3086,7 @@ export interface BrowserSurface3 {
     window?: WindowTabSelector6;
     tab?: WindowTabSelector7;
 }
-export interface ByCriteria6 {
+export interface ByCriteria7 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -2978,7 +3104,7 @@ export interface ByCriteria6 {
      */
     url?: string;
 }
-export interface ByCriteria7 {
+export interface ByCriteria8 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -2996,6 +3122,27 @@ export interface ByCriteria7 {
      */
     url?: string;
 }
+export interface AppSurface1 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector1;
+}
+export interface ByCriteria9 {
+    /**
+     * 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.
  */
@@ -3021,6 +3168,9 @@ export interface SourceIntegration {
      */
     contentPath?: string;
 }
+export interface AppCapturesDonTSupportCropYet {
+    [k: string]: unknown;
+}
 export interface Common10 {
     /**
      * JSON Schema for this object.
@@ -3331,7 +3481,7 @@ export interface BrowserSurface4 {
     window?: WindowTabSelector8;
     tab?: WindowTabSelector9;
 }
-export interface ByCriteria8 {
+export interface ByCriteria10 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -3349,7 +3499,7 @@ export interface ByCriteria8 {
      */
     url?: string;
 }
-export interface ByCriteria9 {
+export interface ByCriteria11 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -3679,7 +3829,7 @@ export interface BrowserSurface5 {
     window?: WindowTabSelector10;
     tab?: WindowTabSelector11;
 }
-export interface ByCriteria10 {
+export interface ByCriteria12 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -3697,7 +3847,7 @@ export interface ByCriteria10 {
      */
     url?: string;
 }
-export interface ByCriteria11 {
+export interface ByCriteria13 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -3715,6 +3865,27 @@ export interface ByCriteria11 {
      */
     url?: string;
 }
+export interface AppSurface2 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector2;
+}
+export interface ByCriteria14 {
+    /**
+     * 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 ProcessSurface2 {
     /**
      * Name of a background process started by a runShell/runCode `background` step.
@@ -3733,7 +3904,7 @@ export interface BrowserSurface6 {
     window?: WindowTabSelector12;
     tab?: WindowTabSelector13;
 }
-export interface ByCriteria12 {
+export interface ByCriteria15 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -3751,7 +3922,7 @@ export interface ByCriteria12 {
      */
     url?: string;
 }
-export interface ByCriteria13 {
+export interface ByCriteria16 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -3769,6 +3940,27 @@ export interface ByCriteria13 {
      */
     url?: string;
 }
+export interface AppSurface3 {
+    /**
+     * Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier).
+     */
+    app: string;
+    window?: AppWindowSelector3;
+}
+export interface ByCriteria17 {
+    /**
+     * 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 Common14 {
     /**
      * JSON Schema for this object.
@@ -3902,10 +4094,106 @@ export interface SourceLocation14 {
      */
     endIndex: number;
 }
-export interface LoadVariables {
-    loadVariables: LoadVariables1;
+export interface StartSurface {
+    startSurface: StartSurface1;
     [k: string]: unknown;
 }
+/**
+ * Open (provision) a surface and register it by name so later steps can target it with `surface`. Phase A1 ships the native app branch: launch a desktop application by executable path, bundle ID, or UWP AppUserModelID. The mobile fields (`install`, `activity`, `device`) are validated now and land in later phases; browser/process branches and the parallel array form arrive with multi-surface Phase 6. See docs/design/native-app-surfaces.md.
+ */
+export interface StartSurface1 {
+    /**
+     * The app identifier: an executable path (`C:\\Windows\\System32\\notepad.exe`), a `.app` path, a bundle ID (`com.apple.TextEdit`), a package name (`com.example.myapp`), or a UWP AppUserModelID (`Microsoft.WindowsCalculator_8wekyb3d8bbwe!App`). Disambiguated by syntax — never by a type field.
+     */
+    app: string;
+    /**
+     * Surface-registry name later steps use in `surface`. Default: the executable basename without extension, or the final dot-segment of an ID.
+     */
+    name?: string;
+    /**
+     * Launch arguments (desktop apps). Entries join into a single shell-style argument string for the driver, so an argument with embedded spaces must carry its own quotes (e.g. "\"My File.txt\"").
+     */
+    args?: string[];
+    /**
+     * Working directory for the launched app (desktop apps). Default: the run's working directory.
+     */
+    workingDirectory?: string;
+    /**
+     * Extra environment variables for the launched app (desktop apps). Driver support varies; unmapped variables fail with a clear runtime error.
+     */
+    env?: {
+        [k: string]: string;
+    };
+    /**
+     * Path to an installable artifact (`.apk`/`.app`/`.ipa`) to install on the device before launch. Reserved for the mobile phases; validated now, not yet implemented.
+     */
+    install?: string;
+    /**
+     * Android main activity override (defaults to the package's launcher activity). Reserved for the Android phase; validated now, not yet implemented.
+     */
+    activity?: string;
+    /**
+     * Device the app runs on. Omit for a host desktop app. A string references an already-provisioned device by name; an object provisions one. Reserved for the mobile phases; validated now, not yet implemented.
+     */
+    device?: DeviceByName | DeviceDescriptor;
+    /**
+     * Escape-hatch passthrough: merged into the automation session's capabilities after the ones Doc Detective computes (namespaced per driver, e.g. `appium:noReset`). Driver- and version-specific; use sparingly.
+     */
+    driverOptions?: {
+        [k: string]: unknown;
+    };
+    waitUntil?: AppReadiness1;
+    /**
+     * Startup ceiling in milliseconds (launch + install + readiness).
+     */
+    timeout?: number;
+}
+export interface DeviceDescriptor {
+    /**
+     * Target platform. Selects the mobile driver.
+     */
+    platform: "android" | "ios";
+    /**
+     * AVD name (Android) or simulator device name (iOS). Also the device's registry identity: the same name resolves to the same device.
+     */
+    name?: string;
+    /**
+     * Platform version. Default: the newest available.
+     */
+    osVersion?: string;
+    /**
+     * Run the Android emulator without a window. Ignored where not applicable.
+     */
+    headless?: boolean;
+    /**
+     * Initial orientation. Reserved; validated now, not yet implemented.
+     */
+    orientation?: "portrait" | "landscape";
+    /**
+     * Device kind. `emulator`/`simulator` (the default, inferred from `platform`) or `device` for real hardware. Reserved; validated now, not yet implemented.
+     */
+    type?: "emulator" | "simulator" | "device";
+    /**
+     * 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 AppReadiness1 {
+    /**
+     * Fixed delay (ms).
+     */
+    delayMs?: number;
+    find?: ElementCriteria2;
+}
 export interface Common15 {
     /**
      * JSON Schema for this object.
@@ -4039,6 +4327,143 @@ export interface SourceLocation15 {
      */
     endIndex: number;
 }
+export interface LoadVariables {
+    loadVariables: LoadVariables1;
+    [k: string]: unknown;
+}
+export interface Common16 {
+    /**
+     * 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?: OutputsStep16;
+    variables?: VariablesStep16;
+    /**
+     * 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?: Condition32;
+    /**
+     * 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?: Condition33 | Assertion16[];
+    /**
+     * 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?: Routing64[];
+    /**
+     * 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?: Routing65[];
+    /**
+     * 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?: Routing66[];
+    /**
+     * 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?: Routing67[];
+    location?: SourceLocation16;
+    /**
+     * 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 OutputsStep16 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `OutputsStep16`'s JSON-Schema definition
+     * via the `patternProperty` "^[A-Za-z0-9_]+$".
+     */
+    [k: string]: string;
+}
+/**
+ * Environment variables to set from user-defined expressions.
+ */
+export interface VariablesStep16 {
+    /**
+     * Runtime expression for a user-defined output value.
+     *
+     * This interface was referenced by `VariablesStep16`'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 Assertion16 {
+    /**
+     * 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 | {
+        [k: string]: unknown;
+    } | string;
+    /**
+     * The value actually observed. Optional.
+     */
+    actual?: unknown[] | boolean | number | null | {
+        [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 SourceLocation16 {
+    /**
+     * 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 DragAndDrop {
     dragAndDrop: DragAndDrop1;
     [k: string]: unknown;
@@ -4077,7 +4502,7 @@ export interface BrowserSurface7 {
     window?: WindowTabSelector14;
     tab?: WindowTabSelector15;
 }
-export interface ByCriteria14 {
+export interface ByCriteria18 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -4095,7 +4520,7 @@ export interface ByCriteria14 {
      */
     url?: string;
 }
-export interface ByCriteria15 {
+export interface ByCriteria19 {
     /**
      * Name assigned when the window/tab was opened.
      */
@@ -4113,7 +4538,7 @@ export interface ByCriteria15 {
      */
     url?: string;
 }
-export interface Common16 {
+export interface Common17 {
     /**
      * JSON Schema for this object.
      */
@@ -4130,34 +4555,34 @@ export interface Common16 {
      * 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?: OutputsStep16;
-    variables?: VariablesStep16;
+    outputs?: OutputsStep17;
+    variables?: VariablesStep17;
     /**
      * 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?: Condition32;
+    if?: Condition34;
     /**
      * 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?: Condition33 | Assertion16[];
+    assertions?: Condition35 | Assertion17[];
     /**
      * 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?: Routing64[];
+    onPass?: Routing68[];
     /**
      * 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?: Routing65[];
+    onFail?: Routing69[];
     /**
      * 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?: Routing66[];
+    onWarning?: Routing70[];
     /**
      * 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?: Routing67[];
-    location?: SourceLocation16;
+    onSkip?: Routing71[];
+    location?: SourceLocation17;
     /**
      * 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.
      */
@@ -4175,11 +4600,11 @@ export interface Common16 {
 /**
  * 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 OutputsStep16 {
+export interface OutputsStep17 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `OutputsStep16`'s JSON-Schema definition
+     * This interface was referenced by `OutputsStep17`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -4187,11 +4612,11 @@ export interface OutputsStep16 {
 /**
  * Environment variables to set from user-defined expressions.
  */
-export interface VariablesStep16 {
+export interface VariablesStep17 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `VariablesStep16`'s JSON-Schema definition
+     * This interface was referenced by `VariablesStep17`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -4199,7 +4624,7 @@ export interface VariablesStep16 {
 /**
  * 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 Assertion16 {
+export interface Assertion17 {
     /**
      * Human-readable articulation of the check, e.g. `exitCode in [0]`.
      */
@@ -4232,7 +4657,7 @@ export interface Assertion16 {
 /**
  * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
  */
-export interface SourceLocation16 {
+export interface SourceLocation17 {
     /**
      * 1-indexed line number in the source file where the step was detected.
      */
@@ -4250,7 +4675,7 @@ export interface LoadCookie {
     loadCookie: LoadCookie1;
     [k: string]: unknown;
 }
-export interface Common17 {
+export interface Common18 {
     /**
      * JSON Schema for this object.
      */
@@ -4267,34 +4692,34 @@ export interface Common17 {
      * 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?: OutputsStep17;
-    variables?: VariablesStep17;
+    outputs?: OutputsStep18;
+    variables?: VariablesStep18;
     /**
      * 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?: Condition34;
+    if?: Condition36;
     /**
      * 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?: Condition35 | Assertion17[];
+    assertions?: Condition37 | Assertion18[];
     /**
      * 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?: Routing68[];
+    onPass?: Routing72[];
     /**
      * 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?: Routing69[];
+    onFail?: Routing73[];
     /**
      * 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?: Routing70[];
+    onWarning?: Routing74[];
     /**
      * 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?: Routing71[];
-    location?: SourceLocation17;
+    onSkip?: Routing75[];
+    location?: SourceLocation18;
     /**
      * 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.
      */
@@ -4312,11 +4737,11 @@ export interface Common17 {
 /**
  * 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 OutputsStep17 {
+export interface OutputsStep18 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `OutputsStep17`'s JSON-Schema definition
+     * This interface was referenced by `OutputsStep18`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -4324,11 +4749,11 @@ export interface OutputsStep17 {
 /**
  * Environment variables to set from user-defined expressions.
  */
-export interface VariablesStep17 {
+export interface VariablesStep18 {
     /**
      * Runtime expression for a user-defined output value.
      *
-     * This interface was referenced by `VariablesStep17`'s JSON-Schema definition
+     * This interface was referenced by `VariablesStep18`'s JSON-Schema definition
      * via the `patternProperty` "^[A-Za-z0-9_]+$".
      */
     [k: string]: string;
@@ -4336,7 +4761,7 @@ export interface VariablesStep17 {
 /**
  * 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 Assertion17 {
+export interface Assertion18 {
     /**
      * Human-readable articulation of the check, e.g. `exitCode in [0]`.
      */
@@ -4369,7 +4794,7 @@ export interface Assertion17 {
 /**
  * Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.
  */
-export interface SourceLocation17 {
+export interface SourceLocation18 {
     /**
      * 1-indexed line number in the source file where the step was detected.
      */