fix(ci): npm link codeceptjs in CI; drop dead joi types reference

* `@codeceptjs/configure` and `@codeceptjs/expect-helper` both do
  `require('codeceptjs')` from inside their own packages. End users
  installing codeceptjs into a project's node_modules resolve fine —
  but in this repo (where the project IS codeceptjs) Node has nothing
  at node_modules/codeceptjs to resolve to, so those imports throw and
  helper/plugin loading fails on every CI run. Add `npm link && npm
  link codeceptjs` after install in playwright/puppeteer/webdriver/
  plugin/dtslint/test workflows. Documented in CLAUDE.md.

* `lib/plugin/browser.js`: route through `setBrowserConfig` from
  `@codeceptjs/configure` instead of duplicating the helper-mutation
  logic inline. The configure dep is the right primitive — removing
  the duplicate, single source of truth.

* `typings/index.d.ts`: drop `/// <reference types="joi" />`. joi is
  not used in any public type, the directive was leftover from a prior
  incarnation, and it broke `dtslint` (which looks for `@types/joi`,
  doesn't exist) and the def-runner test (failed-resolution alignment
  produced an undefined `resolutionDiagnostics` access in newer TS).

* Docs: `docs/configuration.md` setCommonPlugins table aligned with
  4.x plugin set (no eachElement, pauseOn instead of pauseOnFail);
  `docs/plugins.md` regen with aiTrace section.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: DavertMik

.github/workflows/dtslint.yml

@@ -28,5 +28,10 @@ jobs:
         env:
           PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: true
           PUPPETEER_SKIP_CHROMIUM_DOWNLOAD: true
+      # @codeceptjs/configure & @codeceptjs/expect-helper do `require('codeceptjs')`;
+      # in this repo (where the project IS codeceptjs) Node has nothing at
+      # node_modules/codeceptjs to resolve to. `npm link` fills the gap.
+      # End users don't need this.
+      - run: npm link && npm link codeceptjs
       - run: npm run def
       - run: npm run dtslint

.github/workflows/playwright.yml

@@ -40,6 +40,11 @@ jobs:
           npm i --force
         env:
           PUPPETEER_SKIP_CHROMIUM_DOWNLOAD: true
+      # @codeceptjs/configure & @codeceptjs/expect-helper do `require('codeceptjs')`;
+      # in this repo (where the project IS codeceptjs) Node has nothing at
+      # node_modules/codeceptjs to resolve to. `npm link` fills the gap.
+      # End users don't need this.
+      - run: npm link && npm link codeceptjs
       - name: Allow Release info Change
         run: |
           sudo apt-get update --allow-releaseinfo-change

.github/workflows/plugin.yml

@@ -40,6 +40,11 @@ jobs:
           npm i --force
         env:
           PUPPETEER_SKIP_CHROMIUM_DOWNLOAD: true
+      # @codeceptjs/configure & @codeceptjs/expect-helper do `require('codeceptjs')`;
+      # in this repo (where the project IS codeceptjs) Node has nothing at
+      # node_modules/codeceptjs to resolve to. `npm link` fills the gap.
+      # End users don't need this.
+      - run: npm link && npm link codeceptjs
       - name: Allow Release info Change
         run: |
           sudo apt-get update --allow-releaseinfo-change

.github/workflows/puppeteer.yml

@@ -40,6 +40,11 @@ jobs:
           npm i --force && npm i puppeteer --force
         env:
           PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: true
+      # @codeceptjs/configure & @codeceptjs/expect-helper do `require('codeceptjs')`;
+      # in this repo (where the project IS codeceptjs) Node has nothing at
+      # node_modules/codeceptjs to resolve to. `npm link` fills the gap.
+      # End users don't need this.
+      - run: npm link && npm link codeceptjs
       - name: Start mock server
         run: nohup npm run mock-server:start &
       - name: Wait for mock server

.github/workflows/test.yml

@@ -32,6 +32,12 @@ jobs:
         env:
           PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: true
           PUPPETEER_SKIP_CHROMIUM_DOWNLOAD: true
