Merge branch '4.x' into feature/5425-ai-trace-plugin

Author: DavertMik

.github/workflows/publish-beta.yml

@@ -0,0 +1,37 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    if: ${{ github.event.release.prerelease || contains(github.event.release.tag_name, 'alpha') || contains(github.event.release.tag_name, 'beta') || contains(github.event.release.tag_name, 'rc') }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.target_commitish }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm install -g npm@latest
+
+      - run: npm ci
+
+      - name: Set package version
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          VERSION="${TAG#v}"
+          npm version "$VERSION" --no-git-tag-version
+
+      - name: Publish to npm
+        run: npm publish --provenance --tag beta

README.md

@@ -233,127 +233,61 @@ Scenario('test title', () => {
 })
 ```
 
-## HTML Reporter
+## HTML Reports
 
-CodeceptJS includes a powerful built-in HTML Reporter that generates comprehensive, interactive test reports with detailed information about your test runs. The HTML reporter is **enabled by default** for all new projects and provides:
+Generate beautiful HTML reports using **[@testomatio/reporter](https://github.com/testomatio/reporter)** package.
 
-### Features
-
-- **Interactive Dashboard**: Visual statistics, pie charts, and expandable test details
-- **Step-by-Step Execution**: Shows individual test steps with timing and status indicators
-- **BDD/Gherkin Support**: Full support for feature files with proper scenario formatting
-- **System Information**: Comprehensive environment details including browser versions
-- **Advanced Filtering**: Real-time filtering by status, tags, features, and test types
-- **History Tracking**: Multi-run history with trend visualization
-- **Error Details**: Clean formatting of error messages and stack traces
-- **Artifacts Support**: Display screenshots and other test artifacts
-
-### Visual Examples
-
-#### Interactive Test Dashboard
-
-The main dashboard provides a complete overview with interactive statistics and pie charts:
-
-![HTML Reporter Dashboard](docs/shared/html-reporter-main-dashboard.png)
-
-#### Detailed Test Results
-
-Each test shows comprehensive execution details with expandable step information:
-
-![HTML Reporter Test Details](docs/shared/html-reporter-test-details.png)
+### Installation
 
-#### Advanced Filtering Capabilities
-
-Real-time filtering allows quick navigation through test results:
-
-![HTML Reporter Filtering](docs/shared/html-reporter-filtering.png)
+```sh
+npm install @testomatio/reporter --save-dev
+```
 
-#### BDD/Gherkin Support
+### Configuration
 
-Full support for Gherkin scenarios with proper feature formatting:
+Add the `testomatio` plugin to your `codecept.conf.js`:
 
-![HTML Reporter BDD Details](docs/shared/html-reporter-bdd-details.png)
+```js
+plugins: {
+  testomatio: {
+    enabled: true,
+    require: '@testomatio/reporter/lib/adapter/codecept',
+  },
+}
+```
 
-The HTML reporter generates self-contained reports that can be easily shared with your team. Learn more about configuration and features in the [HTML Reporter documentation](https://codecept.io/plugins/#htmlreporter).
+### Usage
 
-## MCP Server
+Generate HTML reports by setting the `TESTOMATIO_HTML_REPORT_SAVE` environment variable:
 
-CodeceptJS includes a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that enables AI agents (like Claude, ChatGPT) to interact with and control your tests programmatically. This allows AI to:
+```sh
+TESTOMATIO_HTML_REPORT_SAVE=1 npx codeceptjs run
+```
 
-- **List all tests** in your project
-- **List all available actions** (I.* methods) from enabled helpers
-- **Run arbitrary CodeceptJS code** and capture artifacts (ARIA snapshots, screenshots, HTML, logs)
-- **Run specific tests** with AI-friendly trace files generated by the aiTrace plugin
-- **Run tests step by step** for detailed debugging and analysis
-- **Control browser sessions** (start/stop)
+The report will be saved to `html-report/testomatio-report.html`.
 
 ### Features
 
-- **AI-Friendly Trace Files**: When enabled, the aiTrace plugin generates comprehensive trace files with screenshots, HTML, ARIA snapshots, browser logs, and HTTP requests
-- **Real-time Monitoring**: Get trace file URLs at the start of test execution so AI can monitor tests in real-time
-- **Artifact Capture**: Automatically capture ARIA snapshots, page source, console logs, and more
-- **Browser Management**: Automatic or manual browser lifecycle control
-- **Timeout Control**: Configurable timeouts for all operations
+- Modern, responsive interface with real-time statistics
+- Detailed test information with step-by-step breakdown
+- Screenshots, videos, and artifacts display
+- BDD/Gherkin support with proper scenario formatting
+- Customizable output location and filename
+- Optional integration with [Testomat.io](https://testomat.io) cloud
 
-### Quick Start
+### Customization
 
-1. Install the MCP SDK:
 ```sh
