qunitx 0.8.3 → 0.9.1

package/package.json

@@ -1,14 +1,42 @@
 {
   "name": "qunitx",
   "type": "module",
-  "version": "0.8.3",
+  "version": "0.9.1",
   "description": "A universal test framework for testing any js file on node.js, browser or deno with QUnit API",
   "author": "Izel Nakri",
   "license": "MIT",
   "keywords": [
     "test",
-    "test framework",
     "testing",
+    "automated testing",
+    "test framework",
+    "ui testing",
+    "e2e",
+    "e2e testing",
+    "0 dependencies",
+    "zero dependencies",
+    "no dependencies",
+    "universal testing",
+    "universal test framework",
+    "universal test",
+    "universal",
+    "cross platform",
+    "cross platform testing",
+    "cross platform test framework",
+    "cross platform test",
+    "unit testing",
+    "unit test",
+    "unit",
+    "integration testing",
+    "integration test",
+    "integration",
+    "qa",
+    "quality assurance",
+    "tdd",
+    "bdd",
+    "assert",
+    "frontend",
+    "backend",
     "qunit",
     "node",
     "deno",
@@ -61,7 +89,7 @@
     "ts-node": ">=10.7.0"
   },
   "volta": {
-    "node": "20.4.0"
+    "node": "20.5.0"
   },
   "prettier": {
     "printWidth": 100,

package/shims/deno/index.js

@@ -1,48 +1,27 @@
-import {
-  afterEach,
-  beforeEach,
-  beforeAll,
-  afterAll,
-  describe,
-  it,
-} from "https://deno.land/std@0.192.0/testing/bdd.ts";
-import assert from './assert.js';
-
-// TODO: TEST beforeEach, before, afterEach, after, currently not sure if they work!
-export const module = async function(moduleName, runtimeOptions, moduleContent) {
-  let targetRuntimeOptions = moduleContent ? Object.assign(runtimeOptions, { name: moduleName }) : { name: moduleName };
-  let targetModuleContent = moduleContent ? moduleName : runtimeOptions;
-
-  return describe(assignDefaultValues(targetRuntimeOptions, { concurrency: true }), async function() {
-    return await targetModuleContent({ before: beforeAll, after: afterAll, beforeEach, afterEach }, {
-      moduleName,
-      options: runtimeOptions
-    });
-  });
+import { AssertionError as DenoAssertionError } from "https://deno.land/std@0.192.0/testing/asserts.ts";
+import '../../vendor/qunit.js';
+import Assert from '../shared/assert.js';
+import ModuleContext from '../shared/module-context.js';
+import TestContext from '../shared/test-context.js';
+import Module from './module.js';
+import Test from './test.js';
+
+export class AssertionError extends DenoAssertionError {
+  constructor(object) {
+    super(object.message);
+  }
 }
 
-export const test = async function(testName, runtimeOptions, testContent) {
-  let targetRuntimeOptions = testContent ? Object.assign(runtimeOptions, { name: testName }) : { name: testName };
-  let targetTestContent = testContent ? testContent : runtimeOptions;
+Assert.QUnit = QUnit;
+Assert.AssertionError = AssertionError;
+ModuleContext.Assert = Assert;
+TestContext.Assert = Assert;
 
-  return it(targetRuntimeOptions, async function() {
-    let metadata = { testName, options: targetRuntimeOptions, expectedTestCount: undefined };
-    return await targetTestContent(assert, metadata);
+Object.freeze(Assert);
+Object.freeze(ModuleContext);
+Object.freeze(TestContext);
 
-    if (expectedTestCount) {
-
-    }
-  });
-}
-
-function assignDefaultValues(options, defaultValues) {
-  for (let key in defaultValues) {
-    if (options[key] === undefined) {
-      options[key] = defaultValues[key];
-    }
-  }
-
-  return options;
-}
+export const module = Module;
+export const test = Test;
 
-export default { module, test, assert };
+export default { AssertionError: Assert.AssertionError, module, test, config: {} };

package/shims/deno/module.js

@@ -0,0 +1,71 @@
+import { describe, beforeAll, afterAll } from "https://deno.land/std@0.192.0/testing/bdd.ts";
+import ModuleContext from '../shared/module-context.js';
+
+// NOTE: node.js beforeEach & afterEach is buggy because the TestContext it has is NOT correct reference when called, it gets the last context
+// NOTE: QUnit expect() logic is buggy in nested modules
+// NOTE: after gets the last direct children test of the module, not last defined context of a module(last defined context is a module)
+
+export default function module(moduleName, runtimeOptions, moduleContent) {
+  let targetRuntimeOptions = moduleContent ? runtimeOptions : {};
+  let targetModuleContent = moduleContent ? moduleContent : runtimeOptions;
+  let moduleContext = new ModuleContext(moduleName);
+
+  return describe(moduleName, { concurrency: true, ...targetRuntimeOptions }, async function () {
+    let beforeHooks = [];
+    let afterHooks = [];
+
+    beforeAll(async function () {
+      Object.assign(moduleContext.context, moduleContext.moduleChain.reduce((result, module) => {
+        return Object.assign(result, module.context, {
+          steps: result.steps.concat(module.context.steps),
+          expectedAssertionCount: module.context.expectedAssertionCount
+            ? module.context.expectedAssertionCount
+            : result.expectedAssertionCount
+        });
+      }, { steps: [], expectedAssertionCount: undefined }));
+
+      for (let hook of beforeHooks) {
+        await hook.call(moduleContext.context, moduleContext.assert);
+      }
+
+      for (let i = 0, len = moduleContext.tests.length; i < len; i++) {
+        Object.assign(moduleContext.tests[i], moduleContext.context, {
+          steps: moduleContext.context.steps,
+          totalExecutedAssertions: moduleContext.context.totalExecutedAssertions,
+          expectedAssertionCount: moduleContext.context.expectedAssertionCount,
+        });
+      }
+    });
+    afterAll(async () => {
+      for (const assert of moduleContext.tests.map(testContext => testContext.assert)) {
+        await assert.waitForAsyncOps();
+      }
+
+      let targetContext = moduleContext.tests[moduleContext.tests.length - 1];
+      for (let j = afterHooks.length - 1; j >= 0; j--) {
+        await afterHooks[j].call(targetContext, targetContext.assert);
+      }
+
+      for (let i = 0, len = moduleContext.tests.length; i < len; i++) {
+        moduleContext.tests[i].finish();
+      }
+    });
+
+    targetModuleContent.call(moduleContext.context, {
+      before(beforeFn) {
+        beforeHooks[beforeHooks.length] = beforeFn;
+      },
+      beforeEach(beforeEachFn) {
+        moduleContext.beforeEachHooks[moduleContext.beforeEachHooks.length] = beforeEachFn;
+      },
+      afterEach(afterEachFn) {
+        moduleContext.afterEachHooks[moduleContext.afterEachHooks.length] = afterEachFn;
+      },
+      after(afterFn) {
+        afterHooks[afterHooks.length] = afterFn;
+      }
+    }, { moduleName, options: runtimeOptions });
+
+    ModuleContext.currentModuleChain.pop();
+  });
+}

package/shims/deno/test.js

@@ -0,0 +1,37 @@
+import { it } from "https://deno.land/std@0.192.0/testing/bdd.ts";
+import TestContext from '../shared/test-context.js';
+import ModuleContext from '../shared/module-context.js';
+
+export default function test(testName, runtimeOptions, testContent) {
+  let moduleContext = ModuleContext.lastModule;
+  if (!moduleContext) {
+    throw new Error(`Test '${testName}' called outside of module context.`);
+  }
+
+  let targetRuntimeOptions = testContent ? runtimeOptions : {};
+  let targetTestContent = testContent ? testContent : runtimeOptions;
+  let context = new TestContext(testName, moduleContext);
+
+  return it(testName, { concurrency: true, ...targetRuntimeOptions }, async function () {
+    let result;
+    for (let module of context.module.moduleChain) {
+      for (let hook of module.beforeEachHooks) {
+        await hook.call(context, context.assert);
+      }
+    }
+
+    result = await targetTestContent.call(context, context.assert, { testName, options: runtimeOptions });
+
+    await context.assert.waitForAsyncOps();
+
+    for (let i = context.module.moduleChain.length - 1; i >= 0; i--) {
+      let module = context.module.moduleChain[i];
+      for (let j = module.afterEachHooks.length - 1; j >= 0; j--) {
+        await module.afterEachHooks[j].call(context, context.assert);
+      }
+    }
+
+    return result;
+  });
+}
+

package/shims/node/index.js

@@ -1,75 +1,22 @@
-import { run, describe, it, before, after, beforeEach, afterEach } from 'node:test';
-import assert from './assert.js';
+import { AssertionError } from 'node:assert';
+import QUnit from '../../vendor/qunit.js';
+import Assert from '../shared/assert.js';
+import ModuleContext from '../shared/module-context.js';
+import TestContext from '../shared/test-context.js';
+import Module from './module.js';
+import Test from './test.js';
 
-export const module = async function(moduleName, runtimeOptions, moduleContent) {
-  let targetRuntimeOptions = moduleContent ? runtimeOptions : {};
-  let targetModuleContent = moduleContent ? moduleContent : runtimeOptions;
+Assert.QUnit = QUnit;
+Assert.AssertionError = AssertionError;
 
-  return describe(moduleName, assignDefaultValues(targetRuntimeOptions, { concurrency: true }), async function() {
-    return await targetModuleContent({ before, after, beforeEach, afterEach }, {
-      moduleName,
-      options: runtimeOptions
-    });
-  });
-}
+ModuleContext.Assert = Assert;
+TestContext.Assert = Assert;
 
-export const test = async function(testName, runtimeOptions, testContent) {
-  let targetRuntimeOptions = testContent ? runtimeOptions : {};
-  let targetTestContent = testContent ? testContent : runtimeOptions;
+Object.freeze(Assert);
+Object.freeze(ModuleContext);
+Object.freeze(TestContext);
 
-  return it(testName, assignDefaultValues(targetRuntimeOptions, { concurrency: true }), async function() {
-    return await targetTestContent(assert, { testName, options: runtimeOptions });
-  });
-}
+export const module = Module;
+export const test = Test;
 
-function assignDefaultValues(options, defaultValues) {
-  for (let key in defaultValues) {
-    if (options[key] === undefined) {
-      options[key] = defaultValues[key];
-    }
-  }
-
-  return options;
-}
-
-export default { module, test, config: {} };
-
-// NOTE: later maybe expose these as well:
-
-// import QUnit from './vendor/qunit.js';
-
-// QUnit.config.autostart = false;
-
-// export const isLocal = QUnit.isLocal;
-// export const on = QUnit.on;
-// export const test = QUnit.test;
-// export const skip = QUnit.skip;
-// export const start = QUnit.start;
-// export const is = QUnit.is;
-// export const extend = QUnit.extend;
-// export const stack = QUnit.stack;
-// export const onUnhandledRejection = QUnit.onUnhandledRejection;
-// export const assert = QUnit.assert;
-// export const dump = QUnit.dump;
-// export const done = QUnit.done;
-// export const testStart = QUnit.testStart;
-// export const moduleStart = QUnit.moduleStart;
-// export const version = QUnit.version;
-// export const module = QUnit.module;
-// export const todo = QUnit.todo;
-// export const only = QUnit.only;
-// export const config = QUnit.config;
-// export const objectType = QUnit.objectType;
-// export const load = QUnit.load;
-// export const onError = QUnit.onError;
-// export const pushFailure = QUnit.pushFailure;
-// export const equiv = QUnit.equiv;
-// export const begin = QUnit.begin;
-// export const log = QUnit.log;
-// export const testDone = QUnit.testDone;
-// export const moduleDone = QUnit.moduleDone;
-// export const diff = QUnit.diff;
-
-// export default Object.assign(QUnit, {
-//   QUnitxVersion: '0.0.1'
-// });
+export default { AssertionError: Assert.AssertionError, module, test, config: {} };

package/shims/node/module.js

@@ -0,0 +1,71 @@
+import { describe, before as beforeAll, after as afterAll } from 'node:test';
+import ModuleContext from '../shared/module-context.js';
+
+// NOTE: node.js beforeEach & afterEach is buggy because the TestContext it has is NOT correct reference when called, it gets the last context
+// NOTE: QUnit expect() logic is buggy in nested modules
+// NOTE: after gets the last direct children test of the module, not last defined context of a module(last defined context is a module)
+
+export default function module(moduleName, runtimeOptions, moduleContent) {
+  let targetRuntimeOptions = moduleContent ? runtimeOptions : {};
+  let targetModuleContent = moduleContent ? moduleContent : runtimeOptions;
+  let moduleContext = new ModuleContext(moduleName);
+
+  return describe(moduleName, { concurrency: true, ...targetRuntimeOptions }, async function () {
+    let beforeHooks = [];
+    let afterHooks = [];
+
+    beforeAll(async function () {
+      Object.assign(moduleContext.context, moduleContext.moduleChain.reduce((result, module) => {
+        return Object.assign(result, module.context, {
+          steps: result.steps.concat(module.context.steps),
+          expectedAssertionCount: module.context.expectedAssertionCount
+            ? module.context.expectedAssertionCount
+            : result.expectedAssertionCount
+        });
+      }, { steps: [], expectedAssertionCount: undefined }));
+
+      for (let hook of beforeHooks) {
+        await hook.call(moduleContext.context, moduleContext.assert);
+      }
+
+      for (let i = 0, len = moduleContext.tests.length; i < len; i++) {
+        Object.assign(moduleContext.tests[i], moduleContext.context, {
+          steps: moduleContext.context.steps,
+          totalExecutedAssertions: moduleContext.context.totalExecutedAssertions,
+          expectedAssertionCount: moduleContext.context.expectedAssertionCount,
+        });
+      }
+    });
+    afterAll(async () => {
+      for (const assert of moduleContext.tests.map(testContext => testContext.assert)) {
+        await assert.waitForAsyncOps();
+      }
+
+      let targetContext = moduleContext.tests[moduleContext.tests.length - 1];
+      for (let j = afterHooks.length - 1; j >= 0; j--) {
+        await afterHooks[j].call(targetContext, targetContext.assert);
+      }
+
+      for (let i = 0, len = moduleContext.tests.length; i < len; i++) {
+        moduleContext.tests[i].finish();
+      }
+    });
+
+    targetModuleContent.call(moduleContext.context, {
+      before(beforeFn) {
+        beforeHooks[beforeHooks.length] = beforeFn;
+      },
+      beforeEach(beforeEachFn) {
+        moduleContext.beforeEachHooks[moduleContext.beforeEachHooks.length] = beforeEachFn;
+      },
+      afterEach(afterEachFn) {
+        moduleContext.afterEachHooks[moduleContext.afterEachHooks.length] = afterEachFn;
+      },
+      after(afterFn) {
+        afterHooks[afterHooks.length] = afterFn;
+      }
+    }, { moduleName, options: runtimeOptions });
+
+    ModuleContext.currentModuleChain.pop();
+  });
+}

package/shims/node/test.js

@@ -0,0 +1,37 @@
+import { it } from 'node:test';
+import TestContext from '../shared/test-context.js';
+import ModuleContext from '../shared/module-context.js';
+
+export default function test(testName, runtimeOptions, testContent) {
+  let moduleContext = ModuleContext.lastModule;
+  if (!moduleContext) {
+    throw new Error(`Test '${testName}' called outside of module context.`);
+  }
+
+  let targetRuntimeOptions = testContent ? runtimeOptions : {};
+  let targetTestContent = testContent ? testContent : runtimeOptions;
+  let context = new TestContext(testName, moduleContext);
+
+  return it(testName, { concurrency: true, ...targetRuntimeOptions }, async function () {
+    let result;
+    for (let module of context.module.moduleChain) {
+      for (let hook of module.beforeEachHooks) {
+        await hook.call(context, context.assert);
+      }
+    }
+
+    result = await targetTestContent.call(context, context.assert, { testName, options: runtimeOptions });
+
+    await context.assert.waitForAsyncOps();
+
+    for (let i = context.module.moduleChain.length - 1; i >= 0; i--) {
+      let module = context.module.moduleChain[i];
+      for (let j = module.afterEachHooks.length - 1; j >= 0; j--) {
+        await module.afterEachHooks[j].call(context, context.assert);
+      }
+    }
+
+    return result;
+  });
+}
+

package/shims/{deno → shared}/assert.js

@@ -1,89 +1,130 @@
-import { AssertionError as DenoAssertionError, assertRejects, assertThrows } from "https://deno.land/std@0.192.0/testing/asserts.ts";
 import '../../vendor/qunit.js';
 import { objectValues, objectValuesSubset, validateExpectedExceptionArgs, validateException } from '../shared/index.js';
 import util from 'node:util';
 
-export class AssertionError extends DenoAssertionError {
-  constructor(object) {
-    super(object.message);
+// More: contexts needed for timeout
+// NOTE: Another approach for a global report Make this._assertions.set(this.currentTest, (this._assertions.get(this.currentTest) || 0) + 1); for pushResult
+// NOTE: This should *always* be a singleton(?), passed around as an argument for hooks. Seems difficult with concurrency. Singleton needs to be a concurrent data structure.
+
+export default class Assert {
+  static QUnit;
+  static AssertionError;
+
+  constructor(module, test) {
+    this.test = test || module.context;
   }
-}
 
-// NOTE: Maybe do the expect, steps in some object, and also do timeout and async(?)
-export default {
-  _steps: [],
-  timeout() {
-    return true; // NOTE: NOT implemented
-  },
-  step(value = '') {
-    this._steps.push(value);
-  },
-  verifySteps(steps, message = 'Verify steps failed!') {
-    const result = this.deepEqual(this._steps, steps, message);
+  _incrementAssertionCount() {
+    this.test.totalExecutedAssertions++;
+  }
+  timeout(number) {
+    if (!Number.isInteger(number) || number < 0) {
+      throw new Error('assert.timeout() expects a positive integer.');
+    }
+
+    this.test.timeout = number;
+  }
+  step(message) {
+    let assertionMessage = message;
+    let result = !!message;
+
+    this.test.steps.push(message);
+
+    if (typeof message === 'undefined' || message === '') {
+      assertionMessage = 'You must provide a message to assert.step';
+    } else if (typeof message !== 'string') {
+      assertionMessage = 'You must provide a string value to assert.step';
+      result = false;
+    }
 
-    this._steps.length = 0;
+    this.pushResult({
+      result,
+      message: assertionMessage
+    });
+  }
+  verifySteps(steps, message = 'Verify steps failed!') {
+    this.deepEqual(this.test.steps, steps, message);
+    this.test.steps.length = 0;
+  }
+  expect(number) {
+    if (!Number.isInteger(number) || number < 0) {
+      throw new Error('assert.expect() expects a positive integer.');
+    }
 
-    return result;
-  },
-  expect() {
-    return () => {}; // NOTE: NOT implemented
-  },
+    this.test.expectedAssertionCount = number;
+  }
   async() {
-    return () => {}; // NOTE: noop, node should have sanitizeResources
-  },
+    let resolveFn;
+    let done = new Promise(resolve => { resolveFn = resolve; });
+
+    this.test.asyncOps.push(done);
+
+    return () => { resolveFn(); };
+  }
+  async waitForAsyncOps() {
+    return Promise.all(this.test.asyncOps);
+  }
   pushResult(resultInfo = {}) {
-    if (!result) {
-      throw new AssertionError({
+    this._incrementAssertionCount();
+    if (!resultInfo.result) {
+      throw new Assert.AssertionError({
         actual: resultInfo.actual,
         expected: resultInfo.expected,
-        message: result.Infomessage || 'Custom assertion failed!',
+        message: resultInfo.message || 'Custom assertion failed!',
         stackStartFn: this.pushResult,
       });
     }
-  },
+
+    return this;
+  }
   ok(state, message) {
+    this._incrementAssertionCount();
     if (!state) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual: state,
         expected: true,
         message: message || `Expected argument to be truthy, it was: ${inspect(state)}`,
         stackStartFn: this.ok,
       });
     }
-  },
+  }
   notOk(state, message) {
+    this._incrementAssertionCount();
     if (state) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual: state,
         expected: false,
         message: message || `Expected argument to be falsy, it was: ${inspect(state)}`,
         stackStartFn: this.notOk,
       });
     }
-  },
+  }
   true(state, message) {
+    this._incrementAssertionCount();
     if (state !== true) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual: state,
         expected: true,
         message: message || `Expected argument to be true, it was: ${inspect(state)}`,
         stackStartFn: this.true,
       });
     }
