chore: sync docs, unified API and releases from CodeceptJS

Author: codeceptjs-bot

src/content/docs/configuration.md

@@ -68,16 +68,18 @@ For TypeScript test files in CodeceptJS 4.x, use the [`tsx`](https://tsx.is) loa
 // codecept.conf.ts
 export const config = {
   tests: './**/*_test.ts',
-  require: ['tsx/cjs'],
+  require: ['tsx/esm'],
   helpers: {},
   include: {},
 }
 ```
 
+This requires `"type": "module"` in `package.json` so `.ts` test files are compiled as ES Modules.
+
 Combine several modules:
 
 ```ts
-require: ['tsx/cjs', 'should', './lib/testSetup']
+require: ['tsx/esm', 'should', './lib/testSetup']
 ```
 
 The config file itself (`codecept.conf.ts`) and helpers are transpiled automatically — only test files need the loader. See [TypeScript](/typescript) for the full setup.

src/content/docs/installation.md

@@ -108,7 +108,7 @@ npm i tsx --save-dev
 // codecept.conf.ts
 export const config = {
   tests: './**/*_test.ts',
-  require: ['tsx/cjs'],   // loads the *_test.ts files
+  require: ['tsx/esm'],   // loads the *_test.ts files as ES Modules (needs "type": "module")
   helpers: {
     Playwright: { url: 'http://localhost', browser: 'chromium' },
   },

src/content/docs/parallel.md

@@ -113,7 +113,7 @@ import { Workers, event } from 'codeceptjs'
 const workers = new Workers(null, { testConfig: './codecept.conf.js' })
 
 // split the suite into 2 groups, run each group on two browsers
-const groups = workers.createGroupsOfSuites(2)
+const groups = await workers.createGroupsOfSuites(2)
 for (const browser of ['chromium', 'firefox']) {
   for (const group of groups) {
     const worker = workers.spawn()
@@ -136,7 +136,7 @@ try {
 Building blocks:
 
 - `new Workers(N, { testConfig, options })` — `N` workers; pass `null` to spawn them yourself with `spawn()`.
-- `createGroupsOfTests(n)` / `createGroupsOfSuites(n)` — split the suite into `n` groups.
+- `await createGroupsOfTests(n)` / `await createGroupsOfSuites(n)` — split the suite into `n` groups (async: test files are loaded as ES Modules).
 - `worker.addTests(group)` / `worker.addConfig(partialConfig)` — assign tests and config overrides to a spawned worker.
 - `bootstrapAll()` → `run()` → `teardownAll()` — lifecycle (wrap `run()` in `try/finally` so teardown always runs).
 - Events on the `workers` object: `event.test.passed`, `event.test.failed`, `event.all.result`, plus `'message'` for anything a child worker sends. `printResults()` prints the standard summary; `result.hasFailed()` and `result.stats` give the totals.

src/content/docs/release.md

@@ -4,6 +4,26 @@ description: Latest CodeceptJS releases, pulled from GitHub.
 ---
 <!-- Auto-generated by bunosh release:pull from codeceptjs/CodeceptJS GitHub Releases. Do not edit. -->
 
+## [4.1.0](https://github.com/codeceptjs/CodeceptJS/releases/tag/4.1.0)
+
+_Released 2026-07-30_
+
+### What's Changed
+* Fixes run-rerun by @DenysKuchma in https://github.com/codeceptjs/CodeceptJS/pull/5667
+* fix(core): load Mocha test files as ES Modules (fixes internal-API imports from tests, #5636) by @DavertMik in https://github.com/codeceptjs/CodeceptJS/pull/5640
+* chore(deps): bump @xmldom/xmldom from 0.9.8 to 0.9.10 by @ElVisPL in https://github.com/codeceptjs/CodeceptJS/pull/5651
+* fix(appium): replace deprecated setNetworkConnection/getNetworkConnection with mobile: setConnectivity/getConnectivity by @mirao in https://github.com/codeceptjs/CodeceptJS/pull/5662
+* fix(typings): add ARIA locators to ILocator by @patryk-przybysz in https://github.com/codeceptjs/CodeceptJS/pull/5665
+* chore(deps-dev): bump eslint-plugin-mocha from 11.2.0 to 11.3.0 by @dependabot[bot] in https://github.com/codeceptjs/CodeceptJS/pull/5629
+* chore(deps-dev): bump graphql from 16.12.0 to 16.14.2 by @dependabot[bot] in https://github.com/codeceptjs/CodeceptJS/pull/5627
+* chore(deps): bump monocart-coverage-reports from 2.12.9 to 2.12.12 by @dependabot[bot] in https://github.com/codeceptjs/CodeceptJS/pull/5625
+
+### New Contributors
+* @ElVisPL made their first contribution in https://github.com/codeceptjs/CodeceptJS/pull/5651
+* @patryk-przybysz made their first contribution in https://github.com/codeceptjs/CodeceptJS/pull/5665
+
+**Full Changelog**: https://github.com/codeceptjs/CodeceptJS/compare/4.0.9...4.1.0
+
 ## [4.0.8](https://github.com/codeceptjs/CodeceptJS/releases/tag/4.0.8)
 
 _Released 2026-06-17_
@@ -170,15 +190,3 @@ _Released 2026-05-14_
 
 
 **Full Changelog**: https://github.com/codeceptjs/CodeceptJS/compare/4.0.0-rc.22...4.0.0-rc.23
-
-## [4.0.0-rc.22](https://github.com/codeceptjs/CodeceptJS/releases/tag/4.0.0-rc.22) _(pre-release)_
-
-_Released 2026-05-13_
-
-### What's Changed
-* fix(playwright): replace constructor.name checks with stable public API (#5559) by @mirao in https://github.com/codeceptjs/CodeceptJS/pull/5560
-* fix(workers): do not exit worker on unhandled rejections by @gololdf1sh in https://github.com/codeceptjs/CodeceptJS/pull/5561
-* feat(plugin): JUnit XML reporter plugin with steps & meta by @DavertMik in https://github.com/codeceptjs/CodeceptJS/pull/5558
-
-
-**Full Changelog**: https://github.com/codeceptjs/CodeceptJS/compare/4.0.0-rc.21...4.0.0-rc.22

src/content/docs/typescript.md

@@ -12,7 +12,7 @@ CodeceptJS ships [type declarations](https://github.com/codeceptjs/CodeceptJS/tr
 ? Do you plan to write tests in TypeScript? Yes
 ```
 
-It writes `codecept.conf.ts` and `*_test.ts` files. The **config file** and helpers are transpiled automatically. **Test files** need a loader — CodeceptJS 4.x is ESM, and Mocha loads test files through CommonJS hooks, so use [`tsx`](https://tsx.is) (fast, esbuild-based, no `tsconfig.json` required):
+It writes `codecept.conf.ts` and `*_test.ts` files. The **config file** and helpers are transpiled automatically. **Test files** need a loader — CodeceptJS 4.x is ESM and loads test files as ES Modules, so use [`tsx`](https://tsx.is) (fast, esbuild-based, no `tsconfig.json` required):
 
 ```sh
 npm i tsx --save-dev
@@ -22,16 +22,16 @@ npm i tsx --save-dev
 // codecept.conf.ts
 export const config = {
   tests: './**/*_test.ts',
-  require: ['tsx/cjs'],   // loads the *_test.ts files
+  require: ['tsx/esm'],   // loads the *_test.ts files as ES Modules
   helpers: {
     Playwright: { url: 'http://localhost', browser: 'chromium' },
   },
 }
 ```
 
-Run the tests with `npx codeceptjs run`.
+Set `"type": "module"` in `package.json` so `tsx` compiles your `.ts` test files as ES Modules. Then run the tests with `npx codeceptjs run`.
 
-> Adding TypeScript to an existing project: set `"type": "module"` in `package.json`, rename the config to `codecept.conf.ts` with `export const config = {}`, install `tsx`, and add `require: ['tsx/cjs']`.
+> Adding TypeScript to an existing project: set `"type": "module"` in `package.json`, rename the config to `codecept.conf.ts` with `export const config = {}`, install `tsx`, and add `require: ['tsx/esm']`.
 
 ## Writing tests
 
@@ -56,7 +56,9 @@ Scenario('admin signs in', ({ I }) => {
 })
 ```
 
-> **Cannot find module** or **Unexpected token** while running tests means the loader isn't wired up — check that `tsx` is installed and `require: ['tsx/cjs']` is in the config.
+> **Cannot find module** or **Unexpected token** while running tests means the loader isn't wired up — check that `tsx` is installed and `require: ['tsx/esm']` is in the config.
+>
+> **`ERR_REQUIRE_CYCLE_MODULE`** means `tsx` is compiling your `.ts` tests as CommonJS — add `"type": "module"` to the nearest `package.json`.
 
 ## Promise-based typings