doc-detective 4.8.0 → 4.9.0

package/dist/index.cjs

@@ -548,7 +548,7 @@ var init_schemas = __esm({
             default: "."
           },
           reporters: {
-            description: "Reporters to use when emitting test results. Built-in reporters: `terminal`, `json`, `html`. Custom reporters registered via `registerReporter()` can also be referenced by name.",
+            description: "Reporters to use when emitting test results. Built-in reporters: `terminal`, `json`, `html`, `runFolder`. The `runFolder` reporter (enabled by default) archives each run's results as `<output>/.doc-detective/run-<runId>/testResults.json`, beside any screenshots the run captured, in addition to the flat output the `json` reporter writes. Custom reporters registered via `registerReporter()` can also be referenced by name.",
             type: "array",
             items: {
               type: "string",
@@ -556,7 +556,8 @@ var init_schemas = __esm({
             },
             default: [
               "terminal",
-              "json"
+              "json",
+              "runFolder"
             ]
           },
           specFilter: {
@@ -1409,6 +1410,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -1462,6 +1470,13 @@ var init_schemas = __esm({
                                                 description: "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.",
                                                 default: false
                                               },
+                                              autoScreenshot: {
+                                                type: "string",
+                                                minLength: 1,
+                                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                description: "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.",
+                                                readOnly: true
+                                              },
                                               location: {
                                                 type: "object",
                                                 description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -1579,6 +1594,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -1887,6 +1909,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -2239,6 +2268,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -3688,6 +3724,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -4230,6 +4273,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -5324,6 +5374,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -5660,6 +5717,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -5982,6 +6046,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -6326,6 +6397,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -7113,6 +7191,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -7458,6 +7543,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -7659,6 +7751,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -7771,6 +7870,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -7880,6 +7986,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -8476,6 +8589,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -8804,6 +8924,13 @@ var init_schemas = __esm({
                                                       ],
                                                       additionalProperties: false,
                                                       title: "Source Location"
+                                                    },
+                                                    autoScreenshot: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                      description: "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.",
+                                                      readOnly: true
                                                     }
                                                   },
                                                   title: "Common"
@@ -9942,6 +10069,11 @@ var init_schemas = __esm({
             type: "boolean",
             default: false
           },
+          autoScreenshot: {
+            description: "If `true`, captures a screenshot after every step that runs in a browser, in addition to any explicit `screenshot` steps. Images are saved in the per-run artifact directory (`<output>/.doc-detective/run-<runId>/`) at paths derived from spec, test, and context IDs plus the step's order, action, and ID (for example, `screenshots/<specId>/<testId>/<contextId>/01-goTo-s4f2a91c.png`), so the same step lands on the same relative path in every run's folder for run-over-run comparison. Specs and tests can override this value with their own `autoScreenshot` fields (test level wins over spec level, which wins over config level). Equivalent to `--auto-screenshot` on the CLI.",
+            type: "boolean",
+            default: false
+          },
           autoUpdate: {
             description: "If `true` (default), the CLI checks for a newer published `doc-detective` on startup and self-updates before running tests. Updates happen for global (`npm i -g`) and `npx` installs only \u2014 local installs (where `doc-detective` is a project dep) get an informational message instead, since auto-updating would mutate the user's lockfile. CI environments and the `DOC_DETECTIVE_SKIP_AUTO_UPDATE=1` env var also skip the check. Set to `false` to pin to the installed version. Equivalent to `--no-auto-update` on the CLI.",
             type: "boolean",
@@ -10159,6 +10291,13 @@ var init_schemas = __esm({
                                       ],
                                       additionalProperties: false,
                                       title: "Source Location"
+                                    },
+                                    autoScreenshot: {
+                                      type: "string",
+                                      minLength: 1,
+                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                      description: "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.",
+                                      readOnly: true
                                     }
                                   },
                                   title: "Common"
@@ -10212,6 +10351,13 @@ var init_schemas = __esm({
                                   description: "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.",
                                   default: false
                                 },
+                                autoScreenshot: {
+                                  type: "string",
+                                  minLength: 1,
+                                  pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                  description: "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.",
+                                  readOnly: true
+                                },
                                 location: {
                                   type: "object",
                                   description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -10329,6 +10475,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -10637,6 +10790,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -10989,6 +11149,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -12438,6 +12605,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -12980,6 +13154,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -14074,6 +14255,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -14410,6 +14598,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -14732,6 +14927,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -15076,6 +15278,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -15863,6 +16072,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -16208,6 +16424,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -16409,6 +16632,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -16521,6 +16751,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -16630,6 +16867,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -17226,6 +17470,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -17554,6 +17805,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -18278,6 +18536,10 @@ var init_schemas = __esm({
             specFilter: [
               "auth"
             ]
+          },
+          {
+            autoScreenshot: true,
+            output: "./test-results"
           }
         ]
       },
@@ -22501,7 +22763,7 @@ var init_schemas = __esm({
                 default: "."
               },
               reporters: {
-                description: "Reporters to use when emitting test results. Built-in reporters: `terminal`, `json`, `html`. Custom reporters registered via `registerReporter()` can also be referenced by name.",
+                description: "Reporters to use when emitting test results. Built-in reporters: `terminal`, `json`, `html`, `runFolder`. The `runFolder` reporter (enabled by default) archives each run's results as `<output>/.doc-detective/run-<runId>/testResults.json`, beside any screenshots the run captured, in addition to the flat output the `json` reporter writes. Custom reporters registered via `registerReporter()` can also be referenced by name.",
                 type: "array",
                 items: {
                   type: "string",
@@ -22509,7 +22771,8 @@ var init_schemas = __esm({
                 },
                 default: [
                   "terminal",
-                  "json"
+                  "json",
+                  "runFolder"
                 ]
               },
               specFilter: {
@@ -23362,6 +23625,13 @@ var init_schemas = __esm({
                                                         ],
                                                         additionalProperties: false,
                                                         title: "Source Location"
+                                                      },
+                                                      autoScreenshot: {
+                                                        type: "string",
+                                                        minLength: 1,
+                                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                        description: "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.",
+                                                        readOnly: true
                                                       }
                                                     },
                                                     title: "Common"
@@ -23415,6 +23685,13 @@ var init_schemas = __esm({
                                                     description: "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.",
                                                     default: false
                                                   },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
+                                                  },
                                                   location: {
                                                     type: "object",
                                                     description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -23532,6 +23809,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -23840,6 +24124,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -24192,6 +24483,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -25641,6 +25939,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -26183,6 +26488,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -27277,6 +27589,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -27613,6 +27932,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -27935,6 +28261,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -28279,6 +28612,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -29066,6 +29406,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -29411,6 +29758,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -29612,6 +29966,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -29724,6 +30085,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -29833,6 +30201,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -30429,6 +30804,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -30757,6 +31139,13 @@ var init_schemas = __esm({
                                                           ],
                                                           additionalProperties: false,
                                                           title: "Source Location"
+                                                        },
+                                                        autoScreenshot: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                          description: "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.",
+                                                          readOnly: true
                                                         }
                                                       },
                                                       title: "Common"
@@ -31895,6 +32284,11 @@ var init_schemas = __esm({
                 type: "boolean",
                 default: false
               },
+              autoScreenshot: {
+                description: "If `true`, captures a screenshot after every step that runs in a browser, in addition to any explicit `screenshot` steps. Images are saved in the per-run artifact directory (`<output>/.doc-detective/run-<runId>/`) at paths derived from spec, test, and context IDs plus the step's order, action, and ID (for example, `screenshots/<specId>/<testId>/<contextId>/01-goTo-s4f2a91c.png`), so the same step lands on the same relative path in every run's folder for run-over-run comparison. Specs and tests can override this value with their own `autoScreenshot` fields (test level wins over spec level, which wins over config level). Equivalent to `--auto-screenshot` on the CLI.",
+                type: "boolean",
+                default: false
+              },
               autoUpdate: {
                 description: "If `true` (default), the CLI checks for a newer published `doc-detective` on startup and self-updates before running tests. Updates happen for global (`npm i -g`) and `npx` installs only \u2014 local installs (where `doc-detective` is a project dep) get an informational message instead, since auto-updating would mutate the user's lockfile. CI environments and the `DOC_DETECTIVE_SKIP_AUTO_UPDATE=1` env var also skip the check. Set to `false` to pin to the installed version. Equivalent to `--no-auto-update` on the CLI.",
                 type: "boolean",
@@ -32112,6 +32506,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -32165,6 +32566,13 @@ var init_schemas = __esm({
                                       description: "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.",
                                       default: false
                                     },
+                                    autoScreenshot: {
+                                      type: "string",
+                                      minLength: 1,
+                                      pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                      description: "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.",
+                                      readOnly: true
+                                    },
                                     location: {
                                       type: "object",
                                       description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -32282,6 +32690,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -32590,6 +33005,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -32942,6 +33364,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -34391,6 +34820,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -34933,6 +35369,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -36027,6 +36470,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -36363,6 +36813,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -36685,6 +37142,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -37029,6 +37493,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -37816,6 +38287,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -38161,6 +38639,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -38362,6 +38847,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -38474,6 +38966,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -38583,6 +39082,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -39179,6 +39685,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -39507,6 +40020,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -40231,6 +40751,10 @@ var init_schemas = __esm({
                 specFilter: [
                   "auth"
                 ]
+              },
+              {
+                autoScreenshot: true,
+                output: "./test-results"
               }
             ]
           },
@@ -40835,6 +41359,10 @@ var init_schemas = __esm({
                         ]
                       }
                     },
+                    autoScreenshot: {
+                      type: "boolean",
+                      description: "If `true`, captures a screenshot after every step in this spec's tests that runs in a browser. Overrides the config-level `autoScreenshot`; individual tests can override this value with their own `autoScreenshot`. When unset, defers to the config level."
+                    },
                     tests: {
                       description: "[Tests](test) to perform.",
                       type: "array",
@@ -40864,6 +41392,10 @@ var init_schemas = __esm({
                                 description: "Whether or not to detect steps in input files based on markup regex.",
                                 default: true
                               },
+                              autoScreenshot: {
+                                type: "boolean",
+                                description: "If `true`, captures a screenshot after every step in this test that runs in a browser. Overrides `autoScreenshot` set at the spec or config level. When unset, defers to the spec level, then the config level."
+                              },
                               runOn: {
                                 type: "array",
                                 description: "Contexts to run the test in. Overrides contexts defined at the config and spec levels.",
@@ -41530,6 +42062,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -41583,6 +42122,13 @@ var init_schemas = __esm({
                                         description: "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.",
                                         default: false
                                       },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
+                                      },
                                       location: {
                                         type: "object",
                                         description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -41700,6 +42246,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -42008,6 +42561,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -42360,6 +42920,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -43809,6 +44376,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -44351,6 +44925,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -45445,6 +46026,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -45781,6 +46369,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -46103,6 +46698,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -46447,6 +47049,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -47234,6 +47843,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -47579,6 +48195,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -47780,6 +48403,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -47892,6 +48522,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -48001,6 +48638,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -48597,6 +49241,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -48925,6 +49576,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -49719,6 +50377,13 @@ var init_schemas = __esm({
                                                   ],
                                                   additionalProperties: false,
                                                   title: "Source Location"
+                                                },
+                                                autoScreenshot: {
+                                                  type: "string",
+                                                  minLength: 1,
+                                                  pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                  description: "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.",
+                                                  readOnly: true
                                                 }
                                               },
                                               title: "Common"
@@ -49772,6 +50437,13 @@ var init_schemas = __esm({
                                               description: "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.",
                                               default: false
                                             },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
+                                            },
                                             location: {
                                               type: "object",
                                               description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -49889,6 +50561,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -50197,6 +50876,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -50549,6 +51235,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -51998,6 +52691,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -52540,6 +53240,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -53634,6 +54341,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -53970,6 +54684,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -54292,6 +55013,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -54636,6 +55364,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -55423,6 +56158,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -55768,6 +56510,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -55969,6 +56718,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -56081,6 +56837,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -56190,6 +56953,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -56786,6 +57556,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -57114,6 +57891,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -58322,6 +59106,16 @@ var init_schemas = __esm({
             type: "string",
             description: "Unique identifier for the test specification."
           },
+          runId: {
+            type: "string",
+            description: "Identifier for the run that produced this report, derived from the run's start timestamp. Matches the run's artifact folder name (`run-<runId>`). System-populated.",
+            readOnly: true
+          },
+          runDir: {
+            type: "string",
+            description: "Absolute path to the run's artifact folder (`<output>/.doc-detective/run-<runId>/`), where the `runFolder` reporter archives results and `autoScreenshot` images are saved. Step-level `autoScreenshot` paths in the report are relative to this folder. System-populated.",
+            readOnly: true
+          },
           specs: {
             description: "Test specifications that were performed.",
             type: "array",
@@ -58923,6 +59717,10 @@ var init_schemas = __esm({
                         ]
                       }
                     },
+                    autoScreenshot: {
+                      type: "boolean",
+                      description: "If `true`, captures a screenshot after every step in this spec's tests that runs in a browser. Overrides the config-level `autoScreenshot`; individual tests can override this value with their own `autoScreenshot`. When unset, defers to the config level."
+                    },
                     tests: {
                       description: "[Tests](test) to perform.",
                       type: "array",
@@ -58952,6 +59750,10 @@ var init_schemas = __esm({
                                 description: "Whether or not to detect steps in input files based on markup regex.",
                                 default: true
                               },
+                              autoScreenshot: {
+                                type: "boolean",
+                                description: "If `true`, captures a screenshot after every step in this test that runs in a browser. Overrides `autoScreenshot` set at the spec or config level. When unset, defers to the spec level, then the config level."
+                              },
                               runOn: {
                                 type: "array",
                                 description: "Contexts to run the test in. Overrides contexts defined at the config and spec levels.",
@@ -59618,6 +60420,13 @@ var init_schemas = __esm({
                                             ],
                                             additionalProperties: false,
                                             title: "Source Location"
+                                          },
+                                          autoScreenshot: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                            description: "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.",
+                                            readOnly: true
                                           }
                                         },
                                         title: "Common"
@@ -59671,6 +60480,13 @@ var init_schemas = __esm({
                                         description: "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.",
                                         default: false
                                       },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
+                                      },
                                       location: {
                                         type: "object",
                                         description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -59788,6 +60604,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -60096,6 +60919,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -60448,6 +61278,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -61897,6 +62734,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -62439,6 +63283,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -63533,6 +64384,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -63869,6 +64727,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -64191,6 +65056,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -64535,6 +65407,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -65322,6 +66201,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -65667,6 +66553,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -65868,6 +66761,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -65980,6 +66880,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -66089,6 +66996,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -66685,6 +67599,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -67013,6 +67934,13 @@ var init_schemas = __esm({
                                               ],
                                               additionalProperties: false,
                                               title: "Source Location"
+                                            },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
                                             }
                                           },
                                           title: "Common"
@@ -67807,6 +68735,13 @@ var init_schemas = __esm({
                                                   ],
                                                   additionalProperties: false,
                                                   title: "Source Location"
+                                                },
+                                                autoScreenshot: {
+                                                  type: "string",
+                                                  minLength: 1,
+                                                  pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                  description: "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.",
+                                                  readOnly: true
                                                 }
                                               },
                                               title: "Common"
@@ -67860,6 +68795,13 @@ var init_schemas = __esm({
                                               description: "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.",
                                               default: false
                                             },
+                                            autoScreenshot: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                              description: "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.",
+                                              readOnly: true
+                                            },
                                             location: {
                                               type: "object",
                                               description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -67977,6 +68919,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -68285,6 +69234,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -68637,6 +69593,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -70086,6 +71049,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -70628,6 +71598,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -71722,6 +72699,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -72058,6 +73042,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -72380,6 +73371,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -72724,6 +73722,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -73511,6 +74516,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -73856,6 +74868,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -74057,6 +75076,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -74169,6 +75195,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -74278,6 +75311,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -74874,6 +75914,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -75202,6 +76249,13 @@ var init_schemas = __esm({
                                                     ],
                                                     additionalProperties: false,
                                                     title: "Source Location"
+                                                  },
+                                                  autoScreenshot: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                                    description: "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.",
+                                                    readOnly: true
                                                   }
                                                 },
                                                 title: "Common"
@@ -78399,6 +79453,10 @@ var init_schemas = __esm({
               ]
             }
           },
+          autoScreenshot: {
+            type: "boolean",
+            description: "If `true`, captures a screenshot after every step in this spec's tests that runs in a browser. Overrides the config-level `autoScreenshot`; individual tests can override this value with their own `autoScreenshot`. When unset, defers to the config level."
+          },
           tests: {
             description: "[Tests](test) to perform.",
             type: "array",
@@ -78428,6 +79486,10 @@ var init_schemas = __esm({
                       description: "Whether or not to detect steps in input files based on markup regex.",
                       default: true
                     },
+                    autoScreenshot: {
+                      type: "boolean",
+                      description: "If `true`, captures a screenshot after every step in this test that runs in a browser. Overrides `autoScreenshot` set at the spec or config level. When unset, defers to the spec level, then the config level."
+                    },
                     runOn: {
                       type: "array",
                       description: "Contexts to run the test in. Overrides contexts defined at the config and spec levels.",
@@ -79094,6 +80156,13 @@ var init_schemas = __esm({
                                   ],
                                   additionalProperties: false,
                                   title: "Source Location"
+                                },
+                                autoScreenshot: {
+                                  type: "string",
+                                  minLength: 1,
+                                  pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                  description: "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.",
+                                  readOnly: true
                                 }
                               },
                               title: "Common"
@@ -79147,6 +80216,13 @@ var init_schemas = __esm({
                               description: "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.",
                               default: false
                             },
+                            autoScreenshot: {
+                              type: "string",
+                              minLength: 1,
+                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                              description: "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.",
+                              readOnly: true
+                            },
                             location: {
                               type: "object",
                               description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -79264,6 +80340,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -79572,6 +80655,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -79924,6 +81014,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -81373,6 +82470,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -81915,6 +83019,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -83009,6 +84120,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -83345,6 +84463,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -83667,6 +84792,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -84011,6 +85143,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -84798,6 +85937,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -85143,6 +86289,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -85344,6 +86497,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -85456,6 +86616,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -85565,6 +86732,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -86161,6 +87335,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -86489,6 +87670,13 @@ var init_schemas = __esm({
                                     ],
                                     additionalProperties: false,
                                     title: "Source Location"
+                                  },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
                                   }
                                 },
                                 title: "Common"
@@ -87283,6 +88471,13 @@ var init_schemas = __esm({
                                         ],
                                         additionalProperties: false,
                                         title: "Source Location"
+                                      },
+                                      autoScreenshot: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                        description: "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.",
+                                        readOnly: true
                                       }
                                     },
                                     title: "Common"
@@ -87336,6 +88531,13 @@ var init_schemas = __esm({
                                     description: "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.",
                                     default: false
                                   },
+                                  autoScreenshot: {
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                    description: "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.",
+                                    readOnly: true
+                                  },
                                   location: {
                                     type: "object",
                                     description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -87453,6 +88655,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -87761,6 +88970,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -88113,6 +89329,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -89562,6 +90785,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -90104,6 +91334,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -91198,6 +92435,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -91534,6 +92778,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -91856,6 +93107,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -92200,6 +93458,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -92987,6 +94252,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -93332,6 +94604,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -93533,6 +94812,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -93645,6 +94931,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -93754,6 +95047,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -94350,6 +95650,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -94678,6 +95985,13 @@ var init_schemas = __esm({
                                           ],
                                           additionalProperties: false,
                                           title: "Source Location"
+                                        },
+                                        autoScreenshot: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                          description: "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.",
+                                          readOnly: true
                                         }
                                       },
                                       title: "Common"
@@ -95752,6 +97066,13 @@ var init_schemas = __esm({
                   ],
                   additionalProperties: false,
                   title: "Source Location"
+                },
+                autoScreenshot: {
+                  type: "string",
+                  minLength: 1,
+                  pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                  description: "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.",
+                  readOnly: true
                 }
               },
               title: "Common"
@@ -95805,6 +97126,13 @@ var init_schemas = __esm({
               description: "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.",
               default: false
             },
+            autoScreenshot: {
+              type: "string",
+              minLength: 1,
+              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+              description: "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.",
+              readOnly: true
+            },
             location: {
               type: "object",
               description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -95922,6 +97250,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -96230,6 +97565,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -96582,6 +97924,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -98031,6 +99380,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -98573,6 +99929,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -99667,6 +101030,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -100003,6 +101373,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -100325,6 +101702,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -100669,6 +102053,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -101456,6 +102847,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -101801,6 +103199,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -102002,6 +103407,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -102114,6 +103526,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -102223,6 +103642,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -102819,6 +104245,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -103147,6 +104580,13 @@ var init_schemas = __esm({
                     ],
                     additionalProperties: false,
                     title: "Source Location"
+                  },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
                   }
                 },
                 title: "Common"
@@ -103628,6 +105068,10 @@ var init_schemas = __esm({
             description: "Whether or not to detect steps in input files based on markup regex.",
             default: true
           },
+          autoScreenshot: {
+            type: "boolean",
+            description: "If `true`, captures a screenshot after every step in this test that runs in a browser. Overrides `autoScreenshot` set at the spec or config level. When unset, defers to the spec level, then the config level."
+          },
           runOn: {
             type: "array",
             description: "Contexts to run the test in. Overrides contexts defined at the config and spec levels.",
@@ -104294,6 +105738,13 @@ var init_schemas = __esm({
                         ],
                         additionalProperties: false,
                         title: "Source Location"
+                      },
+                      autoScreenshot: {
+                        type: "string",
+                        minLength: 1,
+                        pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                        description: "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.",
+                        readOnly: true
                       }
                     },
                     title: "Common"
@@ -104347,6 +105798,13 @@ var init_schemas = __esm({
                     description: "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.",
                     default: false
                   },
+                  autoScreenshot: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                    description: "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.",
+                    readOnly: true
+                  },
                   location: {
                     type: "object",
                     description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -104464,6 +105922,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -104772,6 +106237,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -105124,6 +106596,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -106573,6 +108052,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -107115,6 +108601,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -108209,6 +109702,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -108545,6 +110045,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -108867,6 +110374,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -109211,6 +110725,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -109998,6 +111519,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -110343,6 +111871,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -110544,6 +112079,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -110656,6 +112198,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -110765,6 +112314,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -111361,6 +112917,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -111689,6 +113252,13 @@ var init_schemas = __esm({
                           ],
                           additionalProperties: false,
                           title: "Source Location"
+                        },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
                         }
                       },
                       title: "Common"
@@ -112483,6 +114053,13 @@ var init_schemas = __esm({
                               ],
                               additionalProperties: false,
                               title: "Source Location"
+                            },
+                            autoScreenshot: {
+                              type: "string",
+                              minLength: 1,
+                              pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                              description: "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.",
+                              readOnly: true
                             }
                           },
                           title: "Common"
@@ -112536,6 +114113,13 @@ var init_schemas = __esm({
                           description: "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.",
                           default: false
                         },
+                        autoScreenshot: {
+                          type: "string",
+                          minLength: 1,
+                          pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                          description: "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.",
+                          readOnly: true
+                        },
                         location: {
                           type: "object",
                           description: "Source location where this step was detected in the original file. This is system-populated metadata and should not be set manually.",
@@ -112653,6 +114237,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -112961,6 +114552,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -113313,6 +114911,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -114762,6 +116367,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -115304,6 +116916,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -116398,6 +118017,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -116734,6 +118360,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -117056,6 +118689,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -117400,6 +119040,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -118187,6 +119834,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -118532,6 +120186,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -118733,6 +120394,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -118845,6 +120513,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -118954,6 +120629,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -119550,6 +121232,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -119878,6 +121567,13 @@ var init_schemas = __esm({
                                 ],
                                 additionalProperties: false,
                                 title: "Source Location"
+                              },
+                              autoScreenshot: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "^(?![A-Za-z]:|[\\\\/])[^\\\\]+$",
+                                description: "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.",
+                                readOnly: true
                               }
                             },
                             title: "Common"
@@ -130437,8 +132133,7 @@ function replaceEnvs(stringOrObject) {
   return stringOrObject;
 }
 function timestamp() {
-  let timestamp2 = /* @__PURE__ */ new Date();
-  return `${timestamp2.getFullYear()}${("0" + (timestamp2.getMonth() + 1)).slice(-2)}${("0" + timestamp2.getDate()).slice(-2)}-${("0" + timestamp2.getHours()).slice(-2)}${("0" + timestamp2.getMinutes()).slice(-2)}${("0" + timestamp2.getSeconds()).slice(-2)}`;
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
 }
 function getOrInitRunTimestamp(config) {
   if (!config)
@@ -130448,6 +132143,33 @@ function getOrInitRunTimestamp(config) {
   }
   return config.__runTimestamp;
 }
+function getRunOutputDir(config) {
+  if (config?.__runOutputDir)
+    return config.__runOutputDir;
+  let base = String(config?.output || ".");
+  const reportFileExtensions = [".json", ".html", ".htm"];
+  if (reportFileExtensions.some((ext) => base.toLowerCase().endsWith(ext))) {
+    base = import_node_path.default.dirname(base);
+  }
+  const runsRoot = import_node_path.default.resolve(base, ".doc-detective");
+  import_node_fs.default.mkdirSync(runsRoot, { recursive: true });
+  const runId = getOrInitRunTimestamp(config);
+  let dir = import_node_path.default.join(runsRoot, `run-${runId}`);
+  let suffix = 2;
+  for (; ; ) {
+    try {
+      import_node_fs.default.mkdirSync(dir);
+      break;
+    } catch (error) {
+      if (error?.code !== "EEXIST")
+        throw error;
+      dir = import_node_path.default.join(runsRoot, `run-${runId}-${suffix++}`);
+    }
+  }
+  if (config)
+    config.__runOutputDir = dir;
+  return dir;
+}
 async function spawnCommand(cmd, args = [], options = {}) {
   const spawnOptions = {
     shell: true
@@ -132909,15 +134631,34 @@ function safeRegExp(pattern, flags) {
     return null;
   }
 }
-function generateUUID() {
-  if (typeof crypto !== "undefined" && crypto.randomUUID) {
-    return crypto.randomUUID();
+var HASH_EXCLUDED_KEYS = /* @__PURE__ */ new Set([
+  "location",
+  "testId",
+  "stepId",
+  "contextId"
+]);
+function contentHash(value) {
+  let input;
+  if (typeof value === "string") {
+    input = value;
+  } else {
+    try {
+      input = JSON.stringify(value, (key, v) => HASH_EXCLUDED_KEYS.has(key) ? void 0 : v) ?? "";
+    } catch {
+      input = "";
+    }
   }
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function(c) {
-    const r = Math.random() * 16 | 0;
-    const v = c === "x" ? r : r & 3 | 8;
-    return v.toString(16);
-  });
+  let hash = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function normalizePathForId(filePath) {
+  if (!filePath)
+    return "";
+  return filePath.replace(/\\/g, "/").replace(/^\.\//, "").replace(/[^a-zA-Z0-9._/-]/g, "_");
 }
 function getLineStarts(content) {
   const starts = [0];
@@ -132951,7 +134692,8 @@ async function detectTests(input) {
     config: input.config,
     content: input.content,
     filePath: input.filePath,
-    fileType: input.fileType
+    fileType: input.fileType,
+    testIdBase: input.testIdBase
   });
 }
 function parseXmlAttributes({ stringifiedObject }) {
@@ -133110,7 +134852,7 @@ function replaceNumericVariables(stringOrObjectSource, values) {
   }
   return stringOrObject;
 }
-async function parseContent({ config = {}, content, filePath = "", fileType }) {
+async function parseContent({ config = {}, content, filePath = "", fileType, testIdBase }) {
   const statements = [];
   const statementTypes = ["testStart", "testEnd", "ignoreStart", "ignoreEnd", "step"];
   function findTest({ tests: tests2, testId: testId2 }) {
@@ -133178,7 +134920,15 @@ async function parseContent({ config = {}, content, filePath = "", fileType }) {
   }
   statements.sort((a, b) => a.sortIndex - b.sortIndex);
   let tests = [];
-  let testId = generateUUID();
+  const pendingTestIds = /* @__PURE__ */ new Set();
+  let pendingCounter = 0;
+  const pendingSalt = contentHash(content);
+  const nextPendingTestId = () => {
+    const id = `__dd-pending-${pendingSalt}-${++pendingCounter}`;
+    pendingTestIds.add(id);
+    return id;
+  };
+  let testId = nextPendingTestId();
   let ignore = false;
   statements.forEach((statement) => {
     let test;
@@ -133223,7 +134973,7 @@ async function parseContent({ config = {}, content, filePath = "", fileType }) {
         break;
       }
       case "testEnd":
-        testId = generateUUID();
+        testId = nextPendingTestId();
         ignore = false;
         break;
       case "ignoreStart":
@@ -133362,6 +135112,20 @@ async function parseContent({ config = {}, content, filePath = "", fileType }) {
         break;
     }
   });
+  const usedTestIds = new Set(tests.filter((test) => test.testId && !pendingTestIds.has(test.testId)).map((test) => test.testId));
+  const idBase = testIdBase || normalizePathForId(filePath) || "detected";
+  tests.forEach((test) => {
+    if (!test.testId || !pendingTestIds.has(test.testId))
+      return;
+    const baseId = `${idBase}~${contentHash(test)}`;
+    let id = baseId;
+    let suffix = 2;
+    while (usedTestIds.has(id)) {
+      id = `${baseId}-${suffix++}`;
+    }
+    usedTestIds.add(id);
+    test.testId = id;
+  });
   if (filePath) {
     tests.forEach((test) => {
       test.contentPath = filePath;
@@ -134567,12 +136331,9 @@ async function detectTests2({ config }) {
 function generateSpecId(filePath) {
   const absolutePath = import_node_path9.default.resolve(filePath);
   const cwd = process.cwd();
-  let relativePath;
-  if (absolutePath.startsWith(cwd)) {
-    relativePath = import_node_path9.default.relative(cwd, absolutePath);
-  } else {
-    relativePath = absolutePath;
-  }
+  const candidate = import_node_path9.default.relative(cwd, absolutePath);
+  const isInsideCwd = candidate.length > 0 && !candidate.startsWith("..") && !import_node_path9.default.isAbsolute(candidate);
+  const relativePath = isInsideCwd ? candidate : absolutePath;
   const normalizedPath = relativePath.split(import_node_path9.default.sep).join("/").replace(/^\.\//, "").replace(/[^a-zA-Z0-9._\-\/]/g, "_");
   return normalizedPath;
 }
@@ -134804,6 +136565,28 @@ async function parseTests({ config, files }) {
       content = await readFile({ fileURLOrPath: file });
     }
     if (typeof content === "object") {
+      if (!content.specId)
+        content.specId = generateSpecId(file);
+      if (!content.contentPath)
+        content.contentPath = file;
+      if (Array.isArray(content.tests)) {
+        const usedTestIds = new Set(content.tests.map((test) => test?.testId).filter((id) => id));
+        for (const test of content.tests) {
+          if (!test || typeof test !== "object" || test.testId)
+            continue;
+          if (typeof test.id !== "undefined" || test.file || test.setup || test.cleanup || Array.isArray(test.steps) && test.steps.some((step) => step && typeof step === "object" && "action" in step)) {
+            continue;
+          }
+          const baseId = `${content.specId}~${contentHash(test)}`;
+          let id = baseId;
+          let suffix = 2;
+          while (usedTestIds.has(id)) {
+            id = `${baseId}-${suffix++}`;
+          }
+          usedTestIds.add(id);
+          test.testId = id;
+        }
+      }
       const stepLocations = /* @__PURE__ */ new Map();
       if (rawContent && content.tests) {
         try {
@@ -134954,7 +136737,8 @@ async function parseTests({ config, files }) {
         config,
         content,
         fileType,
-        filePath: file
+        filePath: file,
+        testIdBase: id
       });
       spec.tests.push(...tests);
       spec.tests = spec.tests.filter((test) => test.steps && test.steps.length > 0);
@@ -135026,13 +136810,16 @@ function resolveContexts({ contexts, test, config }) {
   });
   contexts.forEach((context) => {
     const staticContexts = [];
+    const carry = { ...context };
+    delete carry.platforms;
+    delete carry.browsers;
     context.platforms.forEach((platform) => {
       if (!browserRequired) {
-        const staticContext = { platform };
+        const staticContext = { ...carry, platform };
         staticContexts.push(staticContext);
       } else {
         context.browsers.forEach((browser) => {
-          const staticContext = { platform, browser };
+          const staticContext = { ...carry, platform, browser };
           staticContexts.push(staticContext);
         });
       }
@@ -135079,8 +136866,22 @@ ${JSON.stringify(documentArray, null, 2)}`);
 ${JSON.stringify(openApiDocuments, null, 2)}`);
   return openApiDocuments;
 }
-async function resolveContext({ config, test, context }) {
-  const contextId = context.contextId || import_node_crypto4.default.randomUUID();
+function uniqueId(base, usedIds) {
+  let id = base;
+  let suffix = 2;
+  while (usedIds.has(id)) {
+    id = `${base}-${suffix++}`;
+  }
+  return id;
+}
+function deriveContextId({ context, usedIds }) {
+  const base = [context.platform, context.browser?.name].filter(Boolean).join("-") || "default";
+  return uniqueId(base, usedIds);
+}
+async function resolveContext({ config, test, context, usedContextIds }) {
+  context.contextId = context.contextId ? uniqueId(context.contextId, usedContextIds) : deriveContextId({ context, usedIds: usedContextIds });
+  const contextId = context.contextId;
+  usedContextIds.add(contextId);
   log(config, "debug", `RESOLVING CONTEXT ID ${contextId}:
 ${JSON.stringify(context, null, 2)}`);
   const resolvedContext = {
@@ -135095,7 +136896,7 @@ ${JSON.stringify(resolvedContext, null, 2)}`);
   return resolvedContext;
 }
 async function resolveTest({ config, spec, test }) {
-  const testId = test.testId || import_node_crypto4.default.randomUUID();
+  const testId = test.testId || `${spec.specId}~${contentHash(test)}`;
   log(config, "debug", `RESOLVING TEST ID ${testId}:
 ${JSON.stringify(test, null, 2)}`);
   const resolvedTest = {
@@ -135114,11 +136915,13 @@ ${JSON.stringify(test, null, 2)}`);
     contexts: resolvedTest.runOn,
     config
   });
+  const usedContextIds = /* @__PURE__ */ new Set();
   for (const context of testContexts) {
     const resolvedContext = await resolveContext({
       config,
       test,
-      context
+      context,
+      usedContextIds
     });
     resolvedTest.contexts.push(resolvedContext);
   }
@@ -135127,7 +136930,7 @@ ${JSON.stringify(resolvedTest, null, 2)}`);
   return resolvedTest;
 }
 async function resolveSpec({ config, spec }) {
-  const specId = spec.specId || import_node_crypto4.default.randomUUID();
+  const specId = spec.specId || (spec.contentPath ? generateSpecId(spec.contentPath) : import_node_crypto4.default.randomUUID());
   log(config, "debug", `RESOLVING SPEC ID ${specId}:
 ${JSON.stringify(spec, null, 2)}`);
   const resolvedSpec = {
@@ -139219,7 +141022,11 @@ async function runSpecs({ resolvedTests }) {
   const metaValues = { specs: {} };
   const installAttempts = /* @__PURE__ */ new Map();
   const warmUpResults = /* @__PURE__ */ new Map();
+  const runDir = getRunOutputDir(config);
+  const runId = import_node_path18.default.basename(runDir).replace(/^run-/, "");
   const report = {
+    runId,
+    runDir,
     summary: {
       specs: {
         pass: 0,
@@ -139272,8 +141079,18 @@ async function runSpecs({ resolvedTests }) {
         contexts: new Array(test.contexts.length)
       };
       specReport.tests.push(testReport);
+      const usedContextIds = new Set(test.contexts.map((c) => c.contextId).filter(Boolean));
       test.contexts.forEach((context, slot) => {
-        context.contextId = context.contextId || (0, import_node_crypto5.randomUUID)();
+        if (!context.contextId) {
+          const base = [context.platform, context.browser?.name].filter(Boolean).join("-") || "default";
+          let id = base;
+          let suffix = 2;
+          while (usedContextIds.has(id)) {
+            id = `${base}-${suffix++}`;
+          }
+          usedContextIds.add(id);
+          context.contextId = id;
+        }
         jobs.push({ spec, test, context, contexts: testReport.contexts, slot });
       });
     }
@@ -139490,6 +141307,45 @@ async function warmUpContexts({ jobs, config, runnerDetails, appiumPool, install
     }
   }
 }
+function resolveAutoScreenshot({ config, spec, test }) {
+  return Boolean(test?.autoScreenshot ?? spec?.autoScreenshot ?? config?.autoScreenshot);
+}
+function capPathSegment(segment, max = 64) {
+  return segment.length <= max ? segment : segment.slice(segment.length - max);
+}
+async function captureAutoScreenshot({ config, driver, spec, test, context, step, stepIndex, stepCount }) {
+  try {
+    const action = driverActions2.find((key) => typeof step[key] !== "undefined") || "step";
+    const sanitizedTestId = sanitizeFilesystemName(String(test.testId ?? ""), "test");
+    const runDir = getRunOutputDir(config);
+    const dir = import_node_path18.default.join(runDir, "screenshots", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), capPathSegment(sanitizedTestId), capPathSegment(sanitizeFilesystemName(String(context.contextId ?? ""), "context")));
+    const stepIdString = sanitizeFilesystemName(String(step.stepId ?? ""), "step");
+    const stepRef = capPathSegment(stepIdString.startsWith(`${sanitizedTestId}~`) ? stepIdString.slice(sanitizedTestId.length + 1) : stepIdString);
+    const pad = Math.max(2, String(stepCount).length);
+    const fileName = `${String(stepIndex + 1).padStart(pad, "0")}-${action}-${stepRef}.png`;
+    const screenshotStep = {
+      stepId: `${step.stepId}_auto`,
+      description: "Automatic post-step screenshot",
+      screenshot: {
+        path: import_node_path18.default.join(dir, fileName),
+        overwrite: "true"
+      }
+    };
+    const captureResult = await saveScreenshot({
+      config,
+      step: screenshotStep,
+      driver
+    });
+    if (captureResult.status !== "PASS") {
+      log(config, "warning", `Auto screenshot failed after step ${step.stepId}: ${captureResult.description}`);
+      return null;
+    }
+    return import_node_path18.default.relative(runDir, screenshotStep.screenshot.path).split(import_node_path18.default.sep).join("/");
+  } catch (error) {
+    log(config, "warning", `Auto screenshot failed after step ${step.stepId}: ${error?.message ?? error}`);
+    return null;
+  }
+}
 async function runContext({ config, spec, test, context, runnerDetails, appiumPool, metaValues, installAttempts, warmUpResults, logPrefix = "" }) {
   const platform = runnerDetails.environment.platform;
   let availableApps = runnerDetails.availableApps;
@@ -139628,10 +141484,20 @@ ${JSON.stringify(context, null, 2)}`);
         await driver.setWindowSize(context.browser?.window?.width || windowSize.width, context.browser?.window?.height || windowSize.height);
       }
     }
+    const autoScreenshotEnabled = resolveAutoScreenshot({ config, spec, test });
     let stepExecutionFailed = false;
-    for (let step of context.steps) {
-      if (!step.stepId)
-        step.stepId = (0, import_node_crypto5.randomUUID)();
+    const usedStepIds = new Set(context.steps.map((s) => s.stepId).filter(Boolean));
+    for (const [stepIndex, step] of context.steps.entries()) {
+      if (!step.stepId) {
+        const baseId = sanitizeFilesystemName(`${test.testId}~s${contentHash(step)}`, `step-${(0, import_node_crypto5.randomUUID)()}`);
+        let stepId = baseId;
+        let suffix = 2;
+        while (usedStepIds.has(stepId)) {
+          stepId = `${baseId}-${suffix++}`;
+        }
+        step.stepId = stepId;
+      }
+      usedStepIds.add(step.stepId);
       clog("debug", `STEP:
 ${JSON.stringify(step, null, 2)}`);
       if (step.unsafe && runnerDetails.allowUnsafeSteps === false) {
@@ -139674,6 +141540,20 @@ ${JSON.stringify(stepResult, null, 2)}`);
         ...step,
         ...stepResult
       };
+      if (autoScreenshotEnabled && driver && typeof step.screenshot === "undefined" && isDriverRequired({ test: { steps: [step] } })) {
+        const capturedPath = await captureAutoScreenshot({
+          config,
+          driver,
+          spec,
+          test,
+          context,
+          step,
+          stepIndex,
+          stepCount: context.steps.length
+        });
+        if (capturedPath)
+          stepReport.autoScreenshot = capturedPath;
+      }
       contextReport.steps.push(stepReport);
       if (stepReport.result === "FAIL") {
         stepExecutionFailed = true;