refactor: eliminate internal globals in favor of store singleton and direct imports

Replace all internal global variable usage with proper ESM patterns:
- Add store.initialize() method with immutable required fields (codeceptDir, outputDir, workerMode)
- Replace global.codecept_dir/output_dir reads with store.codeceptDir/outputDir (~55 sites)
- Replace global.container reads with direct container imports (~15 sites)
- Replace global.debugMode with store.debugMode in WebDriver/Puppeteer
- Replace process.env.RUNS_WITH_WORKERS with store.workerMode
- Replace process.env.FEATURE_ONLY/SCENARIO_ONLY with store.featureOnly/scenarioOnly
- Replace global.maskSensitiveData with store.maskSensitiveData
- Convert singleton guard globals to module-level variables
- Remove dead global.codecept_debug
- Keep user-facing DSL globals (Feature, Scenario, etc.) and backward compat writes

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

Author: DavertMik

lib/ai.js

@@ -7,6 +7,7 @@ import { generateText } from 'ai'
 import { fileURLToPath } from 'url'
 import path from 'path'
 import { fileExists } from './utils.js'
+import store from './store.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 
@@ -24,8 +25,8 @@ async function loadPrompts() {
   for (const name of promptNames) {
     let promptPath
 
-    if (global.codecept_dir) {
-      promptPath = path.join(global.codecept_dir, `prompts/${name}.js`)
+    if (store.codeceptDir) {
+      promptPath = path.join(store.codeceptDir, `prompts/${name}.js`)
     }
 
     if (!promptPath || !fileExists(promptPath)) {

lib/codecept.js

@@ -21,6 +21,7 @@ import { emptyFolder } from './utils.js'
 import { initCodeceptGlobals } from './globals.js'
 import { validateTypeScriptSetup, getTSNodeESMWarning } from './utils/loaderCheck.js'
 import recorder from './recorder.js'
+import store from './store.js'
 
 import storeListener from './listener/store.js'
 import stepsListener from './listener/steps.js'
@@ -71,7 +72,7 @@ class Codecept {
         } else {
           // For npm packages, resolve from the user's directory
           // This ensures packages like tsx are found in user's node_modules
-          const userDir = global.codecept_dir || process.cwd()
+          const userDir = store.codeceptDir || process.cwd()
 
           try {
             // Use createRequire to resolve from user's directory
@@ -102,8 +103,6 @@ class Codecept {
     await this.requireModules(this.requiringModules)
     // initializing listeners
     await container.create(this.config, this.opts)
-    // Store container globally for easy access
-    global.container = container
     await this.runHooks()
   }
 
@@ -171,7 +170,7 @@ class Codecept {
    */
   loadTests(pattern) {
     const options = {
-      cwd: global.codecept_dir,
+      cwd: store.codeceptDir,
     }
 
     let patterns = [pattern]
@@ -203,7 +202,7 @@ class Codecept {
         globSync(pattern, options).forEach(file => {
           if (file.includes('node_modules')) return
           if (!fsPath.isAbsolute(file)) {
-            file = fsPath.join(global.codecept_dir, file)
+            file = fsPath.join(store.codeceptDir, file)
           }
           if (!this.testFiles.includes(fsPath.resolve(file))) {
             this.testFiles.push(fsPath.resolve(file))
@@ -293,7 +292,7 @@ class Codecept {
 
       if (test) {
         if (!fsPath.isAbsolute(test)) {
-          test = fsPath.join(global.codecept_dir, test)
+          test = fsPath.join(store.codeceptDir, test)
         }
         const testBasename = fsPath.basename(test, '.js')
         const testFeatureBasename = fsPath.basename(test, '.feature')

lib/command/dryRun.js

@@ -50,7 +50,7 @@ async function printTests(files) {
   const { default: figures } = await import('figures')
   const { default: colors } = await import('chalk')
 
-  output.print(output.styles.debug(`Tests from ${global.codecept_dir}:`))
+  output.print(output.styles.debug(`Tests from ${store.codeceptDir}:`))
   output.print()
 
   const mocha = Container.mocha()

lib/command/generate.js

@@ -5,6 +5,7 @@ import { mkdirp } from 'mkdirp'
 import path from 'path'
 import { fileExists, ucfirst, lcfirst, beautify } from '../utils.js'
 import output from '../output.js'
+import store from '../store.js'
 import generateDefinitions from './definitions.js'
 import { getConfig, getTestRoot, safeFileWrite, readConfig } from './utils.js'
 
@@ -20,6 +21,7 @@ Scenario('test something', async ({ {{actor}} }) => {
 // generates empty test
 export async function test(genPath) {
   const testsPath = getTestRoot(genPath)
+  store.codeceptDir = testsPath
   global.codecept_dir = testsPath
   const config = await getConfig(testsPath)
   if (!config) return

lib/command/gherkin/snippets.js

@@ -8,6 +8,7 @@ import fsPath from 'path'
 import { getConfig, getTestRoot } from '../utils.js'
 import Codecept from '../../codecept.js'
 import output from '../../output.js'
+import store from '../../store.js'
 import { matchStep } from '../../mocha/bdd.js'
 
 const uuidFn = IdGenerator.uuid()
@@ -43,9 +44,9 @@ export default async function (genPath, options) {
   }
 
   const files = []
-  globSync(options.feature || config.gherkin.features, { cwd: options.feature ? '.' : global.codecept_dir }).forEach(file => {
+  globSync(options.feature || config.gherkin.features, { cwd: options.feature ? '.' : store.codeceptDir }).forEach(file => {
     if (!fsPath.isAbsolute(file)) {
-      file = fsPath.join(global.codecept_dir, file)
+      file = fsPath.join(store.codeceptDir, file)
     }
     files.push(fsPath.resolve(file))
   })
@@ -92,7 +93,7 @@ export default async function (genPath, options) {
       if (child.scenario.keyword === 'Scenario Outline') continue // skip scenario outline
       parseSteps(child.scenario.steps)
         .map(step => {
-          return Object.assign(step, { file: file.replace(global.codecept_dir, '').slice(1) })
+          return Object.assign(step, { file: file.replace(store.codeceptDir, '').slice(1) })
         })
         .map(step => newSteps.set(`${step.type}(${step})`, step))
     }
@@ -107,7 +108,7 @@ export default async function (genPath, options) {
   }
 
   if (!fsPath.isAbsolute(stepFile)) {
-    stepFile = fsPath.join(global.codecept_dir, stepFile)
+    stepFile = fsPath.join(store.codeceptDir, stepFile)
   }
 
   const snippets = [...newSteps.values()]

lib/command/run-multiple.js

@@ -8,6 +8,7 @@ import event from '../event.js'
 import { createRuns } from './run-multiple/collection.js'
 import { clearString, replaceValueDeep } from '../utils.js'
 import { getConfig, getTestRoot, fail } from './utils.js'
+import store from '../store.js'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
@@ -35,6 +36,7 @@ export default async function (selectedRuns, options) {
   const configFile = options.config
 
   const testRoot = getTestRoot(configFile)
+  store.codeceptDir = testRoot
   global.codecept_dir = testRoot
 
   // copy opts to run

lib/command/run-workers.js

@@ -41,7 +41,7 @@ export default async function (workerCount, selectedRuns, options) {
   output.print(`CodeceptJS v${Codecept.version()} ${output.standWithUkraine()}`)
   output.print(`Running tests in ${output.styles.bold(numberOfWorkers)} workers...`)
   store.hasWorkers = true
-  process.env.RUNS_WITH_WORKERS = 'true'
+  store.workerMode = true
 
   const workers = new Workers(numberOfWorkers, config)
   workers.overrideConfig(overrideConfigs)

lib/command/run.js

@@ -32,7 +32,7 @@ export default async function (test, options) {
     codecept.loadTests(test)
 
     if (options.verbose) {
-      global.debugMode = true
+      store.debugMode = true
       const { getMachineInfo } = await import('./info.js')
       await getMachineInfo()
     }

lib/command/workers/runTests.js

@@ -21,8 +21,8 @@ const { options, tests, testRoot, workerIndex, poolMode } = workerData
 
 // Global error handlers to catch critical errors but not test failures
 process.on('uncaughtException', (err) => {
-  if (global.container?.tsFileMapping && fixErrorStack) {
-    const fileMapping = global.container.tsFileMapping()
+  if (container?.tsFileMapping && fixErrorStack) {
+    const fileMapping = container.tsFileMapping()
     if (fileMapping) {
       fixErrorStack(err, fileMapping)
     }
@@ -40,8 +40,8 @@ process.on('uncaughtException', (err) => {
 })
 
 process.on('unhandledRejection', (reason, promise) => {
-  if (reason && typeof reason === 'object' && reason.stack && global.container?.tsFileMapping && fixErrorStack) {
-    const fileMapping = global.container.tsFileMapping()
+  if (reason && typeof reason === 'object' && reason.stack && container?.tsFileMapping && fixErrorStack) {
+    const fileMapping = container.tsFileMapping()
     if (fileMapping) {
       fixErrorStack(reason, fileMapping)
     }
@@ -163,8 +163,8 @@ initPromise = (async function () {
       // IMPORTANT: await is required here since getConfig is async
       baseConfig = await getConfig(options.config || testRoot)
     } catch (configErr) {
-      if (global.container?.tsFileMapping && fixErrorStack) {
-        const fileMapping = global.container.tsFileMapping()
+      if (container?.tsFileMapping && fixErrorStack) {
+        const fileMapping = container.tsFileMapping()
         if (fileMapping) {
           fixErrorStack(configErr, fileMapping)
         }
@@ -185,8 +185,8 @@ initPromise = (async function () {
     try {
       await codecept.init(testRoot)
     } catch (initErr) {
-      if (global.container?.tsFileMapping && fixErrorStack) {
-        const fileMapping = global.container.tsFileMapping()
+      if (container?.tsFileMapping && fixErrorStack) {
+        const fileMapping = container.tsFileMapping()
         if (fileMapping) {
           fixErrorStack(initErr, fileMapping)
         }
@@ -218,8 +218,8 @@ initPromise = (async function () {
       parentPort?.close()
     }
   } catch (err) {
-    if (global.container?.tsFileMapping && fixErrorStack) {
-      const fileMapping = global.container.tsFileMapping()
+    if (container?.tsFileMapping && fixErrorStack) {
+      const fileMapping = container.tsFileMapping()
       if (fileMapping) {
         fixErrorStack(err, fileMapping)
       }

lib/container.js

@@ -672,7 +672,7 @@ async function createPlugins(config, options = {}) {
       continue
     }
 
-    if (!options.child && process.env.RUNS_WITH_WORKERS === 'true' && !runInParent) {
+    if (!options.child && store.workerMode && !runInParent) {
       continue
     }
     let module
@@ -681,7 +681,7 @@ async function createPlugins(config, options = {}) {
         module = pluginConfig.require
         if (module.startsWith('.')) {
           // local
-          module = path.resolve(global.codecept_dir, module) // custom plugin
+          module = path.resolve(store.codeceptDir, module) // custom plugin
         }
       } else {
         module = `./plugin/${pluginName}.js`
@@ -716,7 +716,7 @@ async function loadGherkinStepsAsync(paths) {
       bddModule.clearCurrentStepFile()
     }
   } else {
-    const folderPath = paths.startsWith('.') ? normalizeAndJoin(global.codecept_dir, paths) : ''
+    const folderPath = paths.startsWith('.') ? normalizeAndJoin(store.codeceptDir, paths) : ''
     if (folderPath !== '') {
       const files = globSync(folderPath)
       for (const file of files) {
@@ -764,7 +764,7 @@ async function loadSupportObject(modulePath, supportObjectName) {
     }
   }
   if (typeof modulePath === 'string' && modulePath.charAt(0) === '.') {
-    modulePath = path.join(global.codecept_dir, modulePath)
+    modulePath = path.join(store.codeceptDir, modulePath)
   }
   try {
     // Use dynamic import for both ESM and CJS modules
@@ -888,7 +888,7 @@ async function loadTranslation(locale, vocabularies) {
   const langs = await Translation.getLangs()
   if (langs[locale]) {
     translation = new Translation(langs[locale])
-  } else if (fileExists(path.join(global.codecept_dir, locale))) {
+  } else if (fileExists(path.join(store.codeceptDir, locale))) {
     // get from a provided file instead
     translation = Translation.createDefault()
     translation.loadVocabulary(locale)
@@ -905,7 +905,7 @@ function getHelperModuleName(helperName, config) {
   // classical require
   if (config[helperName].require) {
     if (config[helperName].require.startsWith('.')) {
-      let helperPath = path.resolve(global.codecept_dir, config[helperName].require)
+      let helperPath = path.resolve(store.codeceptDir, config[helperName].require)
       // Add .js extension if not present for ESM compatibility
       if (!path.extname(helperPath)) {
         helperPath += '.js'