feat: target ESLint v9

Author: Marsup

.eslintignore

@@ -0,0 +1,20 @@
+'use strict';
+
+const HapiPlugin = require('@hapi/eslint-plugin');
+
+module.exports = [
+    {
+        ignores: [
+            'node_modules/',
+            'test_runner/',
+            'test/coverage/',
+            'test/cli/',
+            'test/cli_*/',
+            'test/lint/',
+            'test/override/',
+            'test/plan/',
+            'test/transform/'
+        ]
+    },
+    ...HapiPlugin.configs.module
+];

eslint.config.js

@@ -1,5 +1,5 @@
 'use strict';
 
-module.exports = {
-    extends: 'plugin:@hapi/module'
-};
+const HapiPlugin = require('@hapi/eslint-plugin');
+
+module.exports = [...HapiPlugin.configs.module];

lib/linter/.eslintrc.js

@@ -1,7 +1,6 @@
 'use strict';
 
 const Fs = require('fs');
-const Path = require('path');
 
 const Eslint = require('eslint');
 const Hoek = require('@hapi/hoek');
@@ -18,31 +17,47 @@ exports.lint = async function () {
 
     const options = process.argv[2] ? JSON.parse(process.argv[2]) : undefined;
 
-    if (!Fs.existsSync('.eslintrc.js') &&
-        !Fs.existsSync('.eslintrc.cjs') && // Needed for projects with "type": "module"
-        !Fs.existsSync('.eslintrc.yaml') &&
-        !Fs.existsSync('.eslintrc.yml') &&
-        !Fs.existsSync('.eslintrc.json') &&
-        !Fs.existsSync('.eslintrc')) {
-        configuration.overrideConfigFile = Path.join(__dirname, '.eslintrc.js');
+    let usingDefault = false;
+
+    if (!Fs.existsSync('eslint.config.js') &&
+        !Fs.existsSync('eslint.config.cjs') &&
+        !Fs.existsSync('eslint.config.mjs')) {
+        // No configuration file found, using the default one
+        usingDefault = true;
+        configuration.baseConfig = require('./.eslintrc.js');
+        configuration.overrideConfigFile = true;
     }
 
     if (options) {
         Hoek.merge(configuration, options, true, false);
     }
 
-    if (!configuration.extensions) {
-        configuration.extensions = ['.js', '.cjs', '.mjs'];
+    // Only the default configuration should be altered, otherwise the user's configuration should be used as is
+    if (usingDefault) {
+        if (!configuration.extensions) {
+            const extensions = ['js', 'cjs', 'mjs'];
+
+            if (configuration.typescript) {
+                extensions.push('ts');
+            }
 
-        if (configuration.typescript) {
-            configuration.extensions.push('.ts');
+            configuration.baseConfig.unshift({
+                files: extensions.map((ext) => `**/*.${ext}`)
+            });
         }
-    }
 
-    if (configuration.typescript) {
-        delete configuration.typescript;
+        if (configuration.ignores) {
+            configuration.baseConfig.unshift({
+                ignores: configuration.ignores
+            });
+        }
     }
 
+    delete configuration.extensions;
+    delete configuration.typescript;
+    delete configuration.ignores;
+
+
     let results;
     try {
         const eslint = new Eslint.ESLint(configuration);
@@ -66,6 +81,13 @@ exports.lint = async function () {
 
         transformed.errors = result.messages.map((err) => {
 
+            if (err.messageTemplate === 'all-matched-files-ignored') {
+                return {
+                    severity: 'ERROR',
+                    message: err.message
+                };
+            }
+
             return {
                 line: err.line,
                 severity: err.severity === 1 ? 'WARNING' : 'ERROR',

lib/linter/index.js

@@ -16,8 +16,7 @@ const SourceMap = require('../source-map');
 const Transform = require('./transform');
 
 const internals = {
-    _state: Symbol.for('@hapi/lab/coverage/_state'),
-    eslint: new ESLint.ESLint({ baseConfig: Eslintrc })
+    _state: Symbol.for('@hapi/lab/coverage/_state')
 };
 
 
@@ -111,7 +110,7 @@ internals.prime = function (extension, ctx) {
     require.extensions[extension] = function (localModule, filename) {
 
         // We never want to instrument eslint configs in order to avoid infinite recursion
-        if (Path.basename(filename, extension) !== '.eslintrc') {
+        if (!['.eslintrc', 'eslint.config'].includes(Path.basename(filename, extension))) {
             for (let i = 0; i < internals.state.patterns.length; ++i) {
                 if (internals.state.patterns[i].test(filename.replace(/\\/g, '/'))) {
                     return localModule._compile(internals.instrument(filename, ctx), filename);
@@ -761,11 +760,40 @@ internals.file = async function (filename, data, options) {
 
 internals.context = async (options) => {
 
+    const filePath = Path.join(options.coveragePath || '', 'x.js');
+    let calculated;
+
     // The parserOptions are shared by all files for coverage purposes, based on
     // the effective eslint config for a hypothetical file {coveragePath}/x.js
-    const { parserOptions } = await internals.eslint.calculateConfigForFile(
-        Path.join(options.coveragePath || '', 'x.js')
-    );
+    try {
+        // Let's try first with eslint's native configuration detection
+        const eslint = new ESLint.ESLint({
+            ignore: false
+        });
+
+        calculated = await eslint.calculateConfigForFile(filePath);
+    }
+    catch (err) {
+        /* $lab:coverage:off$ */
+        if (err.messageTemplate !== 'config-file-missing') {
+            throw err;
+        }
+
+        // If the eslint config file is missing, we'll use the one provided by lab
+        const eslint = new ESLint.ESLint({
+            overrideConfig: Eslintrc,
+            overrideConfigFile: true,
+            ignore: false
+        });
+
+        calculated = await eslint.calculateConfigForFile(filePath);
+        /* $lab:coverage:on$ */
+    }
+
+    const parserOptions = {
+        ...calculated.languageOptions,
+        ...calculated.languageOptions?.parserOptions
+    };
 
     return { parserOptions };
 };

lib/modules/coverage.js

@@ -20,7 +20,7 @@ exports.lint = function (settings) {
         try {
             linterOptions = JSON.parse(settings['lint-options'] || '{}');
         }
-        catch (err) {
+        catch {
             return reject(new Error('lint-options could not be parsed'));
         }
 

lib/modules/lint.js

@@ -73,7 +73,7 @@ exports.retrieveFile = function (path) {
     try {
         contents = Fs.readFileSync(path, 'utf8');
     }
-    catch (e) {
+    catch {
         contents = null;
     }
 

lib/modules/transform.js

@@ -14,7 +14,7 @@ internals.transform = function (content, fileName) {
         try {
             var { config, error } = Typescript.readConfigFile(configFile, Typescript.sys.readFile);
         }
-        catch (err) {
+        catch {
             throw new Error(`Cannot find a tsconfig file for ${fileName}`);
         }
 

lib/modules/typescript.js

@@ -13,10 +13,12 @@ const internals = {};
 
 // Prevent libraries like Sinon from clobbering global time functions
 
+/* eslint-disable no-redeclare */
 const Date = global.Date;
 const setTimeout = global.setTimeout;
 const clearTimeout = global.clearTimeout;
 const setImmediate = global.setImmediate;
+/* eslint-enable no-redeclare */
 
 
 Error.stackTraceLimit = Infinity;                   // Set Error stack size

lib/runner.js

@@ -13,19 +13,14 @@
         "bin/lab",
         "lib"
     ],
-    "eslintConfig": {
-        "extends": [
-            "plugin:@hapi/module"
-        ]
-    },
     "dependencies": {
         "@babel/core": "^7.16.0",
-        "@babel/eslint-parser": "^7.16.0",
+        "@babel/eslint-parser": "^7.25.1",
         "@hapi/bossy": "^6.0.0",
-        "@hapi/eslint-plugin": "^6.0.0",
+        "@hapi/eslint-plugin": "^7.0.0",
         "@hapi/hoek": "^11.0.2",
         "diff": "^5.0.0",
-        "eslint": "8.x.x",
+        "eslint": "9.x.x",
         "find-rc": "4.x.x",
         "globby": "^11.1.0",
         "handlebars": "4.x.x",
@@ -37,7 +32,7 @@
         "will-call": "1.x.x"
     },
     "peerDependencies": {
-        "@hapi/eslint-plugin": "^6.0.0",
+        "@hapi/eslint-plugin": "^7.0.0",
         "typescript": ">=3.6.5"
     },
     "peerDependenciesMeta": {
@@ -48,13 +43,14 @@
     "devDependencies": {
         "@hapi/code": "^9.0.0",
         "@hapi/somever": "^4.0.0",
+        "@types/eslint": "^9.6.0",
         "@types/node": "^18.11.17",
-        "@typescript-eslint/parser": "^5.62.0",
         "cpr": "3.x.x",
         "lab-event-reporter": "1.x.x",
         "semver": "7.x.x",
         "tsconfig-paths": "^4.0.0",
-        "typescript": "^4.5.4"
+        "typescript": "^4.5.4",
+        "typescript-eslint": "^8.1.0"
     },
     "bin": {
         "lab": "./bin/lab"