doc-detective 4.35.0 → 4.36.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/dist/common/src/schemas/schemas.json +337 -337
  2. package/dist/common/src/types/generated/closeSurface_v3.d.ts +2 -2
  3. package/dist/common/src/types/generated/screenshot_v3.d.ts +1 -1
  4. package/dist/common/src/types/generated/step_v3.d.ts +6 -6
  5. package/dist/common/src/types/generated/surface_v3.d.ts +1 -1
  6. package/dist/common/src/types/generated/swipe_v3.d.ts +2 -2
  7. package/dist/common/src/types/generated/test_v3.d.ts +12 -12
  8. package/dist/common/src/types/generated/type_v3.d.ts +1 -1
  9. package/dist/core/tests/activeSurface.d.ts +46 -0
  10. package/dist/core/tests/activeSurface.d.ts.map +1 -0
  11. package/dist/core/tests/activeSurface.js +141 -0
  12. package/dist/core/tests/activeSurface.js.map +1 -0
  13. package/dist/core/tests/appSurface.d.ts +2 -0
  14. package/dist/core/tests/appSurface.d.ts.map +1 -1
  15. package/dist/core/tests/appSurface.js +24 -13
  16. package/dist/core/tests/appSurface.js.map +1 -1
  17. package/dist/core/tests/browserSessions.d.ts +3 -0
  18. package/dist/core/tests/browserSessions.d.ts.map +1 -1
  19. package/dist/core/tests/browserSessions.js +3 -0
  20. package/dist/core/tests/browserSessions.js.map +1 -1
  21. package/dist/core/tests/click.d.ts +3 -1
  22. package/dist/core/tests/click.d.ts.map +1 -1
  23. package/dist/core/tests/click.js +3 -1
  24. package/dist/core/tests/click.js.map +1 -1
  25. package/dist/core/tests/findElement.d.ts +4 -1
  26. package/dist/core/tests/findElement.d.ts.map +1 -1
  27. package/dist/core/tests/findElement.js +52 -27
  28. package/dist/core/tests/findElement.js.map +1 -1
  29. package/dist/core/tests/saveScreenshot.d.ts +4 -1
  30. package/dist/core/tests/saveScreenshot.d.ts.map +1 -1
  31. package/dist/core/tests/saveScreenshot.js +70 -54
  32. package/dist/core/tests/saveScreenshot.js.map +1 -1
  33. package/dist/core/tests/startSurface.d.ts +3 -1
  34. package/dist/core/tests/startSurface.d.ts.map +1 -1
  35. package/dist/core/tests/startSurface.js +36 -2
  36. package/dist/core/tests/startSurface.js.map +1 -1
  37. package/dist/core/tests/swipe.d.ts +4 -1
  38. package/dist/core/tests/swipe.d.ts.map +1 -1
  39. package/dist/core/tests/swipe.js +37 -25
  40. package/dist/core/tests/swipe.js.map +1 -1
  41. package/dist/core/tests/typeKeys.d.ts +3 -1
  42. package/dist/core/tests/typeKeys.d.ts.map +1 -1
  43. package/dist/core/tests/typeKeys.js +42 -36
  44. package/dist/core/tests/typeKeys.js.map +1 -1
  45. package/dist/core/tests.d.ts +3 -1
  46. package/dist/core/tests.d.ts.map +1 -1
  47. package/dist/core/tests.js +38 -9
  48. package/dist/core/tests.js.map +1 -1
  49. package/dist/hints/context.d.ts +3 -0
  50. package/dist/hints/context.d.ts.map +1 -1
  51. package/dist/hints/context.js +25 -0
  52. package/dist/hints/context.js.map +1 -1
  53. package/dist/hints/hints.d.ts.map +1 -1
  54. package/dist/hints/hints.js +19 -0
  55. package/dist/hints/hints.js.map +1 -1
  56. package/dist/hints/types.d.ts +7 -0
  57. package/dist/hints/types.d.ts.map +1 -1
  58. package/dist/index.cjs +684 -470
  59. package/dist/runtime/browserStepKeys.d.ts +37 -0
  60. package/dist/runtime/browserStepKeys.d.ts.map +1 -1
  61. package/dist/runtime/browserStepKeys.js +73 -0
  62. package/dist/runtime/browserStepKeys.js.map +1 -1
  63. package/dist/runtime/inferRuntimeNeeds.d.ts.map +1 -1
  64. package/dist/runtime/inferRuntimeNeeds.js +18 -11
  65. package/dist/runtime/inferRuntimeNeeds.js.map +1 -1
  66. package/package.json +1 -1
