refactor: Convert to TypeScript. No functional changes. Minimum NodeJS version set to 14.17, since it's minimum runtime requirement for TypeScript 5.1+.

Author: Nenad Vićentić

README.md

@@ -35,6 +35,12 @@ The `au new` command now simplify wraps `npx makes aurelia/v1`. Users can direct
 
 Run `npm test` to run the unit tests.
 
+To run and individual test, you can use command with filters. For example:
+
+```powershell
+npx jasmine spec/lib/build/bundled-source.spec.js --filter="transform saves cache"
+```
+
 ## Release new aurelia-cli version
 
 Just run `npm version patch` (or minor or major)

bin/aurelia-cli.js

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 
+/**
+ * @import { CLI } from '../dist/cli'
+ */
+
 const resolve = require('resolve');
 
 const semver = require('semver');
 const nodeVersion = process.versions.node;
-if (semver.lt(nodeVersion, '10.12.0')) {
+if (semver.lt(nodeVersion, '14.17.0')) {
   console.error(`You are running Node.js v${nodeVersion}.
-aurelia-cli requires Node.js v10.12.0 or above.
+aurelia-cli requires Node.js v14.17.0 or above.
 Please upgrade to latest Node.js https://nodejs.org`);
   process.exit(1);
 }
@@ -22,10 +26,11 @@ let originalBaseDir = process.cwd();
 resolve('aurelia-cli', {
   basedir: originalBaseDir
 }, function(error, projectLocalCli) {
+  /** @type {CLI} */
   let cli;
 
   if (commandName === 'new' || error) {
-    cli = new (require('../lib/index').CLI);
+    cli = new (require('../dist/index').CLI);
     cli.options.runningGlobally = true;
   } else {
     cli = new (require(projectLocalCli).CLI);

build/clean-dir.mjs

@@ -0,0 +1,4 @@
+import { rmSync, mkdirSync } from 'node:fs';
+
+rmSync('./dist', { recursive: true, force: true});
+mkdirSync('./dist');

build/copy-files.mjs

@@ -0,0 +1,6 @@
+import * as cpx from 'cpx';
+
+cpx.copy('src/**/*.json', 'dist')
+  .on('copy', (e) => console.log(`Copied: ${e.srcPath}`));
+  cpx.copy('src/**/*.txt', 'dist')
+  .on('copy', (e) => console.log(`Copied: ${e.srcPath}`));

eslint.config.mjs

@@ -1,35 +1,48 @@
-import globals from "globals";
-import eslint from "@eslint/js";
+// @ts-check
 
-export default [
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import stylistic from '@stylistic/eslint-plugin';
+import stylisticJS from '@stylistic/eslint-plugin-js';
+
+export default tseslint.config(
   {
-    ignores: ["lib/build/amodro-trace", "**/dist"],
+    ignores: ['src/build/amodro-trace', '**/dist', '**/lib', './spec', './build', './bin']
   },
   eslint.configs.recommended,
+  tseslint.configs.recommended,
   {
     languageOptions: {
-      globals: {
-        ...globals.node,
-        ...globals.jasmine,
-      },
-
-      ecmaVersion: 2019,
-      sourceType: "commonjs",
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname
+      }
     },
-
+    plugins: {
+      '@stylistic': stylistic,
+      '@stylistic/js': stylisticJS
+    }
+  },
+  {
     rules: {
-      "no-prototype-builtins": 0,
-      "no-console": 0,
-      "getter-return": 0,
-      "no-inner-declarations": 0,
-
-      "comma-dangle": ["error", {
-        arrays: "never",
-        objects: "never",
-        imports: "never",
-        exports: "never",
-        functions: "never",
+      'no-prototype-builtins': 0,
+      'no-console': 0,
+      'getter-return': 0,
+      'no-inner-declarations': 0,
+      'comma-dangle': ['error', {
+        arrays: 'never',
+        objects: 'never',
+        imports: 'never',
+        exports: 'never',
+        functions: 'never'
       }],
-    },
+      'prefer-rest-params': 'warn',
+      'prefer-spread': 'warn',
+      '@stylistic/js/quotes': ['warn', 'single'],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-require-imports': 'warn',
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': 'error'
+    }
   }
-];
+);

jsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./",
+    "allowJs": true,
+    "types": ["node"]
+  },
+  "include": ["bin", "build", "eslint.config.mjs"]
+}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "aurelia-cli",
-  "version": "3.0.4",
+  "version": "3.1.0-beta.1",
   "description": "The command line tooling for Aurelia.",
   "keywords": [
     "aurelia",
@@ -16,21 +16,29 @@
     "aurelia": "bin/aurelia-cli.js",
     "au": "bin/aurelia-cli.js"
   },
+  "type": "commonjs",
   "scripts": {
-    "lint": "eslint lib spec",
-    "pretest": "npm run lint",
+    "prebuild": "node build/clean-dir.mjs && npm run lint",
+    "build": "tsc",
+    "postbuild": "node build/copy-files.mjs",
+    "lint": "eslint src",
+    "pretest": "npm run lint && npm run build",
     "test": "jasmine",
     "coverage": "c8 jasmine",
     "test:watch": "nodemon -x 'npm test'",
+    "prepare": "npm run build",
     "preversion": "npm test",
     "version": "standard-changelog && git add CHANGELOG.md",
     "postversion": "git push && git push --tags && npm publish"
   },
   "license": "MIT",
   "author": "Rob Eisenberg <[email protected]> (http://robeisenberg.com/)",
-  "main": "lib/index.js",
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
   "files": [
     "bin",
+    "build",
+    "dist",
     "lib"
   ],
   "repository": {
@@ -81,21 +89,34 @@
     "string_decoder": "^1.3.0",
     "terser": "^5.36.0",
     "timers-browserify": "^2.0.12",
+    "tslib": "^2.8.1",
     "tty-browserify": "0.0.1",
-    "typescript": "^5.6.3",
+    "typescript": "^5.8.3",
     "url": "^0.11.4",
     "util": "^0.12.5",
     "vm-browserify": "^1.1.2"
   },
   "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@stylistic/eslint-plugin": "^4.2.0",
+    "@stylistic/eslint-plugin-js": "^4.2.0",
+    "@types/convert-source-map": "^2.0.3",
+    "@types/gulp": "^4.0.17",
+    "@types/jasmine": "^5.1.7",
+    "@types/lodash": "^4.17.16",
+    "@types/map-stream": "^0.0.3",
     "@types/node": "^22.8.1",
+    "@types/resolve": "^1.20.6",
+    "@types/vinyl-fs": "^3.0.5",
     "c8": "^10.1.2",
-    "eslint": "^9.13.0",
+    "cpx": "^1.5.0",
+    "eslint": "^9.24.0",
     "globals": "^15.11.0",
     "jasmine": "^5.4.0",
     "jasmine-spec-reporter": "^7.0.0",
     "nodemon": "^3.1.7",
     "standard-changelog": "^6.0.0",
+    "typescript-eslint": "^8.29.0",
     "yargs": "^17.7.2"
   }
 }

spec/helpers/setup.js

@@ -0,0 +1,8 @@
+const isDebugMode = typeof v8debug === 'object' || 
+                    /--debug|--inspect/.test(process.execArgv.join(' ')) ||
+                    process.env.VSCODE_INSPECTOR_OPTIONS;
+
+if (isDebugMode) {
+  jasmine.DEFAULT_TIMEOUT_INTERVAL = 60 * 1000; // 1 minute timeout in debug mode
+  console.log('Debug mode detected - extended timeouts enabled');
+}

spec/jsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": null,
+    "rootDirs": ["../src", "./"],
+    "allowJs": true,
+    "module": "CommonJS",
+    "types": ["node", "jasmine"]
+  },
+  "include": [
+    "./**/*.js"
+  ]
+}

spec/lib/build/ast-matcher.spec.js

@@ -1,6 +1,6 @@
 const meriyah = require('meriyah');
 
-const astm = require('../../../lib/build/ast-matcher');
+const astm = require('../../../dist/build/ast-matcher');
 const extract = astm.extract;
 const compilePattern = astm.compilePattern;
 const astMatcher = astm.astMatcher;