@softure-ai/marketing-kit 0.1.9 → 0.1.11

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 (67) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/README.md +124 -5
  3. package/dist/cli/main.js +42 -6
  4. package/dist/cli/main.js.map +1 -1
  5. package/dist/config/config.d.ts +2 -0
  6. package/dist/config/config.d.ts.map +1 -1
  7. package/dist/config/config.js +1 -0
  8. package/dist/config/config.js.map +1 -1
  9. package/dist/config/placeholders.d.ts +32 -0
  10. package/dist/config/placeholders.d.ts.map +1 -0
  11. package/dist/config/placeholders.js +41 -0
  12. package/dist/config/placeholders.js.map +1 -0
  13. package/dist/config/schema.d.ts +3758 -0
  14. package/dist/config/schema.d.ts.map +1 -1
  15. package/dist/config/schema.js +84 -0
  16. package/dist/config/schema.js.map +1 -1
  17. package/dist/config/shot-steps.d.ts +1101 -0
  18. package/dist/config/shot-steps.d.ts.map +1 -0
  19. package/dist/config/shot-steps.js +65 -0
  20. package/dist/config/shot-steps.js.map +1 -0
  21. package/dist/record/actions.d.ts +3 -10
  22. package/dist/record/actions.d.ts.map +1 -1
  23. package/dist/record/actions.js +7 -23
  24. package/dist/record/actions.js.map +1 -1
  25. package/dist/record/locator.d.ts +10 -0
  26. package/dist/record/locator.d.ts.map +1 -0
  27. package/dist/record/locator.js +24 -0
  28. package/dist/record/locator.js.map +1 -0
  29. package/dist/screenshot/gates.d.ts +55 -5
  30. package/dist/screenshot/gates.d.ts.map +1 -1
  31. package/dist/screenshot/gates.js +58 -5
  32. package/dist/screenshot/gates.js.map +1 -1
  33. package/dist/screenshot/prepare.d.ts +18 -0
  34. package/dist/screenshot/prepare.d.ts.map +1 -0
  35. package/dist/screenshot/prepare.js +60 -0
  36. package/dist/screenshot/prepare.js.map +1 -0
  37. package/dist/screenshot/screenshot.d.ts +9 -2
  38. package/dist/screenshot/screenshot.d.ts.map +1 -1
  39. package/dist/screenshot/screenshot.js +140 -8
  40. package/dist/screenshot/screenshot.js.map +1 -1
  41. package/dist/screenshot/shot-texts.d.ts +26 -0
  42. package/dist/screenshot/shot-texts.d.ts.map +1 -0
  43. package/dist/screenshot/shot-texts.js +55 -0
  44. package/dist/screenshot/shot-texts.js.map +1 -0
  45. package/dist/screenshot/sign-in.d.ts +34 -0
  46. package/dist/screenshot/sign-in.d.ts.map +1 -0
  47. package/dist/screenshot/sign-in.js +66 -0
  48. package/dist/screenshot/sign-in.js.map +1 -0
  49. package/dist/screenshot/steps.d.ts +13 -0
  50. package/dist/screenshot/steps.d.ts.map +1 -0
  51. package/dist/screenshot/steps.js +82 -0
  52. package/dist/screenshot/steps.js.map +1 -0
  53. package/package.json +2 -2
  54. package/schema/marketing.schema.json +3080 -10
  55. package/src/cli/main.ts +40 -6
  56. package/src/config/config.ts +3 -0
  57. package/src/config/placeholders.ts +60 -0
  58. package/src/config/schema.ts +89 -0
  59. package/src/config/shot-steps.ts +79 -0
  60. package/src/record/actions.ts +5 -31
  61. package/src/record/locator.ts +37 -0
  62. package/src/screenshot/gates.ts +77 -5
  63. package/src/screenshot/prepare.ts +64 -0
  64. package/src/screenshot/screenshot.ts +146 -9
  65. package/src/screenshot/shot-texts.ts +72 -0
  66. package/src/screenshot/sign-in.ts +91 -0
  67. package/src/screenshot/steps.ts +85 -0
@@ -2637,7 +2637,6 @@
2637
2637
  "additionalProperties": false
2638
2638
  },
