@serenity-js/webdriverio-8 3.36.2 → 3.37.0

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.37.0](https://github.com/serenity-js/serenity-js/compare/v3.36.2...v3.37.0) (2025-12-02)
+
+**Note:** Version bump only for package @serenity-js/webdriverio-8
+
+
+
+
+
 ## [3.36.2](https://github.com/serenity-js/serenity-js/compare/v3.36.1...v3.36.2) (2025-11-26)
 
 **Note:** Version bump only for package @serenity-js/webdriverio-8

package/README.md

@@ -1,9 +1,16 @@
-# Serenity/JS with WebdriverIO 8 🚀
+# Serenity/JS WebdriverIO
+
+[![NPM Version](https://badge.fury.io/js/%40serenity-js%2Fwebdriverio-8.svg)](https://badge.fury.io/js/%40serenity-js%2Fwebdriverio-8)
+[![Build Status](https://github.com/serenity-js/serenity-js/actions/workflows/main.yaml/badge.svg?branch=main)](https://github.com/serenity-js/serenity-js/actions)
+[![Maintainability](https://qlty.sh/gh/serenity-js/projects/serenity-js/maintainability.svg)](https://qlty.sh/gh/serenity-js/projects/serenity-js)
+[![Code Coverage](https://qlty.sh/gh/serenity-js/projects/serenity-js/coverage.svg)](https://qlty.sh/gh/serenity-js/projects/serenity-js)
+[![Contributors](https://img.shields.io/github/contributors/serenity-js/serenity-js.svg)](https://github.com/serenity-js/serenity-js/graphs/contributors)
+[![Known Vulnerabilities](https://snyk.io/test/npm/@serenity-js/webdriverio-8/badge.svg)](https://snyk.io/test/npm/@serenity-js/webdriverio-8)
+[![GitHub stars](https://img.shields.io/github/stars/serenity-js/serenity-js?style=flat)](https://github.com/serenity-js/serenity-js)
 
 [![Follow Serenity/JS on LinkedIn](https://img.shields.io/badge/Follow-Serenity%2FJS%20-0077B5?logo=linkedin)](https://www.linkedin.com/company/serenity-js)
 [![Watch Serenity/JS on YouTube](https://img.shields.io/badge/Watch-@serenity--js-E62117?logo=youtube)](https://www.youtube.com/@serenity-js)
 [![Join Serenity/JS Community Chat](https://img.shields.io/badge/Chat-Serenity%2FJS%20Community-FBD30B?logo=matrix)](https://matrix.to/#/#serenity-js:gitter.im)
-[![GitHub stars](https://img.shields.io/github/stars/serenity-js/serenity-js?label=Serenity%2FJS&logo=github&style=badge)](https://github.com/serenity-js/serenity-js)
 [![Support Serenity/JS on GitHub](https://img.shields.io/badge/Support-@serenity--js-703EC8?logo=github)](https://github.com/sponsors/serenity-js)
 
 [Serenity/JS](https://serenity-js.org) revolutionises automated testing by enabling your team to write **expressive**, **maintainable tests** that align
@@ -17,16 +24,16 @@ helping both technical teams and business stakeholders understand the quality of
 Serenity/JS WebdriverIO 8 module is intended for existing projects that can't yet upgrade to WebdriverIO 9. 
 If you're starting a new project, we recommend using the [Serenity/JS WebdriverIO module](https://serenity-js.org/api/webdriverio/).
 
-## 🚀 Why choose Serenity/JS?
+## Features
 
 - Write **expressive**, **maintainable** tests that align with your unique domain using the [**Serenity/JS Screenplay Pattern**](https://serenity-js.org/handbook/design/screenplay-pattern) APIs.
 - **Leverage advanced reporting** to track progress, detect failures, and share results with both technical and business stakeholders.
 - Build on flexible, modular, and extensible architecture that supports a wide range of test automation needs.
 - Integrate with WebdriverIO 8 and modern test automation tools.
 
-## 🛠️ Integrate WebdriverIO 8 with Serenity/JS in 4 steps
+## Quick Start
 
-### 1. Installing Serenity/JS modules
+### Installation
 
 To add Serenity/JS to an existing WebdriverIO 8 project, install the following Serenity/JS modules from NPM:
 
@@ -45,7 +52,7 @@ Learn more about Serenity/JS modules:
 
 If you prefer to review a reference implementation first, clone a [Serenity/JS Project Template](https://serenity-js.org/handbook/project-templates/) for your preferred test runner.
 
-### 2. Configuring Serenity/JS
+### Configuring Serenity/JS
 
 To enable integration with Serenity/JS, configure WebdriverIO as follows:
 
@@ -128,7 +135,7 @@ Learn more about:
 - [Serenity/JS Mocha configuration options](https://serenity-js.org/api/mocha-adapter/interface/MochaConfig/)
 - [WebdriverIO configuration file](https://webdriver.io/docs/configurationfile/)
 
-### 3. Generating Serenity BDD reports and living documentation 
+### Reporting 
 
 [Serenity BDD reports and living documentation](https://serenity-bdd.github.io/docs/reporting/the_serenity_reports) are generated by [Serenity BDD CLI](https://github.com/serenity-bdd/serenity-core/tree/main/serenity-cli),
 a Java program provided by the [`@serenity-js/serenity-bdd`](https://serenity-js.org/api/serenity-bdd/) module.
@@ -158,7 +165,7 @@ To learn more about the `SerenityBDDReporter`, please consult:
 - configuration examples in [`SerenityBDDReporter` API docs](https://serenity-js.org/api/serenity-bdd/class/SerenityBDDReporter/),
 - [Serenity/JS examples on GitHub](https://github.com/serenity-js/serenity-js/tree/main/examples).
 
-### 4. Writing a test scenario
+### Writing a test scenario
 
 Assuming you're using WebdriverIO 8 with Mocha, create a test file under `./test/specs/example.spec.ts` with the following contents:
 
@@ -197,7 +204,7 @@ allowing you to switch to `@serenity-js/webdriverio` whenever you're ready to up
 You can learn more about these and other Serenity/JS modules in the [Serenity/JS API documentation](https://serenity-js.org/api/).
 You might also want to check out the [Serenity/JS WebdriverIO integration guide](https://serenity-js.org/handbook/test-runners/webdriverio/) for more details on configuring your framework.
 
-### 4. Running your tests and generating reports
+### Running your tests and generating reports
 
 To run your tests and generate Serenity/JS reports, execute the following command in your terminal:
 
@@ -208,27 +215,39 @@ npm test
 Your test results will be available in the `target/site/serenity` directory.
 To view them, open the `index.html` file in your preferred web browser.
 
-## 💡️ Learn Serenity/JS
+## Documentation
+
+- [API Reference](https://serenity-js.org/api/)
+- [Screenplay Pattern Guide](https://serenity-js.org/handbook/design/screenplay-pattern/)
+- [Serenity/JS Project Templates](https://serenity-js.org/handbook/project-templates/)
+- [More examples and reference implementations](https://github.com/serenity-js/serenity-js/tree/main/examples)
+- [Tutorial: First Web Scenario](https://serenity-js.org/handbook/tutorials/your-first-web-scenario/)
+- [Tutorial: First API Scenario](https://serenity-js.org/handbook/tutorials/your-first-api-scenario/)
+
+## Contributing
+
+Contributions of all kinds are welcome! Get started with the [Contributing Guide](https://serenity-js.org/community/contributing/).
+
+## Community
+
+- [Community Chat](https://matrix.to/#/#serenity-js:gitter.im)
+- [Discussions Forum](https://github.com/orgs/serenity-js/discussions)
+    - Visit the [💡How to... ?](https://github.com/orgs/serenity-js/discussions/categories/how-to) section for answers to common questions
 
-- [Serenity/JS WebdriverIO integration guide](https://serenity-js.org/handbook/test-runners/webdriverio/) - Integrate Serenity/JS with your WebdriverIO test suite, enable Serenity BDD reports, and start using the Screenplay Pattern
-- [Serenity/JS Handbook](https://serenity-js.org/handbook/) - Write high-quality automated acceptance tests with Serenity/JS
-- [Serenity/JS API documentation](https://serenity-js.org/api/) - Explore Serenity/JS modules and features
-- [Serenity/JS Project Templates](https://serenity-js.org/handbook/project-templates/) - Kickstart your projects with best practices built right in
+If you enjoy using Serenity/JS, make sure to star ⭐️ [Serenity/JS on GitHub](https://github.com/serenity-js/serenity-js) to help others discover the framework!
 
-## 👋 Join the Serenity/JS Community
+## License
 
-- [Serenity/JS Community chat channel](https://matrix.to/#/#serenity-js:gitter.im) - Meet Serenity/JS developers and maintainers
-- [Serenity/JS Forum](https://github.com/orgs/serenity-js/discussions/categories/how-to) - Find answers to your Serenity/JS questions
-- [Contribute to Serenity/JS](https://serenity-js.org/community/contributing/) - Learn how to propose features, report bugs, and contribute to the Serenity/JS codebase
+The Serenity/JS code base is licensed under the [Apache-2.0](https://opensource.org/license/apache-2-0) license,
+while its documentation and the [Serenity/JS Handbook](https://serenity-js.org/handbook/) are licensed under the [Creative Commons BY-NC-SA 4.0 International](https://creativecommons.org/licenses/by-nc-sa/4.0/).
 
-## 📣 Stay up to date
+See the [Serenity/JS License](https://serenity-js.org/legal/license/).
 
-- [Serenity/JS on YouTube](https://www.youtube.com/@serenity-js) - Subscribe for tutorials, demos, conference talks, and more
-- [Serenity/JS on LinkedIn](https://www.linkedin.com/company/serenity-js) - Follow for release and community event announcements
-- [Serenity/JS on GitHub](https://github.com/serenity-js/serenity-js) - Star Serenity/JS to help others discover the framework!
+## Support
 
-## 💛 Support Serenity/JS
+Support ongoing development through [GitHub Sponsors](https://github.com/sponsors/serenity-js). Sponsors gain access to [Serenity/JS Playbooks](https://github.com/serenity-js/playbooks)
+and priority help in the [Discussions Forum](https://github.com/orgs/serenity-js/discussions).
 
-Support our mission to make test automation collaborative and easier to scale. Become a Serenity/JS GitHub Sponsor today!
+For corporate sponsorship or commercial support, please contact [Jan Molak](https://www.linkedin.com/in/janmolak/).
 
-[![GitHub Sponsors](https://img.shields.io/badge/Sponsor%20@serenity%2FJS-703EC8?style=for-the-badge&logo=github&logoColor=white)](https://github.com/sponsors/serenity-js)
+[![GitHub Sponsors](https://img.shields.io/badge/Support%20@serenity%2FJS-703EC8?style=for-the-badge&logo=github&logoColor=white)](https://github.com/sponsors/serenity-js).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serenity-js/webdriverio-8",
-  "version": "3.36.2",
+  "version": "3.37.0",
   "description": "Adapter that integrates @serenity-js/web with WebdriverIO 8, enabling Serenity/JS reporting and using the Screenplay Pattern to write web and mobile test scenarios",
   "author": {
     "name": "Jan Molak",
@@ -74,9 +74,9 @@
     "node": "^20 || ^22 || ^24"
   },
   "dependencies": {
-    "@serenity-js/core": "3.36.2",
-    "@serenity-js/rest": "3.36.2",
-    "@serenity-js/web": "3.36.2",
+    "@serenity-js/core": "3.37.0",
+    "@serenity-js/rest": "3.37.0",
+    "@serenity-js/web": "3.37.0",
     "@wdio/reporter": "8.43.0",
     "deepmerge": "4.3.1",
     "tiny-types": "1.24.3"
@@ -118,5 +118,5 @@
     "start-server-and-test": "2.1.3",
     "webdriverio": "8.46.0"
   },
-  "gitHead": "bce71a2454b8c6e2639bc351cc84f47c0c8cbb0a"
+  "gitHead": "dae146cd99a04f09b5926fb9d3205af562fa2927"
 }