From 337dc328f0c4c6fb39b0750a05bc984a1b850f89 Mon Sep 17 00:00:00 2001
From: DavertMik <davert@testomat.io>
Date: Wed, 14 Oct 2026 03:53:15 +0300
Subject: [PATCH 1/2] chore: migrate task runner from runok to Bunosh

Bunoshfile.js is now the only task file; runok.cjs and the runok
dependency are removed. npm scripts docs, def and
update-contributor-faces call bunosh.

Fixes Lightpanda docs missing inherited CDPBrowser methods: CI ran
runok.cjs, whose inheritedHelperDocs list lacked Lightpanda.

Bunoshfile fixes:
- restore MockRequest section in docs:external-helpers
- drop extra blank line after generated front matter
- sort helper/plugin file lists (Bun readdir is unordered)

Removes legacy release tasks (release, publishSite, wiki, versioning,
get:commit-log, publish:next-beta-version) and their npm scripts:
releases go through GitHub Releases + publish workflow, and the
website refreshes itself via its own `bunosh docs`.

CI workflows that run def/docs now set up bun. bunosh pinned to ^0.6.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .github/workflows/doc-generation.yml |    2 +
 .github/workflows/dtslint.yml        |    1 +
 .github/workflows/publish-beta.yml   |    1 +
 Bunoshfile.js                        |  161 +--
 docs/helpers/Lightpanda.md           | 1844 +++++++++++++++++++++++++-
 package.json                         |   20 +-
 runok.cjs                            |  763 -----------
 7 files changed, 1862 insertions(+), 930 deletions(-)
 delete mode 100755 runok.cjs

diff --git a/.github/workflows/doc-generation.yml b/.github/workflows/doc-generation.yml
index 7c2acbd11..0c8b799ed 100644
--- a/.github/workflows/doc-generation.yml
+++ b/.github/workflows/doc-generation.yml
@@ -26,6 +26,8 @@ jobs:
         with:
           node-version: ${{ matrix.node-version }}
 
+      - uses: oven-sh/setup-bun@v2
+
       - name: Install Dependencies
         run: npm i --force
 
diff --git a/.github/workflows/dtslint.yml b/.github/workflows/dtslint.yml
index 753de549d..e91612c29 100644
--- a/.github/workflows/dtslint.yml
+++ b/.github/workflows/dtslint.yml
@@ -24,6 +24,7 @@ jobs:
         uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
+      - uses: oven-sh/setup-bun@v2
       - run: npm i --force
         env:
           PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: true
diff --git a/.github/workflows/publish-beta.yml b/.github/workflows/publish-beta.yml
index 743f6d849..b4cdc69c6 100644
--- a/.github/workflows/publish-beta.yml
+++ b/.github/workflows/publish-beta.yml
@@ -22,6 +22,7 @@ jobs:
           node-version: 24
           registry-url: 'https://registry.npmjs.org'
 
+      - uses: oven-sh/setup-bun@v2
       - run: npm install
       - run: npm install -g npm@latest
 
diff --git a/Bunoshfile.js b/Bunoshfile.js
index d29f1df0d..bf1741ddc 100644
--- a/Bunoshfile.js
+++ b/Bunoshfile.js
@@ -1,8 +1,6 @@
 import fs from 'node:fs'
 import path from 'node:path'
-import { execSync } from 'node:child_process'
 import axios from 'axios'
-import semver from 'semver'
 
 const { shell, writeToFile, copyFile, task } = global.bunosh
 const { say, yell } = global.bunosh
