Refactor test cases into more granular files

Author: pilafmon

.github/workflows/release-on-vtag.yaml

@@ -11,5 +11,5 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5             #see: https://github.com/actions/checkout/releases
+      - uses: actions/checkout@v6             #see: https://github.com/actions/checkout/releases
       - uses: softprops/action-gh-release@v2  #see: https://github.com/softprops/action-gh-release/releases

.github/workflows/run-spec-on-push.yaml

@@ -8,7 +8,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5    #see: https://github.com/actions/checkout/releases
+      - uses: actions/checkout@v6    #see: https://github.com/actions/checkout/releases
       - uses: actions/setup-node@v6  #see: https://github.com/actions/setup-node/releases
       - run: npm install
       - run: npm test

LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2025 Individual contributors to esm-to-plain-js
+Copyright (c) 2022-2026 Individual contributors to esm-to-plain-js
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package.json

@@ -54,23 +54,23 @@
    },
    "dependencies": {
       "chalk": "~5.6",
-      "cli-argv-util": "~1.4",
+      "cli-argv-util": "~1.5",
       "fancy-log": "~2.0",
       "slash": "~5.1"
    },
    "devDependencies": {
-      "@eslint/js": "~9.39",
+      "@eslint/js": "~10.0",
       "@types/fancy-log": "~2.0",
-      "@types/node": "~25.0",
+      "@types/node": "~25.3",
       "add-dist-header": "~1.6",
       "assert-deep-strict-equal": "~1.2",
       "copy-file-util": "~1.3",
-      "eslint": "~9.39",
+      "eslint": "~10.0",
       "jshint": "~2.13",
       "mocha": "~11.7",
       "rimraf": "~6.1",
       "run-scripts-util": "~1.3",
       "typescript": "~5.9",
-      "typescript-eslint": "~8.50"
+      "typescript-eslint": "~8.56"
    }
 }

spec/cli.spec.js

@@ -0,0 +1,33 @@
+// esm-to-plain-js
+// CLI Specification Suite
+
+// Imports
+import { assertDeepStrictEqual, fileToLines } from 'assert-deep-strict-equal';
+import { cliArgvUtil } from 'cli-argv-util';
+import fs from 'fs';
+
+// Setup
+const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'));
+const run = (posix) => cliArgvUtil.run(pkg, posix);
+
+////////////////////////////////////////////////////////////////////////////////
+describe('Executing the CLI', () => {
+
+   it('comments out the imports and swaps the export for globalThis', () => {
+      run('esm-to-plain-js --cd=spec/fixtures web-app.esm.js ../target/cli/web-app.cli.js');
+      const actual = fileToLines('spec/target/cli/web-app.cli.js');
+      const expected = [
+         '// Ensure library is loaded => import * as R from \'ramda\';',
+         'const webApp = {',
+         '   luckyNumbers: [3, 7, 21, 777],',
+         '   setup() {',
+         '      const elem = globalThis.document.getElementById(\'lucky-num\');',
+         '      elem.innerText = R.last(webApp.luckyNumbers);',
+         '      },',
+         '   };',
+         'globalThis.webApp = webApp;',
+         ];
+      assertDeepStrictEqual(actual, expected);
+      });
+
+   });

spec/errors.spec.js

@@ -0,0 +1,26 @@
+// esm-to-plain-js
+// Error Handling Specification Suite
+
+// Imports
+import assert from 'assert';
+
+// Setup
+import { esmToPlainJs } from '../dist/esm-to-plain-js.js';
+
+////////////////////////////////////////////////////////////////////////////////
+describe('Correct error is thrown', () => {
+
+   it('when the "source" file parameter is missing', () => {
+      const makeBogusCall = () => esmToPlainJs.transform();
+      const exception =     { message: '[esm-to-plain-js] Must specify a source file.' };
+      assert.throws(makeBogusCall, exception);
+      });
+
+   it('when the "target" file parameter is missing', () => {
+      const source =        'spec/fixtures/web-app.esm.js';
+      const makeBogusCall = () => esmToPlainJs.transform(source);
+      const exception =     { message: '[esm-to-plain-js] Must specify a target file.' };
+      assert.throws(makeBogusCall, exception);
+      });
+
+   });

spec/mocha.spec.js

@@ -0,0 +1,46 @@
+// esm-to-plain-js
+// Package Specification Suite
+
+// Imports
+import { assertDeepStrictEqual } from 'assert-deep-strict-equal';
+import fs from 'fs';
+
+// Setup
+import { esmToPlainJs } from '../dist/esm-to-plain-js.js';
+
+////////////////////////////////////////////////////////////////////////////////
+describe('The "dist" folder', () => {
+
+   it('contains the correct files', () => {
+      const actual = fs.readdirSync('dist').sort();
+      const expected = [
+         'esm-to-plain-js.d.ts',
+         'esm-to-plain-js.js',
+         ];
+      assertDeepStrictEqual(actual, expected);
+      });
+
+   });
+
+////////////////////////////////////////////////////////////////////////////////
+describe('Library module', () => {
+
+   it('is an object', () => {
+      const actual =   { constructor: esmToPlainJs.constructor.name };
+      const expected = { constructor: 'Object' };
+      assertDeepStrictEqual(actual, expected);
+      });
+
+   it('has functions named assert(), cli(), reporter(), and transform()', () => {
+      const module = esmToPlainJs;
+      const actual = Object.keys(module).sort().map(key => [key, typeof module[key]]);
+      const expected = [
+         ['assert',    'function'],
+         ['cli',       'function'],
+         ['reporter',  'function'],
+         ['transform', 'function'],
+         ];
+      assertDeepStrictEqual(actual, expected);
+      });
+
+   });