@vardot/varbase-e2e 2.0.0 → 2.0.2

package/.playwright-mcp/page-2026-08-10T08-52-17-430Z.yml

@@ -0,0 +1,410 @@
+- generic [active] [ref=f99e1]:
+  - generic:
+    - link "Skip to main content" [ref=f99e2] [cursor=pointer]:
+      - /url: "#content"
+    - link "Skip to search" [ref=f99e3] [cursor=pointer]:
+      - /url: "#search-block-form"
+  - navigation [ref=f99e5]:
+    - generic [ref=f99e6]:
+      - generic [ref=f99e7]:
+        - generic:
+          - generic:
+            - generic:
+              - list:
+                - listitem [ref=f99e8]:
+                  - link "Drupal.org home" [ref=f99e9] [cursor=pointer]:
+                    - /url: /home
+                - listitem [ref=f99e10]:
+                  - link "Discover Drupal" [ref=f99e11] [cursor=pointer]:
+                    - /url: https://www.drupal.org/about/overview/technical
+                - listitem [ref=f99e12]:
+                  - link "Build with Drupal" [ref=f99e13] [cursor=pointer]:
+                    - /url: https://www.drupal.org/docs/official_docs/local-development-guide
+                - listitem [ref=f99e14]:
+                  - link "Partners & Services" [ref=f99e15] [cursor=pointer]:
+                    - /url: https://www.drupal.org/drupal-services
+                - listitem [ref=f99e16]:
+                  - link "Community" [ref=f99e17] [cursor=pointer]:
+                    - /url: https://www.drupal.org/community
+                - listitem [ref=f99e18]:
+                  - link "Support Drupal" [ref=f99e19] [cursor=pointer]:
+                    - /url: /association
+                - listitem [ref=f99e20]:
+                  - link "Get Started" [ref=f99e21] [cursor=pointer]:
+                    - /url: /try-hosting
+      - generic [ref=f99e27]:
+        - heading "Search form" [level=2] [ref=f99e28]
+        - generic: Search
+        - button "Search" [ref=f99e31] [cursor=pointer]
+      - generic [ref=f99e32]:
+        - generic:
+          - generic:
+            - generic:
+              - list:
+                - listitem:
+                  - link [ref=f99e33] [cursor=pointer]:
+                    - /url: "#block-system-user-menu"
+                    - img "Log in, view profile, and more" [ref=f99e34]
+  - link [ref=f99e39] [cursor=pointer]:
+    - /url: /
+    - img "Drupal.org" [ref=f99e40]
+  - generic [ref=f99e42]:
+    - generic [ref=f99e43]:
+      - navigation [ref=f99e45]:
+        - link "General projects" [ref=f99e47] [cursor=pointer]:
+          - /url: /project/project_general
+        - link "Varbase Project Template" [ref=f99e49] [cursor=pointer]:
+          - /url: /project/varbase_project
+        - link "Issues" [ref=f99e51] [cursor=pointer]:
+          - /url: /project/issues/varbase_project
+        - 'link "task: Switch the Varbase functional testing suite to Varbase E2E on 9.2.x" [ref=f99e53] [cursor=pointer]':
+          - /url: /project/varbase_project/issues/3615713
+      - heading [level=1] [ref=f99e54]:
+        - text: Edit
+        - emphasis [ref=f99e55]: "task: Switch the Varbase functional testing suite to Varbase E2E on 9.2.x"
+    - generic [ref=f99e56]:
+      - heading "Primary tabs" [level=2] [ref=f99e57]
+      - list [ref=f99e58]:
+        - listitem [ref=f99e59]:
+          - link "View" [ref=f99e60] [cursor=pointer]:
+            - /url: /project/varbase_project/issues/3615713
+        - listitem [ref=f99e61]:
+          - link "Edit (active tab)" [ref=f99e62] [cursor=pointer]:
+            - /url: /node/3615713/edit
+            - text: Edit
+            - generic [ref=f99e63]: (active tab)
+    - main [ref=f99e64]:
+      - generic [ref=f99e65]:
+        - generic [ref=f99e67]:
+          - text: "?"
+          - paragraph [ref=f99e70]:
+            - text: Learn
+            - link "how to report an issue" [ref=f99e71] [cursor=pointer]:
+              - /url: /community/contributor-guide/reference-information/quick-info/creating-or-updating-an-issue-report
+            - text: .
+        - generic [ref=f99e79]:
+          - group [ref=f99e80]:
+            - link "Hide Issue metadata" [ref=f99e83] [cursor=pointer]:
+              - /url: "#"
+              - generic [ref=f99e84]: Hide
+              - text: Issue metadata
+            - generic [ref=f99e85]:
+              - generic [ref=f99e86]:
+                - generic [ref=f99e87]: Title *
+                - textbox "Title *" [ref=f99e88]: "task: Switch the Varbase functional testing suite to Varbase E2E on 9.2.x"
+              - generic [ref=f99e89]:
+                - application [ref=f99e92]:
+                  - generic [ref=f99e93]: Project *
+                  - textbox "Project *" [ref=f99e94]: Varbase Project Template (3401545)
+                - generic [ref=f99e97]:
+                  - generic [ref=f99e98]: Version *
+                  - combobox "Version *" [ref=f99e99]:
+                    - option "11.0.x-dev"
+                    - option "11.0.5"
+                    - option "11.0.4"
+                    - option "11.0.3"
+                    - option "11.0.2"
+                    - option "11.0.1"
+                    - option "11.0.0"
+                    - option "11.0.0-alpha1"
+                    - option "10.1.x-dev"
+                    - option "10.1.3"
+                    - option "10.1.2"
+                    - option "10.1.1"
+                    - option "9.2.x-dev" [selected]
+                    - option "9.2.1"
+                    - option "9.2.0"
+                - generic [ref=f99e101]:
+                  - generic [ref=f99e102]: Component *
+                  - combobox "Component *" [ref=f99e103]:
+                    - option "Code" [selected]
+                    - option "Documentation"
+                    - option "Miscellaneous"
+                    - option "User interface"
+                - generic [ref=f99e105]:
+                  - generic [ref=f99e106]: Assigned *
+                  - combobox "Assigned *" [ref=f99e107]:
+                    - option "Unassigned" [selected]
+                    - option "josebc"
+                    - option "mohammed j. razem"
+                    - option "omar alahmed"
+                    - option "rajab natshah"
+              - generic [ref=f99e108]:
+                - generic [ref=f99e110]:
+                  - generic [ref=f99e111]: Category *
+                  - combobox "Category *" [ref=f99e112]:
+                    - option "Bug report"
+                    - option "Task" [selected]
+                    - option "Feature request"
+                    - option "Support request"
+                    - option "Plan"
+                - generic [ref=f99e114]:
+                  - generic [ref=f99e115]: Priority *
+                  - combobox "Priority *" [ref=f99e116]:
+                    - option "Critical"
+                    - option "Major"
+                    - option "Normal" [selected]
+                    - option "Minor"
+                - generic [ref=f99e118]:
+                  - generic [ref=f99e119]: Status *
+                  - combobox "Status *" [ref=f99e120]:
+                    - option "Active" [selected]
+                    - option "Needs work"
+                    - option "Needs review"
+                    - option "Reviewed & tested by the community"
+                    - option "Patch (to be ported)"
+                    - option "Fixed"
+                    - option "Postponed"
+                    - option "Postponed (maintainer needs more info)"
+                    - option "Closed (duplicate)"
+                    - option "Closed (won't fix)"
+                    - option "Closed (works as designed)"
+                    - option "Closed (cannot reproduce)"
+                    - option "Closed (outdated)"
+              - generic [ref=f99e121]:
+                - text: Descriptions of the
+                - link "Priority" [ref=f99e122] [cursor=pointer]:
+                  - /url: /docs/develop/issues/fields-and-other-parts-of-an-issue/issue-priority-field
+                - text: and
+                - link "Status" [ref=f99e123] [cursor=pointer]:
+                  - /url: /docs/develop/issues/fields-and-other-parts-of-an-issue/issue-status-field
+                - text: values can be found in the
+                - link "Drupal project issues" [ref=f99e124] [cursor=pointer]:
+                  - /url: /docs/develop/issues
+                - text: documentation.
+              - application [ref=f99e127]:
+                - generic [ref=f99e128]: Issue tags
+                - textbox "Issue tags" [ref=f99e129]
+                - generic [ref=f99e130]:
+                  - text: Before adding tags
+                  - link "read the issue tag guidelines" [ref=f99e131] [cursor=pointer]:
+                    - /url: /node/3156530
+                  - text: . Do
+                  - strong [ref=f99e132]: NOT
+                  - text: use tags for adding random keywords or duplicating any other fields. Separate terms with a comma, not a space.
+          - generic [ref=f99e137]:
+            - generic [ref=f99e138]:
+              - generic [ref=f99e139]: Comment
+              - generic [ref=f99e140]:
+                - toolbar [ref=f99e141]:
+                  - button "Bold(B)" [ref=f99e142] [cursor=pointer]
+                  - button "Italic(I)" [ref=f99e143] [cursor=pointer]
+                  - button "Strike-through" [ref=f99e144] [cursor=pointer]
+                  - button "Heading 2" [ref=f99e145] [cursor=pointer]
+                  - button "Heading 3" [ref=f99e146] [cursor=pointer]
+                  - button "Heading 4" [ref=f99e147] [cursor=pointer]
+                  - button "Quote" [ref=f99e148] [cursor=pointer]
+                  - button "code" [ref=f99e149] [cursor=pointer]
+                  - button "PHP" [ref=f99e150] [cursor=pointer]
+                  - button "Insert/edit image(M)" [ref=f99e151] [cursor=pointer]
+                  - button "Insert/edit link(L)" [ref=f99e152] [cursor=pointer]
+                  - button "Ordered list. Converts selected lines to a numbered list.(O)" [ref=f99e153] [cursor=pointer]
+                  - button "Unordered list. Converts selected lines to a bulleted list.(U)" [ref=f99e154] [cursor=pointer]
+                  - button "Get help on button functionality.(H)" [ref=f99e155] [cursor=pointer]
+                - textbox "Comment" [ref=f99e156]
+            - group "Show Text format" [ref=f99e158]:
+              - paragraph [ref=f99e160]:
+                - link "More information about text formats" [ref=f99e161] [cursor=pointer]:
+                  - /url: /filter/tips
+          - group [ref=f99e162]:
+            - link "Hide Issue summary & relationships" [ref=f99e165] [cursor=pointer]:
+              - /url: "#"
+              - generic [ref=f99e166]: Hide
+              - text: Issue summary & relationships
+            - generic [ref=f99e167]:
+              - generic [ref=f99e170]:
+                - generic [ref=f99e171]:
+                  - generic [ref=f99e172]: Issue summary
+                  - generic [ref=f99e173]:
+                    - toolbar [ref=f99e174]:
+                      - button "Bold(B)" [ref=f99e175] [cursor=pointer]
+                      - button "Italic(I)" [ref=f99e176] [cursor=pointer]
+                      - button "Strike-through" [ref=f99e177] [cursor=pointer]
+                      - button "Heading 2" [ref=f99e178] [cursor=pointer]
+                      - button "Heading 3" [ref=f99e179] [cursor=pointer]
+                      - button "Heading 4" [ref=f99e180] [cursor=pointer]
+                      - button "Quote" [ref=f99e181] [cursor=pointer]
+                      - button "code" [ref=f99e182] [cursor=pointer]
+                      - button "PHP" [ref=f99e183] [cursor=pointer]
+                      - button "Insert/edit image(M)" [ref=f99e184] [cursor=pointer]
+                      - button "Insert/edit link(L)" [ref=f99e185] [cursor=pointer]
+                      - button "Ordered list. Converts selected lines to a numbered list.(O)" [ref=f99e186] [cursor=pointer]
+                      - button "Unordered list. Converts selected lines to a bulleted list.(U)" [ref=f99e187] [cursor=pointer]
+                      - button "Get help on button functionality.(H)" [ref=f99e188] [cursor=pointer]
+                    - textbox "Issue summary" [ref=f99e189]: "<h3 id=\"summary-problem-motivation\">Problem/Motivation</h3> <p>The Varbase functional testing suite on this branch still depends on the previous testing package. The harness now ships as Varbase E2E (<code>@vardot/varbase-e2e</code> 2.0.0), which includes the Drupal and Varbase step packs as built-ins. Keeping local copies makes scenarios ambiguous and cuts this project off from upstream fixes.</p> <h4 id=\"summary-steps-reproduce\">Steps to reproduce</h4> <p>Run <code>grep -rn \"VARBASE_E2E\\|varbase-e2e\" package.json cucumber.js</code> on 9.2.x &mdash; it still points at the previous package.</p> <h3 id=\"summary-proposed-resolution\">Proposed resolution</h3> <ul> <li>Depend on <code>@vardot/varbase-e2e ^2.0.0</code>; update <code>cucumber.js</code> require globs and the report script path.</li> <li>Re-point custom step helper imports at the new package.</li> <li>Remove custom steps now shipped as built-ins; keep only project-specific ones.</li> <li>Rename env vars to the <code>VARBASE_E2E_*</code> family across config/CI/DDEV.</li> <li>Verify with <code>npx cucumber-js --dry-run</code> (zero ambiguous/undefined), then CI.</li> </ul> <p><em>AI-Generated: Yes</em></p> <h3 id=\"summary-remaining-tasks\">Remaining tasks</h3> <ul> <li>✅ File an issue</li> <li>❌ Addition/Change/Update/Fix</li> <li>❌ Testing to ensure no regression</li> <li>➖ Automated unit testing coverage</li> <li>❌ Automated functional testing coverage</li> <li>➖ UX/UI designer responsibilities</li> <li>❌ Readability</li> <li>➖ Accessibility</li> <li>➖ Performance</li> <li>➖ Security</li> <li>❌ Developer Documentation</li> <li>➖ User Guide Documentation</li> <li>➖ Reviewed by human</li> <li>➖ Code review by maintainers</li> <li>➖ Full testing and approval</li> <li>➖ Credit contributors</li> <li>➖ Review with the product owner</li> <li>➖ Release notes snippet</li> <li>❌ Release</li> </ul> <h3 id=\"summary-ui-changes\">User interface changes</h3> <ul> <li>N/A</li> </ul> <h3 id=\"summary-api-changes\">API changes</h3> <ul> <li>N/A</li> </ul> <h3 id=\"summary-data-model-changes\">Data model changes</h3> <ul> <li>N/A</li> </ul> <h3 id=\"summary-release-notes\">Release notes snippet</h3> <ul> <li>The Varbase functional testing suite now runs on Varbase E2E (<code>@vardot/varbase-e2e</code> 2.0.0).</li> </ul>"
+                - group "Show Text format" [ref=f99e191]:
+                  - paragraph [ref=f99e193]:
+                    - link "More information about text formats" [ref=f99e194] [cursor=pointer]:
+                      - /url: /filter/tips
+                - generic [ref=f99e195]:
+                  - text: A
+                  - link "description of the issue summary field" [ref=f99e196] [cursor=pointer]:
+                    - /url: /community/contributor-guide/reference-information/drupal-project-issues/fields-and-other-parts-of-9
+                  - text: and
+                  - link "alternative issue summary templates" [ref=f99e197] [cursor=pointer]:
+                    - /url: /community/contributor-guide/reference-information/drupal-project-issues/fields-and-other-parts-of-11
+                  - text: can be found in the
+                  - link "Drupal project issues" [ref=f99e198] [cursor=pointer]:
+                    - /url: /community/contributor-guide/reference-information/drupal-project-issues
+                  - text: documentation.
+              - generic [ref=f99e201]:
+                - generic [ref=f99e202]: Parent issue link
+                - generic [ref=f99e205]:
+                  - generic [ref=f99e206]: URL
+                  - textbox "URL" [ref=f99e207]
+                - generic [ref=f99e208]: URL of the parent issue. It can be https://www.drupal.org issue or https://git.drupalcode.org issue.
+              - generic [ref=f99e211]:
+                - link "Show row weights" [ref=f99e213] [cursor=pointer]:
+                  - /url: "#"
+                - table [ref=f99e214]:
+                  - rowgroup [ref=f99e215]:
+                    - row [ref=f99e216]:
+                      - columnheader "Related issues links" [ref=f99e217]
+                  - rowgroup [ref=f99e219]:
+                    - row "Related issues links URL" [ref=f99e220]:
+                      - cell [ref=f99e221]:
+                        - link "Drag to re-order" [ref=f99e222]:
+                          - /url: "#"
+                      - cell "Related issues links URL" [ref=f99e224]:
+                        - generic [ref=f99e225]:
+                          - generic [ref=f99e226]: Related issues links
+                          - generic [ref=f99e229]:
+                            - generic [ref=f99e230]: URL
+                            - textbox "URL" [ref=f99e231]
+                - generic [ref=f99e232]: URLs of related issues. They can be https://www.drupal.org issues or https://git.drupalcode.org issues.
+                - button "Add another item" [ref=f99e234]
+          - group [ref=f99e237]:
+            - link "Show Files" [ref=f99e240] [cursor=pointer]:
+              - /url: "#"
+              - generic [ref=f99e241]: Show
+              - text: Files
+          - heading "Vertical Tabs" [level=2] [ref=f99e242]
+          - paragraph [ref=f99e243]:
+            - text: Be sure to
+            - link "update the contribution record" [ref=f99e244] [cursor=pointer]:
+              - /url: https://new.drupal.org/contribution-record?source_link=https%3A//www.drupal.org/node/3615713
+          - generic [ref=f99e245]:
+            - button "Save" [ref=f99e246]
+            - button "Preview" [ref=f99e247]
+            - button "View changes" [ref=f99e248]
+  - contentinfo [ref=f99e249]:
+    - generic [ref=f99e250]:
+      - generic [ref=f99e253]:
+        - link [ref=f99e254] [cursor=pointer]:
+          - /url: https://www.tag1.com/?utm_source=DA&utm_medium=referral&utm_campaign=drupal-org-footer
+          - text: Infrastructure management for Drupal.org provided by
+          - img "Tag1 logo" [ref=f99e255]
+        - link "Need a Drupal 7 extended support partner? Consider Tag1." [ref=f99e257] [cursor=pointer]:
+          - /url: https://d7es.tag1.com/plans?utm_source=DA&utm_medium=footer&utm_campaign=EOL&utm_id=d7es&utm_term=plans&utm_content=Dec
+      - generic [ref=f99e258]:
+        - generic:
+          - generic:
+            - heading "News items" [level=4] [ref=f99e259]
+            - list [ref=f99e260]:
+              - listitem [ref=f99e261]:
+                - link "News" [ref=f99e262] [cursor=pointer]:
+                  - /url: https://www.drupal.org/news
+              - listitem [ref=f99e263]:
+                - link "Planet Drupal" [ref=f99e264] [cursor=pointer]:
+                  - /url: https://www.drupal.org/planet
+              - listitem [ref=f99e265]:
+                - link "Social media" [ref=f99e266] [cursor=pointer]:
+                  - /url: https://www.drupal.org/about/media-kit/social-media
+              - listitem [ref=f99e267]:
+                - link "Sign up for Drupal news" [ref=f99e268] [cursor=pointer]:
+                  - /url: https://www.drupal.org/subscribe
+              - listitem [ref=f99e269]:
+                - link "Security advisories" [ref=f99e270] [cursor=pointer]:
+                  - /url: https://www.drupal.org/security
+              - listitem [ref=f99e271]:
+                - link "Jobs" [ref=f99e272] [cursor=pointer]:
+                  - /url: https://jobs.drupal.org/
+            - heading "Our community" [level=4] [ref=f99e273]
+            - list [ref=f99e274]:
+              - listitem [ref=f99e275]:
+                - link "Community" [ref=f99e276] [cursor=pointer]:
+                  - /url: https://www.drupal.org/community
+              - listitem [ref=f99e277]:
+                - generic [ref=f99e278]:
+                  - link "Services" [ref=f99e279] [cursor=pointer]:
+                    - /url: https://www.drupal.org/drupal-services
+                  - text: ","
+                  - link "Training" [ref=f99e280] [cursor=pointer]:
+                    - /url: https://www.drupal.org/training
+                  - text: "&"
+                  - link "Hosting" [ref=f99e281] [cursor=pointer]:
+                    - /url: https://www.drupal.org/hosting
+              - listitem [ref=f99e282]:
+                - link "Contributor guide" [ref=f99e283] [cursor=pointer]:
+                  - /url: https://www.drupal.org/community/contributor-guide
+              - listitem [ref=f99e284]:
+                - link "Groups & meetups" [ref=f99e285] [cursor=pointer]:
+                  - /url: https://groups.drupal.org/groups
+              - listitem [ref=f99e286]:
+                - link "DrupalCon" [ref=f99e287] [cursor=pointer]:
+                  - /url: https://events.drupal.org
+              - listitem [ref=f99e288]:
+                - link "Code of conduct" [ref=f99e289] [cursor=pointer]:
+                  - /url: https://www.drupal.org/dcoc
+            - heading "Documentation" [level=4] [ref=f99e290]
+            - list [ref=f99e291]:
+              - listitem [ref=f99e292]:
+                - link "Documentation" [ref=f99e293] [cursor=pointer]:
+                  - /url: https://www.drupal.org/documentation
+              - listitem [ref=f99e294]:
+                - link "Drupal Guide" [ref=f99e295] [cursor=pointer]:
+                  - /url: https://www.drupal.org/docs
+              - listitem [ref=f99e296]:
+                - link "Drupal User Guide" [ref=f99e297] [cursor=pointer]:
+                  - /url: https://www.drupal.org/docs/user_guide/en/index.html
+              - listitem [ref=f99e298]:
+                - link "Developer docs" [ref=f99e299] [cursor=pointer]:
+                  - /url: https://www.drupal.org/documentation/develop
+              - listitem [ref=f99e300]:
+                - link "API.Drupal.org" [ref=f99e301] [cursor=pointer]:
+                  - /url: https://api.drupal.org/
+            - heading "Drupal code base" [level=4] [ref=f99e302]
+            - list [ref=f99e303]:
+              - listitem [ref=f99e304]:
+                - link "Download & Extend" [ref=f99e305] [cursor=pointer]:
+                  - /url: https://www.drupal.org/download
+              - listitem [ref=f99e306]:
+                - link "Drupal core" [ref=f99e307] [cursor=pointer]:
+                  - /url: https://www.drupal.org/project/drupal
+              - listitem [ref=f99e308]:
+                - link "Modules" [ref=f99e309] [cursor=pointer]:
+                  - /url: https://www.drupal.org/project/project_module
+              - listitem [ref=f99e310]:
+                - link "Themes" [ref=f99e311] [cursor=pointer]:
+                  - /url: https://www.drupal.org/project/project_theme
+              - listitem [ref=f99e312]:
+                - link "Distributions" [ref=f99e313] [cursor=pointer]:
+                  - /url: https://www.drupal.org/project/project_distribution
+            - heading "Governance of community" [level=4] [ref=f99e314]
+            - list [ref=f99e315]:
+              - listitem [ref=f99e316]:
+                - link "About" [ref=f99e317] [cursor=pointer]:
+                  - /url: https://www.drupal.org/about
+              - listitem [ref=f99e318]:
+                - link "Web accessibility" [ref=f99e319] [cursor=pointer]:
+                  - /url: https://www.drupal.org/about/features/accessibility
+              - listitem [ref=f99e320]:
+                - link "Drupal Association" [ref=f99e321] [cursor=pointer]:
+                  - /url: https://www.drupal.org/association
+              - listitem [ref=f99e322]:
+                - link "About Drupal.org" [ref=f99e323] [cursor=pointer]:
+                  - /url: https://www.drupal.org/drupalorg
+              - listitem [ref=f99e324]:
+                - link "Terms of service" [ref=f99e325] [cursor=pointer]:
+                  - /url: https://www.drupal.org/terms
+              - listitem [ref=f99e326]:
+                - link "Privacy policy" [ref=f99e327] [cursor=pointer]:
+                  - /url: https://www.drupal.org/privacy
+      - paragraph [ref=f99e331]:
+        - text: Drupal is a
+        - link "registered trademark" [ref=f99e332] [cursor=pointer]:
+          - /url: /about/trademark
+        - text: of
+        - link "Dries Buytaert" [ref=f99e333] [cursor=pointer]:
+          - /url: https://dri.es
+        - text: .