2639
2639
  "screenshots": {
2640
- "default": [],
2641
2640
  "description": "Screenshots taken by softure-marketing shots.",
2642
2641
  "type": "array",
2643
2642
  "items": {
@@ -2727,17 +2726,3088 @@
2727
2726
  "description": "A Playwright storage state (cookies and localStorage as JSON), relative to the folder of marketing.json, to capture a signed-in screen. It holds a session: keep it out of git.",
2728
2727
  "type": "string",
2729
2728
  "minLength": 1
2729
+ },
2730
+ "signedIn": {
2731
+ "default": false,
2732
+ "description": "Capture signed in through the signIn block: shots signs in once per run and keeps the session in memory. Not with storageState.",
2733
+ "type": "boolean"
2734
+ },
2735
+ "steps": {
2736
+ "description": "Done in order after the page loaded, before any gate reads it, e.g. a click that opens a collapsed section; a failing step refuses the shot.",
2737
+ "type": "array",
2738
+ "items": {
2739
+ "oneOf": [
2740
+ {
2741
+ "type": "object",
2742
+ "properties": {
2743
+ "do": {
2744
+ "type": "string",
2745
+ "const": "fill",
2746
+ "description": "Replaces the value of an input, e.g. the e-mail of the sign-in form."
2747
+ },
2748
+ "target": {
2749
+ "description": "The element, as a locator descriptor with exactly one of role, text, label, testId, css.",
2750
+ "type": "object",
2751
+ "properties": {
2752
+ "role": {
2753
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
2754
+ "type": "string",
2755
+ "enum": [
2756
+ "alert",
2757
+ "alertdialog",
2758
+ "application",
2759
+ "article",
2760
+ "banner",
2761
+ "blockquote",
2762
+ "button",
2763
+ "caption",
2764
+ "cell",
2765
+ "checkbox",
2766
+ "code",
2767
+ "columnheader",
2768
+ "combobox",
2769
+ "complementary",
2770
+ "contentinfo",
2771
+ "definition",
2772
+ "deletion",
2773
+ "dialog",
2774
+ "directory",
2775
+ "document",
2776
+ "emphasis",
2777
+ "feed",
2778
+ "figure",
2779
+ "form",
2780
+ "generic",
2781
+ "grid",
2782
+ "gridcell",
2783
+ "group",
2784
+ "heading",
2785
+ "img",
2786
+ "insertion",
2787
+ "link",
2788
+ "list",
2789
+ "listbox",
2790
+ "listitem",
2791
+ "log",
2792
+ "main",
2793
+ "marquee",
2794
+ "math",
2795
+ "meter",
2796
+ "menu",
2797
+ "menubar",
2798
+ "menuitem",
2799
+ "menuitemcheckbox",
2800
+ "menuitemradio",
2801
+ "navigation",
2802
+ "none",
2803
+ "note",
2804
+ "option",
2805
+ "paragraph",
2806
+ "presentation",
2807
+ "progressbar",
2808
+ "radio",
2809
+ "radiogroup",
2810
+ "region",
2811
+ "row",
2812
+ "rowgroup",
2813
+ "rowheader",
2814
+ "scrollbar",
2815
+ "search",
2816
+ "searchbox",
2817
+ "separator",
2818
+ "slider",
2819
+ "spinbutton",
2820
+ "status",
2821
+ "strong",
2822
+ "subscript",
2823
+ "superscript",
2824
+ "switch",
2825
+ "tab",
2826
+ "table",
2827
+ "tablist",
2828
+ "tabpanel",
2829
+ "term",
2830
+ "textbox",
2831
+ "time",
2832
+ "timer",
2833
+ "toolbar",
2834
+ "tooltip",
2835
+ "tree",
2836
+ "treegrid",
2837
+ "treeitem"
2838
+ ]
2839
+ },
2840
+ "name": {
2841
+ "description": "The accessible name, with role: a string or { regex, flags }.",
2842
+ "anyOf": [
2843
+ {
2844
+ "type": "string",
2845
+ "minLength": 1
2846
+ },
2847
+ {
2848
+ "type": "object",
2849
+ "properties": {
2850
+ "regex": {
2851
+ "type": "string",
2852
+ "minLength": 1,
2853
+ "description": "A JavaScript regular expression source, without slashes."
2854
+ },
2855
+ "flags": {
2856
+ "default": "",
2857
+ "description": "Any of i, m, s, u, each at most once.",
2858
+ "type": "string",
2859
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
2860
+ }
2861
+ },
2862
+ "required": [
2863
+ "regex"
2864
+ ],
2865
+ "additionalProperties": false
2866
+ }
2867
+ ]
2868
+ },
2869
+ "text": {
2870
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
2871
+ "anyOf": [
2872
+ {
2873
+ "type": "string",
2874
+ "minLength": 1
2875
+ },
2876
+ {
2877
+ "type": "object",
2878
+ "properties": {
2879
+ "regex": {
2880
+ "type": "string",
2881
+ "minLength": 1,
2882
+ "description": "A JavaScript regular expression source, without slashes."
2883
+ },
2884
+ "flags": {
2885
+ "default": "",
2886
+ "description": "Any of i, m, s, u, each at most once.",
2887
+ "type": "string",
2888
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
2889
+ }
2890
+ },
2891
+ "required": [
2892
+ "regex"
2893
+ ],
2894
+ "additionalProperties": false
2895
+ }
2896
+ ]
2897
+ },
2898
+ "label": {
2899
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
2900
+ "anyOf": [
2901
+ {
2902
+ "type": "string",
2903
+ "minLength": 1
2904
+ },
2905
+ {
2906
+ "type": "object",
2907
+ "properties": {
2908
+ "regex": {
2909
+ "type": "string",
2910
+ "minLength": 1,
2911
+ "description": "A JavaScript regular expression source, without slashes."
2912
+ },
2913
+ "flags": {
2914
+ "default": "",
2915
+ "description": "Any of i, m, s, u, each at most once.",
2916
+ "type": "string",
2917
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
2918
+ }
2919
+ },
2920
+ "required": [
2921
+ "regex"
2922
+ ],
2923
+ "additionalProperties": false
2924
+ }
2925
+ ]
2926
+ },
2927
+ "testId": {
2928
+ "description": "Find by data-testid (Playwright getByTestId).",
2929
+ "type": "string",
2930
+ "minLength": 1
2931
+ },
2932
+ "css": {
2933
+ "description": "Find by CSS selector; narrow it with hasText.",
2934
+ "type": "string",
2935
+ "minLength": 1
2936
+ },
2937
+ "hasText": {
2938
+ "description": "Only elements containing this text, with css.",
2939
+ "anyOf": [
2940
+ {
2941
+ "type": "string",
2942
+ "minLength": 1
2943
+ },
2944
+ {
2945
+ "type": "object",
2946
+ "properties": {
2947
+ "regex": {
2948
+ "type": "string",
2949
+ "minLength": 1,
2950
+ "description": "A JavaScript regular expression source, without slashes."
2951
+ },
2952
+ "flags": {
2953
+ "default": "",
2954
+ "description": "Any of i, m, s, u, each at most once.",
2955
+ "type": "string",
2956
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
2957
+ }
2958
+ },
2959
+ "required": [
2960
+ "regex"
2961
+ ],
2962
+ "additionalProperties": false
2963
+ }
2964
+ ]
2965
+ },
2966
+ "exact": {
2967
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
2968
+ "type": "boolean"
2969
+ },
2970
+ "nth": {
2971
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
2972
+ "type": "integer",
2973
+ "minimum": 0,
2974
+ "maximum": 9007199254740991
2975
+ }
2976
+ },
2977
+ "additionalProperties": false
2978
+ },
2979
+ "value": {
2980
+ "type": "string",
2981
+ "description": "The value; {env:NAME} and {data:key} are replaced. Never printed, so a password may go here as {env:NAME}."
2982
+ }
2983
+ },
2984
+ "required": [
2985
+ "do",
2986
+ "target",
2987
+ "value"
2988
+ ],
2989
+ "additionalProperties": false
2990
+ },
2991
+ {
2992
+ "type": "object",
2993
+ "properties": {
2994
+ "do": {
2995
+ "type": "string",
2996
+ "const": "click",
2997
+ "description": "Clicks the element, e.g. the submit button or a collapsed section's summary."
2998
+ },
2999
+ "target": {
3000
+ "description": "The element, as a locator descriptor with exactly one of role, text, label, testId, css.",
3001
+ "type": "object",
3002
+ "properties": {
3003
+ "role": {
3004
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
3005
+ "type": "string",
3006
+ "enum": [
3007
+ "alert",
3008
+ "alertdialog",
3009
+ "application",
3010
+ "article",
3011
+ "banner",
3012
+ "blockquote",
3013
+ "button",
3014
+ "caption",
3015
+ "cell",
3016
+ "checkbox",
3017
+ "code",
3018
+ "columnheader",
3019
+ "combobox",
3020
+ "complementary",
3021
+ "contentinfo",
3022
+ "definition",
3023
+ "deletion",
3024
+ "dialog",
3025
+ "directory",
3026
+ "document",
3027
+ "emphasis",
3028
+ "feed",
3029
+ "figure",
3030
+ "form",
3031
+ "generic",
3032
+ "grid",
3033
+ "gridcell",
3034
+ "group",
3035
+ "heading",
3036
+ "img",
3037
+ "insertion",
3038
+ "link",
3039
+ "list",
3040
+ "listbox",
3041
+ "listitem",
3042
+ "log",
3043
+ "main",
3044
+ "marquee",
3045
+ "math",
3046
+ "meter",
3047
+ "menu",
3048
+ "menubar",
3049
+ "menuitem",
3050
+ "menuitemcheckbox",
3051
+ "menuitemradio",
3052
+ "navigation",
3053
+ "none",
3054
+ "note",
3055
+ "option",
3056
+ "paragraph",
3057
+ "presentation",
3058
+ "progressbar",
3059
+ "radio",
3060
+ "radiogroup",
3061
+ "region",
3062
+ "row",
3063
+ "rowgroup",
3064
+ "rowheader",
3065
+ "scrollbar",
3066
+ "search",
3067
+ "searchbox",
3068
+ "separator",
3069
+ "slider",
3070
+ "spinbutton",
3071
+ "status",
3072
+ "strong",
3073
+ "subscript",
3074
+ "superscript",
3075
+ "switch",
3076
+ "tab",
3077
+ "table",
3078
+ "tablist",
3079
+ "tabpanel",
3080
+ "term",
3081
+ "textbox",
3082
+ "time",
3083
+ "timer",
3084
+ "toolbar",
3085
+ "tooltip",
3086
+ "tree",
3087
+ "treegrid",
3088
+ "treeitem"
3089
+ ]
3090
+ },
3091
+ "name": {
3092
+ "description": "The accessible name, with role: a string or { regex, flags }.",
3093
+ "anyOf": [
3094
+ {
3095
+ "type": "string",
3096
+ "minLength": 1
3097
+ },
3098
+ {
3099
+ "type": "object",
3100
+ "properties": {
3101
+ "regex": {
3102
+ "type": "string",
3103
+ "minLength": 1,
3104
+ "description": "A JavaScript regular expression source, without slashes."
3105
+ },
3106
+ "flags": {
3107
+ "default": "",
3108
+ "description": "Any of i, m, s, u, each at most once.",
3109
+ "type": "string",
3110
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3111
+ }
3112
+ },
3113
+ "required": [
3114
+ "regex"
3115
+ ],
3116
+ "additionalProperties": false
3117
+ }
3118
+ ]
3119
+ },
3120
+ "text": {
3121
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
3122
+ "anyOf": [
3123
+ {
3124
+ "type": "string",
3125
+ "minLength": 1
3126
+ },
3127
+ {
3128
+ "type": "object",
3129
+ "properties": {
3130
+ "regex": {
3131
+ "type": "string",
3132
+ "minLength": 1,
3133
+ "description": "A JavaScript regular expression source, without slashes."
3134
+ },
3135
+ "flags": {
3136
+ "default": "",
3137
+ "description": "Any of i, m, s, u, each at most once.",
3138
+ "type": "string",
3139
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3140
+ }
3141
+ },
3142
+ "required": [
3143
+ "regex"
3144
+ ],
3145
+ "additionalProperties": false
3146
+ }
3147
+ ]
3148
+ },
3149
+ "label": {
3150
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
3151
+ "anyOf": [
3152
+ {
3153
+ "type": "string",
3154
+ "minLength": 1
3155
+ },
3156
+ {
3157
+ "type": "object",
3158
+ "properties": {
3159
+ "regex": {
3160
+ "type": "string",
3161
+ "minLength": 1,
3162
+ "description": "A JavaScript regular expression source, without slashes."
3163
+ },
3164
+ "flags": {
3165
+ "default": "",
3166
+ "description": "Any of i, m, s, u, each at most once.",
3167
+ "type": "string",
3168
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3169
+ }
3170
+ },
3171
+ "required": [
3172
+ "regex"
3173
+ ],
3174
+ "additionalProperties": false
3175
+ }
3176
+ ]
3177
+ },
3178
+ "testId": {
3179
+ "description": "Find by data-testid (Playwright getByTestId).",
3180
+ "type": "string",
3181
+ "minLength": 1
3182
+ },
3183
+ "css": {
3184
+ "description": "Find by CSS selector; narrow it with hasText.",
3185
+ "type": "string",
3186
+ "minLength": 1
3187
+ },
3188
+ "hasText": {
3189
+ "description": "Only elements containing this text, with css.",
3190
+ "anyOf": [
3191
+ {
3192
+ "type": "string",
3193
+ "minLength": 1
3194
+ },
3195
+ {
3196
+ "type": "object",
3197
+ "properties": {
3198
+ "regex": {
3199
+ "type": "string",
3200
+ "minLength": 1,
3201
+ "description": "A JavaScript regular expression source, without slashes."
3202
+ },
3203
+ "flags": {
3204
+ "default": "",
3205
+ "description": "Any of i, m, s, u, each at most once.",
3206
+ "type": "string",
3207
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3208
+ }
3209
+ },
3210
+ "required": [
3211
+ "regex"
3212
+ ],
3213
+ "additionalProperties": false
3214
+ }
3215
+ ]
3216
+ },
3217
+ "exact": {
3218
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
3219
+ "type": "boolean"
3220
+ },
3221
+ "nth": {
3222
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
3223
+ "type": "integer",
3224
+ "minimum": 0,
3225
+ "maximum": 9007199254740991
3226
+ }
3227
+ },
3228
+ "additionalProperties": false
3229
+ }
3230
+ },
3231
+ "required": [
3232
+ "do",
3233
+ "target"
3234
+ ],
3235
+ "additionalProperties": false
3236
+ },
3237
+ {
3238
+ "type": "object",
3239
+ "properties": {
3240
+ "do": {
3241
+ "type": "string",
3242
+ "const": "check",
3243
+ "description": "Ticks a checkbox or radio button, e.g. the terms of a sign-up form."
3244
+ },
3245
+ "target": {
3246
+ "description": "The element, as a locator descriptor with exactly one of role, text, label, testId, css.",
3247
+ "type": "object",
3248
+ "properties": {
3249
+ "role": {
3250
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
3251
+ "type": "string",
3252
+ "enum": [
3253
+ "alert",
3254
+ "alertdialog",
3255
+ "application",
3256
+ "article",
3257
+ "banner",
3258
+ "blockquote",
3259
+ "button",
3260
+ "caption",
3261
+ "cell",
3262
+ "checkbox",
3263
+ "code",
3264
+ "columnheader",
3265
+ "combobox",
3266
+ "complementary",
3267
+ "contentinfo",
3268
+ "definition",
3269
+ "deletion",
3270
+ "dialog",
3271
+ "directory",
3272
+ "document",
3273
+ "emphasis",
3274
+ "feed",
3275
+ "figure",
3276
+ "form",
3277
+ "generic",
3278
+ "grid",
3279
+ "gridcell",
3280
+ "group",
3281
+ "heading",
3282
+ "img",
3283
+ "insertion",
3284
+ "link",
3285
+ "list",
3286
+ "listbox",
3287
+ "listitem",
3288
+ "log",
3289
+ "main",
3290
+ "marquee",
3291
+ "math",
3292
+ "meter",
3293
+ "menu",
3294
+ "menubar",
3295
+ "menuitem",
3296
+ "menuitemcheckbox",
3297
+ "menuitemradio",
3298
+ "navigation",
3299
+ "none",
3300
+ "note",
3301
+ "option",
3302
+ "paragraph",
3303
+ "presentation",
3304
+ "progressbar",
3305
+ "radio",
3306
+ "radiogroup",
3307
+ "region",
3308
+ "row",
3309
+ "rowgroup",
3310
+ "rowheader",
3311
+ "scrollbar",
3312
+ "search",
3313
+ "searchbox",
3314
+ "separator",
3315
+ "slider",
3316
+ "spinbutton",
3317
+ "status",
3318
+ "strong",
3319
+ "subscript",
3320
+ "superscript",
3321
+ "switch",
3322
+ "tab",
3323
+ "table",
3324
+ "tablist",
3325
+ "tabpanel",
3326
+ "term",
3327
+ "textbox",
3328
+ "time",
3329
+ "timer",
3330
+ "toolbar",
3331
+ "tooltip",
3332
+ "tree",
3333
+ "treegrid",
3334
+ "treeitem"
3335
+ ]
3336
+ },
3337
+ "name": {
3338
+ "description": "The accessible name, with role: a string or { regex, flags }.",
3339
+ "anyOf": [
3340
+ {
3341
+ "type": "string",
3342
+ "minLength": 1
3343
+ },
3344
+ {
3345
+ "type": "object",
3346
+ "properties": {
3347
+ "regex": {
3348
+ "type": "string",
3349
+ "minLength": 1,
3350
+ "description": "A JavaScript regular expression source, without slashes."
3351
+ },
3352
+ "flags": {
3353
+ "default": "",
3354
+ "description": "Any of i, m, s, u, each at most once.",
3355
+ "type": "string",
3356
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3357
+ }
3358
+ },
3359
+ "required": [
3360
+ "regex"
3361
+ ],
3362
+ "additionalProperties": false
3363
+ }
3364
+ ]
3365
+ },
3366
+ "text": {
3367
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
3368
+ "anyOf": [
3369
+ {
3370
+ "type": "string",
3371
+ "minLength": 1
3372
+ },
3373
+ {
3374
+ "type": "object",
3375
+ "properties": {
3376
+ "regex": {
3377
+ "type": "string",
3378
+ "minLength": 1,
3379
+ "description": "A JavaScript regular expression source, without slashes."
3380
+ },
3381
+ "flags": {
3382
+ "default": "",
3383
+ "description": "Any of i, m, s, u, each at most once.",
3384
+ "type": "string",
3385
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3386
+ }
3387
+ },
3388
+ "required": [
3389
+ "regex"
3390
+ ],
3391
+ "additionalProperties": false
3392
+ }
3393
+ ]
3394
+ },
3395
+ "label": {
3396
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
3397
+ "anyOf": [
3398
+ {
3399
+ "type": "string",
3400
+ "minLength": 1
3401
+ },
3402
+ {
3403
+ "type": "object",
3404
+ "properties": {
3405
+ "regex": {
3406
+ "type": "string",
3407
+ "minLength": 1,
3408
+ "description": "A JavaScript regular expression source, without slashes."
3409
+ },
3410
+ "flags": {
3411
+ "default": "",
3412
+ "description": "Any of i, m, s, u, each at most once.",
3413
+ "type": "string",
3414
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3415
+ }
3416
+ },
3417
+ "required": [
3418
+ "regex"
3419
+ ],
3420
+ "additionalProperties": false
3421
+ }
3422
+ ]
3423
+ },
3424
+ "testId": {
3425
+ "description": "Find by data-testid (Playwright getByTestId).",
3426
+ "type": "string",
3427
+ "minLength": 1
3428
+ },
3429
+ "css": {
3430
+ "description": "Find by CSS selector; narrow it with hasText.",
3431
+ "type": "string",
3432
+ "minLength": 1
3433
+ },
3434
+ "hasText": {
3435
+ "description": "Only elements containing this text, with css.",
3436
+ "anyOf": [
3437
+ {
3438
+ "type": "string",
3439
+ "minLength": 1
3440
+ },
3441
+ {
3442
+ "type": "object",
3443
+ "properties": {
3444
+ "regex": {
3445
+ "type": "string",
3446
+ "minLength": 1,
3447
+ "description": "A JavaScript regular expression source, without slashes."
3448
+ },
3449
+ "flags": {
3450
+ "default": "",
3451
+ "description": "Any of i, m, s, u, each at most once.",
3452
+ "type": "string",
3453
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3454
+ }
3455
+ },
3456
+ "required": [
3457
+ "regex"
3458
+ ],
3459
+ "additionalProperties": false
3460
+ }
3461
+ ]
3462
+ },
3463
+ "exact": {
3464
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
3465
+ "type": "boolean"
3466
+ },
3467
+ "nth": {
3468
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
3469
+ "type": "integer",
3470
+ "minimum": 0,
3471
+ "maximum": 9007199254740991
3472
+ }
3473
+ },
3474
+ "additionalProperties": false
3475
+ }
3476
+ },
3477
+ "required": [
3478
+ "do",
3479
+ "target"
3480
+ ],
3481
+ "additionalProperties": false
3482
+ },
3483
+ {
3484
+ "type": "object",
3485
+ "properties": {
3486
+ "do": {
3487
+ "type": "string",
3488
+ "const": "press",
3489
+ "description": "Presses a key on the focused element, e.g. Enter."
3490
+ },
3491
+ "key": {
3492
+ "type": "string",
3493
+ "pattern": "^\\S+$",
3494
+ "description": "A Playwright key name; modifiers joined with +."
3495
+ }
3496
+ },
3497
+ "required": [
3498
+ "do",
3499
+ "key"
3500
+ ],
3501
+ "additionalProperties": false
3502
+ },
3503
+ {
3504
+ "type": "object",
3505
+ "properties": {
3506
+ "do": {
3507
+ "type": "string",
3508
+ "const": "open",
3509
+ "description": "Opens every matching <details> element (nth picks one), e.g. every disclosure of a card; fails when a match is not a <details> or does not stay open."
3510
+ },
3511
+ "target": {
3512
+ "description": "The <details> elements, as a locator descriptor with exactly one of role, text, label, testId, css; every match is opened.",
3513
+ "type": "object",
3514
+ "properties": {
3515
+ "role": {
3516
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
3517
+ "type": "string",
3518
+ "enum": [
3519
+ "alert",
3520
+ "alertdialog",
3521
+ "application",
3522
+ "article",
3523
+ "banner",
3524
+ "blockquote",
3525
+ "button",
3526
+ "caption",
3527
+ "cell",
3528
+ "checkbox",
3529
+ "code",
3530
+ "columnheader",
3531
+ "combobox",
3532
+ "complementary",
3533
+ "contentinfo",
3534
+ "definition",
3535
+ "deletion",
3536
+ "dialog",
3537
+ "directory",
3538
+ "document",
3539
+ "emphasis",
3540
+ "feed",
3541
+ "figure",
3542
+ "form",
3543
+ "generic",
3544
+ "grid",
3545
+ "gridcell",
3546
+ "group",
3547
+ "heading",
3548
+ "img",
3549
+ "insertion",
3550
+ "link",
3551
+ "list",
3552
+ "listbox",
3553
+ "listitem",
3554
+ "log",
3555
+ "main",
3556
+ "marquee",
3557
+ "math",
3558
+ "meter",
3559
+ "menu",
3560
+ "menubar",
3561
+ "menuitem",
3562
+ "menuitemcheckbox",
3563
+ "menuitemradio",
3564
+ "navigation",
3565
+ "none",
3566
+ "note",
3567
+ "option",
3568
+ "paragraph",
3569
+ "presentation",
3570
+ "progressbar",
3571
+ "radio",
3572
+ "radiogroup",
3573
+ "region",
3574
+ "row",
3575
+ "rowgroup",
3576
+ "rowheader",
3577
+ "scrollbar",
3578
+ "search",
3579
+ "searchbox",
3580
+ "separator",
3581
+ "slider",
3582
+ "spinbutton",
3583
+ "status",
3584
+ "strong",
3585
+ "subscript",
3586
+ "superscript",
3587
+ "switch",
3588
+ "tab",
3589
+ "table",
3590
+ "tablist",
3591
+ "tabpanel",
3592
+ "term",
3593
+ "textbox",
3594
+ "time",
3595
+ "timer",
3596
+ "toolbar",
3597
+ "tooltip",
3598
+ "tree",
3599
+ "treegrid",
3600
+ "treeitem"
3601
+ ]
3602
+ },
3603
+ "name": {
3604
+ "description": "The accessible name, with role: a string or { regex, flags }.",
3605
+ "anyOf": [
3606
+ {
3607
+ "type": "string",
3608
+ "minLength": 1
3609
+ },
3610
+ {
3611
+ "type": "object",
3612
+ "properties": {
3613
+ "regex": {
3614
+ "type": "string",
3615
+ "minLength": 1,
3616
+ "description": "A JavaScript regular expression source, without slashes."
3617
+ },
3618
+ "flags": {
3619
+ "default": "",
3620
+ "description": "Any of i, m, s, u, each at most once.",
3621
+ "type": "string",
3622
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3623
+ }
3624
+ },
3625
+ "required": [
3626
+ "regex"
3627
+ ],
3628
+ "additionalProperties": false
3629
+ }
3630
+ ]
3631
+ },
3632
+ "text": {
3633
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
3634
+ "anyOf": [
3635
+ {
3636
+ "type": "string",
3637
+ "minLength": 1
3638
+ },
3639
+ {
3640
+ "type": "object",
3641
+ "properties": {
3642
+ "regex": {
3643
+ "type": "string",
3644
+ "minLength": 1,
3645
+ "description": "A JavaScript regular expression source, without slashes."
3646
+ },
3647
+ "flags": {
3648
+ "default": "",
3649
+ "description": "Any of i, m, s, u, each at most once.",
3650
+ "type": "string",
3651
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3652
+ }
3653
+ },
3654
+ "required": [
3655
+ "regex"
3656
+ ],
3657
+ "additionalProperties": false
3658
+ }
3659
+ ]
3660
+ },
3661
+ "label": {
3662
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
3663
+ "anyOf": [
3664
+ {
3665
+ "type": "string",
3666
+ "minLength": 1
3667
+ },
3668
+ {
3669
+ "type": "object",
3670
+ "properties": {
3671
+ "regex": {
3672
+ "type": "string",
3673
+ "minLength": 1,
3674
+ "description": "A JavaScript regular expression source, without slashes."
3675
+ },
3676
+ "flags": {
3677
+ "default": "",
3678
+ "description": "Any of i, m, s, u, each at most once.",
3679
+ "type": "string",
3680
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3681
+ }
3682
+ },
3683
+ "required": [
3684
+ "regex"
3685
+ ],
3686
+ "additionalProperties": false
3687
+ }
3688
+ ]
3689
+ },
3690
+ "testId": {
3691
+ "description": "Find by data-testid (Playwright getByTestId).",
3692
+ "type": "string",
3693
+ "minLength": 1
3694
+ },
3695
+ "css": {
3696
+ "description": "Find by CSS selector; narrow it with hasText.",
3697
+ "type": "string",
3698
+ "minLength": 1
3699
+ },
3700
+ "hasText": {
3701
+ "description": "Only elements containing this text, with css.",
3702
+ "anyOf": [
3703
+ {
3704
+ "type": "string",
3705
+ "minLength": 1
3706
+ },
3707
+ {
3708
+ "type": "object",
3709
+ "properties": {
3710
+ "regex": {
3711
+ "type": "string",
3712
+ "minLength": 1,
3713
+ "description": "A JavaScript regular expression source, without slashes."
3714
+ },
3715
+ "flags": {
3716
+ "default": "",
3717
+ "description": "Any of i, m, s, u, each at most once.",
3718
+ "type": "string",
3719
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3720
+ }
3721
+ },
3722
+ "required": [
3723
+ "regex"
3724
+ ],
3725
+ "additionalProperties": false
3726
+ }
3727
+ ]
3728
+ },
3729
+ "exact": {
3730
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
3731
+ "type": "boolean"
3732
+ },
3733
+ "nth": {
3734
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
3735
+ "type": "integer",
3736
+ "minimum": 0,
3737
+ "maximum": 9007199254740991
3738
+ }
3739
+ },
3740
+ "additionalProperties": false
3741
+ }
3742
+ },
3743
+ "required": [
3744
+ "do",
3745
+ "target"
3746
+ ],
3747
+ "additionalProperties": false
3748
+ },
3749
+ {
3750
+ "type": "object",
3751
+ "properties": {
3752
+ "do": {
3753
+ "type": "string",
3754
+ "const": "hide",
3755
+ "description": "Hides every match but the last keepLast (display: none), e.g. all but the last three columns of a horizontally scrolling chart."
3756
+ },
3757
+ "target": {
3758
+ "description": "The elements, as a locator descriptor with exactly one of role, text, label, testId, css; every match counts.",
3759
+ "type": "object",
3760
+ "properties": {
3761
+ "role": {
3762
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
3763
+ "type": "string",
3764
+ "enum": [
3765
+ "alert",
3766
+ "alertdialog",
3767
+ "application",
3768
+ "article",
3769
+ "banner",
3770
+ "blockquote",
3771
+ "button",
3772
+ "caption",
3773
+ "cell",
3774
+ "checkbox",
3775
+ "code",
3776
+ "columnheader",
3777
+ "combobox",
3778
+ "complementary",
3779
+ "contentinfo",
3780
+ "definition",
3781
+ "deletion",
3782
+ "dialog",
3783
+ "directory",
3784
+ "document",
3785
+ "emphasis",
3786
+ "feed",
3787
+ "figure",
3788
+ "form",
3789
+ "generic",
3790
+ "grid",
3791
+ "gridcell",
3792
+ "group",
3793
+ "heading",
3794
+ "img",
3795
+ "insertion",
3796
+ "link",
3797
+ "list",
3798
+ "listbox",
3799
+ "listitem",
3800
+ "log",
3801
+ "main",
3802
+ "marquee",
3803
+ "math",
3804
+ "meter",
3805
+ "menu",
3806
+ "menubar",
3807
+ "menuitem",
3808
+ "menuitemcheckbox",
3809
+ "menuitemradio",
3810
+ "navigation",
3811
+ "none",
3812
+ "note",
3813
+ "option",
3814
+ "paragraph",
3815
+ "presentation",
3816
+ "progressbar",
3817
+ "radio",
3818
+ "radiogroup",
3819
+ "region",
3820
+ "row",
3821
+ "rowgroup",
3822
+ "rowheader",
3823
+ "scrollbar",
3824
+ "search",
3825
+ "searchbox",
3826
+ "separator",
3827
+ "slider",
3828
+ "spinbutton",
3829
+ "status",
3830
+ "strong",
3831
+ "subscript",
3832
+ "superscript",
3833
+ "switch",
3834
+ "tab",
3835
+ "table",
3836
+ "tablist",
3837
+ "tabpanel",
3838
+ "term",
3839
+ "textbox",
3840
+ "time",
3841
+ "timer",
3842
+ "toolbar",
3843
+ "tooltip",
3844
+ "tree",
3845
+ "treegrid",
3846
+ "treeitem"
3847
+ ]
3848
+ },
3849
+ "name": {
3850
+ "description": "The accessible name, with role: a string or { regex, flags }.",
3851
+ "anyOf": [
3852
+ {
3853
+ "type": "string",
3854
+ "minLength": 1
3855
+ },
3856
+ {
3857
+ "type": "object",
3858
+ "properties": {
3859
+ "regex": {
3860
+ "type": "string",
3861
+ "minLength": 1,
3862
+ "description": "A JavaScript regular expression source, without slashes."
3863
+ },
3864
+ "flags": {
3865
+ "default": "",
3866
+ "description": "Any of i, m, s, u, each at most once.",
3867
+ "type": "string",
3868
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3869
+ }
3870
+ },
3871
+ "required": [
3872
+ "regex"
3873
+ ],
3874
+ "additionalProperties": false
3875
+ }
3876
+ ]
3877
+ },
3878
+ "text": {
3879
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
3880
+ "anyOf": [
3881
+ {
3882
+ "type": "string",
3883
+ "minLength": 1
3884
+ },
3885
+ {
3886
+ "type": "object",
3887
+ "properties": {
3888
+ "regex": {
3889
+ "type": "string",
3890
+ "minLength": 1,
3891
+ "description": "A JavaScript regular expression source, without slashes."
3892
+ },
3893
+ "flags": {
3894
+ "default": "",
3895
+ "description": "Any of i, m, s, u, each at most once.",
3896
+ "type": "string",
3897
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3898
+ }
3899
+ },
3900
+ "required": [
3901
+ "regex"
3902
+ ],
3903
+ "additionalProperties": false
3904
+ }
3905
+ ]
3906
+ },
3907
+ "label": {
3908
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
3909
+ "anyOf": [
3910
+ {
3911
+ "type": "string",
3912
+ "minLength": 1
3913
+ },
3914
+ {
3915
+ "type": "object",
3916
+ "properties": {
3917
+ "regex": {
3918
+ "type": "string",
3919
+ "minLength": 1,
3920
+ "description": "A JavaScript regular expression source, without slashes."
3921
+ },
3922
+ "flags": {
3923
+ "default": "",
3924
+ "description": "Any of i, m, s, u, each at most once.",
3925
+ "type": "string",
3926
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3927
+ }
3928
+ },
3929
+ "required": [
3930
+ "regex"
3931
+ ],
3932
+ "additionalProperties": false
3933
+ }
3934
+ ]
3935
+ },
3936
+ "testId": {
3937
+ "description": "Find by data-testid (Playwright getByTestId).",
3938
+ "type": "string",
3939
+ "minLength": 1
3940
+ },
3941
+ "css": {
3942
+ "description": "Find by CSS selector; narrow it with hasText.",
3943
+ "type": "string",
3944
+ "minLength": 1
3945
+ },
3946
+ "hasText": {
3947
+ "description": "Only elements containing this text, with css.",
3948
+ "anyOf": [
3949
+ {
3950
+ "type": "string",
3951
+ "minLength": 1
3952
+ },
3953
+ {
3954
+ "type": "object",
3955
+ "properties": {
3956
+ "regex": {
3957
+ "type": "string",
3958
+ "minLength": 1,
3959
+ "description": "A JavaScript regular expression source, without slashes."
3960
+ },
3961
+ "flags": {
3962
+ "default": "",
3963
+ "description": "Any of i, m, s, u, each at most once.",
3964
+ "type": "string",
3965
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
3966
+ }
3967
+ },
3968
+ "required": [
3969
+ "regex"
3970
+ ],
3971
+ "additionalProperties": false
3972
+ }
3973
+ ]
3974
+ },
3975
+ "exact": {
3976
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
3977
+ "type": "boolean"
3978
+ },
3979
+ "nth": {
3980
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
3981
+ "type": "integer",
3982
+ "minimum": 0,
3983
+ "maximum": 9007199254740991
3984
+ }
3985
+ },
3986
+ "additionalProperties": false
3987
+ },
3988
+ "keepLast": {
3989
+ "default": 0,
3990
+ "description": "How many of the last matches stay shown (0-1000, default 0); the step fails when there are not more matches than this.",
3991
+ "type": "integer",
3992
+ "minimum": 0,
3993
+ "maximum": 1000
3994
+ }
3995
+ },
3996
+ "required": [
3997
+ "do",
3998
+ "target"
3999
+ ],
4000
+ "additionalProperties": false
4001
+ }
4002
+ ]
4003
+ }
4004
+ },
4005
+ "crop": {
4006
+ "description": "Capture one element at a fixed aspect ratio (e.g. 4:3 around a chart) instead of the viewport: as wide as the element, from its top edge (or crop.top's). Not with full or scrollTo.",
4007
+ "type": "object",
4008
+ "properties": {
4009
+ "target": {
4010
+ "description": "The element framed: exactly one match (nth picks one of several).",
4011
+ "type": "object",
4012
+ "properties": {
4013
+ "role": {
4014
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
4015
+ "type": "string",
4016
+ "enum": [
4017
+ "alert",
4018
+ "alertdialog",
4019
+ "application",
4020
+ "article",
4021
+ "banner",
4022
+ "blockquote",
4023
+ "button",
4024
+ "caption",
4025
+ "cell",
4026
+ "checkbox",
4027
+ "code",
4028
+ "columnheader",
4029
+ "combobox",
4030
+ "complementary",
4031
+ "contentinfo",
4032
+ "definition",
4033
+ "deletion",
4034
+ "dialog",
4035
+ "directory",
4036
+ "document",
4037
+ "emphasis",
4038
+ "feed",
4039
+ "figure",
4040
+ "form",
4041
+ "generic",
4042
+ "grid",
4043
+ "gridcell",
4044
+ "group",
4045
+ "heading",
4046
+ "img",
4047
+ "insertion",
4048
+ "link",
4049
+ "list",
4050
+ "listbox",
4051
+ "listitem",
4052
+ "log",
4053
+ "main",
4054
+ "marquee",
4055
+ "math",
4056
+ "meter",
4057
+ "menu",
4058
+ "menubar",
4059
+ "menuitem",
4060
+ "menuitemcheckbox",
4061
+ "menuitemradio",
4062
+ "navigation",
4063
+ "none",
4064
+ "note",
4065
+ "option",
4066
+ "paragraph",
4067
+ "presentation",
4068
+ "progressbar",
4069
+ "radio",
4070
+ "radiogroup",
4071
+ "region",
4072
+ "row",
4073
+ "rowgroup",
4074
+ "rowheader",
4075
+ "scrollbar",
4076
+ "search",
4077
+ "searchbox",
4078
+ "separator",
4079
+ "slider",
4080
+ "spinbutton",
4081
+ "status",
4082
+ "strong",
4083
+ "subscript",
4084
+ "superscript",
4085
+ "switch",
4086
+ "tab",
4087
+ "table",
4088
+ "tablist",
4089
+ "tabpanel",
4090
+ "term",
4091
+ "textbox",
4092
+ "time",
4093
+ "timer",
4094
+ "toolbar",
4095
+ "tooltip",
4096
+ "tree",
4097
+ "treegrid",
4098
+ "treeitem"
4099
+ ]
4100
+ },
4101
+ "name": {
4102
+ "description": "The accessible name, with role: a string or { regex, flags }.",
4103
+ "anyOf": [
4104
+ {
4105
+ "type": "string",
4106
+ "minLength": 1
4107
+ },
4108
+ {
4109
+ "type": "object",
4110
+ "properties": {
4111
+ "regex": {
4112
+ "type": "string",
4113
+ "minLength": 1,
4114
+ "description": "A JavaScript regular expression source, without slashes."
4115
+ },
4116
+ "flags": {
4117
+ "default": "",
4118
+ "description": "Any of i, m, s, u, each at most once.",
4119
+ "type": "string",
4120
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4121
+ }
4122
+ },
4123
+ "required": [
4124
+ "regex"
4125
+ ],
4126
+ "additionalProperties": false
4127
+ }
4128
+ ]
4129
+ },
4130
+ "text": {
4131
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
4132
+ "anyOf": [
4133
+ {
4134
+ "type": "string",
4135
+ "minLength": 1
4136
+ },
4137
+ {
4138
+ "type": "object",
4139
+ "properties": {
4140
+ "regex": {
4141
+ "type": "string",
4142
+ "minLength": 1,
4143
+ "description": "A JavaScript regular expression source, without slashes."
4144
+ },
4145
+ "flags": {
4146
+ "default": "",
4147
+ "description": "Any of i, m, s, u, each at most once.",
4148
+ "type": "string",
4149
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4150
+ }
4151
+ },
4152
+ "required": [
4153
+ "regex"
4154
+ ],
4155
+ "additionalProperties": false
4156
+ }
4157
+ ]
4158
+ },
4159
+ "label": {
4160
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
4161
+ "anyOf": [
4162
+ {
4163
+ "type": "string",
4164
+ "minLength": 1
4165
+ },
4166
+ {
4167
+ "type": "object",
4168
+ "properties": {
4169
+ "regex": {
4170
+ "type": "string",
4171
+ "minLength": 1,
4172
+ "description": "A JavaScript regular expression source, without slashes."
4173
+ },
4174
+ "flags": {
4175
+ "default": "",
4176
+ "description": "Any of i, m, s, u, each at most once.",
4177
+ "type": "string",
4178
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4179
+ }
4180
+ },
4181
+ "required": [
4182
+ "regex"
4183
+ ],
4184
+ "additionalProperties": false
4185
+ }
4186
+ ]
4187
+ },
4188
+ "testId": {
4189
+ "description": "Find by data-testid (Playwright getByTestId).",
4190
+ "type": "string",
4191
+ "minLength": 1
4192
+ },
4193
+ "css": {
4194
+ "description": "Find by CSS selector; narrow it with hasText.",
4195
+ "type": "string",
4196
+ "minLength": 1
4197
+ },
4198
+ "hasText": {
4199
+ "description": "Only elements containing this text, with css.",
4200
+ "anyOf": [
4201
+ {
4202
+ "type": "string",
4203
+ "minLength": 1
4204
+ },
4205
+ {
4206
+ "type": "object",
4207
+ "properties": {
4208
+ "regex": {
4209
+ "type": "string",
4210
+ "minLength": 1,
4211
+ "description": "A JavaScript regular expression source, without slashes."
4212
+ },
4213
+ "flags": {
4214
+ "default": "",
4215
+ "description": "Any of i, m, s, u, each at most once.",
4216
+ "type": "string",
4217
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4218
+ }
4219
+ },
4220
+ "required": [
4221
+ "regex"
4222
+ ],
4223
+ "additionalProperties": false
4224
+ }
4225
+ ]
4226
+ },
4227
+ "exact": {
4228
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
4229
+ "type": "boolean"
4230
+ },
4231
+ "nth": {
4232
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
4233
+ "type": "integer",
4234
+ "minimum": 0,
4235
+ "maximum": 9007199254740991
4236
+ }
4237
+ },
4238
+ "additionalProperties": false
4239
+ },
4240
+ "top": {
4241
+ "description": "An element inside target whose top edge starts the frame instead of target's (e.g. a row of a card); exactly one match. The width stays target's.",
4242
+ "type": "object",
4243
+ "properties": {
4244
+ "role": {
4245
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
4246
+ "type": "string",
4247
+ "enum": [
4248
+ "alert",
4249
+ "alertdialog",
4250
+ "application",
4251
+ "article",
4252
+ "banner",
4253
+ "blockquote",
4254
+ "button",
4255
+ "caption",
4256
+ "cell",
4257
+ "checkbox",
4258
+ "code",
4259
+ "columnheader",
4260
+ "combobox",
4261
+ "complementary",
4262
+ "contentinfo",
4263
+ "definition",
4264
+ "deletion",
4265
+ "dialog",
4266
+ "directory",
4267
+ "document",
4268
+ "emphasis",
4269
+ "feed",
4270
+ "figure",
4271
+ "form",
4272
+ "generic",
4273
+ "grid",
4274
+ "gridcell",
4275
+ "group",
4276
+ "heading",
4277
+ "img",
4278
+ "insertion",
4279
+ "link",
4280
+ "list",
4281
+ "listbox",
4282
+ "listitem",
4283
+ "log",
4284
+ "main",
4285
+ "marquee",
4286
+ "math",
4287
+ "meter",
4288
+ "menu",
4289
+ "menubar",
4290
+ "menuitem",
4291
+ "menuitemcheckbox",
4292
+ "menuitemradio",
4293
+ "navigation",
4294
+ "none",
4295
+ "note",
4296
+ "option",
4297
+ "paragraph",
4298
+ "presentation",
4299
+ "progressbar",
4300
+ "radio",
4301
+ "radiogroup",
4302
+ "region",
4303
+ "row",
4304
+ "rowgroup",
4305
+ "rowheader",
4306
+ "scrollbar",
4307
+ "search",
4308
+ "searchbox",
4309
+ "separator",
4310
+ "slider",
4311
+ "spinbutton",
4312
+ "status",
4313
+ "strong",
4314
+ "subscript",
4315
+ "superscript",
4316
+ "switch",
4317
+ "tab",
4318
+ "table",
4319
+ "tablist",
4320
+ "tabpanel",
4321
+ "term",
4322
+ "textbox",
4323
+ "time",
4324
+ "timer",
4325
+ "toolbar",
4326
+ "tooltip",
4327
+ "tree",
4328
+ "treegrid",
4329
+ "treeitem"
4330
+ ]
4331
+ },
4332
+ "name": {
4333
+ "description": "The accessible name, with role: a string or { regex, flags }.",
4334
+ "anyOf": [
4335
+ {
4336
+ "type": "string",
4337
+ "minLength": 1
4338
+ },
4339
+ {
4340
+ "type": "object",
4341
+ "properties": {
4342
+ "regex": {
4343
+ "type": "string",
4344
+ "minLength": 1,
4345
+ "description": "A JavaScript regular expression source, without slashes."
4346
+ },
4347
+ "flags": {
4348
+ "default": "",
4349
+ "description": "Any of i, m, s, u, each at most once.",
4350
+ "type": "string",
4351
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4352
+ }
4353
+ },
4354
+ "required": [
4355
+ "regex"
4356
+ ],
4357
+ "additionalProperties": false
4358
+ }
4359
+ ]
4360
+ },
4361
+ "text": {
4362
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
4363
+ "anyOf": [
4364
+ {
4365
+ "type": "string",
4366
+ "minLength": 1
4367
+ },
4368
+ {
4369
+ "type": "object",
4370
+ "properties": {
4371
+ "regex": {
4372
+ "type": "string",
4373
+ "minLength": 1,
4374
+ "description": "A JavaScript regular expression source, without slashes."
4375
+ },
4376
+ "flags": {
4377
+ "default": "",
4378
+ "description": "Any of i, m, s, u, each at most once.",
4379
+ "type": "string",
4380
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4381
+ }
4382
+ },
4383
+ "required": [
4384
+ "regex"
4385
+ ],
4386
+ "additionalProperties": false
4387
+ }
4388
+ ]
4389
+ },
4390
+ "label": {
4391
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
4392
+ "anyOf": [
4393
+ {
4394
+ "type": "string",
4395
+ "minLength": 1
4396
+ },
4397
+ {
4398
+ "type": "object",
4399
+ "properties": {
4400
+ "regex": {
4401
+ "type": "string",
4402
+ "minLength": 1,
4403
+ "description": "A JavaScript regular expression source, without slashes."
4404
+ },
4405
+ "flags": {
4406
+ "default": "",
4407
+ "description": "Any of i, m, s, u, each at most once.",
4408
+ "type": "string",
4409
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4410
+ }
4411
+ },
4412
+ "required": [
4413
+ "regex"
4414
+ ],
4415
+ "additionalProperties": false
4416
+ }
4417
+ ]
4418
+ },
4419
+ "testId": {
4420
+ "description": "Find by data-testid (Playwright getByTestId).",
4421
+ "type": "string",
4422
+ "minLength": 1
4423
+ },
4424
+ "css": {
4425
+ "description": "Find by CSS selector; narrow it with hasText.",
4426
+ "type": "string",
4427
+ "minLength": 1
4428
+ },
4429
+ "hasText": {
4430
+ "description": "Only elements containing this text, with css.",
4431
+ "anyOf": [
4432
+ {
4433
+ "type": "string",
4434
+ "minLength": 1
4435
+ },
4436
+ {
4437
+ "type": "object",
4438
+ "properties": {
4439
+ "regex": {
4440
+ "type": "string",
4441
+ "minLength": 1,
4442
+ "description": "A JavaScript regular expression source, without slashes."
4443
+ },
4444
+ "flags": {
4445
+ "default": "",
4446
+ "description": "Any of i, m, s, u, each at most once.",
4447
+ "type": "string",
4448
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4449
+ }
4450
+ },
4451
+ "required": [
4452
+ "regex"
4453
+ ],
4454
+ "additionalProperties": false
4455
+ }
4456
+ ]
4457
+ },
4458
+ "exact": {
4459
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
4460
+ "type": "boolean"
4461
+ },
4462
+ "nth": {
4463
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
4464
+ "type": "integer",
4465
+ "minimum": 0,
4466
+ "maximum": 9007199254740991
4467
+ }
4468
+ },
4469
+ "additionalProperties": false
4470
+ },
4471
+ "aspect": {
4472
+ "description": "The frame's width to height, e.g. 4:3: as wide as the element (plus padding), from its top edge down.",
4473
+ "type": "string",
4474
+ "pattern": "^[1-9]\\d{0,3}:[1-9]\\d{0,3}$"
4475
+ },
4476
+ "padding": {
4477
+ "default": 0,
4478
+ "description": "CSS pixels of the page around the element on the left, right and top (0-200, default 0).",
4479
+ "type": "integer",
4480
+ "minimum": 0,
4481
+ "maximum": 200
4482
+ }
4483
+ },
4484
+ "required": [
4485
+ "target",
4486
+ "aspect"
4487
+ ],
4488
+ "additionalProperties": false
4489
+ },
4490
+ "hide": {
4491
+ "default": [],
4492
+ "description": "CSS selectors hidden in this entry's shots only, on top of app.hideSelectors (a print state: hint buttons, disclosure arrows); the shot is refused when one still shows an element in the frame.",
4493
+ "type": "array",
4494
+ "items": {
4495
+ "type": "string",
4496
+ "pattern": "^(?!.*\\/\\*)[^{};<>\\\\]+$"
4497
+ }
2730
4498
  }
2731
4499
  },