-  },
+  }
   false(state, message) {
+    this._incrementAssertionCount();
     if (state !== false) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual: state,
         expected: true,
         message: message || `Expected argument to be false, it was: ${inspect(state)}`,
         stackStartFn: this.false,
       });
     }
-  },
+  }
   equal(actual, expected, message) {
+    this._incrementAssertionCount();
     if (actual != expected) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual,
         expected,
         message: message || `Expected: ${defaultMessage(actual, 'should equal to:', expected)}`,
@@ -91,10 +132,11 @@ export default {
         stackStartFn: this.equal,
       });
     }
-  },
+  }
   notEqual(actual, expected, message) {
+    this._incrementAssertionCount();
     if (actual == expected) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual,
         expected,
         operator: '!=',
@@ -102,58 +144,63 @@ export default {
         stackStartFn: this.notEqual,
       });
     }
-  },
+  }
   propEqual(actual, expected, message) {
+    this._incrementAssertionCount();
     let targetActual = objectValues(actual);
     let targetExpected = objectValues(expected);
-    if (!window.QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
+    if (!Assert.QUnit.equiv(targetActual, targetExpected)) {
+      throw new Assert.AssertionError({
         actual: targetActual,
         expected: targetExpected,
         message: message || `Expected properties to be propEqual: ${defaultMessage(targetActual, 'should propEqual to:', targetExpected)}`,
         stackStartFn: this.propEqual,
       });
     }
-  },
+  }
   notPropEqual(actual, expected, message) {
+    this._incrementAssertionCount();
     let targetActual = objectValues(actual);
     let targetExpected = objectValues(expected);
-    if (window.QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
+    if (Assert.QUnit.equiv(targetActual, targetExpected)) {
+      throw new Assert.AssertionError({
         actual: targetActual,
         expected: targetExpected,
         message: message || `Expected properties to NOT be propEqual: ${defaultMessage(targetActual, 'should notPropEqual to:', targetExpected)}`,
         stackStartFn: this.notPropEqual,
       });
     }
-  },
+  }
   propContains(actual, expected, message) {
+    this._incrementAssertionCount();
     let targetActual = objectValuesSubset(actual, expected);
     let targetExpected = objectValues(expected, false);
-    if (!window.QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
+    if (!Assert.QUnit.equiv(targetActual, targetExpected)) {
+      throw new Assert.AssertionError({
         actual: targetActual,
         expected: targetExpected,
         message: message || `propContains assertion fail on: ${defaultMessage(targetActual, 'should propContains to:', targetExpected)}`,
         stackStartFn: this.propContains,
       });
     }
-  },
+  }
   notPropContains(actual, expected, message) {
+    this._incrementAssertionCount();
     let targetActual = objectValuesSubset(actual, expected);
     let targetExpected = objectValues(expected);
-    if (window.QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
+    if (Assert.QUnit.equiv(targetActual, targetExpected)) {
+      throw new Assert.AssertionError({
         actual: targetActual,
         expected: targetExpected,
         message: message || `notPropContains assertion fail on: ${defaultMessage(targetActual, 'should notPropContains of:', targetExpected)}`,
         stackStartFn: this.notPropContains,
       });
     }
-  },
+  }
   deepEqual(actual, expected, message) {
-    if (!window.QUnit.equiv(actual, expected)) {
-      throw new AssertionError({
+    this._incrementAssertionCount();
+    if (!Assert.QUnit.equiv(actual, expected)) {
+      throw new Assert.AssertionError({
         actual,
         expected,
         message: message || `Expected values to be deepEqual: ${defaultMessage(actual, 'should deepEqual to:', expected)}`,
@@ -161,10 +208,11 @@ export default {
         stackStartFn: this.deepEqual,
       });
     }
-  },
+  }
   notDeepEqual(actual, expected, message) {
-    if (window.QUnit.equiv(actual, expected)) {
-      throw new AssertionError({
+    this._incrementAssertionCount();
+    if (Assert.QUnit.equiv(actual, expected)) {
+      throw new Assert.AssertionError({
         actual,
         expected,
         message: message || `Expected values to be NOT deepEqual: ${defaultMessage(actual, 'should notDeepEqual to:', expected)}`,
@@ -172,10 +220,11 @@ export default {
         stackStartFn: this.notDeepEqual,
       });
     }
-  },
+  }
   strictEqual(actual, expected, message) {
+    this._incrementAssertionCount();
     if (actual !== expected) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual,
         expected,
         message: message || `Expected: ${defaultMessage(actual, 'is strictEqual to:', expected)}`,
@@ -183,10 +232,11 @@ export default {
         stackStartFn: this.strictEqual,
       });
     }
-  },
+  }
   notStrictEqual(actual, expected, message) {
+    this._incrementAssertionCount();
     if (actual === expected) {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual,
         expected,
         message: message || `Expected: ${defaultMessage(actual, 'is notStrictEqual to:', expected)}`,
@@ -194,11 +244,12 @@ export default {
         stackStartFn: this.notStrictEqual,
       });
     }
-  },
+  }
   throws(blockFn, expectedInput, assertionMessage) {
+    this?._incrementAssertionCount();
     let [expected, message] = validateExpectedExceptionArgs(expectedInput, assertionMessage, 'rejects');
     if (typeof blockFn !== 'function') {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual: blockFn,
         expected: Function,
         message: 'The value provided to `assert.throws` was not a function.',
@@ -211,7 +262,7 @@ export default {
     } catch (error) {
       let validation = validateException(error, expected, message);
       if (validation.result === false) {
-        throw new AssertionError({
+        throw new Assert.AssertionError({
           actual: validation.result,
           expected: validation.expected,
           message: validation.message,
@@ -222,18 +273,19 @@ export default {
       return;
     }
 
-    throw new AssertionError({
+    throw new Assert.AssertionError({
       actual: blockFn,
       expected: expected,
       message: 'Function passed to `assert.throws` did not throw an exception!',
       stackStartFn: this.throws,
     });
-  },
+  }
   async rejects(promise, expectedInput, assertionMessage) {
+    this._incrementAssertionCount();
     let [expected, message] = validateExpectedExceptionArgs(expectedInput, assertionMessage, 'rejects');
     let then = promise && promise.then;
     if (typeof then !== 'function') {
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual: promise,
         expected: expected,
         message: 'The value provided to `assert.rejects` was not a promise!',
@@ -243,7 +295,7 @@ export default {
 
     try {
       await promise;
-      throw new AssertionError({
+      throw new Assert.AssertionError({
         actual: promise,
         expected: expected,
         message: 'The promise returned by the `assert.rejects` callback did not reject!',
@@ -252,7 +304,7 @@ export default {
     } catch (error) {
       let validation = validateException(error, expected, message);
       if (validation.result === false) {
-        throw new AssertionError({
+        throw new Assert.AssertionError({
           actual: validation.result,
           expected: validation.expected,
           message: validation.message,
@@ -276,4 +328,3 @@ ${inspect(expected)}`
 function inspect(value) {
   return util.inspect(value, { depth: 10, colors: true, compact: false });
 }
-

package/shims/shared/module-context.js

@@ -0,0 +1,47 @@
+import TestContext from './test-context.js';
+
+export default class ModuleContext {
+  static Assert;
+  static currentModuleChain = [];
+
+  static get lastModule() {
+    return this.currentModuleChain[this.currentModuleChain.length - 1];
+  }
+
+  context = new TestContext();
+
+  #tests = [];
+  get tests() {
+    return this.#tests;
+  }
+
+  #beforeEachHooks = [];
+  get beforeEachHooks() {
+    return this.#beforeEachHooks;
+  }
+
+  #afterEachHooks = [];
+  get afterEachHooks() {
+    return this.#afterEachHooks;
+  }
+
+  #moduleChain = [];
+  get moduleChain() {
+    return this.#moduleChain;
+  }
+  set moduleChain(value) {
+    this.#moduleChain = value;
+  }
+
+  constructor(name) {
+    let parentModule = ModuleContext.currentModuleChain[ModuleContext.currentModuleChain.length - 1];
+
+    ModuleContext.currentModuleChain.push(this);
+
+    this.moduleChain = ModuleContext.currentModuleChain.slice(0);
+    this.name = parentModule ? `${parentModule.name} > ${name}` : name;
+    this.assert = new ModuleContext.Assert(this);
+
+    return Object.freeze(this);
+  }
+}

package/shims/shared/test-context.js

@@ -0,0 +1,102 @@
+export default class TestContext {
+  static Assert;
+
+  #name;
+  get name() {
+    return this.#name;
+  }
+  set name(value) {
+    this.#name = value;
+  }
+
+  #module;
+  get module() {
+    return this.#module;
+  }
+  set module(value) {
+    this.#module = value;
+  }
+
+  #asyncOps = [];
+  get asyncOps() {
+    return this.#asyncOps;
+  }
+  set asyncOps(value) {
+    this.#asyncOps = value;
+  }
+
+  #assert;
+  get assert() {
+    return this.#assert;
+  }
+  set assert(value) {
+    this.#assert = value;
+  }
+
+  #timeout;
+  get timeout() {
+    return this.#timeout;
+  }
+  set timeout(value) {
+    this.#timeout = value;
+  }
+
+  #steps = [];
+  get steps() {
+    return this.#steps;
+  }
+  set steps(value) {
+    this.#steps = value;
+  }
+
+  #expectedAssertionCount;
+  get expectedAssertionCount() {
+    return this.#expectedAssertionCount;
+  }
+  set expectedAssertionCount(value) {
+    this.#expectedAssertionCount = value;
+  }
+
+  #totalExecutedAssertions = 0;
+  get totalExecutedAssertions() {
+    return this.#totalExecutedAssertions;
+  }
+  set totalExecutedAssertions(value) {
+    this.#totalExecutedAssertions = value;
+  }
+
+  constructor(name, moduleContext) {
+    if (moduleContext) {
+      this.name = `${moduleContext.name} | ${name}`;
+      this.module = moduleContext;
+      this.module.tests.push(this);
+      this.assert = new TestContext.Assert(moduleContext, this);
+    }
+  }
+
+  finish() {
+    if (this.totalExecutedAssertions === 0) {
+      this.assert.pushResult({
+        result: false,
+        actual: this.totalExecutedAssertions,
+        expected: '> 0',
+        message: `Expected at least one assertion to be run for test: ${this.name}`,
+      });
+    } else if (this.steps.length > 0) {
+      this.assert.pushResult({
+        result: false,
+        actual: this.steps,
+        expected: [],
+        message: `Expected assert.verifySteps() to be called before end of test after using assert.step(). Unverified steps: ${this.steps.join(', ')}`,
+      });
+    } else if (this.expectedAssertionCount && this.expectedAssertionCount !== this.totalExecutedAssertions) {
+      this.assert.pushResult({
+        result: false,
+        actual: this.totalExecutedAssertions,
+        expected: this.expectedAssertionCount,
+        message: `Expected ${this.expectedAssertionCount} assertions, but ${this.totalExecutedAssertions} were run for test: ${this.name}`,
+      });
+    }
+  }
+}
+

package/shims/node/assert.js

@@ -1,272 +0,0 @@
-import QUnit from '../../vendor/qunit.js';
-import { objectValues, objectValuesSubset, validateExpectedExceptionArgs, validateException } from '../shared/index.js';
-import assert, { AssertionError } from 'node:assert';
-import util from 'node:util';
-
-// NOTE: Maybe do the expect, steps in some object, and also do timeout and async(?)
-export default {
-  _steps: [],
-  timeout() {
-    return true; // NOTE: NOT implemented
-  },
-  step(value = '') {
-    this._steps.push(value);
-  },
-  verifySteps(steps, message = 'Verify steps failed!') {
-    const result = this.deepEqual(this._steps, steps, message);
-
-    this._steps.length = 0;
-
-    return result;
-  },
-  expect() {
-    return () => {}; // NOTE: NOT implemented
-  },
-  async() {
-    return () => {}; // NOTE: noop, node should have sanitizeResources
-  },
-  pushResult(resultInfo = {}) {
-    if (!result) {
-      throw new AssertionError({
-        actual: resultInfo.actual,
-        expected: resultInfo.expected,
-        message: result.Infomessage || 'Custom assertion failed!',
-        stackStartFn: this.pushResult,
-      });
-    }
-  },
-  ok(state, message) {
-    if (!state) {
-      throw new AssertionError({
-        actual: state,
-        expected: true,
-        message: message || `Expected argument to be truthy, it was: ${inspect(state)}`,
-        stackStartFn: this.ok,
-      });
-    }
-  },
-  notOk(state, message) {
-    if (state) {
-      throw new AssertionError({
-        actual: state,
-        expected: false,
-        message: message || `Expected argument to be falsy, it was: ${inspect(state)}`,
-        stackStartFn: this.notOk,
-      });
-    }
-  },
-  true(state, message) {
-    if (state !== true) {
-      throw new AssertionError({
-        actual: state,
-        expected: true,
-        message: message || `Expected argument to be true, it was: ${inspect(state)}`,
-        stackStartFn: this.true,
-      });
-    }
-  },
-  false(state, message) {
-    if (state !== false) {
-      throw new AssertionError({
-        actual: state,
-        expected: true,
-        message: message || `Expected argument to be false, it was: ${inspect(state)}`,
-        stackStartFn: this.false,
-      });
-    }
-  },
-  equal(actual, expected, message) {
-    if (actual != expected) {
-      throw new AssertionError({
-        actual,
-        expected,
-        message: message || `Expected: ${defaultMessage(actual, 'should equal to:', expected)}`,
-        operator: '==',
-        stackStartFn: this.equal,
-      });
-    }
-  },
-  notEqual(actual, expected, message) {
-    if (actual == expected) {
-      throw new AssertionError({
-        actual,
-        expected,
-        operator: '!=',
-        message: message || `Expected: ${defaultMessage(actual, 'should notEqual to:', expected)}`,
-        stackStartFn: this.notEqual,
-      });
-    }
-  },
-  propEqual(actual, expected, message) {
-    let targetActual = objectValues(actual);
-    let targetExpected = objectValues(expected);
-    if (!QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
-        actual: targetActual,
-        expected: targetExpected,
-        message: message || `Expected properties to be propEqual: ${defaultMessage(targetActual, 'should propEqual to:', targetExpected)}`,
-        stackStartFn: this.propEqual,
-      });
-    }
-  },
-  notPropEqual(actual, expected, message) {
-    let targetActual = objectValues(actual);
-    let targetExpected = objectValues(expected);
-    if (QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
-        actual: targetActual,
-        expected: targetExpected,
-        message: message || `Expected properties to NOT be propEqual: ${defaultMessage(targetActual, 'should notPropEqual to:', targetExpected)}`,
-        stackStartFn: this.notPropEqual,
-      });
-    }
-  },
-  propContains(actual, expected, message) {
-    let targetActual = objectValuesSubset(actual, expected);
-    let targetExpected = objectValues(expected, false);
-    if (!QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
-        actual: targetActual,
-        expected: targetExpected,
-        message: message || `propContains assertion fail on: ${defaultMessage(targetActual, 'should propContains to:', targetExpected)}`,
-        stackStartFn: this.propContains,
-      });
-    }
-  },
-  notPropContains(actual, expected, message) {
-    let targetActual = objectValuesSubset(actual, expected);
-    let targetExpected = objectValues(expected);
-    if (QUnit.equiv(targetActual, targetExpected)) {
-      throw new AssertionError({
-        actual: targetActual,
-        expected: targetExpected,
-        message: message || `notPropContains assertion fail on: ${defaultMessage(targetActual, 'should notPropContains of:', targetExpected)}`,
-        stackStartFn: this.notPropContains,
-      });
-    }
-  },
-  deepEqual(actual, expected, message) {
-    if (!QUnit.equiv(actual, expected)) {
-      throw new AssertionError({
-        actual,
-        expected,
-        message: message || `Expected values to be deepEqual: ${defaultMessage(actual, 'should deepEqual to:', expected)}`,
-        operator: 'deepEqual',
-        stackStartFn: this.deepEqual,
-      });
-    }
-  },
-  notDeepEqual(actual, expected, message) {
-    if (QUnit.equiv(actual, expected)) {
-      throw new AssertionError({
-        actual,
-        expected,
-        message: message || `Expected values to be NOT deepEqual: ${defaultMessage(actual, 'should notDeepEqual to:', expected)}`,
-        operator: 'notDeepEqual',
-        stackStartFn: this.notDeepEqual,
-      });
-    }
-  },
-  strictEqual(actual, expected, message) {
-    if (actual !== expected) {
-      throw new AssertionError({
-        actual,
-        expected,
-        message: message || `Expected: ${defaultMessage(actual, 'is strictEqual to:', expected)}`,
-        operator: 'strictEqual',
-        stackStartFn: this.strictEqual,
-      });
-    }
-  },
-  notStrictEqual(actual, expected, message) {
-    if (actual === expected) {
-      throw new AssertionError({
-        actual,
-        expected,
-        message: message || `Expected: ${defaultMessage(actual, 'is notStrictEqual to:', expected)}`,
-        operator: 'notStrictEqual',
-        stackStartFn: this.notStrictEqual,
-      });
-    }
-  },
-  throws(blockFn, expectedInput, assertionMessage) {
-    let [expected, message] = validateExpectedExceptionArgs(expectedInput, assertionMessage, 'rejects');
-    if (typeof blockFn !== 'function') {
-      throw new AssertionError({
-        actual: blockFn,
-        expected: Function,
-        message: 'The value provided to `assert.throws` was not a function.',
-        stackStartFn: this.throws,
-      });
-    }
-
-    try {
-      blockFn();
-    } catch (error) {
-      let validation = validateException(error, expected, message);
-      if (validation.result === false) {
-        throw new AssertionError({
-          actual: validation.result,
-          expected: validation.expected,
-          message: validation.message,
-          stackStartFn: this.throws,
-        });
-      }
-
-      return;
-    }
-
-    throw new AssertionError({
-      actual: blockFn,
-      expected: expected,
-      message: 'Function passed to `assert.throws` did not throw an exception!',
-      stackStartFn: this.throws,
-    });
-  },
-  async rejects(promise, expectedInput, assertionMessage) {
-    let [expected, message] = validateExpectedExceptionArgs(expectedInput, assertionMessage, 'rejects');
-    let then = promise && promise.then;
-    if (typeof then !== 'function') {
-      throw new AssertionError({
-        actual: promise,
-        expected: expected,
-        message: 'The value provided to `assert.rejects` was not a promise!',
-        stackStartFn: this.rejects,
-      });
-    }
-
-    try {
-      await promise;
-      throw new AssertionError({
-        actual: promise,
-        expected: expected,
-        message: 'The promise returned by the `assert.rejects` callback did not reject!',
-        stackStartFn: this.rejects,
-      });
-    } catch (error) {
-      let validation = validateException(error, expected, message);
-      if (validation.result === false) {
-        throw new AssertionError({
-          actual: validation.result,
-          expected: validation.expected,
-          message: validation.message,
-          stackStartFn: this.rejects,
-        });
-      }
-    }
-  }
-};
-
-function defaultMessage(actual, description, expected) {
-  return `
-
-${inspect(actual)}
-
-${description}
-
-${inspect(expected)}`
-}
-
-function inspect(value) {
-  return util.inspect(value, { depth: 10, colors: true, compact: false });
-}