+      # @codeceptjs/configure does `import 'codeceptjs'`; in this repo (where
+      # the project IS codeceptjs) Node has nothing at node_modules/codeceptjs
+      # to resolve to. `npm link` fills in that gap so configure shares our
+      # Config singleton. End users don't need this — they install codeceptjs
+      # into their project's node_modules normally.
+      - run: npm link && npm link codeceptjs
       - name: Start mock server
         run: nohup npm run mock-server:start &
       - name: Wait for mock server
@@ -72,6 +78,12 @@ jobs:
         env:
           PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: true
           PUPPETEER_SKIP_CHROMIUM_DOWNLOAD: true
+      # @codeceptjs/configure does `import 'codeceptjs'`; in this repo (where
+      # the project IS codeceptjs) Node has nothing at node_modules/codeceptjs
+      # to resolve to. `npm link` fills in that gap so configure shares our
+      # Config singleton. End users don't need this — they install codeceptjs
+      # into their project's node_modules normally.
+      - run: npm link && npm link codeceptjs
       - name: Start mock server
         run: nohup npm run mock-server:start &
       - name: Wait for mock server

.github/workflows/webdriver.yml

@@ -41,6 +41,11 @@ jobs:
         env:
           PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: true
           PUPPETEER_SKIP_CHROMIUM_DOWNLOAD: true
+      # @codeceptjs/configure & @codeceptjs/expect-helper do `require('codeceptjs')`;
+      # in this repo (where the project IS codeceptjs) Node has nothing at
+      # node_modules/codeceptjs to resolve to. `npm link` fills the gap.
+      # End users don't need this.
+      - run: npm link && npm link codeceptjs
       - name: Start mock server
         run: nohup npm run mock-server:start &
       - name: Wait for mock server

CLAUDE.md

@@ -7,6 +7,16 @@ This project is migrating from 3.x to ESM replacing all require() calls with imp
 Each time unsure what to do refer to the same file implementation in **3.x branch**
 3.x branch contains stable version of all core classes that work
 
+## Local Development Setup
+
+After `npm install`, run once:
+
+```
+npm link && npm link codeceptjs
+```
+
+This makes `node_modules/codeceptjs` resolve back to the project root. Required because `@codeceptjs/configure` (a runtime dep) does `import 'codeceptjs'` — and in this repo the project itself IS codeceptjs, so without the link Node has nothing at `node_modules/codeceptjs` to resolve to. CI runs the same two commands automatically (see `.github/workflows/test.yml`). End users don't need this — they install codeceptjs into their own project's node_modules normally.
+
 ## Running Tests
 
 Focus on acceptance tests:

docs/configuration.md

@@ -197,12 +197,13 @@ setCommonPlugins()
 | Plugin             | Default        | Notes                                                                          |
 | :----------------- | :------------- | :----------------------------------------------------------------------------- |
 | `retryFailedStep`  | enabled        | Retry steps that fail with transient errors                                    |
-| `eachElement`      | enabled        | Provides `eachElement` effect                                                  |
 | `screenshotOnFail` | enabled        | Capture a screenshot when a test fails                                         |
-| `pauseOnFail`      | registered     | Activate via `-p pauseOnFail`                                                  |
+| `pauseOn`          | registered     | Pause on failure / step / file / URL — `-p pauseOn:fail`, `-p pauseOn:step`, `-p pauseOn:file:tests/login_test.js`, `-p pauseOn:url:/checkout/*` |
 | `browser`          | registered     | CLI overrides for browser helpers — `-p browser:show`, `-p browser:browser=firefox`, see [commands](/commands#browser-control) |
 | `aiTrace`          | registered     | Capture AI traces — `-p aiTrace`                                               |
 
+> `eachElement`, `tryTo`, and `retryTo` are no longer plugins in 4.x — import them from `codeceptjs/effects`.
+
 ## Profile
 
 Using `process.env.profile` you can change the config dynamically.