2732
- "required": [
2733
- "id",
2734
- "path",
2735
- "width",
2736
- "height",
2737
- "expect"
2738
- ],
2739
- "additionalProperties": false
2740
- }
4500
+ "required": [
4501
+ "id",
4502
+ "path",
4503
+ "width",
4504
+ "height",
4505
+ "expect"
4506
+ ],
4507
+ "additionalProperties": false
4508
+ }
4509
+ },
4510
+ "signIn": {
4511
+ "description": "How softure-marketing shots signs in for the screenshots with signedIn: true, and the optional command that prepares the account.",
4512
+ "type": "object",
4513
+ "properties": {
4514
+ "prepare": {
4515
+ "description": "A command (arguments, no shell, run in the folder of marketing.json once the app answers, with MARKETING_BASE_URL set) that creates and seeds the account; its last line of output is a JSON object of strings or numbers, read as {data:key}. Its output is not printed.",
4516
+ "minItems": 1,
4517
+ "type": "array",
4518
+ "items": {
4519
+ "type": "string",
4520
+ "minLength": 1
4521
+ }
4522
+ },
4523
+ "path": {
4524
+ "type": "string",
4525
+ "format": "starts_with",
4526
+ "pattern": "^\\/.*",
4527
+ "description": "The sign-in page, e.g. /login."
4528
+ },
4529
+ "steps": {
4530
+ "minItems": 1,
4531
+ "type": "array",
4532
+ "items": {
4533
+ "oneOf": [
4534
+ {
4535
+ "type": "object",
4536
+ "properties": {
4537
+ "do": {
4538
+ "type": "string",
4539
+ "const": "fill",
4540
+ "description": "Replaces the value of an input, e.g. the e-mail of the sign-in form."
4541
+ },
4542
+ "target": {
4543
+ "description": "The element, as a locator descriptor with exactly one of role, text, label, testId, css.",
4544
+ "type": "object",
4545
+ "properties": {
4546
+ "role": {
4547
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
4548
+ "type": "string",
4549
+ "enum": [
4550
+ "alert",
4551
+ "alertdialog",
4552
+ "application",
4553
+ "article",
4554
+ "banner",
4555
+ "blockquote",
4556
+ "button",
4557
+ "caption",
4558
+ "cell",
4559
+ "checkbox",
4560
+ "code",
4561
+ "columnheader",
4562
+ "combobox",
4563
+ "complementary",
4564
+ "contentinfo",
4565
+ "definition",
4566
+ "deletion",
4567
+ "dialog",
4568
+ "directory",
4569
+ "document",
4570
+ "emphasis",
4571
+ "feed",
4572
+ "figure",
4573
+ "form",
4574
+ "generic",
4575
+ "grid",
4576
+ "gridcell",
4577
+ "group",
4578
+ "heading",
4579
+ "img",
4580
+ "insertion",
4581
+ "link",
4582
+ "list",
4583
+ "listbox",
4584
+ "listitem",
4585
+ "log",
4586
+ "main",
4587
+ "marquee",
4588
+ "math",
4589
+ "meter",
4590
+ "menu",
4591
+ "menubar",
4592
+ "menuitem",
4593
+ "menuitemcheckbox",
4594
+ "menuitemradio",
4595
+ "navigation",
4596
+ "none",
4597
+ "note",
4598
+ "option",
4599
+ "paragraph",
4600
+ "presentation",
4601
+ "progressbar",
4602
+ "radio",
4603
+ "radiogroup",
4604
+ "region",
4605
+ "row",
4606
+ "rowgroup",
4607
+ "rowheader",
4608
+ "scrollbar",
4609
+ "search",
4610
+ "searchbox",
4611
+ "separator",
4612
+ "slider",
4613
+ "spinbutton",
4614
+ "status",
4615
+ "strong",
4616
+ "subscript",
4617
+ "superscript",
4618
+ "switch",
4619
+ "tab",
4620
+ "table",
4621
+ "tablist",
4622
+ "tabpanel",
4623
+ "term",
4624
+ "textbox",
4625
+ "time",
4626
+ "timer",
4627
+ "toolbar",
4628
+ "tooltip",
4629
+ "tree",
4630
+ "treegrid",
4631
+ "treeitem"
4632
+ ]
4633
+ },
4634
+ "name": {
4635
+ "description": "The accessible name, with role: a string or { regex, flags }.",
4636
+ "anyOf": [
4637
+ {
4638
+ "type": "string",
4639
+ "minLength": 1
4640
+ },
4641
+ {
4642
+ "type": "object",
4643
+ "properties": {
4644
+ "regex": {
4645
+ "type": "string",
4646
+ "minLength": 1,
4647
+ "description": "A JavaScript regular expression source, without slashes."
4648
+ },
4649
+ "flags": {
4650
+ "default": "",
4651
+ "description": "Any of i, m, s, u, each at most once.",
4652
+ "type": "string",
4653
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4654
+ }
4655
+ },
4656
+ "required": [
4657
+ "regex"
4658
+ ],
4659
+ "additionalProperties": false
4660
+ }
4661
+ ]
4662
+ },
4663
+ "text": {
4664
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
4665
+ "anyOf": [
4666
+ {
4667
+ "type": "string",
4668
+ "minLength": 1
4669
+ },
4670
+ {
4671
+ "type": "object",
4672
+ "properties": {
4673
+ "regex": {
4674
+ "type": "string",
4675
+ "minLength": 1,
4676
+ "description": "A JavaScript regular expression source, without slashes."
4677
+ },
4678
+ "flags": {
4679
+ "default": "",
4680
+ "description": "Any of i, m, s, u, each at most once.",
4681
+ "type": "string",
4682
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4683
+ }
4684
+ },
4685
+ "required": [
4686
+ "regex"
4687
+ ],
4688
+ "additionalProperties": false
4689
+ }
4690
+ ]
4691
+ },
4692
+ "label": {
4693
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
4694
+ "anyOf": [
4695
+ {
4696
+ "type": "string",
4697
+ "minLength": 1
4698
+ },
4699
+ {
4700
+ "type": "object",
4701
+ "properties": {
4702
+ "regex": {
4703
+ "type": "string",
4704
+ "minLength": 1,
4705
+ "description": "A JavaScript regular expression source, without slashes."
4706
+ },
4707
+ "flags": {
4708
+ "default": "",
4709
+ "description": "Any of i, m, s, u, each at most once.",
4710
+ "type": "string",
4711
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4712
+ }
4713
+ },
4714
+ "required": [
4715
+ "regex"
4716
+ ],
4717
+ "additionalProperties": false
4718
+ }
4719
+ ]
4720
+ },
4721
+ "testId": {
4722
+ "description": "Find by data-testid (Playwright getByTestId).",
4723
+ "type": "string",
4724
+ "minLength": 1
4725
+ },
4726
+ "css": {
4727
+ "description": "Find by CSS selector; narrow it with hasText.",
4728
+ "type": "string",
4729
+ "minLength": 1
4730
+ },
4731
+ "hasText": {
4732
+ "description": "Only elements containing this text, with css.",
4733
+ "anyOf": [
4734
+ {
4735
+ "type": "string",
4736
+ "minLength": 1
4737
+ },
4738
+ {
4739
+ "type": "object",
4740
+ "properties": {
4741
+ "regex": {
4742
+ "type": "string",
4743
+ "minLength": 1,
4744
+ "description": "A JavaScript regular expression source, without slashes."
4745
+ },
4746
+ "flags": {
4747
+ "default": "",
4748
+ "description": "Any of i, m, s, u, each at most once.",
4749
+ "type": "string",
4750
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4751
+ }
4752
+ },
4753
+ "required": [
4754
+ "regex"
4755
+ ],
4756
+ "additionalProperties": false
4757
+ }
4758
+ ]
4759
+ },
4760
+ "exact": {
4761
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
4762
+ "type": "boolean"
4763
+ },
4764
+ "nth": {
4765
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
4766
+ "type": "integer",
4767
+ "minimum": 0,
4768
+ "maximum": 9007199254740991
4769
+ }
4770
+ },
4771
+ "additionalProperties": false
4772
+ },
4773
+ "value": {
4774
+ "type": "string",
4775
+ "description": "The value; {env:NAME} and {data:key} are replaced. Never printed, so a password may go here as {env:NAME}."
4776
+ }
4777
+ },
4778
+ "required": [
4779
+ "do",
4780
+ "target",
4781
+ "value"
4782
+ ],
4783
+ "additionalProperties": false
4784
+ },
4785
+ {
4786
+ "type": "object",
4787
+ "properties": {
4788
+ "do": {
4789
+ "type": "string",
4790
+ "const": "click",
4791
+ "description": "Clicks the element, e.g. the submit button or a collapsed section's summary."
4792
+ },
4793
+ "target": {
4794
+ "description": "The element, as a locator descriptor with exactly one of role, text, label, testId, css.",
4795
+ "type": "object",
4796
+ "properties": {
4797
+ "role": {
4798
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
4799
+ "type": "string",
4800
+ "enum": [
4801
+ "alert",
4802
+ "alertdialog",
4803
+ "application",
4804
+ "article",
4805
+ "banner",
4806
+ "blockquote",
4807
+ "button",
4808
+ "caption",
4809
+ "cell",
4810
+ "checkbox",
4811
+ "code",
4812
+ "columnheader",
4813
+ "combobox",
4814
+ "complementary",
4815
+ "contentinfo",
4816
+ "definition",
4817
+ "deletion",
4818
+ "dialog",
4819
+ "directory",
4820
+ "document",
4821
+ "emphasis",
4822
+ "feed",
4823
+ "figure",
4824
+ "form",
4825
+ "generic",
4826
+ "grid",
4827
+ "gridcell",
4828
+ "group",
4829
+ "heading",
4830
+ "img",
4831
+ "insertion",
4832
+ "link",
4833
+ "list",
4834
+ "listbox",
4835
+ "listitem",
4836
+ "log",
4837
+ "main",
4838
+ "marquee",
4839
+ "math",
4840
+ "meter",
4841
+ "menu",
4842
+ "menubar",
4843
+ "menuitem",
4844
+ "menuitemcheckbox",
4845
+ "menuitemradio",
4846
+ "navigation",
4847
+ "none",
4848
+ "note",
4849
+ "option",
4850
+ "paragraph",
4851
+ "presentation",
4852
+ "progressbar",
4853
+ "radio",
4854
+ "radiogroup",
4855
+ "region",
4856
+ "row",
4857
+ "rowgroup",
4858
+ "rowheader",
4859
+ "scrollbar",
4860
+ "search",
4861
+ "searchbox",
4862
+ "separator",
4863
+ "slider",
4864
+ "spinbutton",
4865
+ "status",
4866
+ "strong",
4867
+ "subscript",
4868
+ "superscript",
4869
+ "switch",
4870
+ "tab",
4871
+ "table",
4872
+ "tablist",
4873
+ "tabpanel",
4874
+ "term",
4875
+ "textbox",
4876
+ "time",
4877
+ "timer",
4878
+ "toolbar",
4879
+ "tooltip",
4880
+ "tree",
4881
+ "treegrid",
4882
+ "treeitem"
4883
+ ]
4884
+ },
4885
+ "name": {
4886
+ "description": "The accessible name, with role: a string or { regex, flags }.",
4887
+ "anyOf": [
4888
+ {
4889
+ "type": "string",
4890
+ "minLength": 1
4891
+ },
4892
+ {
4893
+ "type": "object",
4894
+ "properties": {
4895
+ "regex": {
4896
+ "type": "string",
4897
+ "minLength": 1,
4898
+ "description": "A JavaScript regular expression source, without slashes."
4899
+ },
4900
+ "flags": {
4901
+ "default": "",
4902
+ "description": "Any of i, m, s, u, each at most once.",
4903
+ "type": "string",
4904
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4905
+ }
4906
+ },
4907
+ "required": [
4908
+ "regex"
4909
+ ],
4910
+ "additionalProperties": false
4911
+ }
4912
+ ]
4913
+ },
4914
+ "text": {
4915
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
4916
+ "anyOf": [
4917
+ {
4918
+ "type": "string",
4919
+ "minLength": 1
4920
+ },
4921
+ {
4922
+ "type": "object",
4923
+ "properties": {
4924
+ "regex": {
4925
+ "type": "string",
4926
+ "minLength": 1,
4927
+ "description": "A JavaScript regular expression source, without slashes."
4928
+ },
4929
+ "flags": {
4930
+ "default": "",
4931
+ "description": "Any of i, m, s, u, each at most once.",
4932
+ "type": "string",
4933
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4934
+ }
4935
+ },
4936
+ "required": [
4937
+ "regex"
4938
+ ],
4939
+ "additionalProperties": false
4940
+ }
4941
+ ]
4942
+ },
4943
+ "label": {
4944
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
4945
+ "anyOf": [
4946
+ {
4947
+ "type": "string",
4948
+ "minLength": 1
4949
+ },
4950
+ {
4951
+ "type": "object",
4952
+ "properties": {
4953
+ "regex": {
4954
+ "type": "string",
4955
+ "minLength": 1,
4956
+ "description": "A JavaScript regular expression source, without slashes."
4957
+ },
4958
+ "flags": {
4959
+ "default": "",
4960
+ "description": "Any of i, m, s, u, each at most once.",
4961
+ "type": "string",
4962
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
4963
+ }
4964
+ },
4965
+ "required": [
4966
+ "regex"
4967
+ ],
4968
+ "additionalProperties": false
4969
+ }
4970
+ ]
4971
+ },
4972
+ "testId": {
4973
+ "description": "Find by data-testid (Playwright getByTestId).",
4974
+ "type": "string",
4975
+ "minLength": 1
4976
+ },
4977
+ "css": {
4978
+ "description": "Find by CSS selector; narrow it with hasText.",
4979
+ "type": "string",
4980
+ "minLength": 1
4981
+ },
4982
+ "hasText": {
4983
+ "description": "Only elements containing this text, with css.",
4984
+ "anyOf": [
4985
+ {
4986
+ "type": "string",
4987
+ "minLength": 1
4988
+ },
4989
+ {
4990
+ "type": "object",
4991
+ "properties": {
4992
+ "regex": {
4993
+ "type": "string",
4994
+ "minLength": 1,
4995
+ "description": "A JavaScript regular expression source, without slashes."
4996
+ },
4997
+ "flags": {
4998
+ "default": "",
4999
+ "description": "Any of i, m, s, u, each at most once.",
5000
+ "type": "string",
5001
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5002
+ }
5003
+ },
5004
+ "required": [
5005
+ "regex"
5006
+ ],
5007
+ "additionalProperties": false
5008
+ }
5009
+ ]
5010
+ },
5011
+ "exact": {
5012
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
5013
+ "type": "boolean"
5014
+ },
5015
+ "nth": {
5016
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
5017
+ "type": "integer",
5018
+ "minimum": 0,
5019
+ "maximum": 9007199254740991
5020
+ }
5021
+ },
5022
+ "additionalProperties": false
5023
+ }
5024
+ },
5025
+ "required": [
5026
+ "do",
5027
+ "target"
5028
+ ],
5029
+ "additionalProperties": false
5030
+ },
5031
+ {
5032
+ "type": "object",
5033
+ "properties": {
5034
+ "do": {
5035
+ "type": "string",
5036
+ "const": "check",
5037
+ "description": "Ticks a checkbox or radio button, e.g. the terms of a sign-up form."
5038
+ },
5039
+ "target": {
5040
+ "description": "The element, as a locator descriptor with exactly one of role, text, label, testId, css.",
5041
+ "type": "object",
5042
+ "properties": {
5043
+ "role": {
5044
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
5045
+ "type": "string",
5046
+ "enum": [
5047
+ "alert",
5048
+ "alertdialog",
5049
+ "application",
5050
+ "article",
5051
+ "banner",
5052
+ "blockquote",
5053
+ "button",
5054
+ "caption",
5055
+ "cell",
5056
+ "checkbox",
5057
+ "code",
5058
+ "columnheader",
5059
+ "combobox",
5060
+ "complementary",
5061
+ "contentinfo",
5062
+ "definition",
5063
+ "deletion",
5064
+ "dialog",
5065
+ "directory",
5066
+ "document",
5067
+ "emphasis",
5068
+ "feed",
5069
+ "figure",
5070
+ "form",
5071
+ "generic",
5072
+ "grid",
5073
+ "gridcell",
5074
+ "group",
5075
+ "heading",
5076
+ "img",
5077
+ "insertion",
5078
+ "link",
5079
+ "list",
5080
+ "listbox",
5081
+ "listitem",
5082
+ "log",
5083
+ "main",
5084
+ "marquee",
5085
+ "math",
5086
+ "meter",
5087
+ "menu",
5088
+ "menubar",
5089
+ "menuitem",
5090
+ "menuitemcheckbox",
5091
+ "menuitemradio",
5092
+ "navigation",
5093
+ "none",
5094
+ "note",
5095
+ "option",
5096
+ "paragraph",
5097
+ "presentation",
5098
+ "progressbar",
5099
+ "radio",
5100
+ "radiogroup",
5101
+ "region",
5102
+ "row",
5103
+ "rowgroup",
5104
+ "rowheader",
5105
+ "scrollbar",
5106
+ "search",
5107
+ "searchbox",
5108
+ "separator",
5109
+ "slider",
5110
+ "spinbutton",
5111
+ "status",
5112
+ "strong",
5113
+ "subscript",
5114
+ "superscript",
5115
+ "switch",
5116
+ "tab",
5117
+ "table",
5118
+ "tablist",
5119
+ "tabpanel",
5120
+ "term",
5121
+ "textbox",
5122
+ "time",
5123
+ "timer",
5124
+ "toolbar",
5125
+ "tooltip",
5126
+ "tree",
5127
+ "treegrid",
5128
+ "treeitem"
5129
+ ]
5130
+ },
5131
+ "name": {
5132
+ "description": "The accessible name, with role: a string or { regex, flags }.",
5133
+ "anyOf": [
5134
+ {
5135
+ "type": "string",
5136
+ "minLength": 1
5137
+ },
5138
+ {
5139
+ "type": "object",
5140
+ "properties": {
5141
+ "regex": {
5142
+ "type": "string",
5143
+ "minLength": 1,
5144
+ "description": "A JavaScript regular expression source, without slashes."
5145
+ },
5146
+ "flags": {
5147
+ "default": "",
5148
+ "description": "Any of i, m, s, u, each at most once.",
5149
+ "type": "string",
5150
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5151
+ }
5152
+ },
5153
+ "required": [
5154
+ "regex"
5155
+ ],
5156
+ "additionalProperties": false
5157
+ }
5158
+ ]
5159
+ },
5160
+ "text": {
5161
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
5162
+ "anyOf": [
5163
+ {
5164
+ "type": "string",
5165
+ "minLength": 1
5166
+ },
5167
+ {
5168
+ "type": "object",
5169
+ "properties": {
5170
+ "regex": {
5171
+ "type": "string",
5172
+ "minLength": 1,
5173
+ "description": "A JavaScript regular expression source, without slashes."
5174
+ },
5175
+ "flags": {
5176
+ "default": "",
5177
+ "description": "Any of i, m, s, u, each at most once.",
5178
+ "type": "string",
5179
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5180
+ }
5181
+ },
5182
+ "required": [
5183
+ "regex"
5184
+ ],
5185
+ "additionalProperties": false
5186
+ }
5187
+ ]
5188
+ },
5189
+ "label": {
5190
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
5191
+ "anyOf": [
5192
+ {
5193
+ "type": "string",
5194
+ "minLength": 1
5195
+ },
5196
+ {
5197
+ "type": "object",
5198
+ "properties": {
5199
+ "regex": {
5200
+ "type": "string",
5201
+ "minLength": 1,
5202
+ "description": "A JavaScript regular expression source, without slashes."
5203
+ },
5204
+ "flags": {
5205
+ "default": "",
5206
+ "description": "Any of i, m, s, u, each at most once.",
5207
+ "type": "string",
5208
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5209
+ }
5210
+ },
5211
+ "required": [
5212
+ "regex"
5213
+ ],
5214
+ "additionalProperties": false
5215
+ }
5216
+ ]
5217
+ },
5218
+ "testId": {
5219
+ "description": "Find by data-testid (Playwright getByTestId).",
5220
+ "type": "string",
5221
+ "minLength": 1
5222
+ },
5223
+ "css": {
5224
+ "description": "Find by CSS selector; narrow it with hasText.",
5225
+ "type": "string",
5226
+ "minLength": 1
5227
+ },
5228
+ "hasText": {
5229
+ "description": "Only elements containing this text, with css.",
5230
+ "anyOf": [
5231
+ {
5232
+ "type": "string",
5233
+ "minLength": 1
5234
+ },
5235
+ {
5236
+ "type": "object",
5237
+ "properties": {
5238
+ "regex": {
5239
+ "type": "string",
5240
+ "minLength": 1,
5241
+ "description": "A JavaScript regular expression source, without slashes."
5242
+ },
5243
+ "flags": {
5244
+ "default": "",
5245
+ "description": "Any of i, m, s, u, each at most once.",
5246
+ "type": "string",
5247
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5248
+ }
5249
+ },
5250
+ "required": [
5251
+ "regex"
5252
+ ],
5253
+ "additionalProperties": false
5254
+ }
5255
+ ]
5256
+ },
5257
+ "exact": {
5258
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
5259
+ "type": "boolean"
5260
+ },
5261
+ "nth": {
5262
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
5263
+ "type": "integer",
5264
+ "minimum": 0,
5265
+ "maximum": 9007199254740991
5266
+ }
5267
+ },
5268
+ "additionalProperties": false
5269
+ }
5270
+ },
5271
+ "required": [
5272
+ "do",
5273
+ "target"
5274
+ ],
5275
+ "additionalProperties": false
5276
+ },
5277
+ {
5278
+ "type": "object",
5279
+ "properties": {
5280
+ "do": {
5281
+ "type": "string",
5282
+ "const": "press",
5283
+ "description": "Presses a key on the focused element, e.g. Enter."
5284
+ },
5285
+ "key": {
5286
+ "type": "string",
5287
+ "pattern": "^\\S+$",
5288
+ "description": "A Playwright key name; modifiers joined with +."
5289
+ }
5290
+ },
5291
+ "required": [
5292
+ "do",
5293
+ "key"
5294
+ ],
5295
+ "additionalProperties": false
5296
+ },
5297
+ {
5298
+ "type": "object",
5299
+ "properties": {
5300
+ "do": {
5301
+ "type": "string",
5302
+ "const": "open",
5303
+ "description": "Opens every matching <details> element (nth picks one), e.g. every disclosure of a card; fails when a match is not a <details> or does not stay open."
5304
+ },
5305
+ "target": {
5306
+ "description": "The <details> elements, as a locator descriptor with exactly one of role, text, label, testId, css; every match is opened.",
5307
+ "type": "object",
5308
+ "properties": {
5309
+ "role": {
5310
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
5311
+ "type": "string",
5312
+ "enum": [
5313
+ "alert",
5314
+ "alertdialog",
5315
+ "application",
5316
+ "article",
5317
+ "banner",
5318
+ "blockquote",
5319
+ "button",
5320
+ "caption",
5321
+ "cell",
5322
+ "checkbox",
5323
+ "code",
5324
+ "columnheader",
5325
+ "combobox",
5326
+ "complementary",
5327
+ "contentinfo",
5328
+ "definition",
5329
+ "deletion",
5330
+ "dialog",
5331
+ "directory",
5332
+ "document",
5333
+ "emphasis",
5334
+ "feed",
5335
+ "figure",
5336
+ "form",
5337
+ "generic",
5338
+ "grid",
5339
+ "gridcell",
5340
+ "group",
5341
+ "heading",
5342
+ "img",
5343
+ "insertion",
5344
+ "link",
5345
+ "list",
5346
+ "listbox",
5347
+ "listitem",
5348
+ "log",
5349
+ "main",
5350
+ "marquee",
5351
+ "math",
5352
+ "meter",
5353
+ "menu",
5354
+ "menubar",
5355
+ "menuitem",
5356
+ "menuitemcheckbox",
5357
+ "menuitemradio",
5358
+ "navigation",
5359
+ "none",
5360
+ "note",
5361
+ "option",
5362
+ "paragraph",
5363
+ "presentation",
5364
+ "progressbar",
5365
+ "radio",
5366
+ "radiogroup",
5367
+ "region",
5368
+ "row",
5369
+ "rowgroup",
5370
+ "rowheader",
5371
+ "scrollbar",
5372
+ "search",
5373
+ "searchbox",
5374
+ "separator",
5375
+ "slider",
5376
+ "spinbutton",
5377
+ "status",
5378
+ "strong",
5379
+ "subscript",
5380
+ "superscript",
5381
+ "switch",
5382
+ "tab",
5383
+ "table",
5384
+ "tablist",
5385
+ "tabpanel",
5386
+ "term",
5387
+ "textbox",
5388
+ "time",
5389
+ "timer",
5390
+ "toolbar",
5391
+ "tooltip",
5392
+ "tree",
5393
+ "treegrid",
5394
+ "treeitem"
5395
+ ]
5396
+ },
5397
+ "name": {
5398
+ "description": "The accessible name, with role: a string or { regex, flags }.",
5399
+ "anyOf": [
5400
+ {
5401
+ "type": "string",
5402
+ "minLength": 1
5403
+ },
5404
+ {
5405
+ "type": "object",
5406
+ "properties": {
5407
+ "regex": {
5408
+ "type": "string",
5409
+ "minLength": 1,
5410
+ "description": "A JavaScript regular expression source, without slashes."
5411
+ },
5412
+ "flags": {
5413
+ "default": "",
5414
+ "description": "Any of i, m, s, u, each at most once.",
5415
+ "type": "string",
5416
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5417
+ }
5418
+ },
5419
+ "required": [
5420
+ "regex"
5421
+ ],
5422
+ "additionalProperties": false
5423
+ }
5424
+ ]
5425
+ },
5426
+ "text": {
5427
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
5428
+ "anyOf": [
5429
+ {
5430
+ "type": "string",
5431
+ "minLength": 1
5432
+ },
5433
+ {
5434
+ "type": "object",
5435
+ "properties": {
5436
+ "regex": {
5437
+ "type": "string",
5438
+ "minLength": 1,
5439
+ "description": "A JavaScript regular expression source, without slashes."
5440
+ },
5441
+ "flags": {
5442
+ "default": "",
5443
+ "description": "Any of i, m, s, u, each at most once.",
5444
+ "type": "string",
5445
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5446
+ }
5447
+ },
5448
+ "required": [
5449
+ "regex"
5450
+ ],
5451
+ "additionalProperties": false
5452
+ }
5453
+ ]
5454
+ },
5455
+ "label": {
5456
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
5457
+ "anyOf": [
5458
+ {
5459
+ "type": "string",
5460
+ "minLength": 1
5461
+ },
5462
+ {
5463
+ "type": "object",
5464
+ "properties": {
5465
+ "regex": {
5466
+ "type": "string",
5467
+ "minLength": 1,
5468
+ "description": "A JavaScript regular expression source, without slashes."
5469
+ },
5470
+ "flags": {
5471
+ "default": "",
5472
+ "description": "Any of i, m, s, u, each at most once.",
5473
+ "type": "string",
5474
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5475
+ }
5476
+ },
5477
+ "required": [
5478
+ "regex"
5479
+ ],
5480
+ "additionalProperties": false
5481
+ }
5482
+ ]
5483
+ },
5484
+ "testId": {
5485
+ "description": "Find by data-testid (Playwright getByTestId).",
5486
+ "type": "string",
5487
+ "minLength": 1
5488
+ },
5489
+ "css": {
5490
+ "description": "Find by CSS selector; narrow it with hasText.",
5491
+ "type": "string",
5492
+ "minLength": 1
5493
+ },
5494
+ "hasText": {
5495
+ "description": "Only elements containing this text, with css.",
5496
+ "anyOf": [
5497
+ {
5498
+ "type": "string",
5499
+ "minLength": 1
5500
+ },
5501
+ {
5502
+ "type": "object",
5503
+ "properties": {
5504
+ "regex": {
5505
+ "type": "string",
5506
+ "minLength": 1,
5507
+ "description": "A JavaScript regular expression source, without slashes."
5508
+ },
5509
+ "flags": {
5510
+ "default": "",
5511
+ "description": "Any of i, m, s, u, each at most once.",
5512
+ "type": "string",
5513
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5514
+ }
5515
+ },
5516
+ "required": [
5517
+ "regex"
5518
+ ],
5519
+ "additionalProperties": false
5520
+ }
5521
+ ]
5522
+ },
5523
+ "exact": {
5524
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
5525
+ "type": "boolean"
5526
+ },
5527
+ "nth": {
5528
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
5529
+ "type": "integer",
5530
+ "minimum": 0,
5531
+ "maximum": 9007199254740991
5532
+ }
5533
+ },
5534
+ "additionalProperties": false
5535
+ }
5536
+ },
5537
+ "required": [
5538
+ "do",
5539
+ "target"
5540
+ ],
5541
+ "additionalProperties": false
5542
+ },
5543
+ {
5544
+ "type": "object",
5545
+ "properties": {
5546
+ "do": {
5547
+ "type": "string",
5548
+ "const": "hide",
5549
+ "description": "Hides every match but the last keepLast (display: none), e.g. all but the last three columns of a horizontally scrolling chart."
5550
+ },
5551
+ "target": {
5552
+ "description": "The elements, as a locator descriptor with exactly one of role, text, label, testId, css; every match counts.",
5553
+ "type": "object",
5554
+ "properties": {
5555
+ "role": {
5556
+ "description": "Find by ARIA role (Playwright getByRole), e.g. button; narrow it with name.",
5557
+ "type": "string",
5558
+ "enum": [
5559
+ "alert",
5560
+ "alertdialog",
5561
+ "application",
5562
+ "article",
5563
+ "banner",
5564
+ "blockquote",
5565
+ "button",
5566
+ "caption",
5567
+ "cell",
5568
+ "checkbox",
5569
+ "code",
5570
+ "columnheader",
5571
+ "combobox",
5572
+ "complementary",
5573
+ "contentinfo",
5574
+ "definition",
5575
+ "deletion",
5576
+ "dialog",
5577
+ "directory",
5578
+ "document",
5579
+ "emphasis",
5580
+ "feed",
5581
+ "figure",
5582
+ "form",
5583
+ "generic",
5584
+ "grid",
5585
+ "gridcell",
5586
+ "group",
5587
+ "heading",
5588
+ "img",
5589
+ "insertion",
5590
+ "link",
5591
+ "list",
5592
+ "listbox",
5593
+ "listitem",
5594
+ "log",
5595
+ "main",
5596
+ "marquee",
5597
+ "math",
5598
+ "meter",
5599
+ "menu",
5600
+ "menubar",
5601
+ "menuitem",
5602
+ "menuitemcheckbox",
5603
+ "menuitemradio",
5604
+ "navigation",
5605
+ "none",
5606
+ "note",
5607
+ "option",
5608
+ "paragraph",
5609
+ "presentation",
5610
+ "progressbar",
5611
+ "radio",
5612
+ "radiogroup",
5613
+ "region",
5614
+ "row",
5615
+ "rowgroup",
5616
+ "rowheader",
5617
+ "scrollbar",
5618
+ "search",
5619
+ "searchbox",
5620
+ "separator",
5621
+ "slider",
5622
+ "spinbutton",
5623
+ "status",
5624
+ "strong",
5625
+ "subscript",
5626
+ "superscript",
5627
+ "switch",
5628
+ "tab",
5629
+ "table",
5630
+ "tablist",
5631
+ "tabpanel",
5632
+ "term",
5633
+ "textbox",
5634
+ "time",
5635
+ "timer",
5636
+ "toolbar",
5637
+ "tooltip",
5638
+ "tree",
5639
+ "treegrid",
5640
+ "treeitem"
5641
+ ]
5642
+ },
5643
+ "name": {
5644
+ "description": "The accessible name, with role: a string or { regex, flags }.",
5645
+ "anyOf": [
5646
+ {
5647
+ "type": "string",
5648
+ "minLength": 1
5649
+ },
5650
+ {
5651
+ "type": "object",
5652
+ "properties": {
5653
+ "regex": {
5654
+ "type": "string",
5655
+ "minLength": 1,
5656
+ "description": "A JavaScript regular expression source, without slashes."
5657
+ },
5658
+ "flags": {
5659
+ "default": "",
5660
+ "description": "Any of i, m, s, u, each at most once.",
5661
+ "type": "string",
5662
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5663
+ }
5664
+ },
5665
+ "required": [
5666
+ "regex"
5667
+ ],
5668
+ "additionalProperties": false
5669
+ }
5670
+ ]
5671
+ },
5672
+ "text": {
5673
+ "description": "Find by visible text (Playwright getByText): a substring, or { regex, flags }.",
5674
+ "anyOf": [
5675
+ {
5676
+ "type": "string",
5677
+ "minLength": 1
5678
+ },
5679
+ {
5680
+ "type": "object",
5681
+ "properties": {
5682
+ "regex": {
5683
+ "type": "string",
5684
+ "minLength": 1,
5685
+ "description": "A JavaScript regular expression source, without slashes."
5686
+ },
5687
+ "flags": {
5688
+ "default": "",
5689
+ "description": "Any of i, m, s, u, each at most once.",
5690
+ "type": "string",
5691
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5692
+ }
5693
+ },
5694
+ "required": [
5695
+ "regex"
5696
+ ],
5697
+ "additionalProperties": false
5698
+ }
5699
+ ]
5700
+ },
5701
+ "label": {
5702
+ "description": "Find a form control by its label (Playwright getByLabel): a substring, or { regex, flags }.",
5703
+ "anyOf": [
5704
+ {
5705
+ "type": "string",
5706
+ "minLength": 1
5707
+ },
5708
+ {
5709
+ "type": "object",
5710
+ "properties": {
5711
+ "regex": {
5712
+ "type": "string",
5713
+ "minLength": 1,
5714
+ "description": "A JavaScript regular expression source, without slashes."
5715
+ },
5716
+ "flags": {
5717
+ "default": "",
5718
+ "description": "Any of i, m, s, u, each at most once.",
5719
+ "type": "string",
5720
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5721
+ }
5722
+ },
5723
+ "required": [
5724
+ "regex"
5725
+ ],
5726
+ "additionalProperties": false
5727
+ }
5728
+ ]
5729
+ },
5730
+ "testId": {
5731
+ "description": "Find by data-testid (Playwright getByTestId).",
5732
+ "type": "string",
5733
+ "minLength": 1
5734
+ },
5735
+ "css": {
5736
+ "description": "Find by CSS selector; narrow it with hasText.",
5737
+ "type": "string",
5738
+ "minLength": 1
5739
+ },
5740
+ "hasText": {
5741
+ "description": "Only elements containing this text, with css.",
5742
+ "anyOf": [
5743
+ {
5744
+ "type": "string",
5745
+ "minLength": 1
5746
+ },
5747
+ {
5748
+ "type": "object",
5749
+ "properties": {
5750
+ "regex": {
5751
+ "type": "string",
5752
+ "minLength": 1,
5753
+ "description": "A JavaScript regular expression source, without slashes."
5754
+ },
5755
+ "flags": {
5756
+ "default": "",
5757
+ "description": "Any of i, m, s, u, each at most once.",
5758
+ "type": "string",
5759
+ "pattern": "^(?!.*(.).*\\1)[imsu]*$"
5760
+ }
5761
+ },
5762
+ "required": [
5763
+ "regex"
5764
+ ],
5765
+ "additionalProperties": false
5766
+ }
5767
+ ]
5768
+ },
5769
+ "exact": {
5770
+ "description": "Whole and case-sensitive match of a string name, text or label (default false).",
5771
+ "type": "boolean"
5772
+ },
5773
+ "nth": {
5774
+ "description": "The n-th match (0 = the first); without it, a locator that matches several elements fails.",
5775
+ "type": "integer",
5776
+ "minimum": 0,
5777
+ "maximum": 9007199254740991
5778
+ }
5779
+ },
5780
+ "additionalProperties": false
5781
+ },
5782
+ "keepLast": {
5783
+ "default": 0,
5784
+ "description": "How many of the last matches stay shown (0-1000, default 0); the step fails when there are not more matches than this.",
5785
+ "type": "integer",
5786
+ "minimum": 0,
5787
+ "maximum": 1000
5788
+ }
5789
+ },
5790
+ "required": [
5791
+ "do",
5792
+ "target"
5793
+ ],
5794
+ "additionalProperties": false
5795
+ }
5796
+ ]
5797
+ },
5798
+ "description": "What signs in on that page: fill the e-mail and password ({env:NAME} or {data:key}), click the button."
5799
+ },
5800
+ "expect": {
5801
+ "type": "string",
5802
+ "description": "A phrase only a signed-in page shows, within 15 s of the last step; without it the sign-in fails and so does every signedIn screenshot."
5803
+ }
5804
+ },
5805
+ "required": [
5806
+ "path",
5807
+ "steps",
5808
+ "expect"
5809
+ ],
5810
+ "additionalProperties": false
2741
5811
  },
2742
5812
  "ogImages": {
2743
5813
  "description": "Open Graph images rendered by softure-marketing og.",