Build: Add native ESM distribution

Gruntfile.js

@@ -27,6 +27,12 @@ module.exports = function (grunt) {
       'src-css': {
         src: 'src/core/qunit.css',
         dest: 'qunit/qunit.css'
+      },
+      'src-export-wrappers': {
+        src: 'src/core/export-*.js',
+        expand: true,
+        flatten: true,
+        dest: 'qunit/'
       }
     },
     search: {

demos/bundlers.mjs

@@ -7,7 +7,7 @@ const dirname = path.dirname(url.fileURLToPath(import.meta.url));
 const DIR = path.join(dirname, 'bundlers');
 
 // Prepare
-cp.execSync('npm install --no-audit --update-notifier=false', { cwd: DIR, encoding: 'utf8' });
+// cp.execSync('npm install --no-audit --update-notifier=false', { cwd: DIR, encoding: 'utf8' });
 await import('./bundlers/build.mjs');
 
 const tmpJsFiles = fs.readdirSync(path.join(DIR, 'tmp'))

package.json

@@ -37,6 +37,20 @@
     "LICENSE.txt"
   ],
   "main": "qunit/qunit.js",
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./qunit/export-wrapper-nodejs-module.js",
+        "default": "./qunit/qunit.js"
+      },
+      "module": {
+        "import": "./qunit/qunit.module.js",
+        "default": "./qunit/export-wrapper-bundler-require.js"
+      },
+      "import": "./qunit/qunit.module.js",
+      "default": "./qunit/qunit.js"
+    }
+  },
   "engines": {
     "node": ">=18"
   },
@@ -82,8 +96,8 @@
     "tap-min": "^3.0.0"
   },
   "scripts": {
-    "build": "rollup -c && grunt copy:src-css",
-    "build-coverage": "rollup -c --environment BUILD_TARGET:coverage && grunt copy:src-css",
+    "build": "rollup -c && grunt copy",
+    "build-coverage": "rollup -c --environment BUILD_TARGET:coverage && grunt copy",
     "build-dev": "node build/dev.js",
     "benchmark": "npm install --silent --no-audit --prefix test/benchmark/ && node test/benchmark/micro.js",
     "lint": "eslint --cache .",

rollup.config.js

@@ -8,44 +8,74 @@ const replace = require('@rollup/plugin-replace');
 const { replacements } = require('./build/dist-replace.js');
 const isCoverage = process.env.BUILD_TARGET === 'coverage';
 
-module.exports = {
-  input: 'src/core/qunit.js',
-  output: {
-    file: 'qunit/qunit.js',
-    sourcemap: isCoverage,
-    format: 'iife',
-    exports: 'none',
+const banner = `/*!
+ * QUnit @VERSION
+ * https://qunitjs.com/
+ *
+ * Copyright OpenJS Foundation and other contributors
+ * Released under the MIT license
+ * https://jquery.org/license
+ */`;
 
-    // eslint-disable-next-line no-multi-str
-    banner: '/*!\n\
- * QUnit @VERSION\n\
- * https://qunitjs.com/\n\
- *\n\
- * Copyright OpenJS Foundation and other contributors\n\
- * Released under the MIT license\n\
- * https://jquery.org/license\n\
- */'
-  },
-  plugins: [
-    replace({
-      preventAssignment: true,
-      delimiters: ['', ''],
-      ...replacements
-    }),
-    nodeResolve(),
-    commonjs(),
-    babel({
-      babelHelpers: 'bundled',
-      babelrc: false,
-      presets: [
-        ['@babel/preset-env', {
-          targets: {
-            ie: 11,
-            safari: 7,
-            node: 18
-          }
-        }]
-      ]
-    })
-  ]
+const replacementOptions = {
+  preventAssignment: true,
+  delimiters: ['', ''],
+  ...replacements
 };
+
+module.exports = [
+  {
+    input: 'src/core/qunit-commonjs.js',
+    output: {
+      file: 'qunit/qunit.js',
+      sourcemap: isCoverage,
+      format: 'iife',
+      exports: 'none',
+      banner: banner
+    },
+    plugins: [
+      replace(replacementOptions),
+      nodeResolve(),
+      commonjs(),
+      babel({
+        babelHelpers: 'bundled',
+        babelrc: false,
+        presets: [
+          ['@babel/preset-env', {
+            targets: {
+              ie: 11,
+              safari: 7,
+              node: 18
+            }
+          }]
+        ]
+      })
+    ]
+  },
+  {
+    input: 'src/core/qunit.js',
+    output: {
+      file: 'qunit/qunit.module.js',
+      format: 'es',
+      exports: 'named',
+      banner: banner
+    },
+    plugins: [
+      replace(replacementOptions),
+      nodeResolve(),
+      commonjs(),
+      babel({
+        babelHelpers: 'bundled',
+        babelrc: false,
+        presets: [
+          ['@babel/preset-env', {
+            targets: {
+              safari: 10,
+              node: 18
+            }
+          }]
+        ]
+      })
+    ]
+  }
+];

src/core/export-wrapper-bundler-require.js

@@ -0,0 +1,7 @@
+// In a single bundler invocation, if different parts or dependencies
+// of a project mix ESM and CJS, avoid a split-brain state by making
+// sure both import and re-use the same instance via this wrapper.
+//
+// Bundlers generally allow requiring an ESM file from CommonJS.
+const { QUnit } = require('./qunit.module.js');
+module.exports = QUnit;

src/core/export-wrapper-nodejs-module.js

@@ -0,0 +1,45 @@
+// In a single Node.js process, if different parts or dependencies
+// of a project mix ESM and CJS, avoid a split-brain state by making
+// sure both import and re-use the same instance via this wrapper.
+//
+// The "real" ESM file is reserved for bundlers, web distribution,
+// and other consumers of package.json#exports.module.
+//
+// Node.js 18+ can import a CommonJS file from ESM.
+import QUnit from "./qunit.js";
+
+export const {
+  assert,
+  begin,
+  config,
+  diff,
+  done,
+  dump,
+  equiv,
+  hooks,
+  is,
+  isLocal,
+  log,
+  module,
+  moduleDone,
+  moduleStart,
+  objectType,
+  on,
+  only,
+  onUncaughtException,
+  pushFailure,
+  reporters,
+  skip,
+  stack,
+  start,
+  test,
+  testDone,
+  testStart,
+  todo,
+  urlParams,
+  version
+} = QUnit;
+
+export { QUnit };
+
+export default QUnit;

src/core/qunit-commonjs.js

@@ -0,0 +1,12 @@
+/* global module, exports */
+import QUnit from './qunit.js';
+
+// For Node.js
+if (typeof module !== 'undefined' && module && module.exports) {
+  module.exports = QUnit;
+}
+
+// For CommonJS with exports, but without module.exports, like Rhino
+if (typeof exports !== 'undefined' && exports) {
+  exports.QUnit = QUnit;
+}