refactor: install globalThis.codeceptjs from each suite's own bootstrap

Drop the side-effect block from lib/codecept.js. The framework now lets
each test suite own the registry install via its own bootstrap script:

- mocha-driven tests (unit, runner, rest): .mocharc → test/support/setup.mjs
  already runs before every file. setup.mjs calls installCodeceptjs().
- codeceptjs-runner-driven acceptance suites: each codecept.*.js config
  references installCodeceptjs as its `bootstrap` field. The runner
  invokes bootstrap after container.create and before tests start, so
  globalThis.codeceptjs is in place by the time @codeceptjs/expect-helper's
  Proxy is read at I.expect*() call time.

The shared installer lives in test/support/install-codeceptjs.js — five
lines, one job, idempotent. WebDriver's existing 5s selenium-wait
bootstrap calls installCodeceptjs() then waits, in that order.

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

Author: DavertMik

lib/codecept.js

@@ -33,16 +33,6 @@ import globalRetryListener from './listener/globalRetry.js'
 import exitListener from './listener/exit.js'
 import emptyRunListener from './listener/emptyRun.js'
 
-// Companion packages (@codeceptjs/configure, @codeceptjs/expect-helper,
-// @codeceptjs/helper) read framework singletons through globalThis.codeceptjs.
-// `@codeceptjs/configure` in particular runs at the top of a user's
-// codecept.conf.js, before `Config.load` returns — so the registry has to
-// exist by the time this module is imported, not later during init.
-// In tests we install the same handle from .mocharc → test/support/setup.mjs.
-if (!globalThis.codeceptjs) {
-  globalThis.codeceptjs = { config: Config, container, event, output, recorder, Helper }
-}
-
 /**
  * CodeceptJS runner
  */

test/acceptance/codecept.Playwright.coverage.js

@@ -1,4 +1,5 @@
 import TestHelper from '../support/TestHelper.js'
+import installCodeceptjs from '../support/install-codeceptjs.js'
 
 export const config = {
   tests: './*_test.js',
@@ -28,7 +29,7 @@ export const config = {
     },
   },
   include: {},
-  bootstrap: false,
+  bootstrap: installCodeceptjs,
   mocha: {},
   plugins: {
     screenshotOnFail: {

test/acceptance/codecept.Playwright.js

@@ -1,4 +1,5 @@
 import TestHelper from '../support/TestHelper.js'
+import installCodeceptjs from '../support/install-codeceptjs.js'
 
 export const config = {
   tests: './*_test.js',
@@ -31,7 +32,7 @@ export const config = {
     '@codeceptjs/expect-helper': {},
   },
   include: {},
-  bootstrap: false,
+  bootstrap: installCodeceptjs,
   mocha: {},
   plugins: {
     screenshotOnFail: {

test/acceptance/codecept.Puppeteer.js

@@ -1,4 +1,5 @@
 import TestHelper from '../support/TestHelper.js'
+import installCodeceptjs from '../support/install-codeceptjs.js'
 
 export const config = {
   tests: './*_test.js',
@@ -21,7 +22,7 @@ export const config = {
     },
   },
   include: {},
-  bootstrap: false,
+  bootstrap: installCodeceptjs,
   mocha: {},
   plugins: {
     screenshotOnFail: {

test/acceptance/codecept.WebDriver.js

@@ -1,4 +1,5 @@
 import TestHelper from '../support/TestHelper.js'
+import installCodeceptjs from '../support/install-codeceptjs.js'
 
 export const config = {
   tests: './*_test.js',
@@ -26,10 +27,10 @@ export const config = {
     },
   },
   include: {},
-  bootstrap: async () =>
-    new Promise(done => {
-      setTimeout(done, 5000)
-    }), // let's wait for selenium
+  bootstrap: async () => {
+    installCodeceptjs()
+    await new Promise(done => setTimeout(done, 5000)) // let's wait for selenium
+  },
   mocha: {},
   name: 'acceptance',
   plugins: {

test/support/install-codeceptjs.js

@@ -0,0 +1,16 @@
+import Helper from '@codeceptjs/helper'
+import Config from '../../lib/config.js'
+import container from '../../lib/container.js'
+import event from '../../lib/event.js'
+import output from '../../lib/output.js'
+import recorder from '../../lib/recorder.js'
+
+// Install the in-process handle that companion packages
+// (@codeceptjs/configure, @codeceptjs/expect-helper, @codeceptjs/helper)
+// read at runtime. Each test suite calls this from its own bootstrap:
+// mocha-driven tests via .mocharc → test/support/setup.mjs;
+// codeceptjs-runner-driven acceptance suites via the `bootstrap` field.
+export default function installCodeceptjs() {
+  if (globalThis.codeceptjs) return
+  globalThis.codeceptjs = { config: Config, container, event, output, recorder, Helper }
+}

test/support/setup.mjs

@@ -1,17 +1,5 @@
 import * as chai from 'chai'
-chai.should()
-
-// Install the framework registry the same way the runner does in lib/codecept.js.
-// Unit tests import lib/* modules directly (bypassing the runner), so without
-// this companion packages reaching for `globalThis.codeceptjs` (e.g.
-// @codeceptjs/configure inside the browser plugin) get an undefined handle.
-import Helper from '@codeceptjs/helper'
-import Config from '../../lib/config.js'
-import container from '../../lib/container.js'
-import event from '../../lib/event.js'
-import output from '../../lib/output.js'
-import recorder from '../../lib/recorder.js'
+import installCodeceptjs from './install-codeceptjs.js'
 
-if (!globalThis.codeceptjs) {
-  globalThis.codeceptjs = { config: Config, container, event, output, recorder, Helper }
-}
+chai.should()
+installCodeceptjs()