-npm install @modelcontextprotocol/sdk
-```
-
-2. Configure your MCP client (e.g., Claude Desktop):
-```json
-{
-  "mcpServers": {
-    "codeceptjs": {
-      "command": "node",
-      "args": ["path/to/codeceptjs/bin/mcp-server.js"]
-    }
-  }
-}
-```
-
-3. Enable the aiTrace plugin in `codecept.conf.js`:
-```javascript
-plugins: {
-  aiTrace: {
-    enabled: true
-  }
-}
-```
+# Custom output folder
+TESTOMATIO_HTML_REPORT_SAVE=1 TESTOMATIO_HTML_REPORT_FOLDER=./reports npx codeceptjs run
 
-### Usage Examples
+# Custom filename
+TESTOMATIO_HTML_REPORT_SAVE=1 TESTOMATIO_HTML_FILENAME=my-report.html npx codeceptjs run
 
-**List all tests:**
-```json
-{
-  "name": "list_tests"
-}
-```
-
-**Run CodeceptJS code:**
-```json
-{
-  "name": "run_code",
-  "arguments": {
-    "code": "await I.amOnPage('/'); await I.see('Welcome')"
-  }
-}
+# Integrate with Testomat.io cloud
+TESTOMATIO_HTML_REPORT_SAVE=1 TESTOMATIO=your_api_key npx codeceptjs run
 ```
 
-**Run a test with trace:**
-```json
-{
-  "name": "run_test",
-  "arguments": {
-    "test": "tests/login_test.js"
-  }
-}
-```
-
-Learn more about the MCP Server in the [MCP documentation](https://github.com/codeceptjs/CodeceptJS/blob/main/docs/mcp.md).
-
 ## PageObjects
 
 CodeceptJS provides the most simple way to create and use page objects in your test.

docs/helpers/Appium.md

@@ -960,13 +960,17 @@ Returns **void** automatically synchronized promise through #recorder
 
 Opposite to `seeElement`. Checks that element is not visible (or in DOM)
 
+The second parameter is a context (CSS or XPath locator) to narrow the search.
+
 ```js
 I.dontSeeElement('.modal'); // modal is not shown
+I.dontSeeElement('.modal', '#container');
 ```
 
 #### Parameters
 
 *   `locator` **([string][5] | [object][11])** located by CSS|XPath|Strict locator.
+*   `context` **([string][5]? | [object][11])** (optional, `null` by default) element located by CSS | XPath | strict locator. (optional, default `null`)
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1009,6 +1013,8 @@ Returns **void** automatically synchronized promise through #recorder
 Fills a text field or textarea, after clearing its value, with the given string.
 Field is located by name, label, CSS, or XPath.
 
+The third parameter is a context (CSS or XPath locator) to narrow the search.
+
 ```js
 // by label
 I.fillField('Email', 'hello@world.com');
@@ -1018,12 +1024,15 @@ I.fillField('password', secret('123456'));
 I.fillField('form#login input[name=username]', 'John');
 // or by strict locator
 I.fillField({css: 'form#login input[name=username]'}, 'John');
+// within a context
+I.fillField('Name', 'John', '#section2');
 ```
 
 #### Parameters
 
 *   `field` **([string][5] | [object][11])** located by label|name|CSS|XPath|strict locator.
 *   `value` **([string][5] | [object][11])** text value to fill.
+*   `context` **([string][5]? | [object][11])** (optional, `null` by default) element located by CSS | XPath | strict locator. (optional, default `null`)
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1194,13 +1203,17 @@ Returns **void** automatically synchronized promise through #recorder
 Checks that a given Element is visible
 Element is located by CSS or XPath.
 
+The second parameter is a context (CSS or XPath locator) to narrow the search.
+
 ```js
 I.seeElement('#modal');
+I.seeElement('#modal', '#container');
 ```
 
 #### Parameters
 
 *   `locator` **([string][5] | [object][11])** located by CSS|XPath|strict locator.
+*   `context` **([string][5]? | [object][11])** (optional, `null` by default) element located by CSS | XPath | strict locator. (optional, default `null`)
 
 Returns **void** automatically synchronized promise through #recorder
 
@@ -1247,13 +1260,17 @@ Selects an option in a drop-down select.
 Field is searched by label | name | CSS | XPath.
 Option is selected by visible text or by value.
 
+The third parameter is a context (CSS or XPath locator) to narrow the search.
+
 ```js
 I.selectOption('Choose Plan', 'Monthly'); // select by label
 I.selectOption('subscription', 'Monthly'); // match option by text
 I.selectOption('subscription', '0'); // or by value
 I.selectOption('//form/select[@name=account]','Premium');
 I.selectOption('form select[name=account]', 'Premium');
 I.selectOption({css: 'form select[name=account]'}, 'Premium');
+// within a context
+I.selectOption('age', '21-60', '#section2');
 ```
 
 Provide an array for the second argument to select multiple options.
@@ -1266,6 +1283,7 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
 
 *   `select` **([string][5] | [object][11])** field located by label|name|CSS|XPath|strict locator.
 *   `option` **([string][5] | [Array][8]\<any>)** visible text or value of option.
+*   `context` **([string][5]? | [object][11])** (optional, `null` by default) element located by CSS | XPath | strict locator. (optional, default `null`)
 
 Returns **void** automatically synchronized promise through #recorderSupported only for web testing