package/AGENTS.md

@@ -133,8 +133,10 @@ Config: `cucumber.js` (`worldParameters`, annotated) and
 `playwright.config.ts` (browser launch + context), plus the scaffold
 template in `bin/init-varbase-e2e.js` that must mirror them.
 
-Visual regression: extracted to the [`diffy-steps`](https://github.com/webship/diffy-steps)
-plugin — not in this repository.
+Visual regression: not in this repository — consumers install a step-pack
+plugin such as [`@webship-js/diffy-steps`](https://github.com/webship/diffy-steps).
+Third-party `*-steps` packs built for the harness this grew from work with
+varbase-e2e unchanged.
 
 ## This repo is the package
 

package/CLAUDE.md

@@ -56,7 +56,7 @@ Env vars: `LAUNCH_URL`, `BROWSER`, `HEADLESS`, `SLOW_MO`, `FORCE_COLOR`,
 `VARBASE_E2E_AUTO_SETTLE`, `VARBASE_E2E_REPORT_DISABLE`, `VARBASE_E2E_REPORT_ARGS`,
 `VARBASE_E2E_FILTER_HOOK_LINES`, `VARBASE_E2E_SCREENSHOT_*`, `VARBASE_E2E_VIDEO*`,
 `VARBASE_E2E_JS_ERROR_*`, `VARBASE_E2E_SELECTORS_OFFSET`,
-`VARBASE_E2E_SELECTORS_BREAKPOINTS`, `DIFFY_*`. Every one of them mirrors a
+`VARBASE_E2E_SELECTORS_BREAKPOINTS`. Every one of them mirrors a
 `worldParameters` key in `cucumber.js` — that file is the annotated
 reference; read it before inventing a new knob.
 
@@ -150,13 +150,27 @@ names matter more than they look.
 
 ### 2.6 Visual regression lives outside this repo
 
-The Diffy step-pack was extracted to its own plugin,
-[`diffy-steps`](https://github.com/webship/diffy-steps). varbase-e2e no
-longer ships `tests/step-definitions-diffy/`, the `diffy`
-`worldParameters` block, or the mock Diffy API. Consumers install the
-plugin and add `node_modules/@webship-js/diffy-steps/tests/step-definitions/**/*.js`
-to their own `require:` list. Nothing in this repo depends on it — the
-steps only ever used `@cucumber/cucumber`, `axios`, and Node built-ins.
+varbase-e2e ships no visual-regression steps: no
+`tests/step-definitions-diffy/`, no `diffy` `worldParameters` block, no
+mock Diffy API. Consumers who want visual regression install a
+step-pack plugin and add its step-definition path to their own
+`require:` list — the Diffy pack,
+[`@webship-js/diffy-steps`](https://github.com/webship/diffy-steps), is
+the reference example. Third-party `*-steps` packs built for the
+harness this grew from work with varbase-e2e unchanged: they only ever
+used `@cucumber/cucumber`, `axios`, and Node built-ins, none of which
+this rename touched. Its `DIFFY_*` env vars belong to that plugin, not
+to this package's `cucumber.js`.
+
+```js
+// consumer cucumber.js
+require: [
+  'node_modules/@vardot/varbase-e2e/tests/step-definitions/**/*.js',
+  'node_modules/@webship-js/diffy-steps/tests/step-definitions/**/*.js',
+  'tests/step-definitions/**/*.js',
+],
+```
+
 Treat any `diffy` question as a `diffy-steps` question.
 
 ### 2.7 CI

package/docs/README.md

@@ -44,9 +44,10 @@ The full step catalogue — one page per category, generated from the step defin
 | [Advanced screenshots](advanced-screenshots.md) | Per-size, full-page, named (3 sub-pages under `advanced-screenshots/`) |
 | [Advanced selectors](advanced-selectors.md) | Named selector registry, position assertions |
 
-> **Visual regression moved out.** The Diffy step-pack now ships as its own
-> plugin, [`diffy-steps`](https://github.com/webship/diffy-steps) — install it
-> alongside varbase-e2e and add its step-definition path to `cucumber.js`.
+> **Visual regression moved out.** It ships as a separate step-pack plugin —
+> [`@webship-js/diffy-steps`](https://github.com/webship/diffy-steps) — install
+> it alongside varbase-e2e and add its step-definition path to `cucumber.js`.
+> `*-steps` packs built for the harness this grew from work unchanged.
 
 ## At a glance
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vardot/varbase-e2e",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Varbase E2E automated functional testing.",
   "main": "index.js",
   "bin": {

package/tests/step-definitions/action.steps.js

@@ -44,10 +44,25 @@ When(/^(I |we )*press( the)* "([^"]*)?"( button)*$/, async function (pronounCase
   const esc = element.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
   const page = this.page;
   await actOrExplain('press button', element, async () => {
-    await page.locator('button, input[type="button"], input[type="submit"], [role="button"], a')
-      .filter({ hasText: new RegExp('^' + esc + '$') })
-      .first()
-      .click();
+    const all = page.locator('button, input[type="button"], input[type="submit"], [role="button"], a')
+      .filter({ hasText: new RegExp('^' + esc + '$') });
+    // Sticky action bars (Gin) clone buttons: the original stays hidden while
+    // the visible clone carries the same text. Prefer the visible candidate —
+    // clicking the hidden original starves actionability for the full timeout.
+    let btn = all.first();
+    const count = await all.count();
+    for (let i = 0; i < count; i++) {
+      if (await all.nth(i).isVisible()) { btn = all.nth(i); break; }
+    }
+    try {
+      await btn.click({ timeout: 10000 });
+    } catch (e) {
+      // A fixed-position overlay (chat widgets, sticky action bars) can sit on
+      // top of a correctly-resolved button and starve the pointer click's
+      // actionability checks. The button itself is right — dispatch the click
+      // in-page so its handlers (including form submit) still fire.
+      await btn.evaluate((el) => el.click(), { timeout: 5000 });
+    }
   });
 });
 

package/tests/step-definitions/drupal-layout-builder.steps.js

@@ -51,6 +51,28 @@ When(/^(?:I |we )*add a basic(?: "([^"]*)")? section at the end of layout$/, asy
   if (!(await layoutLink.count())) throw friendly(`The "${layout}" layout option was not found in the Add section list.`);
   await layoutLink.click();
   await smartSettle(this.page, budget(this));
+  // On newer Bootstrap Layout Builder the layout option adds the section
+  // directly instead of opening its settings in the off-canvas. When the
+  // section settings form (container type, breakpoints, background) did not
+  // open, click the newly added (highest-delta) section's "Configure" link -
+  // a use-ajax link that opens the settings in the #drupal-off-canvas dialog,
+  // where the following section-settings steps run.
+  const hasSettingsForm = await this.page.locator('[id*="layout-container-type"]').count();
+  if (!hasSettingsForm) {
+    const links = this.page.locator('a.layout-builder__link--configure[href*="/layout_builder/configure-form/section/"]');
+    const count = await links.count();
+    let bestLink = null;
+    let bestDelta = -1;
+    for (let i = 0; i < count; i++) {
+      const href = await links.nth(i).getAttribute('href');
+      const delta = parseInt(href.split('/').pop(), 10);
+      if (delta > bestDelta) { bestDelta = delta; bestLink = links.nth(i); }
+    }
+    if (bestLink) {
+      await bestLink.click();
+      await smartSettle(this.page, budget(this));
+    }
+  }
 });
 
 /**
@@ -69,8 +91,20 @@ When(/^(?:I |we )*save the section$/, async function () {
   // Drupal's jQuery-bound AJAX submit handler for this button - it can leave
   // the section silently un-added. Use a real Playwright mouse click instead,
   // which dispatches the full native event sequence.
-  const btn = this.page.locator('input[type="submit"], button').filter({ hasText: /Add section/i }).first();
-  if (!(await btn.count())) throw friendly('The "Add section" button was not found.');
+  // The submit reads "Add section" on a fresh section and "Update" when the
+  // settings were opened through the section's Configure link. Match the
+  // value attribute exactly (the control is usually an <input>) or a
+  // button's exact text, preferring the off-canvas dialog - a loose /Update/
+  // match grabs invisible widget buttons ("Update widget") elsewhere.
+  const label = /^(Add section|Update)$/;
+  const pick = (scope) => this.page
+    .locator(`${scope} input[type="submit"][value="Add section"], ${scope} input[type="submit"][value="Update"]`)
+    .or(this.page.locator(`${scope} button`).filter({ hasText: label }));
+  let btn = pick('#drupal-off-canvas').first();
+  if (!(await btn.count())) {
+    btn = pick('body').first();
+  }
+  if (!(await btn.count())) throw friendly('The "Add section" / "Update" button was not found.');
   await btn.click();
   await smartSettle(this.page, budget(this));
 });
@@ -105,14 +139,21 @@ When(/^(?:I |we )*add section gutters$/, async function () {
  * Example #5: When we select the "Edge to Edge" container type
  */
 When(/^(?:I |we )*select the "([^"]*)" container type(?: with a "([^"]*)" width)?$/, async function (type, width) {
-  // Real Playwright clicks, not a raw DOM click inside page.evaluate(): the
-  // LB config sidebar's radio labels are wired through Drupal AJAX behaviors,
-  // which a synthetic click can silently fail to trigger (see the identical
-  // issue fixed for "save the section").
+  // A real Playwright click first: the LB config sidebar's radio labels are
+  // wired through Drupal AJAX behaviors, which a synthetic click can silently
+  // fail to trigger (see the identical issue fixed for "save the section").
+  // But on some Bootstrap Styles versions these labels are visually-hidden
+  // colour/type swatches, so the actionability checks time out even though the
+  // label is the right target — fall back to an in-page native click then
+  // (the label's own click handler still fires Drupal's behaviors).
   const clickLabel = async (text, forPrefix) => {
     const lbl = this.page.locator('label').filter({ hasText: text }).and(this.page.locator(`label[for*="${forPrefix}"]`)).first();
     if (!(await lbl.count())) return false;
-    await lbl.click();
+    try {
+      await lbl.click({ timeout: 10000 });
+    } catch (e) {
+      await lbl.evaluate((el) => el.click());
+    }
     return true;
   };
   if (!(await clickLabel(type, 'edit-layout-settings-ui-tab-content-layout-container-type'))) {

package/tests/step-definitions/drupal-media.steps.js

@@ -55,8 +55,32 @@ When(/^(?:I |we )*open the "([^"]*)" media library$/, async function (field) {
   if (!(await btn.count())) {
     throw friendly(`No media library open button for the "${field}" field was found.`);
   }
-  await btn.click({ timeout: 8000 });
-  await smartSettle(this.page, budget(this));
+  const dialog = this.page.locator('.ui-dialog .media-library-view, .media-library-widget-modal').first();
+  const open = async () => {
+    try {
+      await btn.click({ timeout: 8000 });
+    } catch (e) {
+      // A stale jQuery UI overlay (ui-widget-overlay) from a previous dialog can
+      // intercept pointer events over a correctly-resolved button. The button is
+      // right - dispatch the click in-page so Drupal's AJAX handler still fires.
+      await btn.evaluate((el) => el.click());
+    }
+    await smartSettle(this.page, budget(this));
+  };
+  await open();
+  // The dialog can be torn down by a previous dialog's late close animation
+  // (two stacked jQuery UI dialogs) - verify it is really there, and re-open
+  // once when it is not, before letting the next step run against nothing.
+  try {
+    await dialog.waitFor({ state: 'visible', timeout: 10000 });
+  } catch (e) {
+    await open();
+    try {
+      await dialog.waitFor({ state: 'visible', timeout: 10000 });
+    } catch (e2) {
+      throw friendly(`The media library dialog for "${field}" did not open.`);
+    }
+  }
 });
 
 /**