doc-detective-common 4.24.0 → 4.25.1

package/dist/index.cjs

@@ -34175,7 +34175,7 @@ var schemas_default = {
                                                 record: {
                                                   $schema: "http://json-schema.org/draft-07/schema#",
                                                   title: "record",
-                                                  description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                                  description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                                   anyOf: [
                                                     {
                                                       title: "Record (simple)",
@@ -34190,7 +34190,7 @@ var schemas_default = {
                                                       type: "object",
                                                       properties: {
                                                         surface: {
-                                                          description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                          description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                           anyOf: [
                                                             {
                                                               title: "Surface (by browser engine)",
@@ -34340,6 +34340,72 @@ var schemas_default = {
                                                                   ]
                                                                 }
                                                               }
+                                                            },
+                                                            {
+                                                              title: "App surface",
+                                                              type: "object",
+                                                              additionalProperties: false,
+                                                              required: [
+                                                                "app"
+                                                              ],
+                                                              properties: {
+                                                                app: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  pattern: "\\S",
+                                                                  transform: [
+                                                                    "trim"
+                                                                  ],
+                                                                  description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                                },
+                                                                window: {
+                                                                  description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                  title: "App window selector",
+                                                                  anyOf: [
+                                                                    {
+                                                                      title: "By index",
+                                                                      type: "integer",
+                                                                      description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                    },
+                                                                    {
+                                                                      title: "By name",
+                                                                      type: "string",
+                                                                      minLength: 1,
+                                                                      pattern: "\\S",
+                                                                      transform: [
+                                                                        "trim"
+                                                                      ],
+                                                                      description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                    },
+                                                                    {
+                                                                      title: "By criteria",
+                                                                      type: "object",
+                                                                      additionalProperties: false,
+                                                                      minProperties: 1,
+                                                                      properties: {
+                                                                        name: {
+                                                                          type: "string",
+                                                                          minLength: 1,
+                                                                          pattern: "\\S",
+                                                                          transform: [
+                                                                            "trim"
+                                                                          ],
+                                                                          description: "Assigned window name."
+                                                                        },
+                                                                        index: {
+                                                                          type: "integer",
+                                                                          description: "Index in creation order. Negative counts from the end."
+                                                                        },
+                                                                        title: {
+                                                                          type: "string",
+                                                                          minLength: 1,
+                                                                          description: "Window title to match. Substring, or /regex/."
+                                                                        }
+                                                                      }
+                                                                    }
+                                                                  ]
+                                                                }
+                                                              }
                                                             }
                                                           ]
                                                         },
@@ -34405,13 +34471,12 @@ var schemas_default = {
                                                                 },
                                                                 target: {
                                                                   type: "string",
-                                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                   enum: [
                                                                     "display",
                                                                     "window",
                                                                     "viewport"
-                                                                  ],
-                                                                  default: "display"
+                                                                  ]
                                                                 },
                                                                 fps: {
                                                                   type: "integer",
@@ -34429,7 +34494,7 @@ var schemas_default = {
                                                     {
                                                       type: "boolean",
                                                       title: "Record (boolean)",
-                                                      description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                                      description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                                     }
                                                   ],
                                                   components: {
@@ -34447,7 +34512,7 @@ var schemas_default = {
                                                         type: "object",
                                                         properties: {
                                                           surface: {
-                                                            description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                            description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                             anyOf: [
                                                               {
                                                                 title: "Surface (by browser engine)",
@@ -34597,6 +34662,72 @@ var schemas_default = {
                                                                     ]
                                                                   }
                                                                 }
+                                                              },
+                                                              {
+                                                                title: "App surface",
+                                                                type: "object",
+                                                                additionalProperties: false,
+                                                                required: [
+                                                                  "app"
+                                                                ],
+                                                                properties: {
+                                                                  app: {
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    pattern: "\\S",
+                                                                    transform: [
+                                                                      "trim"
+                                                                    ],
+                                                                    description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                                  },
+                                                                  window: {
+                                                                    description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                    title: "App window selector",
+                                                                    anyOf: [
+                                                                      {
+                                                                        title: "By index",
+                                                                        type: "integer",
+                                                                        description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                      },
+                                                                      {
+                                                                        title: "By name",
+                                                                        type: "string",
+                                                                        minLength: 1,
+                                                                        pattern: "\\S",
+                                                                        transform: [
+                                                                          "trim"
+                                                                        ],
+                                                                        description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                      },
+                                                                      {
+                                                                        title: "By criteria",
+                                                                        type: "object",
+                                                                        additionalProperties: false,
+                                                                        minProperties: 1,
+                                                                        properties: {
+                                                                          name: {
+                                                                            type: "string",
+                                                                            minLength: 1,
+                                                                            pattern: "\\S",
+                                                                            transform: [
+                                                                              "trim"
+                                                                            ],
+                                                                            description: "Assigned window name."
+                                                                          },
+                                                                          index: {
+                                                                            type: "integer",
+                                                                            description: "Index in creation order. Negative counts from the end."
+                                                                          },
+                                                                          title: {
+                                                                            type: "string",
+                                                                            minLength: 1,
+                                                                            description: "Window title to match. Substring, or /regex/."
+                                                                          }
+                                                                        }
+                                                                      }
+                                                                    ]
+                                                                  }
+                                                                }
                                                               }
                                                             ]
                                                           },
@@ -34662,13 +34793,12 @@ var schemas_default = {
                                                                   },
                                                                   target: {
                                                                     type: "string",
-                                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                     enum: [
                                                                       "display",
                                                                       "window",
                                                                       "viewport"
-                                                                    ],
-                                                                    default: "display"
+                                                                    ]
                                                                   },
                                                                   fps: {
                                                                     type: "integer",
@@ -34714,13 +34844,12 @@ var schemas_default = {
                                                               },
                                                               target: {
                                                                 type: "string",
-                                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                 enum: [
                                                                   "display",
                                                                   "window",
                                                                   "viewport"
-                                                                ],
-                                                                default: "display"
+                                                                ]
                                                               },
                                                               fps: {
                                                                 type: "integer",
@@ -34753,6 +34882,22 @@ var schemas_default = {
                                                         target: "window",
                                                         fps: 60
                                                       }
+                                                    },
+                                                    {
+                                                      path: "notepad.mp4",
+                                                      surface: {
+                                                        app: "notepad"
+                                                      }
+                                                    },
+                                                    {
+                                                      path: "full-screen.mp4",
+                                                      surface: {
+                                                        app: "notepad"
+                                                      },
+                                                      engine: {
+                                                        name: "ffmpeg",
+                                                        target: "display"
+                                                      }
                                                     }
                                                   ]
                                                 }
@@ -78757,7 +78902,7 @@ var schemas_default = {
                                   record: {
                                     $schema: "http://json-schema.org/draft-07/schema#",
                                     title: "record",
-                                    description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                    description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                     anyOf: [
                                       {
                                         title: "Record (simple)",
@@ -78772,7 +78917,7 @@ var schemas_default = {
                                         type: "object",
                                         properties: {
                                           surface: {
-                                            description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                            description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                             anyOf: [
                                               {
                                                 title: "Surface (by browser engine)",
@@ -78922,6 +79067,72 @@ var schemas_default = {
                                                     ]
                                                   }
                                                 }
+                                              },
+                                              {
+                                                title: "App surface",
+                                                type: "object",
+                                                additionalProperties: false,
+                                                required: [
+                                                  "app"
+                                                ],
+                                                properties: {
+                                                  app: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "\\S",
+                                                    transform: [
+                                                      "trim"
+                                                    ],
+                                                    description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                  },
+                                                  window: {
+                                                    description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                    title: "App window selector",
+                                                    anyOf: [
+                                                      {
+                                                        title: "By index",
+                                                        type: "integer",
+                                                        description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                      },
+                                                      {
+                                                        title: "By name",
+                                                        type: "string",
+                                                        minLength: 1,
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ],
+                                                        description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                      },
+                                                      {
+                                                        title: "By criteria",
+                                                        type: "object",
+                                                        additionalProperties: false,
+                                                        minProperties: 1,
+                                                        properties: {
+                                                          name: {
+                                                            type: "string",
+                                                            minLength: 1,
+                                                            pattern: "\\S",
+                                                            transform: [
+                                                              "trim"
+                                                            ],
+                                                            description: "Assigned window name."
+                                                          },
+                                                          index: {
+                                                            type: "integer",
+                                                            description: "Index in creation order. Negative counts from the end."
+                                                          },
+                                                          title: {
+                                                            type: "string",
+                                                            minLength: 1,
+                                                            description: "Window title to match. Substring, or /regex/."
+                                                          }
+                                                        }
+                                                      }
+                                                    ]
+                                                  }
+                                                }
                                               }
                                             ]
                                           },
@@ -78987,13 +79198,12 @@ var schemas_default = {
                                                   },
                                                   target: {
                                                     type: "string",
-                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                     enum: [
                                                       "display",
                                                       "window",
                                                       "viewport"
-                                                    ],
-                                                    default: "display"
+                                                    ]
                                                   },
                                                   fps: {
                                                     type: "integer",
@@ -79011,7 +79221,7 @@ var schemas_default = {
                                       {
                                         type: "boolean",
                                         title: "Record (boolean)",
-                                        description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                        description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                       }
                                     ],
                                     components: {
@@ -79029,7 +79239,7 @@ var schemas_default = {
                                           type: "object",
                                           properties: {
                                             surface: {
-                                              description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                              description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                               anyOf: [
                                                 {
                                                   title: "Surface (by browser engine)",
@@ -79179,6 +79389,72 @@ var schemas_default = {
                                                       ]
                                                     }
                                                   }
+                                                },
+                                                {
+                                                  title: "App surface",
+                                                  type: "object",
+                                                  additionalProperties: false,
+                                                  required: [
+                                                    "app"
+                                                  ],
+                                                  properties: {
+                                                    app: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "\\S",
+                                                      transform: [
+                                                        "trim"
+                                                      ],
+                                                      description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                    },
+                                                    window: {
+                                                      description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                      title: "App window selector",
+                                                      anyOf: [
+                                                        {
+                                                          title: "By index",
+                                                          type: "integer",
+                                                          description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                        },
+                                                        {
+                                                          title: "By name",
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ],
+                                                          description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                        },
+                                                        {
+                                                          title: "By criteria",
+                                                          type: "object",
+                                                          additionalProperties: false,
+                                                          minProperties: 1,
+                                                          properties: {
+                                                            name: {
+                                                              type: "string",
+                                                              minLength: 1,
+                                                              pattern: "\\S",
+                                                              transform: [
+                                                                "trim"
+                                                              ],
+                                                              description: "Assigned window name."
+                                                            },
+                                                            index: {
+                                                              type: "integer",
+                                                              description: "Index in creation order. Negative counts from the end."
+                                                            },
+                                                            title: {
+                                                              type: "string",
+                                                              minLength: 1,
+                                                              description: "Window title to match. Substring, or /regex/."
+                                                            }
+                                                          }
+                                                        }
+                                                      ]
+                                                    }
+                                                  }
                                                 }
                                               ]
                                             },
@@ -79244,13 +79520,12 @@ var schemas_default = {
                                                     },
                                                     target: {
                                                       type: "string",
-                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                       enum: [
                                                         "display",
                                                         "window",
                                                         "viewport"
-                                                      ],
-                                                      default: "display"
+                                                      ]
                                                     },
                                                     fps: {
                                                       type: "integer",
@@ -79296,13 +79571,12 @@ var schemas_default = {
                                                 },
                                                 target: {
                                                   type: "string",
-                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                   enum: [
                                                     "display",
                                                     "window",
                                                     "viewport"
-                                                  ],
-                                                  default: "display"
+                                                  ]
                                                 },
                                                 fps: {
                                                   type: "integer",
@@ -79335,6 +79609,22 @@ var schemas_default = {
                                           target: "window",
                                           fps: 60
                                         }
+                                      },
+                                      {
+                                        path: "notepad.mp4",
+                                        surface: {
+                                          app: "notepad"
+                                        }
+                                      },
+                                      {
+                                        path: "full-screen.mp4",
+                                        surface: {
+                                          app: "notepad"
+                                        },
+                                        engine: {
+                                          name: "ffmpeg",
+                                          target: "display"
+                                        }
                                       }
                                     ]
                                   }
