@lumjs/tests 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -11,6 +11,15 @@ and a reference to a property of a module will be in `@tests.propName` format.
 
 ## [Unreleased]
 
+## [2.1.1] - 2025-11-26
+### Fixed / Changed
+- The Harness (and `lumtest.js` script) can now handle ES Module test files.
+  Unlike CommonJS, you need to explicitly export the test instance!
+- I have marked this as requiring Node.js v22 or higher.
+  That is mostly due to how the `node` plugin works, as it currently uses 
+  `require()` for all test files regardless as to if they are CommonJS
+  or ES Modules, and that will explode on older Node.js versions.
+
 ## [2.1.0] - 2025-11-26
 ### Changed
 - Bumped core version to newest release with changes to _stringify_.
@@ -204,7 +213,9 @@ and a reference to a property of a module will be in `@tests.propName` format.
 - Ported from Lum.js v4 library set.
 - Added a few more features from the PHP version.
 
-[Unreleased]: https://github.com/supernovus/lum.tests.js/compare/v2.0.0...HEAD
+[Unreleased]: https://github.com/supernovus/lum.tests.js/compare/v2.1.1...HEAD
+[2.1.1]: https://github.com/supernovus/lum.tests.js/compare/v2.1.0...v2.1.1
+[2.1.0]: https://github.com/supernovus/lum.tests.js/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/supernovus/lum.tests.js/compare/v1.9.0...v2.0.0
 [1.9.0]: https://github.com/supernovus/lum.tests.js/compare/v1.8.0...v1.9.0
 [1.8.0]: https://github.com/supernovus/lum.tests.js/compare/v1.7.1...v1.8.0

package/TODO.md

@@ -1,7 +1,5 @@
 # TODO
 
-- Add explicit support for running ES Module based tests.
-- An alternative to passing `module` object to test instances.
 - Write tests for:
   - `call()`
   - `diesWith()`
@@ -11,4 +9,3 @@
   - `async()` (currently used in `@lumjs/encode:v2.0.0` package).
 - Test the `harness/parser` and associated `grammar/tap` libraries.
 - Test the *external* test mode in `Harness`.
-

package/lib/harness/plugin/node.js

@@ -1,6 +1,6 @@
 // Node.js harness plugin
 const core = require('@lumjs/core');
-const {N,F,S} = core.types;
+const {N,F,S,isObj} = core.types;
 const Plugin = require('./index');
 const cp = require('node:child_process');
 const getCwd = require('node:process').cwd;
@@ -8,6 +8,7 @@ const fs = require('node:fs');
 const path = require('node:path');
 const RE = /[\/\(\[]+/;
 const WS = /\s+/g;
+const MJS_EXPS = ['default','test'];
 
 /**
  * Node.js Harness plugin
@@ -20,7 +21,16 @@ class NodePlugin extends Plugin
   runInternal(queued)
   {
     let name = path.join(getCwd(), queued.filename);
-    return require(name);
+    let mod = require(name);
+    if (!(mod instanceof Stats)) {
+      for (let exp of MJS_EXPS) {
+        if (mod[exp] instanceof Stats) {
+          return mod[exp];
+        }
+      }
+      throw new Error("test files MUST export the Test instance");
+    }
+    return mod;
   }
 
   runExternal(queued)
@@ -97,3 +107,5 @@ class NodePlugin extends Plugin
 } // Node plugin class
 
 module.exports = NodePlugin;
+
+const Stats = require('../../test/stats');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumjs/tests",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "main": "lib/index.js",
   "bin":
   {
@@ -30,12 +30,15 @@
     "@lumjs/core": "^1.38.4"
   },
   "scripts": {
-    "test": "./bin/lumtest.js",
+    "test": "./bin/lumtest.js -e '\\.[mc]?js$'",
     "build-docs": "jsdoc -c ./jsdoc.json",
     "build": "npm run build:grammar",
     "build:grammar": "./bin/build-grammar.sh tap"
   },
   "devDependencies": {
     "peggy": "^2.0.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
   }
 }