@vardot/varbase-e2e 2.0.2 → 2.0.4

package/.playwright-mcp/page-2026-09-07T08-42-33-250Z.yml

@@ -0,0 +1,287 @@
+- generic [active] [ref=f3e1]:
+  - link "Skip to main content" [ref=f3e2] [cursor=pointer]:
+    - /url: "#main-content"
+  - generic [ref=f3e4]:
+    - banner [ref=f3e5]:
+      - generic [ref=f3e11]:
+        - link [ref=f3e14] [cursor=pointer]:
+          - /url: /
+          - img "Horizon Aid Client Demo 1 logo" [ref=f3e15]
+        - generic [ref=f3e17]:
+          - navigation [ref=f3e20]:
+            - list [ref=f3e22]:
+              - listitem [ref=f3e23]:
+                - link "About" [ref=f3e24] [cursor=pointer]:
+                  - /url: /about
+              - listitem [ref=f3e25]:
+                - link "Resources" [ref=f3e26] [cursor=pointer]:
+                  - /url: /resources
+              - listitem [ref=f3e27]:
+                - link "Programs" [ref=f3e28] [cursor=pointer]:
+                  - /url: /programs
+              - listitem [ref=f3e29]:
+                - link "Countries" [ref=f3e30] [cursor=pointer]:
+                  - /url: /countries
+              - listitem [ref=f3e31]:
+                - link "Events" [ref=f3e32] [cursor=pointer]:
+                  - /url: /events
+              - listitem [ref=f3e33]:
+                - link "Donate" [ref=f3e34] [cursor=pointer]:
+                  - /url: /donate
+          - generic [ref=f3e35]:
+            - button "Search" [ref=f3e36] [cursor=pointer]:
+              - generic [ref=f3e37]: 
+            - text:  
+    - main [ref=f3e38]:
+      - generic [ref=f3e41]:
+        - generic [ref=f3e42]:
+          - figure [ref=f3e44]:
+            - img "Home Page Header Banner" [ref=f3e47]
+          - generic [ref=f3e48]:
+            - heading "Focus Forward" [level=1] [ref=f3e49]
+            - paragraph [ref=f3e51]: Empowering local communities to defend human rights and rebuild together.
+            - link "Donate Today" [ref=f3e53] [cursor=pointer]:
+              - /url: /donate
+        - generic [ref=f3e60]:
+          - heading "Delivering life-saving aid and sustainable development to communities in crisis." [level=2] [ref=f3e61]
+          - link "Learn About Our Role" [ref=f3e64] [cursor=pointer]:
+            - /url: /about
+        - generic [ref=f3e69]:
+          - generic [ref=f3e75]:
+            - generic [ref=f3e76]:
+              - heading "Global Impact" [level=2] [ref=f3e77]
+              - paragraph [ref=f3e79]: We believe in absolute transparency. Through partnerships and direct community funding, we track every dollar to ensure your support creates immediate, sustainable protection for human rights worldwide.
+            - link "Explore Our Impact" [ref=f3e81] [cursor=pointer]:
+              - /url: /countries
+          - generic [ref=f3e83]:
+            - generic [ref=f3e85]:
+              - generic [ref=f3e86]: 0K+
+              - paragraph [ref=f3e87]: Lives Protected
+            - generic [ref=f3e89]:
+              - generic [ref=f3e90]: 0K+
+              - paragraph [ref=f3e91]: Legal Aid Hours
+            - generic [ref=f3e93]:
+              - generic [ref=f3e94]: 0K+
+              - paragraph [ref=f3e95]: Communities Served
+        - generic [ref=f3e101]:
+          - heading "Explore Our Programs" [level=2] [ref=f3e102]
+          - generic [ref=f3e106]:
+            - tablist [ref=f3e107]:
+              - tab "Education" [selected] [ref=f3e108] [cursor=pointer]
+              - tab "Women" [ref=f3e109] [cursor=pointer]
+              - tab "Agriculture" [ref=f3e110] [cursor=pointer]
+              - tab "Medicine" [ref=f3e111] [cursor=pointer]
+              - tab "Health" [ref=f3e112] [cursor=pointer]
+            - tabpanel [ref=f3e114]:
+              - generic [ref=f3e115]:
+                - figure [ref=f3e117]:
+                  - img "Children sitting together outside tents in a camp" [ref=f3e120]
+                - generic [ref=f3e121]:
+                  - heading "Education" [level=3] [ref=f3e122]
+                  - paragraph [ref=f3e123]: Building safe schools and training local teachers to give children a clear path to a brighter future.
+                  - link "Learn More" [ref=f3e124] [cursor=pointer]:
+                    - /url: /programs/education
+        - generic [ref=f3e139]:
+          - generic [ref=f3e140]:
+            - heading "Where We Work" [level=2] [ref=f3e141]
+            - generic [ref=f3e142]: We work where displacement, conflict and climate pressure hit hardest. Each country page sets out our role, the work on the ground, the figures behind it and the partners we work with.
+          - generic [ref=f3e143]:
+            - generic [ref=f3e144]:
+              - figure [ref=f3e146]:
+                - img "Girls in a classroom in Afghanistan" [ref=f3e148]
+              - generic [ref=f3e149]:
+                - generic [ref=f3e150]:
+                  - heading "Afghanistan" [level=3] [ref=f3e151]
+                  - generic [ref=f3e152]: One of the most complex humanitarian contexts in the world. We have worked alongside Afghan communities through displacement, conflict and recovery for over a decade.
+                - link "View Country" [ref=f3e154] [cursor=pointer]:
+                  - /url: /countries/afghanistan
+            - generic [ref=f3e155]:
+              - figure [ref=f3e157]:
+                - img "Bangladesh country programme" [ref=f3e159]
+              - generic [ref=f3e160]:
+                - generic [ref=f3e161]:
+                  - heading "Bangladesh" [level=3] [ref=f3e162]
+                  - generic [ref=f3e163]: Shelter, water and sanitation support in dense displacement settlements exposed to cyclones and monsoon flooding.
+                - link "View Country" [ref=f3e165] [cursor=pointer]:
+                  - /url: /countries/bangladesh
+            - generic [ref=f3e166]:
+              - figure [ref=f3e168]:
+                - img "Colombia country programme" [ref=f3e170]
+              - generic [ref=f3e171]:
+                - generic [ref=f3e172]:
+                  - heading "Colombia" [level=3] [ref=f3e173]
+                  - generic [ref=f3e174]: Legal aid, documentation and integration support for migrant and host communities along the migration corridor.
+                - link "View Country" [ref=f3e176] [cursor=pointer]:
+                  - /url: /countries/colombia
+            - generic [ref=f3e177]:
+              - figure [ref=f3e179]:
+                - img "Ecuador country programme" [ref=f3e181]
+              - generic [ref=f3e182]:
+                - generic [ref=f3e183]:
+                  - heading "Ecuador" [level=3] [ref=f3e184]
+                  - generic [ref=f3e185]: Emergency legal aid and protection services for migrant families moving through major border corridors.
+                - link "View Country" [ref=f3e187] [cursor=pointer]:
+                  - /url: /countries/ecuador
+          - generic [ref=f3e188]:
+            - link "View All Countries" [ref=f3e189] [cursor=pointer]:
+              - /url: /countries
+            - generic [ref=f3e191]:
+              - button "Previous" [disabled]
+              - button "Next" [disabled]
+        - generic [ref=f3e197]:
+          - heading "Collaborating With Partners to Drive Community Impact" [level=2] [ref=f3e205]
+          - generic [ref=f3e206]:
+            - figure [ref=f3e208]:
+              - img "Invert Partner" [ref=f3e210]
+            - figure [ref=f3e212]:
+              - img "Cloud Partner" [ref=f3e214]
+            - figure [ref=f3e216]:
+              - img "Minty Partner" [ref=f3e218]
+            - figure [ref=f3e220]:
+              - img "Greenish Partner" [ref=f3e222]
+            - figure [ref=f3e224]:
+              - img "Vision Partner" [ref=f3e226]
+        - generic [ref=f3e230]:
+          - heading "Upcoming Events" [level=2] [ref=f3e232]
+          - generic [ref=f3e240]:
+            - generic [ref=f3e242]:
+              - generic [ref=f3e243]:
+                - generic [ref=f3e244]: Webinar
+                - generic [ref=f3e246]:
+                  - heading "Digital security for advocacy groups" [level=3] [ref=f3e247]
+                  - generic [ref=f3e248]: Learn how to protect field communications, secure donor data, and defend your organisation against cyber threats in high-risk environments.
+              - generic [ref=f3e249]:
+                - paragraph [ref=f3e250]: 12 Jun – 30 Jul
+                - paragraph [ref=f3e251]: 11:00 - 14:30 +03
+              - link "Digital security for advocacy groups Learn how to protect field communications, secure donor data, and defend your organisation against cyber threats in high-risk environments.":
+                - /url: /events/digital-security-advocacy-groups
+            - generic [ref=f3e253]:
+              - generic [ref=f3e254]:
+                - generic [ref=f3e255]: In-person
+                - generic [ref=f3e257]:
+                  - heading "Global refugee policy briefing" [level=3] [ref=f3e258]
+                  - generic [ref=f3e259]: Senior legal advisors present new frameworks on asylum rights and cross-border protection standards.
+              - generic [ref=f3e260]:
+                - paragraph [ref=f3e261]: 17 Jun
+                - paragraph [ref=f3e262]: 11:00 - 14:30 +03
+              - link "Global refugee policy briefing Senior legal advisors present new frameworks on asylum rights and cross-border protection standards.":
+                - /url: /events/global-refugee-policy-briefing
+            - generic [ref=f3e264]:
+              - generic [ref=f3e265]:
+                - generic [ref=f3e266]: Summit
+                - generic [ref=f3e268]:
+                  - heading "Grassroots leadership summit" [level=3] [ref=f3e269]
+                  - generic [ref=f3e270]: A two-day convening for community leaders working in displacement and humanitarian response.
+              - generic [ref=f3e271]:
+                - paragraph [ref=f3e272]: 28 Jun – 29 Jun
+                - paragraph [ref=f3e273]: 11:00 - 14:30 +03
+              - link "Grassroots leadership summit A two-day convening for community leaders working in displacement and humanitarian response.":
+                - /url: /events/grassroots-leadership-summit
+          - link "See All Events" [ref=f3e275] [cursor=pointer]:
+            - /url: /events
+        - generic [ref=f3e284]:
+          - generic [ref=f3e285]:
+            - heading "Latest Updates" [level=2] [ref=f3e286]
+            - list [ref=f3e287]:
+              - listitem [ref=f3e288]:
+                - link "Healthcare & Medicine" [ref=f3e289] [cursor=pointer]:
+                  - /url: /resources
+              - listitem [ref=f3e290]:
+                - link "Sustenance & Growth" [ref=f3e291] [cursor=pointer]:
+                  - /url: /resources
+              - listitem [ref=f3e292]:
+                - link "Universal Education" [ref=f3e293] [cursor=pointer]:
+                  - /url: /resources
+            - link "Explore More" [ref=f3e294] [cursor=pointer]:
+              - /url: /resources
+          - generic [ref=f3e296]:
+            - generic [ref=f3e297]:
+              - generic [ref=f3e298]:
+                - generic [ref=f3e299]:
+                  - figure [ref=f3e300]:
+                    - img "Two people walking through irrigated fields at first light" [ref=f3e303]
+                  - generic "Report" [ref=f3e305]
+                - generic [ref=f3e307]:
+                  - heading "Cultivating independence in rural farms" [level=3] [ref=f3e308]
+                  - time [ref=f3e309]:
+                    - generic [ref=f3e310]: Aug 19, 2026
+                  - generic [ref=f3e311]: Cooperatives using climate-resilient tools secured steady yields for a second consecutive season.
+                - link "Cultivating independence in rural farms Aug 19, 2026 Cooperatives using climate-resilient tools secured steady yields for a second consecutive season.":
+                  - /url: /resources/cultivating-independence-rural-farms
+              - generic [ref=f3e312]:
+                - generic [ref=f3e313]:
+                  - figure [ref=f3e314]:
+                    - img "An aid worker handing supplies to a man beside a mobile clinic van" [ref=f3e317]
+                  - generic "News" [ref=f3e319]
+                - generic [ref=f3e321]:
+                  - heading "Bridging medical gaps in border corridors" [level=3] [ref=f3e322]
+                  - time [ref=f3e323]:
+                    - generic [ref=f3e324]: Aug 19, 2026
+                  - generic [ref=f3e325]: Mobile health units delivered emergency paediatric care and preventative supplies to more than forty remote settlements this quarter.
+                - link "Bridging medical gaps in border corridors Aug 19, 2026 Mobile health units delivered emergency paediatric care and preventative supplies to more than forty remote settlements this quarter.":
+                  - /url: /resources/bridging-medical-gaps-border-corridors
+              - generic [ref=f3e326]:
+                - generic [ref=f3e327]:
+                  - figure [ref=f3e328]:
+                    - img "An aid worker handing supplies to a man beside a mobile clinic van" [ref=f3e331]
+                  - generic "Report" [ref=f3e333]
+                - generic [ref=f3e335]:
+                  - heading "Border health screening outcomes" [level=3] [ref=f3e336]
+                  - time [ref=f3e337]:
+                    - generic [ref=f3e338]: Aug 19, 2026
+                  - generic [ref=f3e339]: Screening results from four crossings over twelve months.
+                - link "Border health screening outcomes Aug 19, 2026 Screening results from four crossings over twelve months.":
+                  - /url: /resources/border-health-screening-outcomes
+            - generic [ref=f3e340]:
+              - button "Previous" [disabled]
+              - button "Next" [ref=f3e341] [cursor=pointer]
+    - contentinfo [ref=f3e347]:
+      - generic [ref=f3e348]:
+        - generic [ref=f3e355]:
+          - generic [ref=f3e356]:
+            - figure [ref=f3e366]:
+              - img "Horizon Aid" [ref=f3e367]
+            - paragraph [ref=f3e370]: A nonprofit fighting poverty, disease, and inequity around the world.
+            - list [ref=f3e374]:
+              - listitem [ref=f3e375]:
+                - link " Linkedin" [ref=f3e376] [cursor=pointer]:
+                  - /url: https://www.linkedin.com/company/vardot
+              - listitem [ref=f3e377]:
+                - link " Facebook" [ref=f3e378] [cursor=pointer]:
+                  - /url: https://www.facebook.com/vardotters/
+              - listitem [ref=f3e379]:
+                - link " Instagram" [ref=f3e380] [cursor=pointer]:
+                  - /url: https://www.instagram.com/vardotters/
+              - listitem [ref=f3e381]:
+                - link " X-Twitter" [ref=f3e382] [cursor=pointer]:
+                  - /url: https://x.com/Vardot
+          - list [ref=f3e386]:
+            - listitem [ref=f3e387]:
+              - link "Quicklinks":
+                - /url: ""
+              - list [ref=f3e388]:
+                - listitem [ref=f3e389]:
+                  - link "Learn" [ref=f3e390] [cursor=pointer]:
+                    - /url: /resources
+                - listitem [ref=f3e391]:
+                  - link "Explore" [ref=f3e392] [cursor=pointer]:
+                    - /url: /programs
+                - listitem [ref=f3e393]:
+                  - link "Impact" [ref=f3e394] [cursor=pointer]:
+                    - /url: /impact
+                - listitem [ref=f3e395]:
+                  - link "Act" [ref=f3e396] [cursor=pointer]:
+                    - /url: /donate
+          - generic [ref=f3e397]:
+            - heading "Join Our Mission" [level=2] [ref=f3e398]
+            - paragraph [ref=f3e401]: Stay informed about our latest initiatives and how you can help.
+            - button "Subscribe" [ref=f3e403] [cursor=pointer]
+        - generic [ref=f3e409]:
+          - list [ref=f3e413]:
+            - listitem [ref=f3e414]:
+              - link "Terms and Conditions" [ref=f3e415] [cursor=pointer]:
+                - /url: /terms-and-conditions
+            - listitem [ref=f3e416]:
+              - link "My privacy settings" [ref=f3e417] [cursor=pointer]:
+                - /url: ""
+          - paragraph [ref=f3e420]: Copyright © 2026

