@lumjs/tests 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -11,6 +11,20 @@ and a reference to a property of a module will be in `@tests.propName` format.
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-01-30
+### Changed
+- Updated to reflect several changes in `@lumjs/core` in regards to deprecated
+  functions, etc. There's more to do yet, but it's a start!
+
+## [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 +218,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,7 @@
 # TODO
 
-- Add explicit support for running ES Module based tests.
-- An alternative to passing `module` object to test instances.
+- Update the `peggy` package to the v5.x releases.
+
 - Write tests for:
   - `call()`
   - `diesWith()`
@@ -11,4 +11,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','t'];
 
 /**
  * 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/lib/index.js

@@ -2,9 +2,8 @@
  * Several test related classes.
  * @module @lumjs/tests
  */
-const {def,lazy} = require('@lumjs/core/types');
-
-const E = def.e;
+const {df,lazy} = require('@lumjs/core');
+const E = {enumerable: true};
 
 /**
  * The main Test class
@@ -13,7 +12,7 @@ const E = def.e;
  * @class
  * @see module:@lumjs/tests/test
  */
-def(exports, 'Test', require('./test'), E);
+df(exports, 'Test', require('./test'), E);
 
 /**
  * Test Harness class (lazy loaded)

package/lib/test/stats.js

@@ -1,5 +1,6 @@
 const core = require('@lumjs/core');
 const mods = require('@lumjs/core/modules');
+const describe = require('@lumjs/describe');
 const {types} = core;
 const {S,N,F,isObj,def} = types;
 const Log = require('./log');
@@ -144,7 +145,7 @@ class LumTestStats
 
   stringify(what)
   {
-    return types.stringify(what, this.stringifyOpts);
+    return describe(what, this.stringifyOpts);
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumjs/tests",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "main": "lib/index.js",
   "bin":
   {
@@ -27,15 +27,19 @@
   },
   "dependencies": 
   {
-    "@lumjs/core": "^1.38.4"
+    "@lumjs/core": "^1.38.6",
+    "@lumjs/describe": "^1.0.0"
   },
   "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"
   }
 }