chore: next version (#1079)

* chore: change CI target for next

* chore: add next branch to CI targets

* feat: target ESLint v9

* Tighten type checking config (#1071)

* Use more restrictive type signatures
* Don't rely on broken expect.error()

* chore: report node 18+ support (#1081)

* chore: update documentation for eslint ignore

---------

Co-authored-by: Gil Pedersen <[email protected]>

Author: Marsup

.eslintignore

@@ -4,11 +4,10 @@ on:
   push:
     branches:
       - master
+      - next
   pull_request:
   workflow_dispatch:
 
 jobs:
   test:
-    uses: hapijs/.github/.github/workflows/ci-module.yml@master
-    with:
-      min-node-version: 14
+    uses: hapijs/.github/.github/workflows/ci-module.yml@min-node-18-hapi-21

.github/workflows/ci-module.yml

@@ -632,10 +632,17 @@ Your project's eslint configuration will now extend the default **lab** configur
 
 ### Ignoring files in linting
 
-Since [eslint](http://eslint.org/) is used to lint, you can create an `.eslintignore` containing paths to be ignored:
-```
-node_modules/*
-**/vendor/*.js
+Since [eslint](http://eslint.org/) is used to lint, if you don't already have an `eslint.config.{js|cjs|mjs|ts|mts|cts}` you can create one,
+and add an `ignores` rule containing paths to be ignored. Here is an example preserving default hapi rules:
+```javascript
+import HapiPlugin from '@hapi/eslint-plugin';
+
+export default [
+    {
+        ignores: ['node_modules/*', '**/vendor/*.js'],
+    },
+    ...HapiPlugin.configs.module,
+];
 ```
 
 ### Only run linting

API.md

@@ -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,50 @@ 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') &&
+        !Fs.existsSync('eslint.config.ts') &&
+        !Fs.existsSync('eslint.config.mts') &&
+        !Fs.existsSync('eslint.config.cts')) {
+        // 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) {
-            configuration.extensions.push('.ts');
+            if (configuration.typescript) {
+                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 +84,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

@@ -15,6 +15,8 @@ const Utils = require('../utils');
 const internals = {
     compiler: {
         strict: true,
+        noUncheckedIndexedAccess: true,
+        exactOptionalPropertyTypes: true,
         jsx: Ts.JsxEmit.React,
         lib: ['lib.es2020.d.ts'],
         module: Ts.ModuleKind.CommonJS,