package/AGENTS.md

@@ -109,7 +109,7 @@ step definitions. Critical takeaways:
 
 ## Source map
 
-Step definitions: `tests/step-definitions/` — 495 steps across 44
+Step definitions: `tests/step-definitions/` — 512 steps across 45
 `*.steps.js` files, all auto-loaded, including the Drupal and Varbase packs
 (`drupal-core`, `drupal-ckeditor`, `drupal-media`, `drupal-moderation`,
 `drupal-layout-builder`, `drupal-paragraphs`, `drupal-canvas`, `varbase`)

package/CLAUDE.md

@@ -266,7 +266,7 @@ Some pairs look similar but cover different domains. NEVER merge:
 
 ## 5. File organisation
 
-495 built-in steps across 44 step files. Cucumber auto-loads every
+512 built-in steps across 45 step files. Cucumber auto-loads every
 `*.steps.js` in `tests/step-definitions/`.
 
 ```
@@ -276,7 +276,7 @@ tests/step-definitions/
 ├── a11y.steps.js           (26)  # axe-core WCAG audits + POUR hygiene probes (axe loaded lazily)
 ├── action.steps.js          (7)  # press / click / follow / attach file (actOrExplain lives here)
 ├── api.steps.js            (22)  # REST long form — base URL, headers, query, body, JSON Pointer
-├── assertion.steps.js      (14)  # see / not see, in row, in element, response, count
+├── assertion.steps.js      (17)  # see / not see, in row, in element, page title, response, HTTP status, count
 ├── auth.steps.js            (3)  # storageState save / restore / clear
 ├── clock.steps.js           (7)  # page.clock — install / advance / pause / set
 ├── cookie.steps.js         (12)  # cookie exists / equals / contains
@@ -293,7 +293,7 @@ tests/step-definitions/
 ├── link.steps.js            (9)  # href / title / target / rel assertions
 ├── metatag.steps.js         (3)  # <meta> description / keywords / OG / Twitter
 ├── modal.steps.js           (9)  # HTML modal visibility / content / interactions
-├── navigation.steps.js     (11)  # anonymous user, homepage, paths, history, URL assertions
+├── navigation.steps.js     (14)  # anonymous user, homepage, paths, history, URL + access assertions
 ├── network.steps.js        (10)  # route stubs / blocks / delays / offline
 ├── path.steps.js            (8)  # URL path / query parameter / fragment
 ├── response.steps.js        (4)  # response header inspection
@@ -310,15 +310,16 @@ tests/step-definitions/
 ├── xml.steps.js            (20)  # XPath equals / contains / count / attr
 ├── drupal-canvas.steps.js  (12)  # Drupal Canvas editor + authoring API (pages, library, patterns, publish)
 ├── drupal-ckeditor.steps.js (4)  # CKEditor 5 body writing, toolbar commands, Linkit dialog
+├── drupal-drimage-improved.steps.js (13) # Drimage Improved: loaded / lazy / sized / webp / noscript / figure / caption / alt / title, selector-free
 ├── drupal-core.steps.js    (27)  # Drupal core: session, rows, operations, breadcrumbs, toolbar, waits
 ├── drupal-layout-builder.steps.js (17) # Layout Builder sections + the form controls that configure them
 ├── drupal-media.steps.js    (4)  # media library open / select / insert / submit dialog
 ├── drupal-moderation.steps.js (3)# moderation sidebar open + shows / does not show
 ├── drupal-paragraphs.steps.js (1)# choose a paragraph component in the add-widget dialog
-├── varbase.steps.js        (14)  # Varbase: users, tour, theme settings, sticky header, a11y checker, warm-up
+├── varbase.steps.js        (12)  # Varbase: users, tour, theme settings, sticky header, a11y checker, warm-up
 └── yaml.steps.js           (38)  # multi-doc, types, numerics, JSON Schema, diff
 
-tests/features/                 # 71 .feature files
+tests/features/                 # 72 .feature files
 tests/selectors/                # 26 JSON presets + _canonical-keys.json
 tests/assets/                   # upload fixtures (pdf, png)
 examples/                       # static HTML fixtures served by `npm start`

package/README.md

@@ -1,3 +1,5 @@
+![Varbase E2E](images/varbase-e2e-logo.svg)
+
 # Varbase E2E
 
 [![Github Actions](https://github.com/Vardot/varbase-e2e/actions/workflows/github-actions.yml/badge.svg?branch=2.0.x)](https://github.com/Vardot/varbase-e2e/actions)

package/docs/04-step-reference.md

@@ -4,7 +4,7 @@ All step definitions ship in `tests/step-definitions/*.steps.js`. Cucumber-js lo
 
 This is a topical reference — the fast lookup when you know roughly what you want.
 
-For the **full catalogue**, with every step's pattern and at least five valid Gherkin examples each, see [`steps/`](steps/README.md): 495 steps across 44 category pages, generated from the step definitions themselves. The Drupal and Varbase packs are documented there and not repeated below.
+For the **full catalogue**, with every step's pattern and at least five valid Gherkin examples each, see [`steps/`](steps/README.md): 508 steps across 45 category pages, generated from the step definitions themselves. The Drupal and Varbase packs are documented there and not repeated below.
 
 ## Navigation
 
@@ -18,6 +18,14 @@ For the **full catalogue**, with every step's pattern and at least five valid Gh
 | `When I move forward one page` | `varbase-e2e.js` |
 | `When I reload the page` | `varbase-e2e.js` |
 
+## Access
+
+| Step | Notes |
+| --- | --- |
+| `Then I am denied access to "/path"` | Refused: 403, 404, an access-denied page, or a log-in redirect. `should be refused` is the same step. |
+| `Then I should be allowed "/path"` | 2xx and no refusal marker. `am granted access to` is the same step. |
+| `Then I should be denied access` | The page already open. `the page should be access restricted` is the same step. |
+
 ## Click & press
 
 | Step | Notes |
@@ -358,9 +366,12 @@ This index lists every public step grouped by source file, with one Gherkin exam
 - *^(the )*"([^"]*)?" element should( not)* contain "([^"]*)?"$*  ·  Example: `Then the "body" element should contain "color:white;"`
 - *^(I |we )*should see (\d+) "([^"]*)" elements?$*  ·  Example: `Then I should see 3 "li" elements`
 - *^(the )*"([^"]*)?" link should contain "([^"]*)?"$*  ·  Example: `Then the "Login" link should contain "/log-in"`
+- *^(the )*page title should( not)* be "([^"]*)?"$*  ·  Example: `Then the page title should be "About Us"`
+- *^(the )*page title should( not)* contain "([^"]*)?"$*  ·  Example: `Then the page title should contain "About"`
 - *^(the )*"([^"]*)?" link should contain "([^"]*)?" by( its)*(?: "([^"]*)?")* (attribute|attr)$*  ·  Example: `Then the "#about-us-id" link should contain "about" by attr`
 - *^(the )*response should( not)* contain "([^"]*)?"$*  ·  Example: `Then the response should contain "Welcome visitor"`
 - *^(the )*response status code should( not)* be (\d+)$*  ·  Example: `Then the response status code should be 200`
+- *^(the )*page should( not)* return HTTP status (\d+)$*  ·  Example: `Then the page should return HTTP status 404`
 
 ### auth.steps.js
 
@@ -570,6 +581,9 @@ This index lists every public step grouped by source file, with one Gherkin exam
 - *^(I |we )*should( not)* be on( the)* (homepage|frontpage)$*  ·  Example: `Then I should be on homepage`
 - *^(I |we )*should( not)* be on( the)* "([^"]*)?"( page)*$*  ·  Example: `Then I should be on "/"`
 - *^(the )*url should( not)* match "([^"]*)?"$*  ·  Example: `Then the url should match "/contact-us.html"`
+- *^(I |we )*(?:am|should be) (?:denied access to|refused) "([^"]*)?"$*  ·  Example: `Then I am denied access to "/admin/config"`
+- *^(I |we )*(?:am|should be) (?:allowed|granted access to) "([^"]*)?"$*  ·  Example: `Then I should be allowed "/admin/content"`
+- *^(?:(?:I |we )*should be denied access|(?:the )*page should be access restricted)$*  ·  Example: `Then I should be denied access`
 
 ### network.steps.js
 

package/docs/README.md

@@ -1,8 +1,10 @@
+![Varbase E2E](../images/varbase-e2e-logo.svg)
+
 # Varbase E2E Documentation
 
 Varbase E2E is a BDD-first browser-automation harness built on Playwright + Cucumber-js. Feature files in plain Gherkin; selectors that survive redesigns; smart waits that never sleep.
 
-**495 built-in steps** across **44 step files**, including the Drupal and Varbase packs. **282 example scenarios / 1,372 step executions** in the bundled suite, all green on chromium.
+**512 built-in steps** across **45 step files**, including the Drupal and Varbase packs. **299 example scenarios / 1,456 step executions** in the bundled suite, all green on chromium.
 
 The full step catalogue — one page per category, generated from the step definitions themselves — is in **[`steps/`](steps/README.md)**.
 
@@ -39,7 +41,7 @@ The full step catalogue — one page per category, generated from the step defin
 | [Install — DDEV](install-varbase-e2e/ddev-varbase-e2e.md) | DDEV-Varbase-E2E variant |
 | [Global settings](global-settings.md) | `cucumber.js` `worldParameters` reference |
 | [Step definitions](step-definitions.md) | Step-definition hub — what a step is, the rules, where the catalogue lives |
-| [Step catalogue](steps/README.md) | All 495 steps, 44 category pages under `steps/`, generated from the source |
+| [Step catalogue](steps/README.md) | All 512 steps, 45 category pages under `steps/`, generated from the source |
 | [API step definitions](api-step-definitions.md) | REST step definitions |
 | [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 |
@@ -79,7 +81,7 @@ varbase-e2e/
 │       ├── a11y.steps.js               (26)   # axe-core audits + WCAG hygiene probes
 │       ├── action.steps.js              (7)   # press / click / follow / attach
 │       ├── api.steps.js                (22)   # REST long form (base URL, headers, query, body, JSON Pointer)
-│       ├── assertion.steps.js          (14)   # see / not see, in row, in element, response, count
+│       ├── assertion.steps.js          (17)   # see / not see, in row, in element, page title, response, HTTP status, count
 │       ├── auth.steps.js                (3)   # save / restore / clear storageState
 │       ├── clock.steps.js               (7)   # install / advance / pause / set system time
 │       ├── cookie.steps.js             (12)   # cookie exists / equals / contains
@@ -96,7 +98,7 @@ varbase-e2e/
 │       ├── link.steps.js                (9)   # href / title / target / rel
 │       ├── metatag.steps.js             (3)   # description / keywords / OG / Twitter
 │       ├── modal.steps.js               (9)   # HTML modal visibility / content / interactions
-│       ├── navigation.steps.js         (11)   # homepage / paths / history / URL assertions
+│       ├── navigation.steps.js         (14)   # homepage / paths / history / URL assertions
 │       ├── network.steps.js            (10)   # route stubs / mocks / delays / offline
 │       ├── path.steps.js                (8)   # URL path / query / fragment
 │       ├── response.steps.js            (4)   # response header inspection
@@ -117,7 +119,8 @@ varbase-e2e/
 │       ├── drupal-media.steps.js        (4)   # media library open / select / insert
 │       ├── drupal-moderation.steps.js   (3)   # moderation sidebar open + assertions
 │       ├── drupal-paragraphs.steps.js   (1)   # choose a paragraph component
-│       ├── varbase.steps.js            (14)   # Varbase users, tour, theme settings, a11y checker
+│       ├── drupal-drimage-improved.steps.js (13) # Drimage Improved: loaded / lazy / sized / webp / noscript / figure / caption / alt / title, no selectors
+│       ├── varbase.steps.js            (12)   # Varbase users, tour, theme settings, a11y checker
 │       ├── xml.steps.js                (20)   # XPath equals / contains / count / attr
 │       └── yaml.steps.js               (38)   # multi-doc + types + numerics + JSON Schema + diff
 ├── examples/                   <— Static HTML fixtures

package/docs/install-varbase-e2e.md

@@ -30,5 +30,3 @@ The page is part of the Varbase E2E 2.0.x documentation section, which includes:
 - Advanced Selectors
 - Assertions
 - Commands
-
-There is also a subsection on "[DDEV Varbase E2E](/docs/varbase-e2e/2.0.x/install-varbase-e2e/ddev-varbase-e2e)" available under the installation guide.

package/docs/steps/README.md

@@ -4,7 +4,7 @@ Every step Varbase E2E ships, one page per category, generated from the step
 definitions themselves — so the phrasing, the pattern and the examples on these
 pages are exactly what the runner matches.
 
-**495 steps across 44 categories.**
+**512 steps across 45 categories.**
 
 Cucumber-js loads every `*.steps.js` under `tests/step-definitions/`
 automatically. You never `require()` a step file from a feature: write the
@@ -37,10 +37,11 @@ Steps for the Drupal and Varbase surfaces the team tests every day — the node
 | Content moderation | 3 | [`drupal-moderation.md`](drupal-moderation.md) |
 | Layout Builder | 17 | [`drupal-layout-builder.md`](drupal-layout-builder.md) |
 | Paragraphs | 1 | [`drupal-paragraphs.md`](drupal-paragraphs.md) |
+| Drimage Improved | 13 | [`drupal-drimage-improved.md`](drupal-drimage-improved.md) |
 | Drupal Canvas | 12 | [`drupal-canvas.md`](drupal-canvas.md) |
-| Varbase | 14 | [`varbase.md`](varbase.md) |
+| Varbase | 12 | [`varbase.md`](varbase.md) |
 
-**82 steps.**
+**95 steps.**
 
 ## User journeys
 
@@ -48,7 +49,7 @@ Driving the browser the way a person does: going somewhere, filling something in
 
 | Category | Steps | Page |
 | --- | --- | --- |
-| Navigation | 11 | [`navigation.md`](navigation.md) |
+| Navigation | 14 | [`navigation.md`](navigation.md) |
 | Actions | 7 | [`action.md`](action.md) |
 | Forms | 13 | [`form.md`](form.md) |
 | Field state | 27 | [`field.md`](field.md) |
@@ -67,7 +68,7 @@ Asserting what the page ended up showing.
 
 | Category | Steps | Page |
 | --- | --- | --- |
-| Assertions | 14 | [`assertion.md`](assertion.md) |
+| Assertions | 17 | [`assertion.md`](assertion.md) |
 | Web-first matchers | 12 | [`web-first.md`](web-first.md) |
 | Element interactions | 19 | [`element.md`](element.md) |
 | Tables | 8 | [`table.md`](table.md) |

package/docs/steps/assertion.md

@@ -1,6 +1,6 @@
 # Assertions steps
 
-14 steps, defined in `tests/step-definitions/assertion.steps.js`.
+17 steps, defined in `tests/step-definitions/assertion.steps.js`.
 
 Cucumber-js loads every `*.steps.js` in that directory automatically — you never `require()` a step file from a feature.
 
@@ -18,8 +18,11 @@ Cucumber-js loads every `*.steps.js` in that directory automatically — you nev
 | 10 | `Then I should see 3 "li" elements` |
 | 11 | `Then the "Login" link should contain "/log-in"` |
 | 12 | `Then the "#about-us-id" link should contain "about" by attr` |
-| 13 | `Then the response should contain "Welcome visitor"` |
-| 14 | `Then the response status code should be 200` |
+| 13 | `Then the page title should be "About Us"` |
+| 14 | `Then the page title should contain "About"` |
+| 15 | `Then the response should contain "Welcome visitor"` |
+| 16 | `Then the response status code should be 200` |
+| 17 | `Then the page should return HTTP status 200` |
 
 ---
 
@@ -280,7 +283,59 @@ And the "aboutUs" link should contain "about" by its "class" attribute
 And the ".contactUs" link should contain "/contact-" by attr
 ```
 
-## 13. Then the response should contain "Welcome visitor"
+## 13. Then the page title should be "About Us"
+
+Assert the page title is, or is not, exactly this text.
+
+The title is `document.title` — the `<title>` element, which is the browser tab text, the bookmark name, the search-result heading and what a screen reader announces first on a new page. On a Drupal site it is the head title pattern, so this is how a test proves the pattern and the token that fills it both work. Compared after trimming, because a title built from a template often carries stray whitespace around the separator.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+/^(the )*page title should( not)* be "([^"]*)?"$/
+```
+
+**Examples**
+
+```gherkin
+Then the page title should be "About Us"
+Then the page title should not be "Access denied"
+And the page title should be "Contact Us | Example"
+When I go to "/blog"
+  Then the page title should be "Blog | Example"
+Then the page title should not be "Page not found | Example"
+```
+
+## 14. Then the page title should contain "About"
+
+Assert the page title contains, or does not contain, this text.
+
+The form to reach for on a real site: the head title carries the site name and a separator the test has no business hardcoding, so assert the part the page owns. Case-sensitive, compared after trimming.
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+/^(the )*page title should( not)* contain "([^"]*)?"$/
+```
+
+**Examples**
+
+```gherkin
+Then the page title should contain "About"
+Then the page title should not contain "Access denied"
+And the page title should contain "Getting Started"
+When I go to "/contact-us"
+  Then the page title should contain "Contact"
+Then the page title should not contain "Untitled"
+```
+
+Related: `I wait until the page title is/contains "..."` in [`wait.md`](wait.md) waits for a title to become something; these two assert what it is now.
+
+## 15. Then the response should contain "Welcome visitor"
 
 Assert that the rendered HTML response contains or does not contain text.
 
@@ -307,10 +362,12 @@ When I am on "/about"
   And the response should not contain "TODO"
 ```
 
-## 14. Then the response status code should be 200
+## 16. Then the response status code should be 200
 
 Assert that the current page's response status is or is not a given code.
 
+Re-requests the current URL **through the browser's own context**, so the check sees what this user sees: the session cookies travel with the request, and redirects are not followed, so a 3xx can actually be asserted.
+
 **Keyword**: `Then`
 
 **Pattern**
@@ -325,4 +382,32 @@ Assert that the current page's response status is or is not a given code.
 Then the response status code should be 200
 And the response status code should not be 404
 Then the response status code should be 301
+When I go to "/no-such-page"
+  Then the response status code should be 404
+Then the response status code should not be 500
 ```
+
+## 17. Then the page should return HTTP status 200
+
+The same assertion as step 16, in the phrasing that reads as a sentence about the page rather than about a response object — one implementation, two phrasings. A test about a 404 page reads better as "the page should return HTTP status 404"; a test about an API call reads better as "the response status code should be 404".
+
+**Keyword**: `Then`
+
+**Pattern**
+
+```js
+/^(the )*page should( not)* return HTTP status (\d+)$/
+```
+
+**Examples**
+
+```gherkin
+Then the page should return HTTP status 200
+Then the page should not return HTTP status 404
+And the page should return HTTP status 403
+When I go to "/no-such-page"
+  Then the page should return HTTP status 404
+Then the page should return HTTP status 301
+```
+
+Note: the status a page returns is not always what it renders. A Drupal site can answer 200 with an access-denied page, or 404 to keep a route unguessable — see the access assertions in [`navigation.md`](navigation.md) for asserting the refusal itself rather than its status.