introduce engine.js

package.json

@@ -37,14 +37,16 @@
     "bin/babel.cjs",
     "bin/jest.js",
     "src/dark.cjs",
+    "src/engine.js",
+    "src/engine.node.cjs",
+    "src/engine.select.cjs",
     "src/jest.js",
     "src/jest.config.js",
     "src/jest.environment.js",
     "src/jest.fn.js",
     "src/jest.mock.js",
     "src/jest.snapshot.js",
     "src/jest.timers.js",
-    "src/node.js",
     "src/tape.js",
     "src/version.js",
     "!__tests__",

src/engine.js

@@ -0,0 +1,19 @@
+import engine from './engine.select.cjs' // need to be sync for non-preloaded imports into cjs
+
+const { assert, assertLoose } = engine
+export { assert, assertLoose }
+
+const { mock, describe, test, beforeEach, afterEach, before, after } = engine
+export { mock, describe, test, beforeEach, afterEach, before, after }
+
+const { builtinModules, syncBuiltinESMExports } = engine
+export { builtinModules, syncBuiltinESMExports }
+
+const { utilFormat, isPromise, nodeVersion } = engine
+export { utilFormat, isPromise, nodeVersion }
+
+const { baseFile, relativeRequire, isTopLevelESM } = engine
+export { baseFile, relativeRequire, isTopLevelESM }
+
+const { snapshot, readSnapshot, setSnapshotSerializers, setSnapshotResolver } = engine
+export { snapshot, readSnapshot, setSnapshotSerializers, setSnapshotResolver }

src/engine.node.cjs

@@ -0,0 +1,39 @@
+const assert = require('node:assert/strict')
+const assertLoose = require('node:assert')
+const { types, format: utilFormat } = require('node:util')
+const { existsSync, readFileSync } = require('node:fs')
+const { normalize, basename, dirname, join: pathJoin } = require('node:path')
+const { createRequire, builtinModules, syncBuiltinESMExports } = require('node:module')
+const nodeTest = require('node:test')
+
+const { mock, describe, test, beforeEach, afterEach, before, after } = nodeTest
+
+const isPromise = types.isPromise
+const nodeVersion = process.versions.node
+
+const files = process.argv.slice(1)
+const baseFile = files.length === 1 && existsSync(files[0]) ? normalize(files[0]) : undefined
+
+const relativeRequire = baseFile ? createRequire(baseFile) : require
+const isTopLevelESM = () => !baseFile || !Object.hasOwn(relativeRequire.cache, baseFile) // assume ESM otherwise
+
+const snapshot = nodeTest.snapshot
+let snapshotResolver = (dir, name) => [dir, `${name}.snapshot`] // default per Node.js docs
+const resolveSnapshot = (f) => pathJoin(...snapshotResolver(dirname(f), basename(f)))
+const readSnapshot = (f = baseFile) => (f ? readFileSync(resolveSnapshot(f), 'utf8') : null)
+const setSnapshotSerializers = (list) => snapshot?.setDefaultSnapshotSerializers(list)
+const setSnapshotResolver = (fn) => {
+  snapshotResolver = fn
+  snapshot?.setResolveSnapshotPath(resolveSnapshot)
+}
+
+/* eslint-disable unicorn/no-useless-spread */
+module.exports = {
+  ...{ assert, assertLoose },
+  ...{ mock, describe, test, beforeEach, afterEach, before, after },
+  ...{ builtinModules, syncBuiltinESMExports },
+  ...{ utilFormat, isPromise, nodeVersion },
+  ...{ baseFile, relativeRequire, isTopLevelESM },
+  ...{ snapshot, readSnapshot, setSnapshotSerializers, setSnapshotResolver },
+}
+/* eslint-enable unicorn/no-useless-spread */

src/engine.select.cjs

@@ -0,0 +1 @@
+module.exports = require('./engine.node.cjs')

src/jest.config.js

@@ -1,4 +1,4 @@
-// Not using ./node.js yet
+// Not using ./engine.js yet, might pass / embed already loaded config instead
 import assert from 'node:assert/strict'
 import { readFile } from 'node:fs/promises'
 import { existsSync } from 'node:fs'

src/jest.fn.js

@@ -1,4 +1,4 @@
-import { mock, assert } from './node.js'
+import { mock, assert } from './engine.js'
 
 const registry = new Set()
 let callId = 0

src/jest.js

@@ -6,7 +6,7 @@ import {
   assert,
   utilFormat,
   isPromise,
-} from './node.js'
+} from './engine.js'
 import { jestConfig } from './jest.config.js'
 import { jestFunctionMocks } from './jest.fn.js'
 import { jestModuleMocks } from './jest.mock.js'
@@ -190,4 +190,4 @@ const jest = {
 
 export { jest, describe, test, test as it }
 export { expect } from 'expect'
-export { beforeEach, afterEach, before as beforeAll, after as afterAll } from './node.js'
+export { beforeEach, afterEach, before as beforeAll, after as afterAll } from './engine.js'

src/jest.mock.js

@@ -6,7 +6,7 @@ import {
   isTopLevelESM,
   builtinModules,
   syncBuiltinESMExports,
-} from './node.js'
+} from './engine.js'
 import { jestfn } from './jest.fn.js'
 import { makeEsbuildMockable } from './dark.cjs'
 

src/jest.snapshot.js

@@ -5,7 +5,7 @@ import {
   setSnapshotSerializers,
   readSnapshot,
   relativeRequire,
-} from './node.js'
+} from './engine.js'
 import { expect } from 'expect'
 import { format, plugins as builtinPlugins } from 'pretty-format'
 import { jestConfig } from './jest.config.js'

src/jest.timers.js

@@ -1,4 +1,4 @@
-import { mock, assert } from './node.js'
+import { mock, assert } from './engine.js'
 import { jestConfig } from './jest.config.js'
 import { haveValidTimers, haveNoTimerInfiniteLoopBug } from './version.js'
 

src/tape.js

@@ -1,4 +1,4 @@
-import { assert, assertLoose, test } from './node.js'
+import { assert, assertLoose, test } from './engine.js'
 import { createCallerLocationHook } from './dark.cjs'
 import './version.js'
 

src/version.js

@@ -1,4 +1,4 @@
-import { assert, nodeVersion } from './node.js'
+import { assert, nodeVersion } from './engine.js'
 
 const [major, minor, patch] = nodeVersion.split('.').map(Number)
 assert(major !== 21, 'Node.js 21.x is deprecated!') // reached EOL, no reason to even test