@@ -47,7 +45,7 @@ export async function docsPlugins() {
   task.stopOnFailures()
   ensureDir('docs/plugins')
 
-  const files = fs.readdirSync('lib/plugin').filter(f => path.extname(f) === '.js')
+  const files = fs.readdirSync('lib/plugin').filter(f => path.extname(f) === '.js').sort()
 
   const sharedPartials = fs.readdirSync('docs/shared').filter(f => path.extname(f) === '.mustache')
   const sharedPlaceholders = sharedPartials.map(file => `{{ ${path.basename(file, '.mustache')} }}`)
@@ -90,7 +88,6 @@ editLink: false
 sidebar: auto
 title: ${name}
 ---
-
 `
       line.fromFile(pluginMarkDownFile(name))
     })
@@ -140,6 +137,14 @@ export async function docsExternalHelpers() {
     cfg.replace(/string \| object/g, 'LocatorOrString')
   })
 
+  say('Building @codeceptjs/mock-request')
+  helper = 'MockRequest'
+  replaceInFile('node_modules/@codeceptjs/mock-request/index.js', cfg => {
+    cfg.replace(/CodeceptJS.LocatorOrString/g, 'string | object')
+    cfg.replace(/LocatorOrString/g, 'string | object')
+  })
+  await shell`npx documentation build node_modules/@codeceptjs/mock-request/index.js -o ${helperMarkDownFile(helper)} ${documentjsCliArgs}`
+
   await writeToFile(helperMarkDownFile(helper), line => {
     line`---\npermalink: /helpers/${helper}\nsidebar: auto\ntitle: ${helper}\n---\n\n# ${helper}\n\n`
     line.fromFile(helperMarkDownFile(helper))
@@ -170,7 +175,7 @@ export async function docsExternalPlugins() {
  */
 export async function buildLibWithDocs(forTypings = false) {
   task.stopOnFailures()
-  const files = fs.readdirSync('lib/helper').filter(f => path.extname(f) === '.js')
+  const files = fs.readdirSync('lib/helper').filter(f => path.extname(f) === '.js').sort()
   ensureDir('docs/build')
 
   const partials = fs.readdirSync('docs/webapi').filter(f => path.extname(f) === '.mustache')
@@ -229,7 +234,7 @@ export async function buildLibWithDocs(forTypings = false) {
  */
 export async function docsHelpers() {
   task.stopOnFailures()
-  const files = fs.readdirSync('lib/helper').filter(f => path.extname(f) === '.js')
+  const files = fs.readdirSync('lib/helper').filter(f => path.extname(f) === '.js').sort()
   ensureDir('docs/build')
 
   const ignoreList = ['Polly', 'MockRequest']
@@ -321,78 +326,12 @@ editLink: false
 sidebar: auto
 title: ${name}
 ---
-
 `
       line.fromFile(helperMarkDownFile(name))
     })
   }
 }
 
-/**
- * Sync wiki pages from the CodeceptJS.wiki repo into website docs.
- */
-export async function wiki() {
-  task.stopOnFailures()
-  if (!fs.existsSync('docs/wiki/Home.md')) {
-    await shell`git clone git@github.com:codeceptjs/CodeceptJS.wiki.git docs/wiki`
-  }
-  await shell`git pull origin master`.cwd('docs/wiki')
-
-  await writeToFile('docs/community-helpers.md', line => {
-    line`---`
-    line`permalink: /community-helpers`
-    line`title: Community Helpers`
-    line`editLink: false`
-    line`---`
-    line``
-    line`# Community Helpers`
-    line`> Share your helpers at our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Community-Helpers)`
-    line``
-    line.fromFile('docs/wiki/Community-Helpers-&-Plugins.md')
-  })
-
-  await writeToFile('docs/examples.md', line => {
-    line`---`
-    line`permalink: /examples`
-    line`layout: Section`
-    line`sidebar: false`
-    line`title: Examples`
-    line`editLink: false`
-    line`---`
-    line``
-    line`# Examples`
-    line`> Add your own examples to our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Examples)`
-    line.fromFile('docs/wiki/Examples.md')
-  })
-
-  await writeToFile('docs/books.md', line => {
-    line`---`
-    line`permalink: /books`
-    line`layout: Section`
-    line`sidebar: false`
-    line`title: Books & Posts`
-    line`editLink: false`
-    line`---`
-    line``
-    line`# Books & Posts`
-    line`> Add your own books or posts to our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Books-&-Posts)`
-    line.fromFile('docs/wiki/Books-&-Posts.md')
-  })
-
-  await writeToFile('docs/videos.md', line => {
-    line`---`
-    line`permalink: /videos`
-    line`layout: Section`
-    line`sidebar: false`
-    line`title: Videos`
-    line`editLink: false`
-    line`---`
-    line``
-    line`> Add your own videos to our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Videos)`
-    line.fromFile('docs/wiki/Videos.md')
-  })
-}
-
 const inheritedHelperDocs = {
   Appium: {
     parent: 'WebDriver',
@@ -456,28 +395,6 @@ async function docsHelperMarkdown(name, { parent, exclude = [], excludeConfig =
   fs.writeFileSync(helperMarkDownFile(name), output)
 }
 
-/**
- * Update the codecept.io website: regenerate changelog, sync wiki, push docs and publish.
- */
-export async function publishSite() {
-  await processChangelog()
-  await wiki()
-
-  const dir = 'website'
-  if (fs.existsSync(dir)) {
-    await shell`rm -rf ${dir}`
-  }
-
-  await shell`git clone git@github.com:codeceptjs/website.git ${dir}`
-  copyFile('docs', 'website/docs')
-
-  await shell`git add -A`.cwd(dir)
-  await shell`git commit -m "synchronized with docs"`.cwd(dir)
-  await shell`git pull`.cwd(dir)
-  await shell`git push`.cwd(dir)
-  await shell`./runok.js publish`.cwd(dir)
-}
-
 /**
  * Run the PHP test app and the REST test server together. Warning! PHP required!
  */
@@ -485,32 +402,6 @@ export async function server() {
   await Promise.all([shell`php -S 127.0.0.1:8000 -t test/data/app`, testServer()])
 }
 
-/**
- * Release CodeceptJS to npm. Optionally bump package.json version first.
- * @param {string} [releaseType] - "patch", "minor" or "major" to bump before releasing.
- */
-export async function release(releaseType = null) {
-  task.stopOnFailures()
-  const packageInfo = JSON.parse(fs.readFileSync('package.json'))
-  if (releaseType) {
-    packageInfo.version = semver.inc(packageInfo.version, releaseType)
-    fs.writeFileSync('package.json', JSON.stringify(packageInfo))
-    await shell`git add package.json`
-    await shell`git commit -m "version bump"`
-  }
-  const version = packageInfo.version
-  await docs()
-  await def()
-  await publishSite()
-  await shell`git pull`
-  await shell`git tag ${version}`
-  await shell`git push origin 3.x --tags`
-  await shell`rm -rf docs/wiki/.git`
-  await shell`npm publish`
-  say('-- RELEASED --')
-}
-
-
 /**
  * Update the contributors table in README.md from the GitHub API.
  */
@@ -569,7 +460,6 @@ export async function contributorFaces() {
   }
 }
 
-
 /**
  * Scaffold a config, feature test and runner test for a new feature.
  * @param {string} featureName - Name of the feature to scaffold tests for.
@@ -633,28 +523,6 @@ describe('CodeceptJS ${featureName}', function () {
   say(`npx mocha test/runner --grep ${featureName}`)
 }
 
-async function processChangelog() {
-  const file = 'CHANGELOG.md'
-  let changelog = fs.readFileSync(file).toString()
-
-  changelog = changelog.replace(/\s@([\w-]+)/gm, ' **[$1](https://github.com/$1)**')
-  changelog = changelog.replace(/#(\d+)/gm, '[#$1](https://github.com/codeceptjs/CodeceptJS/issues/$1)')
-  changelog = changelog.replace(/\s\[(\w+)\]\s/gm, ' **[$1]** ')
-
-  await writeToFile('docs/changelog.md', line => {
-    line`---`
-    line`permalink: /changelog`
-    line`title: Releases`
-    line`sidebar: false`
-    line`layout: Section`
-    line`---`
-    line``
-    line`# Releases`
-    line``
-    line`${changelog}`
-  })
-}
-
 /**
  * Run the read-only REST test server on port 8010.
  */
@@ -694,21 +562,21 @@ export async function graphql() {
  * Lint the codebase with ESLint.
  */
 export async function lint() {
-  await shell`eslint bin/ examples/ lib/ test/ translations/ runok.cjs`
+  await shell`eslint bin/ examples/ lib/ test/ translations/ Bunoshfile.js`
 }
 
 /**
  * Lint and auto-fix the codebase with ESLint.
  */
 export async function lintFix() {
-  await shell`eslint bin/ examples/ lib/ test/ translations/ runok.cjs --fix`
+  await shell`eslint bin/ examples/ lib/ test/ translations/ Bunoshfile.js --fix`
 }
 
 /**
  * Format the codebase with Prettier.
  */
 export async function prettier() {
-  await shell`prettier --config prettier.config.js --write bin/**/*.js lib/**/*.js test/**/*.js translations/**/*.js runok.cjs`
+  await shell`prettier --config prettier.config.js --write bin/**/*.js lib/**/*.js test/**/*.js translations/**/*.js Bunoshfile.js`
 }
 
 /**
@@ -858,7 +726,6 @@ export async function prepare() {
   await shell`husky install`
 }
 
-
 function replaceInFile(file, fn) {
   let text = fs.readFileSync(file).toString()
   fn({
diff --git a/docs/helpers/Lightpanda.md b/docs/helpers/Lightpanda.md
index 6c44bedb2..bde92b064 100644
--- a/docs/helpers/Lightpanda.md
+++ b/docs/helpers/Lightpanda.md
@@ -78,20 +78,30 @@ These are set automatically and only need overriding for unusual setups:
 
 This helper should be configured in codecept.conf.js
 
-Type: [object][3]
+Type: [object][4]
 
 ### Properties
 
-*   `endpoint` **[string][4]?** explicit CDP endpoint. Setting this switches the helper to ATTACH
+*   `endpoint` **[string][3]?** explicit CDP endpoint. Setting this switches the helper to ATTACH
     mode: it only connects, and never spawns or kills a process, no matter what else is configured.
     Leave it unset for SELF-MANAGED mode (see below).
-*   `binaryPath` **[string][4]?** path to the `lightpanda` executable, used in SELF-MANAGED mode
+*   `binaryPath` **[string][3]?** path to the `lightpanda` executable, used in SELF-MANAGED mode
     (`endpoint` unset). Checked before `LIGHTPANDA_PATH` and `PATH`.
-*   `port` **[number][5]?** port `lightpanda serve` listens on, in SELF-MANAGED mode. When unset, a
+*   `port` **[number][8]?** port `lightpanda serve` listens on, in SELF-MANAGED mode. When unset, a
     free port is picked automatically, which is what makes `run-workers` collision-free — every
     worker gets its own instance on its own port with zero config.
-*   `serverStartTimeout` **[number][5]?** milliseconds to wait for a spawned `lightpanda serve`
+*   `serverStartTimeout` **[number][8]?** milliseconds to wait for a spawned `lightpanda serve`
     to answer `/json/version` before `_connect` gives up.
+*   `url` **[string][3]?** base url of website to be tested.
+*   `headers` **[object][4]?** headers sent when connecting to the endpoint, e.g. for authenticated remote browsers.
+*   `input` **[string][3]?** how actions are dispatched: `cdp` (real mouse and keyboard events) or `synthetic` (DOM events). `auto` picks `cdp` when the browser renders layout.
+*   `xpathPolyfill` **([string][3] | [boolean][18])?** inject an XPath polyfill for browsers with incomplete XPath support. `auto` detects when it is needed.
+*   `capabilities` **[object][4]?** browser capabilities (`layout`, `xpath`, `screenshot`, `video`, `innerText`, `aria`) to use instead of detecting them at runtime.
+*   `waitForTimeout` **[number][8]?** default timeout for wait* actions, in seconds.
+*   `waitForAction` **[number][8]?** fixed delay after each action, in milliseconds. When unset, actions wait only for the navigation they trigger.
+*   `pollInterval` **[number][8]?** interval between checks while waiting, in milliseconds.
+*   `getPageTimeout` **[number][8]?** maximum time to wait for a page to load, in seconds.
+*   `waitForNavigation` **[string][3]?** when a navigation is considered finished: `load`, `domcontentloaded`, or `networkidle`.
 
 
 
@@ -128,12 +138,1830 @@ Type: [object][3]
 
 *   `config` **LightpandaConfig**&#x20;
 
+### amOnPage
+
+Opens a web page in a browser. Requires relative or absolute url.
+If url starts with `/`, opens a web page of a site defined in `url` config parameter.
+
+```js
+I.amOnPage('/'); // opens main page of website
+I.amOnPage('https://github.com'); // opens github
+I.amOnPage('/login'); // opens a login page
+```
+
+#### Parameters
+
+*   `url` **[string][3]** url path or global url.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### appendField
+
+Appends text to a input field or textarea.
+Field is located by name, label, CSS or XPath
+
+The third parameter is an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+I.appendField('#myTextField', 'appended');
+// typing secret
+I.appendField('password', secret('123456'));
+// within a context
+I.appendField('name', 'John', '.form-container');
+```
+
+#### Parameters
+
+*   `field` **([string][3] | [object][4])** located by label|name|CSS|XPath|strict locator
+*   `value` **[string][3]** text value to append.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### attachFile
+
+Attaches a file to element located by label, name, CSS or XPath
+Path to file is relative current codecept directory (where codecept.conf.ts or codecept.conf.js is located).
+File will be uploaded to remote system (if tests are running remotely).
+
+The third parameter is an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+I.attachFile('Avatar', 'data/avatar.jpg');
+I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
+// within a context
+I.attachFile('Avatar', 'data/avatar.jpg', '.form-container');
+```
+
+If the locator points to a non-file-input element (e.g., a dropzone area),
+the file will be dropped onto that element using drag-and-drop events.
+
+```js
+I.attachFile('#dropzone', 'data/avatar.jpg');
+```
+
+#### Parameters
+
+*   `field` &#x20;
+*   `pathToFile` **[string][3]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### blur
+
+Remove focus from a text input, button, etc.
+Calls [blur][5] on the element.
+
+Examples:
+
+```js
+I.blur('.text-area')
+```
+
+```js
+//element `#product-tile` is focused
+I.see('#add-to-cart-btn');
+I.blur('#product-tile')
+I.dontSee('#add-to-cart-btn');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `options` **any?** Playwright only: [Additional options][6] for available options object as 2nd argument.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### capabilities
+
+Type: CodeceptJS.HelperCapabilities
+
+### checkOption
+
+Selects a checkbox or radio button.
+Element is located by label or name or CSS or XPath.
+
+The second parameter is an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+I.checkOption('#agree');
+I.checkOption('I Agree to Terms and Conditions');
+I.checkOption('agree', '//form');
+```
+
+#### Parameters
+
+*   `field` **([string][3] | [object][4])** checkbox located by label | name | CSS | XPath | strict locator.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### clearClipboard
+
+Clears the system clipboard.
+
+```js
+I.clearClipboard();
+I.seeClipboardEquals('');
+```
+
+Returns **void** automatically synchronized promise through #recorder
+
+### clearCookie
+
+Clears a cookie by name,
+if none provided clears all cookies.
+
+```js
+I.clearCookie();
+I.clearCookie('test');
+```
+
+#### Parameters
+
+*   `name` &#x20;
+*   `cookie` **[string][3]?** (optional, `null` by default) cookie name 
+
+### clearField
+
+Clears a `<textarea>` or text `<input>` element's value.
+
+The second parameter is an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+I.clearField('Email');
+I.clearField('user[email]');
+I.clearField('#email');
+// within a context
+I.clearField('Email', '.form-container');
+```
+
+#### Parameters
+
+*   `field` &#x20;
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+*   `editable` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+
+Returns **void** automatically synchronized promise through #recorder.
+
+### click
+
+Perform a click on a link or a button, given by a locator.
+If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+For images, the "alt" attribute and inner text of any parent links are searched.
+
+If no locator is provided, defaults to clicking the body element (`'//body'`).
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
+
+```js
+// click body element (default)
+I.click();
+// simple link
+I.click('Logout');
+// button of form
+I.click('Submit');
+// CSS button
+I.click('#form input[type=submit]');
+// XPath
+I.click('//form/*[@type=submit]');
+// link in context
+I.click('Logout', '#nav');
+// using strict locator
+I.click({css: 'nav a.login'});
+// using ARIA role locator
+I.click({role: 'button', name: 'Submit'});
+```
+
+> ℹ️ ARIA role locators (`{role, name}`) match elements the way assistive technology does and survive markup refactors. See [Locators][7].
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** (optional, `'//body'` by default) clickable link or button located by text, or any element located by CSS|XPath|strict locator. 
+*   `context` **([string][3]? | [object][4] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### clickXY
+
+Clicks at page coordinates, or at coordinates relative to an element.
+Requires a browser that renders layout.
+
+```js
+I.clickXY(100, 200); // page coordinates
+I.clickXY('#area', 50, 30); // relative to #area
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4] | [number][8])** element to click relative to, or the X page coordinate.
+*   `x` **[number][8]?** X coordinate relative to the element, or the Y page coordinate if `locator` is a number.
+*   `y` **[number][8]?** Y coordinate relative to the element.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSee
+
+Opposite to `see`. Checks that a text is not present on a page.
+Use context parameter to narrow down the search.
+
+```js
+I.dontSee('Login'); // assume we are already logged in.
+I.dontSee('Login', '.nav'); // no login inside .nav element
+```
+
+#### Parameters
+
+*   `text` **[string][3]** which is not present.
+*   `context` **([string][3] | [object][4])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeCheckboxIsChecked
+
+Verifies that the specified checkbox is not checked.
+
+```js
+I.dontSeeCheckboxIsChecked('#agree'); // located by ID
+I.dontSeeCheckboxIsChecked('I agree to terms'); // located by label
+I.dontSeeCheckboxIsChecked('agree'); // located by name
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+*   `field` **([string][3] | [object][4])** located by label|name|CSS|XPath|strict locator.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeCookie
+
+Checks that cookie with given name does not exist.
+
+```js
+I.dontSeeCookie('auth'); // no auth cookie
+```
+
+#### Parameters
+
+*   `name` **[string][3]** cookie name.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeCurrentPathEquals
+
+Checks that current URL path does NOT match the expected path.
+Query strings and URL fragments are ignored.
+
+```js
+I.dontSeeCurrentPathEquals('/form'); // fails for '/form', '/form?user=1', '/form#section'
+I.dontSeeCurrentPathEquals('/'); // fails for '/', '/?user=ok', '/#top'
+```
+
+#### Parameters
+
+*   `path` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeCurrentUrlEquals
+
+Checks that current url is not equal to provided one.
+If a relative url provided, a configured url will be prepended to it.
+
+```js
+I.dontSeeCurrentUrlEquals('/login'); // relative url are ok
+I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also ok
+```
+
+#### Parameters
+
+*   `url` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeElement
+
+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][3] | [object][4])** located by CSS|XPath|Strict locator.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeElementInDOM
+
+Opposite to `seeElementInDOM`. Checks that element is not on page.
+
+```js
+I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** located by CSS|XPath|Strict locator.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeInCurrentUrl
+
+Checks that current url does not contain a provided fragment.
+
+#### Parameters
+
+*   `url` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeInField
+
+Checks that value of input field or textarea doesn't equal to given value
+Opposite to `seeInField`.
+
+The third parameter is an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+I.dontSeeInField('email', 'user@user.com'); // field by name
+I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
+// within a context
+I.dontSeeInField('Name', 'old_value', '.form-container');
+```
+
+#### Parameters
+
+*   `field` **([string][3] | [object][4])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][3] | [object][4])** value to check.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeInSource
+
+Checks that the current page does not contains the given string in its raw source code.
+
+```js
+I.dontSeeInSource('<!--'); // no comments in source
+```
+
+#### Parameters
+
+*   `text` &#x20;
+*   `value` **[string][3]** to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeInTitle
+
+Checks that title does not contain text.
+
+```js
+I.dontSeeInTitle('Error');
+```
+
+#### Parameters
+
+*   `text` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### dontSeeTraffic
+
+Verifies that a certain request is not part of network traffic.
+
+Examples:
+
+```js
+I.dontSeeTraffic({ name: 'Unexpected API Call', url: 'https://api.example.com' });
+I.dontSeeTraffic({ name: 'Unexpected API Call of "user" endpoint', url: /api.example.com.*user/ });
+```
+
+#### Parameters
+
+*   `opts` **[Object][4]** options when checking the traffic network.
+
+    *   `opts.name` **[string][3]** A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+    *   `opts.url` **([string][3] | [RegExp][9])** Expected URL of request in network traffic. Can be a string or a regular expression.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### doubleClick
+
+Performs a double-click on an element matched by link|button|label|CSS or XPath.
+Context can be specified as second parameter to narrow search.
+
+```js
+I.doubleClick('Edit');
+I.doubleClick('Edit', '.actions');
+I.doubleClick({css: 'button.accept'});
+I.doubleClick('.btn.edit');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### executeAsyncScript
+
+Executes async script on page.
+Provided function should execute a passed callback (as first argument) to signal it is finished.
+
+Example: In Vue.js to make components completely rendered we are waiting for [nextTick][10].
+
+```js
+I.executeAsyncScript(function(done) {
+  Vue.nextTick(done); // waiting for next tick
+});
+```
+
+By passing value to `done()` function you can return values.
+Additional arguments can be passed as well, while `done` function is always last parameter in arguments list.
+
+```js
+let val = await I.executeAsyncScript(function(url, done) {
+  // in browser context
+  $.ajax(url, { success: (data) => done(data); }
+}, 'http://ajax.callback.url/');
+```
+
+#### Parameters
+
+*   `fn` **([string][3] | [function][11])** function to be executed in browser context.
+*   `args` **...any** to be passed to function.
+
+Returns **[Promise][12]<any>** script return value
+
+### executeScript
+
+Executes sync script on a page.
+Pass arguments to function as additional parameters.
+Will return execution result to a test.
+In this case you should use async function and await to receive results.
+
+Example with jQuery DatePicker:
+
+```js
+// change date of jQuery DatePicker
+I.executeScript(function() {
+  // now we are inside browser context
+  $('date').datetimepicker('setDate', new Date());
+});
+```
+
+Can return values. Don't forget to use `await` to get them.
+
+```js
+let date = await I.executeScript(function(el) {
+  // only basic types can be returned
+  return $(el).datetimepicker('getDate').toString();
+}, '#date'); // passing jquery selector
+```
+
+#### Parameters
+
+*   `fn` **([string][3] | [function][11])** function to be executed in browser context.
+*   `args` **...any** to be passed to function.
+
+Returns **[Promise][12]<any>** script return value
+
+### fillField
+
+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 an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+// by label
+I.fillField('Email', 'hello@world.com');
+// by name
+I.fillField('password', secret('123456'));
+// by CSS
+I.fillField('form#login input[name=username]', 'John');
+// or by strict locator
+I.fillField({css: 'form#login input[name=username]'}, 'John');
+// by ARIA role locator
+I.fillField({role: 'textbox', name: 'Email'}, 'hello@world.com');
+// within a context
+I.fillField('Name', 'John', '#section2');
+```
+
+> ℹ️ ARIA role locators (`{role, name}`) match fields by their accessible name and survive markup refactors. See [Locators][7].
+
+#### Parameters
+
+*   `field` **([string][3] | [object][4])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][3] | [object][4])** text value to fill.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### flushNetworkTraffics
+
+Resets all recorded network requests.
+
+```js
+I.flushNetworkTraffics();
+```
+
+### focus
+
+Calls [focus][5] on the matching element.
+
+Examples:
+
+```js
+I.dontSee('#add-to-cart-btn');
+I.focus('#product-tile')
+I.see('#add-to-cart-bnt');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `options` **any?** Playwright only: [Additional options][13] for available options object as 2nd argument.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### forceClick
+
+Perform an emulated click on a link or a button, given by a locator.
+Unlike normal click instead of sending native event, emulates a click with JavaScript.
+This works on hidden, animated or inactive elements as well.
+
+If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
+For buttons, the "value" attribute, "name" attribute, and inner text are searched. For links, the link text is searched.
+For images, the "alt" attribute and inner text of any parent links are searched.
+
+The second parameter is a context (CSS or XPath locator) to narrow the search.
+
+```js
+// simple link
+I.forceClick('Logout');
+// button of form
+I.forceClick('Submit');
+// CSS button
+I.forceClick('#form input[type=submit]');
+// XPath
+I.forceClick('//form/*[@type=submit]');
+// link in context
+I.forceClick('Logout', '#nav');
+// using strict locator
+I.forceClick({css: 'nav a.login'});
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### grabAriaSnapshot
+
+Retrieves the ARIA snapshot of the page, or of an element, built from the browser accessibility tree.
+The format matches Playwright's [ARIA snapshots][14].
+
+```js
+const snapshot = await I.grabAriaSnapshot();
+const formSnapshot = await I.grabAriaSnapshot('#login-form');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator. Defaults to body element. 
+
+Returns **[Promise][12]<[string][3]>** YAML representation of the accessibility tree
+
+### grabAttributeFrom
+
+Retrieves an attribute from an element located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async with `await`** operator.
+If more than one element is found - attribute of first element is returned.
+
+```js
+let hint = await I.grabAttributeFrom('#tooltip', 'title');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `attr` **[string][3]** attribute name.
+
+Returns **[Promise][12]<[string][3]>** attribute value
+
+### grabAttributeFromAll
+
+Retrieves an array of attributes from elements located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async with `await`** operator.
+
+```js
+let hints = await I.grabAttributeFromAll('.tooltip', 'title');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `attr` **[string][3]** attribute name.
+
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
+
+### grabCookie
+
+Gets a cookie object by name.
+If none provided gets all cookies.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+let cookie = await I.grabCookie('auth');
+assert(cookie.value, '123456');
+```
+
+#### Parameters
+
+*   `name` **[string][3]?** cookie name. 
+
+Returns **any** attribute value
+
+### grabCookies
+
+Retrieves all cookies visible to the current page.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+let cookies = await I.grabCookies();
+```
+
+Returns **[Promise][12]<[Array][15]<CodeceptJS.Cookie>>** array of cookie objects.
+
+### grabCssPropertyFrom
+
+Grab CSS property for given locator
+Resumes test execution, so **should be used inside an async function with `await`** operator.
+If more than one element is found - value of first element is returned.
+
+```js
+const value = await I.grabCssPropertyFrom('h3', 'font-weight');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `cssProperty` **[string][3]** CSS property name.
+
+Returns **[Promise][12]<[string][3]>** CSS value
+
+### grabCssPropertyFromAll
+
+Grab array of CSS properties for given locator
+Resumes test execution, so **should be used inside an async function with `await`** operator.
+
+```js
+const values = await I.grabCssPropertyFromAll('h3', 'font-weight');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `cssProperty` **[string][3]** CSS property name.
+
+Returns **[Promise][12]<[Array][15]<[string][3]>>** CSS value
+
+### grabCurrentUrl
+
+Get current URL from browser.
+Resumes test execution, so should be used inside an async function.
+
+```js
+let url = await I.grabCurrentUrl();
+console.log(`Current URL is [${url}]`);
+```
+
+Returns **[Promise][12]<[string][3]>** current URL
+
+### grabFromClipboard
+
+Grabs the text content of the system clipboard and returns it to test.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+I.click('Copy to clipboard');
+let url = await I.grabFromClipboard();
+```
+
+Reading the clipboard requires a secure context (`https` or `localhost`) and is supported
+in Chromium-based browsers, where read access is granted automatically.
+
+Returns **[Promise][12]<[string][3]>** the system clipboard contents.
+
+### grabHTMLFrom
+
+Retrieves the innerHTML from an element located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+If more than one element is found - HTML of first element is returned.
+
+```js
+let postHTML = await I.grabHTMLFrom('#post');
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+*   `element` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[string][3]>** HTML code for an element
+
+### grabHTMLFromAll
+
+Retrieves all the innerHTML from elements located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+let postHTMLs = await I.grabHTMLFromAll('.post');
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+*   `element` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[Array][15]<[string][3]>>** HTML code for an element
+
+### grabNumberOfElements
+
+Grab number of elements by locator.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+let numOfElements = await I.grabNumberOfElements('p');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[number][8]>** number of matched elements.
+
+### grabNumberOfVisibleElements
+
+Grab number of visible elements by locator.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+let numOfElements = await I.grabNumberOfVisibleElements('p');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[number][8]>** number of visible elements
+
+### grabPageScrollPosition
+
+Retrieves a page scroll position and returns it to test.
+Resumes test execution, so **should be used inside an async function with `await`** operator.
+
+```js
+let { x, y } = await I.grabPageScrollPosition();
+```
+
+Returns **[Promise][12]<PageScrollPosition>** scroll position
+
+### grabRecordedNetworkTraffics
+
+Grab the recording network traffics
+
+```js
+const traffics = await I.grabRecordedNetworkTraffics();
+expect(traffics[0].url).to.equal('https://reqres.in/api/comments/1');
+expect(traffics[0].response.status).to.equal(200);
+expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
+```
+
+Returns **[Array][15]** recorded network traffics
+
+### grabSource
+
+Retrieves page source and returns it to test.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+let pageSource = await I.grabSource();
+```
+
+Returns **[Promise][12]<[string][3]>** source code
+
+### grabTextFrom
+
+Retrieves a text from an element located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async with `await`** operator.
+
+```js
+let pin = await I.grabTextFrom('#pin');
+```
+
+If multiple elements found returns first element.
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[string][3]>** attribute value
+
+### grabTextFromAll
+
+Retrieves all texts from an element located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async with `await`** operator.
+
+```js
+let pins = await I.grabTextFromAll('#pin li');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
+
+### grabTitle
+
+Retrieves a page title and returns it to test.
+Resumes test execution, so **should be used inside async with `await`** operator.
+
+```js
+let title = await I.grabTitle();
+```
+
+Returns **[Promise][12]<[string][3]>** title
+
+### grabValueFrom
+
+Retrieves a value from a form element located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+If more than one element is found - value of first element is returned.
+
+```js
+let email = await I.grabValueFrom('input[name=email]');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[string][3]>** attribute value
+
+### grabValueFromAll
+
+Retrieves an array of value from a form located by CSS or XPath and returns it to test.
+Resumes test execution, so **should be used inside async function with `await`** operator.
+
+```js
+let inputs = await I.grabValueFromAll('//form/input');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+
+Returns **[Promise][12]<[Array][15]<[string][3]>>** attribute value
+
+### grabWebElement
+
+Grab WebElement for given locator
+Resumes test execution, so **should be used inside an async function with `await`** operator.
+
+```js
+const webElement = await I.grabWebElement('#button');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<any>** WebElement of being used Web helper
+
+### grabWebElements
+
+Grab WebElements for given locator
+Resumes test execution, so **should be used inside an async function with `await`** operator.
+
+```js
+const webElements = await I.grabWebElements('#button');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+
+Returns **[Promise][12]<any>** WebElement of being used Web helper
+
+### pressKey
+
+Presses a key or a key combination on the focused element.
+
+```js
+I.pressKey('Enter');
+I.pressKey(['Control', 'a']);
+```
+
+#### Parameters
+
+*   `key` **([string][3] | [Array][15]<[string][3]>)** a key or an array of keys to combine (modifiers first).
+
+Returns **void** automatically synchronized promise through #recorder
+
+### refreshPage
+
+Reload the current page.
+
+```js
+I.refreshPage();
+```
+
+Returns **void** automatically synchronized promise through #recorder
+
+### resizeWindow
+
+Resize the current window to provided width and height.
+First parameter can be set to `maximize`.
+
+#### Parameters
+
+*   `width` **[number][8]** width in pixels or `maximize`.
+*   `height` **[number][8]** height in pixels.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### rightClick
+
+Performs right click on a clickable element matched by semantic locator, CSS or XPath.
+
+```js
+// right click element with id el
+I.rightClick('#el');
+// right click link or button with text "Click me"
+I.rightClick('Click me');
+// right click button with text "Click me" inside .context
+I.rightClick('Click me', '.context');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** clickable element located by CSS|XPath|strict locator.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS|XPath|strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### saveElementScreenshot
+
+Saves screenshot of the specified locator to ouput folder (set in codecept.conf.ts or codecept.conf.js).
+Filename is relative to output folder.
+
+```js
+I.saveElementScreenshot(`#submit`,'debug.png');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `fileName` **[string][3]** file name to save.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### saveScreenshot
+
+Saves a screenshot to the output folder (set in codecept.conf.ts or codecept.conf.js).
+Filename is relative to the output folder.
+
+```js
+I.saveScreenshot('debug.png');
+```
+
+#### Parameters
+
+*   `fileName` **[string][3]** file name to save.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### scrollPageToBottom
+
+Scroll page to the bottom.
+
+```js
+I.scrollPageToBottom();
+```
+
+Returns **void** automatically synchronized promise through #recorder
+
+### scrollPageToTop
+
+Scroll page to the top.
+
+```js
+I.scrollPageToTop();
+```
+
+Returns **void** automatically synchronized promise through #recorder
+
+### scrollTo
+
+Scrolls to element matched by locator.
+Extra shift can be set with offsetX and offsetY options.
+
+```js
+I.scrollTo('footer');
+I.scrollTo('#submit', 5, 5);
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+*   `offsetX` **[number][8]** (optional, `0` by default) X-axis offset. 
+*   `offsetY` **[number][8]** (optional, `0` by default) Y-axis offset. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### see
+
+Checks that a page contains a visible text.
+Use context parameter to narrow down the search.
+
+```js
+I.see('Welcome'); // text welcome on a page
+I.see('Welcome', '.content'); // text inside .content div
+I.see('Register', {css: 'form.register'}); // use strict locator
+```
+
+#### Parameters
+
+*   `text` **[string][3]** expected on page.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeAttributesOnElements
+
+Checks that all elements with given locator have given attributes.
+
+```js
+I.seeAttributesOnElements('//form', { method: "post"});
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+*   `attributes` **[object][4]** attributes and their values to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeCheckboxIsChecked
+
+Verifies that the specified checkbox is checked.
+
+```js
+I.seeCheckboxIsChecked('Agree');
+I.seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms
+I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
+```
+
+#### Parameters
+
+*   `locator` &#x20;
+*   `field` **([string][3] | [object][4])** located by label|name|CSS|XPath|strict locator.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeClipboardEquals
+
+Checks that the system clipboard is equal to the given text.
+
+```js
+I.click('Copy to clipboard');
+I.seeClipboardEquals('https://codecept.io');
+```
+
+Reading the clipboard requires a secure context (`https` or `localhost`) and is supported
+in Chromium-based browsers, where read access is granted automatically.
+
+#### Parameters
+
+*   `text` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeCookie
+
+Checks that cookie with given name exists.
+
+```js
+I.seeCookie('Auth');
+```
+
+#### Parameters
+
+*   `name` **[string][3]** cookie name.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeCssPropertiesOnElements
+
+Checks that all elements with given locator have given CSS properties.
+
+```js
+I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+*   `cssProperties` **[object][4]** object with CSS properties and their values to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeCurrentPathEquals
+
+Checks that current URL path matches the expected path.
+Query strings and URL fragments are ignored.
+
+```js
+I.seeCurrentPathEquals('/info'); // passes for '/info', '/info?user=1', '/info#section'
+I.seeCurrentPathEquals('/'); // passes for '/', '/?user=ok', '/#top'
+```
+
+#### Parameters
+
+*   `path` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeCurrentUrlEquals
+
+Checks that current url is equal to provided one.
+If a relative url provided, a configured url will be prepended to it.
+So both examples will work:
+
+```js
+I.seeCurrentUrlEquals('/register');
+I.seeCurrentUrlEquals('http://my.site.com/register');
+```
+
+#### Parameters
+
+*   `url` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeElement
+
+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');
+// using ARIA role locator
+I.seeElement({role: 'dialog'});
+```
+
+> ℹ️ ARIA role locators (`{role, name}`) match elements the way assistive technology does and survive markup refactors. See [Locators][7].
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** located by CSS|XPath|strict locator.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeElementInDOM
+
+Checks that a given Element is present in the DOM
+Element is located by CSS or XPath.
+
+```js
+I.seeElementInDOM('#modal');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeInClipboard
+
+Checks that the system clipboard contains the given text.
+
+```js
+I.click('Copy to clipboard');
+I.seeInClipboard('https://codecept.io');
+```
+
+Reading the clipboard requires a secure context (`https` or `localhost`) and is supported
+in Chromium-based browsers, where read access is granted automatically.
+
+#### Parameters
+
+*   `text` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeInCurrentUrl
+
+Checks that current url contains a provided fragment.
+
+```js
+I.seeInCurrentUrl('/register'); // we are on registration page
+```
+
+#### Parameters
+
+*   `url` **[string][3]** a fragment to check
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeInField
+
+Checks that the given input field or textarea equals to given value.
+For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
+
+The third parameter is an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+I.seeInField('Username', 'davert');
+I.seeInField({css: 'form textarea'},'Type your comment here');
+I.seeInField('form input[type=hidden]','hidden_value');
+I.seeInField('#searchform input','Search');
+// within a context
+I.seeInField('Name', 'John', '.form-container');
+```
+
+#### Parameters
+
+*   `field` **([string][3] | [object][4])** located by label|name|CSS|XPath|strict locator.
+*   `value` **([string][3] | [object][4])** value to check.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeInSource
+
+Checks that the current page contains the given string in its raw source code.
+
+```js
+I.seeInSource('<h1>Green eggs &amp; ham</h1>');
+```
+
+#### Parameters
+
+*   `text` **[string][3]** value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeInTitle
+
+Checks that title contains text.
+
+```js
+I.seeInTitle('Home Page');
+```
+
+#### Parameters
+
+*   `text` **[string][3]** text value to check.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeNumberOfVisibleElements
+
+Asserts that an element is visible a given number of times.
+Element is located by CSS or XPath.
+
+```js
+I.seeNumberOfVisibleElements('.buttons', 3);
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `num` **[number][8]** number of elements.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### seeTraffic
+
+Verifies that a certain request is part of network traffic.
+
+```js
+// checking the request url contains certain query strings
+I.amOnPage('https://openai.com/blog/chatgpt');
+I.startRecordingTraffic();
+await I.seeTraffic({
+    name: 'sentry event',
+    url: 'https://images.openai.com/blob/cf717bdb-0c8c-428a-b82b-3c3add87a600',
+    parameters: {
+    width: '1919',
+    height: '1138',
+    },
+  });
+```
+
+```js
+// checking the request url contains certain post data
+I.amOnPage('https://openai.com/blog/chatgpt');
+I.startRecordingTraffic();
+await I.seeTraffic({
+    name: 'event',
+    url: 'https://cloudflareinsights.com/cdn-cgi/rum',
+    requestPostData: {
+    st: 2,
+    },
+  });
+```
+
+#### Parameters
+
+*   `opts` **[Object][4]** options when checking the traffic network.
+
+    *   `opts.name` **[string][3]** A name of that request. Can be any value. Only relevant to have a more meaningful error message in case of fail.
+    *   `opts.url` **[string][3]** Expected URL of request in network traffic
+    *   `opts.parameters` **[Object][4]?** Expected parameters of that request in network traffic
+    *   `opts.requestPostData` **[Object][4]?** Expected that request contains post data in network traffic
+    *   `opts.timeout` **[number][8]?** Timeout to wait for request in seconds. Default is 10 seconds.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### selectOption
+
+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 an optional 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.
+
+```js
+I.selectOption('Which OS do you use?', ['Android', 'iOS']);
+```
+
+#### Parameters
+
+*   `select` **([string][3] | [object][4])** field located by label|name|CSS|XPath|strict locator.
+*   `option` **([string][3] | [Array][15]<any>)** visible text or value of option.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### setCookie
+
+Sets cookie(s).
+
+Can be a single cookie object or an array of cookies:
+
+```js
+I.setCookie({name: 'auth', value: true});
+
+// as array
+I.setCookie([
+  {name: 'auth', value: true},
+  {name: 'agree', value: true}
+]);
+```
+
+#### Parameters
+
+*   `cookie` **(Cookie | [Array][15]<Cookie>)** a cookie object or array of cookie objects.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### startRecordingTraffic
+
+Starts recording the network traffics.
+This also resets recorded network requests.
+
+```js
+I.startRecordingTraffic();
+```
+
+Returns **void** automatically synchronized promise through #recorder
+
+### startScreencast
+
+Starts recording a video of the page. Stop it with `stopScreencast`.
+Usually enabled through the `screencast` plugin rather than called directly.
+
+```js
+I.startScreencast();
+```
+
+#### Parameters
+
+*   `options` **[object][4]?** `{ maxWidth, maxHeight, quality, everyNthFrame }` 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### stopRecordingTraffic
+
+Stops recording of network traffic. Recorded traffic is not flashed.
+
+```js
+I.stopRecordingTraffic();
+```
+
+### stopScreencast
+
+Stops the recording started by `startScreencast` and returns it as an animated PNG.
+
+```js
+const video = await I.stopScreencast();
+```
+
+#### Parameters
+
+*   `options` **[object][4]?** `{ lastFrameDelayMs }`: how long the last frame is shown, in milliseconds (1000 by default). 
+
+Returns **[Promise][12]<([Buffer][16] | null)>** APNG data, or `null` if no frames were recorded.
+
+### type
+
+Types out the given text into an active field.
+To slow down typing use a second parameter, to set interval between key presses.
+*Note:* Should be used when [`fillField`][17] is not an option.
+
+```js
+// passing in a string
+I.type('Type this out.');
+
+// typing values with a 100ms interval
+I.type('4141555311111111', 100);
+
+// passing in an array
+I.type(['T', 'E', 'X', 'T']);
+
+// passing a secret
+I.type(secret('123456'));
+```
+
+#### Parameters
+
+*   `keys` &#x20;
+*   `delay` **[number][8]?** (optional) delay in ms between key presses 
+*   `key` **([string][3] | [Array][15]<[string][3]>)** or array of keys to type.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### uncheckOption
+
+Unselects a checkbox or radio button.
+Element is located by label or name or CSS or XPath.
+
+The second parameter is an optional context (CSS or XPath locator) to narrow the search.
+
+```js
+I.uncheckOption('#agree');
+I.uncheckOption('I Agree to Terms and Conditions');
+I.uncheckOption('agree', '//form');
+```
+
+#### Parameters
+
+*   `field` **([string][3] | [object][4])** checkbox located by label | name | CSS | XPath | strict locator.
+*   `context` **([string][3]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### wait
+
+Pauses execution for a number of seconds.
+
+```js
+I.wait(2); // wait 2 secs
+```
+
+#### Parameters
+
+*   `sec` **[number][8]** number of second to wait.
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitCurrentPathEquals
+
+Waits for the current URL path to match the expected path.
+Query strings and URL fragments are ignored.
+
+```js
+I.waitCurrentPathEquals('/info', 5);
+```
+
+#### Parameters
+
+*   `path` **[string][3]** value to check.
+*   `sec` **[number][8]?** (optional, `waitForTimeout` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForCookie
+
+Waits for the specified cookie in the cookies.
+
+```js
+I.waitForCookie("token");
+```
+
+#### Parameters
+
+*   `name` **[string][3]** expected cookie name.
+*   `sec` **[number][8]** (optional, `3` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForDetached
+
+Waits for an element to become not attached to the DOM on a page (by default waits for 1sec).
+Element can be located by CSS or XPath.
+
+```js
+I.waitForDetached('#popup');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForElement
+
+Waits for element to be present on page (by default waits for 1sec).
+Element can be located by CSS or XPath.
+
+```js
+I.waitForElement('.btn.continue');
+I.waitForElement('.btn.continue', 5); // wait for 5 secs
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForFunction
+
+Waits for a function to return true (waits for 1 sec by default).
+Running in browser context.
+
+```js
+I.waitForFunction(fn[, [args[, timeout]])
+```
+
+```js
+I.waitForFunction(() => window.requests == 0);
+I.waitForFunction(() => window.requests == 0, 5); // waits for 5 sec
+I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and wait for 5 sec
+```
+
+#### Parameters
+
+*   `fn` **([string][3] | [function][11])** to be executed in browser context.
+*   `argsOrSec` **([Array][15]<any> | [number][8])?** (optional, `1` by default) arguments for function or seconds. 
+*   `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForInvisible
+
+Waits for an element to be removed or become invisible on a page (by default waits for 1sec).
+Element can be located by CSS or XPath.
+
+```js
+I.waitForInvisible('#popup');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForText
+
+Waits for a text to appear (by default waits for 1sec).
+Element can be located by CSS or XPath.
+Narrow down search results by providing context.
+
+```js
+I.waitForText('Thank you, form has been submitted');
+I.waitForText('Thank you, form has been submitted', 5, '#modal');
+```
+
+#### Parameters
+
+*   `text` **[string][3]** to wait for.
+*   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+*   `context` **([string][3] | [object][4])?** (optional) element located by CSS|XPath|strict locator. 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitForVisible
+
+Waits for an element to become visible on a page (by default waits for 1sec).
+Element can be located by CSS or XPath.
+
+```js
+I.waitForVisible('#popup');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitInUrl
+
+Waiting for the part of the URL to match the expected. Useful for SPA to understand that page was changed.
+
+```js
+I.waitInUrl('/info', 2);
+```
+
+#### Parameters
+
+*   `urlPart` **[string][3]** value to check.
+*   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitToHide
+
+Waits for an element to hide (by default waits for 1sec).
+Element can be located by CSS or XPath.
+
+```js
+I.waitToHide('#popup');
+```
+
+#### Parameters
+
+*   `locator` **([string][3] | [object][4])** element located by CSS|XPath|strict locator.
+*   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### waitUrlEquals
+
+Waits for the entire URL to match the expected
+
+```js
+I.waitUrlEquals('/info', 2);
+I.waitUrlEquals('http://127.0.0.1:8000/info');
+```
+
+#### Parameters
+
+*   `urlPart` **[string][3]** value to check.
+*   `sec` **[number][8]** (optional, `1` by default) time in seconds to wait 
+
+Returns **void** automatically synchronized promise through #recorder
+
+### _connect
+
+In SELF-MANAGED mode, resolves and spawns the browser server (or courtesy-attaches to an
+already-running one on :9222) exactly once via `_resolveSelfManaged`. Then resolves the CDP
+endpoint and opens the underlying `CDPConnection`, storing it on `this.cdp`.
+
+### _findFreePort
+
+Picks a free TCP port on 127.0.0.1 by briefly listening on port 0 and reading back the
+OS-assigned port. Used when `options.port` isn't explicitly set, so multiple `run-workers`
+workers never collide on the same port.
+
+Returns **[Promise][12]<[number][8]>** a free port.
+
+### _manageServer
+
+Opts a subclass into managing its own browser server process. Called from a subclass
+constructor with the raw user config and a server descriptor:
+
+*   `name` — binary name looked up on `PATH`, also used in messages
+*   `envVar` — environment variable that may point at the binary
+*   `args(port)` — arguments the binary is spawned with to serve CDP on `port`
+*   `env` — extra environment variables for the spawned process
+*   `releases` — URL shown when no binary can be resolved
+
+An explicit `endpoint` in the user config always wins: the helper stays in ATTACH mode and
+never spawns or kills anything. Otherwise the helper becomes SELF-MANAGED and the default
+`endpoint` is cleared until `_resolveSelfManaged` sets the real one.
+
+#### Parameters
+
+*   `config` **[object][4]** the config object the helper was constructed with.
+*   `server` **[object][4]** the server descriptor described above.
+
+### _probeUp
+
+Probes a `/json/version`-style URL with a short timeout, used for the courtesy-attach check.
+
+#### Parameters
+
+*   `url` **[string][3]**&#x20;
+
+Returns **[Promise][12]<[boolean][18]>** true if the URL answered.
+
+### _resolveBinary
+
+Resolves the binary to spawn, in priority order: `options.binaryPath`, then the server
+descriptor's environment variable, then its name on `PATH`. The `PATH` lookup walks the
+directories itself instead of shelling out to `which`, which does not exist on Windows: on
+Windows every `PATHEXT` suffix is tried, so a `.exe` on `PATH` is found too.
+
+Returns **([string][3] | null)** an absolute or relative path to the binary, or null if none resolved.
+
+### _resolveSelfManaged
+
+Resolves how to reach a SELF-MANAGED browser, trying, in order: spawn a binary
+(`binaryPath` config, then the descriptor's `envVar`, then its `name` on `PATH`) on
+`options.port` or a free port, courtesy-attach to `http://127.0.0.1:9222` if something already
+answers there (never killed by this helper), or throw a loud, actionable error. Sets
+`this.options.endpoint` as a side effect.
+
+A spawn failure (e.g. a bad binary) is delivered asynchronously by Node as an `error` event;
+it is recorded on `this.serverError` and surfaced as a rejection from `_waitForServer` instead
+of crashing the process as an uncaught exception.
+
+### _waitForServer
+
+Polls `http://127.0.0.1:<port>/json/version` until the spawned server responds,
+`this.serverError` is set by the process' `error` event, or `options.serverStartTimeout`
+elapses. The process typically comes up within tens of milliseconds — a 20ms retry interval
+keeps the wasted tail after the server is actually ready small, since this cost is paid once
+per run and counts directly toward real-world startup latency.
+
 [1]: https://lightpanda.io
 
 [2]: https://lightpanda.io/docs/open-source/installation
 
-[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+[3]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+
+[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
+
+[5]: https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus
+
+[6]: https://playwright.dev/docs/api/class-locator#locator-blur
+
+[7]: /locators#aria-locators
+
+[8]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+
+[9]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/RegExp
+
+[10]: https://vuejs.org/v2/api/#Vue-nextTick
+
+[11]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
+
+[12]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
+
+[13]: https://playwright.dev/docs/api/class-locator#locator-focus
+
+[14]: https://playwright.dev/docs/aria-snapshots
+
+[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
+
+[16]: https://nodejs.org/api/buffer.html
 
-[4]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
+[17]: #fillfield
 
-[5]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
+[18]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
diff --git a/package.json b/package.json
index e4fdc7ddd..f680baaad 100644
--- a/package.json
+++ b/package.json
@@ -59,10 +59,10 @@
     "mock-server:stop": "kill -9 $(lsof -t -i:3001)",
     "test:with-mock-server": "npm run mock-server:start && npm test",
     "json-server:graphql": "node test/data/graphql/index.js",
-    "lint": "eslint bin/ examples/ lib/ test/ translations/ runok.cjs",
-    "lint-fix": "eslint bin/ examples/ lib/ test/ translations/ runok.cjs --fix",
-    "prettier": "prettier --config prettier.config.js --write bin/**/*.js lib/**/*.js test/**/*.js translations/**/*.js runok.cjs",
-    "docs": "./runok.cjs docs",
+    "lint": "eslint bin/ examples/ lib/ test/ translations/ Bunoshfile.js",
+    "lint-fix": "eslint bin/ examples/ lib/ test/ translations/ Bunoshfile.js --fix",
+    "prettier": "prettier --config prettier.config.js --write bin/**/*.js lib/**/*.js test/**/*.js translations/**/*.js Bunoshfile.js",
+    "docs": "bunosh docs",
     "test:unit": "mocha test/unit --recursive --timeout 10000",
     "test:unit:windows": "mocha test/unit/container_test.js --recursive --timeout 10000",
     "test:rest": "mocha test/rest --recursive --timeout 20000",
@@ -83,15 +83,12 @@
     "test:unit:webbapi:lightpanda": "mocha test/helper/CDPBrowser_lightpanda_test.js --timeout 30000",
     "test:unit:expect": "mocha test/helper/Expect_test.js",
     "test:plugin": "mocha test/plugin/plugin_test.js",
-    "def": "./runok.cjs def",
+    "def": "bunosh def",
     "dev:graphql": "node test/data/graphql/index.js",
-    "publish:site": "./runok.cjs publish:site",
-    "update-contributor-faces": "./runok.cjs contributor:faces",
+    "update-contributor-faces": "bunosh contributor:faces",
     "types-fix": "node typings/fixDefFiles.js",
     "dtslint": "npm run types-fix && tsd",
-    "prepare": "husky install",
-    "prepare-release": "./runok.cjs versioning && ./runok.cjs get:commit-log",
-    "publish-beta": "./runok.cjs publish:next-beta-version"
+    "prepare": "husky install"
   },
   "dependencies": {
     "@codeceptjs/configure": "^4.0.0-beta.4",
@@ -161,7 +158,7 @@
     "@wdio/selenium-standalone-service": "8.15.0",
     "@wdio/utils": "9.23.3",
     "@xmldom/xmldom": "^0.9.12",
-    "bunosh": "latest",
+    "bunosh": "^0.6.0",
     "chai": "^6.2.1",
     "chai-as-promised": "^8.0.2",
     "chai-subset": "1.6.0",
@@ -184,7 +181,6 @@
     "puppeteer": "24.36.0",
     "qrcode-terminal": "0.12.0",
     "rosie": "2.1.1",
-    "runok": "^0.9.3",
     "semver": "7.7.3",
     "sinon": "22.0.0",
     "sinon-chai": "^4.0.1",
diff --git a/runok.cjs b/runok.cjs
deleted file mode 100755
index 804cf2f19..000000000
--- a/runok.cjs
+++ /dev/null
@@ -1,763 +0,0 @@
-#!/usr/bin/env node
-const fs = require('fs')
-const path = require('path')
-const axios = require('axios')
-
-const {
-  stopOnFail,
-  chdir,
-  tasks: { git, copy, exec, replaceInFile, npmRun, npx, writeToFile },
-  runok,
-} = require('runok')
-const { execSync } = require('node:child_process')
-const semver = require('semver')
-
-const helperMarkDownFile = function (name) {
-  return `docs/helpers/${name}.md`
-}
-const pluginMarkDownFile = function (name) {
-  return `docs/plugins/${name}.md`
-}
-const documentjsCliArgs = '-f md --shallow --markdown-toc=false --sort-order=alpha'
-
-const inheritedHelperDocs = {
-  Appium: {
-    parent: 'WebDriver',
-    exclude: [/Title/, /Popup/, /Cookie/, /Url/, /^press/, /^refreshPage/, /^resizeWindow/, /Script$/, /cursor/, /Css/, /Tab$/, /^wait/],
-  },
-  Obscura: { parent: 'CDPBrowser' },
-  Kitesurf: { parent: 'CDPBrowser', excludeConfig: ['endpoint', 'headers'] },
-}
-
-const abstractHelpers = ['CDPBrowser']
-
-const helperHooks = [
-  '_init',
-  '_before',
-  '_after',
-  '_beforeStep',
-  '_afterStep',
-  '_beforeSuite',
-  '_afterSuite',
-  '_passed',
-  '_failed',
-  '_finishTest',
-  '_setConfig',
-  '_validateConfig',
-  '_test',
-  '_useTo',
-]
-
-stopOnFail()
-
-module.exports = {
-  async docs() {
-    // generate all docs (runs all docs:* commands in parallel)
-    await Promise.all([this.docsHelpers(), this.docsPlugins(), this.docsExternalHelpers()])
-  },
-
-  async def() {
-    await Promise.all([this.buildLibWithDocs(true), this.docsPlugins(), this.docsExternalHelpers()])
-    await this.defTypings()
-  },
-
-  async defTypings() {
-    console.log('Generate TypeScript definition')
-    // Generate definitions for promised-based helper methods
-    await npx('jsdoc -c typings/jsdocPromiseBased.conf.json')
-    fs.renameSync('typings/types.d.ts', 'typings/promiseBasedTypes.d.ts')
-    // Generate all other regular definitions
-    await npx('jsdoc -c typings/jsdoc.conf.json')
-  },
-
-  async docsPlugins() {
-    // generate documentation for plugins: each plugin gets a dedicated page
-
-    if (!fs.existsSync('docs/plugins')) fs.mkdirSync('docs/plugins')
-
-    const files = fs.readdirSync('lib/plugin').filter(f => path.extname(f) === '.js')
-
-    const sharedPartials = fs.readdirSync('docs/shared').filter(f => path.extname(f) === '.mustache')
-    const sharedPlaceholders = sharedPartials.map(file => `{{ ${path.basename(file, '.mustache')} }}`)
-    const sharedTemplates = sharedPartials.map(file => fs.readFileSync(`docs/shared/${file}`).toString()).map(template => `\n\n\n${template}`)
-
-    const index = []
-
-    for (const file of files) {
-      const name = path.basename(file, '.js')
-      console.log(`Writing documentation for ${name} plugin`)
-
-      await npx(`documentation build lib/plugin/${file} -o ${pluginMarkDownFile(name)} ${documentjsCliArgs}`)
-
-      replaceInFile(pluginMarkDownFile(name), cfg => {
-        cfg.replace(/\(optional, default.*?\)/gm, '')
-        cfg.replace(/\\*/gm, '')
-      })
-
-      replaceInFile(pluginMarkDownFile(name), cfg => {
-        for (const i in sharedPlaceholders) {
-          cfg.replace(sharedPlaceholders[i], sharedTemplates[i])
-        }
-      })
-
-      const lines = fs.readFileSync(pluginMarkDownFile(name)).toString().split('\n')
-      const headingAt = lines.findIndex(l => l.startsWith('## '))
-      const summary = []
-      for (let i = headingAt + 1; i < lines.length; i++) {
-        const line = lines[i].trim()
-        if (!summary.length && !line) continue
-        if (summary.length && (!line || line.startsWith('#') || line.startsWith('```'))) break
-        summary.push(line)
-      }
-      index.push({ name, summary: summary.join(' ').trim() })
-
-      await writeToFile(pluginMarkDownFile(name), cfg => {
-        cfg.append(`---
-permalink: /plugins/${name}
-editLink: false
-sidebar: auto
-title: ${name}
----
-
-`)
-        cfg.textFromFile(pluginMarkDownFile(name))
-      })
-    }
-
-    // overview page links to every dedicated plugin page (keeps /plugins permalink)
-    await writeToFile('docs/plugins.md', cfg => {
-      cfg.line('---')
-      cfg.line('permalink: /plugins')
-      cfg.line('editLink: false')
-      cfg.line('sidebar: auto')
-      cfg.line('title: Plugins')
-      cfg.line('---')
-      cfg.line('')
-      cfg.line('# Plugins')
-      cfg.line('')
-      cfg.line('CodeceptJS bundles the following plugins. Each plugin has its own page with full configuration reference.')
-      cfg.line('')
-      for (const { name, summary } of index) {
-        cfg.line(`## [${name}](/plugins/${name})`)
-        cfg.line('')
-        if (summary) cfg.line(summary)
-        cfg.line('')
-      }
-    })
-  },
-
-
-  async docsExternalHelpers() {
-    // generate documentation for helpers outside of main repo
-    console.log('Building @codecepjs/detox helper docs')
-    let helper = 'Detox'
-    replaceInFile(`node_modules/@codeceptjs/detox-helper/${helper}.js`, cfg => {
-      cfg.replace(/CodeceptJS.LocatorOrString/g, 'string | object')
-      cfg.replace(/LocatorOrString/g, 'string | object')
-    })
-    await npx(`documentation build node_modules/@codeceptjs/detox-helper/${helper}.js -o ${helperMarkDownFile(helper)} ${documentjsCliArgs}`)
-
-    await writeToFile(helperMarkDownFile(helper), cfg => {
-      cfg.line(`---\npermalink: /helpers/${helper}\nsidebar: auto\ntitle: ${helper}\n---\n\n# ${helper}\n\n`)
-      cfg.textFromFile(helperMarkDownFile(helper))
-    })
-
-    replaceInFile(`node_modules/@codeceptjs/detox-helper/${helper}.js`, cfg => {
-      cfg.replace(/string \| object/g, 'CodeceptJS.LocatorOrString')
-      cfg.replace(/string \| object/g, 'LocatorOrString')
-    })
-
-    console.log('Building @codeceptjs/mock-request')
-    helper = 'MockRequest'
-    replaceInFile('node_modules/@codeceptjs/mock-request/index.js', cfg => {
-      cfg.replace(/CodeceptJS.LocatorOrString/g, 'string | object')
-      cfg.replace(/LocatorOrString/g, 'string | object')
-    })
-    await npx(`documentation build node_modules/@codeceptjs/mock-request/index.js -o ${helperMarkDownFile(helper)} ${documentjsCliArgs}`)
-
-    await writeToFile(helperMarkDownFile(helper), cfg => {
-      cfg.line(`---\npermalink: /helpers/${helper}\nsidebar: auto\ntitle: ${helper}\n---\n\n# ${helper}\n\n`)
-      cfg.textFromFile(helperMarkDownFile(helper))
-    })
-
-    replaceInFile('node_modules/@codeceptjs/mock-request/index.js', cfg => {
-      cfg.replace(/string \| object/g, 'CodeceptJS.LocatorOrString')
-      cfg.replace(/string \| object/g, 'LocatorOrString')
-    })
-  },
-
-  async docsExternalPlugins() {
-    // generate documentation for helpers outside of main repo
-    console.log('Building Vue plugin docs')
-    const resp = await axios.get('https://raw.githubusercontent.com/codecept-js/vue-cli-plugin-codeceptjs-puppeteer/master/README.md')
-
-    writeToFile('docs/vue.md', cfg => {
-      cfg.line('---\npermalink: /vue\nlayout: Section\nsidebar: false\ntitle: Testing Vue Apps\n---\n\n')
-      cfg.line(resp.data)
-    })
-
-    this.docsCi()
-  },
-
-  async buildLibWithDocs(forTypings = false) {
-    // generate documentation for helpers
-    const files = fs.readdirSync('lib/helper').filter(f => path.extname(f) === '.js')
-
-    const partials = fs.readdirSync('docs/webapi').filter(f => path.extname(f) === '.mustache')
-    const placeholders = partials.map(file => `{{> ${path.basename(file, '.mustache')} }}`)
-    const templates = partials
-      .map(file => fs.readFileSync(`docs/webapi/${file}`).toString())
-      .map(template =>
-        template
-          .replace(/^/gm, '   * ')
-          .replace(/^/, '\n')
-          .replace(/\s*\* /, ''),
-      )
-
-    for (const file of files) {
-      const name = path.basename(file, '.js')
-      console.log(`Building helpers with docs for ${name}`)
-      copy(`lib/helper/${file}`, `docs/build/${file}`)
-      replaceInFile(`docs/build/${file}`, cfg => {
-        for (const i in placeholders) {
-          cfg.replace(placeholders[i], templates[i])
-        }
-        if (!forTypings) {
-          cfg.replace(/CodeceptJS.LocatorOrString\?/g, '(string | object)?')
-          cfg.replace(/LocatorOrString\?/g, '(string | object)?')
-          cfg.replace(/CodeceptJS.LocatorOrString/g, 'string | object')
-          cfg.replace(/LocatorOrString/g, 'string | object')
-          cfg.replace(/CodeceptJS.StringOrSecret/g, 'string | object')
-        }
-        // Convert ESM imports to require() for JSDoc compatibility
-        cfg.replace(/^import\s+([^'"`\s{]+)\s+from\s+['"`]([^'"`]+)['"`]/gm, "const $1 = require('$2')")
-        cfg.replace(/^import\s*\{\s*([^}]+)\s*\}\s*from\s+['"`]([^'"`]+)['"`]/gm, (match, imports, path) => {
-          // Handle destructuring imports with aliases - convert to simple require and assign
-          if (imports.includes(' as ')) {
-            const parts = imports.split(',').map(i => i.trim())
-            const assignments = parts.map(part => {
-              if (part.includes(' as ')) {
-                const [original, alias] = part.split(' as ').map(s => s.trim())
-                return `const ${alias} = require('${path}').${original}`
-              } else {
-                return `const ${part} = require('${path}').${part}`
-              }
-            })
-            return assignments.join(';\n')
-          }
-          return `const { ${imports} } = require('${path}')`
-        })
-        cfg.replace(/^import\s+\*\s+as\s+([^'"`]+)\s+from\s+['"`]([^'"`]+)['"`]/gm, "const $1 = require('$2')")
-
-        // Convert ESM exports to module.exports for JSDoc compatibility
-        cfg.replace(/^export\s*\{\s*([^}]+)\s+as\s+default\s*\}/gm, 'module.exports = $1')
-        cfg.replace(/^export\s+default\s+(.+)/gm, 'module.exports = $1')
-        cfg.replace(/^export\s*\{\s*([^}]+)\s*\}/gm, 'module.exports = { $1 }')
-        cfg.replace(/^export\s+(class|function|const|let|var)\s+([^\s=]+)/gm, '$1 $2')
-      })
-    }
-  },
-
-  async docsHelpers() {
-    // generate documentation for helpers
-    const files = fs.readdirSync('lib/helper').filter(f => path.extname(f) === '.js')
-
-    const ignoreList = ['Polly', 'MockRequest'] // WebDriverIO won't be documented and should be removed
-
-    const partials = fs.readdirSync('docs/webapi').filter(f => path.extname(f) === '.mustache')
-    const placeholders = partials.map(file => `{{> ${path.basename(file, '.mustache')} }}`)
-    const templates = partials
-      .map(file => fs.readFileSync(`docs/webapi/${file}`).toString())
-      .map(template =>
-        template
-          .replace(/^/gm, '   * ')
-          .replace(/^/, '\n')
-          .replace(/\s*\* /, ''),
-      )
-
-    const sharedPartials = fs.readdirSync('docs/shared').filter(f => path.extname(f) === '.mustache')
-    const sharedPlaceholders = sharedPartials.map(file => `{{ ${path.basename(file, '.mustache')} }}`)
-    const sharedTemplates = sharedPartials.map(file => fs.readFileSync(`docs/shared/${file}`).toString()).map(template => `\n\n\n${template}`)
-
-    const helperFiles = files.filter(file => ignoreList.indexOf(path.basename(file, '.js')) < 0)
-
-    for (const file of helperFiles) {
-      copy(`lib/helper/${file}`, `docs/build/${file}`)
-      replaceInFile(`docs/build/${file}`, cfg => {
-        for (const i in placeholders) {
-          cfg.replace(placeholders[i], templates[i])
-        }
-        cfg.replace(/CodeceptJS.LocatorOrString\?/g, '(string | object)?')
-        cfg.replace(/LocatorOrString\?/g, '(string | object)?')
-        cfg.replace(/CodeceptJS.LocatorOrString/g, 'string | object')
-        cfg.replace(/LocatorOrString/g, 'string | object')
-        cfg.replace(/CodeceptJS.StringOrSecret/g, 'string | object')
-
-        // Convert ESM imports to require() for JSDoc compatibility
-        cfg.replace(/^import\s+([^'"`\s{]+)\s+from\s+['"`]([^'"`]+)['"`]/gm, "const $1 = require('$2')")
-        cfg.replace(/^import\s*\{\s*([^}]+)\s*\}\s*from\s+['"`]([^'"`]+)['"`]/gm, (match, imports, path) => {
-          // Handle destructuring imports with aliases - convert to simple require and assign
-          if (imports.includes(' as ')) {
-            const parts = imports.split(',').map(i => i.trim())
-            const assignments = parts.map(part => {
-              if (part.includes(' as ')) {
-                const [original, alias] = part.split(' as ').map(s => s.trim())
-                return `const ${alias} = require('${path}').${original}`
-              } else {
-                return `const ${part} = require('${path}').${part}`
-              }
-            })
-            return assignments.join(';\n')
-          }
-          return `const { ${imports} } = require('${path}')`
-        })
-        cfg.replace(/^import\s+\*\s+as\s+([^'"`]+)\s+from\s+['"`]([^'"`]+)['"`]/gm, "const $1 = require('$2')")
-
-        // Convert ESM exports to module.exports for JSDoc compatibility
-        cfg.replace(/^export\s*\{\s*([^}]+)\s+as\s+default\s*\}/gm, 'module.exports = $1')
-        cfg.replace(/^export\s+default\s+(.+)/gm, 'module.exports = $1')
-        cfg.replace(/^export\s*\{\s*([^}]+)\s*\}/gm, 'module.exports = { $1 }')
-        cfg.replace(/^export\s+(class|function|const|let|var)\s+([^\s=]+)/gm, '$1 $2')
-      })
-    }
-
-    for (const file of helperFiles) {
-      const name = path.basename(file, '.js')
-      if (abstractHelpers.includes(name)) continue
-      console.log(`Writing documentation for ${name}`)
-
-      await this.docsHelperMarkdown(name, inheritedHelperDocs[name])
-      replaceInFile(helperMarkDownFile(name), cfg => {
-        cfg.replace(/\(optional, default.*?\)/gm, '')
-        cfg.replace(/\\*/gm, '')
-      })
-
-      replaceInFile(helperMarkDownFile(name), cfg => {
-        for (const i in sharedPlaceholders) {
-          cfg.replace(sharedPlaceholders[i], sharedTemplates[i])
-        }
-      })
-
-      replaceInFile(helperMarkDownFile(name), cfg => {
-        const regex = /## config((.|\n)*)\[1\]/m
-        const fullText = fs.readFileSync(helperMarkDownFile(name)).toString()
-        const text = fullText.match(regex)
-        if (!text) return
-
-        cfg.replace('<!-- configuration -->', text[1])
-        cfg.replace(regex, '[1]')
-      })
-
-      await writeToFile(helperMarkDownFile(name), cfg => {
-        cfg.append(`---
-permalink: /helpers/${name}
-editLink: false
-sidebar: auto
-title: ${name}
----
-
-`)
-        cfg.textFromFile(helperMarkDownFile(name))
-      })
-    }
-  },
-
-  async wiki() {
-    // publish wiki pages to website
-    if (!fs.existsSync('docs/wiki/Home.md')) {
-      await git(fn => {
-        fn.clone('git@github.com:codeceptjs/CodeceptJS.wiki.git', 'docs/wiki')
-      })
-    }
-    await chdir('docs/wiki', () => git(cfg => cfg.pull('origin master')))
-
-    await writeToFile('docs/community-helpers.md', cfg => {
-      cfg.line('---')
-      cfg.line('permalink: /community-helpers')
-      cfg.line('title: Community Helpers')
-      cfg.line('editLink: false')
-      cfg.line('---')
-      cfg.line('')
-      cfg.line('# Community Helpers')
-      cfg.line('> Share your helpers at our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Community-Helpers)')
-      cfg.line('')
-      cfg.textFromFile('docs/wiki/Community-Helpers-&-Plugins.md')
-    })
-
-    writeToFile('docs/examples.md', cfg => {
-      cfg.line('---')
-      cfg.line('permalink: /examples')
-      cfg.line('layout: Section')
-      cfg.line('sidebar: false')
-      cfg.line('title: Examples')
-      cfg.line('editLink: false')
-      cfg.line('---')
-      cfg.line('')
-      cfg.line('# Examples')
-      cfg.line('> Add your own examples to our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Examples)')
-      cfg.textFromFile('docs/wiki/Examples.md')
-    })
-
-    writeToFile('docs/books.md', cfg => {
-      cfg.line('---')
-      cfg.line('permalink: /books')
-      cfg.line('layout: Section')
-      cfg.line('sidebar: false')
-      cfg.line('title: Books & Posts')
-      cfg.line('editLink: false')
-      cfg.line('---')
-      cfg.line('')
-      cfg.line('# Books & Posts')
-      cfg.line('> Add your own books or posts to our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Books-&-Posts)')
-      cfg.textFromFile('docs/wiki/Books-&-Posts.md')
-    })
-
-    writeToFile('docs/videos.md', cfg => {
-      cfg.line('---')
-      cfg.line('permalink: /videos')
-      cfg.line('layout: Section')
-      cfg.line('sidebar: false')
-      cfg.line('title: Videos')
-      cfg.line('editLink: false')
-      cfg.line('---')
-      cfg.line('')
-      cfg.line('> Add your own videos to our [Wiki Page](https://github.com/codeceptjs/CodeceptJS/wiki/Videos)')
-      cfg.textFromFile('docs/wiki/Videos.md')
-    })
-  },
-
-  async docsHelperMarkdown(name, { parent, exclude = [], excludeConfig = [] } = {}) {
-    const documentation = await import('documentation')
-    const buildOptions = { shallow: true, sortOrder: ['alpha'] }
-    const doc = await documentation.build([`docs/build/${name}.js`], buildOptions)
-    doc.sort((a, b) => (b.kind === 'class') - (a.kind === 'class'))
-    let members = doc[0].members.instance
-
-    if (parent) {
-      const parentDoc = await documentation.build([`docs/build/${parent}.js`], buildOptions)
-      const parentClass = parentDoc.find(c => c.kind === 'class')
-      for (const method of parentClass.members.instance) {
-        if (exclude.some(f => method.name.match(f))) continue
-        if (members.some(m => m.name === method.name)) continue
-        members.push(method)
-      }
-
-      const config = doc.find(c => c.name === 'config')
-      const parentConfig = parentDoc.find(c => c.name === 'config')
-      if (config && parentConfig) {
-        for (const prop of parentConfig.properties) {
-          if (excludeConfig.includes(prop.name)) continue
-          if (config.properties.some(p => p.name === prop.name)) continue
-          config.properties.push(prop)
-        }
-      }
-    }
-
-    members = members.filter(m => !helperHooks.includes(m.name))
-    members.sort((a, b) => a.name.startsWith('_') - b.name.startsWith('_') || a.name.localeCompare(b.name))
-    doc[0].members.instance = members
-
-    const output = await documentation.formats.md(doc, { markdownToc: false })
-    fs.writeFileSync(helperMarkDownFile(name), output)
-  },
-
-  async publishSite() {
-    // updates codecept.io website
-    await processChangelog()
-    await this.wiki()
-
-    const dir = 'website'
-    if (fs.existsSync(dir)) {
-      await exec(`rm -rf ${dir}`)
-    }
-
-    await git(fn => fn.clone('git@github.com:codeceptjs/website.git', dir))
-    await copy('docs', 'website/docs')
-
-    await chdir(dir, async () => {
-      stopOnFail(false)
-      await git(fn => {
-        fn.add('-A')
-        fn.commit('-m "synchronized with docs"')
-        fn.pull()
-        fn.push()
-      })
-      stopOnFail(true)
-
-      await exec('./runok.js publish')
-    })
-  },
-
-  async server() {
-    // run test server. Warning! PHP required!
-    await Promise.all([exec('php -S 127.0.0.1:8000 -t test/data/app'), npmRun('test-server')])
-  },
-
-  async release(releaseType = null) {
-    const packageInfo = JSON.parse(fs.readFileSync('package.json'))
-    // Releases CodeceptJS. You can pass in argument "patch", "minor", "major" to update package.json
-    if (releaseType) {
-      packageInfo.version = semver.inc(packageInfo.version, releaseType)
-      fs.writeFileSync('package.json', JSON.stringify(packageInfo))
-      await git(cmd => {
-        cmd.add('package.json')
-        cmd.commit('-m "version bump"')
-      })
-    }
-    // publish a new release on npm. Update version in package.json!
-    const version = packageInfo.version
-    await this.docs()
-    await this.def()
-    await this.publishSite()
-    await git(cmd => {
-      cmd.pull()
-      cmd.tag(version)
-      cmd.push('origin 3.x --tags')
-    })
-    await exec('rm -rf docs/wiki/.git')
-    await exec('npm publish')
-    console.log('-- RELEASED --')
-  },
-
-  async versioning() {
-    const semver = require('semver')
-
-    if (fs.existsSync('./package.json')) {
-      const packageFile = require('./package.json')
-      const currentVersion = packageFile.version
-      let type = process.argv[3]
-      if (!['major', 'minor', 'patch'].includes(type)) {
-        type = 'patch'
-      }
-
-      const newVersion = semver.inc(packageFile.version, type)
-      packageFile.version = newVersion
-      fs.writeFileSync('./package.json', JSON.stringify(packageFile, null, 2).replace(/(^[ \t]*\n)/gm, ''))
-      console.log('Version updated', currentVersion, '=>', newVersion)
-
-      const file = 'CHANGELOG.md'
-      const changelog = fs.readFileSync(file).toString()
-
-      const _changelog = `## ${newVersion}\n
-❤️ Thanks all to those who contributed to make this release! ❤️
-
-🛩️ *Features*
-
-🐛 *Bug Fixes*
-
-📖 *Documentation*
-
-${changelog}`
-
-      fs.writeFileSync(`./${file}`, _changelog)
-
-      console.log('Creating and switching to release branch...')
-      await exec(`git checkout -b release-${newVersion}`)
-    }
-  },
-
-  async getCommitLog() {
-    console.log('Gathering commits...')
-    const logs = await exec('git log --grep "chore(deps" --invert-grep --pretty=\'format:* %s - by @%aN\' $(git describe --abbrev=0 --tags)..HEAD | grep "DOC: " -v')
-    console.log(logs.data.stdout)
-  },
-
-  async contributorFaces() {
-    // update contributors list in readme
-    const owner = 'codeceptjs'
-    const repo = 'codeceptjs'
-    const token = process.env.GH_TOKEN
-
-    try {
-      const response = await axios.get(`https://api.github.com/repos/${owner}/${repo}/contributors`, {
-        headers: { Authorization: `token ${token}` },
-      })
-
-      // Filter out bot accounts
-      const excludeUsers = ['dependabot[bot]', 'actions-user']
-
-      const filteredContributors = response.data.filter(contributor => !excludeUsers.includes(contributor.login))
-
-      const contributors = filteredContributors.map(contributor => {
-        return `
-<td align="center">
-  <a href="${contributor.html_url}">
-    <img src="${contributor.avatar_url}" width="100" height="100" alt="${contributor.login}"/><br />
-    <sub><b>${contributor.login}</b></sub>
-  </a>
-</td>`
-      })
-
-      // Chunk contributors into rows of 4
-      const rows = []
-      const chunkSize = 4
-      for (let i = 0; i < contributors.length; i += chunkSize) {
-        rows.push(`<tr>${contributors.slice(i, i + chunkSize).join('')}</tr>`)
-      }
-
-      // Combine rows into a table
-      const contributorsTable = `
-<table>
-  ${rows.join('\n')}
-</table>
-    `
-
-      const readmePath = path.join(__dirname, 'README.md')
-      let content = fs.readFileSync(readmePath, 'utf-8')
-
-      // Replace or add the contributors section in the README
-      const contributorsSectionRegex = /(## Contributors\s*\n)([\s\S]*?)(\n##|$)/
-      const match = content.match(contributorsSectionRegex)
-
-      if (match) {
-        const updatedContent = content.replace(contributorsSectionRegex, `${match[1]}\n${contributorsTable}\n${match[3]}`)
-        fs.writeFileSync(readmePath, updatedContent, 'utf-8')
-      } else {
-        // If no contributors section exists, add one at the end
-        content += `\n${contributorsTable}`
-        fs.writeFileSync(readmePath, content, 'utf-8')
-      }
-
-      console.log('Contributors section updated successfully!')
-    } catch (error) {
-      console.error('Error fetching contributors:', error.message)
-    }
-  },
-
-  getCurrentBetaVersion() {
-    try {
-      const output = execSync('npm view codeceptjs versions --json').toString()
-      const versions = JSON.parse(output)
-      const betaVersions = versions.filter(version => version.includes('beta'))
-      const latestBeta = betaVersions.length ? betaVersions[betaVersions.length - 1] : null
-      console.log(`Current beta version: ${latestBeta}`)
-      return latestBeta
-    } catch (error) {
-      console.error('Error fetching package versions:', error)
-      process.exit(1)
-    }
-  },
-
-  publishNextBetaVersion() {
-    const currentBetaVersion = this.getCurrentBetaVersion()
-    if (!currentBetaVersion) {
-      console.error('No beta version found.')
-      process.exit(1)
-    }
-
-    const nextBetaVersion = semver.inc(currentBetaVersion, 'prerelease', 'beta')
-    console.log(`Publishing version: ${nextBetaVersion}`)
-
-    try {
-      // Save original version
-      const packageJson = JSON.parse(fs.readFileSync('package.json', 'utf8'))
-      const originalVersion = packageJson.version
-      execSync(`npm version ${nextBetaVersion} --no-git-tag-version`)
-      execSync('npm publish --tag beta')
-      console.log(`Successfully published ${nextBetaVersion}`)
-
-      // Revert to original version
-      execSync(`npm version ${originalVersion} --no-git-tag-version`)
-      console.log(`Reverted back to original version: ${originalVersion}`)
-    } catch (error) {
-      console.error('Error publishing package:', error)
-      process.exit(1)
-    }
-  },
-
-  async runnerCreateTests(featureName) {
-    // create runner tests for feature
-    const fs = require('fs').promises
-    const path = require('path')
-
-    // Create directories
-    const configDir = path.join('test/data/sandbox/configs', featureName)
-    await fs.mkdir(configDir, { recursive: true })
-
-    // Create codecept config file
-    const configContent = `exports.config = {
-    tests: './*_test.js',
-    output: './output',
-    helpers: {
-      FileSystem: {},
-    },
-    include: {},
-    bootstrap: false,
-    mocha: {},
-    name: '${featureName} tests'
-  }
-  `
-    await fs.writeFile(path.join(configDir, `codecept.conf.js`), configContent)
-
-    // Create feature test file
-    const testContent = `Feature('${featureName}');
-
-Scenario('test ${featureName}', ({ I }) => {
-  // Add test steps here
-});
-`
-    await fs.writeFile(path.join(configDir, `${featureName}_test.js`), testContent)
-
-    // Create runner test file
-    const runnerTestContent = `const { expect } = require('expect')
-const exec = require('child_process').exec
-const { codecept_dir, codecept_run } = require('./consts')
-const debug = require('debug')('codeceptjs:tests')
-
-const config_run_config = (config, grep, verbose = false) =>
-  \`\${codecept_run} \${verbose ? '--verbose' : ''} --config \${codecept_dir}/configs/${featureName}/\${config} \${grep ? \`--grep "\${grep}"\` : ''}\`
-
-describe('CodeceptJS ${featureName}', function () {
-  this.timeout(10000)
-
-  it('should run ${featureName} test', done => {
-    exec(config_run_config('codecept.conf.js'), (err, stdout) => {
-      debug(stdout)
-      expect(stdout).toContain('OK')
-      expect(err).toBeFalsy()
-      done()
-    })
-  })
-})
-`
-    await fs.writeFile(path.join('test/runner', `${featureName}_test.js`), runnerTestContent)
-
-    console.log(`Created test files for feature: ${featureName}`)
-
-    console.log('Run codecept tests with:')
-    console.log(`./bin/codecept.js run --config ${configDir}/codecept.conf.js`)
-
-    console.log('')
-    console.log('Run tests with:')
-    console.log(`npx mocha test/runner --grep ${featureName}`)
-  },
-}
-
-async function processChangelog() {
-  const file = 'CHANGELOG.md'
-  let changelog = fs.readFileSync(file).toString()
-
-  // user
-  changelog = changelog.replace(/\s@([\w-]+)/gm, ' **[$1](https://github.com/$1)**')
-
-  // issue
-  changelog = changelog.replace(/#(\d+)/gm, '[#$1](https://github.com/codeceptjs/CodeceptJS/issues/$1)')
-
-  // helper
-  changelog = changelog.replace(/\s\[(\w+)\]\s/gm, ' **[$1]** ')
-
-  writeToFile('docs/changelog.md', cfg => {
-    cfg.line('---')
-    cfg.line('permalink: /changelog')
-    cfg.line('title: Releases')
-    cfg.line('sidebar: false')
-    cfg.line('layout: Section')
-    cfg.line('---')
-    cfg.line('')
-    cfg.line('# Releases')
-    cfg.line('')
-    cfg.line(changelog)
-  })
-}
-
-if (require.main === module) runok(module.exports)

From bdaa2b36c633d7173a6e0d9155844ac183722ba9 Mon Sep 17 00:00:00 2001
From: DavertMik <davert@testomat.io>
Date: Wed, 14 Oct 2026 12:27:21 +0300
Subject: [PATCH 2/2] ci: set up bun for runner tests (definitions test runs
 npm run def)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .github/workflows/test.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index f2d9af1d4..ab49db4cf 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -89,6 +89,7 @@ jobs:
         uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
+      - uses: oven-sh/setup-bun@v2
       - run: npm i
         env:
           PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: true