package/dist/index.cjs CHANGED
@@ -7259,7 +7259,7 @@ var init_schemas = __esm({
7259
7259
  minimum: 1
7260
7260
  },
7261
7261
  surface: {
7262
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
7262
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
7263
7263
  anyOf: [
7264
7264
  {
7265
7265
  title: "Surface (by browser engine)",
@@ -7612,7 +7612,7 @@ var init_schemas = __esm({
7612
7612
  minimum: 1
7613
7613
  },
7614
7614
  surface: {
7615
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
7615
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
7616
7616
  anyOf: [
7617
7617
  {
7618
7618
  title: "Surface (by browser engine)",
@@ -7908,7 +7908,7 @@ var init_schemas = __esm({
7908
7908
  {
7909
7909
  $schema: "http://json-schema.org/draft-07/schema#",
7910
7910
  title: "surface",
7911
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
7911
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
7912
7912
  anyOf: [
7913
7913
  {
7914
7914
  title: "Surface (by name)",
@@ -8532,7 +8532,7 @@ var init_schemas = __esm({
8532
8532
  items: {
8533
8533
  $schema: "http://json-schema.org/draft-07/schema#",
8534
8534
  title: "surface",
8535
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
8535
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
8536
8536
  anyOf: [
8537
8537
  {
8538
8538
  title: "Surface (by name)",
@@ -14308,7 +14308,7 @@ var init_schemas = __esm({
14308
14308
  minimum: 1
14309
14309
  },
14310
14310
  surface: {
14311
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
14311
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
14312
14312
  anyOf: [
14313
14313
  {
14314
14314
  title: "Surface (by browser engine)",
@@ -14661,7 +14661,7 @@ var init_schemas = __esm({
14661
14661
  minimum: 1
14662
14662
  },
14663
14663
  surface: {
14664
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
14664
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
14665
14665
  anyOf: [
14666
14666
  {
14667
14667
  title: "Surface (by browser engine)",
@@ -15951,7 +15951,7 @@ var init_schemas = __esm({
15951
15951
  additionalProperties: false,
15952
15952
  properties: {
15953
15953
  surface: {
15954
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
15954
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
15955
15955
  anyOf: [
15956
15956
  {
15957
15957
  title: "Surface (by browser engine)",
@@ -16300,7 +16300,7 @@ var init_schemas = __esm({
16300
16300
  minimum: 1
16301
16301
  },
16302
16302
  surface: {
16303
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
16303
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
16304
16304
  anyOf: [
16305
16305
  {
16306
16306
  title: "Surface (by browser engine)",
@@ -16653,7 +16653,7 @@ var init_schemas = __esm({
16653
16653
  minimum: 1
16654
16654
  },
16655
16655
  surface: {
16656
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
16656
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
16657
16657
  anyOf: [
16658
16658
  {
16659
16659
  title: "Surface (by browser engine)",
@@ -17023,7 +17023,7 @@ var init_schemas = __esm({
17023
17023
  surface: {
17024
17024
  $schema: "http://json-schema.org/draft-07/schema#",
17025
17025
  title: "surface",
17026
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
17026
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
17027
17027
  anyOf: [
17028
17028
  {
17029
17029
  title: "Surface (by name)",
@@ -18520,7 +18520,7 @@ var init_schemas = __esm({
18520
18520
  surface: {
18521
18521
  $schema: "http://json-schema.org/draft-07/schema#",
18522
18522
  title: "surface",
18523
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
18523
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
18524
18524
  anyOf: [
18525
18525
  {
18526
18526
  title: "Surface (by name)",
@@ -20097,7 +20097,7 @@ var init_schemas = __esm({
20097
20097
  additionalProperties: false,
20098
20098
  properties: {
20099
20099
  surface: {
20100
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
20100
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
20101
20101
  anyOf: [
20102
20102
  {
20103
20103
  title: "Surface (by browser engine)",
@@ -20446,7 +20446,7 @@ var init_schemas = __esm({
20446
20446
  minimum: 1
20447
20447
  },
20448
20448
  surface: {
20449
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
20449
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
20450
20450
  anyOf: [
20451
20451
  {
20452
20452
  title: "Surface (by browser engine)",
@@ -20799,7 +20799,7 @@ var init_schemas = __esm({
20799
20799
  minimum: 1
20800
20800
  },
20801
20801
  surface: {
20802
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
20802
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
20803
20803
  anyOf: [
20804
20804
  {
20805
20805
  title: "Surface (by browser engine)",
@@ -21169,7 +21169,7 @@ var init_schemas = __esm({
21169
21169
  surface: {
21170
21170
  $schema: "http://json-schema.org/draft-07/schema#",
21171
21171
  title: "surface",
21172
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
21172
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
21173
21173
  anyOf: [
21174
21174
  {
21175
21175
  title: "Surface (by name)",
@@ -22666,7 +22666,7 @@ var init_schemas = __esm({
22666
22666
  surface: {
22667
22667
  $schema: "http://json-schema.org/draft-07/schema#",
22668
22668
  title: "surface",
22669
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
22669
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
22670
22670
  anyOf: [
22671
22671
  {
22672
22672
  title: "Surface (by name)",
@@ -33358,7 +33358,7 @@ var init_schemas = __esm({
33358
33358
  surface: {
33359
33359
  $schema: "http://json-schema.org/draft-07/schema#",
33360
33360
  title: "surface",
33361
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
33361
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
33362
33362
  anyOf: [
33363
33363
  {
33364
33364
  title: "Surface (by name)",
@@ -34855,7 +34855,7 @@ var init_schemas = __esm({
34855
34855
  surface: {
34856
34856
  $schema: "http://json-schema.org/draft-07/schema#",
34857
34857
  title: "surface",
34858
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
34858
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
34859
34859
  anyOf: [
34860
34860
  {
34861
34861
  title: "Surface (by name)",
@@ -37334,7 +37334,7 @@ var init_schemas = __esm({
37334
37334
  additionalProperties: false,
37335
37335
  properties: {
37336
37336
  surface: {
37337
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
37337
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
37338
37338
  anyOf: [
37339
37339
  {
37340
37340
  title: "Surface (by browser engine)",
@@ -39885,7 +39885,7 @@ var init_schemas = __esm({
39885
39885
  additionalProperties: false,
39886
39886
  properties: {
39887
39887
  surface: {
39888
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
39888
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
39889
39889
  anyOf: [
39890
39890
  {
39891
39891
  title: "Surface (by browser engine)",
@@ -42415,7 +42415,7 @@ var init_schemas = __esm({
42415
42415
  additionalProperties: false,
42416
42416
  properties: {
42417
42417
  surface: {
42418
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
42418
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
42419
42419
  anyOf: [
42420
42420
  {
42421
42421
  title: "Surface (by browser engine)",
@@ -50141,7 +50141,7 @@ var init_schemas = __esm({
50141
50141
  {
50142
50142
  $schema: "http://json-schema.org/draft-07/schema#",
50143
50143
  title: "surface",
50144
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
50144
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
50145
50145
  anyOf: [
50146
50146
  {
50147
50147
  title: "Surface (by name)",
@@ -50765,7 +50765,7 @@ var init_schemas = __esm({
50765
50765
  items: {
50766
50766
  $schema: "http://json-schema.org/draft-07/schema#",
50767
50767
  title: "surface",
50768
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
50768
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
50769
50769
  anyOf: [
50770
50770
  {
50771
50771
  title: "Surface (by name)",
@@ -58521,7 +58521,7 @@ var init_schemas = __esm({
58521
58521
  description: "Duration of the swipe movement in milliseconds."
58522
58522
  },
58523
58523
  surface: {
58524
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
58524
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
58525
58525
  anyOf: [
58526
58526
  {
58527
58527
  title: "Surface (by browser engine)",
@@ -58802,7 +58802,7 @@ var init_schemas = __esm({
58802
58802
  description: "Duration of the swipe movement in milliseconds."
58803
58803
  },
58804
58804
  surface: {
58805
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
58805
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
58806
58806
  anyOf: [
58807
58807
  {
58808
58808
  title: "Surface (by browser engine)",
@@ -59066,7 +59066,7 @@ var init_schemas = __esm({
59066
59066
  description: "Duration of the swipe movement in milliseconds."
59067
59067
  },
59068
59068
  surface: {
59069
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
59069
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
59070
59070
  anyOf: [
59071
59071
  {
59072
59072
  title: "Surface (by browser engine)",
@@ -59318,7 +59318,7 @@ var init_schemas = __esm({
59318
59318
  description: "Duration of the swipe movement in milliseconds."
59319
59319
  },
59320
59320
  surface: {
59321
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
59321
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
59322
59322
  anyOf: [
59323
59323
  {
59324
59324
  title: "Surface (by browser engine)",
@@ -59599,7 +59599,7 @@ var init_schemas = __esm({
59599
59599
  description: "Duration of the swipe movement in milliseconds."
59600
59600
  },
59601
59601
  surface: {
59602
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
59602
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
59603
59603
  anyOf: [
59604
59604
  {
59605
59605
  title: "Surface (by browser engine)",
@@ -72076,7 +72076,7 @@ var init_schemas = __esm({
72076
72076
  minimum: 1
72077
72077
  },
72078
72078
  surface: {
72079
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
72079
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
72080
72080
  anyOf: [
72081
72081
  {
72082
72082
  title: "Surface (by browser engine)",
@@ -72429,7 +72429,7 @@ var init_schemas = __esm({
72429
72429
  minimum: 1
72430
72430
  },
72431
72431
  surface: {
72432
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
72432
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
72433
72433
  anyOf: [
72434
72434
  {
72435
72435
  title: "Surface (by browser engine)",
@@ -73719,7 +73719,7 @@ var init_schemas = __esm({
73719
73719
  additionalProperties: false,
73720
73720
  properties: {
73721
73721
  surface: {
73722
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
73722
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
73723
73723
  anyOf: [
73724
73724
  {
73725
73725
  title: "Surface (by browser engine)",
@@ -74068,7 +74068,7 @@ var init_schemas = __esm({
74068
74068
  minimum: 1
74069
74069
  },
74070
74070
  surface: {
74071
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
74071
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
74072
74072
  anyOf: [
74073
74073
  {
74074
74074
  title: "Surface (by browser engine)",
@@ -74421,7 +74421,7 @@ var init_schemas = __esm({
74421
74421
  minimum: 1
74422
74422
  },
74423
74423
  surface: {
74424
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
74424
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
74425
74425
  anyOf: [
74426
74426
  {
74427
74427
  title: "Surface (by browser engine)",
@@ -74791,7 +74791,7 @@ var init_schemas = __esm({
74791
74791
  surface: {
74792
74792
  $schema: "http://json-schema.org/draft-07/schema#",
74793
74793
  title: "surface",
74794
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
74794
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
74795
74795
  anyOf: [
74796
74796
  {
74797
74797
  title: "Surface (by name)",
@@ -76288,7 +76288,7 @@ var init_schemas = __esm({
76288
76288
  surface: {
76289
76289
  $schema: "http://json-schema.org/draft-07/schema#",
76290
76290
  title: "surface",
76291
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
76291
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
76292
76292
  anyOf: [
76293
76293
  {
76294
76294
  title: "Surface (by name)",
@@ -77865,7 +77865,7 @@ var init_schemas = __esm({
77865
77865
  additionalProperties: false,
77866
77866
  properties: {
77867
77867
  surface: {
77868
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
77868
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
77869
77869
  anyOf: [
77870
77870
  {
77871
77871
  title: "Surface (by browser engine)",
@@ -78214,7 +78214,7 @@ var init_schemas = __esm({
78214
78214
  minimum: 1
78215
78215
  },
78216
78216
  surface: {
78217
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
78217
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
78218
78218
  anyOf: [
78219
78219
  {
78220
78220
  title: "Surface (by browser engine)",
@@ -78567,7 +78567,7 @@ var init_schemas = __esm({
78567
78567
  minimum: 1
78568
78568
  },
78569
78569
  surface: {
78570
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
78570
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
78571
78571
  anyOf: [
78572
78572
  {
78573
78573
  title: "Surface (by browser engine)",
@@ -78937,7 +78937,7 @@ var init_schemas = __esm({
78937
78937
  surface: {
78938
78938
  $schema: "http://json-schema.org/draft-07/schema#",
78939
78939
  title: "surface",
78940
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
78940
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
78941
78941
  anyOf: [
78942
78942
  {
78943
78943
  title: "Surface (by name)",
@@ -80434,7 +80434,7 @@ var init_schemas = __esm({
80434
80434
  surface: {
80435
80435
  $schema: "http://json-schema.org/draft-07/schema#",
80436
80436
  title: "surface",
80437
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
80437
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
80438
80438
  anyOf: [
80439
80439
  {
80440
80440
  title: "Surface (by name)",
@@ -91126,7 +91126,7 @@ var init_schemas = __esm({
91126
91126
  surface: {
91127
91127
  $schema: "http://json-schema.org/draft-07/schema#",
91128
91128
  title: "surface",
91129
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
91129
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
91130
91130
  anyOf: [
91131
91131
  {
91132
91132
  title: "Surface (by name)",
@@ -92623,7 +92623,7 @@ var init_schemas = __esm({
92623
92623
  surface: {
92624
92624
  $schema: "http://json-schema.org/draft-07/schema#",
92625
92625
  title: "surface",
92626
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
92626
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
92627
92627
  anyOf: [
92628
92628
  {
92629
92629
  title: "Surface (by name)",
@@ -95102,7 +95102,7 @@ var init_schemas = __esm({
95102
95102
  additionalProperties: false,
95103
95103
  properties: {
95104
95104
  surface: {
95105
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
95105
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
95106
95106
  anyOf: [
95107
95107
  {
95108
95108
  title: "Surface (by browser engine)",
@@ -97653,7 +97653,7 @@ var init_schemas = __esm({
97653
97653
  additionalProperties: false,
97654
97654
  properties: {
97655
97655
  surface: {
97656
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
97656
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
97657
97657
  anyOf: [
97658
97658
  {
97659
97659
  title: "Surface (by browser engine)",
@@ -100183,7 +100183,7 @@ var init_schemas = __esm({
100183
100183
  additionalProperties: false,
100184
100184
  properties: {
100185
100185
  surface: {
100186
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
100186
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
100187
100187
  anyOf: [
100188
100188
  {
100189
100189
  title: "Surface (by browser engine)",
@@ -107909,7 +107909,7 @@ var init_schemas = __esm({
107909
107909
  {
107910
107910
  $schema: "http://json-schema.org/draft-07/schema#",
107911
107911
  title: "surface",
107912
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
107912
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
107913
107913
  anyOf: [
107914
107914
  {
107915
107915
  title: "Surface (by name)",
@@ -108533,7 +108533,7 @@ var init_schemas = __esm({
108533
108533
  items: {
108534
108534
  $schema: "http://json-schema.org/draft-07/schema#",
108535
108535
  title: "surface",
108536
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
108536
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
108537
108537
  anyOf: [
108538
108538
  {
108539
108539
  title: "Surface (by name)",
@@ -116289,7 +116289,7 @@ var init_schemas = __esm({
116289
116289
  description: "Duration of the swipe movement in milliseconds."
116290
116290
  },
116291
116291
  surface: {
116292
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
116292
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
116293
116293
  anyOf: [
116294
116294
  {
116295
116295
  title: "Surface (by browser engine)",
@@ -116570,7 +116570,7 @@ var init_schemas = __esm({
116570
116570
  description: "Duration of the swipe movement in milliseconds."
116571
116571
  },
116572
116572
  surface: {
116573
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
116573
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
116574
116574
  anyOf: [
116575
116575
  {
116576
116576
  title: "Surface (by browser engine)",
@@ -116834,7 +116834,7 @@ var init_schemas = __esm({
116834
116834
  description: "Duration of the swipe movement in milliseconds."
116835
116835
  },
116836
116836
  surface: {
116837
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
116837
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
116838
116838
  anyOf: [
116839
116839
  {
116840
116840
  title: "Surface (by browser engine)",
@@ -117086,7 +117086,7 @@ var init_schemas = __esm({
117086
117086
  description: "Duration of the swipe movement in milliseconds."
117087
117087
  },
117088
117088
  surface: {
117089
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
117089
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
117090
117090
  anyOf: [
117091
117091
  {
117092
117092
  title: "Surface (by browser engine)",
@@ -117367,7 +117367,7 @@ var init_schemas = __esm({
117367
117367
  description: "Duration of the swipe movement in milliseconds."
117368
117368
  },
117369
117369
  surface: {
117370
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
117370
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
117371
117371
  anyOf: [
117372
117372
  {
117373
117373
  title: "Surface (by browser engine)",
@@ -125886,7 +125886,7 @@ var init_schemas = __esm({
125886
125886
  additionalProperties: false,
125887
125887
  properties: {
125888
125888
  surface: {
125889
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
125889
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
125890
125890
  anyOf: [
125891
125891
  {
125892
125892
  title: "Surface (by browser engine)",
@@ -126235,7 +126235,7 @@ var init_schemas = __esm({
126235
126235
  minimum: 1
126236
126236
  },
126237
126237
  surface: {
126238
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
126238
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
126239
126239
  anyOf: [
126240
126240
  {
126241
126241
  title: "Surface (by browser engine)",
@@ -126588,7 +126588,7 @@ var init_schemas = __esm({
126588
126588
  minimum: 1
126589
126589
  },
126590
126590
  surface: {
126591
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
126591
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
126592
126592
  anyOf: [
126593
126593
  {
126594
126594
  title: "Surface (by browser engine)",
@@ -126958,7 +126958,7 @@ var init_schemas = __esm({
126958
126958
  surface: {
126959
126959
  $schema: "http://json-schema.org/draft-07/schema#",
126960
126960
  title: "surface",
126961
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
126961
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
126962
126962
  anyOf: [
126963
126963
  {
126964
126964
  title: "Surface (by name)",
@@ -128455,7 +128455,7 @@ var init_schemas = __esm({
128455
128455
  surface: {
128456
128456
  $schema: "http://json-schema.org/draft-07/schema#",
128457
128457
  title: "surface",
128458
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
128458
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
128459
128459
  anyOf: [
128460
128460
  {
128461
128461
  title: "Surface (by name)",
@@ -130032,7 +130032,7 @@ var init_schemas = __esm({
130032
130032
  additionalProperties: false,
130033
130033
  properties: {
130034
130034
  surface: {
130035
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
130035
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
130036
130036
  anyOf: [
130037
130037
  {
130038
130038
  title: "Surface (by browser engine)",
@@ -130381,7 +130381,7 @@ var init_schemas = __esm({
130381
130381
  minimum: 1
130382
130382
  },
130383
130383
  surface: {
130384
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
130384
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
130385
130385
  anyOf: [
130386
130386
  {
130387
130387
  title: "Surface (by browser engine)",
@@ -130734,7 +130734,7 @@ var init_schemas = __esm({
130734
130734
  minimum: 1
130735
130735
  },
130736
130736
  surface: {
130737
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
130737
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
130738
130738
  anyOf: [
130739
130739
  {
130740
130740
  title: "Surface (by browser engine)",
@@ -131104,7 +131104,7 @@ var init_schemas = __esm({
131104
131104
  surface: {
131105
131105
  $schema: "http://json-schema.org/draft-07/schema#",
131106
131106
  title: "surface",
131107
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
131107
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
131108
131108
  anyOf: [
131109
131109
  {
131110
131110
  title: "Surface (by name)",
@@ -132601,7 +132601,7 @@ var init_schemas = __esm({
132601
132601
  surface: {
132602
132602
  $schema: "http://json-schema.org/draft-07/schema#",
132603
132603
  title: "surface",
132604
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
132604
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
132605
132605
  anyOf: [
132606
132606
  {
132607
132607
  title: "Surface (by name)",
@@ -142775,7 +142775,7 @@ var init_schemas = __esm({
142775
142775
  minimum: 1
142776
142776
  },
142777
142777
  surface: {
142778
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
142778
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
142779
142779
  anyOf: [
142780
142780
  {
142781
142781
  title: "Surface (by browser engine)",
@@ -143128,7 +143128,7 @@ var init_schemas = __esm({
143128
143128
  minimum: 1
143129
143129
  },
143130
143130
  surface: {
143131
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
143131
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
143132
143132
  anyOf: [
143133
143133
  {
143134
143134
  title: "Surface (by browser engine)",
@@ -144418,7 +144418,7 @@ var init_schemas = __esm({
144418
144418
  additionalProperties: false,
144419
144419
  properties: {
144420
144420
  surface: {
144421
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
144421
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
144422
144422
  anyOf: [
144423
144423
  {
144424
144424
  title: "Surface (by browser engine)",
@@ -144767,7 +144767,7 @@ var init_schemas = __esm({
144767
144767
  minimum: 1
144768
144768
  },
144769
144769
  surface: {
144770
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
144770
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
144771
144771
  anyOf: [
144772
144772
  {
144773
144773
  title: "Surface (by browser engine)",
@@ -145120,7 +145120,7 @@ var init_schemas = __esm({
145120
145120
  minimum: 1
145121
145121
  },
145122
145122
  surface: {
145123
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
145123
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
145124
145124
  anyOf: [
145125
145125
  {
145126
145126
  title: "Surface (by browser engine)",
@@ -145490,7 +145490,7 @@ var init_schemas = __esm({
145490
145490
  surface: {
145491
145491
  $schema: "http://json-schema.org/draft-07/schema#",
145492
145492
  title: "surface",
145493
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
145493
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
145494
145494
  anyOf: [
145495
145495
  {
145496
145496
  title: "Surface (by name)",
@@ -146987,7 +146987,7 @@ var init_schemas = __esm({
146987
146987
  surface: {
146988
146988
  $schema: "http://json-schema.org/draft-07/schema#",
146989
146989
  title: "surface",
146990
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
146990
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
146991
146991
  anyOf: [
146992
146992
  {
146993
146993
  title: "Surface (by name)",
@@ -148564,7 +148564,7 @@ var init_schemas = __esm({
148564
148564
  additionalProperties: false,
148565
148565
  properties: {
148566
148566
  surface: {
148567
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
148567
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
148568
148568
  anyOf: [
148569
148569
  {
148570
148570
  title: "Surface (by browser engine)",
@@ -148913,7 +148913,7 @@ var init_schemas = __esm({
148913
148913
  minimum: 1
148914
148914
  },
148915
148915
  surface: {
148916
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
148916
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
148917
148917
  anyOf: [
148918
148918
  {
148919
148919
  title: "Surface (by browser engine)",
@@ -149266,7 +149266,7 @@ var init_schemas = __esm({
149266
149266
  minimum: 1
149267
149267
  },
149268
149268
  surface: {
149269
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
149269
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
149270
149270
  anyOf: [
149271
149271
  {
149272
149272
  title: "Surface (by browser engine)",
@@ -149636,7 +149636,7 @@ var init_schemas = __esm({
149636
149636
  surface: {
149637
149637
  $schema: "http://json-schema.org/draft-07/schema#",
149638
149638
  title: "surface",
149639
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
149639
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
149640
149640
  anyOf: [
149641
149641
  {
149642
149642
  title: "Surface (by name)",
@@ -151133,7 +151133,7 @@ var init_schemas = __esm({
151133
151133
  surface: {
151134
151134
  $schema: "http://json-schema.org/draft-07/schema#",
151135
151135
  title: "surface",
151136
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
151136
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
151137
151137
  anyOf: [
151138
151138
  {
151139
151139
  title: "Surface (by name)",
@@ -161825,7 +161825,7 @@ var init_schemas = __esm({
161825
161825
  surface: {
161826
161826
  $schema: "http://json-schema.org/draft-07/schema#",
161827
161827
  title: "surface",
161828
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
161828
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
161829
161829
  anyOf: [
161830
161830
  {
161831
161831
  title: "Surface (by name)",
@@ -163322,7 +163322,7 @@ var init_schemas = __esm({
163322
163322
  surface: {
163323
163323
  $schema: "http://json-schema.org/draft-07/schema#",
163324
163324
  title: "surface",
163325
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
163325
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
163326
163326
  anyOf: [
163327
163327
  {
163328
163328
  title: "Surface (by name)",
@@ -165801,7 +165801,7 @@ var init_schemas = __esm({
165801
165801
  additionalProperties: false,
165802
165802
  properties: {
165803
165803
  surface: {
165804
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
165804
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
165805
165805
  anyOf: [
165806
165806
  {
165807
165807
  title: "Surface (by browser engine)",
@@ -168352,7 +168352,7 @@ var init_schemas = __esm({
168352
168352
  additionalProperties: false,
168353
168353
  properties: {
168354
168354
  surface: {
168355
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
168355
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
168356
168356
  anyOf: [
168357
168357
  {
168358
168358
  title: "Surface (by browser engine)",
@@ -170882,7 +170882,7 @@ var init_schemas = __esm({
170882
170882
  additionalProperties: false,
170883
170883
  properties: {
170884
170884
  surface: {
170885
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
170885
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
170886
170886
  anyOf: [
170887
170887
  {
170888
170888
  title: "Surface (by browser engine)",
@@ -178608,7 +178608,7 @@ var init_schemas = __esm({
178608
178608
  {
178609
178609
  $schema: "http://json-schema.org/draft-07/schema#",
178610
178610
  title: "surface",
178611
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
178611
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
178612
178612
  anyOf: [
178613
178613
  {
178614
178614
  title: "Surface (by name)",
@@ -179232,7 +179232,7 @@ var init_schemas = __esm({
179232
179232
  items: {
179233
179233
  $schema: "http://json-schema.org/draft-07/schema#",
179234
179234
  title: "surface",
179235
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
179235
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
179236
179236
  anyOf: [
179237
179237
  {
179238
179238
  title: "Surface (by name)",
@@ -186988,7 +186988,7 @@ var init_schemas = __esm({
186988
186988
  description: "Duration of the swipe movement in milliseconds."
186989
186989
  },
186990
186990
  surface: {
186991
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
186991
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
186992
186992
  anyOf: [
186993
186993
  {
186994
186994
  title: "Surface (by browser engine)",
@@ -187269,7 +187269,7 @@ var init_schemas = __esm({
187269
187269
  description: "Duration of the swipe movement in milliseconds."
187270
187270
  },
187271
187271
  surface: {
187272
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
187272
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
187273
187273
  anyOf: [
187274
187274
  {
187275
187275
  title: "Surface (by browser engine)",
@@ -187533,7 +187533,7 @@ var init_schemas = __esm({
187533
187533
  description: "Duration of the swipe movement in milliseconds."
187534
187534
  },
187535
187535
  surface: {
187536
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
187536
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
187537
187537
  anyOf: [
187538
187538
  {
187539
187539
  title: "Surface (by browser engine)",
@@ -187785,7 +187785,7 @@ var init_schemas = __esm({
187785
187785
  description: "Duration of the swipe movement in milliseconds."
187786
187786
  },
187787
187787
  surface: {
187788
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
187788
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
187789
187789
  anyOf: [
187790
187790
  {
187791
187791
  title: "Surface (by browser engine)",
@@ -188066,7 +188066,7 @@ var init_schemas = __esm({
188066
188066
  description: "Duration of the swipe movement in milliseconds."
188067
188067
  },
188068
188068
  surface: {
188069
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
188069
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
188070
188070
  anyOf: [
188071
188071
  {
188072
188072
  title: "Surface (by browser engine)",
@@ -200543,7 +200543,7 @@ var init_schemas = __esm({
200543
200543
  minimum: 1
200544
200544
  },
200545
200545
  surface: {
200546
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
200546
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
200547
200547
  anyOf: [
200548
200548
  {
200549
200549
  title: "Surface (by browser engine)",
@@ -200896,7 +200896,7 @@ var init_schemas = __esm({
200896
200896
  minimum: 1
200897
200897
  },
200898
200898
  surface: {
200899
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
200899
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
200900
200900
  anyOf: [
200901
200901
  {
200902
200902
  title: "Surface (by browser engine)",
@@ -202186,7 +202186,7 @@ var init_schemas = __esm({
202186
202186
  additionalProperties: false,
202187
202187
  properties: {
202188
202188
  surface: {
202189
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
202189
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
202190
202190
  anyOf: [
202191
202191
  {
202192
202192
  title: "Surface (by browser engine)",
@@ -202535,7 +202535,7 @@ var init_schemas = __esm({
202535
202535
  minimum: 1
202536
202536
  },
202537
202537
  surface: {
202538
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
202538
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
202539
202539
  anyOf: [
202540
202540
  {
202541
202541
  title: "Surface (by browser engine)",
@@ -202888,7 +202888,7 @@ var init_schemas = __esm({
202888
202888
  minimum: 1
202889
202889
  },
202890
202890
  surface: {
202891
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
202891
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
202892
202892
  anyOf: [
202893
202893
  {
202894
202894
  title: "Surface (by browser engine)",
@@ -203258,7 +203258,7 @@ var init_schemas = __esm({
203258
203258
  surface: {
203259
203259
  $schema: "http://json-schema.org/draft-07/schema#",
203260
203260
  title: "surface",
203261
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
203261
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
203262
203262
  anyOf: [
203263
203263
  {
203264
203264
  title: "Surface (by name)",
@@ -204755,7 +204755,7 @@ var init_schemas = __esm({
204755
204755
  surface: {
204756
204756
  $schema: "http://json-schema.org/draft-07/schema#",
204757
204757
  title: "surface",
204758
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
204758
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
204759
204759
  anyOf: [
204760
204760
  {
204761
204761
  title: "Surface (by name)",
@@ -206332,7 +206332,7 @@ var init_schemas = __esm({
206332
206332
  additionalProperties: false,
206333
206333
  properties: {
206334
206334
  surface: {
206335
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
206335
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
206336
206336
  anyOf: [
206337
206337
  {
206338
206338
  title: "Surface (by browser engine)",
@@ -206681,7 +206681,7 @@ var init_schemas = __esm({
206681
206681
  minimum: 1
206682
206682
  },
206683
206683
  surface: {
206684
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
206684
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
206685
206685
  anyOf: [
206686
206686
  {
206687
206687
  title: "Surface (by browser engine)",
@@ -207034,7 +207034,7 @@ var init_schemas = __esm({
207034
207034
  minimum: 1
207035
207035
  },
207036
207036
  surface: {
207037
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
207037
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
207038
207038
  anyOf: [
207039
207039
  {
207040
207040
  title: "Surface (by browser engine)",
@@ -207404,7 +207404,7 @@ var init_schemas = __esm({
207404
207404
  surface: {
207405
207405
  $schema: "http://json-schema.org/draft-07/schema#",
207406
207406
  title: "surface",
207407
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
207407
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
207408
207408
  anyOf: [
207409
207409
  {
207410
207410
  title: "Surface (by name)",
@@ -208901,7 +208901,7 @@ var init_schemas = __esm({
208901
208901
  surface: {
208902
208902
  $schema: "http://json-schema.org/draft-07/schema#",
208903
208903
  title: "surface",
208904
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
208904
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
208905
208905
  anyOf: [
208906
208906
  {
208907
208907
  title: "Surface (by name)",
@@ -219593,7 +219593,7 @@ var init_schemas = __esm({
219593
219593
  surface: {
219594
219594
  $schema: "http://json-schema.org/draft-07/schema#",
219595
219595
  title: "surface",
219596
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
219596
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
219597
219597
  anyOf: [
219598
219598
  {
219599
219599
  title: "Surface (by name)",
@@ -221090,7 +221090,7 @@ var init_schemas = __esm({
221090
221090
  surface: {
221091
221091
  $schema: "http://json-schema.org/draft-07/schema#",
221092
221092
  title: "surface",
221093
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
221093
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
221094
221094
  anyOf: [
221095
221095
  {
221096
221096
  title: "Surface (by name)",
@@ -223569,7 +223569,7 @@ var init_schemas = __esm({
223569
223569
  additionalProperties: false,
223570
223570
  properties: {
223571
223571
  surface: {
223572
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
223572
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
223573
223573
  anyOf: [
223574
223574
  {
223575
223575
  title: "Surface (by browser engine)",
@@ -226120,7 +226120,7 @@ var init_schemas = __esm({
226120
226120
  additionalProperties: false,
226121
226121
  properties: {
226122
226122
  surface: {
226123
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
226123
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
226124
226124
  anyOf: [
226125
226125
  {
226126
226126
  title: "Surface (by browser engine)",
@@ -228650,7 +228650,7 @@ var init_schemas = __esm({
228650
228650
  additionalProperties: false,
228651
228651
  properties: {
228652
228652
  surface: {
228653
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
228653
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
228654
228654
  anyOf: [
228655
228655
  {
228656
228656
  title: "Surface (by browser engine)",
@@ -236376,7 +236376,7 @@ var init_schemas = __esm({
236376
236376
  {
236377
236377
  $schema: "http://json-schema.org/draft-07/schema#",
236378
236378
  title: "surface",
236379
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
236379
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
236380
236380
  anyOf: [
236381
236381
  {
236382
236382
  title: "Surface (by name)",
@@ -237000,7 +237000,7 @@ var init_schemas = __esm({
237000
237000
  items: {
237001
237001
  $schema: "http://json-schema.org/draft-07/schema#",
237002
237002
  title: "surface",
237003
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
237003
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
237004
237004
  anyOf: [
237005
237005
  {
237006
237006
  title: "Surface (by name)",
@@ -244756,7 +244756,7 @@ var init_schemas = __esm({
244756
244756
  description: "Duration of the swipe movement in milliseconds."
244757
244757
  },
244758
244758
  surface: {
244759
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
244759
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
244760
244760
  anyOf: [
244761
244761
  {
244762
244762
  title: "Surface (by browser engine)",
@@ -245037,7 +245037,7 @@ var init_schemas = __esm({
245037
245037
  description: "Duration of the swipe movement in milliseconds."
245038
245038
  },
245039
245039
  surface: {
245040
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
245040
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
245041
245041
  anyOf: [
245042
245042
  {
245043
245043
  title: "Surface (by browser engine)",
@@ -245301,7 +245301,7 @@ var init_schemas = __esm({
245301
245301
  description: "Duration of the swipe movement in milliseconds."
245302
245302
  },
245303
245303
  surface: {
245304
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
245304
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
245305
245305
  anyOf: [
245306
245306
  {
245307
245307
  title: "Surface (by browser engine)",
@@ -245553,7 +245553,7 @@ var init_schemas = __esm({
245553
245553
  description: "Duration of the swipe movement in milliseconds."
245554
245554
  },
245555
245555
  surface: {
245556
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
245556
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
245557
245557
  anyOf: [
245558
245558
  {
245559
245559
  title: "Surface (by browser engine)",
@@ -245834,7 +245834,7 @@ var init_schemas = __esm({
245834
245834
  description: "Duration of the swipe movement in milliseconds."
245835
245835
  },
245836
245836
  surface: {
245837
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
245837
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
245838
245838
  anyOf: [
245839
245839
  {
245840
245840
  title: "Surface (by browser engine)",
@@ -260605,7 +260605,7 @@ var init_schemas = __esm({
260605
260605
  minimum: 1
260606
260606
  },
260607
260607
  surface: {
260608
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
260608
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
260609
260609
  anyOf: [
260610
260610
  {
260611
260611
  title: "Surface (by browser engine)",
@@ -260958,7 +260958,7 @@ var init_schemas = __esm({
260958
260958
  minimum: 1
260959
260959
  },
260960
260960
  surface: {
260961
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
260961
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
260962
260962
  anyOf: [
260963
260963
  {
260964
260964
  title: "Surface (by browser engine)",
@@ -262248,7 +262248,7 @@ var init_schemas = __esm({
262248
262248
  additionalProperties: false,
262249
262249
  properties: {
262250
262250
  surface: {
262251
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
262251
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
262252
262252
  anyOf: [
262253
262253
  {
262254
262254
  title: "Surface (by browser engine)",
@@ -262597,7 +262597,7 @@ var init_schemas = __esm({
262597
262597
  minimum: 1
262598
262598
  },
262599
262599
  surface: {
262600
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
262600
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
262601
262601
  anyOf: [
262602
262602
  {
262603
262603
  title: "Surface (by browser engine)",
@@ -262950,7 +262950,7 @@ var init_schemas = __esm({
262950
262950
  minimum: 1
262951
262951
  },
262952
262952
  surface: {
262953
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
262953
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
262954
262954
  anyOf: [
262955
262955
  {
262956
262956
  title: "Surface (by browser engine)",
@@ -263320,7 +263320,7 @@ var init_schemas = __esm({
263320
263320
  surface: {
263321
263321
  $schema: "http://json-schema.org/draft-07/schema#",
263322
263322
  title: "surface",
263323
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
263323
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
263324
263324
  anyOf: [
263325
263325
  {
263326
263326
  title: "Surface (by name)",
@@ -264817,7 +264817,7 @@ var init_schemas = __esm({
264817
264817
  surface: {
264818
264818
  $schema: "http://json-schema.org/draft-07/schema#",
264819
264819
  title: "surface",
264820
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
264820
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
264821
264821
  anyOf: [
264822
264822
  {
264823
264823
  title: "Surface (by name)",
@@ -266394,7 +266394,7 @@ var init_schemas = __esm({
266394
266394
  additionalProperties: false,
266395
266395
  properties: {
266396
266396
  surface: {
266397
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
266397
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
266398
266398
  anyOf: [
266399
266399
  {
266400
266400
  title: "Surface (by browser engine)",
@@ -266743,7 +266743,7 @@ var init_schemas = __esm({
266743
266743
  minimum: 1
266744
266744
  },
266745
266745
  surface: {
266746
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
266746
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
266747
266747
  anyOf: [
266748
266748
  {
266749
266749
  title: "Surface (by browser engine)",
@@ -267096,7 +267096,7 @@ var init_schemas = __esm({
267096
267096
  minimum: 1
267097
267097
  },
267098
267098
  surface: {
267099
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
267099
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
267100
267100
  anyOf: [
267101
267101
  {
267102
267102
  title: "Surface (by browser engine)",
@@ -267466,7 +267466,7 @@ var init_schemas = __esm({
267466
267466
  surface: {
267467
267467
  $schema: "http://json-schema.org/draft-07/schema#",
267468
267468
  title: "surface",
267469
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
267469
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
267470
267470
  anyOf: [
267471
267471
  {
267472
267472
  title: "Surface (by name)",
@@ -268963,7 +268963,7 @@ var init_schemas = __esm({
268963
268963
  surface: {
268964
268964
  $schema: "http://json-schema.org/draft-07/schema#",
268965
268965
  title: "surface",
268966
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
268966
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
268967
268967
  anyOf: [
268968
268968
  {
268969
268969
  title: "Surface (by name)",
@@ -279655,7 +279655,7 @@ var init_schemas = __esm({
279655
279655
  surface: {
279656
279656
  $schema: "http://json-schema.org/draft-07/schema#",
279657
279657
  title: "surface",
279658
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
279658
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
279659
279659
  anyOf: [
279660
279660
  {
279661
279661
  title: "Surface (by name)",
@@ -281152,7 +281152,7 @@ var init_schemas = __esm({
281152
281152
  surface: {
281153
281153
  $schema: "http://json-schema.org/draft-07/schema#",
281154
281154
  title: "surface",
281155
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
281155
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
281156
281156
  anyOf: [
281157
281157
  {
281158
281158
  title: "Surface (by name)",
@@ -283631,7 +283631,7 @@ var init_schemas = __esm({
283631
283631
  additionalProperties: false,
283632
283632
  properties: {
283633
283633
  surface: {
283634
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
283634
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
283635
283635
  anyOf: [
283636
283636
  {
283637
283637
  title: "Surface (by browser engine)",
@@ -286182,7 +286182,7 @@ var init_schemas = __esm({
286182
286182
  additionalProperties: false,
286183
286183
  properties: {
286184
286184
  surface: {
286185
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
286185
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
286186
286186
  anyOf: [
286187
286187
  {
286188
286188
  title: "Surface (by browser engine)",
@@ -288712,7 +288712,7 @@ var init_schemas = __esm({
288712
288712
  additionalProperties: false,
288713
288713
  properties: {
288714
288714
  surface: {
288715
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
288715
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
288716
288716
  anyOf: [
288717
288717
  {
288718
288718
  title: "Surface (by browser engine)",
@@ -296438,7 +296438,7 @@ var init_schemas = __esm({
296438
296438
  {
296439
296439
  $schema: "http://json-schema.org/draft-07/schema#",
296440
296440
  title: "surface",
296441
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
296441
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
296442
296442
  anyOf: [
296443
296443
  {
296444
296444
  title: "Surface (by name)",
@@ -297062,7 +297062,7 @@ var init_schemas = __esm({
297062
297062
  items: {
297063
297063
  $schema: "http://json-schema.org/draft-07/schema#",
297064
297064
  title: "surface",
297065
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
297065
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
297066
297066
  anyOf: [
297067
297067
  {
297068
297068
  title: "Surface (by name)",
@@ -304818,7 +304818,7 @@ var init_schemas = __esm({
304818
304818
  description: "Duration of the swipe movement in milliseconds."
304819
304819
  },
304820
304820
  surface: {
304821
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
304821
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
304822
304822
  anyOf: [
304823
304823
  {
304824
304824
  title: "Surface (by browser engine)",
@@ -305099,7 +305099,7 @@ var init_schemas = __esm({
305099
305099
  description: "Duration of the swipe movement in milliseconds."
305100
305100
  },
305101
305101
  surface: {
305102
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
305102
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
305103
305103
  anyOf: [
305104
305104
  {
305105
305105
  title: "Surface (by browser engine)",
@@ -305363,7 +305363,7 @@ var init_schemas = __esm({
305363
305363
  description: "Duration of the swipe movement in milliseconds."
305364
305364
  },
305365
305365
  surface: {
305366
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
305366
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
305367
305367
  anyOf: [
305368
305368
  {
305369
305369
  title: "Surface (by browser engine)",
@@ -305615,7 +305615,7 @@ var init_schemas = __esm({
305615
305615
  description: "Duration of the swipe movement in milliseconds."
305616
305616
  },
305617
305617
  surface: {
305618
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
305618
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
305619
305619
  anyOf: [
305620
305620
  {
305621
305621
  title: "Surface (by browser engine)",
@@ -305896,7 +305896,7 @@ var init_schemas = __esm({
305896
305896
  description: "Duration of the swipe movement in milliseconds."
305897
305897
  },
305898
305898
  surface: {
305899
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
305899
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
305900
305900
  anyOf: [
305901
305901
  {
305902
305902
  title: "Surface (by browser engine)",
@@ -317088,7 +317088,7 @@ var init_schemas = __esm({
317088
317088
  minimum: 1
317089
317089
  },
317090
317090
  surface: {
317091
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
317091
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
317092
317092
  anyOf: [
317093
317093
  {
317094
317094
  title: "Surface (by browser engine)",
@@ -317441,7 +317441,7 @@ var init_schemas = __esm({
317441
317441
  minimum: 1
317442
317442
  },
317443
317443
  surface: {
317444
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
317444
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
317445
317445
  anyOf: [
317446
317446
  {
317447
317447
  title: "Surface (by browser engine)",
@@ -318731,7 +318731,7 @@ var init_schemas = __esm({
318731
318731
  additionalProperties: false,
318732
318732
  properties: {
318733
318733
  surface: {
318734
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
318734
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
318735
318735
  anyOf: [
318736
318736
  {
318737
318737
  title: "Surface (by browser engine)",
@@ -319080,7 +319080,7 @@ var init_schemas = __esm({
319080
319080
  minimum: 1
319081
319081
  },
319082
319082
  surface: {
319083
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
319083
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
319084
319084
  anyOf: [
319085
319085
  {
319086
319086
  title: "Surface (by browser engine)",
@@ -319433,7 +319433,7 @@ var init_schemas = __esm({
319433
319433
  minimum: 1
319434
319434
  },
319435
319435
  surface: {
319436
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
319436
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
319437
319437
  anyOf: [
319438
319438
  {
319439
319439
  title: "Surface (by browser engine)",
@@ -319803,7 +319803,7 @@ var init_schemas = __esm({
319803
319803
  surface: {
319804
319804
  $schema: "http://json-schema.org/draft-07/schema#",
319805
319805
  title: "surface",
319806
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
319806
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
319807
319807
  anyOf: [
319808
319808
  {
319809
319809
  title: "Surface (by name)",
@@ -321300,7 +321300,7 @@ var init_schemas = __esm({
321300
321300
  surface: {
321301
321301
  $schema: "http://json-schema.org/draft-07/schema#",
321302
321302
  title: "surface",
321303
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
321303
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
321304
321304
  anyOf: [
321305
321305
  {
321306
321306
  title: "Surface (by name)",
@@ -322877,7 +322877,7 @@ var init_schemas = __esm({
322877
322877
  additionalProperties: false,
322878
322878
  properties: {
322879
322879
  surface: {
322880
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
322880
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
322881
322881
  anyOf: [
322882
322882
  {
322883
322883
  title: "Surface (by browser engine)",
@@ -323226,7 +323226,7 @@ var init_schemas = __esm({
323226
323226
  minimum: 1
323227
323227
  },
323228
323228
  surface: {
323229
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
323229
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
323230
323230
  anyOf: [
323231
323231
  {
323232
323232
  title: "Surface (by browser engine)",
@@ -323579,7 +323579,7 @@ var init_schemas = __esm({
323579
323579
  minimum: 1
323580
323580
  },
323581
323581
  surface: {
323582
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
323582
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
323583
323583
  anyOf: [
323584
323584
  {
323585
323585
  title: "Surface (by browser engine)",
@@ -323949,7 +323949,7 @@ var init_schemas = __esm({
323949
323949
  surface: {
323950
323950
  $schema: "http://json-schema.org/draft-07/schema#",
323951
323951
  title: "surface",
323952
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
323952
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
323953
323953
  anyOf: [
323954
323954
  {
323955
323955
  title: "Surface (by name)",
@@ -325446,7 +325446,7 @@ var init_schemas = __esm({
325446
325446
  surface: {
325447
325447
  $schema: "http://json-schema.org/draft-07/schema#",
325448
325448
  title: "surface",
325449
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
325449
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
325450
325450
  anyOf: [
325451
325451
  {
325452
325452
  title: "Surface (by name)",
@@ -336138,7 +336138,7 @@ var init_schemas = __esm({
336138
336138
  surface: {
336139
336139
  $schema: "http://json-schema.org/draft-07/schema#",
336140
336140
  title: "surface",
336141
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
336141
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
336142
336142
  anyOf: [
336143
336143
  {
336144
336144
  title: "Surface (by name)",
@@ -337635,7 +337635,7 @@ var init_schemas = __esm({
337635
337635
  surface: {
337636
337636
  $schema: "http://json-schema.org/draft-07/schema#",
337637
337637
  title: "surface",
337638
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
337638
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
337639
337639
  anyOf: [
337640
337640
  {
337641
337641
  title: "Surface (by name)",
@@ -340114,7 +340114,7 @@ var init_schemas = __esm({
340114
340114
  additionalProperties: false,
340115
340115
  properties: {
340116
340116
  surface: {
340117
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
340117
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
340118
340118
  anyOf: [
340119
340119
  {
340120
340120
  title: "Surface (by browser engine)",
@@ -342665,7 +342665,7 @@ var init_schemas = __esm({
342665
342665
  additionalProperties: false,
342666
342666
  properties: {
342667
342667
  surface: {
342668
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
342668
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
342669
342669
  anyOf: [
342670
342670
  {
342671
342671
  title: "Surface (by browser engine)",
@@ -345195,7 +345195,7 @@ var init_schemas = __esm({
345195
345195
  additionalProperties: false,
345196
345196
  properties: {
345197
345197
  surface: {
345198
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
345198
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
345199
345199
  anyOf: [
345200
345200
  {
345201
345201
  title: "Surface (by browser engine)",
@@ -352921,7 +352921,7 @@ var init_schemas = __esm({
352921
352921
  {
352922
352922
  $schema: "http://json-schema.org/draft-07/schema#",
352923
352923
  title: "surface",
352924
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
352924
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
352925
352925
  anyOf: [
352926
352926
  {
352927
352927
  title: "Surface (by name)",
@@ -353545,7 +353545,7 @@ var init_schemas = __esm({
353545
353545
  items: {
353546
353546
  $schema: "http://json-schema.org/draft-07/schema#",
353547
353547
  title: "surface",
353548
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
353548
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
353549
353549
  anyOf: [
353550
353550
  {
353551
353551
  title: "Surface (by name)",
@@ -361301,7 +361301,7 @@ var init_schemas = __esm({
361301
361301
  description: "Duration of the swipe movement in milliseconds."
361302
361302
  },
361303
361303
  surface: {
361304
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
361304
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
361305
361305
  anyOf: [
361306
361306
  {
361307
361307
  title: "Surface (by browser engine)",
@@ -361582,7 +361582,7 @@ var init_schemas = __esm({
361582
361582
  description: "Duration of the swipe movement in milliseconds."
361583
361583
  },
361584
361584
  surface: {
361585
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
361585
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
361586
361586
  anyOf: [
361587
361587
  {
361588
361588
  title: "Surface (by browser engine)",
@@ -361846,7 +361846,7 @@ var init_schemas = __esm({
361846
361846
  description: "Duration of the swipe movement in milliseconds."
361847
361847
  },
361848
361848
  surface: {
361849
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
361849
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
361850
361850
  anyOf: [
361851
361851
  {
361852
361852
  title: "Surface (by browser engine)",
@@ -362098,7 +362098,7 @@ var init_schemas = __esm({
362098
362098
  description: "Duration of the swipe movement in milliseconds."
362099
362099
  },
362100
362100
  surface: {
362101
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
362101
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
362102
362102
  anyOf: [
362103
362103
  {
362104
362104
  title: "Surface (by browser engine)",
@@ -362379,7 +362379,7 @@ var init_schemas = __esm({
362379
362379
  description: "Duration of the swipe movement in milliseconds."
362380
362380
  },
362381
362381
  surface: {
362382
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
362382
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
362383
362383
  anyOf: [
362384
362384
  {
362385
362385
  title: "Surface (by browser engine)",
@@ -377670,7 +377670,7 @@ var init_schemas = __esm({
377670
377670
  minimum: 1
377671
377671
  },
377672
377672
  surface: {
377673
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
377673
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
377674
377674
  anyOf: [
377675
377675
  {
377676
377676
  title: "Surface (by browser engine)",
@@ -378023,7 +378023,7 @@ var init_schemas = __esm({
378023
378023
  minimum: 1
378024
378024
  },
378025
378025
  surface: {
378026
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
378026
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
378027
378027
  anyOf: [
378028
378028
  {
378029
378029
  title: "Surface (by browser engine)",
@@ -379313,7 +379313,7 @@ var init_schemas = __esm({
379313
379313
  additionalProperties: false,
379314
379314
  properties: {
379315
379315
  surface: {
379316
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
379316
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
379317
379317
  anyOf: [
379318
379318
  {
379319
379319
  title: "Surface (by browser engine)",
@@ -379662,7 +379662,7 @@ var init_schemas = __esm({
379662
379662
  minimum: 1
379663
379663
  },
379664
379664
  surface: {
379665
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
379665
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
379666
379666
  anyOf: [
379667
379667
  {
379668
379668
  title: "Surface (by browser engine)",
@@ -380015,7 +380015,7 @@ var init_schemas = __esm({
380015
380015
  minimum: 1
380016
380016
  },
380017
380017
  surface: {
380018
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
380018
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
380019
380019
  anyOf: [
380020
380020
  {
380021
380021
  title: "Surface (by browser engine)",
@@ -380385,7 +380385,7 @@ var init_schemas = __esm({
380385
380385
  surface: {
380386
380386
  $schema: "http://json-schema.org/draft-07/schema#",
380387
380387
  title: "surface",
380388
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
380388
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
380389
380389
  anyOf: [
380390
380390
  {
380391
380391
  title: "Surface (by name)",
@@ -381882,7 +381882,7 @@ var init_schemas = __esm({
381882
381882
  surface: {
381883
381883
  $schema: "http://json-schema.org/draft-07/schema#",
381884
381884
  title: "surface",
381885
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
381885
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
381886
381886
  anyOf: [
381887
381887
  {
381888
381888
  title: "Surface (by name)",
@@ -383459,7 +383459,7 @@ var init_schemas = __esm({
383459
383459
  additionalProperties: false,
383460
383460
  properties: {
383461
383461
  surface: {
383462
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
383462
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
383463
383463
  anyOf: [
383464
383464
  {
383465
383465
  title: "Surface (by browser engine)",
@@ -383808,7 +383808,7 @@ var init_schemas = __esm({
383808
383808
  minimum: 1
383809
383809
  },
383810
383810
  surface: {
383811
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
383811
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
383812
383812
  anyOf: [
383813
383813
  {
383814
383814
  title: "Surface (by browser engine)",
@@ -384161,7 +384161,7 @@ var init_schemas = __esm({
384161
384161
  minimum: 1
384162
384162
  },
384163
384163
  surface: {
384164
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
384164
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
384165
384165
  anyOf: [
384166
384166
  {
384167
384167
  title: "Surface (by browser engine)",
@@ -384531,7 +384531,7 @@ var init_schemas = __esm({
384531
384531
  surface: {
384532
384532
  $schema: "http://json-schema.org/draft-07/schema#",
384533
384533
  title: "surface",
384534
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
384534
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
384535
384535
  anyOf: [
384536
384536
  {
384537
384537
  title: "Surface (by name)",
@@ -386028,7 +386028,7 @@ var init_schemas = __esm({
386028
386028
  surface: {
386029
386029
  $schema: "http://json-schema.org/draft-07/schema#",
386030
386030
  title: "surface",
386031
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
386031
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
386032
386032
  anyOf: [
386033
386033
  {
386034
386034
  title: "Surface (by name)",
@@ -396720,7 +396720,7 @@ var init_schemas = __esm({
396720
396720
  surface: {
396721
396721
  $schema: "http://json-schema.org/draft-07/schema#",
396722
396722
  title: "surface",
396723
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
396723
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
396724
396724
  anyOf: [
396725
396725
  {
396726
396726
  title: "Surface (by name)",
@@ -398217,7 +398217,7 @@ var init_schemas = __esm({
398217
398217
  surface: {
398218
398218
  $schema: "http://json-schema.org/draft-07/schema#",
398219
398219
  title: "surface",
398220
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
398220
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
398221
398221
  anyOf: [
398222
398222
  {
398223
398223
  title: "Surface (by name)",
@@ -400696,7 +400696,7 @@ var init_schemas = __esm({
400696
400696
  additionalProperties: false,
400697
400697
  properties: {
400698
400698
  surface: {
400699
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
400699
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
400700
400700
  anyOf: [
400701
400701
  {
400702
400702
  title: "Surface (by browser engine)",
@@ -403247,7 +403247,7 @@ var init_schemas = __esm({
403247
403247
  additionalProperties: false,
403248
403248
  properties: {
403249
403249
  surface: {
403250
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
403250
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
403251
403251
  anyOf: [
403252
403252
  {
403253
403253
  title: "Surface (by browser engine)",
@@ -405777,7 +405777,7 @@ var init_schemas = __esm({
405777
405777
  additionalProperties: false,
405778
405778
  properties: {
405779
405779
  surface: {
405780
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
405780
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
405781
405781
  anyOf: [
405782
405782
  {
405783
405783
  title: "Surface (by browser engine)",
@@ -413503,7 +413503,7 @@ var init_schemas = __esm({
413503
413503
  {
413504
413504
  $schema: "http://json-schema.org/draft-07/schema#",
413505
413505
  title: "surface",
413506
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
413506
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
413507
413507
  anyOf: [
413508
413508
  {
413509
413509
  title: "Surface (by name)",
@@ -414127,7 +414127,7 @@ var init_schemas = __esm({
414127
414127
  items: {
414128
414128
  $schema: "http://json-schema.org/draft-07/schema#",
414129
414129
  title: "surface",
414130
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
414130
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
414131
414131
  anyOf: [
414132
414132
  {
414133
414133
  title: "Surface (by name)",
@@ -421883,7 +421883,7 @@ var init_schemas = __esm({
421883
421883
  description: "Duration of the swipe movement in milliseconds."
421884
421884
  },
421885
421885
  surface: {
421886
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
421886
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
421887
421887
  anyOf: [
421888
421888
  {
421889
421889
  title: "Surface (by browser engine)",
@@ -422164,7 +422164,7 @@ var init_schemas = __esm({
422164
422164
  description: "Duration of the swipe movement in milliseconds."
422165
422165
  },
422166
422166
  surface: {
422167
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
422167
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
422168
422168
  anyOf: [
422169
422169
  {
422170
422170
  title: "Surface (by browser engine)",
@@ -422428,7 +422428,7 @@ var init_schemas = __esm({
422428
422428
  description: "Duration of the swipe movement in milliseconds."
422429
422429
  },
422430
422430
  surface: {
422431
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
422431
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
422432
422432
  anyOf: [
422433
422433
  {
422434
422434
  title: "Surface (by browser engine)",
@@ -422680,7 +422680,7 @@ var init_schemas = __esm({
422680
422680
  description: "Duration of the swipe movement in milliseconds."
422681
422681
  },
422682
422682
  surface: {
422683
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
422683
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
422684
422684
  anyOf: [
422685
422685
  {
422686
422686
  title: "Surface (by browser engine)",
@@ -422961,7 +422961,7 @@ var init_schemas = __esm({
422961
422961
  description: "Duration of the swipe movement in milliseconds."
422962
422962
  },
422963
422963
  surface: {
422964
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
422964
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
422965
422965
  anyOf: [
422966
422966
  {
422967
422967
  title: "Surface (by browser engine)",
@@ -434153,7 +434153,7 @@ var init_schemas = __esm({
434153
434153
  minimum: 1
434154
434154
  },
434155
434155
  surface: {
434156
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
434156
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
434157
434157
  anyOf: [
434158
434158
  {
434159
434159
  title: "Surface (by browser engine)",
@@ -434506,7 +434506,7 @@ var init_schemas = __esm({
434506
434506
  minimum: 1
434507
434507
  },
434508
434508
  surface: {
434509
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
434509
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
434510
434510
  anyOf: [
434511
434511
  {
434512
434512
  title: "Surface (by browser engine)",
@@ -435796,7 +435796,7 @@ var init_schemas = __esm({
435796
435796
  additionalProperties: false,
435797
435797
  properties: {
435798
435798
  surface: {
435799
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
435799
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
435800
435800
  anyOf: [
435801
435801
  {
435802
435802
  title: "Surface (by browser engine)",
@@ -436145,7 +436145,7 @@ var init_schemas = __esm({
436145
436145
  minimum: 1
436146
436146
  },
436147
436147
  surface: {
436148
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
436148
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
436149
436149
  anyOf: [
436150
436150
  {
436151
436151
  title: "Surface (by browser engine)",
@@ -436498,7 +436498,7 @@ var init_schemas = __esm({
436498
436498
  minimum: 1
436499
436499
  },
436500
436500
  surface: {
436501
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
436501
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
436502
436502
  anyOf: [
436503
436503
  {
436504
436504
  title: "Surface (by browser engine)",
@@ -436868,7 +436868,7 @@ var init_schemas = __esm({
436868
436868
  surface: {
436869
436869
  $schema: "http://json-schema.org/draft-07/schema#",
436870
436870
  title: "surface",
436871
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
436871
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
436872
436872
  anyOf: [
436873
436873
  {
436874
436874
  title: "Surface (by name)",
@@ -438365,7 +438365,7 @@ var init_schemas = __esm({
438365
438365
  surface: {
438366
438366
  $schema: "http://json-schema.org/draft-07/schema#",
438367
438367
  title: "surface",
438368
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
438368
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
438369
438369
  anyOf: [
438370
438370
  {
438371
438371
  title: "Surface (by name)",
@@ -439942,7 +439942,7 @@ var init_schemas = __esm({
439942
439942
  additionalProperties: false,
439943
439943
  properties: {
439944
439944
  surface: {
439945
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
439945
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
439946
439946
  anyOf: [
439947
439947
  {
439948
439948
  title: "Surface (by browser engine)",
@@ -440291,7 +440291,7 @@ var init_schemas = __esm({
440291
440291
  minimum: 1
440292
440292
  },
440293
440293
  surface: {
440294
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
440294
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
440295
440295
  anyOf: [
440296
440296
  {
440297
440297
  title: "Surface (by browser engine)",
@@ -440644,7 +440644,7 @@ var init_schemas = __esm({
440644
440644
  minimum: 1
440645
440645
  },
440646
440646
  surface: {
440647
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
440647
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
440648
440648
  anyOf: [
440649
440649
  {
440650
440650
  title: "Surface (by browser engine)",
@@ -441014,7 +441014,7 @@ var init_schemas = __esm({
441014
441014
  surface: {
441015
441015
  $schema: "http://json-schema.org/draft-07/schema#",
441016
441016
  title: "surface",
441017
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
441017
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
441018
441018
  anyOf: [
441019
441019
  {
441020
441020
  title: "Surface (by name)",
@@ -442511,7 +442511,7 @@ var init_schemas = __esm({
442511
442511
  surface: {
442512
442512
  $schema: "http://json-schema.org/draft-07/schema#",
442513
442513
  title: "surface",
442514
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
442514
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
442515
442515
  anyOf: [
442516
442516
  {
442517
442517
  title: "Surface (by name)",
@@ -453203,7 +453203,7 @@ var init_schemas = __esm({
453203
453203
  surface: {
453204
453204
  $schema: "http://json-schema.org/draft-07/schema#",
453205
453205
  title: "surface",
453206
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
453206
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
453207
453207
  anyOf: [
453208
453208
  {
453209
453209
  title: "Surface (by name)",
@@ -454700,7 +454700,7 @@ var init_schemas = __esm({
454700
454700
  surface: {
454701
454701
  $schema: "http://json-schema.org/draft-07/schema#",
454702
454702
  title: "surface",
454703
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
454703
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
454704
454704
  anyOf: [
454705
454705
  {
454706
454706
  title: "Surface (by name)",
@@ -457179,7 +457179,7 @@ var init_schemas = __esm({
457179
457179
  additionalProperties: false,
457180
457180
  properties: {
457181
457181
  surface: {
457182
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
457182
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
457183
457183
  anyOf: [
457184
457184
  {
457185
457185
  title: "Surface (by browser engine)",
@@ -459730,7 +459730,7 @@ var init_schemas = __esm({
459730
459730
  additionalProperties: false,
459731
459731
  properties: {
459732
459732
  surface: {
459733
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
459733
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
459734
459734
  anyOf: [
459735
459735
  {
459736
459736
  title: "Surface (by browser engine)",
@@ -462260,7 +462260,7 @@ var init_schemas = __esm({
462260
462260
  additionalProperties: false,
462261
462261
  properties: {
462262
462262
  surface: {
462263
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
462263
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
462264
462264
  anyOf: [
462265
462265
  {
462266
462266
  title: "Surface (by browser engine)",
@@ -469986,7 +469986,7 @@ var init_schemas = __esm({
469986
469986
  {
469987
469987
  $schema: "http://json-schema.org/draft-07/schema#",
469988
469988
  title: "surface",
469989
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
469989
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
469990
469990
  anyOf: [
469991
469991
  {
469992
469992
  title: "Surface (by name)",
@@ -470610,7 +470610,7 @@ var init_schemas = __esm({
470610
470610
  items: {
470611
470611
  $schema: "http://json-schema.org/draft-07/schema#",
470612
470612
  title: "surface",
470613
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
470613
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
470614
470614
  anyOf: [
470615
470615
  {
470616
470616
  title: "Surface (by name)",
@@ -478366,7 +478366,7 @@ var init_schemas = __esm({
478366
478366
  description: "Duration of the swipe movement in milliseconds."
478367
478367
  },
478368
478368
  surface: {
478369
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
478369
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
478370
478370
  anyOf: [
478371
478371
  {
478372
478372
  title: "Surface (by browser engine)",
@@ -478647,7 +478647,7 @@ var init_schemas = __esm({
478647
478647
  description: "Duration of the swipe movement in milliseconds."
478648
478648
  },
478649
478649
  surface: {
478650
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
478650
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
478651
478651
  anyOf: [
478652
478652
  {
478653
478653
  title: "Surface (by browser engine)",
@@ -478911,7 +478911,7 @@ var init_schemas = __esm({
478911
478911
  description: "Duration of the swipe movement in milliseconds."
478912
478912
  },
478913
478913
  surface: {
478914
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
478914
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
478915
478915
  anyOf: [
478916
478916
  {
478917
478917
  title: "Surface (by browser engine)",
@@ -479163,7 +479163,7 @@ var init_schemas = __esm({
479163
479163
  description: "Duration of the swipe movement in milliseconds."
479164
479164
  },
479165
479165
  surface: {
479166
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
479166
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
479167
479167
  anyOf: [
479168
479168
  {
479169
479169
  title: "Surface (by browser engine)",
@@ -479444,7 +479444,7 @@ var init_schemas = __esm({
479444
479444
  description: "Duration of the swipe movement in milliseconds."
479445
479445
  },
479446
479446
  surface: {
479447
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
479447
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
479448
479448
  anyOf: [
479449
479449
  {
479450
479450
  title: "Surface (by browser engine)",
@@ -488820,7 +488820,7 @@ var init_schemas = __esm({
488820
488820
  additionalProperties: false,
488821
488821
  properties: {
488822
488822
  surface: {
488823
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
488823
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
488824
488824
  anyOf: [
488825
488825
  {
488826
488826
  title: "Surface (by browser engine)",
@@ -491371,7 +491371,7 @@ var init_schemas = __esm({
491371
491371
  additionalProperties: false,
491372
491372
  properties: {
491373
491373
  surface: {
491374
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
491374
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
491375
491375
  anyOf: [
491376
491376
  {
491377
491377
  title: "Surface (by browser engine)",
@@ -493901,7 +493901,7 @@ var init_schemas = __esm({
493901
493901
  additionalProperties: false,
493902
493902
  properties: {
493903
493903
  surface: {
493904
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
493904
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
493905
493905
  anyOf: [
493906
493906
  {
493907
493907
  title: "Surface (by browser engine)",
@@ -504247,7 +504247,7 @@ var init_schemas = __esm({
504247
504247
  minimum: 1
504248
504248
  },
504249
504249
  surface: {
504250
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
504250
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
504251
504251
  anyOf: [
504252
504252
  {
504253
504253
  title: "Surface (by browser engine)",
@@ -504600,7 +504600,7 @@ var init_schemas = __esm({
504600
504600
  minimum: 1
504601
504601
  },
504602
504602
  surface: {
504603
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
504603
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
504604
504604
  anyOf: [
504605
504605
  {
504606
504606
  title: "Surface (by browser engine)",
@@ -505890,7 +505890,7 @@ var init_schemas = __esm({
505890
505890
  additionalProperties: false,
505891
505891
  properties: {
505892
505892
  surface: {
505893
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
505893
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
505894
505894
  anyOf: [
505895
505895
  {
505896
505896
  title: "Surface (by browser engine)",
@@ -506239,7 +506239,7 @@ var init_schemas = __esm({
506239
506239
  minimum: 1
506240
506240
  },
506241
506241
  surface: {
506242
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
506242
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
506243
506243
  anyOf: [
506244
506244
  {
506245
506245
  title: "Surface (by browser engine)",
@@ -506592,7 +506592,7 @@ var init_schemas = __esm({
506592
506592
  minimum: 1
506593
506593
  },
506594
506594
  surface: {
506595
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
506595
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
506596
506596
  anyOf: [
506597
506597
  {
506598
506598
  title: "Surface (by browser engine)",
@@ -506962,7 +506962,7 @@ var init_schemas = __esm({
506962
506962
  surface: {
506963
506963
  $schema: "http://json-schema.org/draft-07/schema#",
506964
506964
  title: "surface",
506965
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
506965
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
506966
506966
  anyOf: [
506967
506967
  {
506968
506968
  title: "Surface (by name)",
@@ -508459,7 +508459,7 @@ var init_schemas = __esm({
508459
508459
  surface: {
508460
508460
  $schema: "http://json-schema.org/draft-07/schema#",
508461
508461
  title: "surface",
508462
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
508462
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
508463
508463
  anyOf: [
508464
508464
  {
508465
508465
  title: "Surface (by name)",
@@ -510036,7 +510036,7 @@ var init_schemas = __esm({
510036
510036
  additionalProperties: false,
510037
510037
  properties: {
510038
510038
  surface: {
510039
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
510039
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
510040
510040
  anyOf: [
510041
510041
  {
510042
510042
  title: "Surface (by browser engine)",
@@ -510385,7 +510385,7 @@ var init_schemas = __esm({
510385
510385
  minimum: 1
510386
510386
  },
510387
510387
  surface: {
510388
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
510388
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
510389
510389
  anyOf: [
510390
510390
  {
510391
510391
  title: "Surface (by browser engine)",
@@ -510738,7 +510738,7 @@ var init_schemas = __esm({
510738
510738
  minimum: 1
510739
510739
  },
510740
510740
  surface: {
510741
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
510741
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
510742
510742
  anyOf: [
510743
510743
  {
510744
510744
  title: "Surface (by browser engine)",
@@ -511108,7 +511108,7 @@ var init_schemas = __esm({
511108
511108
  surface: {
511109
511109
  $schema: "http://json-schema.org/draft-07/schema#",
511110
511110
  title: "surface",
511111
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
511111
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
511112
511112
  anyOf: [
511113
511113
  {
511114
511114
  title: "Surface (by name)",
@@ -512605,7 +512605,7 @@ var init_schemas = __esm({
512605
512605
  surface: {
512606
512606
  $schema: "http://json-schema.org/draft-07/schema#",
512607
512607
  title: "surface",
512608
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
512608
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
512609
512609
  anyOf: [
512610
512610
  {
512611
512611
  title: "Surface (by name)",
@@ -523297,7 +523297,7 @@ var init_schemas = __esm({
523297
523297
  surface: {
523298
523298
  $schema: "http://json-schema.org/draft-07/schema#",
523299
523299
  title: "surface",
523300
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
523300
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
523301
523301
  anyOf: [
523302
523302
  {
523303
523303
  title: "Surface (by name)",
@@ -524794,7 +524794,7 @@ var init_schemas = __esm({
524794
524794
  surface: {
524795
524795
  $schema: "http://json-schema.org/draft-07/schema#",
524796
524796
  title: "surface",
524797
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
524797
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
524798
524798
  anyOf: [
524799
524799
  {
524800
524800
  title: "Surface (by name)",
@@ -527273,7 +527273,7 @@ var init_schemas = __esm({
527273
527273
  additionalProperties: false,
527274
527274
  properties: {
527275
527275
  surface: {
527276
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
527276
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
527277
527277
  anyOf: [
527278
527278
  {
527279
527279
  title: "Surface (by browser engine)",
@@ -529824,7 +529824,7 @@ var init_schemas = __esm({
529824
529824
  additionalProperties: false,
529825
529825
  properties: {
529826
529826
  surface: {
529827
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
529827
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
529828
529828
  anyOf: [
529829
529829
  {
529830
529830
  title: "Surface (by browser engine)",
@@ -532354,7 +532354,7 @@ var init_schemas = __esm({
532354
532354
  additionalProperties: false,
532355
532355
  properties: {
532356
532356
  surface: {
532357
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
532357
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
532358
532358
  anyOf: [
532359
532359
  {
532360
532360
  title: "Surface (by browser engine)",
@@ -540080,7 +540080,7 @@ var init_schemas = __esm({
540080
540080
  {
540081
540081
  $schema: "http://json-schema.org/draft-07/schema#",
540082
540082
  title: "surface",
540083
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
540083
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
540084
540084
  anyOf: [
540085
540085
  {
540086
540086
  title: "Surface (by name)",
@@ -540704,7 +540704,7 @@ var init_schemas = __esm({
540704
540704
  items: {
540705
540705
  $schema: "http://json-schema.org/draft-07/schema#",
540706
540706
  title: "surface",
540707
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
540707
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
540708
540708
  anyOf: [
540709
540709
  {
540710
540710
  title: "Surface (by name)",
@@ -548460,7 +548460,7 @@ var init_schemas = __esm({
548460
548460
  description: "Duration of the swipe movement in milliseconds."
548461
548461
  },
548462
548462
  surface: {
548463
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
548463
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
548464
548464
  anyOf: [
548465
548465
  {
548466
548466
  title: "Surface (by browser engine)",
@@ -548741,7 +548741,7 @@ var init_schemas = __esm({
548741
548741
  description: "Duration of the swipe movement in milliseconds."
548742
548742
  },
548743
548743
  surface: {
548744
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
548744
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
548745
548745
  anyOf: [
548746
548746
  {
548747
548747
  title: "Surface (by browser engine)",
@@ -549005,7 +549005,7 @@ var init_schemas = __esm({
549005
549005
  description: "Duration of the swipe movement in milliseconds."
549006
549006
  },
549007
549007
  surface: {
549008
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
549008
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
549009
549009
  anyOf: [
549010
549010
  {
549011
549011
  title: "Surface (by browser engine)",
@@ -549257,7 +549257,7 @@ var init_schemas = __esm({
549257
549257
  description: "Duration of the swipe movement in milliseconds."
549258
549258
  },
549259
549259
  surface: {
549260
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
549260
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
549261
549261
  anyOf: [
549262
549262
  {
549263
549263
  title: "Surface (by browser engine)",
@@ -549538,7 +549538,7 @@ var init_schemas = __esm({
549538
549538
  description: "Duration of the swipe movement in milliseconds."
549539
549539
  },
549540
549540
  surface: {
549541
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
549541
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
549542
549542
  anyOf: [
549543
549543
  {
549544
549544
  title: "Surface (by browser engine)",
@@ -560730,7 +560730,7 @@ var init_schemas = __esm({
560730
560730
  minimum: 1
560731
560731
  },
560732
560732
  surface: {
560733
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
560733
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
560734
560734
  anyOf: [
560735
560735
  {
560736
560736
  title: "Surface (by browser engine)",
@@ -561083,7 +561083,7 @@ var init_schemas = __esm({
561083
561083
  minimum: 1
561084
561084
  },
561085
561085
  surface: {
561086
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
561086
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
561087
561087
  anyOf: [
561088
561088
  {
561089
561089
  title: "Surface (by browser engine)",
@@ -562373,7 +562373,7 @@ var init_schemas = __esm({
562373
562373
  additionalProperties: false,
562374
562374
  properties: {
562375
562375
  surface: {
562376
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
562376
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
562377
562377
  anyOf: [
562378
562378
  {
562379
562379
  title: "Surface (by browser engine)",
@@ -562722,7 +562722,7 @@ var init_schemas = __esm({
562722
562722
  minimum: 1
562723
562723
  },
562724
562724
  surface: {
562725
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
562725
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
562726
562726
  anyOf: [
562727
562727
  {
562728
562728
  title: "Surface (by browser engine)",
@@ -563075,7 +563075,7 @@ var init_schemas = __esm({
563075
563075
  minimum: 1
563076
563076
  },
563077
563077
  surface: {
563078
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
563078
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
563079
563079
  anyOf: [
563080
563080
  {
563081
563081
  title: "Surface (by browser engine)",
@@ -563445,7 +563445,7 @@ var init_schemas = __esm({
563445
563445
  surface: {
563446
563446
  $schema: "http://json-schema.org/draft-07/schema#",
563447
563447
  title: "surface",
563448
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
563448
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
563449
563449
  anyOf: [
563450
563450
  {
563451
563451
  title: "Surface (by name)",
@@ -564942,7 +564942,7 @@ var init_schemas = __esm({
564942
564942
  surface: {
564943
564943
  $schema: "http://json-schema.org/draft-07/schema#",
564944
564944
  title: "surface",
564945
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
564945
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
564946
564946
  anyOf: [
564947
564947
  {
564948
564948
  title: "Surface (by name)",
@@ -566519,7 +566519,7 @@ var init_schemas = __esm({
566519
566519
  additionalProperties: false,
566520
566520
  properties: {
566521
566521
  surface: {
566522
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
566522
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
566523
566523
  anyOf: [
566524
566524
  {
566525
566525
  title: "Surface (by browser engine)",
@@ -566868,7 +566868,7 @@ var init_schemas = __esm({
566868
566868
  minimum: 1
566869
566869
  },
566870
566870
  surface: {
566871
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
566871
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
566872
566872
  anyOf: [
566873
566873
  {
566874
566874
  title: "Surface (by browser engine)",
@@ -567221,7 +567221,7 @@ var init_schemas = __esm({
567221
567221
  minimum: 1
567222
567222
  },
567223
567223
  surface: {
567224
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
567224
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
567225
567225
  anyOf: [
567226
567226
  {
567227
567227
  title: "Surface (by browser engine)",
@@ -567591,7 +567591,7 @@ var init_schemas = __esm({
567591
567591
  surface: {
567592
567592
  $schema: "http://json-schema.org/draft-07/schema#",
567593
567593
  title: "surface",
567594
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
567594
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
567595
567595
  anyOf: [
567596
567596
  {
567597
567597
  title: "Surface (by name)",
@@ -569088,7 +569088,7 @@ var init_schemas = __esm({
569088
569088
  surface: {
569089
569089
  $schema: "http://json-schema.org/draft-07/schema#",
569090
569090
  title: "surface",
569091
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
569091
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
569092
569092
  anyOf: [
569093
569093
  {
569094
569094
  title: "Surface (by name)",
@@ -579780,7 +579780,7 @@ var init_schemas = __esm({
579780
579780
  surface: {
579781
579781
  $schema: "http://json-schema.org/draft-07/schema#",
579782
579782
  title: "surface",
579783
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
579783
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
579784
579784
  anyOf: [
579785
579785
  {
579786
579786
  title: "Surface (by name)",
@@ -581277,7 +581277,7 @@ var init_schemas = __esm({
581277
581277
  surface: {
581278
581278
  $schema: "http://json-schema.org/draft-07/schema#",
581279
581279
  title: "surface",
581280
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
581280
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
581281
581281
  anyOf: [
581282
581282
  {
581283
581283
  title: "Surface (by name)",
@@ -583756,7 +583756,7 @@ var init_schemas = __esm({
583756
583756
  additionalProperties: false,
583757
583757
  properties: {
583758
583758
  surface: {
583759
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
583759
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
583760
583760
  anyOf: [
583761
583761
  {
583762
583762
  title: "Surface (by browser engine)",
@@ -586307,7 +586307,7 @@ var init_schemas = __esm({
586307
586307
  additionalProperties: false,
586308
586308
  properties: {
586309
586309
  surface: {
586310
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
586310
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
586311
586311
  anyOf: [
586312
586312
  {
586313
586313
  title: "Surface (by browser engine)",
@@ -588837,7 +588837,7 @@ var init_schemas = __esm({
588837
588837
  additionalProperties: false,
588838
588838
  properties: {
588839
588839
  surface: {
588840
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
588840
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
588841
588841
  anyOf: [
588842
588842
  {
588843
588843
  title: "Surface (by browser engine)",
@@ -596563,7 +596563,7 @@ var init_schemas = __esm({
596563
596563
  {
596564
596564
  $schema: "http://json-schema.org/draft-07/schema#",
596565
596565
  title: "surface",
596566
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
596566
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
596567
596567
  anyOf: [
596568
596568
  {
596569
596569
  title: "Surface (by name)",
@@ -597187,7 +597187,7 @@ var init_schemas = __esm({
597187
597187
  items: {
597188
597188
  $schema: "http://json-schema.org/draft-07/schema#",
597189
597189
  title: "surface",
597190
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
597190
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
597191
597191
  anyOf: [
597192
597192
  {
597193
597193
  title: "Surface (by name)",
@@ -604943,7 +604943,7 @@ var init_schemas = __esm({
604943
604943
  description: "Duration of the swipe movement in milliseconds."
604944
604944
  },
604945
604945
  surface: {
604946
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
604946
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
604947
604947
  anyOf: [
604948
604948
  {
604949
604949
  title: "Surface (by browser engine)",
@@ -605224,7 +605224,7 @@ var init_schemas = __esm({
605224
605224
  description: "Duration of the swipe movement in milliseconds."
605225
605225
  },
605226
605226
  surface: {
605227
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
605227
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
605228
605228
  anyOf: [
605229
605229
  {
605230
605230
  title: "Surface (by browser engine)",
@@ -605488,7 +605488,7 @@ var init_schemas = __esm({
605488
605488
  description: "Duration of the swipe movement in milliseconds."
605489
605489
  },
605490
605490
  surface: {
605491
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
605491
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
605492
605492
  anyOf: [
605493
605493
  {
605494
605494
  title: "Surface (by browser engine)",
@@ -605740,7 +605740,7 @@ var init_schemas = __esm({
605740
605740
  description: "Duration of the swipe movement in milliseconds."
605741
605741
  },
605742
605742
  surface: {
605743
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
605743
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
605744
605744
  anyOf: [
605745
605745
  {
605746
605746
  title: "Surface (by browser engine)",
@@ -606021,7 +606021,7 @@ var init_schemas = __esm({
606021
606021
  description: "Duration of the swipe movement in milliseconds."
606022
606022
  },
606023
606023
  surface: {
606024
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
606024
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
606025
606025
  anyOf: [
606026
606026
  {
606027
606027
  title: "Surface (by browser engine)",
@@ -618953,7 +618953,7 @@ var init_schemas = __esm({
618953
618953
  minimum: 1
618954
618954
  },
618955
618955
  surface: {
618956
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
618956
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
618957
618957
  anyOf: [
618958
618958
  {
618959
618959
  title: "Surface (by browser engine)",
@@ -619306,7 +619306,7 @@ var init_schemas = __esm({
619306
619306
  minimum: 1
619307
619307
  },
619308
619308
  surface: {
619309
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
619309
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
619310
619310
  anyOf: [
619311
619311
  {
619312
619312
  title: "Surface (by browser engine)",
@@ -620596,7 +620596,7 @@ var init_schemas = __esm({
620596
620596
  additionalProperties: false,
620597
620597
  properties: {
620598
620598
  surface: {
620599
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
620599
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
620600
620600
  anyOf: [
620601
620601
  {
620602
620602
  title: "Surface (by browser engine)",
@@ -620945,7 +620945,7 @@ var init_schemas = __esm({
620945
620945
  minimum: 1
620946
620946
  },
620947
620947
  surface: {
620948
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
620948
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
620949
620949
  anyOf: [
620950
620950
  {
620951
620951
  title: "Surface (by browser engine)",
@@ -621298,7 +621298,7 @@ var init_schemas = __esm({
621298
621298
  minimum: 1
621299
621299
  },
621300
621300
  surface: {
621301
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
621301
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
621302
621302
  anyOf: [
621303
621303
  {
621304
621304
  title: "Surface (by browser engine)",
@@ -621668,7 +621668,7 @@ var init_schemas = __esm({
621668
621668
  surface: {
621669
621669
  $schema: "http://json-schema.org/draft-07/schema#",
621670
621670
  title: "surface",
621671
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
621671
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
621672
621672
  anyOf: [
621673
621673
  {
621674
621674
  title: "Surface (by name)",
@@ -623165,7 +623165,7 @@ var init_schemas = __esm({
623165
623165
  surface: {
623166
623166
  $schema: "http://json-schema.org/draft-07/schema#",
623167
623167
  title: "surface",
623168
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
623168
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
623169
623169
  anyOf: [
623170
623170
  {
623171
623171
  title: "Surface (by name)",
@@ -624742,7 +624742,7 @@ var init_schemas = __esm({
624742
624742
  additionalProperties: false,
624743
624743
  properties: {
624744
624744
  surface: {
624745
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
624745
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
624746
624746
  anyOf: [
624747
624747
  {
624748
624748
  title: "Surface (by browser engine)",
@@ -625091,7 +625091,7 @@ var init_schemas = __esm({
625091
625091
  minimum: 1
625092
625092
  },
625093
625093
  surface: {
625094
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
625094
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
625095
625095
  anyOf: [
625096
625096
  {
625097
625097
  title: "Surface (by browser engine)",
@@ -625444,7 +625444,7 @@ var init_schemas = __esm({
625444
625444
  minimum: 1
625445
625445
  },
625446
625446
  surface: {
625447
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
625447
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
625448
625448
  anyOf: [
625449
625449
  {
625450
625450
  title: "Surface (by browser engine)",
@@ -625814,7 +625814,7 @@ var init_schemas = __esm({
625814
625814
  surface: {
625815
625815
  $schema: "http://json-schema.org/draft-07/schema#",
625816
625816
  title: "surface",
625817
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
625817
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
625818
625818
  anyOf: [
625819
625819
  {
625820
625820
  title: "Surface (by name)",
@@ -627311,7 +627311,7 @@ var init_schemas = __esm({
627311
627311
  surface: {
627312
627312
  $schema: "http://json-schema.org/draft-07/schema#",
627313
627313
  title: "surface",
627314
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
627314
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
627315
627315
  anyOf: [
627316
627316
  {
627317
627317
  title: "Surface (by name)",
@@ -638003,7 +638003,7 @@ var init_schemas = __esm({
638003
638003
  surface: {
638004
638004
  $schema: "http://json-schema.org/draft-07/schema#",
638005
638005
  title: "surface",
638006
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
638006
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
638007
638007
  anyOf: [
638008
638008
  {
638009
638009
  title: "Surface (by name)",
@@ -639500,7 +639500,7 @@ var init_schemas = __esm({
639500
639500
  surface: {
639501
639501
  $schema: "http://json-schema.org/draft-07/schema#",
639502
639502
  title: "surface",
639503
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
639503
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
639504
639504
  anyOf: [
639505
639505
  {
639506
639506
  title: "Surface (by name)",
@@ -641979,7 +641979,7 @@ var init_schemas = __esm({
641979
641979
  additionalProperties: false,
641980
641980
  properties: {
641981
641981
  surface: {
641982
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
641982
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
641983
641983
  anyOf: [
641984
641984
  {
641985
641985
  title: "Surface (by browser engine)",
@@ -644530,7 +644530,7 @@ var init_schemas = __esm({
644530
644530
  additionalProperties: false,
644531
644531
  properties: {
644532
644532
  surface: {
644533
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
644533
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
644534
644534
  anyOf: [
644535
644535
  {
644536
644536
  title: "Surface (by browser engine)",
@@ -647060,7 +647060,7 @@ var init_schemas = __esm({
647060
647060
  additionalProperties: false,
647061
647061
  properties: {
647062
647062
  surface: {
647063
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
647063
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
647064
647064
  anyOf: [
647065
647065
  {
647066
647066
  title: "Surface (by browser engine)",
@@ -654786,7 +654786,7 @@ var init_schemas = __esm({
654786
654786
  {
654787
654787
  $schema: "http://json-schema.org/draft-07/schema#",
654788
654788
  title: "surface",
654789
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
654789
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
654790
654790
  anyOf: [
654791
654791
  {
654792
654792
  title: "Surface (by name)",
@@ -655410,7 +655410,7 @@ var init_schemas = __esm({
655410
655410
  items: {
655411
655411
  $schema: "http://json-schema.org/draft-07/schema#",
655412
655412
  title: "surface",
655413
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
655413
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
655414
655414
  anyOf: [
655415
655415
  {
655416
655416
  title: "Surface (by name)",
@@ -663166,7 +663166,7 @@ var init_schemas = __esm({
663166
663166
  description: "Duration of the swipe movement in milliseconds."
663167
663167
  },
663168
663168
  surface: {
663169
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
663169
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
663170
663170
  anyOf: [
663171
663171
  {
663172
663172
  title: "Surface (by browser engine)",
@@ -663447,7 +663447,7 @@ var init_schemas = __esm({
663447
663447
  description: "Duration of the swipe movement in milliseconds."
663448
663448
  },
663449
663449
  surface: {
663450
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
663450
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
663451
663451
  anyOf: [
663452
663452
  {
663453
663453
  title: "Surface (by browser engine)",
@@ -663711,7 +663711,7 @@ var init_schemas = __esm({
663711
663711
  description: "Duration of the swipe movement in milliseconds."
663712
663712
  },
663713
663713
  surface: {
663714
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
663714
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
663715
663715
  anyOf: [
663716
663716
  {
663717
663717
  title: "Surface (by browser engine)",
@@ -663963,7 +663963,7 @@ var init_schemas = __esm({
663963
663963
  description: "Duration of the swipe movement in milliseconds."
663964
663964
  },
663965
663965
  surface: {
663966
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
663966
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
663967
663967
  anyOf: [
663968
663968
  {
663969
663969
  title: "Surface (by browser engine)",
@@ -664244,7 +664244,7 @@ var init_schemas = __esm({
664244
664244
  description: "Duration of the swipe movement in milliseconds."
664245
664245
  },
664246
664246
  surface: {
664247
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
664247
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
664248
664248
  anyOf: [
664249
664249
  {
664250
664250
  title: "Surface (by browser engine)",
@@ -671187,7 +671187,7 @@ var init_schemas = __esm({
671187
671187
  surface_v3: {
671188
671188
  $schema: "http://json-schema.org/draft-07/schema#",
671189
671189
  title: "surface",
671190
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
671190
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
671191
671191
  anyOf: [
671192
671192
  {
671193
671193
  title: "Surface (by name)",
@@ -671854,7 +671854,7 @@ var init_schemas = __esm({
671854
671854
  description: "Duration of the swipe movement in milliseconds."
671855
671855
  },
671856
671856
  surface: {
671857
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
671857
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
671858
671858
  anyOf: [
671859
671859
  {
671860
671860
  title: "Surface (by browser engine)",
@@ -672135,7 +672135,7 @@ var init_schemas = __esm({
672135
672135
  description: "Duration of the swipe movement in milliseconds."
672136
672136
  },
672137
672137
  surface: {
672138
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
672138
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
672139
672139
  anyOf: [
672140
672140
  {
672141
672141
  title: "Surface (by browser engine)",
@@ -672399,7 +672399,7 @@ var init_schemas = __esm({
672399
672399
  description: "Duration of the swipe movement in milliseconds."
672400
672400
  },
672401
672401
  surface: {
672402
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
672402
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
672403
672403
  anyOf: [
672404
672404
  {
672405
672405
  title: "Surface (by browser engine)",
@@ -672651,7 +672651,7 @@ var init_schemas = __esm({
672651
672651
  description: "Duration of the swipe movement in milliseconds."
672652
672652
  },
672653
672653
  surface: {
672654
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
672654
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
672655
672655
  anyOf: [
672656
672656
  {
672657
672657
  title: "Surface (by browser engine)",
@@ -672932,7 +672932,7 @@ var init_schemas = __esm({
672932
672932
  description: "Duration of the swipe movement in milliseconds."
672933
672933
  },
672934
672934
  surface: {
672935
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
672935
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
672936
672936
  anyOf: [
672937
672937
  {
672938
672938
  title: "Surface (by browser engine)",
@@ -679326,7 +679326,7 @@ var init_schemas = __esm({
679326
679326
  minimum: 1
679327
679327
  },
679328
679328
  surface: {
679329
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
679329
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
679330
679330
  anyOf: [
679331
679331
  {
679332
679332
  title: "Surface (by browser engine)",
@@ -679679,7 +679679,7 @@ var init_schemas = __esm({
679679
679679
  minimum: 1
679680
679680
  },
679681
679681
  surface: {
679682
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
679682
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
679683
679683
  anyOf: [
679684
679684
  {
679685
679685
  title: "Surface (by browser engine)",
@@ -680969,7 +680969,7 @@ var init_schemas = __esm({
680969
680969
  additionalProperties: false,
680970
680970
  properties: {
680971
680971
  surface: {
680972
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
680972
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
680973
680973
  anyOf: [
680974
680974
  {
680975
680975
  title: "Surface (by browser engine)",
@@ -681318,7 +681318,7 @@ var init_schemas = __esm({
681318
681318
  minimum: 1
681319
681319
  },
681320
681320
  surface: {
681321
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
681321
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
681322
681322
  anyOf: [
681323
681323
  {
681324
681324
  title: "Surface (by browser engine)",
@@ -681671,7 +681671,7 @@ var init_schemas = __esm({
681671
681671
  minimum: 1
681672
681672
  },
681673
681673
  surface: {
681674
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
681674
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
681675
681675
  anyOf: [
681676
681676
  {
681677
681677
  title: "Surface (by browser engine)",
@@ -682041,7 +682041,7 @@ var init_schemas = __esm({
682041
682041
  surface: {
682042
682042
  $schema: "http://json-schema.org/draft-07/schema#",
682043
682043
  title: "surface",
682044
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
682044
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
682045
682045
  anyOf: [
682046
682046
  {
682047
682047
  title: "Surface (by name)",
@@ -683538,7 +683538,7 @@ var init_schemas = __esm({
683538
683538
  surface: {
683539
683539
  $schema: "http://json-schema.org/draft-07/schema#",
683540
683540
  title: "surface",
683541
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
683541
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
683542
683542
  anyOf: [
683543
683543
  {
683544
683544
  title: "Surface (by name)",
@@ -685115,7 +685115,7 @@ var init_schemas = __esm({
685115
685115
  additionalProperties: false,
685116
685116
  properties: {
685117
685117
  surface: {
685118
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
685118
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
685119
685119
  anyOf: [
685120
685120
  {
685121
685121
  title: "Surface (by browser engine)",
@@ -685464,7 +685464,7 @@ var init_schemas = __esm({
685464
685464
  minimum: 1
685465
685465
  },
685466
685466
  surface: {
685467
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
685467
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
685468
685468
  anyOf: [
685469
685469
  {
685470
685470
  title: "Surface (by browser engine)",
@@ -685817,7 +685817,7 @@ var init_schemas = __esm({
685817
685817
  minimum: 1
685818
685818
  },
685819
685819
  surface: {
685820
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
685820
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
685821
685821
  anyOf: [
685822
685822
  {
685823
685823
  title: "Surface (by browser engine)",
@@ -686187,7 +686187,7 @@ var init_schemas = __esm({
686187
686187
  surface: {
686188
686188
  $schema: "http://json-schema.org/draft-07/schema#",
686189
686189
  title: "surface",
686190
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
686190
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
686191
686191
  anyOf: [
686192
686192
  {
686193
686193
  title: "Surface (by name)",
@@ -687684,7 +687684,7 @@ var init_schemas = __esm({
687684
687684
  surface: {
687685
687685
  $schema: "http://json-schema.org/draft-07/schema#",
687686
687686
  title: "surface",
687687
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
687687
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
687688
687688
  anyOf: [
687689
687689
  {
687690
687690
  title: "Surface (by name)",
@@ -698376,7 +698376,7 @@ var init_schemas = __esm({
698376
698376
  surface: {
698377
698377
  $schema: "http://json-schema.org/draft-07/schema#",
698378
698378
  title: "surface",
698379
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
698379
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
698380
698380
  anyOf: [
698381
698381
  {
698382
698382
  title: "Surface (by name)",
@@ -699873,7 +699873,7 @@ var init_schemas = __esm({
699873
699873
  surface: {
699874
699874
  $schema: "http://json-schema.org/draft-07/schema#",
699875
699875
  title: "surface",
699876
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
699876
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
699877
699877
  anyOf: [
699878
699878
  {
699879
699879
  title: "Surface (by name)",
@@ -702352,7 +702352,7 @@ var init_schemas = __esm({
702352
702352
  additionalProperties: false,
702353
702353
  properties: {
702354
702354
  surface: {
702355
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
702355
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
702356
702356
  anyOf: [
702357
702357
  {
702358
702358
  title: "Surface (by browser engine)",
@@ -704903,7 +704903,7 @@ var init_schemas = __esm({
704903
704903
  additionalProperties: false,
704904
704904
  properties: {
704905
704905
  surface: {
704906
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
704906
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
704907
704907
  anyOf: [
704908
704908
  {
704909
704909
  title: "Surface (by browser engine)",
@@ -707433,7 +707433,7 @@ var init_schemas = __esm({
707433
707433
  additionalProperties: false,
707434
707434
  properties: {
707435
707435
  surface: {
707436
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
707436
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
707437
707437
  anyOf: [
707438
707438
  {
707439
707439
  title: "Surface (by browser engine)",
@@ -715159,7 +715159,7 @@ var init_schemas = __esm({
715159
715159
  {
715160
715160
  $schema: "http://json-schema.org/draft-07/schema#",
715161
715161
  title: "surface",
715162
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
715162
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
715163
715163
  anyOf: [
715164
715164
  {
715165
715165
  title: "Surface (by name)",
@@ -715783,7 +715783,7 @@ var init_schemas = __esm({
715783
715783
  items: {
715784
715784
  $schema: "http://json-schema.org/draft-07/schema#",
715785
715785
  title: "surface",
715786
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
715786
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
715787
715787
  anyOf: [
715788
715788
  {
715789
715789
  title: "Surface (by name)",
@@ -723539,7 +723539,7 @@ var init_schemas = __esm({
723539
723539
  description: "Duration of the swipe movement in milliseconds."
723540
723540
  },
723541
723541
  surface: {
723542
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
723542
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
723543
723543
  anyOf: [
723544
723544
  {
723545
723545
  title: "Surface (by browser engine)",
@@ -723820,7 +723820,7 @@ var init_schemas = __esm({
723820
723820
  description: "Duration of the swipe movement in milliseconds."
723821
723821
  },
723822
723822
  surface: {
723823
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
723823
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
723824
723824
  anyOf: [
723825
723825
  {
723826
723826
  title: "Surface (by browser engine)",
@@ -724084,7 +724084,7 @@ var init_schemas = __esm({
724084
724084
  description: "Duration of the swipe movement in milliseconds."
724085
724085
  },
724086
724086
  surface: {
724087
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
724087
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
724088
724088
  anyOf: [
724089
724089
  {
724090
724090
  title: "Surface (by browser engine)",
@@ -724336,7 +724336,7 @@ var init_schemas = __esm({
724336
724336
  description: "Duration of the swipe movement in milliseconds."
724337
724337
  },
724338
724338
  surface: {
724339
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
724339
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
724340
724340
  anyOf: [
724341
724341
  {
724342
724342
  title: "Surface (by browser engine)",
@@ -724617,7 +724617,7 @@ var init_schemas = __esm({
724617
724617
  description: "Duration of the swipe movement in milliseconds."
724618
724618
  },
724619
724619
  surface: {
724620
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
724620
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
724621
724621
  anyOf: [
724622
724622
  {
724623
724623
  title: "Surface (by browser engine)",
@@ -735809,7 +735809,7 @@ var init_schemas = __esm({
735809
735809
  minimum: 1
735810
735810
  },
735811
735811
  surface: {
735812
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
735812
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
735813
735813
  anyOf: [
735814
735814
  {
735815
735815
  title: "Surface (by browser engine)",
@@ -736162,7 +736162,7 @@ var init_schemas = __esm({
736162
736162
  minimum: 1
736163
736163
  },
736164
736164
  surface: {
736165
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
736165
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
736166
736166
  anyOf: [
736167
736167
  {
736168
736168
  title: "Surface (by browser engine)",
@@ -737452,7 +737452,7 @@ var init_schemas = __esm({
737452
737452
  additionalProperties: false,
737453
737453
  properties: {
737454
737454
  surface: {
737455
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
737455
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
737456
737456
  anyOf: [
737457
737457
  {
737458
737458
  title: "Surface (by browser engine)",
@@ -737801,7 +737801,7 @@ var init_schemas = __esm({
737801
737801
  minimum: 1
737802
737802
  },
737803
737803
  surface: {
737804
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
737804
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
737805
737805
  anyOf: [
737806
737806
  {
737807
737807
  title: "Surface (by browser engine)",
@@ -738154,7 +738154,7 @@ var init_schemas = __esm({
738154
738154
  minimum: 1
738155
738155
  },
738156
738156
  surface: {
738157
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
738157
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
738158
738158
  anyOf: [
738159
738159
  {
738160
738160
  title: "Surface (by browser engine)",
@@ -738524,7 +738524,7 @@ var init_schemas = __esm({
738524
738524
  surface: {
738525
738525
  $schema: "http://json-schema.org/draft-07/schema#",
738526
738526
  title: "surface",
738527
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
738527
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
738528
738528
  anyOf: [
738529
738529
  {
738530
738530
  title: "Surface (by name)",
@@ -740021,7 +740021,7 @@ var init_schemas = __esm({
740021
740021
  surface: {
740022
740022
  $schema: "http://json-schema.org/draft-07/schema#",
740023
740023
  title: "surface",
740024
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
740024
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
740025
740025
  anyOf: [
740026
740026
  {
740027
740027
  title: "Surface (by name)",
@@ -741598,7 +741598,7 @@ var init_schemas = __esm({
741598
741598
  additionalProperties: false,
741599
741599
  properties: {
741600
741600
  surface: {
741601
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
741601
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
741602
741602
  anyOf: [
741603
741603
  {
741604
741604
  title: "Surface (by browser engine)",
@@ -741947,7 +741947,7 @@ var init_schemas = __esm({
741947
741947
  minimum: 1
741948
741948
  },
741949
741949
  surface: {
741950
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
741950
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
741951
741951
  anyOf: [
741952
741952
  {
741953
741953
  title: "Surface (by browser engine)",
@@ -742300,7 +742300,7 @@ var init_schemas = __esm({
742300
742300
  minimum: 1
742301
742301
  },
742302
742302
  surface: {
742303
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
742303
+ description: 'The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).',
742304
742304
  anyOf: [
742305
742305
  {
742306
742306
  title: "Surface (by browser engine)",
@@ -742670,7 +742670,7 @@ var init_schemas = __esm({
742670
742670
  surface: {
742671
742671
  $schema: "http://json-schema.org/draft-07/schema#",
742672
742672
  title: "surface",
742673
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
742673
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
742674
742674
  anyOf: [
742675
742675
  {
742676
742676
  title: "Surface (by name)",
@@ -744167,7 +744167,7 @@ var init_schemas = __esm({
744167
744167
  surface: {
744168
744168
  $schema: "http://json-schema.org/draft-07/schema#",
744169
744169
  title: "surface",
744170
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
744170
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
744171
744171
  anyOf: [
744172
744172
  {
744173
744173
  title: "Surface (by name)",
@@ -754859,7 +754859,7 @@ var init_schemas = __esm({
754859
754859
  surface: {
754860
754860
  $schema: "http://json-schema.org/draft-07/schema#",
754861
754861
  title: "surface",
754862
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
754862
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
754863
754863
  anyOf: [
754864
754864
  {
754865
754865
  title: "Surface (by name)",
@@ -756356,7 +756356,7 @@ var init_schemas = __esm({
756356
756356
  surface: {
756357
756357
  $schema: "http://json-schema.org/draft-07/schema#",
756358
756358
  title: "surface",
756359
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
756359
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
756360
756360
  anyOf: [
756361
756361
  {
756362
756362
  title: "Surface (by name)",
@@ -758835,7 +758835,7 @@ var init_schemas = __esm({
758835
758835
  additionalProperties: false,
758836
758836
  properties: {
758837
758837
  surface: {
758838
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
758838
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
758839
758839
  anyOf: [
758840
758840
  {
758841
758841
  title: "Surface (by browser engine)",
@@ -761386,7 +761386,7 @@ var init_schemas = __esm({
761386
761386
  additionalProperties: false,
761387
761387
  properties: {
761388
761388
  surface: {
761389
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
761389
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
761390
761390
  anyOf: [
761391
761391
  {
761392
761392
  title: "Surface (by browser engine)",
@@ -763916,7 +763916,7 @@ var init_schemas = __esm({
763916
763916
  additionalProperties: false,
763917
763917
  properties: {
763918
763918
  surface: {
763919
- description: 'The browser window/tab or app window to capture. Omit to capture the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }). App captures don\'t support `crop` yet.',
763919
+ description: "The browser window/tab or app window to capture. Omit to capture the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be captured). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ \"app\": \u2026 }). App captures don't support `crop` yet.",
763920
763920
  anyOf: [
763921
763921
  {
763922
763922
  title: "Surface (by browser engine)",
@@ -771642,7 +771642,7 @@ var init_schemas = __esm({
771642
771642
  {
771643
771643
  $schema: "http://json-schema.org/draft-07/schema#",
771644
771644
  title: "surface",
771645
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
771645
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
771646
771646
  anyOf: [
771647
771647
  {
771648
771648
  title: "Surface (by name)",
@@ -772266,7 +772266,7 @@ var init_schemas = __esm({
772266
772266
  items: {
772267
772267
  $schema: "http://json-schema.org/draft-07/schema#",
772268
772268
  title: "surface",
772269
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
772269
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
772270
772270
  anyOf: [
772271
772271
  {
772272
772272
  title: "Surface (by name)",
@@ -780022,7 +780022,7 @@ var init_schemas = __esm({
780022
780022
  description: "Duration of the swipe movement in milliseconds."
780023
780023
  },
780024
780024
  surface: {
780025
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
780025
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
780026
780026
  anyOf: [
780027
780027
  {
780028
780028
  title: "Surface (by browser engine)",
@@ -780303,7 +780303,7 @@ var init_schemas = __esm({
780303
780303
  description: "Duration of the swipe movement in milliseconds."
780304
780304
  },
780305
780305
  surface: {
780306
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
780306
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
780307
780307
  anyOf: [
780308
780308
  {
780309
780309
  title: "Surface (by browser engine)",
@@ -780567,7 +780567,7 @@ var init_schemas = __esm({
780567
780567
  description: "Duration of the swipe movement in milliseconds."
780568
780568
  },
780569
780569
  surface: {
780570
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
780570
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
780571
780571
  anyOf: [
780572
780572
  {
780573
780573
  title: "Surface (by browser engine)",
@@ -780819,7 +780819,7 @@ var init_schemas = __esm({
780819
780819
  description: "Duration of the swipe movement in milliseconds."
780820
780820
  },
780821
780821
  surface: {
780822
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
780822
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
780823
780823
  anyOf: [
780824
780824
  {
780825
780825
  title: "Surface (by browser engine)",
@@ -781100,7 +781100,7 @@ var init_schemas = __esm({
781100
781100
  description: "Duration of the swipe movement in milliseconds."
781101
781101
  },
781102
781102
  surface: {
781103
- description: 'The browser window/tab or app window this step acts on. Omit to act on the active tab. The targeted surface stays focused afterward. App surfaces use the object form ({ "app": \u2026 }).',
781103
+ description: `The browser window/tab or app window this step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form ({ "app": \u2026 }).`,
781104
781104
  anyOf: [
781105
781105
  {
781106
781106
  title: "Surface (by browser engine)",
@@ -788440,7 +788440,7 @@ var init_schemas = __esm({
788440
788440
  surface: {
788441
788441
  $schema: "http://json-schema.org/draft-07/schema#",
788442
788442
  title: "surface",
788443
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
788443
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
788444
788444
  anyOf: [
788445
788445
  {
788446
788446
  title: "Surface (by name)",
@@ -789937,7 +789937,7 @@ var init_schemas = __esm({
789937
789937
  surface: {
789938
789938
  $schema: "http://json-schema.org/draft-07/schema#",
789939
789939
  title: "surface",
789940
- description: "The surface a step acts on. Omit to act on the active surface. Supports background processes, browser windows/tabs, and native app windows.",
789940
+ description: "The surface a step acts on. Omit to act on the active surface \u2014 the most recently opened, focused, or explicitly targeted surface, whatever its kind. Specifying a surface switches the active surface for the steps that follow. Supports background processes, browser windows/tabs, and native app windows.",
789941
789941
  anyOf: [
789942
789942
  {
789943
789943
  title: "Surface (by name)",
@@ -805077,7 +805077,31 @@ function stepOpensBrowserSurface(step) {
805077
805077
  function stepOpensAppSurface(step) {
805078
805078
  return startSurfaceDescriptors(step).some((d) => d && typeof d === "object" && typeof d.app === "string");
805079
805079
  }
805080
- var BROWSER_STEP_KEYS;
805080
+ function stepOpensProcessSurface(step) {
805081
+ return startSurfaceDescriptors(step).some((d) => d && typeof d === "object" && typeof d.process === "string");
805082
+ }
805083
+ function stepTargetsProcessSurface(step) {
805084
+ if (!step || typeof step !== "object")
805085
+ return false;
805086
+ return Object.values(step).some((payload) => payload && typeof payload === "object" && payload.surface && typeof payload.surface === "object" && typeof payload.surface.process === "string");
805087
+ }
805088
+ function stepIsSurfacelessInteraction(step) {
805089
+ if (!step || typeof step !== "object")
805090
+ return false;
805091
+ return SURFACE_SENSITIVE_STEP_KEYS.some((key) => {
805092
+ if (typeof step[key] === "undefined")
805093
+ return false;
805094
+ const payload = step[key];
805095
+ const hasExplicitSurface = payload && typeof payload === "object" && !Array.isArray(payload) && payload.surface !== void 0;
805096
+ return !hasExplicitSurface;
805097
+ });
805098
+ }
805099
+ function testHasNonBrowserSurfaceSignal(steps) {
805100
+ if (!Array.isArray(steps))
805101
+ return false;
805102
+ return steps.some((step) => stepOpensAppSurface(step) || stepOpensProcessSurface(step) || stepTargetsAppSurface(step) || stepTargetsProcessSurface(step));
805103
+ }
805104
+ var BROWSER_STEP_KEYS, SURFACE_SENSITIVE_STEP_KEYS;
805081
805105
  var init_browserStepKeys = __esm({
805082
805106
  "dist/runtime/browserStepKeys.js"() {
805083
805107
  "use strict";
@@ -805098,6 +805122,13 @@ var init_browserStepKeys = __esm({
805098
805122
  "swipe",
805099
805123
  "type"
805100
805124
  ];
805125
+ SURFACE_SENSITIVE_STEP_KEYS = [
805126
+ "click",
805127
+ "find",
805128
+ "screenshot",
805129
+ "swipe",
805130
+ "type"
805131
+ ];
805101
805132
  }
805102
805133
  });
805103
805134
 
@@ -805124,8 +805155,9 @@ function inferRuntimeNeeds(resolvedSpecs, options = {}) {
805124
805155
  if (typeof ctx?.browser?.name === "string") {
805125
805156
  addBrowserName(browsers, ctx.browser.name);
805126
805157
  }
805158
+ const ctxHasNonBrowserSignal = testHasNonBrowserSurfaceSignal(ctx?.steps);
805127
805159
  for (const step of arrayOrEmpty(ctx?.steps)) {
805128
- const flags = classifyStep(step);
805160
+ const flags = classifyStep(step, ctxHasNonBrowserSignal);
805129
805161
  if (flags.browser)
805130
805162
  sawBrowserStep = true;
805131
805163
  if (flags.screenshot)
@@ -805137,8 +805169,9 @@ function inferRuntimeNeeds(resolvedSpecs, options = {}) {
805137
805169
  collectStartSurfaceEngines(step, browsers);
805138
805170
  }
805139
805171
  }
805172
+ const testHasNonBrowserSignal = testHasNonBrowserSurfaceSignal(test?.steps);
805140
805173
  for (const step of arrayOrEmpty(test?.steps)) {
805141
- const flags = classifyStep(step);
805174
+ const flags = classifyStep(step, testHasNonBrowserSignal);
805142
805175
  if (flags.browser)
805143
805176
  sawBrowserStep = true;
805144
805177
  if (flags.screenshot)
@@ -805228,15 +805261,15 @@ function collectBrowserNamesFromRunOn(runOn, set) {
805228
805261
  }
805229
805262
  }
805230
805263
  }
805231
- function classifyStep(step) {
805264
+ function classifyStep(step, hasNonBrowserSignal = false) {
805232
805265
  if (!step || typeof step !== "object")
805233
805266
  return { browser: false, screenshot: false, recording: false };
805234
805267
  let browser = false;
805235
805268
  let screenshot = false;
805236
805269
  let recording = false;
805237
- const appTargeted = stepTargetsAppSurface(step);
805270
+ const nonBrowserTargeted = stepTargetsAppSurface(step) || stepTargetsProcessSurface(step) || hasNonBrowserSignal && stepIsSurfacelessInteraction(step);
805238
805271
  for (const key of Object.keys(step)) {
805239
- if (!appTargeted && BROWSER_STEP_KEY_SET.has(key))
805272
+ if (!nonBrowserTargeted && BROWSER_STEP_KEY_SET.has(key))
805240
805273
  browser = true;
805241
805274
  if (SCREENSHOT_STEP_KEYS.has(key))
805242
805275
  screenshot = true;
@@ -808422,8 +808455,110 @@ init_validate();
808422
808455
  // dist/core/tests/browserSurface.js
808423
808456
  init_utils();
808424
808457
 
808458
+ // dist/core/tests/activeSurface.js
808459
+ var ENGINE_KEYWORDS = /* @__PURE__ */ new Set(["chrome", "firefox", "safari", "webkit", "edge"]);
808460
+ var NO_ACTIVE_SURFACE_MESSAGE = "No active surface to act on. Open one first with a startSurface step (or a goTo step for a browser), or target a surface explicitly with `surface`.";
808461
+ function createActiveSurfaceTracker() {
808462
+ return { mru: [] };
808463
+ }
808464
+ function activateSurface(tracker, handle) {
808465
+ if (!tracker)
808466
+ return;
808467
+ tracker.mru = [
808468
+ handle,
808469
+ ...tracker.mru.filter((h) => !(h.kind === handle.kind && h.name === handle.name))
808470
+ ];
808471
+ }
808472
+ function isLive(handle, registries) {
808473
+ if (handle.kind === "browser")
808474
+ return !!registries.browserRegistry?.sessions?.has(handle.name);
808475
+ if (handle.kind === "app")
808476
+ return !!registries.appSession?.surfaces?.has(handle.name);
808477
+ return !!registries.processRegistry?.has(handle.name);
808478
+ }
808479
+ function currentSurface(tracker, registries) {
808480
+ if (!tracker)
808481
+ return null;
808482
+ const live = tracker.mru.filter((h) => isLive(h, registries));
808483
+ tracker.mru = live;
808484
+ return live[0] ?? null;
808485
+ }
808486
+ function resolveTargetSurface({ surface, tracker, driver, appSession, processRegistry }) {
808487
+ const browserRegistry = driver?.state?.sessionRegistry;
808488
+ const registries = {
808489
+ browserRegistry,
808490
+ appSession,
808491
+ processRegistry
808492
+ };
808493
+ if (surface !== void 0 && surface !== null) {
808494
+ if (typeof surface === "object") {
808495
+ if (typeof surface.app === "string") {
808496
+ const name = surface.app.trim();
808497
+ if (!appSession) {
808498
+ return {
808499
+ kind: "error",
808500
+ message: `The surface names an app ("${name}"), but no app session is active in this context. Open the app first with startSurface.`
808501
+ };
808502
+ }
808503
+ const entry = appSession.surfaces.get(name);
808504
+ if (!entry) {
808505
+ return {
808506
+ kind: "error",
808507
+ message: `No app surface named "${name}" is open. Open it first with startSurface.`
808508
+ };
808509
+ }
808510
+ return { kind: "app", entry, window: surface.window };
808511
+ }
808512
+ if (typeof surface.process === "string") {
808513
+ const name = surface.process.trim();
808514
+ return { kind: "process", name, entry: processRegistry?.get(name) };
808515
+ }
808516
+ return { kind: "browser", surface };
808517
+ }
808518
+ if (typeof surface === "string") {
808519
+ const name = surface.trim();
808520
+ if (ENGINE_KEYWORDS.has(name.toLowerCase())) {
808521
+ return { kind: "browser", surface };
808522
+ }
808523
+ if (appSession?.surfaces?.has(name)) {
808524
+ return { kind: "app", entry: appSession.surfaces.get(name) };
808525
+ }
808526
+ if (browserRegistry?.sessions?.has(name)) {
808527
+ return { kind: "browser", surface };
808528
+ }
808529
+ if (processRegistry?.has(name)) {
808530
+ return { kind: "process", name, entry: processRegistry.get(name) };
808531
+ }
808532
+ return {
808533
+ kind: "error",
808534
+ message: `No surface named "${name}" is open in this context. Open it first with a startSurface step (or a goTo step for a browser).`
808535
+ };
808536
+ }
808537
+ }
808538
+ const active = currentSurface(tracker, registries);
808539
+ if (active) {
808540
+ if (active.kind === "app") {
808541
+ return { kind: "app", entry: appSession.surfaces.get(active.name) };
808542
+ }
808543
+ if (active.kind === "process") {
808544
+ return {
808545
+ kind: "process",
808546
+ name: active.name,
808547
+ entry: processRegistry?.get(active.name)
808548
+ };
808549
+ }
808550
+ return { kind: "browser" };
808551
+ }
808552
+ if (driver)
808553
+ return { kind: "browser" };
808554
+ if (appSession?.activeApp && appSession.surfaces?.has(appSession.activeApp)) {
808555
+ return { kind: "app", entry: appSession.surfaces.get(appSession.activeApp) };
808556
+ }
808557
+ return { kind: "error", message: NO_ACTIVE_SURFACE_MESSAGE };
808558
+ }
808559
+
808425
808560
  // dist/core/tests/browserSessions.js
808426
- var ENGINE_KEYWORDS = /* @__PURE__ */ new Set([
808561
+ var ENGINE_KEYWORDS2 = /* @__PURE__ */ new Set([
808427
808562
  "chrome",
808428
808563
  "firefox",
808429
808564
  "safari",
@@ -808436,7 +808571,7 @@ function normalizeEngine(engine) {
808436
808571
  }
808437
808572
  function engineKeywordNameConflict(name, engine) {
808438
808573
  const nameLower = name.toLowerCase();
808439
- if (ENGINE_KEYWORDS.has(nameLower) && normalizeEngine(nameLower) !== normalizeEngine(engine)) {
808574
+ if (ENGINE_KEYWORDS2.has(nameLower) && normalizeEngine(nameLower) !== normalizeEngine(engine)) {
808440
808575
  return `"${name}" is a browser engine keyword, so it can't name a ${String(engine).toLowerCase()} surface. Pick a non-engine name.`;
808441
808576
  }
808442
808577
  return null;
@@ -808447,12 +808582,14 @@ function createSessionRegistry(opts = {}) {
808447
808582
  activeName: null,
808448
808583
  focusSeq: 0,
808449
808584
  ...opts.open ? { open: opts.open } : {},
808450
- ...opts.isNameTaken ? { isNameTaken: opts.isNameTaken } : {}
808585
+ ...opts.isNameTaken ? { isNameTaken: opts.isNameTaken } : {},
808586
+ ...opts.tracker ? { tracker: opts.tracker } : {}
808451
808587
  };
808452
808588
  }
808453
808589
  function activate(registry, entry) {
808454
808590
  entry.lastFocused = ++registry.focusSeq;
808455
808591
  registry.activeName = entry.name;
808592
+ activateSurface(registry.tracker, { kind: "browser", name: entry.name });
808456
808593
  }
808457
808594
  function registerSession(registry, { name, engine, driver }) {
808458
808595
  const key = String(name).trim();
@@ -811680,6 +811817,7 @@ async function startAppSurface({ config, step, appSession, platform, serverDeps
811680
811817
  deviceName
811681
811818
  });
811682
811819
  appSession.activeApp = name;
811820
+ activateSurface(appSession.tracker, { kind: "app", name });
811683
811821
  await snapshotAppWindows(appSession.surfaces.get(name));
811684
811822
  if (!isMobileTargetPlatform(platform)) {
811685
811823
  const pendingHandles = (appSession.recordingHost?.state?.recordings ?? []).filter((handle) => handle?.pendingAppWindowCrop && !handle.crop && !handle.cropRect);
@@ -811720,25 +811858,31 @@ async function startAppSurface({ config, step, appSession, platform, serverDeps
811720
811858
  return result;
811721
811859
  }
811722
811860
  async function ensureAppForeground(entry, appSession) {
811723
- if (!entry.deviceName || !appSession)
811861
+ if (!appSession)
811862
+ return {};
811863
+ if (!entry.deviceName) {
811864
+ appSession.activeApp = entry.name;
811865
+ activateSurface(appSession.tracker, { kind: "app", name: entry.name });
811724
811866
  return {};
811867
+ }
811725
811868
  const session = appSession.deviceSessions?.get(entry.deviceName);
811726
811869
  if (!session) {
811727
811870
  return {
811728
811871
  error: `Couldn't switch to app surface "${entry.name}" (${entry.appId}): no active session for device "${entry.deviceName}".`
811729
811872
  };
811730
811873
  }
811731
- if (session.foregroundApp === entry.appId)
811732
- return {};
811733
- try {
811734
- await session.driver.activateApp(entry.appId);
811735
- } catch (error) {
811736
- return {
811737
- error: `Couldn't switch to app surface "${entry.name}" (${entry.appId}) on device "${entry.deviceName}": ${error?.message ?? error}`
811738
- };
811874
+ if (session.foregroundApp !== entry.appId) {
811875
+ try {
811876
+ await session.driver.activateApp(entry.appId);
811877
+ } catch (error) {
811878
+ return {
811879
+ error: `Couldn't switch to app surface "${entry.name}" (${entry.appId}) on device "${entry.deviceName}": ${error?.message ?? error}`
811880
+ };
811881
+ }
811882
+ session.foregroundApp = entry.appId;
811739
811883
  }
811740
- session.foregroundApp = entry.appId;
811741
811884
  appSession.activeApp = entry.name;
811885
+ activateSurface(appSession.tracker, { kind: "app", name: entry.name });
811742
811886
  return {};
811743
811887
  }
811744
811888
  async function closeAppSurface({ entry, appSession }) {
@@ -813767,9 +813911,6 @@ function translateProcessKeys(keys) {
813767
813911
  }
813768
813912
  return out;
813769
813913
  }
813770
- function resolveSurface(surface) {
813771
- return parseSurfaceRef(surface);
813772
- }
813773
813914
  async function typeToProcess({ step, name, processRegistry }) {
813774
813915
  const result = {
813775
813916
  status: "PASS",
@@ -813894,7 +814035,7 @@ async function getSpecialKeyMap(ctx = {}) {
813894
814035
  };
813895
814036
  return _specialKeyMap;
813896
814037
  }
813897
- async function typeKeys({ config, step, driver, processRegistry, appSession }) {
814038
+ async function typeKeys({ config, step, driver, processRegistry, appSession, surfaceTracker }) {
813898
814039
  let result = {
813899
814040
  status: "PASS",
813900
814041
  description: "Typed keys.",
@@ -813927,13 +814068,20 @@ async function typeKeys({ config, step, driver, processRegistry, appSession }) {
813927
814068
  result.description = "No keys to type.";
813928
814069
  return result;
813929
814070
  }
813930
- const appRef = resolveAppSurfaceRef(step.type.surface, appSession);
813931
- if (appRef) {
813932
- if (appRef.error) {
813933
- result.status = "FAIL";
813934
- result.description = appRef.error;
813935
- return result;
813936
- }
814071
+ const target = resolveTargetSurface({
814072
+ surface: step.type.surface,
814073
+ tracker: surfaceTracker,
814074
+ driver,
814075
+ appSession,
814076
+ processRegistry
814077
+ });
814078
+ if (target.kind === "error") {
814079
+ result.status = "FAIL";
814080
+ result.description = target.message;
814081
+ return result;
814082
+ }
814083
+ if (target.kind === "app") {
814084
+ const appRef = { entry: target.entry, window: target.window };
813937
814085
  let windowTarget = null;
813938
814086
  if (appRef.window !== void 0) {
813939
814087
  const resolvedWindow = await resolveAppWindow({
@@ -814054,29 +814202,27 @@ async function typeKeys({ config, step, driver, processRegistry, appSession }) {
814054
814202
  result.outputs = { keys: step.type.keys };
814055
814203
  return result;
814056
814204
  }
814057
- const resolved = reinterpretForSessions(driver, resolveSurface(step.type.surface));
814058
- if (resolved.kind === "unsupported") {
814059
- result.status = "FAIL";
814060
- result.description = "surface kind not yet supported.";
814061
- return result;
814062
- }
814063
- if (resolved.kind === "process") {
814205
+ if (target.kind === "process") {
814064
814206
  const wu = step.type.waitUntil;
814065
814207
  if (wu && (wu.networkIdleTime !== void 0 || wu.domIdleTime !== void 0 || wu.find !== void 0)) {
814066
814208
  result.status = "FAIL";
814067
- result.description = `Browser readiness conditions (networkIdleTime/domIdleTime/find) don't apply to the process surface "${resolved.name}".`;
814209
+ result.description = `Browser readiness conditions (networkIdleTime/domIdleTime/find) don't apply to the process surface "${target.name}".`;
814068
814210
  return result;
814069
814211
  }
814070
- return await typeToProcess({ step, name: resolved.name, processRegistry });
814212
+ const typed = await typeToProcess({ step, name: target.name, processRegistry });
814213
+ if (typed.status === "PASS") {
814214
+ activateSurface(surfaceTracker, { kind: "process", name: target.name });
814215
+ }
814216
+ return typed;
814071
814217
  }
814072
- if (resolved.kind === "browser") {
814218
+ if (target.surface !== void 0) {
814073
814219
  const wu = step.type.waitUntil;
814074
814220
  if (wu && (wu.stdio !== void 0 || wu.delayMs !== void 0)) {
814075
814221
  result.status = "FAIL";
814076
814222
  result.description = "Process readiness conditions (stdio/delayMs) don't apply to a browser surface.";
814077
814223
  return result;
814078
814224
  }
814079
- const switched = await switchToSurface(driver, step.type.surface);
814225
+ const switched = await switchToSurface(driver, target.surface);
814080
814226
  if (!switched.ok) {
814081
814227
  result.status = "FAIL";
814082
814228
  result.description = switched.message;
@@ -814161,7 +814307,7 @@ async function typeKeys({ config, step, driver, processRegistry, appSession }) {
814161
814307
  result.description = `Couldn't type keys: ${error.message}.`;
814162
814308
  return result;
814163
814309
  }
814164
- if (resolved.kind === "browser" && step.type.waitUntil) {
814310
+ if (target.surface !== void 0 && step.type.waitUntil) {
814165
814311
  const readiness = await waitForBrowserReadiness({
814166
814312
  driver,
814167
814313
  waitUntil: step.type.waitUntil,
@@ -814430,7 +814576,7 @@ async function finalizeFound({ result }) {
814430
814576
  result.status = status;
814431
814577
  return result;
814432
814578
  }
814433
- async function findElement({ config, step, driver, click, appSession }) {
814579
+ async function findElement({ config, step, driver, click, appSession, processRegistry, surfaceTracker }) {
814434
814580
  let result = {
814435
814581
  status: "PASS",
814436
814582
  description: "Found an element matching selector.",
@@ -814443,20 +814589,33 @@ async function findElement({ config, step, driver, click, appSession }) {
814443
814589
  return result;
814444
814590
  }
814445
814591
  step = isValidStep.object;
814446
- if (typeof step.find === "object" && step.find.surface !== void 0) {
814447
- const appRef = resolveAppSurfaceRef(step.find.surface, appSession);
814448
- if (appRef) {
814449
- if (appRef.error) {
814450
- result.status = "FAIL";
814451
- result.description = appRef.error;
814452
- return result;
814453
- }
814592
+ const target = resolveTargetSurface({
814593
+ surface: typeof step.find === "object" && step.find !== null ? step.find.surface : void 0,
814594
+ tracker: surfaceTracker,
814595
+ driver,
814596
+ appSession,
814597
+ processRegistry
814598
+ });
814599
+ if (target.kind === "error") {
814600
+ result.status = "FAIL";
814601
+ result.description = target.message;
814602
+ return result;
814603
+ }
814604
+ if (target.kind === "process") {
814605
+ result.status = "FAIL";
814606
+ result.description = `The resolved surface is the background process "${target.name}", which doesn't support find or click steps. Target a browser or app surface with \`surface\`, or send input with a type step.`;
814607
+ return result;
814608
+ }
814609
+ if (target.kind === "app") {
814610
+ const appRef = { entry: target.entry, window: target.window };
814611
+ const findSpec = typeof step.find === "string" ? { elementText: step.find } : step.find;
814612
+ {
814454
814613
  let windowTarget = null;
814455
814614
  if (appRef.window !== void 0) {
814456
814615
  const resolved = await resolveAppWindow({
814457
814616
  entry: appRef.entry,
814458
814617
  selector: appRef.window,
814459
- timeoutMs: step.find.timeout ?? 5e3
814618
+ timeoutMs: findSpec.timeout ?? 5e3
814460
814619
  });
814461
814620
  if (!resolved.ok) {
814462
814621
  result.status = "FAIL";
@@ -814476,10 +814635,10 @@ async function findElement({ config, step, driver, click, appSession }) {
814476
814635
  const appDriver = appRef.entry.driver;
814477
814636
  const found = await findAppElement({
814478
814637
  driver: appDriver,
814479
- criteria: step.find,
814638
+ criteria: findSpec,
814480
814639
  // ?? so an explicit `timeout: 0` (schema minimum) stays an
814481
814640
  // immediate check instead of being clobbered to the default.
814482
- timeout: step.find.timeout ?? 5e3,
814641
+ timeout: findSpec.timeout ?? 5e3,
814483
814642
  platform: appRef.entry.platform,
814484
814643
  root: scopedFindRoot(appRef.entry, windowTarget)
814485
814644
  });
@@ -814495,15 +814654,15 @@ async function findElement({ config, step, driver, click, appSession }) {
814495
814654
  } catch {
814496
814655
  }
814497
814656
  await finalizeFound({ result });
814498
- if (step.find.moveTo || step.find.type) {
814657
+ if (findSpec.moveTo || findSpec.type) {
814499
814658
  result.status = "FAIL";
814500
814659
  result.description += " The moveTo/type sub-effects aren't supported on app surfaces; use a separate `type` step targeting the app surface.";
814501
814660
  return result;
814502
814661
  }
814503
- if (click || step.find.click) {
814504
- const clickSpec = step.find.click;
814662
+ if (click || findSpec.click) {
814663
+ const clickSpec = findSpec.click;
814505
814664
  const button = typeof clickSpec === "string" && ["left", "right", "middle"].includes(clickSpec) ? clickSpec : clickSpec?.button || "left";
814506
- const duration = step.find.click?.duration;
814665
+ const duration = findSpec.click?.duration;
814507
814666
  const gestures = APP_GESTURES[appRef.entry.platform ?? "windows"];
814508
814667
  if (duration && button !== "left") {
814509
814668
  result.status = "FAIL";
@@ -814548,8 +814707,8 @@ async function findElement({ config, step, driver, click, appSession }) {
814548
814707
  return result;
814549
814708
  }
814550
814709
  }
814551
- if (typeof step.find === "object" && step.find.surface !== void 0) {
814552
- const switched = await switchToSurface(driver, step.find.surface);
814710
+ if (target.surface !== void 0) {
814711
+ const switched = await switchToSurface(driver, target.surface);
814553
814712
  if (!switched.ok) {
814554
814713
  result.status = "FAIL";
814555
814714
  result.description = switched.message;
@@ -815949,7 +816108,7 @@ function normalizeSwipe(swipe) {
815949
816108
  duration: swipe.duration ?? DEFAULT_SWIPE_DURATION
815950
816109
  };
815951
816110
  }
815952
- async function swipeSurface({ config, step, driver, appSession }) {
816111
+ async function swipeSurface({ config, step, driver, appSession, processRegistry, surfaceTracker }) {
815953
816112
  const result = {
815954
816113
  status: "PASS",
815955
816114
  description: "Swiped the surface.",
@@ -815971,13 +816130,25 @@ async function swipeSurface({ config, step, driver, appSession }) {
815971
816130
  ...gesture.from !== void 0 && { from: gesture.from, to: gesture.to },
815972
816131
  duration: gesture.duration
815973
816132
  };
815974
- const appRef = resolveAppSurfaceRef(surface, appSession);
815975
- if (appRef) {
815976
- if (appRef.error) {
815977
- result.status = "FAIL";
815978
- result.description = appRef.error;
815979
- return result;
815980
- }
816133
+ const target = resolveTargetSurface({
816134
+ surface,
816135
+ tracker: surfaceTracker,
816136
+ driver,
816137
+ appSession,
816138
+ processRegistry
816139
+ });
816140
+ if (target.kind === "error") {
816141
+ result.status = "FAIL";
816142
+ result.description = target.message;
816143
+ return result;
816144
+ }
816145
+ if (target.kind === "process") {
816146
+ result.status = "FAIL";
816147
+ result.description = `The resolved surface is the background process "${target.name}", which doesn't support swipe steps. Target a browser or app surface with \`surface\`.`;
816148
+ return result;
816149
+ }
816150
+ if (target.kind === "app") {
816151
+ const appRef = { entry: target.entry, window: target.window };
815981
816152
  let windowTarget = null;
815982
816153
  if (appRef.window !== void 0) {
815983
816154
  const resolvedWindow = await resolveAppWindow({
@@ -816023,14 +816194,8 @@ async function swipeSurface({ config, step, driver, appSession }) {
816023
816194
  result.description = `Swiped the app surface "${appRef.entry.name}".`;
816024
816195
  return result;
816025
816196
  }
816026
- const resolved = reinterpretForSessions(driver, parseSurfaceRef(surface));
816027
- if (resolved.kind === "unsupported") {
816028
- result.status = "FAIL";
816029
- result.description = `The surface names an app, but no app session is active in this context. Open the app first with startSurface.`;
816030
- return result;
816031
- }
816032
- if (resolved.kind === "browser") {
816033
- const switched = await switchToSurface(driver, surface);
816197
+ if (target.surface !== void 0) {
816198
+ const switched = await switchToSurface(driver, target.surface);
816034
816199
  if (!switched.ok) {
816035
816200
  result.status = "FAIL";
816036
816201
  result.description = switched.message;
@@ -816040,7 +816205,7 @@ async function swipeSurface({ config, step, driver, appSession }) {
816040
816205
  }
816041
816206
  if (!driver) {
816042
816207
  result.status = "FAIL";
816043
- result.description = `swipe needs a surface to act on in an app-only context. Name the app surface: { "swipe": { "direction": "up", "surface": { "app": "\u2026" } } }.`;
816208
+ result.description = "No active surface to act on. Open one first with a startSurface step (or a goTo step for a browser), or target a surface explicitly with `surface`.";
816044
816209
  return result;
816045
816210
  }
816046
816211
  try {
@@ -816157,7 +816322,7 @@ function aspectRatiosMatch(a, b) {
816157
816322
  const rb = b.width / b.height;
816158
816323
  return Math.abs(ra - rb) / Math.max(ra, rb) <= 0.05;
816159
816324
  }
816160
- async function saveScreenshot({ config, step, driver, appSession, internal, annotationTheme }) {
816325
+ async function saveScreenshot({ config, step, driver, appSession, processRegistry, surfaceTracker, internal, annotationTheme }) {
816161
816326
  let result = {
816162
816327
  status: "PASS",
816163
816328
  description: "Saved screenshot.",
@@ -816197,55 +816362,65 @@ async function saveScreenshot({ config, step, driver, appSession, internal, anno
816197
816362
  let isAppCapture = false;
816198
816363
  let appEntry = null;
816199
816364
  let appWindowTarget = null;
816200
- if (typeof step.screenshot === "object" && step.screenshot !== null && step.screenshot.surface !== void 0) {
816201
- const appRef = resolveAppSurfaceRef(step.screenshot.surface, appSession);
816202
- if (appRef) {
816203
- if (appRef.error) {
816204
- result.status = "FAIL";
816205
- result.description = appRef.error;
816206
- return result;
816207
- }
816208
- if (appRef.window !== void 0) {
816209
- const resolvedWindow = await resolveAppWindow({
816210
- entry: appRef.entry,
816211
- selector: appRef.window,
816212
- timeoutMs: 5e3
816213
- });
816214
- if (!resolvedWindow.ok) {
816215
- result.status = "FAIL";
816216
- result.description = resolvedWindow.message;
816217
- return result;
816218
- }
816219
- appWindowTarget = resolvedWindow.target;
816220
- }
816221
- if (step.screenshot.crop) {
816222
- result.status = "FAIL";
816223
- result.description = "crop isn't supported on app captures yet; it relies on browser viewport APIs. Capture the window and crop downstream, or omit crop.";
816224
- return result;
816225
- }
816226
- const switchedApp = await ensureAppForeground(appRef.entry, appSession);
816227
- if (switchedApp.error) {
816228
- result.status = "FAIL";
816229
- result.description = switchedApp.error;
816230
- return result;
816231
- }
816232
- captureDriver = appRef.entry.driver;
816233
- appEntry = appRef.entry;
816234
- isAppCapture = true;
816235
- } else {
816236
- const switched = await switchToSurface(driver, step.screenshot.surface);
816237
- if (!switched.ok) {
816365
+ const target = resolveTargetSurface({
816366
+ surface: typeof step.screenshot === "object" && step.screenshot !== null ? step.screenshot.surface : void 0,
816367
+ tracker: surfaceTracker,
816368
+ driver,
816369
+ appSession,
816370
+ processRegistry
816371
+ });
816372
+ if (target.kind === "error") {
816373
+ result.status = "FAIL";
816374
+ result.description = target.message;
816375
+ return result;
816376
+ }
816377
+ if (target.kind === "process") {
816378
+ result.status = "FAIL";
816379
+ result.description = `The resolved surface is the background process "${target.name}", which doesn't support screenshot steps. Target a browser or app surface with \`surface\`.`;
816380
+ return result;
816381
+ }
816382
+ if (target.kind === "app") {
816383
+ const appRef = { entry: target.entry, window: target.window };
816384
+ if (appRef.window !== void 0) {
816385
+ const resolvedWindow = await resolveAppWindow({
816386
+ entry: appRef.entry,
816387
+ selector: appRef.window,
816388
+ timeoutMs: 5e3
816389
+ });
816390
+ if (!resolvedWindow.ok) {
816238
816391
  result.status = "FAIL";
816239
- result.description = switched.message;
816392
+ result.description = resolvedWindow.message;
816240
816393
  return result;
816241
816394
  }
816242
- driver = switched.driver ?? driver;
816243
- captureDriver = driver;
816395
+ appWindowTarget = resolvedWindow.target;
816396
+ }
816397
+ if (typeof step.screenshot === "object" && step.screenshot?.crop) {
816398
+ result.status = "FAIL";
816399
+ result.description = "crop isn't supported on app captures yet; it relies on browser viewport APIs. Capture the window and crop downstream, or omit crop.";
816400
+ return result;
816401
+ }
816402
+ const switchedApp = await ensureAppForeground(appRef.entry, appSession);
816403
+ if (switchedApp.error) {
816404
+ result.status = "FAIL";
816405
+ result.description = switchedApp.error;
816406
+ return result;
816244
816407
  }
816408
+ captureDriver = appRef.entry.driver;
816409
+ appEntry = appRef.entry;
816410
+ isAppCapture = true;
816411
+ } else if (target.surface !== void 0) {
816412
+ const switched = await switchToSurface(driver, target.surface);
816413
+ if (!switched.ok) {
816414
+ result.status = "FAIL";
816415
+ result.description = switched.message;
816416
+ return result;
816417
+ }
816418
+ driver = switched.driver ?? driver;
816419
+ captureDriver = driver;
816245
816420
  }
816246
816421
  if (!captureDriver) {
816247
816422
  result.status = "FAIL";
816248
- result.description = 'No browser session is running in this context to capture. Target an app surface explicitly (e.g. "surface": { "app": "\u2026" }).';
816423
+ result.description = "No active surface to act on. Open one first with a startSurface step (or a goTo step for a browser), or target a surface explicitly with `surface`.";
816249
816424
  return result;
816250
816425
  }
816251
816426
  if (typeof step.screenshot === "boolean") {
@@ -818790,7 +818965,7 @@ function objectExistsInObject(expected, actual) {
818790
818965
 
818791
818966
  // dist/core/tests/click.js
818792
818967
  init_validate();
818793
- async function clickElement({ config, step, driver, appSession }) {
818968
+ async function clickElement({ config, step, driver, appSession, processRegistry, surfaceTracker }) {
818794
818969
  const result = {
818795
818970
  status: "PASS",
818796
818971
  description: "Clicked element.",
@@ -818823,7 +818998,9 @@ async function clickElement({ config, step, driver, appSession }) {
818823
818998
  step: findStep,
818824
818999
  driver,
818825
819000
  click: true,
818826
- appSession
819001
+ appSession,
819002
+ processRegistry,
819003
+ surfaceTracker
818827
819004
  });
818828
819005
  result.outputs = findResult.outputs;
818829
819006
  result.assertions = findResult.assertions;
@@ -819207,7 +819384,7 @@ function intendedName(d, kind) {
819207
819384
  return defaultAppSurfaceName(String(d.app).trim());
819208
819385
  return String(d.process ?? "").trim();
819209
819386
  }
819210
- async function startSurfaceStep({ config, step, platform, driver, processRegistry, appSession, serverDeps, deps }) {
819387
+ async function startSurfaceStep({ config, step, platform, driver, processRegistry, appSession, surfaceTracker, serverDeps, deps }) {
819211
819388
  const startApp = deps?.startAppSurface ?? startAppSurface;
819212
819389
  const startProcess = deps?.startBackgroundProcessSurface ?? startBackgroundProcessSurface;
819213
819390
  const isValidStep = validate({ schemaKey: "step_v3", object: step });
@@ -819310,7 +819487,7 @@ async function startSurfaceStep({ config, step, platform, driver, processRegistr
819310
819487
  } catch (error) {
819311
819488
  return { status: "FAIL", description: error.message };
819312
819489
  }
819313
- return startProcess({
819490
+ const started = await startProcess({
819314
819491
  config,
819315
819492
  descriptor: {
819316
819493
  command: d.process,
@@ -819325,6 +819502,10 @@ async function startSurfaceStep({ config, step, platform, driver, processRegistr
819325
819502
  processRegistry,
819326
819503
  driver
819327
819504
  });
819505
+ if (started.status === "PASS") {
819506
+ activateSurface(surfaceTracker, { kind: "process", name: d.name });
819507
+ }
819508
+ return started;
819328
819509
  };
819329
819510
  if (!isArrayForm) {
819330
819511
  const d = descriptors[0];
@@ -819406,6 +819587,24 @@ async function startSurfaceStep({ config, step, platform, driver, processRegistr
819406
819587
  }
819407
819588
  }
819408
819589
  }
819590
+ for (const slot of indexed) {
819591
+ if (results[slot.i]?.status !== "PASS")
819592
+ continue;
819593
+ const name = results[slot.i].outputs?.name ?? slot.name;
819594
+ if (slot.kind === "app") {
819595
+ activateSurface(appSession?.tracker ?? surfaceTracker, {
819596
+ kind: "app",
819597
+ name
819598
+ });
819599
+ } else if (slot.kind === "browser") {
819600
+ activateSurface(browserRegistry?.tracker ?? surfaceTracker, {
819601
+ kind: "browser",
819602
+ name
819603
+ });
819604
+ } else {
819605
+ activateSurface(surfaceTracker, { kind: "process", name });
819606
+ }
819607
+ }
819409
819608
  const statuses = results.map((r) => r?.status ?? "FAIL");
819410
819609
  const rollup = statuses.includes("FAIL") ? "FAIL" : statuses.includes("SKIPPED") ? "SKIPPED" : "PASS";
819411
819610
  const description = results.map((r) => `${r?.name ?? "?"} (${r?.kind ?? "?"}): ${r?.status ?? "FAIL"} \u2014 ${r?.description ?? "No result."}`).join("\n");
@@ -820708,7 +820907,8 @@ function isSupportedContext({ context, apps, platform }) {
820708
820907
  function isBrowserRequired({ test }) {
820709
820908
  if (!Array.isArray(test?.steps))
820710
820909
  return false;
820711
- return test.steps.some((step) => !step?.__autoRecord && (BROWSER_STEP_KEYS.some((action) => typeof step[action] !== "undefined") && !stepTargetsAppSurface(step) || // Phase 6: `startSurface: { browser: … }` opens a browser session
820910
+ const hasNonBrowserSignal = testHasNonBrowserSurfaceSignal(test.steps);
820911
+ return test.steps.some((step) => !step?.__autoRecord && (BROWSER_STEP_KEYS.some((action) => typeof step[action] !== "undefined") && !stepTargetsAppSurface(step) && !stepTargetsProcessSurface(step) && !(hasNonBrowserSignal && stepIsSurfacelessInteraction(step)) || // Phase 6: `startSurface: { browser: … }` opens a browser session
820712
820912
  // (the goTo-opener sibling); app/process descriptors don't.
820713
820913
  stepOpensBrowserSurface(step)));
820714
820914
  }
@@ -822327,6 +822527,7 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
822327
822527
  };
822328
822528
  metaValues.specs[spec.specId].tests[test.testId].contexts[context.contextId] ??= { steps: {} };
822329
822529
  let appSession;
822530
+ const surfaceTracker = createActiveSurfaceTracker();
822330
822531
  let mobileWebBrowserName;
822331
822532
  const mobileTarget = isMobileTargetPlatform(context.platform);
822332
822533
  if (mobileTarget) {
@@ -822397,6 +822598,8 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
822397
822598
  appSession.appiumEntry = preflight.appiumEntry;
822398
822599
  appSession.appiumHome = preflight.appiumHome;
822399
822600
  }
822601
+ if (appSession)
822602
+ appSession.tracker = surfaceTracker;
822400
822603
  if (isBrowserRequired({ test: context }) && !context.browser?.name) {
822401
822604
  const errorMessage = `Skipping context on '${context.platform}': no supported browser is available in the current environment.`;
822402
822605
  clog("warning", errorMessage);
@@ -822555,7 +822758,8 @@ ${JSON.stringify(context, null, 2)}`);
822555
822758
  open: async () => {
822556
822759
  throw new Error("Additional browser sessions aren't supported on a managed device; the device browser is the context's only browser surface.");
822557
822760
  },
822558
- isNameTaken: (name) => !!processRegistry?.has(name)
822761
+ isNameTaken: (name) => !!processRegistry?.has(name),
822762
+ tracker: surfaceTracker
822559
822763
  });
822560
822764
  registerSession(browserSessions, {
822561
822765
  name: String(mobileWebBrowserName).toLowerCase(),
@@ -822700,7 +822904,8 @@ ${JSON.stringify(context, null, 2)}`);
822700
822904
  throw new Error(res.error);
822701
822905
  return res.driver;
822702
822906
  },
822703
- isNameTaken: (name) => !!processRegistry?.has(name)
822907
+ isNameTaken: (name) => !!processRegistry?.has(name),
822908
+ tracker: surfaceTracker
822704
822909
  });
822705
822910
  registerSession(browserSessions, {
822706
822911
  name: String(startedName).toLowerCase(),
@@ -822867,7 +823072,8 @@ ${JSON.stringify(step, null, 2)}`);
822867
823072
  annotationTheme
822868
823073
  },
822869
823074
  processRegistry,
822870
- appSession
823075
+ appSession,
823076
+ surfaceTracker
822871
823077
  });
822872
823078
  if (logLevelEnabled(config, "debug"))
822873
823079
  clog("debug", `RESULT: ${r.status}
@@ -823075,7 +823281,7 @@ async function stopAllRecordings({ config, context, driver, contextReport }) {
823075
823281
  }
823076
823282
  }
823077
823283
  }
823078
- async function runStep({ config = {}, context = {}, step, driver, metaValues = {}, options = {}, processRegistry, appSession }) {
823284
+ async function runStep({ config = {}, context = {}, step, driver, metaValues = {}, options = {}, processRegistry, appSession, surfaceTracker }) {
823079
823285
  let actionResult;
823080
823286
  step = replaceEnvs(step);
823081
823287
  if (typeof step.click !== "undefined") {
@@ -823083,7 +823289,9 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
823083
823289
  config,
823084
823290
  step,
823085
823291
  driver,
823086
- appSession
823292
+ appSession,
823293
+ processRegistry,
823294
+ surfaceTracker
823087
823295
  });
823088
823296
  } else if (typeof step.dragAndDrop !== "undefined") {
823089
823297
  actionResult = await dragAndDropElement({
@@ -823094,7 +823302,7 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
823094
823302
  } else if (typeof step.checkLink !== "undefined") {
823095
823303
  actionResult = await checkLink({ config, step });
823096
823304
  } else if (typeof step.find !== "undefined") {
823097
- actionResult = await findElement({ config, step, driver, appSession });
823305
+ actionResult = await findElement({ config, step, driver, appSession, processRegistry, surfaceTracker });
823098
823306
  } else if (typeof step.stopRecord !== "undefined") {
823099
823307
  actionResult = await stopRecording({
823100
823308
  config,
@@ -823185,6 +823393,7 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
823185
823393
  appSession,
823186
823394
  driver,
823187
823395
  processRegistry,
823396
+ surfaceTracker,
823188
823397
  platform: context?.platform ?? "",
823189
823398
  serverDeps: {
823190
823399
  startServer: async (appiumEntry, appiumHome) => {
@@ -823233,6 +823442,8 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
823233
823442
  step,
823234
823443
  driver,
823235
823444
  appSession,
823445
+ processRegistry,
823446
+ surfaceTracker,
823236
823447
  annotationTheme: options?.annotationTheme
823237
823448
  });
823238
823449
  } else if (typeof step.annotate !== "undefined") {
@@ -823247,7 +823458,9 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
823247
823458
  config,
823248
823459
  step,
823249
823460
  driver,
823250
- appSession
823461
+ appSession,
823462
+ processRegistry,
823463
+ surfaceTracker
823251
823464
  });
823252
823465
  } else if (typeof step.type !== "undefined") {
823253
823466
  actionResult = await typeKeys({
@@ -823255,7 +823468,8 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
823255
823468
  step,
823256
823469
  driver,
823257
823470
  processRegistry,
823258
- appSession
823471
+ appSession,
823472
+ surfaceTracker
823259
823473
  });
823260
823474
  } else if (typeof step.wait !== "undefined") {
823261
823475
  actionResult = await wait({ step, driver });