doc-detective 4.29.0 → 4.30.0

package/dist/index.cjs

@@ -9324,7 +9324,7 @@ var init_schemas = __esm({
                                                             },
                                                             elementText: {
                                                               type: "string",
-                                                              description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                              description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                             },
                                                             selector: {
                                                               type: "string",
@@ -13470,7 +13470,7 @@ var init_schemas = __esm({
                                                               },
                                                               elementText: {
                                                                 type: "string",
-                                                                description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                                description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                               },
                                                               selector: {
                                                                 type: "string",
@@ -18701,7 +18701,7 @@ var init_schemas = __esm({
                                                                         },
                                                                         elementText: {
                                                                           type: "string",
-                                                                          description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                          description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                         },
                                                                         elementId: {
                                                                           type: "string",
@@ -19233,7 +19233,7 @@ var init_schemas = __esm({
                                                                           },
                                                                           elementText: {
                                                                             type: "string",
-                                                                            description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                            description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                           },
                                                                           elementId: {
                                                                             type: "string",
@@ -54963,7 +54963,7 @@ var init_schemas = __esm({
                                               },
                                               elementText: {
                                                 type: "string",
-                                                description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                               },
                                               selector: {
                                                 type: "string",
@@ -59109,7 +59109,7 @@ var init_schemas = __esm({
                                                 },
                                                 elementText: {
                                                   type: "string",
-                                                  description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                  description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                 },
                                                 selector: {
                                                   type: "string",
@@ -64340,7 +64340,7 @@ var init_schemas = __esm({
                                                           },
                                                           elementText: {
                                                             type: "string",
-                                                            description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                            description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                           },
                                                           elementId: {
                                                             type: "string",
@@ -64872,7 +64872,7 @@ var init_schemas = __esm({
                                                             },
                                                             elementText: {
                                                               type: "string",
-                                                              description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                              description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                             },
                                                             elementId: {
                                                               type: "string",
@@ -95536,7 +95536,7 @@ var init_schemas = __esm({
               },
               elementText: {
                 type: "string",
-                description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
               },
               selector: {
                 type: "string",
@@ -99682,7 +99682,7 @@ var init_schemas = __esm({
                 },
                 elementText: {
                   type: "string",
-                  description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                  description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                 },
                 selector: {
                   type: "string",
@@ -103964,7 +103964,7 @@ var init_schemas = __esm({
                           },
                           elementText: {
                             type: "string",
-                            description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                            description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                           },
                           elementId: {
                             type: "string",
@@ -104496,7 +104496,7 @@ var init_schemas = __esm({
                             },
                             elementText: {
                               type: "string",
-                              description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                              description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                             },
                             elementId: {
                               type: "string",
@@ -113889,7 +113889,7 @@ var init_schemas = __esm({
                                                                 },
                                                                 elementText: {
                                                                   type: "string",
-                                                                  description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                                  description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                                 },
                                                                 selector: {
                                                                   type: "string",
@@ -118035,7 +118035,7 @@ var init_schemas = __esm({
                                                                   },
                                                                   elementText: {
                                                                     type: "string",
-                                                                    description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                                    description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                                   },
                                                                   selector: {
                                                                     type: "string",
@@ -123266,7 +123266,7 @@ var init_schemas = __esm({
                                                                             },
                                                                             elementText: {
                                                                               type: "string",
-                                                                              description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                              description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                             },
                                                                             elementId: {
                                                                               type: "string",
@@ -123798,7 +123798,7 @@ var init_schemas = __esm({
                                                                               },
                                                                               elementText: {
                                                                                 type: "string",
-                                                                                description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                                description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                               },
                                                                               elementId: {
                                                                                 type: "string",
@@ -159528,7 +159528,7 @@ var init_schemas = __esm({
                                                   },
                                                   elementText: {
                                                     type: "string",
-                                                    description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                    description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                   },
                                                   selector: {
                                                     type: "string",
@@ -163674,7 +163674,7 @@ var init_schemas = __esm({
                                                     },
                                                     elementText: {
                                                       type: "string",
-                                                      description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                      description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                     },
                                                     selector: {
                                                       type: "string",
@@ -168905,7 +168905,7 @@ var init_schemas = __esm({
                                                               },
                                                               elementText: {
                                                                 type: "string",
-                                                                description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                               },
                                                               elementId: {
                                                                 type: "string",
@@ -169437,7 +169437,7 @@ var init_schemas = __esm({
                                                                 },
                                                                 elementText: {
                                                                   type: "string",
-                                                                  description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                  description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                 },
                                                                 elementId: {
                                                                   type: "string",
@@ -206906,7 +206906,7 @@ var init_schemas = __esm({
                                                     },
                                                     elementText: {
                                                       type: "string",
-                                                      description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                      description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                     },
                                                     selector: {
                                                       type: "string",
@@ -211052,7 +211052,7 @@ var init_schemas = __esm({
                                                       },
                                                       elementText: {
                                                         type: "string",
-                                                        description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                        description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                       },
                                                       selector: {
                                                         type: "string",
@@ -216283,7 +216283,7 @@ var init_schemas = __esm({
                                                                 },
                                                                 elementText: {
                                                                   type: "string",
-                                                                  description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                  description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                 },
                                                                 elementId: {
                                                                   type: "string",
@@ -216815,7 +216815,7 @@ var init_schemas = __esm({
                                                                   },
                                                                   elementText: {
                                                                     type: "string",
-                                                                    description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                    description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                   },
                                                                   elementId: {
                                                                     type: "string",
@@ -251807,7 +251807,7 @@ var init_schemas = __esm({
                                                           },
                                                           elementText: {
                                                             type: "string",
-                                                            description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                            description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                           },
                                                           selector: {
                                                             type: "string",
@@ -255953,7 +255953,7 @@ var init_schemas = __esm({
                                                             },
                                                             elementText: {
                                                               type: "string",
-                                                              description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                              description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                             },
                                                             selector: {
                                                               type: "string",
@@ -261184,7 +261184,7 @@ var init_schemas = __esm({
                                                                       },
                                                                       elementText: {
                                                                         type: "string",
-                                                                        description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                        description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                       },
                                                                       elementId: {
                                                                         type: "string",
@@ -261716,7 +261716,7 @@ var init_schemas = __esm({
                                                                         },
                                                                         elementText: {
                                                                           type: "string",
-                                                                          description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                          description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                         },
                                                                         elementId: {
                                                                           type: "string",
@@ -299669,7 +299669,7 @@ var init_schemas = __esm({
                                                     },
                                                     elementText: {
                                                       type: "string",
-                                                      description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                      description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                     },
                                                     selector: {
                                                       type: "string",
@@ -303815,7 +303815,7 @@ var init_schemas = __esm({
                                                       },
                                                       elementText: {
                                                         type: "string",
-                                                        description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                        description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                       },
                                                       selector: {
                                                         type: "string",
@@ -309046,7 +309046,7 @@ var init_schemas = __esm({
                                                                 },
                                                                 elementText: {
                                                                   type: "string",
-                                                                  description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                  description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                 },
                                                                 elementId: {
                                                                   type: "string",
@@ -309578,7 +309578,7 @@ var init_schemas = __esm({
                                                                   },
                                                                   elementText: {
                                                                     type: "string",
-                                                                    description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                    description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                   },
                                                                   elementId: {
                                                                     type: "string",
@@ -344570,7 +344570,7 @@ var init_schemas = __esm({
                                                           },
                                                           elementText: {
                                                             type: "string",
-                                                            description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                            description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                           },
                                                           selector: {
                                                             type: "string",
@@ -348716,7 +348716,7 @@ var init_schemas = __esm({
                                                             },
                                                             elementText: {
                                                               type: "string",
-                                                              description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                              description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                             },
                                                             selector: {
                                                               type: "string",
@@ -353947,7 +353947,7 @@ var init_schemas = __esm({
                                                                       },
                                                                       elementText: {
                                                                         type: "string",
-                                                                        description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                        description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                       },
                                                                       elementId: {
                                                                         type: "string",
@@ -354479,7 +354479,7 @@ var init_schemas = __esm({
                                                                         },
                                                                         elementText: {
                                                                           type: "string",
-                                                                          description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                          description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                                         },
                                                                         elementId: {
                                                                           type: "string",
@@ -395756,7 +395756,7 @@ var init_schemas = __esm({
                                           },
                                           elementText: {
                                             type: "string",
-                                            description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                            description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                           },
                                           selector: {
                                             type: "string",
@@ -399902,7 +399902,7 @@ var init_schemas = __esm({
                                             },
                                             elementText: {
                                               type: "string",
-                                              description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                              description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                             },
                                             selector: {
                                               type: "string",
@@ -405133,7 +405133,7 @@ var init_schemas = __esm({
                                                       },
                                                       elementText: {
                                                         type: "string",
-                                                        description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                        description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                       },
                                                       elementId: {
                                                         type: "string",
@@ -405665,7 +405665,7 @@ var init_schemas = __esm({
                                                         },
                                                         elementText: {
                                                           type: "string",
-                                                          description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                          description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                         },
                                                         elementId: {
                                                           type: "string",
@@ -440657,7 +440657,7 @@ var init_schemas = __esm({
                                                 },
                                                 elementText: {
                                                   type: "string",
-                                                  description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                  description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                 },
                                                 selector: {
                                                   type: "string",
@@ -444803,7 +444803,7 @@ var init_schemas = __esm({
                                                   },
                                                   elementText: {
                                                     type: "string",
-                                                    description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                                    description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                                   },
                                                   selector: {
                                                     type: "string",
@@ -450034,7 +450034,7 @@ var init_schemas = __esm({
                                                             },
                                                             elementText: {
                                                               type: "string",
-                                                              description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                              description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                             },
                                                             elementId: {
                                                               type: "string",
@@ -450566,7 +450566,7 @@ var init_schemas = __esm({
                                                               },
                                                               elementText: {
                                                                 type: "string",
-                                                                description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                                description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                               },
                                                               elementId: {
                                                                 type: "string",
@@ -487250,7 +487250,7 @@ var init_schemas = __esm({
                           },
                           elementText: {
                             type: "string",
-                            description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                            description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                           },
                           selector: {
                             type: "string",
@@ -491396,7 +491396,7 @@ var init_schemas = __esm({
                             },
                             elementText: {
                               type: "string",
-                              description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                              description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                             },
                             selector: {
                               type: "string",
@@ -496627,7 +496627,7 @@ var init_schemas = __esm({
                                       },
                                       elementText: {
                                         type: "string",
-                                        description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                        description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                       },
                                       elementId: {
                                         type: "string",
@@ -497159,7 +497159,7 @@ var init_schemas = __esm({
                                         },
                                         elementText: {
                                           type: "string",
-                                          description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                          description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                         },
                                         elementId: {
                                           type: "string",
@@ -535496,7 +535496,7 @@ var init_schemas = __esm({
                                 },
                                 elementText: {
                                   type: "string",
-                                  description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                  description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                 },
                                 selector: {
                                   type: "string",
@@ -539642,7 +539642,7 @@ var init_schemas = __esm({
                                   },
                                   elementText: {
                                     type: "string",
-                                    description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                    description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                   },
                                   selector: {
                                     type: "string",
@@ -544873,7 +544873,7 @@ var init_schemas = __esm({
                                             },
                                             elementText: {
                                               type: "string",
-                                              description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                              description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                             },
                                             elementId: {
                                               type: "string",
@@ -545405,7 +545405,7 @@ var init_schemas = __esm({
                                               },
                                               elementText: {
                                                 type: "string",
-                                                description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                               },
                                               elementId: {
                                                 type: "string",
@@ -580397,7 +580397,7 @@ var init_schemas = __esm({
                                       },
                                       elementText: {
                                         type: "string",
-                                        description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                        description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                       },
                                       selector: {
                                         type: "string",
@@ -584543,7 +584543,7 @@ var init_schemas = __esm({
                                         },
                                         elementText: {
                                           type: "string",
-                                          description: "Display text of the element to find. If combined with other element finding fields, the element must match all specified criteria."
+                                          description: "Display text of the element to find. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed to single spaces), so text a framework splits across several nodes still matches and a driver's surrounding whitespace doesn't cause a miss. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text. If combined with other element finding fields, the element must match all specified criteria."
                                         },
                                         selector: {
                                           type: "string",
@@ -589774,7 +589774,7 @@ var init_schemas = __esm({
                                                   },
                                                   elementText: {
                                                     type: "string",
-                                                    description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                    description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                   },
                                                   elementId: {
                                                     type: "string",
@@ -590306,7 +590306,7 @@ var init_schemas = __esm({
                                                     },
                                                     elementText: {
                                                       type: "string",
-                                                      description: "Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax."
+                                                      description: "Display text of the element to wait for. Matched against the element's full visible text with whitespace normalized (leading/trailing trimmed, internal runs collapsed), so framework-fragmented text still matches. Wrap the value in slashes (`/pattern/`) to match a substring by regular expression instead of the whole normalized text."
                                                     },
                                                     elementId: {
                                                       type: "string",
@@ -631868,10 +631868,16 @@ function getRandomUUID() {
     return v.toString(16);
   });
 }
+function cloneForValidation(object) {
+  return JSON.parse(JSON.stringify(object));
+}
+function snapshotErrors(errors) {
+  return errors.map((error) => ({ ...error }));
+}
 function escapeRegExp(string) {
   return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function validate({ schemaKey, object, addDefaults = true }) {
+function validate({ schemaKey, object, addDefaults = true, structuredErrors = false }) {
   if (!schemaKey) {
     throw new Error("Schema key is required.");
   }
@@ -631883,6 +631889,9 @@ function validate({ schemaKey, object, addDefaults = true }) {
     errors: "",
     object
   };
+  if (structuredErrors) {
+    result.errorObjects = [];
+  }
   let validationObject;
   let check = ajv.getSchema(schemaKey);
   if (!check) {
@@ -631891,29 +631900,43 @@ function validate({ schemaKey, object, addDefaults = true }) {
     result.object = object;
     return result;
   }
-  validationObject = JSON.parse(JSON.stringify(object));
+  validationObject = cloneForValidation(object);
   result.valid = check(validationObject);
   result.errors = "";
   if (check.errors) {
+    const targetErrors = check.errors;
     const compatibleSchemasList = compatibleSchemas[schemaKey];
     if (!compatibleSchemasList) {
-      result.errors = check.errors.map((error) => `${error.instancePath} ${error.message} (${JSON.stringify(error.params)})`).join(", ");
+      result.errors = targetErrors.map((error) => `${error.instancePath} ${error.message} (${JSON.stringify(error.params)})`).join(", ");
+      if (structuredErrors) {
+        result.errorObjects = snapshotErrors(targetErrors);
+      }
       result.object = object;
       result.valid = false;
       return result;
     }
-    const matchedSchemaKey = compatibleSchemasList.find((key) => {
-      validationObject = JSON.parse(JSON.stringify(object));
-      const check2 = ajv.getSchema(key);
-      if (check2 && check2(validationObject))
-        return key;
+    let matchedSchemaKey = compatibleSchemasList.find((key) => {
+      const probe = ajvCheck.getSchema(key);
+      return probe(object);
     });
     if (!matchedSchemaKey) {
-      result.errors = check.errors.map((error) => `${error.instancePath} ${error.message} (${JSON.stringify(error.params)})`).join(", ");
+      matchedSchemaKey = compatibleSchemasList.find((key) => {
+        const mutatingCheck = ajv.getSchema(key);
+        return mutatingCheck(cloneForValidation(object));
+      });
+    }
+    if (!matchedSchemaKey) {
+      result.errors = targetErrors.map((error) => `${error.instancePath} ${error.message} (${JSON.stringify(error.params)})`).join(", ");
+      if (structuredErrors) {
+        result.errorObjects = snapshotErrors(targetErrors);
+      }
       result.object = object;
       result.valid = false;
       return result;
     } else {
+      validationObject = cloneForValidation(object);
+      const matchedCheck = ajv.getSchema(matchedSchemaKey);
+      matchedCheck(validationObject);
       const transformedObject = transformToSchemaKey({
         currentSchema: matchedSchemaKey,
         targetSchema: schemaKey,
@@ -632270,7 +632293,7 @@ Errors: ${result.errors}`);
   }
   return null;
 }
-var import_ajv, import_ajv_formats, import_ajv_keywords, import_ajv_errors, import_dynamicDefaults, ajv, compatibleSchemas;
+var import_ajv, import_ajv_formats, import_ajv_keywords, import_ajv_errors, import_dynamicDefaults, ajv, ajvCheck, compatibleSchemas;
 var init_validate = __esm({
   "dist/common/src/validate.js"() {
     "use strict";
@@ -632287,12 +632310,23 @@ var init_validate = __esm({
       allowUnionTypes: true,
       coerceTypes: true
     });
+    ajvCheck = new import_ajv.default({
+      strictSchema: false,
+      useDefaults: false,
+      allErrors: true,
+      allowUnionTypes: true,
+      coerceTypes: false
+    });
     import_dynamicDefaults.default.DEFAULTS.uuid = (_args) => getRandomUUID;
     (0, import_ajv_formats.default)(ajv);
     (0, import_ajv_keywords.default)(ajv);
     (0, import_ajv_errors.default)(ajv);
+    (0, import_ajv_formats.default)(ajvCheck);
+    (0, import_ajv_keywords.default)(ajvCheck);
+    (0, import_ajv_errors.default)(ajvCheck);
     for (const [key, value] of Object.entries(schemas)) {
       ajv.addSchema(value, key);
+      ajvCheck.addSchema(value, key);
     }
     compatibleSchemas = {
       config_v3: ["config_v2"],
@@ -633722,8 +633756,8 @@ function waitForStdio(bg, expected, { deadline }) {
       return Promise.reject(new Error(`waitUntil.stdio: invalid regular expression ${expected}: ${error.message}`));
     }
   }
-  const matchesText = (text) => regex ? regex.test(text) : text.includes(expected);
-  const matched = () => matchesText(bg.getStdout()) || matchesText(bg.getStderr());
+  const matchesText2 = (text) => regex ? regex.test(text) : text.includes(expected);
+  const matched = () => matchesText2(bg.getStdout()) || matchesText2(bg.getStderr());
   return new Promise((resolve, reject) => {
     if (matched())
       return resolve();
@@ -634062,13 +634096,14 @@ async function loadEnvs(envsFile) {
   }
 }
 function logLevelEnabled(config, level) {
-  if (config.logLevel === "error" && level === "error")
+  const currentLevel = config.logLevel || "info";
+  if (currentLevel === "error" && level === "error")
     return true;
-  if (config.logLevel === "warning" && (level === "error" || level === "warning"))
+  if (currentLevel === "warning" && (level === "error" || level === "warning"))
     return true;
-  if (config.logLevel === "info" && (level === "error" || level === "warning" || level === "info"))
+  if (currentLevel === "info" && (level === "error" || level === "warning" || level === "info"))
     return true;
-  if (config.logLevel === "debug" && (level === "error" || level === "warning" || level === "info" || level === "debug"))
+  if (currentLevel === "debug" && (level === "error" || level === "warning" || level === "info" || level === "debug"))
     return true;
   return false;
 }
@@ -635100,12 +635135,19 @@ var init_files = __esm({
 });
 
 // dist/core/openapi.js
+function getGenerator() {
+  if (!jsfPromise) {
+    jsfPromise = import("json-schema-faker").then(({ createGenerator }) => createGenerator({ optionalsProbability: 0 }));
+  }
+  return jsfPromise;
+}
 async function loadDescription(descriptionPath = "") {
   if (!descriptionPath) {
     throw new Error("Description is required.");
   }
   const definition = await readFile({ fileURLOrPath: descriptionPath });
-  const dereferencedDefinition = await import_json_schema_ref_parser.default.dereference(definition);
+  const parser = (await import("@apidevtools/json-schema-ref-parser")).default;
+  const dereferencedDefinition = await parser.dereference(definition);
   return dereferencedDefinition;
 }
 async function getOperation(definition = {}, operationId = "", responseCode = "", exampleKey = "", server = "") {
@@ -635229,7 +635271,8 @@ async function getExample(definition = {}, exampleKey = "", generateFromSchema =
   }
   if (generateFromSchema && definition.type) {
     try {
-      example = await jsf.generate(definition);
+      const generator = await getGenerator();
+      example = await generator.generate(definition);
       if (example)
         return example;
     } catch (error) {
@@ -635304,15 +635347,12 @@ function checkForExamples(definition = {}, exampleKey = "") {
     return true;
   return false;
 }
-var import_json_schema_faker, import_json_schema_ref_parser, jsf;
+var jsfPromise;
 var init_openapi = __esm({
   "dist/core/openapi.js"() {
     "use strict";
     init_utils();
-    import_json_schema_faker = require("json-schema-faker");
     init_files();
-    import_json_schema_ref_parser = __toESM(require("@apidevtools/json-schema-ref-parser"), 1);
-    jsf = (0, import_json_schema_faker.createGenerator)({ optionalsProbability: 0 });
   }
 });
 
@@ -635320,9 +635360,11 @@ var init_openapi = __esm({
 var config_exports = {};
 __export(config_exports, {
   clearAppCache: () => clearAppCache,
+  detectInstalledBrowserDrivers: () => detectInstalledBrowserDrivers,
   getAvailableApps: () => getAvailableApps,
   getBrowserDiagnostics: () => getBrowserDiagnostics,
   getEnvironment: () => getEnvironment,
+  patchAppCache: () => patchAppCache,
   resolveConcurrentRunners: () => resolveConcurrentRunners,
   setConfig: () => setConfig,
   verifyAppDrivers: () => verifyAppDrivers
@@ -635533,13 +635575,62 @@ function clearAppCache(config) {
   }
   cachedAppsByDir.delete(cacheKeyFor(config));
 }
+async function patchAppCache(config, installed, deps = {}) {
+  const key = cacheKeyFor(config);
+  try {
+    const verify = deps.verify ?? verifyDriverBinary;
+    const drivers = (deps.detectDrivers ?? detectInstalledBrowserDrivers)(config);
+    const descriptors = [];
+    for (const b of installed ?? []) {
+      if (b.name === "chrome" && b.path && b.driverPath && drivers.chromium) {
+        descriptors.push({
+          app: {
+            name: "chrome",
+            version: b.version,
+            path: b.path,
+            driver: b.driverPath
+          },
+          driverName: "chromedriver",
+          driverPath: b.driverPath
+        });
+      } else if (b.name === "firefox" && b.path && drivers.gecko) {
+        descriptors.push({
+          app: { name: "firefox", version: b.version, path: b.path },
+          driverName: b.driverPath ? "geckodriver" : void 0,
+          driverPath: b.driverPath
+        });
+      }
+    }
+    if (descriptors.length === 0) {
+      cachedAppsByDir.delete(key);
+      return;
+    }
+    const verifiedApps = await verifyAppDrivers(descriptors, {
+      verify: (driverName, driverPath) => verify(driverName, driverPath),
+      logger: (msg, level) => log(config, level ?? "warning", msg)
+    });
+    const existing = cachedAppsByDir.get(key) ?? [];
+    const existingNames = new Set(existing.map((a) => a?.name));
+    const additions = verifiedApps.filter((a) => !existingNames.has(a?.name));
+    cachedAppsByDir.set(key, [...existing, ...additions]);
+  } catch {
+    cachedAppsByDir.delete(key);
+  }
+}
+function detectInstalledBrowserDrivers(config, isInstalled = (name) => Boolean(resolveHeavyDepPath(name, { cacheDir: config?.cacheDir }))) {
+  return {
+    chromium: isInstalled("appium-chromium-driver"),
+    gecko: isInstalled("appium-geckodriver"),
+    safari: isInstalled("appium-safari-driver")
+  };
+}
 async function probeBrowserEnvironment({ config, browsersDir }) {
   setAppiumHome({ cacheDir: config?.cacheDir });
   const cwd = process.cwd();
   process.chdir(import_node_path9.default.join(__dirname4, "../.."));
   let installedBrowsers = [];
   let browserDetectionFailed = false;
-  let appiumDriverOutput = "";
+  let installedDrivers = { chromium: false, gecko: false, safari: false };
   try {
     const browsersInstalled = resolveHeavyDepPath("@puppeteer/browsers", {
       cacheDir: config?.cacheDir
@@ -635559,47 +635650,11 @@ async function probeBrowserEnvironment({ config, browsersDir }) {
         installedBrowsers = [];
       }
     }
-    const appiumEntry = resolveHeavyDepPath("appium", {
-      cacheDir: config?.cacheDir
-    });
-    const installedAppiumDrivers = await new Promise((resolve) => {
-      if (!appiumEntry) {
-        resolve({
-          stdout: "",
-          stderr: "appium is not installed; driver list unavailable",
-          exitCode: 1
-        });
-        return;
-      }
-      const child = (0, import_node_child_process6.spawn)(process.execPath, [appiumEntry, "driver", "list"], { env: process.env });
-      let stdout = "";
-      let stderr = "";
-      child.stdout?.on("data", (c) => {
-        stdout += typeof c === "string" ? c : c.toString("utf8");
-      });
-      child.stderr?.on("data", (c) => {
-        stderr += typeof c === "string" ? c : c.toString("utf8");
-      });
-      child.on("error", (err) => {
-        resolve({
-          stdout: stdout.replace(/\n$/, ""),
-          stderr: (stderr + String(err)).replace(/\n$/, ""),
-          exitCode: 1
-        });
-      });
-      child.on("close", (code) => {
-        resolve({
-          stdout: stdout.replace(/\n$/, ""),
-          stderr: stderr.replace(/\n$/, ""),
-          exitCode: code ?? 1
-        });
-      });
-    });
-    appiumDriverOutput = installedAppiumDrivers.stdout + "\n" + installedAppiumDrivers.stderr;
+    installedDrivers = detectInstalledBrowserDrivers(config);
   } finally {
     process.chdir(cwd);
   }
-  return { installedBrowsers, appiumDriverOutput, browserDetectionFailed };
+  return { installedBrowsers, installedDrivers, browserDetectionFailed };
 }
 async function getAvailableApps({ config }) {
   const browsersDir = getBrowsersDir({ cacheDir: config?.cacheDir });
@@ -635607,12 +635662,12 @@ async function getAvailableApps({ config }) {
   const hit = cachedAppsByDir.get(key);
   if (hit)
     return hit;
-  const { installedBrowsers, appiumDriverOutput, browserDetectionFailed } = await probeBrowserEnvironment({ config, browsersDir });
+  const { installedBrowsers, installedDrivers, browserDetectionFailed } = await probeBrowserEnvironment({ config, browsersDir });
   const descriptors = [];
   const chrome = installedBrowsers.find((browser) => browser.browser === "chrome");
   const chromeVersion = chrome?.buildId;
   const chromedriver = installedBrowsers.find((browser) => browser.browser === "chromedriver");
-  const appiumChromium = appiumDriverOutput.match(/\n.*chromium.*installed \(npm\).*\n/);
+  const appiumChromium = installedDrivers.chromium;
   if (chrome && chromedriver && appiumChromium) {
     descriptors.push({
       app: {
@@ -635626,7 +635681,7 @@ async function getAvailableApps({ config }) {
     });
   }
   const firefox = installedBrowsers.find((browser) => browser.browser === "firefox");
-  const appiumFirefox = appiumDriverOutput.match(/\n.*gecko.*installed \(npm\).*\n/);
+  const appiumFirefox = installedDrivers.gecko;
   if (firefox && appiumFirefox) {
     const geckodriverPath = resolveGeckodriverBinaryPath(config, browsersDir);
     descriptors.push({
@@ -635642,7 +635697,7 @@ async function getAvailableApps({ config }) {
   const currentPlatform = config?.environment?.platform ?? getEnvironment().platform;
   if (currentPlatform === "mac") {
     const safariVersion = await spawnCommand("defaults read /Applications/Safari.app/Contents/Info.plist CFBundleShortVersionString");
-    const appiumSafari = appiumDriverOutput.match(/\n.*safari.*installed \(npm\).*\n/);
+    const appiumSafari = installedDrivers.safari;
     if (safariVersion.exitCode === 0 && appiumSafari) {
       descriptors.push({
         app: { name: "safari", version: safariVersion.stdout.trim(), path: "" },
@@ -638294,6 +638349,7 @@ async function loadHerettoContent(herettoConfig, log3, config, deps) {
 }
 
 // dist/core/detectTests.js
+var DETECTION_PARSE_CONCURRENCY = 8;
 async function detectTests2({ config }) {
   const files = await qualifyFiles({ config });
   log(config, "debug", `FILES:`);
@@ -638325,7 +638381,20 @@ async function isValidSourceFile({ config, files, source, allowedExtensions }) {
   if (files.indexOf(source) >= 0)
     return false;
   if (import_node_path11.default.extname(source) === ".json" || import_node_path11.default.extname(source) === ".yaml" || import_node_path11.default.extname(source) === ".yml") {
-    const content = await readFile({ fileURLOrPath: source });
+    const ext = import_node_path11.default.extname(source).slice(1).toLowerCase();
+    let rawContent;
+    try {
+      rawContent = await import_node_fs13.default.promises.readFile(source, "utf8");
+    } catch {
+      log(config, "debug", `${source} couldn't be read. Skipping.`);
+      return false;
+    }
+    let content;
+    try {
+      content = ext === "json" ? JSON.parse(rawContent) : import_yaml3.default.parse(rawContent);
+    } catch {
+      content = rawContent;
+    }
     if (typeof content !== "object") {
       log(config, "debug", `${source} isn't a valid test specification. Skipping.`);
       return false;
@@ -638366,6 +638435,7 @@ async function isValidSourceFile({ config, files, source, allowedExtensions }) {
         }
       }
     }
+    config._parsedFileCache?.set(source, { rawContent, content });
   }
   const extension = import_node_path11.default.extname(source).substring(1);
   if (!allowed.has(extension)) {
@@ -638408,6 +638478,8 @@ async function qualifyFiles({ config }) {
   let sequence = [];
   const phaseByFile = /* @__PURE__ */ new Map();
   config._phaseByFile = phaseByFile;
+  const parsedFileCache = /* @__PURE__ */ new Map();
+  config._parsedFileCache = parsedFileCache;
   const toEntries = (value, phase) => (value == null ? [] : [].concat(value)).map((source) => ({
     source,
     phase
@@ -638536,27 +638608,34 @@ async function qualifyFiles({ config }) {
   return files;
 }
 async function parseTests({ config, files }) {
-  let specs = [];
-  for (const file of files) {
+  const parseOneFile = async (file) => {
     log(config, "debug", `file: ${file}`);
     const extension = import_node_path11.default.extname(file).slice(1);
     let content = "";
     let rawContent;
     if (extension === "json" || extension === "yaml" || extension === "yml") {
-      try {
-        rawContent = await import_node_fs13.default.promises.readFile(file, "utf8");
-        if (extension === "json") {
-          content = JSON.parse(rawContent);
-        } else {
-          content = import_yaml3.default.parse(rawContent);
+      const cached = config._parsedFileCache?.get(file);
+      if (cached) {
+        rawContent = cached.rawContent;
+        content = cached.content;
+      } else {
+        try {
+          rawContent = await import_node_fs13.default.promises.readFile(file, "utf8");
+          if (extension === "json") {
+            content = JSON.parse(rawContent);
+          } else {
+            content = import_yaml3.default.parse(rawContent);
+          }
+        } catch (err) {
+          console.warn(`Failed to read/parse ${file}: ${err.message}`);
+          content = await readFile({ fileURLOrPath: file });
         }
-      } catch (err) {
-        console.warn(`Failed to read/parse ${file}: ${err.message}`);
-        content = await readFile({ fileURLOrPath: file });
       }
     } else {
       content = await readFile({ fileURLOrPath: file });
     }
+    if (content === null)
+      return null;
     if (typeof content === "object") {
       if (!content.specId)
         content.specId = generateSpecId(file);
@@ -638620,7 +638699,10 @@ async function parseTests({ config, files }) {
       content = await resolvePaths({
         config,
         object: content,
-        filePath: file
+        filePath: file,
+        // Detection only ever resolves specs; passing the known objectType skips
+        // resolvePaths' config_v3-then-spec_v3 discovery probe (item 3.1).
+        objectType: "spec"
       });
       for (let t = 0; t < content.tests.length; t++) {
         const test = content.tests[t];
@@ -638685,13 +638767,16 @@ async function parseTests({ config, files }) {
       if (!validation.valid) {
         log(config, "warning", validation);
         log(config, "warning", `After applying setup and cleanup steps, ${file} isn't a valid test specification. Skipping.`);
-        continue;
+        return null;
       }
       content = validation.object;
       content = await resolvePaths({
         config,
         object: content,
-        filePath: file
+        filePath: file,
+        // Detection only ever resolves specs; passing the known objectType skips
+        // resolvePaths' config_v3-then-spec_v3 discovery probe (item 3.1).
+        objectType: "spec"
       });
       content._phase = specPhase;
       for (const [testIdx, testMap] of stepLocations) {
@@ -638724,7 +638809,7 @@ async function parseTests({ config, files }) {
           }
         }
       }
-      specs.push(content);
+      return content;
     } else {
       let id = generateSpecId(file);
       let spec = {
@@ -638752,7 +638837,7 @@ async function parseTests({ config, files }) {
         });
         if (!validation2.valid) {
           log(config, "warning", `Failed to convert ${file} to a runShell step: ${validation2.errors}. Skipping.`);
-          continue;
+          return null;
         }
         spec.tests.push(test);
         const specValidation = validate({
@@ -638766,12 +638851,14 @@ async function parseTests({ config, files }) {
           spec = await resolvePaths({
             config,
             object: spec,
-            filePath: file
+            filePath: file,
+            // Detection only resolves specs — skip the discovery probe (3.1).
+            objectType: "spec"
           });
           spec._phase = config._phaseByFile?.get(import_node_path11.default.resolve(file)) ?? "main";
-          specs.push(spec);
+          return spec;
         }
-        continue;
+        return null;
       }
       const tests = await detectTests({
         config,
@@ -638793,14 +638880,21 @@ async function parseTests({ config, files }) {
         spec = await resolvePaths({
           config,
           object: spec,
-          filePath: file
+          filePath: file,
+          // Detection only resolves specs — skip the discovery probe (3.1).
+          objectType: "spec"
         });
         spec._phase = config._phaseByFile?.get(import_node_path11.default.resolve(file)) ?? "main";
-        specs.push(spec);
+        return spec;
       }
     }
-  }
-  return specs;
+    return null;
+  };
+  const slots = new Array(files.length).fill(null);
+  await runConcurrent(files.map((_, i) => i), DETECTION_PARSE_CONCURRENCY, async (i) => {
+    slots[i] = await parseOneFile(files[i]);
+  });
+  return slots.filter((spec) => spec != null);
 }
 
 // dist/core/resolveTests.js
@@ -638897,11 +638991,22 @@ ${JSON.stringify(documentArray, null, 2)}`);
   const openApiDocuments = [];
   if (config?.integrations?.openApi?.length > 0)
     openApiDocuments.push(...config.integrations.openApi);
+  const descriptionCache = config._openApiDescriptionCache || (config._openApiDescriptionCache = /* @__PURE__ */ new Map());
   if (documentArray?.length > 0) {
     for (const definition of documentArray) {
       try {
-        const openApiDefinition = await loadDescription(definition.descriptionPath);
-        definition.definition = openApiDefinition;
+        if (!definition.definition) {
+          const key = definition.descriptionPath;
+          let pending = descriptionCache.get(key);
+          if (!pending) {
+            pending = loadDescription(key).catch((err) => {
+              descriptionCache.delete(key);
+              throw err;
+            });
+            descriptionCache.set(key, pending);
+          }
+          definition.definition = await pending;
+        }
       } catch (error) {
         log(config, "error", `Failed to load OpenAPI definition from ${definition.descriptionPath}: ${error.message}`);
         continue;
@@ -639028,6 +639133,7 @@ ${JSON.stringify(detectedTests, null, 2)}`);
     config,
     specs: []
   };
+  config._openApiDescriptionCache = /* @__PURE__ */ new Map();
   log(config, "info", "Resolving test specs.");
   for (const spec of detectedTests) {
     const resolvedSpec = await resolveSpec({ config, spec });
@@ -642697,7 +642803,7 @@ async function setElementOutputs({ element }) {
 }
 async function findElementByRegex({ pattern, timeout, driver }) {
   await driver.pause(timeout);
-  const elements = await driver.$$("//*[normalize-space(text())]");
+  const elements = await driver.$$("//*[text()[normalize-space()]]");
   for (const element of elements) {
     const text = await element.getText();
     if (text.match(pattern)) {
@@ -642784,7 +642890,8 @@ async function findElementByShorthand({ string, timeout = 5e3, driver }) {
     await el.waitForExist({ timeout });
     return el;
   }).catch(() => null);
-  const textPromise = driver.$(`//*[normalize-space(text())="${string}"]`).then(async (el) => {
+  const textLiteral = xpathLiteral2(normalizeText(string));
+  const textPromise = driver.$(`//*[normalize-space(.)=${textLiteral} and not(.//*[normalize-space(.)=${textLiteral}])]`).then(async (el) => {
     await el.waitForExist({ timeout });
     return el;
   }).catch(() => null);
@@ -642832,6 +642939,24 @@ async function findElementByShorthand({ string, timeout = 5e3, driver }) {
 function isRegexPattern(str) {
   return typeof str === "string" && str.startsWith("/") && str.endsWith("/");
 }
+function normalizeText(value) {
+  return String(value ?? "").replace(/\s+/g, " ").trim();
+}
+function xpathLiteral2(value) {
+  if (!value.includes('"'))
+    return `"${value}"`;
+  if (!value.includes("'"))
+    return `'${value}'`;
+  const parts = value.split('"').map((p) => `"${p}"`);
+  return `concat(${parts.join(`, '"', `)})`;
+}
+function matchesText(value, pattern) {
+  if (isRegexPattern(pattern)) {
+    const regex = new RegExp(pattern.slice(1, -1));
+    return regex.test(String(value ?? ""));
+  }
+  return normalizeText(value) === normalizeText(pattern);
+}
 function matchesPattern(value, pattern) {
   if (isRegexPattern(pattern)) {
     const regex = new RegExp(pattern.slice(1, -1));
@@ -642933,8 +643058,11 @@ async function findElementByCriteria({ selector, elementText, elementId, element
             }
           }
         }
-        if (elementText) {
-          xpathConditions.push(`normalize-space(text())`);
+        if (elementText && !isRegexPattern(elementText)) {
+          const lit = xpathLiteral2(normalizeText(elementText));
+          xpathConditions.push(`(normalize-space(.)=${lit} and not(.//*[normalize-space(.)=${lit}]))`);
+        } else if (elementText) {
+          xpathConditions.push(`text()[normalize-space()]`);
         }
         let xpath;
         if (xpathConditions.length > 0) {
@@ -643011,7 +643139,9 @@ async function findElementByCriteria({ selector, elementText, elementId, element
               }
               elementCriteriaUsed.push(checkType.type);
             } else {
-              if (!actualValue || !matchesPattern(actualValue, checkType.value)) {
+              const isTextCriterion = checkType.type === "elementText" || checkType.type === "elementAria";
+              const matched = isTextCriterion ? matchesText(actualValue, checkType.value) : matchesPattern(actualValue, checkType.value);
+              if (!actualValue || !matched) {
                 allChecksPassed = false;
                 break;
               }
@@ -646254,7 +646384,6 @@ async function saveScreenshot({ config, step, driver, appSession }) {
         return result;
       } else {
         existFilePath = filePath;
-        filePath = import_node_path17.default.join(dir, `${step.stepId}_${Date.now()}.png`);
       }
     }
   }
@@ -646340,6 +646469,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     await driver.pause(100);
   }
   const recordingActive = !isAppCapture && isRecordingActive(driver);
+  let captureBuffer;
+  let appScratchPath;
   try {
     if (recordingActive) {
       await driver.execute(() => {
@@ -646349,18 +646480,24 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
     }
     if (isAppCapture) {
-      await appWindowScreenshot(appEntry, appWindowTarget, filePath);
+      appScratchPath = import_node_path17.default.join(dir, `.appcapture_${step.stepId || "screenshot"}_${Date.now()}.png`);
+      await appWindowScreenshot(appEntry, appWindowTarget, appScratchPath);
+      captureBuffer = import_node_fs20.default.readFileSync(appScratchPath);
     } else {
-      await captureDriver.saveScreenshot(filePath);
+      const base64 = await captureDriver.takeScreenshot();
+      captureBuffer = Buffer.from(base64, "base64");
     }
   } catch (error) {
     result.status = "FAIL";
     result.description = `Couldn't save screenshot. ${error}`;
-    if (existFilePath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-      import_node_fs20.default.unlinkSync(filePath);
-    }
     return result;
   } finally {
+    if (appScratchPath && import_node_fs20.default.existsSync(appScratchPath)) {
+      try {
+        import_node_fs20.default.unlinkSync(appScratchPath);
+      } catch {
+      }
+    }
     if (recordingActive) {
       try {
         await driver.execute(() => {
@@ -646372,6 +646509,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       }
     }
   }
+  let finalBuffer = captureBuffer;
   if (step.screenshot.crop) {
     let padding = { top: 0, right: 0, bottom: 0, left: 0 };
     if (typeof step.screenshot.crop.padding === "number") {
@@ -646405,35 +646543,45 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     rect.y = Math.round(rect.y);
     rect.width = Math.round(rect.width);
     rect.height = Math.round(rect.height);
-    const imgMeta = await sharp(filePath).metadata();
+    const imgMeta = await sharp(captureBuffer).metadata();
     const clamped = clampCropRect(rect, imgMeta.width, imgMeta.height);
     rect.x = clamped.x;
     rect.y = clamped.y;
     rect.width = clamped.width;
     rect.height = clamped.height;
     log(config, "debug", { padded_rect: rect });
-    const croppedPath = import_node_path17.default.join(dir, `cropped_${step.stepId || Date.now()}.png`);
     try {
-      await sharp(filePath).extract({
+      finalBuffer = await sharp(captureBuffer).extract({
         left: rect.x,
         top: rect.y,
         width: rect.width,
         height: rect.height
-      }).toFile(croppedPath);
-      import_node_fs20.default.renameSync(croppedPath, filePath);
+      }).png().toBuffer();
     } catch (error) {
       result.status = "FAIL";
       result.description = `Couldn't crop image. ${error}`;
-      if (existFilePath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-        import_node_fs20.default.unlinkSync(filePath);
-      }
       return result;
     }
   }
+  const writeFinalPng = (destination) => {
+    try {
+      import_node_fs20.default.writeFileSync(destination, finalBuffer);
+      return true;
+    } catch (error) {
+      result.status = "FAIL";
+      result.description = `Couldn't save screenshot. ${error}`;
+      return false;
+    }
+  };
+  if (isUrlPath) {
+    if (!writeFinalPng(filePath))
+      return result;
+  }
   if (existFilePath) {
     if (step.screenshot.overwrite == "true" && !isUrlPath) {
+      if (!writeFinalPng(existFilePath))
+        return result;
       result.description += ` Overwrote existing file.`;
-      import_node_fs20.default.renameSync(filePath, existFilePath);
       result.outputs.screenshotPath = existFilePath;
       result.outputs.changed = true;
       if (step.screenshot.sourceIntegration) {
@@ -646447,13 +646595,10 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       let img2;
       try {
         img1 = PNG.sync.read(import_node_fs20.default.readFileSync(existFilePath));
-        img2 = PNG.sync.read(import_node_fs20.default.readFileSync(filePath));
+        img2 = PNG.sync.read(finalBuffer);
       } catch (error) {
         result.status = "FAIL";
         result.description = isUrlPath ? `Couldn't decode PNG for comparison. The URL reference (${redactedUrl}) may not be a valid PNG. ${error}` : `Couldn't decode PNG for comparison. ${error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-          import_node_fs20.default.unlinkSync(filePath);
-        }
         return result;
       }
       const aspectRatioMatch = aspectRatiosMatch(img1, img2);
@@ -646464,9 +646609,6 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (!aspectRatioMatch) {
         result.description = `Couldn't compare images. Images have different aspect ratios.`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-          import_node_fs20.default.unlinkSync(filePath);
-        }
         return await evaluateApplicable();
       }
       if (img1.width !== img2.width || img1.height !== img2.height) {
@@ -646474,14 +646616,12 @@ async function saveScreenshot({ config, step, driver, appSession }) {
         const height2 = Math.min(img1.height, img2.height);
         const img1ResizedBuffer = await sharp(img1.data, {
           raw: { width: img1.width, height: img1.height, channels: 4 }
-        }).resize(width2, height2).png().toBuffer();
+        }).resize(width2, height2).raw().toBuffer();
         const img2ResizedBuffer = await sharp(img2.data, {
           raw: { width: img2.width, height: img2.height, channels: 4 }
-        }).resize(width2, height2).png().toBuffer();
-        const resizedImg1 = PNG.sync.read(img1ResizedBuffer);
-        const resizedImg2 = PNG.sync.read(img2ResizedBuffer);
-        img1.data = resizedImg1.data;
-        img2.data = resizedImg2.data;
+        }).resize(width2, height2).raw().toBuffer();
+        img1.data = img1ResizedBuffer;
+        img2.data = img2ResizedBuffer;
         img1.width = width2;
         img1.height = height2;
       }
@@ -646492,9 +646632,6 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       } catch (error) {
         result.status = "FAIL";
         result.description = `Couldn't load screenshot comparison dependency (pixelmatch). ${error?.message ?? error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs20.default.existsSync(filePath)) {
-          import_node_fs20.default.unlinkSync(filePath);
-        }
         return result;
       }
       const numDiffPixels = pixelmatchFn(img1.data, img2.data, null, width, height, { threshold: 5e-4 });
@@ -646511,7 +646648,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (fractionalDiff > step.screenshot.maxVariation) {
         if (step.screenshot.overwrite == "aboveVariation" && !isUrlPath) {
-          import_node_fs20.default.renameSync(filePath, existFilePath);
+          if (!writeFinalPng(existFilePath))
+            return result;
         }
         result.description += ` The difference between the existing screenshot and new screenshot (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.screenshot.maxVariation}).`;
         if (isUrlPath) {
@@ -646535,14 +646673,13 @@ async function saveScreenshot({ config, step, driver, appSession }) {
           if (step.screenshot.sourceIntegration) {
             result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
           }
-          if (step.screenshot.overwrite != "true") {
-            import_node_fs20.default.unlinkSync(filePath);
-          }
         }
       }
     }
   }
   if (!result.outputs.screenshotPath) {
+    if (!writeFinalPng(filePath))
+      return result;
     result.outputs.screenshotPath = filePath;
     result.outputs.changed = true;
     if (step.screenshot.sourceIntegration) {
@@ -652929,6 +653066,9 @@ async function runTests(config, options = {}) {
       return null;
     }
   }
+  if (typeof options.updateJoin === "function") {
+    await options.updateJoin();
+  }
   if (config.dryRun) {
     console.log(JSON.stringify(resolvedTests, null, 2));
     cleanTemp();
@@ -652960,23 +653100,43 @@ async function runTests(config, options = {}) {
       }
       if (needs.browsers.size > 0) {
         try {
-          const { getAvailableApps: getAvailableApps2, clearAppCache: clearAppCache2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+          const { getAvailableApps: getAvailableApps2, patchAppCache: patchAppCache2 } = await Promise.resolve().then(() => (init_config(), config_exports));
           const { ensureBrowserInstalled: ensureBrowserInstalled2, requiredBrowserAssets: requiredBrowserAssets2 } = await Promise.resolve().then(() => (init_browsers(), browsers_exports));
           const available = await getAvailableApps2({ config });
           const availableNames = new Set(available.map((a) => a.name));
-          let installedAnything = false;
+          const installedDescriptors = [];
           for (const browser of needs.browsers) {
             if (availableNames.has(browser))
               continue;
             const assets = requiredBrowserAssets2(browser);
+            const assetResults = {};
             for (const asset of assets) {
-              await ensureBrowserInstalled2(asset, { ctx, deps: { logger: preflightLogger } });
+              assetResults[asset] = await ensureBrowserInstalled2(asset, {
+                ctx,
+                deps: { logger: preflightLogger }
+              });
             }
-            if (assets.length > 0)
-              installedAnything = true;
+            if (assets.length === 0)
+              continue;
+            if (browser === "chrome") {
+              installedDescriptors.push({
+                name: "chrome",
+                version: assetResults.chrome?.version,
+                path: assetResults.chrome?.path,
+                driverPath: assetResults.chromedriver?.path
+              });
+            } else if (browser === "firefox") {
+              installedDescriptors.push({
+                name: "firefox",
+                version: assetResults.firefox?.version,
+                path: assetResults.firefox?.path,
+                driverPath: assetResults.geckodriver?.path
+              });
+            }
+          }
+          if (installedDescriptors.length > 0) {
+            await patchAppCache2(config, installedDescriptors);
           }
-          if (installedAnything)
-            clearAppCache2(config);
         } catch (browserErr) {
           log(config, "debug", `Browser pre-flight check skipped: ${browserErr?.message ?? browserErr}`);
         }
@@ -653003,8 +653163,8 @@ async function runTests(config, options = {}) {
   } else {
     results = await runSpecs({ resolvedTests });
   }
-  log(config, "info", "RESULTS:");
-  log(config, "info", results);
+  log(config, "debug", "RESULTS:");
+  log(config, "debug", results);
   log(config, "info", "Cleaning up and finishing post-processing.");
   cleanTemp();
   sendTelemetry(config, "runTests", results);