doc-detective-common 4.12.1 → 4.13.0

package/dist/index.cjs

@@ -7604,6 +7604,14 @@ var schemas_default = {
                                                             "false"
                                                           ]
                                                         },
+                                                        name: {
+                                                          type: "string",
+                                                          description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ]
+                                                        },
                                                         engine: {
                                                           title: "Recording engine",
                                                           description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -7699,6 +7707,14 @@ var schemas_default = {
                                                               "false"
                                                             ]
                                                           },
+                                                          name: {
+                                                            type: "string",
+                                                            description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                            pattern: "\\S",
+                                                            transform: [
+                                                              "trim"
+                                                            ]
+                                                          },
                                                           engine: {
                                                             title: "Recording engine",
                                                             description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -7934,13 +7950,52 @@ var schemas_default = {
                                                 stopRecord: {
                                                   $schema: "http://json-schema.org/draft-07/schema#",
                                                   title: "stopRecord",
-                                                  description: "Stop the current recording.",
-                                                  type: [
-                                                    "boolean",
-                                                    "null"
+                                                  description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                                  anyOf: [
+                                                    {
+                                                      type: "boolean",
+                                                      title: "stopRecord (boolean)",
+                                                      description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                                    },
+                                                    {
+                                                      type: "null",
+                                                      title: "stopRecord (null)",
+                                                      description: "Stops the most recently started active recording (LIFO)."
+                                                    },
+                                                    {
+                                                      type: "string",
+                                                      title: "stopRecord (name)",
+                                                      description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                      pattern: "\\S",
+                                                      transform: [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    {
+                                                      type: "object",
+                                                      title: "stopRecord (detailed)",
+                                                      additionalProperties: false,
+                                                      required: [
+                                                        "name"
+                                                      ],
+                                                      properties: {
+                                                        name: {
+                                                          type: "string",
+                                                          description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ]
+                                                        }
+                                                      }
+                                                    }
                                                   ],
                                                   examples: [
-                                                    true
+                                                    true,
+                                                    "demo",
+                                                    {
+                                                      name: "demo"
+                                                    }
                                                   ]
                                                 }
                                               },
@@ -10237,6 +10292,11 @@ var schemas_default = {
         type: "boolean",
         default: false
       },
+      autoRecord: {
+        description: "If `true`, records a video of every test context that runs in a browser, in addition to any explicit `record` steps. The recording wraps the whole context (it starts before the first step and stops after the last) and always uses the `ffmpeg` engine. Videos are saved in the per-run artifact directory (`<output>/.doc-detective/run-<runId>/`) at paths derived from spec, test, and context IDs (for example, `recordings/<specId>/<testId>/<contextId>.mp4`), so the same context 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 `autoRecord` fields (test level wins over spec level, which wins over config level). Equivalent to `--auto-record` 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",
@@ -16644,6 +16704,14 @@ var schemas_default = {
                                               "false"
                                             ]
                                           },
+                                          name: {
+                                            type: "string",
+                                            description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                            pattern: "\\S",
+                                            transform: [
+                                              "trim"
+                                            ]
+                                          },
                                           engine: {
                                             title: "Recording engine",
                                             description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -16739,6 +16807,14 @@ var schemas_default = {
                                                 "false"
                                               ]
                                             },
+                                            name: {
+                                              type: "string",
+                                              description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                              pattern: "\\S",
+                                              transform: [
+                                                "trim"
+                                              ]
+                                            },
                                             engine: {
                                               title: "Recording engine",
                                               description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -16974,13 +17050,52 @@ var schemas_default = {
                                   stopRecord: {
                                     $schema: "http://json-schema.org/draft-07/schema#",
                                     title: "stopRecord",
-                                    description: "Stop the current recording.",
-                                    type: [
-                                      "boolean",
-                                      "null"
+                                    description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                    anyOf: [
+                                      {
+                                        type: "boolean",
+                                        title: "stopRecord (boolean)",
+                                        description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                      },
+                                      {
+                                        type: "null",
+                                        title: "stopRecord (null)",
+                                        description: "Stops the most recently started active recording (LIFO)."
+                                      },
+                                      {
+                                        type: "string",
+                                        title: "stopRecord (name)",
+                                        description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                        pattern: "\\S",
+                                        transform: [
+                                          "trim"
+                                        ]
+                                      },
+                                      {
+                                        type: "object",
+                                        title: "stopRecord (detailed)",
+                                        additionalProperties: false,
+                                        required: [
+                                          "name"
+                                        ],
+                                        properties: {
+                                          name: {
+                                            type: "string",
+                                            description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                            pattern: "\\S",
+                                            transform: [
+                                              "trim"
+                                            ]
+                                          }
+                                        }
+                                      }
                                     ],
                                     examples: [
-                                      true
+                                      true,
+                                      "demo",
+                                      {
+                                        name: "demo"
+                                      }
                                     ]
                                   }
                                 },
@@ -22959,6 +23074,14 @@ var schemas_default = {
               "false"
             ]
           },
+          name: {
+            type: "string",
+            description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+            pattern: "\\S",
+            transform: [
+              "trim"
+            ]
+          },
           engine: {
             title: "Recording engine",
             description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -23054,6 +23177,14 @@ var schemas_default = {
                 "false"
               ]
             },
+            name: {
+              type: "string",
+              description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+              pattern: "\\S",
+              transform: [
+                "trim"
+              ]
+            },
             engine: {
               title: "Recording engine",
               description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -30296,6 +30427,14 @@ var schemas_default = {
                                                                 "false"
                                                               ]
                                                             },
+                                                            name: {
+                                                              type: "string",
+                                                              description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                              pattern: "\\S",
+                                                              transform: [
+                                                                "trim"
+                                                              ]
+                                                            },
                                                             engine: {
                                                               title: "Recording engine",
                                                               description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -30391,6 +30530,14 @@ var schemas_default = {
                                                                   "false"
                                                                 ]
                                                               },
+                                                              name: {
+                                                                type: "string",
+                                                                description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                                pattern: "\\S",
+                                                                transform: [
+                                                                  "trim"
+                                                                ]
+                                                              },
                                                               engine: {
                                                                 title: "Recording engine",
                                                                 description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -30626,13 +30773,52 @@ var schemas_default = {
                                                     stopRecord: {
                                                       $schema: "http://json-schema.org/draft-07/schema#",
                                                       title: "stopRecord",
-                                                      description: "Stop the current recording.",
-                                                      type: [
-                                                        "boolean",
-                                                        "null"
+                                                      description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                                      anyOf: [
+                                                        {
+                                                          type: "boolean",
+                                                          title: "stopRecord (boolean)",
+                                                          description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                                        },
+                                                        {
+                                                          type: "null",
+                                                          title: "stopRecord (null)",
+                                                          description: "Stops the most recently started active recording (LIFO)."
+                                                        },
+                                                        {
+                                                          type: "string",
+                                                          title: "stopRecord (name)",
+                                                          description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ]
+                                                        },
+                                                        {
+                                                          type: "object",
+                                                          title: "stopRecord (detailed)",
+                                                          additionalProperties: false,
+                                                          required: [
+                                                            "name"
+                                                          ],
+                                                          properties: {
+                                                            name: {
+                                                              type: "string",
+                                                              description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                              pattern: "\\S",
+                                                              transform: [
+                                                                "trim"
+                                                              ]
+                                                            }
+                                                          }
+                                                        }
                                                       ],
                                                       examples: [
-                                                        true
+                                                        true,
+                                                        "demo",
+                                                        {
+                                                          name: "demo"
+                                                        }
                                                       ]
                                                     }
                                                   },
@@ -32929,6 +33115,11 @@ var schemas_default = {
             type: "boolean",
             default: false
           },
+          autoRecord: {
+            description: "If `true`, records a video of every test context that runs in a browser, in addition to any explicit `record` steps. The recording wraps the whole context (it starts before the first step and stops after the last) and always uses the `ffmpeg` engine. Videos are saved in the per-run artifact directory (`<output>/.doc-detective/run-<runId>/`) at paths derived from spec, test, and context IDs (for example, `recordings/<specId>/<testId>/<contextId>.mp4`), so the same context 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 `autoRecord` fields (test level wins over spec level, which wins over config level). Equivalent to `--auto-record` 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",
@@ -39336,6 +39527,14 @@ var schemas_default = {
                                                   "false"
                                                 ]
                                               },
+                                              name: {
+                                                type: "string",
+                                                description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                pattern: "\\S",
+                                                transform: [
+                                                  "trim"
+                                                ]
+                                              },
                                               engine: {
                                                 title: "Recording engine",
                                                 description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -39431,6 +39630,14 @@ var schemas_default = {
                                                     "false"
                                                   ]
                                                 },
+                                                name: {
+                                                  type: "string",
+                                                  description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                  pattern: "\\S",
+                                                  transform: [
+                                                    "trim"
+                                                  ]
+                                                },
                                                 engine: {
                                                   title: "Recording engine",
                                                   description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -39666,13 +39873,52 @@ var schemas_default = {
                                       stopRecord: {
                                         $schema: "http://json-schema.org/draft-07/schema#",
                                         title: "stopRecord",
-                                        description: "Stop the current recording.",
-                                        type: [
-                                          "boolean",
-                                          "null"
+                                        description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                        anyOf: [
+                                          {
+                                            type: "boolean",
+                                            title: "stopRecord (boolean)",
+                                            description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                          },
+                                          {
+                                            type: "null",
+                                            title: "stopRecord (null)",
+                                            description: "Stops the most recently started active recording (LIFO)."
+                                          },
+                                          {
+                                            type: "string",
+                                            title: "stopRecord (name)",
+                                            description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                            pattern: "\\S",
+                                            transform: [
+                                              "trim"
+                                            ]
+                                          },
+                                          {
+                                            type: "object",
+                                            title: "stopRecord (detailed)",
+                                            additionalProperties: false,
+                                            required: [
+                                              "name"
+                                            ],
+                                            properties: {
+                                              name: {
+                                                type: "string",
+                                                description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                pattern: "\\S",
+                                                transform: [
+                                                  "trim"
+                                                ]
+                                              }
+                                            }
+                                          }
                                         ],
                                         examples: [
-                                          true
+                                          true,
+                                          "demo",
+                                          {
+                                            name: "demo"
+                                          }
                                         ]
                                       }
                                     },
@@ -42162,6 +42408,10 @@ var schemas_default = {
                   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."
                 },
+                autoRecord: {
+                  type: "boolean",
+                  description: "If `true`, records a video of every browser context in this spec's tests. Overrides the config-level `autoRecord`; individual tests can override this value with their own `autoRecord`. When unset, defers to the config level."
+                },
                 tests: {
                   description: "[Tests](test) to perform.",
                   type: "array",
@@ -42195,6 +42445,10 @@ var schemas_default = {
                             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."
                           },
+                          autoRecord: {
+                            type: "boolean",
+                            description: "If `true`, records a video of every browser context in this test. Overrides `autoRecord` 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.",
@@ -49051,6 +49305,14 @@ var schemas_default = {
                                                     "false"
                                                   ]
                                                 },
+                                                name: {
+                                                  type: "string",
+                                                  description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                  pattern: "\\S",
+                                                  transform: [
+                                                    "trim"
+                                                  ]
+                                                },
                                                 engine: {
                                                   title: "Recording engine",
                                                   description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -49146,6 +49408,14 @@ var schemas_default = {
                                                       "false"
                                                     ]
                                                   },
+                                                  name: {
+                                                    type: "string",
+                                                    description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                    pattern: "\\S",
+                                                    transform: [
+                                                      "trim"
+                                                    ]
+                                                  },
                                                   engine: {
                                                     title: "Recording engine",
                                                     description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -49381,13 +49651,52 @@ var schemas_default = {
                                         stopRecord: {
                                           $schema: "http://json-schema.org/draft-07/schema#",
                                           title: "stopRecord",
-                                          description: "Stop the current recording.",
-                                          type: [
-                                            "boolean",
-                                            "null"
+                                          description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                          anyOf: [
+                                            {
+                                              type: "boolean",
+                                              title: "stopRecord (boolean)",
+                                              description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                            },
+                                            {
+                                              type: "null",
+                                              title: "stopRecord (null)",
+                                              description: "Stops the most recently started active recording (LIFO)."
+                                            },
+                                            {
+                                              type: "string",
+                                              title: "stopRecord (name)",
+                                              description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                              pattern: "\\S",
+                                              transform: [
+                                                "trim"
+                                              ]
+                                            },
+                                            {
+                                              type: "object",
+                                              title: "stopRecord (detailed)",
+                                              additionalProperties: false,
+                                              required: [
+                                                "name"
+                                              ],
+                                              properties: {
+                                                name: {
+                                                  type: "string",
+                                                  description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                  pattern: "\\S",
+                                                  transform: [
+                                                    "trim"
+                                                  ]
+                                                }
+                                              }
+                                            }
                                           ],
                                           examples: [
-                                            true
+                                            true,
+                                            "demo",
+                                            {
+                                              name: "demo"
+                                            }
                                           ]
                                         }
                                       },
@@ -57525,6 +57834,14 @@ var schemas_default = {
                                                           "false"
                                                         ]
                                                       },
+                                                      name: {
+                                                        type: "string",
+                                                        description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ]
+                                                      },
                                                       engine: {
                                                         title: "Recording engine",
                                                         description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -57620,6 +57937,14 @@ var schemas_default = {
                                                             "false"
                                                           ]
                                                         },
+                                                        name: {
+                                                          type: "string",
+                                                          description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ]
+                                                        },
                                                         engine: {
                                                           title: "Recording engine",
                                                           description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -57855,13 +58180,52 @@ var schemas_default = {
                                               stopRecord: {
                                                 $schema: "http://json-schema.org/draft-07/schema#",
                                                 title: "stopRecord",
-                                                description: "Stop the current recording.",
-                                                type: [
-                                                  "boolean",
-                                                  "null"
+                                                description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                                anyOf: [
+                                                  {
+                                                    type: "boolean",
+                                                    title: "stopRecord (boolean)",
+                                                    description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                                  },
+                                                  {
+                                                    type: "null",
+                                                    title: "stopRecord (null)",
+                                                    description: "Stops the most recently started active recording (LIFO)."
+                                                  },
+                                                  {
+                                                    type: "string",
+                                                    title: "stopRecord (name)",
+                                                    description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                    pattern: "\\S",
+                                                    transform: [
+                                                      "trim"
+                                                    ]
+                                                  },
+                                                  {
+                                                    type: "object",
+                                                    title: "stopRecord (detailed)",
+                                                    additionalProperties: false,
+                                                    required: [
+                                                      "name"
+                                                    ],
+                                                    properties: {
+                                                      name: {
+                                                        type: "string",
+                                                        description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ]
+                                                      }
+                                                    }
+                                                  }
                                                 ],
                                                 examples: [
-                                                  true
+                                                  true,
+                                                  "demo",
+                                                  {
+                                                    name: "demo"
+                                                  }
                                                 ]
                                               }
                                             },
@@ -60838,6 +61202,10 @@ var schemas_default = {
                   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."
                 },
+                autoRecord: {
+                  type: "boolean",
+                  description: "If `true`, records a video of every browser context in this spec's tests. Overrides the config-level `autoRecord`; individual tests can override this value with their own `autoRecord`. When unset, defers to the config level."
+                },
                 tests: {
                   description: "[Tests](test) to perform.",
                   type: "array",
@@ -60871,6 +61239,10 @@ var schemas_default = {
                             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."
                           },
+                          autoRecord: {
+                            type: "boolean",
+                            description: "If `true`, records a video of every browser context in this test. Overrides `autoRecord` 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.",
@@ -67727,6 +68099,14 @@ var schemas_default = {
                                                     "false"
                                                   ]
                                                 },
+                                                name: {
+                                                  type: "string",
+                                                  description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                  pattern: "\\S",
+                                                  transform: [
+                                                    "trim"
+                                                  ]
+                                                },
                                                 engine: {
                                                   title: "Recording engine",
                                                   description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -67822,6 +68202,14 @@ var schemas_default = {
                                                       "false"
                                                     ]
                                                   },
+                                                  name: {
+                                                    type: "string",
+                                                    description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                    pattern: "\\S",
+                                                    transform: [
+                                                      "trim"
+                                                    ]
+                                                  },
                                                   engine: {
                                                     title: "Recording engine",
                                                     description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -68057,13 +68445,52 @@ var schemas_default = {
                                         stopRecord: {
                                           $schema: "http://json-schema.org/draft-07/schema#",
                                           title: "stopRecord",
-                                          description: "Stop the current recording.",
-                                          type: [
-                                            "boolean",
-                                            "null"
+                                          description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                          anyOf: [
+                                            {
+                                              type: "boolean",
+                                              title: "stopRecord (boolean)",
+                                              description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                            },
+                                            {
+                                              type: "null",
+                                              title: "stopRecord (null)",
+                                              description: "Stops the most recently started active recording (LIFO)."
+                                            },
+                                            {
+                                              type: "string",
+                                              title: "stopRecord (name)",
+                                              description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                              pattern: "\\S",
+                                              transform: [
+                                                "trim"
+                                              ]
+                                            },
+                                            {
+                                              type: "object",
+                                              title: "stopRecord (detailed)",
+                                              additionalProperties: false,
+                                              required: [
+                                                "name"
+                                              ],
+                                              properties: {
+                                                name: {
+                                                  type: "string",
+                                                  description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                  pattern: "\\S",
+                                                  transform: [
+                                                    "trim"
+                                                  ]
+                                                }
+                                              }
+                                            }
                                           ],
                                           examples: [
-                                            true
+                                            true,
+                                            "demo",
+                                            {
+                                              name: "demo"
+                                            }
                                           ]
                                         }
                                       },
@@ -76201,6 +76628,14 @@ var schemas_default = {
                                                           "false"
                                                         ]
                                                       },
+                                                      name: {
+                                                        type: "string",
+                                                        description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ]
+                                                      },
                                                       engine: {
                                                         title: "Recording engine",
                                                         description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -76296,6 +76731,14 @@ var schemas_default = {
                                                             "false"
                                                           ]
                                                         },
+                                                        name: {
+                                                          type: "string",
+                                                          description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ]
+                                                        },
                                                         engine: {
                                                           title: "Recording engine",
                                                           description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -76531,13 +76974,52 @@ var schemas_default = {
                                               stopRecord: {
                                                 $schema: "http://json-schema.org/draft-07/schema#",
                                                 title: "stopRecord",
-                                                description: "Stop the current recording.",
-                                                type: [
-                                                  "boolean",
-                                                  "null"
+                                                description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                                anyOf: [
+                                                  {
+                                                    type: "boolean",
+                                                    title: "stopRecord (boolean)",
+                                                    description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                                  },
+                                                  {
+                                                    type: "null",
+                                                    title: "stopRecord (null)",
+                                                    description: "Stops the most recently started active recording (LIFO)."
+                                                  },
+                                                  {
+                                                    type: "string",
+                                                    title: "stopRecord (name)",
+                                                    description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                    pattern: "\\S",
+                                                    transform: [
+                                                      "trim"
+                                                    ]
+                                                  },
+                                                  {
+                                                    type: "object",
+                                                    title: "stopRecord (detailed)",
+                                                    additionalProperties: false,
+                                                    required: [
+                                                      "name"
+                                                    ],
+                                                    properties: {
+                                                      name: {
+                                                        type: "string",
+                                                        description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ]
+                                                      }
+                                                    }
+                                                  }
                                                 ],
                                                 examples: [
-                                                  true
+                                                  true,
+                                                  "demo",
+                                                  {
+                                                    name: "demo"
+                                                  }
                                                 ]
                                               }
                                             },
@@ -80892,6 +81374,10 @@ var schemas_default = {
         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."
       },
+      autoRecord: {
+        type: "boolean",
+        description: "If `true`, records a video of every browser context in this spec's tests. Overrides the config-level `autoRecord`; individual tests can override this value with their own `autoRecord`. When unset, defers to the config level."
+      },
       tests: {
         description: "[Tests](test) to perform.",
         type: "array",
@@ -80925,6 +81411,10 @@ var schemas_default = {
                   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."
                 },
+                autoRecord: {
+                  type: "boolean",
+                  description: "If `true`, records a video of every browser context in this test. Overrides `autoRecord` 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.",
@@ -87781,6 +88271,14 @@ var schemas_default = {
                                           "false"
                                         ]
                                       },
+                                      name: {
+                                        type: "string",
+                                        description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                        pattern: "\\S",
+                                        transform: [
+                                          "trim"
+                                        ]
+                                      },
                                       engine: {
                                         title: "Recording engine",
                                         description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -87876,6 +88374,14 @@ var schemas_default = {
                                             "false"
                                           ]
                                         },
+                                        name: {
+                                          type: "string",
+                                          description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                          pattern: "\\S",
+                                          transform: [
+                                            "trim"
+                                          ]
+                                        },
                                         engine: {
                                           title: "Recording engine",
                                           description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -88111,13 +88617,52 @@ var schemas_default = {
                               stopRecord: {
                                 $schema: "http://json-schema.org/draft-07/schema#",
                                 title: "stopRecord",
-                                description: "Stop the current recording.",
-                                type: [
-                                  "boolean",
-                                  "null"
+                                description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                anyOf: [
+                                  {
+                                    type: "boolean",
+                                    title: "stopRecord (boolean)",
+                                    description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                  },
+                                  {
+                                    type: "null",
+                                    title: "stopRecord (null)",
+                                    description: "Stops the most recently started active recording (LIFO)."
+                                  },
+                                  {
+                                    type: "string",
+                                    title: "stopRecord (name)",
+                                    description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                    pattern: "\\S",
+                                    transform: [
+                                      "trim"
+                                    ]
+                                  },
+                                  {
+                                    type: "object",
+                                    title: "stopRecord (detailed)",
+                                    additionalProperties: false,
+                                    required: [
+                                      "name"
+                                    ],
+                                    properties: {
+                                      name: {
+                                        type: "string",
+                                        description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                        pattern: "\\S",
+                                        transform: [
+                                          "trim"
+                                        ]
+                                      }
+                                    }
+                                  }
                                 ],
                                 examples: [
-                                  true
+                                  true,
+                                  "demo",
+                                  {
+                                    name: "demo"
+                                  }
                                 ]
                               }
                             },
@@ -96255,6 +96800,14 @@ var schemas_default = {
                                                 "false"
                                               ]
                                             },
+                                            name: {
+                                              type: "string",
+                                              description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                              pattern: "\\S",
+                                              transform: [
+                                                "trim"
+                                              ]
+                                            },
                                             engine: {
                                               title: "Recording engine",
                                               description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -96350,6 +96903,14 @@ var schemas_default = {
                                                   "false"
                                                 ]
                                               },
+                                              name: {
+                                                type: "string",
+                                                description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                                pattern: "\\S",
+                                                transform: [
+                                                  "trim"
+                                                ]
+                                              },
                                               engine: {
                                                 title: "Recording engine",
                                                 description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -96585,13 +97146,52 @@ var schemas_default = {
                                     stopRecord: {
                                       $schema: "http://json-schema.org/draft-07/schema#",
                                       title: "stopRecord",
-                                      description: "Stop the current recording.",
-                                      type: [
-                                        "boolean",
-                                        "null"
+                                      description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                                      anyOf: [
+                                        {
+                                          type: "boolean",
+                                          title: "stopRecord (boolean)",
+                                          description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                                        },
+                                        {
+                                          type: "null",
+                                          title: "stopRecord (null)",
+                                          description: "Stops the most recently started active recording (LIFO)."
+                                        },
+                                        {
+                                          type: "string",
+                                          title: "stopRecord (name)",
+                                          description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                          pattern: "\\S",
+                                          transform: [
+                                            "trim"
+                                          ]
+                                        },
+                                        {
+                                          type: "object",
+                                          title: "stopRecord (detailed)",
+                                          additionalProperties: false,
+                                          required: [
+                                            "name"
+                                          ],
+                                          properties: {
+                                            name: {
+                                              type: "string",
+                                              description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                              pattern: "\\S",
+                                              transform: [
+                                                "trim"
+                                              ]
+                                            }
+                                          }
+                                        }
                                       ],
                                       examples: [
-                                        true
+                                        true,
+                                        "demo",
+                                        {
+                                          name: "demo"
+                                        }
                                       ]
                                     }
                                   },
@@ -105009,6 +105609,14 @@ var schemas_default = {
                           "false"
                         ]
                       },
+                      name: {
+                        type: "string",
+                        description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                        pattern: "\\S",
+                        transform: [
+                          "trim"
+                        ]
+                      },
                       engine: {
                         title: "Recording engine",
                         description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -105104,6 +105712,14 @@ var schemas_default = {
                             "false"
                           ]
                         },
+                        name: {
+                          type: "string",
+                          description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                          pattern: "\\S",
+                          transform: [
+                            "trim"
+                          ]
+                        },
                         engine: {
                           title: "Recording engine",
                           description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -105339,13 +105955,52 @@ var schemas_default = {
               stopRecord: {
                 $schema: "http://json-schema.org/draft-07/schema#",
                 title: "stopRecord",
-                description: "Stop the current recording.",
-                type: [
-                  "boolean",
-                  "null"
+                description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                anyOf: [
+                  {
+                    type: "boolean",
+                    title: "stopRecord (boolean)",
+                    description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                  },
+                  {
+                    type: "null",
+                    title: "stopRecord (null)",
+                    description: "Stops the most recently started active recording (LIFO)."
+                  },
+                  {
+                    type: "string",
+                    title: "stopRecord (name)",
+                    description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                    pattern: "\\S",
+                    transform: [
+                      "trim"
+                    ]
+                  },
+                  {
+                    type: "object",
+                    title: "stopRecord (detailed)",
+                    additionalProperties: false,
+                    required: [
+                      "name"
+                    ],
+                    properties: {
+                      name: {
+                        type: "string",
+                        description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                        pattern: "\\S",
+                        transform: [
+                          "trim"
+                        ]
+                      }
+                    }
+                  }
                 ],
                 examples: [
-                  true
+                  true,
+                  "demo",
+                  {
+                    name: "demo"
+                  }
                 ]
               }
             },
@@ -106948,13 +107603,52 @@ var schemas_default = {
   stopRecord_v3: {
     $schema: "http://json-schema.org/draft-07/schema#",
     title: "stopRecord",
-    description: "Stop the current recording.",
-    type: [
-      "boolean",
-      "null"
+    description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+    anyOf: [
+      {
+        type: "boolean",
+        title: "stopRecord (boolean)",
+        description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+      },
+      {
+        type: "null",
+        title: "stopRecord (null)",
+        description: "Stops the most recently started active recording (LIFO)."
+      },
+      {
+        type: "string",
+        title: "stopRecord (name)",
+        description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+        pattern: "\\S",
+        transform: [
+          "trim"
+        ]
+      },
+      {
+        type: "object",
+        title: "stopRecord (detailed)",
+        additionalProperties: false,
+        required: [
+          "name"
+        ],
+        properties: {
+          name: {
+            type: "string",
+            description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+            pattern: "\\S",
+            transform: [
+              "trim"
+            ]
+          }
+        }
+      }
     ],
     examples: [
-      true
+      true,
+      "demo",
+      {
+        name: "demo"
+      }
     ]
   },
   test_v3: {
@@ -106984,6 +107678,10 @@ var schemas_default = {
         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."
       },
+      autoRecord: {
+        type: "boolean",
+        description: "If `true`, records a video of every browser context in this test. Overrides `autoRecord` 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.",
@@ -113840,6 +114538,14 @@ var schemas_default = {
                                 "false"
                               ]
                             },
+                            name: {
+                              type: "string",
+                              description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                              pattern: "\\S",
+                              transform: [
+                                "trim"
+                              ]
+                            },
                             engine: {
                               title: "Recording engine",
                               description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -113935,6 +114641,14 @@ var schemas_default = {
                                   "false"
                                 ]
                               },
+                              name: {
+                                type: "string",
+                                description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                pattern: "\\S",
+                                transform: [
+                                  "trim"
+                                ]
+                              },
                               engine: {
                                 title: "Recording engine",
                                 description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -114170,13 +114884,52 @@ var schemas_default = {
                     stopRecord: {
                       $schema: "http://json-schema.org/draft-07/schema#",
                       title: "stopRecord",
-                      description: "Stop the current recording.",
-                      type: [
-                        "boolean",
-                        "null"
+                      description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                      anyOf: [
+                        {
+                          type: "boolean",
+                          title: "stopRecord (boolean)",
+                          description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                        },
+                        {
+                          type: "null",
+                          title: "stopRecord (null)",
+                          description: "Stops the most recently started active recording (LIFO)."
+                        },
+                        {
+                          type: "string",
+                          title: "stopRecord (name)",
+                          description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                          pattern: "\\S",
+                          transform: [
+                            "trim"
+                          ]
+                        },
+                        {
+                          type: "object",
+                          title: "stopRecord (detailed)",
+                          additionalProperties: false,
+                          required: [
+                            "name"
+                          ],
+                          properties: {
+                            name: {
+                              type: "string",
+                              description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                              pattern: "\\S",
+                              transform: [
+                                "trim"
+                              ]
+                            }
+                          }
+                        }
                       ],
                       examples: [
-                        true
+                        true,
+                        "demo",
+                        {
+                          name: "demo"
+                        }
                       ]
                     }
                   },
@@ -122314,6 +123067,14 @@ var schemas_default = {
                                       "false"
                                     ]
                                   },
+                                  name: {
+                                    type: "string",
+                                    description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                    pattern: "\\S",
+                                    transform: [
+                                      "trim"
+                                    ]
+                                  },
                                   engine: {
                                     title: "Recording engine",
                                     description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -122409,6 +123170,14 @@ var schemas_default = {
                                         "false"
                                       ]
                                     },
+                                    name: {
+                                      type: "string",
+                                      description: 'Identifier for this recording. A later `stopRecord` step can target it by name (`stopRecord: "<name>"`), which is how you stop a specific recording when several overlap. Names must be unique among recordings that are active at the same time. If omitted, the recording is anonymous and is stopped LIFO by an untargeted `stopRecord`.',
+                                      pattern: "\\S",
+                                      transform: [
+                                        "trim"
+                                      ]
+                                    },
                                     engine: {
                                       title: "Recording engine",
                                       description: "Recording engine to use. Either a string shorthand selecting the engine with defaults, or an object for full control. If unset, defaults to the `browser` engine when a visible Chrome context is available and to `ffmpeg` otherwise.",
@@ -122644,13 +123413,52 @@ var schemas_default = {
                           stopRecord: {
                             $schema: "http://json-schema.org/draft-07/schema#",
                             title: "stopRecord",
-                            description: "Stop the current recording.",
-                            type: [
-                              "boolean",
-                              "null"
+                            description: 'Stop a recording started by an earlier `record` step. With no target (`true`/`null`), stops the most recently started recording that is still active (LIFO). To stop a specific recording when several overlap, target it by name with a string (`stopRecord: "<name>"`) or an object (`stopRecord: { name: "<name>" }`).',
+                            anyOf: [
+                              {
+                                type: "boolean",
+                                title: "stopRecord (boolean)",
+                                description: "If `true`, stops the most recently started active recording (LIFO). If `false`, does nothing \u2014 an explicit no-op (mirrors `record: false`)."
+                              },
+                              {
+                                type: "null",
+                                title: "stopRecord (null)",
+                                description: "Stops the most recently started active recording (LIFO)."
+                              },
+                              {
+                                type: "string",
+                                title: "stopRecord (name)",
+                                description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                pattern: "\\S",
+                                transform: [
+                                  "trim"
+                                ]
+                              },
+                              {
+                                type: "object",
+                                title: "stopRecord (detailed)",
+                                additionalProperties: false,
+                                required: [
+                                  "name"
+                                ],
+                                properties: {
+                                  name: {
+                                    type: "string",
+                                    description: "Name of the recording to stop. Matches the `name` given to a `record` step.",
+                                    pattern: "\\S",
+                                    transform: [
+                                      "trim"
+                                    ]
+                                  }
+                                }
+                              }
                             ],
                             examples: [
-                              true
+                              true,
+                              "demo",
+                              {
+                                name: "demo"
+                              }
                             ]
                           }
                         },