@@ -104054,7 +104344,7 @@ var schemas_default = {
   record_v3: {
     $schema: "http://json-schema.org/draft-07/schema#",
     title: "record",
-    description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+    description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
     anyOf: [
       {
         title: "Record (simple)",
@@ -104069,7 +104359,7 @@ var schemas_default = {
         type: "object",
         properties: {
           surface: {
-            description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+            description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
             anyOf: [
               {
                 title: "Surface (by browser engine)",
@@ -104166,14 +104456,85 @@ var schemas_default = {
                       }
                     ]
                   },
-                  tab: {
-                    description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
-                    title: "Window/tab selector",
+                  tab: {
+                    description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
+                    title: "Window/tab selector",
+                    anyOf: [
+                      {
+                        title: "By index",
+                        type: "integer",
+                        description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                      },
+                      {
+                        title: "By name",
+                        type: "string",
+                        minLength: 1,
+                        pattern: "\\S",
+                        transform: [
+                          "trim"
+                        ],
+                        description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                      },
+                      {
+                        title: "By criteria",
+                        type: "object",
+                        additionalProperties: false,
+                        minProperties: 1,
+                        properties: {
+                          name: {
+                            type: "string",
+                            minLength: 1,
+                            pattern: "\\S",
+                            transform: [
+                              "trim"
+                            ],
+                            description: "Name assigned when the window/tab was opened."
+                          },
+                          index: {
+                            type: "integer",
+                            description: "Index in creation order. Negative counts from the end."
+                          },
+                          title: {
+                            type: "string",
+                            minLength: 1,
+                            description: "Page title to match. Substring, or /regex/."
+                          },
+                          url: {
+                            type: "string",
+                            minLength: 1,
+                            description: "Page URL to match. Substring, or /regex/."
+                          }
+                        }
+                      }
+                    ]
+                  }
+                }
+              },
+              {
+                title: "App surface",
+                type: "object",
+                additionalProperties: false,
+                required: [
+                  "app"
+                ],
+                properties: {
+                  app: {
+                    type: "string",
+                    minLength: 1,
+                    pattern: "\\S",
+                    transform: [
+                      "trim"
+                    ],
+                    description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                  },
+                  window: {
+                    description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                    title: "App window selector",
                     anyOf: [
                       {
                         title: "By index",
                         type: "integer",
-                        description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                        description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
                       },
                       {
                         title: "By name",
@@ -104183,7 +104544,7 @@ var schemas_default = {
                         transform: [
                           "trim"
                         ],
-                        description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                        description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
                       },
                       {
                         title: "By criteria",
@@ -104198,7 +104559,7 @@ var schemas_default = {
                             transform: [
                               "trim"
                             ],
-                            description: "Name assigned when the window/tab was opened."
+                            description: "Assigned window name."
                           },
                           index: {
                             type: "integer",
@@ -104207,12 +104568,7 @@ var schemas_default = {
                           title: {
                             type: "string",
                             minLength: 1,
-                            description: "Page title to match. Substring, or /regex/."
-                          },
-                          url: {
-                            type: "string",
-                            minLength: 1,
-                            description: "Page URL to match. Substring, or /regex/."
+                            description: "Window title to match. Substring, or /regex/."
                           }
                         }
                       }
@@ -104284,13 +104640,12 @@ var schemas_default = {
                   },
                   target: {
                     type: "string",
-                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                     enum: [
                       "display",
                       "window",
                       "viewport"
-                    ],
-                    default: "display"
+                    ]
                   },
                   fps: {
                     type: "integer",
@@ -104308,7 +104663,7 @@ var schemas_default = {
       {
         type: "boolean",
         title: "Record (boolean)",
-        description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+        description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
       }
     ],
     components: {
@@ -104326,7 +104681,7 @@ var schemas_default = {
           type: "object",
           properties: {
             surface: {
-              description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+              description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
               anyOf: [
                 {
                   title: "Surface (by browser engine)",
@@ -104476,6 +104831,72 @@ var schemas_default = {
                       ]
                     }
                   }
+                },
+                {
+                  title: "App surface",
+                  type: "object",
+                  additionalProperties: false,
+                  required: [
+                    "app"
+                  ],
+                  properties: {
+                    app: {
+                      type: "string",
+                      minLength: 1,
+                      pattern: "\\S",
+                      transform: [
+                        "trim"
+                      ],
+                      description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                    },
+                    window: {
+                      description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                      title: "App window selector",
+                      anyOf: [
+                        {
+                          title: "By index",
+                          type: "integer",
+                          description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                        },
+                        {
+                          title: "By name",
+                          type: "string",
+                          minLength: 1,
+                          pattern: "\\S",
+                          transform: [
+                            "trim"
+                          ],
+                          description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                        },
+                        {
+                          title: "By criteria",
+                          type: "object",
+                          additionalProperties: false,
+                          minProperties: 1,
+                          properties: {
+                            name: {
+                              type: "string",
+                              minLength: 1,
+                              pattern: "\\S",
+                              transform: [
+                                "trim"
+                              ],
+                              description: "Assigned window name."
+                            },
+                            index: {
+                              type: "integer",
+                              description: "Index in creation order. Negative counts from the end."
+                            },
+                            title: {
+                              type: "string",
+                              minLength: 1,
+                              description: "Window title to match. Substring, or /regex/."
+                            }
+                          }
+                        }
+                      ]
+                    }
+                  }
                 }
               ]
             },
@@ -104541,13 +104962,12 @@ var schemas_default = {
                     },
                     target: {
                       type: "string",
-                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                       enum: [
                         "display",
                         "window",
                         "viewport"
-                      ],
-                      default: "display"
+                      ]
                     },
                     fps: {
                       type: "integer",
@@ -104593,13 +105013,12 @@ var schemas_default = {
                 },
                 target: {
                   type: "string",
-                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                   enum: [
                     "display",
                     "window",
                     "viewport"
-                  ],
-                  default: "display"
+                  ]
                 },
                 fps: {
                   type: "integer",
@@ -104632,6 +105051,22 @@ var schemas_default = {
           target: "window",
           fps: 60
         }
+      },
+      {
+        path: "notepad.mp4",
+        surface: {
+          app: "notepad"
+        }
+      },
+      {
+        path: "full-screen.mp4",
+        surface: {
+          app: "notepad"
+        },
+        engine: {
+          name: "ffmpeg",
+          target: "display"
+        }
       }
     ]
   },
@@ -136499,7 +136934,7 @@ var schemas_default = {
                                                     record: {
                                                       $schema: "http://json-schema.org/draft-07/schema#",
                                                       title: "record",
-                                                      description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                                      description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                                       anyOf: [
                                                         {
                                                           title: "Record (simple)",
@@ -136514,7 +136949,7 @@ var schemas_default = {
                                                           type: "object",
                                                           properties: {
                                                             surface: {
-                                                              description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                              description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                               anyOf: [
                                                                 {
                                                                   title: "Surface (by browser engine)",
@@ -136664,6 +137099,72 @@ var schemas_default = {
                                                                       ]
                                                                     }
                                                                   }
+                                                                },
+                                                                {
+                                                                  title: "App surface",
+                                                                  type: "object",
+                                                                  additionalProperties: false,
+                                                                  required: [
+                                                                    "app"
+                                                                  ],
+                                                                  properties: {
+                                                                    app: {
+                                                                      type: "string",
+                                                                      minLength: 1,
+                                                                      pattern: "\\S",
+                                                                      transform: [
+                                                                        "trim"
+                                                                      ],
+                                                                      description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                                    },
+                                                                    window: {
+                                                                      description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                      title: "App window selector",
+                                                                      anyOf: [
+                                                                        {
+                                                                          title: "By index",
+                                                                          type: "integer",
+                                                                          description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                        },
+                                                                        {
+                                                                          title: "By name",
+                                                                          type: "string",
+                                                                          minLength: 1,
+                                                                          pattern: "\\S",
+                                                                          transform: [
+                                                                            "trim"
+                                                                          ],
+                                                                          description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                        },
+                                                                        {
+                                                                          title: "By criteria",
+                                                                          type: "object",
+                                                                          additionalProperties: false,
+                                                                          minProperties: 1,
+                                                                          properties: {
+                                                                            name: {
+                                                                              type: "string",
+                                                                              minLength: 1,
+                                                                              pattern: "\\S",
+                                                                              transform: [
+                                                                                "trim"
+                                                                              ],
+                                                                              description: "Assigned window name."
+                                                                            },
+                                                                            index: {
+                                                                              type: "integer",
+                                                                              description: "Index in creation order. Negative counts from the end."
+                                                                            },
+                                                                            title: {
+                                                                              type: "string",
+                                                                              minLength: 1,
+                                                                              description: "Window title to match. Substring, or /regex/."
+                                                                            }
+                                                                          }
+                                                                        }
+                                                                      ]
+                                                                    }
+                                                                  }
                                                                 }
                                                               ]
                                                             },
@@ -136729,13 +137230,12 @@ var schemas_default = {
                                                                     },
                                                                     target: {
                                                                       type: "string",
-                                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                       enum: [
                                                                         "display",
                                                                         "window",
                                                                         "viewport"
-                                                                      ],
-                                                                      default: "display"
+                                                                      ]
                                                                     },
                                                                     fps: {
                                                                       type: "integer",
@@ -136753,7 +137253,7 @@ var schemas_default = {
                                                         {
                                                           type: "boolean",
                                                           title: "Record (boolean)",
-                                                          description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                                          description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                                         }
                                                       ],
                                                       components: {
@@ -136771,7 +137271,7 @@ var schemas_default = {
                                                             type: "object",
                                                             properties: {
                                                               surface: {
-                                                                description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                                description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                                 anyOf: [
                                                                   {
                                                                     title: "Surface (by browser engine)",
@@ -136921,6 +137421,72 @@ var schemas_default = {
                                                                         ]
                                                                       }
                                                                     }
+                                                                  },
+                                                                  {
+                                                                    title: "App surface",
+                                                                    type: "object",
+                                                                    additionalProperties: false,
+                                                                    required: [
+                                                                      "app"
+                                                                    ],
+                                                                    properties: {
+                                                                      app: {
+                                                                        type: "string",
+                                                                        minLength: 1,
+                                                                        pattern: "\\S",
+                                                                        transform: [
+                                                                          "trim"
+                                                                        ],
+                                                                        description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                                      },
+                                                                      window: {
+                                                                        description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                        title: "App window selector",
+                                                                        anyOf: [
+                                                                          {
+                                                                            title: "By index",
+                                                                            type: "integer",
+                                                                            description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                          },
+                                                                          {
+                                                                            title: "By name",
+                                                                            type: "string",
+                                                                            minLength: 1,
+                                                                            pattern: "\\S",
+                                                                            transform: [
+                                                                              "trim"
+                                                                            ],
+                                                                            description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                          },
+                                                                          {
+                                                                            title: "By criteria",
+                                                                            type: "object",
+                                                                            additionalProperties: false,
+                                                                            minProperties: 1,
+                                                                            properties: {
+                                                                              name: {
+                                                                                type: "string",
+                                                                                minLength: 1,
+                                                                                pattern: "\\S",
+                                                                                transform: [
+                                                                                  "trim"
+                                                                                ],
+                                                                                description: "Assigned window name."
+                                                                              },
+                                                                              index: {
+                                                                                type: "integer",
+                                                                                description: "Index in creation order. Negative counts from the end."
+                                                                              },
+                                                                              title: {
+                                                                                type: "string",
+                                                                                minLength: 1,
+                                                                                description: "Window title to match. Substring, or /regex/."
+                                                                              }
+                                                                            }
+                                                                          }
+                                                                        ]
+                                                                      }
+                                                                    }
                                                                   }
                                                                 ]
                                                               },
@@ -136986,13 +137552,12 @@ var schemas_default = {
                                                                       },
                                                                       target: {
                                                                         type: "string",
-                                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                         enum: [
                                                                           "display",
                                                                           "window",
                                                                           "viewport"
-                                                                        ],
-                                                                        default: "display"
+                                                                        ]
                                                                       },
                                                                       fps: {
                                                                         type: "integer",
@@ -137038,13 +137603,12 @@ var schemas_default = {
                                                                   },
                                                                   target: {
                                                                     type: "string",
-                                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                     enum: [
                                                                       "display",
                                                                       "window",
                                                                       "viewport"
-                                                                    ],
-                                                                    default: "display"
+                                                                    ]
                                                                   },
                                                                   fps: {
                                                                     type: "integer",
@@ -137077,6 +137641,22 @@ var schemas_default = {
                                                             target: "window",
                                                             fps: 60
                                                           }
+                                                        },
+                                                        {
+                                                          path: "notepad.mp4",
+                                                          surface: {
+                                                            app: "notepad"
+                                                          }
+                                                        },
+                                                        {
+                                                          path: "full-screen.mp4",
+                                                          surface: {
+                                                            app: "notepad"
+                                                          },
+                                                          engine: {
+                                                            name: "ffmpeg",
+                                                            target: "display"
+                                                          }
                                                         }
                                                       ]
                                                     }
@@ -181081,7 +181661,7 @@ var schemas_default = {
                                       record: {
                                         $schema: "http://json-schema.org/draft-07/schema#",
                                         title: "record",
-                                        description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                        description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                         anyOf: [
                                           {
                                             title: "Record (simple)",
@@ -181096,7 +181676,7 @@ var schemas_default = {
                                             type: "object",
                                             properties: {
                                               surface: {
-                                                description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                 anyOf: [
                                                   {
                                                     title: "Surface (by browser engine)",
@@ -181246,6 +181826,72 @@ var schemas_default = {
                                                         ]
                                                       }
                                                     }
+                                                  },
+                                                  {
+                                                    title: "App surface",
+                                                    type: "object",
+                                                    additionalProperties: false,
+                                                    required: [
+                                                      "app"
+                                                    ],
+                                                    properties: {
+                                                      app: {
+                                                        type: "string",
+                                                        minLength: 1,
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ],
+                                                        description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                      },
+                                                      window: {
+                                                        description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                        title: "App window selector",
+                                                        anyOf: [
+                                                          {
+                                                            title: "By index",
+                                                            type: "integer",
+                                                            description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                          },
+                                                          {
+                                                            title: "By name",
+                                                            type: "string",
+                                                            minLength: 1,
+                                                            pattern: "\\S",
+                                                            transform: [
+                                                              "trim"
+                                                            ],
+                                                            description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                          },
+                                                          {
+                                                            title: "By criteria",
+                                                            type: "object",
+                                                            additionalProperties: false,
+                                                            minProperties: 1,
+                                                            properties: {
+                                                              name: {
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                pattern: "\\S",
+                                                                transform: [
+                                                                  "trim"
+                                                                ],
+                                                                description: "Assigned window name."
+                                                              },
+                                                              index: {
+                                                                type: "integer",
+                                                                description: "Index in creation order. Negative counts from the end."
+                                                              },
+                                                              title: {
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                description: "Window title to match. Substring, or /regex/."
+                                                              }
+                                                            }
+                                                          }
+                                                        ]
+                                                      }
+                                                    }
                                                   }
                                                 ]
                                               },
@@ -181311,13 +181957,12 @@ var schemas_default = {
                                                       },
                                                       target: {
                                                         type: "string",
-                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                         enum: [
                                                           "display",
                                                           "window",
                                                           "viewport"
-                                                        ],
-                                                        default: "display"
+                                                        ]
                                                       },
                                                       fps: {
                                                         type: "integer",
@@ -181335,7 +181980,7 @@ var schemas_default = {
                                           {
                                             type: "boolean",
                                             title: "Record (boolean)",
-                                            description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                            description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                           }
                                         ],
                                         components: {
@@ -181353,7 +181998,7 @@ var schemas_default = {
                                               type: "object",
                                               properties: {
                                                 surface: {
-                                                  description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                  description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                   anyOf: [
                                                     {
                                                       title: "Surface (by browser engine)",
@@ -181503,6 +182148,72 @@ var schemas_default = {
                                                           ]
                                                         }
                                                       }
+                                                    },
+                                                    {
+                                                      title: "App surface",
+                                                      type: "object",
+                                                      additionalProperties: false,
+                                                      required: [
+                                                        "app"
+                                                      ],
+                                                      properties: {
+                                                        app: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ],
+                                                          description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                        },
+                                                        window: {
+                                                          description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                          title: "App window selector",
+                                                          anyOf: [
+                                                            {
+                                                              title: "By index",
+                                                              type: "integer",
+                                                              description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                            },
+                                                            {
+                                                              title: "By name",
+                                                              type: "string",
+                                                              minLength: 1,
+                                                              pattern: "\\S",
+                                                              transform: [
+                                                                "trim"
+                                                              ],
+                                                              description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                            },
+                                                            {
+                                                              title: "By criteria",
+                                                              type: "object",
+                                                              additionalProperties: false,
+                                                              minProperties: 1,
+                                                              properties: {
+                                                                name: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  pattern: "\\S",
+                                                                  transform: [
+                                                                    "trim"
+                                                                  ],
+                                                                  description: "Assigned window name."
+                                                                },
+                                                                index: {
+                                                                  type: "integer",
+                                                                  description: "Index in creation order. Negative counts from the end."
+                                                                },
+                                                                title: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  description: "Window title to match. Substring, or /regex/."
+                                                                }
+                                                              }
+                                                            }
+                                                          ]
+                                                        }
+                                                      }
                                                     }
                                                   ]
                                                 },
@@ -181568,13 +182279,12 @@ var schemas_default = {
                                                         },
                                                         target: {
                                                           type: "string",
-                                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                           enum: [
                                                             "display",
                                                             "window",
                                                             "viewport"
-                                                          ],
-                                                          default: "display"
+                                                          ]
                                                         },
                                                         fps: {
                                                           type: "integer",
@@ -181620,13 +182330,12 @@ var schemas_default = {
                                                     },
                                                     target: {
                                                       type: "string",
-                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                       enum: [
                                                         "display",
                                                         "window",
                                                         "viewport"
-                                                      ],
-                                                      default: "display"
+                                                      ]
                                                     },
                                                     fps: {
                                                       type: "integer",
@@ -181659,6 +182368,22 @@ var schemas_default = {
                                               target: "window",
                                               fps: 60
                                             }
+                                          },
+                                          {
+                                            path: "notepad.mp4",
+                                            surface: {
+                                              app: "notepad"
+                                            }
+                                          },
+                                          {
+                                            path: "full-screen.mp4",
+                                            surface: {
+                                              app: "notepad"
+                                            },
+                                            engine: {
+                                              name: "ffmpeg",
+                                              target: "display"
+                                            }
                                           }
                                         ]
                                       }
@@ -227436,7 +228161,7 @@ var schemas_default = {
                                         record: {
                                           $schema: "http://json-schema.org/draft-07/schema#",
                                           title: "record",
-                                          description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                          description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                           anyOf: [
                                             {
                                               title: "Record (simple)",
@@ -227451,7 +228176,7 @@ var schemas_default = {
                                               type: "object",
                                               properties: {
                                                 surface: {
-                                                  description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                  description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                   anyOf: [
                                                     {
                                                       title: "Surface (by browser engine)",
@@ -227601,6 +228326,72 @@ var schemas_default = {
                                                           ]
                                                         }
                                                       }
+                                                    },
+                                                    {
+                                                      title: "App surface",
+                                                      type: "object",
+                                                      additionalProperties: false,
+                                                      required: [
+                                                        "app"
+                                                      ],
+                                                      properties: {
+                                                        app: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ],
+                                                          description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                        },
+                                                        window: {
+                                                          description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                          title: "App window selector",
+                                                          anyOf: [
+                                                            {
+                                                              title: "By index",
+                                                              type: "integer",
+                                                              description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                            },
+                                                            {
+                                                              title: "By name",
+                                                              type: "string",
+                                                              minLength: 1,
+                                                              pattern: "\\S",
+                                                              transform: [
+                                                                "trim"
+                                                              ],
+                                                              description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                            },
+                                                            {
+                                                              title: "By criteria",
+                                                              type: "object",
+                                                              additionalProperties: false,
+                                                              minProperties: 1,
+                                                              properties: {
+                                                                name: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  pattern: "\\S",
+                                                                  transform: [
+                                                                    "trim"
+                                                                  ],
+                                                                  description: "Assigned window name."
+                                                                },
+                                                                index: {
+                                                                  type: "integer",
+                                                                  description: "Index in creation order. Negative counts from the end."
+                                                                },
+                                                                title: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  description: "Window title to match. Substring, or /regex/."
+                                                                }
+                                                              }
+                                                            }
+                                                          ]
+                                                        }
+                                                      }
                                                     }
                                                   ]
                                                 },
@@ -227666,13 +228457,12 @@ var schemas_default = {
                                                         },
                                                         target: {
                                                           type: "string",
-                                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                           enum: [
                                                             "display",
                                                             "window",
                                                             "viewport"
-                                                          ],
-                                                          default: "display"
+                                                          ]
                                                         },
                                                         fps: {
                                                           type: "integer",
@@ -227690,7 +228480,7 @@ var schemas_default = {
                                             {
                                               type: "boolean",
                                               title: "Record (boolean)",
-                                              description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                              description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                             }
                                           ],
                                           components: {
@@ -227708,7 +228498,7 @@ var schemas_default = {
                                                 type: "object",
                                                 properties: {
                                                   surface: {
-                                                    description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                    description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                     anyOf: [
                                                       {
                                                         title: "Surface (by browser engine)",
@@ -227805,14 +228595,85 @@ var schemas_default = {
                                                               }
                                                             ]
                                                           },
-                                                          tab: {
-                                                            description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
-                                                            title: "Window/tab selector",
+                                                          tab: {
+                                                            description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
+                                                            title: "Window/tab selector",
+                                                            anyOf: [
+                                                              {
+                                                                title: "By index",
+                                                                type: "integer",
+                                                                description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                                              },
+                                                              {
+                                                                title: "By name",
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                pattern: "\\S",
+                                                                transform: [
+                                                                  "trim"
+                                                                ],
+                                                                description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                              },
+                                                              {
+                                                                title: "By criteria",
+                                                                type: "object",
+                                                                additionalProperties: false,
+                                                                minProperties: 1,
+                                                                properties: {
+                                                                  name: {
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    pattern: "\\S",
+                                                                    transform: [
+                                                                      "trim"
+                                                                    ],
+                                                                    description: "Name assigned when the window/tab was opened."
+                                                                  },
+                                                                  index: {
+                                                                    type: "integer",
+                                                                    description: "Index in creation order. Negative counts from the end."
+                                                                  },
+                                                                  title: {
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    description: "Page title to match. Substring, or /regex/."
+                                                                  },
+                                                                  url: {
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    description: "Page URL to match. Substring, or /regex/."
+                                                                  }
+                                                                }
+                                                              }
+                                                            ]
+                                                          }
+                                                        }
+                                                      },
+                                                      {
+                                                        title: "App surface",
+                                                        type: "object",
+                                                        additionalProperties: false,
+                                                        required: [
+                                                          "app"
+                                                        ],
+                                                        properties: {
+                                                          app: {
+                                                            type: "string",
+                                                            minLength: 1,
+                                                            pattern: "\\S",
+                                                            transform: [
+                                                              "trim"
+                                                            ],
+                                                            description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                          },
+                                                          window: {
+                                                            description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                            title: "App window selector",
                                                             anyOf: [
                                                               {
                                                                 title: "By index",
                                                                 type: "integer",
-                                                                description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                                                description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
                                                               },
                                                               {
                                                                 title: "By name",
@@ -227822,7 +228683,7 @@ var schemas_default = {
                                                                 transform: [
                                                                   "trim"
                                                                 ],
-                                                                description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
                                                               },
                                                               {
                                                                 title: "By criteria",
@@ -227837,7 +228698,7 @@ var schemas_default = {
                                                                     transform: [
                                                                       "trim"
                                                                     ],
-                                                                    description: "Name assigned when the window/tab was opened."
+                                                                    description: "Assigned window name."
                                                                   },
                                                                   index: {
                                                                     type: "integer",
@@ -227846,12 +228707,7 @@ var schemas_default = {
                                                                   title: {
                                                                     type: "string",
                                                                     minLength: 1,
-                                                                    description: "Page title to match. Substring, or /regex/."
-                                                                  },
-                                                                  url: {
-                                                                    type: "string",
-                                                                    minLength: 1,
-                                                                    description: "Page URL to match. Substring, or /regex/."
+                                                                    description: "Window title to match. Substring, or /regex/."
                                                                   }
                                                                 }
                                                               }
@@ -227923,13 +228779,12 @@ var schemas_default = {
                                                           },
                                                           target: {
                                                             type: "string",
-                                                            description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                            description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                             enum: [
                                                               "display",
                                                               "window",
                                                               "viewport"
-                                                            ],
-                                                            default: "display"
+                                                            ]
                                                           },
                                                           fps: {
                                                             type: "integer",
@@ -227975,13 +228830,12 @@ var schemas_default = {
                                                       },
                                                       target: {
                                                         type: "string",
-                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                         enum: [
                                                           "display",
                                                           "window",
                                                           "viewport"
-                                                        ],
-                                                        default: "display"
+                                                        ]
                                                       },
                                                       fps: {
                                                         type: "integer",
@@ -228014,6 +228868,22 @@ var schemas_default = {
                                                 target: "window",
                                                 fps: 60
                                               }
+                                            },
+                                            {
+                                              path: "notepad.mp4",
+                                              surface: {
+                                                app: "notepad"
+                                              }
+                                            },
+                                            {
+                                              path: "full-screen.mp4",
+                                              surface: {
+                                                app: "notepad"
+                                              },
+                                              engine: {
+                                                name: "ffmpeg",
+                                                target: "display"
+                                              }
                                             }
                                           ]
                                         }
@@ -271317,7 +272187,7 @@ var schemas_default = {
                                               record: {
                                                 $schema: "http://json-schema.org/draft-07/schema#",
                                                 title: "record",
-                                                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                                 anyOf: [
                                                   {
                                                     title: "Record (simple)",
@@ -271332,7 +272202,7 @@ var schemas_default = {
                                                     type: "object",
                                                     properties: {
                                                       surface: {
-                                                        description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                        description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                         anyOf: [
                                                           {
                                                             title: "Surface (by browser engine)",
@@ -271482,6 +272352,72 @@ var schemas_default = {
                                                                 ]
                                                               }
                                                             }
+                                                          },
+                                                          {
+                                                            title: "App surface",
+                                                            type: "object",
+                                                            additionalProperties: false,
+                                                            required: [
+                                                              "app"
+                                                            ],
+                                                            properties: {
+                                                              app: {
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                pattern: "\\S",
+                                                                transform: [
+                                                                  "trim"
+                                                                ],
+                                                                description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                              },
+                                                              window: {
+                                                                description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                title: "App window selector",
+                                                                anyOf: [
+                                                                  {
+                                                                    title: "By index",
+                                                                    type: "integer",
+                                                                    description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                  },
+                                                                  {
+                                                                    title: "By name",
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    pattern: "\\S",
+                                                                    transform: [
+                                                                      "trim"
+                                                                    ],
+                                                                    description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                  },
+                                                                  {
+                                                                    title: "By criteria",
+                                                                    type: "object",
+                                                                    additionalProperties: false,
+                                                                    minProperties: 1,
+                                                                    properties: {
+                                                                      name: {
+                                                                        type: "string",
+                                                                        minLength: 1,
+                                                                        pattern: "\\S",
+                                                                        transform: [
+                                                                          "trim"
+                                                                        ],
+                                                                        description: "Assigned window name."
+                                                                      },
+                                                                      index: {
+                                                                        type: "integer",
+                                                                        description: "Index in creation order. Negative counts from the end."
+                                                                      },
+                                                                      title: {
+                                                                        type: "string",
+                                                                        minLength: 1,
+                                                                        description: "Window title to match. Substring, or /regex/."
+                                                                      }
+                                                                    }
+                                                                  }
+                                                                ]
+                                                              }
+                                                            }
                                                           }
                                                         ]
                                                       },
@@ -271547,13 +272483,12 @@ var schemas_default = {
                                                               },
                                                               target: {
                                                                 type: "string",
-                                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                 enum: [
                                                                   "display",
                                                                   "window",
                                                                   "viewport"
-                                                                ],
-                                                                default: "display"
+                                                                ]
                                                               },
                                                               fps: {
                                                                 type: "integer",
@@ -271571,7 +272506,7 @@ var schemas_default = {
                                                   {
                                                     type: "boolean",
                                                     title: "Record (boolean)",
-                                                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                                   }
                                                 ],
                                                 components: {
@@ -271589,7 +272524,7 @@ var schemas_default = {
                                                       type: "object",
                                                       properties: {
                                                         surface: {
-                                                          description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                          description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                           anyOf: [
                                                             {
                                                               title: "Surface (by browser engine)",
@@ -271739,6 +272674,72 @@ var schemas_default = {
                                                                   ]
                                                                 }
                                                               }
+                                                            },
+                                                            {
+                                                              title: "App surface",
+                                                              type: "object",
+                                                              additionalProperties: false,
+                                                              required: [
+                                                                "app"
+                                                              ],
+                                                              properties: {
+                                                                app: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  pattern: "\\S",
+                                                                  transform: [
+                                                                    "trim"
+                                                                  ],
+                                                                  description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                                },
+                                                                window: {
+                                                                  description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                  title: "App window selector",
+                                                                  anyOf: [
+                                                                    {
+                                                                      title: "By index",
+                                                                      type: "integer",
+                                                                      description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                    },
+                                                                    {
+                                                                      title: "By name",
+                                                                      type: "string",
+                                                                      minLength: 1,
+                                                                      pattern: "\\S",
+                                                                      transform: [
+                                                                        "trim"
+                                                                      ],
+                                                                      description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                    },
+                                                                    {
+                                                                      title: "By criteria",
+                                                                      type: "object",
+                                                                      additionalProperties: false,
+                                                                      minProperties: 1,
+                                                                      properties: {
+                                                                        name: {
+                                                                          type: "string",
+                                                                          minLength: 1,
+                                                                          pattern: "\\S",
+                                                                          transform: [
+                                                                            "trim"
+                                                                          ],
+                                                                          description: "Assigned window name."
+                                                                        },
+                                                                        index: {
+                                                                          type: "integer",
+                                                                          description: "Index in creation order. Negative counts from the end."
+                                                                        },
+                                                                        title: {
+                                                                          type: "string",
+                                                                          minLength: 1,
+                                                                          description: "Window title to match. Substring, or /regex/."
+                                                                        }
+                                                                      }
+                                                                    }
+                                                                  ]
+                                                                }
+                                                              }
                                                             }
                                                           ]
                                                         },
@@ -271804,13 +272805,12 @@ var schemas_default = {
                                                                 },
                                                                 target: {
                                                                   type: "string",
-                                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                   enum: [
                                                                     "display",
                                                                     "window",
                                                                     "viewport"
-                                                                  ],
-                                                                  default: "display"
+                                                                  ]
                                                                 },
                                                                 fps: {
                                                                   type: "integer",
@@ -271856,13 +272856,12 @@ var schemas_default = {
                                                             },
                                                             target: {
                                                               type: "string",
-                                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                               enum: [
                                                                 "display",
                                                                 "window",
                                                                 "viewport"
-                                                              ],
-                                                              default: "display"
+                                                              ]
                                                             },
                                                             fps: {
                                                               type: "integer",
@@ -271895,6 +272894,22 @@ var schemas_default = {
                                                       target: "window",
                                                       fps: 60
                                                     }
+                                                  },
+                                                  {
+                                                    path: "notepad.mp4",
+                                                    surface: {
+                                                      app: "notepad"
+                                                    }
+                                                  },
+                                                  {
+                                                    path: "full-screen.mp4",
+                                                    surface: {
+                                                      app: "notepad"
+                                                    },
+                                                    engine: {
+                                                      name: "ffmpeg",
+                                                      target: "display"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -318159,7 +319174,7 @@ var schemas_default = {
                                         record: {
                                           $schema: "http://json-schema.org/draft-07/schema#",
                                           title: "record",
-                                          description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                          description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                           anyOf: [
                                             {
                                               title: "Record (simple)",
@@ -318174,7 +319189,7 @@ var schemas_default = {
                                               type: "object",
                                               properties: {
                                                 surface: {
-                                                  description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                  description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                   anyOf: [
                                                     {
                                                       title: "Surface (by browser engine)",
@@ -318271,14 +319286,85 @@ var schemas_default = {
                                                             }
                                                           ]
                                                         },
-                                                        tab: {
-                                                          description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
-                                                          title: "Window/tab selector",
+                                                        tab: {
+                                                          description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
+                                                          title: "Window/tab selector",
+                                                          anyOf: [
+                                                            {
+                                                              title: "By index",
+                                                              type: "integer",
+                                                              description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                                            },
+                                                            {
+                                                              title: "By name",
+                                                              type: "string",
+                                                              minLength: 1,
+                                                              pattern: "\\S",
+                                                              transform: [
+                                                                "trim"
+                                                              ],
+                                                              description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                            },
+                                                            {
+                                                              title: "By criteria",
+                                                              type: "object",
+                                                              additionalProperties: false,
+                                                              minProperties: 1,
+                                                              properties: {
+                                                                name: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  pattern: "\\S",
+                                                                  transform: [
+                                                                    "trim"
+                                                                  ],
+                                                                  description: "Name assigned when the window/tab was opened."
+                                                                },
+                                                                index: {
+                                                                  type: "integer",
+                                                                  description: "Index in creation order. Negative counts from the end."
+                                                                },
+                                                                title: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  description: "Page title to match. Substring, or /regex/."
+                                                                },
+                                                                url: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  description: "Page URL to match. Substring, or /regex/."
+                                                                }
+                                                              }
+                                                            }
+                                                          ]
+                                                        }
+                                                      }
+                                                    },
+                                                    {
+                                                      title: "App surface",
+                                                      type: "object",
+                                                      additionalProperties: false,
+                                                      required: [
+                                                        "app"
+                                                      ],
+                                                      properties: {
+                                                        app: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ],
+                                                          description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                        },
+                                                        window: {
+                                                          description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                          title: "App window selector",
                                                           anyOf: [
                                                             {
                                                               title: "By index",
                                                               type: "integer",
-                                                              description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                                              description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
                                                             },
                                                             {
                                                               title: "By name",
@@ -318288,7 +319374,7 @@ var schemas_default = {
                                                               transform: [
                                                                 "trim"
                                                               ],
-                                                              description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                              description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
                                                             },
                                                             {
                                                               title: "By criteria",
@@ -318303,7 +319389,7 @@ var schemas_default = {
                                                                   transform: [
                                                                     "trim"
                                                                   ],
-                                                                  description: "Name assigned when the window/tab was opened."
+                                                                  description: "Assigned window name."
                                                                 },
                                                                 index: {
                                                                   type: "integer",
@@ -318312,12 +319398,7 @@ var schemas_default = {
                                                                 title: {
                                                                   type: "string",
                                                                   minLength: 1,
-                                                                  description: "Page title to match. Substring, or /regex/."
-                                                                },
-                                                                url: {
-                                                                  type: "string",
-                                                                  minLength: 1,
-                                                                  description: "Page URL to match. Substring, or /regex/."
+                                                                  description: "Window title to match. Substring, or /regex/."
                                                                 }
                                                               }
                                                             }
@@ -318389,13 +319470,12 @@ var schemas_default = {
                                                         },
                                                         target: {
                                                           type: "string",
-                                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                           enum: [
                                                             "display",
                                                             "window",
                                                             "viewport"
-                                                          ],
-                                                          default: "display"
+                                                          ]
                                                         },
                                                         fps: {
                                                           type: "integer",
@@ -318413,7 +319493,7 @@ var schemas_default = {
                                             {
                                               type: "boolean",
                                               title: "Record (boolean)",
-                                              description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                              description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                             }
                                           ],
                                           components: {
@@ -318431,7 +319511,7 @@ var schemas_default = {
                                                 type: "object",
                                                 properties: {
                                                   surface: {
-                                                    description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                    description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                     anyOf: [
                                                       {
                                                         title: "Surface (by browser engine)",
@@ -318581,6 +319661,72 @@ var schemas_default = {
                                                             ]
                                                           }
                                                         }
+                                                      },
+                                                      {
+                                                        title: "App surface",
+                                                        type: "object",
+                                                        additionalProperties: false,
+                                                        required: [
+                                                          "app"
+                                                        ],
+                                                        properties: {
+                                                          app: {
+                                                            type: "string",
+                                                            minLength: 1,
+                                                            pattern: "\\S",
+                                                            transform: [
+                                                              "trim"
+                                                            ],
+                                                            description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                          },
+                                                          window: {
+                                                            description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                            title: "App window selector",
+                                                            anyOf: [
+                                                              {
+                                                                title: "By index",
+                                                                type: "integer",
+                                                                description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                              },
+                                                              {
+                                                                title: "By name",
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                pattern: "\\S",
+                                                                transform: [
+                                                                  "trim"
+                                                                ],
+                                                                description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                              },
+                                                              {
+                                                                title: "By criteria",
+                                                                type: "object",
+                                                                additionalProperties: false,
+                                                                minProperties: 1,
+                                                                properties: {
+                                                                  name: {
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    pattern: "\\S",
+                                                                    transform: [
+                                                                      "trim"
+                                                                    ],
+                                                                    description: "Assigned window name."
+                                                                  },
+                                                                  index: {
+                                                                    type: "integer",
+                                                                    description: "Index in creation order. Negative counts from the end."
+                                                                  },
+                                                                  title: {
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    description: "Window title to match. Substring, or /regex/."
+                                                                  }
+                                                                }
+                                                              }
+                                                            ]
+                                                          }
+                                                        }
                                                       }
                                                     ]
                                                   },
@@ -318646,13 +319792,12 @@ var schemas_default = {
                                                           },
                                                           target: {
                                                             type: "string",
-                                                            description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                            description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                             enum: [
                                                               "display",
                                                               "window",
                                                               "viewport"
-                                                            ],
-                                                            default: "display"
+                                                            ]
                                                           },
                                                           fps: {
                                                             type: "integer",
@@ -318698,13 +319843,12 @@ var schemas_default = {
                                                       },
                                                       target: {
                                                         type: "string",
-                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                         enum: [
                                                           "display",
                                                           "window",
                                                           "viewport"
-                                                        ],
-                                                        default: "display"
+                                                        ]
                                                       },
                                                       fps: {
                                                         type: "integer",
@@ -318737,6 +319881,22 @@ var schemas_default = {
                                                 target: "window",
                                                 fps: 60
                                               }
+                                            },
+                                            {
+                                              path: "notepad.mp4",
+                                              surface: {
+                                                app: "notepad"
+                                              }
+                                            },
+                                            {
+                                              path: "full-screen.mp4",
+                                              surface: {
+                                                app: "notepad"
+                                              },
+                                              engine: {
+                                                name: "ffmpeg",
+                                                target: "display"
+                                              }
                                             }
                                           ]
                                         }
@@ -362040,7 +363200,7 @@ var schemas_default = {
                                               record: {
                                                 $schema: "http://json-schema.org/draft-07/schema#",
                                                 title: "record",
-                                                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                                 anyOf: [
                                                   {
                                                     title: "Record (simple)",
@@ -362055,7 +363215,7 @@ var schemas_default = {
                                                     type: "object",
                                                     properties: {
                                                       surface: {
-                                                        description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                        description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                         anyOf: [
                                                           {
                                                             title: "Surface (by browser engine)",
@@ -362205,6 +363365,72 @@ var schemas_default = {
                                                                 ]
                                                               }
                                                             }
+                                                          },
+                                                          {
+                                                            title: "App surface",
+                                                            type: "object",
+                                                            additionalProperties: false,
+                                                            required: [
+                                                              "app"
+                                                            ],
+                                                            properties: {
+                                                              app: {
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                pattern: "\\S",
+                                                                transform: [
+                                                                  "trim"
+                                                                ],
+                                                                description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                              },
+                                                              window: {
+                                                                description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                title: "App window selector",
+                                                                anyOf: [
+                                                                  {
+                                                                    title: "By index",
+                                                                    type: "integer",
+                                                                    description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                  },
+                                                                  {
+                                                                    title: "By name",
+                                                                    type: "string",
+                                                                    minLength: 1,
+                                                                    pattern: "\\S",
+                                                                    transform: [
+                                                                      "trim"
+                                                                    ],
+                                                                    description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                  },
+                                                                  {
+                                                                    title: "By criteria",
+                                                                    type: "object",
+                                                                    additionalProperties: false,
+                                                                    minProperties: 1,
+                                                                    properties: {
+                                                                      name: {
+                                                                        type: "string",
+                                                                        minLength: 1,
+                                                                        pattern: "\\S",
+                                                                        transform: [
+                                                                          "trim"
+                                                                        ],
+                                                                        description: "Assigned window name."
+                                                                      },
+                                                                      index: {
+                                                                        type: "integer",
+                                                                        description: "Index in creation order. Negative counts from the end."
+                                                                      },
+                                                                      title: {
+                                                                        type: "string",
+                                                                        minLength: 1,
+                                                                        description: "Window title to match. Substring, or /regex/."
+                                                                      }
+                                                                    }
+                                                                  }
+                                                                ]
+                                                              }
+                                                            }
                                                           }
                                                         ]
                                                       },
@@ -362270,13 +363496,12 @@ var schemas_default = {
                                                               },
                                                               target: {
                                                                 type: "string",
-                                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                 enum: [
                                                                   "display",
                                                                   "window",
                                                                   "viewport"
-                                                                ],
-                                                                default: "display"
+                                                                ]
                                                               },
                                                               fps: {
                                                                 type: "integer",
@@ -362294,7 +363519,7 @@ var schemas_default = {
                                                   {
                                                     type: "boolean",
                                                     title: "Record (boolean)",
-                                                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                                   }
                                                 ],
                                                 components: {
@@ -362312,7 +363537,7 @@ var schemas_default = {
                                                       type: "object",
                                                       properties: {
                                                         surface: {
-                                                          description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                          description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                           anyOf: [
                                                             {
                                                               title: "Surface (by browser engine)",
@@ -362462,6 +363687,72 @@ var schemas_default = {
                                                                   ]
                                                                 }
                                                               }
+                                                            },
+                                                            {
+                                                              title: "App surface",
+                                                              type: "object",
+                                                              additionalProperties: false,
+                                                              required: [
+                                                                "app"
+                                                              ],
+                                                              properties: {
+                                                                app: {
+                                                                  type: "string",
+                                                                  minLength: 1,
+                                                                  pattern: "\\S",
+                                                                  transform: [
+                                                                    "trim"
+                                                                  ],
+                                                                  description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                                },
+                                                                window: {
+                                                                  description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                                  title: "App window selector",
+                                                                  anyOf: [
+                                                                    {
+                                                                      title: "By index",
+                                                                      type: "integer",
+                                                                      description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                                    },
+                                                                    {
+                                                                      title: "By name",
+                                                                      type: "string",
+                                                                      minLength: 1,
+                                                                      pattern: "\\S",
+                                                                      transform: [
+                                                                        "trim"
+                                                                      ],
+                                                                      description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                                    },
+                                                                    {
+                                                                      title: "By criteria",
+                                                                      type: "object",
+                                                                      additionalProperties: false,
+                                                                      minProperties: 1,
+                                                                      properties: {
+                                                                        name: {
+                                                                          type: "string",
+                                                                          minLength: 1,
+                                                                          pattern: "\\S",
+                                                                          transform: [
+                                                                            "trim"
+                                                                          ],
+                                                                          description: "Assigned window name."
+                                                                        },
+                                                                        index: {
+                                                                          type: "integer",
+                                                                          description: "Index in creation order. Negative counts from the end."
+                                                                        },
+                                                                        title: {
+                                                                          type: "string",
+                                                                          minLength: 1,
+                                                                          description: "Window title to match. Substring, or /regex/."
+                                                                        }
+                                                                      }
+                                                                    }
+                                                                  ]
+                                                                }
+                                                              }
                                                             }
                                                           ]
                                                         },
@@ -362527,13 +363818,12 @@ var schemas_default = {
                                                                 },
                                                                 target: {
                                                                   type: "string",
-                                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                                   enum: [
                                                                     "display",
                                                                     "window",
                                                                     "viewport"
-                                                                  ],
-                                                                  default: "display"
+                                                                  ]
                                                                 },
                                                                 fps: {
                                                                   type: "integer",
@@ -362579,13 +363869,12 @@ var schemas_default = {
                                                             },
                                                             target: {
                                                               type: "string",
-                                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                               enum: [
                                                                 "display",
                                                                 "window",
                                                                 "viewport"
-                                                              ],
-                                                              default: "display"
+                                                              ]
                                                             },
                                                             fps: {
                                                               type: "integer",
@@ -362618,6 +363907,22 @@ var schemas_default = {
                                                       target: "window",
                                                       fps: 60
                                                     }
+                                                  },
+                                                  {
+                                                    path: "notepad.mp4",
+                                                    surface: {
+                                                      app: "notepad"
+                                                    }
+                                                  },
+                                                  {
+                                                    path: "full-screen.mp4",
+                                                    surface: {
+                                                      app: "notepad"
+                                                    },
+                                                    engine: {
+                                                      name: "ffmpeg",
+                                                      target: "display"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -412095,7 +413400,7 @@ var schemas_default = {
                               record: {
                                 $schema: "http://json-schema.org/draft-07/schema#",
                                 title: "record",
-                                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                 anyOf: [
                                   {
                                     title: "Record (simple)",
@@ -412110,7 +413415,7 @@ var schemas_default = {
                                     type: "object",
                                     properties: {
                                       surface: {
-                                        description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                        description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                         anyOf: [
                                           {
                                             title: "Surface (by browser engine)",
@@ -412260,6 +413565,72 @@ var schemas_default = {
                                                 ]
                                               }
                                             }
+                                          },
+                                          {
+                                            title: "App surface",
+                                            type: "object",
+                                            additionalProperties: false,
+                                            required: [
+                                              "app"
+                                            ],
+                                            properties: {
+                                              app: {
+                                                type: "string",
+                                                minLength: 1,
+                                                pattern: "\\S",
+                                                transform: [
+                                                  "trim"
+                                                ],
+                                                description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                              },
+                                              window: {
+                                                description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                title: "App window selector",
+                                                anyOf: [
+                                                  {
+                                                    title: "By index",
+                                                    type: "integer",
+                                                    description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                  },
+                                                  {
+                                                    title: "By name",
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "\\S",
+                                                    transform: [
+                                                      "trim"
+                                                    ],
+                                                    description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                  },
+                                                  {
+                                                    title: "By criteria",
+                                                    type: "object",
+                                                    additionalProperties: false,
+                                                    minProperties: 1,
+                                                    properties: {
+                                                      name: {
+                                                        type: "string",
+                                                        minLength: 1,
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ],
+                                                        description: "Assigned window name."
+                                                      },
+                                                      index: {
+                                                        type: "integer",
+                                                        description: "Index in creation order. Negative counts from the end."
+                                                      },
+                                                      title: {
+                                                        type: "string",
+                                                        minLength: 1,
+                                                        description: "Window title to match. Substring, or /regex/."
+                                                      }
+                                                    }
+                                                  }
+                                                ]
+                                              }
+                                            }
                                           }
                                         ]
                                       },
@@ -412325,13 +413696,12 @@ var schemas_default = {
                                               },
                                               target: {
                                                 type: "string",
-                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                 enum: [
                                                   "display",
                                                   "window",
                                                   "viewport"
-                                                ],
-                                                default: "display"
+                                                ]
                                               },
                                               fps: {
                                                 type: "integer",
@@ -412349,7 +413719,7 @@ var schemas_default = {
                                   {
                                     type: "boolean",
                                     title: "Record (boolean)",
-                                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                   }
                                 ],
                                 components: {
@@ -412367,7 +413737,7 @@ var schemas_default = {
                                       type: "object",
                                       properties: {
                                         surface: {
-                                          description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                          description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                           anyOf: [
                                             {
                                               title: "Surface (by browser engine)",
@@ -412517,6 +413887,72 @@ var schemas_default = {
                                                   ]
                                                 }
                                               }
+                                            },
+                                            {
+                                              title: "App surface",
+                                              type: "object",
+                                              additionalProperties: false,
+                                              required: [
+                                                "app"
+                                              ],
+                                              properties: {
+                                                app: {
+                                                  type: "string",
+                                                  minLength: 1,
+                                                  pattern: "\\S",
+                                                  transform: [
+                                                    "trim"
+                                                  ],
+                                                  description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                },
+                                                window: {
+                                                  description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                  title: "App window selector",
+                                                  anyOf: [
+                                                    {
+                                                      title: "By index",
+                                                      type: "integer",
+                                                      description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                    },
+                                                    {
+                                                      title: "By name",
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "\\S",
+                                                      transform: [
+                                                        "trim"
+                                                      ],
+                                                      description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                    },
+                                                    {
+                                                      title: "By criteria",
+                                                      type: "object",
+                                                      additionalProperties: false,
+                                                      minProperties: 1,
+                                                      properties: {
+                                                        name: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ],
+                                                          description: "Assigned window name."
+                                                        },
+                                                        index: {
+                                                          type: "integer",
+                                                          description: "Index in creation order. Negative counts from the end."
+                                                        },
+                                                        title: {
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          description: "Window title to match. Substring, or /regex/."
+                                                        }
+                                                      }
+                                                    }
+                                                  ]
+                                                }
+                                              }
                                             }
                                           ]
                                         },
@@ -412582,13 +414018,12 @@ var schemas_default = {
                                                 },
                                                 target: {
                                                   type: "string",
-                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                   enum: [
                                                     "display",
                                                     "window",
                                                     "viewport"
-                                                  ],
-                                                  default: "display"
+                                                  ]
                                                 },
                                                 fps: {
                                                   type: "integer",
@@ -412634,13 +414069,12 @@ var schemas_default = {
                                             },
                                             target: {
                                               type: "string",
-                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                               enum: [
                                                 "display",
                                                 "window",
                                                 "viewport"
-                                              ],
-                                              default: "display"
+                                              ]
                                             },
                                             fps: {
                                               type: "integer",
@@ -412673,6 +414107,22 @@ var schemas_default = {
                                       target: "window",
                                       fps: 60
                                     }
+                                  },
+                                  {
+                                    path: "notepad.mp4",
+                                    surface: {
+                                      app: "notepad"
+                                    }
+                                  },
+                                  {
+                                    path: "full-screen.mp4",
+                                    surface: {
+                                      app: "notepad"
+                                    },
+                                    engine: {
+                                      name: "ffmpeg",
+                                      target: "display"
+                                    }
                                   }
                                 ]
                               }
@@ -455976,7 +457426,7 @@ var schemas_default = {
                                     record: {
                                       $schema: "http://json-schema.org/draft-07/schema#",
                                       title: "record",
-                                      description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                      description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                                       anyOf: [
                                         {
                                           title: "Record (simple)",
@@ -455991,7 +457441,7 @@ var schemas_default = {
                                           type: "object",
                                           properties: {
                                             surface: {
-                                              description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                              description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                               anyOf: [
                                                 {
                                                   title: "Surface (by browser engine)",
@@ -456141,6 +457591,72 @@ var schemas_default = {
                                                       ]
                                                     }
                                                   }
+                                                },
+                                                {
+                                                  title: "App surface",
+                                                  type: "object",
+                                                  additionalProperties: false,
+                                                  required: [
+                                                    "app"
+                                                  ],
+                                                  properties: {
+                                                    app: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "\\S",
+                                                      transform: [
+                                                        "trim"
+                                                      ],
+                                                      description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                    },
+                                                    window: {
+                                                      description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                      title: "App window selector",
+                                                      anyOf: [
+                                                        {
+                                                          title: "By index",
+                                                          type: "integer",
+                                                          description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                        },
+                                                        {
+                                                          title: "By name",
+                                                          type: "string",
+                                                          minLength: 1,
+                                                          pattern: "\\S",
+                                                          transform: [
+                                                            "trim"
+                                                          ],
+                                                          description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                        },
+                                                        {
+                                                          title: "By criteria",
+                                                          type: "object",
+                                                          additionalProperties: false,
+                                                          minProperties: 1,
+                                                          properties: {
+                                                            name: {
+                                                              type: "string",
+                                                              minLength: 1,
+                                                              pattern: "\\S",
+                                                              transform: [
+                                                                "trim"
+                                                              ],
+                                                              description: "Assigned window name."
+                                                            },
+                                                            index: {
+                                                              type: "integer",
+                                                              description: "Index in creation order. Negative counts from the end."
+                                                            },
+                                                            title: {
+                                                              type: "string",
+                                                              minLength: 1,
+                                                              description: "Window title to match. Substring, or /regex/."
+                                                            }
+                                                          }
+                                                        }
+                                                      ]
+                                                    }
+                                                  }
                                                 }
                                               ]
                                             },
@@ -456206,13 +457722,12 @@ var schemas_default = {
                                                     },
                                                     target: {
                                                       type: "string",
-                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                       enum: [
                                                         "display",
                                                         "window",
                                                         "viewport"
-                                                      ],
-                                                      default: "display"
+                                                      ]
                                                     },
                                                     fps: {
                                                       type: "integer",
@@ -456230,7 +457745,7 @@ var schemas_default = {
                                         {
                                           type: "boolean",
                                           title: "Record (boolean)",
-                                          description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                          description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                                         }
                                       ],
                                       components: {
@@ -456248,7 +457763,7 @@ var schemas_default = {
                                             type: "object",
                                             properties: {
                                               surface: {
-                                                description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                                description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                                 anyOf: [
                                                   {
                                                     title: "Surface (by browser engine)",
@@ -456345,14 +457860,85 @@ var schemas_default = {
                                                           }
                                                         ]
                                                       },
-                                                      tab: {
-                                                        description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
-                                                        title: "Window/tab selector",
+                                                      tab: {
+                                                        description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
+                                                        title: "Window/tab selector",
+                                                        anyOf: [
+                                                          {
+                                                            title: "By index",
+                                                            type: "integer",
+                                                            description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                                          },
+                                                          {
+                                                            title: "By name",
+                                                            type: "string",
+                                                            minLength: 1,
+                                                            pattern: "\\S",
+                                                            transform: [
+                                                              "trim"
+                                                            ],
+                                                            description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                          },
+                                                          {
+                                                            title: "By criteria",
+                                                            type: "object",
+                                                            additionalProperties: false,
+                                                            minProperties: 1,
+                                                            properties: {
+                                                              name: {
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                pattern: "\\S",
+                                                                transform: [
+                                                                  "trim"
+                                                                ],
+                                                                description: "Name assigned when the window/tab was opened."
+                                                              },
+                                                              index: {
+                                                                type: "integer",
+                                                                description: "Index in creation order. Negative counts from the end."
+                                                              },
+                                                              title: {
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                description: "Page title to match. Substring, or /regex/."
+                                                              },
+                                                              url: {
+                                                                type: "string",
+                                                                minLength: 1,
+                                                                description: "Page URL to match. Substring, or /regex/."
+                                                              }
+                                                            }
+                                                          }
+                                                        ]
+                                                      }
+                                                    }
+                                                  },
+                                                  {
+                                                    title: "App surface",
+                                                    type: "object",
+                                                    additionalProperties: false,
+                                                    required: [
+                                                      "app"
+                                                    ],
+                                                    properties: {
+                                                      app: {
+                                                        type: "string",
+                                                        minLength: 1,
+                                                        pattern: "\\S",
+                                                        transform: [
+                                                          "trim"
+                                                        ],
+                                                        description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                                      },
+                                                      window: {
+                                                        description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                                        title: "App window selector",
                                                         anyOf: [
                                                           {
                                                             title: "By index",
                                                             type: "integer",
-                                                            description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                                            description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
                                                           },
                                                           {
                                                             title: "By name",
@@ -456362,7 +457948,7 @@ var schemas_default = {
                                                             transform: [
                                                               "trim"
                                                             ],
-                                                            description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                            description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
                                                           },
                                                           {
                                                             title: "By criteria",
@@ -456377,7 +457963,7 @@ var schemas_default = {
                                                                 transform: [
                                                                   "trim"
                                                                 ],
-                                                                description: "Name assigned when the window/tab was opened."
+                                                                description: "Assigned window name."
                                                               },
                                                               index: {
                                                                 type: "integer",
@@ -456386,12 +457972,7 @@ var schemas_default = {
                                                               title: {
                                                                 type: "string",
                                                                 minLength: 1,
-                                                                description: "Page title to match. Substring, or /regex/."
-                                                              },
-                                                              url: {
-                                                                type: "string",
-                                                                minLength: 1,
-                                                                description: "Page URL to match. Substring, or /regex/."
+                                                                description: "Window title to match. Substring, or /regex/."
                                                               }
                                                             }
                                                           }
@@ -456463,13 +458044,12 @@ var schemas_default = {
                                                       },
                                                       target: {
                                                         type: "string",
-                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                         enum: [
                                                           "display",
                                                           "window",
                                                           "viewport"
-                                                        ],
-                                                        default: "display"
+                                                        ]
                                                       },
                                                       fps: {
                                                         type: "integer",
@@ -456515,13 +458095,12 @@ var schemas_default = {
                                                   },
                                                   target: {
                                                     type: "string",
-                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                                     enum: [
                                                       "display",
                                                       "window",
                                                       "viewport"
-                                                    ],
-                                                    default: "display"
+                                                    ]
                                                   },
                                                   fps: {
                                                     type: "integer",
@@ -456554,6 +458133,22 @@ var schemas_default = {
                                             target: "window",
                                             fps: 60
                                           }
+                                        },
+                                        {
+                                          path: "notepad.mp4",
+                                          surface: {
+                                            app: "notepad"
+                                          }
+                                        },
+                                        {
+                                          path: "full-screen.mp4",
+                                          surface: {
+                                            app: "notepad"
+                                          },
+                                          engine: {
+                                            name: "ffmpeg",
+                                            target: "display"
+                                          }
                                         }
                                       ]
                                     }
@@ -500743,7 +502338,7 @@ var schemas_default = {
               record: {
                 $schema: "http://json-schema.org/draft-07/schema#",
                 title: "record",
-                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                 anyOf: [
                   {
                     title: "Record (simple)",
@@ -500758,7 +502353,7 @@ var schemas_default = {
                     type: "object",
                     properties: {
                       surface: {
-                        description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                        description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                         anyOf: [
                           {
                             title: "Surface (by browser engine)",
@@ -500908,6 +502503,72 @@ var schemas_default = {
                                 ]
                               }
                             }
+                          },
+                          {
+                            title: "App surface",
+                            type: "object",
+                            additionalProperties: false,
+                            required: [
+                              "app"
+                            ],
+                            properties: {
+                              app: {
+                                type: "string",
+                                minLength: 1,
+                                pattern: "\\S",
+                                transform: [
+                                  "trim"
+                                ],
+                                description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                              },
+                              window: {
+                                description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                title: "App window selector",
+                                anyOf: [
+                                  {
+                                    title: "By index",
+                                    type: "integer",
+                                    description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                  },
+                                  {
+                                    title: "By name",
+                                    type: "string",
+                                    minLength: 1,
+                                    pattern: "\\S",
+                                    transform: [
+                                      "trim"
+                                    ],
+                                    description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                  },
+                                  {
+                                    title: "By criteria",
+                                    type: "object",
+                                    additionalProperties: false,
+                                    minProperties: 1,
+                                    properties: {
+                                      name: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "\\S",
+                                        transform: [
+                                          "trim"
+                                        ],
+                                        description: "Assigned window name."
+                                      },
+                                      index: {
+                                        type: "integer",
+                                        description: "Index in creation order. Negative counts from the end."
+                                      },
+                                      title: {
+                                        type: "string",
+                                        minLength: 1,
+                                        description: "Window title to match. Substring, or /regex/."
+                                      }
+                                    }
+                                  }
+                                ]
+                              }
+                            }
                           }
                         ]
                       },
@@ -500973,13 +502634,12 @@ var schemas_default = {
                               },
                               target: {
                                 type: "string",
-                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                 enum: [
                                   "display",
                                   "window",
                                   "viewport"
-                                ],
-                                default: "display"
+                                ]
                               },
                               fps: {
                                 type: "integer",
@@ -500997,7 +502657,7 @@ var schemas_default = {
                   {
                     type: "boolean",
                     title: "Record (boolean)",
-                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                    description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                   }
                 ],
                 components: {
@@ -501015,7 +502675,7 @@ var schemas_default = {
                       type: "object",
                       properties: {
                         surface: {
-                          description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                          description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                           anyOf: [
                             {
                               title: "Surface (by browser engine)",
@@ -501165,6 +502825,72 @@ var schemas_default = {
                                   ]
                                 }
                               }
+                            },
+                            {
+                              title: "App surface",
+                              type: "object",
+                              additionalProperties: false,
+                              required: [
+                                "app"
+                              ],
+                              properties: {
+                                app: {
+                                  type: "string",
+                                  minLength: 1,
+                                  pattern: "\\S",
+                                  transform: [
+                                    "trim"
+                                  ],
+                                  description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                },
+                                window: {
+                                  description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                  title: "App window selector",
+                                  anyOf: [
+                                    {
+                                      title: "By index",
+                                      type: "integer",
+                                      description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                    },
+                                    {
+                                      title: "By name",
+                                      type: "string",
+                                      minLength: 1,
+                                      pattern: "\\S",
+                                      transform: [
+                                        "trim"
+                                      ],
+                                      description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                    },
+                                    {
+                                      title: "By criteria",
+                                      type: "object",
+                                      additionalProperties: false,
+                                      minProperties: 1,
+                                      properties: {
+                                        name: {
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "\\S",
+                                          transform: [
+                                            "trim"
+                                          ],
+                                          description: "Assigned window name."
+                                        },
+                                        index: {
+                                          type: "integer",
+                                          description: "Index in creation order. Negative counts from the end."
+                                        },
+                                        title: {
+                                          type: "string",
+                                          minLength: 1,
+                                          description: "Window title to match. Substring, or /regex/."
+                                        }
+                                      }
+                                    }
+                                  ]
+                                }
+                              }
                             }
                           ]
                         },
@@ -501230,13 +502956,12 @@ var schemas_default = {
                                 },
                                 target: {
                                   type: "string",
-                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                  description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                   enum: [
                                     "display",
                                     "window",
                                     "viewport"
-                                  ],
-                                  default: "display"
+                                  ]
                                 },
                                 fps: {
                                   type: "integer",
@@ -501282,13 +503007,12 @@ var schemas_default = {
                             },
                             target: {
                               type: "string",
-                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                               enum: [
                                 "display",
                                 "window",
                                 "viewport"
-                              ],
-                              default: "display"
+                              ]
                             },
                             fps: {
                               type: "integer",
@@ -501321,6 +503045,22 @@ var schemas_default = {
                       target: "window",
                       fps: 60
                     }
+                  },
+                  {
+                    path: "notepad.mp4",
+                    surface: {
+                      app: "notepad"
+                    }
+                  },
+                  {
+                    path: "full-screen.mp4",
+                    surface: {
+                      app: "notepad"
+                    },
+                    engine: {
+                      name: "ffmpeg",
+                      target: "display"
+                    }
                   }
                 ]
               }
@@ -547965,7 +549705,7 @@ var schemas_default = {
                     record: {
                       $schema: "http://json-schema.org/draft-07/schema#",
                       title: "record",
-                      description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                      description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                       anyOf: [
                         {
                           title: "Record (simple)",
@@ -547980,7 +549720,7 @@ var schemas_default = {
                           type: "object",
                           properties: {
                             surface: {
-                              description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                              description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                               anyOf: [
                                 {
                                   title: "Surface (by browser engine)",
@@ -548077,14 +549817,85 @@ var schemas_default = {
                                         }
                                       ]
                                     },
-                                    tab: {
-                                      description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
-                                      title: "Window/tab selector",
+                                    tab: {
+                                      description: "Which tab to act on. Omit to use the active tab. Without `window`, the selector searches every tab in creation order \u2014 including tabs the page opened itself.",
+                                      title: "Window/tab selector",
+                                      anyOf: [
+                                        {
+                                          title: "By index",
+                                          type: "integer",
+                                          description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                        },
+                                        {
+                                          title: "By name",
+                                          type: "string",
+                                          minLength: 1,
+                                          pattern: "\\S",
+                                          transform: [
+                                            "trim"
+                                          ],
+                                          description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                        },
+                                        {
+                                          title: "By criteria",
+                                          type: "object",
+                                          additionalProperties: false,
+                                          minProperties: 1,
+                                          properties: {
+                                            name: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "\\S",
+                                              transform: [
+                                                "trim"
+                                              ],
+                                              description: "Name assigned when the window/tab was opened."
+                                            },
+                                            index: {
+                                              type: "integer",
+                                              description: "Index in creation order. Negative counts from the end."
+                                            },
+                                            title: {
+                                              type: "string",
+                                              minLength: 1,
+                                              description: "Page title to match. Substring, or /regex/."
+                                            },
+                                            url: {
+                                              type: "string",
+                                              minLength: 1,
+                                              description: "Page URL to match. Substring, or /regex/."
+                                            }
+                                          }
+                                        }
+                                      ]
+                                    }
+                                  }
+                                },
+                                {
+                                  title: "App surface",
+                                  type: "object",
+                                  additionalProperties: false,
+                                  required: [
+                                    "app"
+                                  ],
+                                  properties: {
+                                    app: {
+                                      type: "string",
+                                      minLength: 1,
+                                      pattern: "\\S",
+                                      transform: [
+                                        "trim"
+                                      ],
+                                      description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                    },
+                                    window: {
+                                      description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                      title: "App window selector",
                                       anyOf: [
                                         {
                                           title: "By index",
                                           type: "integer",
-                                          description: "Index in creation order. Negative counts from the end; `-1` is the newest."
+                                          description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
                                         },
                                         {
                                           title: "By name",
@@ -548094,7 +549905,7 @@ var schemas_default = {
                                           transform: [
                                             "trim"
                                           ],
-                                          description: "Name assigned when the window/tab was opened (goTo `newTab`/`newWindow`). The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                          description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
                                         },
                                         {
                                           title: "By criteria",
@@ -548109,7 +549920,7 @@ var schemas_default = {
                                               transform: [
                                                 "trim"
                                               ],
-                                              description: "Name assigned when the window/tab was opened."
+                                              description: "Assigned window name."
                                             },
                                             index: {
                                               type: "integer",
@@ -548118,12 +549929,7 @@ var schemas_default = {
                                             title: {
                                               type: "string",
                                               minLength: 1,
-                                              description: "Page title to match. Substring, or /regex/."
-                                            },
-                                            url: {
-                                              type: "string",
-                                              minLength: 1,
-                                              description: "Page URL to match. Substring, or /regex/."
+                                              description: "Window title to match. Substring, or /regex/."
                                             }
                                           }
                                         }
@@ -548195,13 +550001,12 @@ var schemas_default = {
                                     },
                                     target: {
                                       type: "string",
-                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                      description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                       enum: [
                                         "display",
                                         "window",
                                         "viewport"
-                                      ],
-                                      default: "display"
+                                      ]
                                     },
                                     fps: {
                                       type: "integer",
@@ -548219,7 +550024,7 @@ var schemas_default = {
                         {
                           type: "boolean",
                           title: "Record (boolean)",
-                          description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                          description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                         }
                       ],
                       components: {
@@ -548237,7 +550042,7 @@ var schemas_default = {
                             type: "object",
                             properties: {
                               surface: {
-                                description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                 anyOf: [
                                   {
                                     title: "Surface (by browser engine)",
@@ -548387,6 +550192,72 @@ var schemas_default = {
                                         ]
                                       }
                                     }
+                                  },
+                                  {
+                                    title: "App surface",
+                                    type: "object",
+                                    additionalProperties: false,
+                                    required: [
+                                      "app"
+                                    ],
+                                    properties: {
+                                      app: {
+                                        type: "string",
+                                        minLength: 1,
+                                        pattern: "\\S",
+                                        transform: [
+                                          "trim"
+                                        ],
+                                        description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                      },
+                                      window: {
+                                        description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                        title: "App window selector",
+                                        anyOf: [
+                                          {
+                                            title: "By index",
+                                            type: "integer",
+                                            description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                          },
+                                          {
+                                            title: "By name",
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "\\S",
+                                            transform: [
+                                              "trim"
+                                            ],
+                                            description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                          },
+                                          {
+                                            title: "By criteria",
+                                            type: "object",
+                                            additionalProperties: false,
+                                            minProperties: 1,
+                                            properties: {
+                                              name: {
+                                                type: "string",
+                                                minLength: 1,
+                                                pattern: "\\S",
+                                                transform: [
+                                                  "trim"
+                                                ],
+                                                description: "Assigned window name."
+                                              },
+                                              index: {
+                                                type: "integer",
+                                                description: "Index in creation order. Negative counts from the end."
+                                              },
+                                              title: {
+                                                type: "string",
+                                                minLength: 1,
+                                                description: "Window title to match. Substring, or /regex/."
+                                              }
+                                            }
+                                          }
+                                        ]
+                                      }
+                                    }
                                   }
                                 ]
                               },
@@ -548452,13 +550323,12 @@ var schemas_default = {
                                       },
                                       target: {
                                         type: "string",
-                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                        description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                         enum: [
                                           "display",
                                           "window",
                                           "viewport"
-                                        ],
-                                        default: "display"
+                                        ]
                                       },
                                       fps: {
                                         type: "integer",
@@ -548504,13 +550374,12 @@ var schemas_default = {
                                   },
                                   target: {
                                     type: "string",
-                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                    description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                     enum: [
                                       "display",
                                       "window",
                                       "viewport"
-                                    ],
-                                    default: "display"
+                                    ]
                                   },
                                   fps: {
                                     type: "integer",
@@ -548543,6 +550412,22 @@ var schemas_default = {
                             target: "window",
                             fps: 60
                           }
+                        },
+                        {
+                          path: "notepad.mp4",
+                          surface: {
+                            app: "notepad"
+                          }
+                        },
+                        {
+                          path: "full-screen.mp4",
+                          surface: {
+                            app: "notepad"
+                          },
+                          engine: {
+                            name: "ffmpeg",
+                            target: "display"
+                          }
                         }
                       ]
                     }
@@ -591846,7 +593731,7 @@ var schemas_default = {
                           record: {
                             $schema: "http://json-schema.org/draft-07/schema#",
                             title: "record",
-                            description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                            description: "Start recording. Must be followed by a `stopRecord` step. The `browser` engine captures the Chrome viewport (works under concurrency); the `ffmpeg` engine captures the screen and supports any application. On Android/iOS contexts, recording captures the device screen through the device itself \u2014 `engine` doesn't apply. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
                             anyOf: [
                               {
                                 title: "Record (simple)",
@@ -591861,7 +593746,7 @@ var schemas_default = {
                                 type: "object",
                                 properties: {
                                   surface: {
-                                    description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                    description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                     anyOf: [
                                       {
                                         title: "Surface (by browser engine)",
@@ -592011,6 +593896,72 @@ var schemas_default = {
                                             ]
                                           }
                                         }
+                                      },
+                                      {
+                                        title: "App surface",
+                                        type: "object",
+                                        additionalProperties: false,
+                                        required: [
+                                          "app"
+                                        ],
+                                        properties: {
+                                          app: {
+                                            type: "string",
+                                            minLength: 1,
+                                            pattern: "\\S",
+                                            transform: [
+                                              "trim"
+                                            ],
+                                            description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                          },
+                                          window: {
+                                            description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                            title: "App window selector",
+                                            anyOf: [
+                                              {
+                                                title: "By index",
+                                                type: "integer",
+                                                description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                              },
+                                              {
+                                                title: "By name",
+                                                type: "string",
+                                                minLength: 1,
+                                                pattern: "\\S",
+                                                transform: [
+                                                  "trim"
+                                                ],
+                                                description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                              },
+                                              {
+                                                title: "By criteria",
+                                                type: "object",
+                                                additionalProperties: false,
+                                                minProperties: 1,
+                                                properties: {
+                                                  name: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    pattern: "\\S",
+                                                    transform: [
+                                                      "trim"
+                                                    ],
+                                                    description: "Assigned window name."
+                                                  },
+                                                  index: {
+                                                    type: "integer",
+                                                    description: "Index in creation order. Negative counts from the end."
+                                                  },
+                                                  title: {
+                                                    type: "string",
+                                                    minLength: 1,
+                                                    description: "Window title to match. Substring, or /regex/."
+                                                  }
+                                                }
+                                              }
+                                            ]
+                                          }
+                                        }
                                       }
                                     ]
                                   },
@@ -592076,13 +594027,12 @@ var schemas_default = {
                                           },
                                           target: {
                                             type: "string",
-                                            description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                            description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                             enum: [
                                               "display",
                                               "window",
                                               "viewport"
-                                            ],
-                                            default: "display"
+                                            ]
                                           },
                                           fps: {
                                             type: "integer",
@@ -592100,7 +594050,7 @@ var schemas_default = {
                               {
                                 type: "boolean",
                                 title: "Record (boolean)",
-                                description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context and the `ffmpeg` engine otherwise. If `false`, doesn't record."
+                                description: "If `true`, starts recording \u2014 auto-selecting the `browser` engine for a visible Chrome context, the device screen on Android/iOS contexts, and the `ffmpeg` engine otherwise. If `false`, doesn't record."
                               }
                             ],
                             components: {
@@ -592118,7 +594068,7 @@ var schemas_default = {
                                   type: "object",
                                   properties: {
                                     surface: {
-                                      description: "The browser window/tab to record. Omit to record the active tab. The targeted tab stays focused afterward.",
+                                      description: 'The browser window/tab or app window to record. Omit to record the active surface. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }) and are captured via the `ffmpeg` engine, cropped to the app window by default.',
                                       anyOf: [
                                         {
                                           title: "Surface (by browser engine)",
@@ -592268,6 +594218,72 @@ var schemas_default = {
                                               ]
                                             }
                                           }
+                                        },
+                                        {
+                                          title: "App surface",
+                                          type: "object",
+                                          additionalProperties: false,
+                                          required: [
+                                            "app"
+                                          ],
+                                          properties: {
+                                            app: {
+                                              type: "string",
+                                              minLength: 1,
+                                              pattern: "\\S",
+                                              transform: [
+                                                "trim"
+                                              ],
+                                              description: "Name of an app surface opened by `startSurface` (its `name`, or the default derived from the app identifier)."
+                                            },
+                                            window: {
+                                              description: "Which app window to act on. Omit to use the active window. Apps have windows, no tabs.",
+                                              title: "App window selector",
+                                              anyOf: [
+                                                {
+                                                  title: "By index",
+                                                  type: "integer",
+                                                  description: "Index in creation order. Negative counts from the end; `-1` is the newest (e.g. a dialog the app just opened)."
+                                                },
+                                                {
+                                                  title: "By name",
+                                                  type: "string",
+                                                  minLength: 1,
+                                                  pattern: "\\S",
+                                                  transform: [
+                                                    "trim"
+                                                  ],
+                                                  description: "Assigned window name. The integer branch is listed first because Ajv validates with coerceTypes \u2014 string-first would coerce integer indexes into name strings."
+                                                },
+                                                {
+                                                  title: "By criteria",
+                                                  type: "object",
+                                                  additionalProperties: false,
+                                                  minProperties: 1,
+                                                  properties: {
+                                                    name: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      pattern: "\\S",
+                                                      transform: [
+                                                        "trim"
+                                                      ],
+                                                      description: "Assigned window name."
+                                                    },
+                                                    index: {
+                                                      type: "integer",
+                                                      description: "Index in creation order. Negative counts from the end."
+                                                    },
+                                                    title: {
+                                                      type: "string",
+                                                      minLength: 1,
+                                                      description: "Window title to match. Substring, or /regex/."
+                                                    }
+                                                  }
+                                                }
+                                              ]
+                                            }
+                                          }
                                         }
                                       ]
                                     },
@@ -592333,13 +594349,12 @@ var schemas_default = {
                                             },
                                             target: {
                                               type: "string",
-                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                              description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                               enum: [
                                                 "display",
                                                 "window",
                                                 "viewport"
-                                              ],
-                                              default: "display"
+                                              ]
                                             },
                                             fps: {
                                               type: "integer",
@@ -592385,13 +594400,12 @@ var schemas_default = {
                                         },
                                         target: {
                                           type: "string",
-                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped).",
+                                          description: "What the `ffmpeg` engine captures. `display` records the full screen, `window` the active window, `viewport` the browser content area. Ignored by the `browser` engine, which always captures its tab. `window` and `viewport` are best-effort (captured full-screen, then cropped). If unset, defaults to `window` when the recording's `surface` is an app surface and to `display` otherwise. `viewport` doesn't apply to app surfaces (they have no browser viewport).",
                                           enum: [
                                             "display",
                                             "window",
                                             "viewport"
-                                          ],
-                                          default: "display"
+                                          ]
                                         },
                                         fps: {
                                           type: "integer",
@@ -592424,6 +594438,22 @@ var schemas_default = {
                                   target: "window",
                                   fps: 60
                                 }
+                              },
+                              {
+                                path: "notepad.mp4",
+                                surface: {
+                                  app: "notepad"
+                                }
+                              },
+                              {
+                                path: "full-screen.mp4",
+                                surface: {
+                                  app: "notepad"
+                                },
+                                engine: {
+                                  name: "ffmpeg",
+                                  target: "display"
+                                }
                               }
                             ]
                           }