metalint 0.13.0 → 0.14.1

package/README.md

@@ -100,15 +100,21 @@ source) :
   <tr>
     <td>package.json</td>
     <td>
+      <!-- markdownlint-disable no-bare-urls -->
+      <!-- https://github.com/DavidAnson/markdownlint/issues/961 -->
       <a title="npm-check-updates"
          href="https://www.npmjs.com/package/npm-check-updates"
          >npm-check-updates</a>,
+      <!-- markdownlint-enable no-bare-urls -->
+      <!-- markdownlint-disable no-bare-urls -->
+      <!-- https://github.com/DavidAnson/markdownlint/issues/961 -->
       <a title="npm-package-json-lint"
          href="https://www.npmjs.com/package/npm-package-json-lint"
          >npm-package-json-lint</a>,
+      <!-- markdownlint-enable no-bare-urls -->
       <a title="sort-package-json"
-         href="https://www.npmjs.com/package/sort-package-json"
-         >Sort Package.json</a>
+         href="https://www.npmjs.com/package/sort-package-json">Sort
+        Package.json</a>
     </td>
   </tr>
   <tr>
@@ -228,14 +234,10 @@ ajouter le script suivant dans votre `package.json` :
 
 Metalint est maintenant utilisable avec la commande : `npm run lint`
 
-[img-npm]: https://img.shields.io/npm/dm/metalint?label=npm&logo=npm&logoColor=white
-[img-build]: https://img.shields.io/github/actions/workflow/status/regseb/metalint/ci.yml?branch=main&logo=github&logoColor=white
-
-<!-- Attendre que le logo de Stryker soit accepté.
-     https://github.com/simple-icons/simple-icons/pull/7388 -->
-
-[img-coverage]: https://img.shields.io/endpoint?label=coverage&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fregseb%2Fmetalint%2Fmain
-[img-semver]: https://img.shields.io/badge/semver-2.0.0-blue?logo=semver&logoColor=white
+[img-npm]: https://img.shields.io/npm/dm/metalint?label=npm&logo=npm&logoColor=whitesmoke
+[img-build]: https://img.shields.io/github/actions/workflow/status/regseb/metalint/ci.yml?branch=main&logo=github&logoColor=whitesmoke
+[img-coverage]: https://img.shields.io/endpoint?label=coverage&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fregseb%2Fmetalint%2Fmain&logo=stryker&logoColor=whitesmoke
+[img-semver]: https://img.shields.io/badge/semver-2.0.0-blue?logo=semver&logoColor=whitesmoke
 [link-npm]: https://www.npmjs.com/package/metalint
 [link-build]: https://github.com/regseb/metalint/actions/workflows/ci.yml?query=branch%3Amain
 [link-coverage]: https://dashboard.stryker-mutator.io/reports/github.com/regseb/metalint/main

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metalint",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "description": "Un linter pour les gouverner tous.",
   "keywords": [
     "checker",
@@ -21,6 +21,21 @@
     "./src/",
     "./types/"
   ],
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./src/code/index.js"
+    },
+    "./api/formatter": {
+      "types": "./types/formatter/formatter.d.ts",
+      "default": "./src/core/formatter/formatter.js"
+    },
+    "./api/wrapper": {
+      "types": "./types/wrapper/wrapper.d.ts",
+      "default": "./src/core/wrapper/wrapper.js"
+    },
+    "./package.json": "./package.json"
+  },
   "main": "./src/core/index.js",
   "types": "./types/index.d.ts",
   "bin": "./src/bin/index.js",
@@ -35,7 +50,6 @@
     "test:coverage": "stryker run .stryker.config.js",
     "jsdocs": "typedoc --tsconfig .tsconfig_jsdocs.json",
     "prepare": "tsc --project .tsconfig_types.json",
-    "release": "standard-version",
     "clean": "node .script/clean.js"
   },
   "dependencies": {
@@ -45,52 +59,51 @@
   "devDependencies": {
     "@coffeelint/cli": "5.2.11",
     "@prantlf/jsonlint": "14.0.3",
-    "@prettier/plugin-xml": "3.1.1",
+    "@prettier/plugin-xml": "3.2.0",
     "@stryker-mutator/core": "7.1.1",
     "@stryker-mutator/mocha-runner": "7.1.1",
-    "@types/eslint": "8.44.0",
+    "@types/eslint": "8.44.2",
     "@types/htmlhint": "1.1.2",
+    "@types/jshint": "2.12.2",
     "@types/mocha": "10.0.1",
     "@types/mock-fs": "4.13.1",
-    "@types/prettier": "2.7.3",
-    "@types/sinon": "10.0.15",
+    "@types/sinon": "10.0.16",
     "@types/yargs": "17.0.24",
-    "addons-linter": "6.10.0",
+    "addons-linter": "6.13.0",
     "csslint": "1.0.5",
     "doiuse": "6.0.2",
-    "eslint": "8.45.0",
+    "eslint": "8.49.0",
     "eslint-plugin-array-func": "3.1.8",
     "eslint-plugin-eslint-comments": "3.2.0",
-    "eslint-plugin-import": "2.27.5",
-    "eslint-plugin-jsdoc": "46.4.4",
+    "eslint-plugin-import": "2.28.1",
+    "eslint-plugin-jsdoc": "46.5.1",
     "eslint-plugin-mocha": "10.1.0",
-    "eslint-plugin-n": "16.0.1",
+    "eslint-plugin-n": "16.0.2",
     "eslint-plugin-no-unsanitized": "4.0.2",
     "eslint-plugin-promise": "6.1.1",
     "eslint-plugin-regexp": "1.15.0",
-    "eslint-plugin-unicorn": "48.0.0",
+    "eslint-plugin-unicorn": "48.0.1",
     "htmlhint": "1.1.4",
     "htmllint": "0.8.0",
     "jshint": "2.13.6",
     "jsonlint-mod": "1.7.6",
-    "markdownlint": "0.29.0",
-    "markuplint": "3.12.0",
+    "markdownlint": "0.31.0",
+    "markuplint": "3.12.1",
     "mocha": "10.2.0",
     "mock-fs": "5.2.0",
-    "npm-check-updates": "16.10.16",
+    "npm-check-updates": "16.13.3",
     "npm-package-json-lint": "7.0.0",
-    "prettier": "3.0.0",
+    "prettier": "3.0.3",
     "purgecss": "5.0.0",
     "sinon": "15.2.0",
     "sort-package-json": "2.5.1",
     "standard": "17.1.0",
-    "standard-version": "9.5.0",
-    "stylelint": "15.10.2",
-    "typedoc": "0.24.8",
-    "typescript": "5.1.6",
+    "stylelint": "15.10.3",
+    "typedoc": "0.25.1",
+    "typescript": "5.2.2",
     "yaml-lint": "1.7.0"
   },
   "engines": {
-    "node": ">=18.12.0"
+    "node": ">=20.0.0"
   }
 }

package/src/bin/argv.js

@@ -90,7 +90,7 @@ export const parse = async function (argv = process.argv.slice(2)) {
                   ),
         config: args.config,
         fix: args.fix,
-        // Ne pas utiliser yargs.coerce() pour convertir les données car cette
+        // Ne pas utiliser yargs.coerce() pour convertir les données, car cette
         // méthode est incompatible avec yargs.choices().
         // https://github.com/yargs/yargs/issues/1379
         formatter:

package/src/bin/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// Désactiver cette règle car elle ne supporte pas les valeurs de la propriété
+// Désactiver cette règle, car elle ne supporte pas les valeurs de la propriété
 // "files" (du package.json) commençant par "./".
 // https://github.com/eslint-community/eslint-plugin-n/issues/99
 // eslint-disable-next-line n/no-unpublished-bin
@@ -49,7 +49,7 @@ if (undefined === import.meta.resolve) {
  * @param {FlattenedConfigReporter[]} reporters La liste des rapporteurs
  *                                              utilisés pour afficher les
  *                                              résultats.
- * @returns {Promise<Severity|undefined>} La sévérité la plus élévée des
+ * @returns {Promise<Severity|undefined>} La sévérité la plus élevée des
  *                                        résultats.
  */
 const check = async function (files, checkers, root, reporters) {
@@ -61,7 +61,7 @@ const check = async function (files, checkers, root, reporters) {
     });
     const results = await metalint(files, checkers, root);
     for (const [file, notices] of Object.entries(results)) {
-        // Déterminer la sévérité la plus élévée des résultats.
+        // Déterminer la sévérité la plus élevée des résultats.
         if (undefined !== notices) {
             for (const notice of notices) {
                 if (undefined === severity || severity > notice.severity) {

package/src/core/configuration/flatten.js

@@ -8,7 +8,6 @@ import Levels from "../levels.js";
 import { merge } from "../utils/object.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
  * @typedef {import("../formatter/formatter.js").default} TypeofFormatter
  * @typedef {import("../../type/index.d.ts").FlattenedConfig} FlattenedConfig
  * @typedef {import("../../type/index.d.ts").FlattenedConfigChecker} FlattenedConfigChecker

package/src/core/configuration/normalize.js

@@ -11,7 +11,6 @@ import Levels from "../levels.js";
 import Wrapper, { WRAPPERS } from "../wrapper/wrapper.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
  * @typedef {import("../../type/index.d.ts").Level} Level
  * @typedef {import("../../type/index.d.ts").NormalizedConfig} NormalizedConfig
  * @typedef {import("../../type/index.d.ts").NormalizedConfigChecker} NormalizedConfigChecker
@@ -481,8 +480,8 @@ export const normalizeCheckers = async function (partials, { dir }) {
 
 /**
  * Normalise la configuration. La structure de l'objet JSON contenant la
- * configuration est souple pour rendre le fichier moins verbeuse. Cette
- * fonction renseigne les valeurs par défaut pour les propriétes non-présentes.
+ * configuration est souple pour rendre le fichier moins verbeux. Cette fonction
+ * renseigne les valeurs par défaut pour les propriétés non-présentes.
  *
  * @param {*}      partial     L'objet JSON contenant la configuration.
  * @param {Object} context     Le context de la propriété.

package/src/core/formatter/checkstyle.js

@@ -9,7 +9,7 @@ import Severities from "../severities.js";
 import Formatter from "./formatter.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
@@ -46,7 +46,7 @@ export default class CheckstyleFormatter extends Formatter {
     /**
      * Le flux où écrire les résultats.
      *
-     * @type {WritableStream}
+     * @type {Writable}
      */
     #writer;
 
@@ -61,14 +61,13 @@ export default class CheckstyleFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
-     * @param {number}         [options.indent] La taille des indentations (en
-     *                                          espace) ou <code>-1</code> (par
-     *                                          défaut) pour ne pas mettre de
-     *                                          retour à la ligne.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
+     * @param {number}   [options.indent] La taille des indentations (en espace)
+     *                                    ou <code>-1</code> (par défaut) pour
+     *                                    ne pas mettre de retour à la ligne.
      */
     constructor(level, options) {
         super(level);

package/src/core/formatter/console.js

@@ -11,7 +11,7 @@ import Severities from "../severities.js";
 import Formatter from "./formatter.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Location} Location
  * @typedef {import("../../type/index.js").Notice} Notice
@@ -21,9 +21,9 @@ import Formatter from "./formatter.js";
 /**
  * Écrit un message avec un style / couleur.
  *
- * @param {WritableStream} writer  Le flux où afficher le message.
- * @param {string}         message Le message qui sera affiché.
- * @param {string}         [style] Le code du style.
+ * @param {Writable} writer  Le flux où afficher le message.
+ * @param {string}   message Le message qui sera affiché.
+ * @param {string}   [style] Le code du style.
  */
 const print = function (writer, message, style) {
     let line;
@@ -56,11 +56,11 @@ const print = function (writer, message, style) {
 /**
  * Écrit une ligne du code source.
  *
- * @param {number}         line    Le numéro de la ligne.
- * @param {string[]}       content Toutes les lignes du fichiers.
- * @param {boolean}        active  La marque indiquant si la problème est dans
- *                                 cette ligne.
- * @param {WritableStream} writer  Le flux où afficher la ligne.
+ * @param {number}   line    Le numéro de la ligne.
+ * @param {string[]} content Toutes les lignes du fichier.
+ * @param {boolean}  active  La marque indiquant si le problème est dans cette
+ *                           ligne.
+ * @param {Writable} writer  Le flux où afficher la ligne.
  */
 const printCodeSourceLine = function (line, content, active, writer) {
     // Vérifier que le numéro de la ligne demandée existe dans le fichier.
@@ -76,10 +76,10 @@ const printCodeSourceLine = function (line, content, active, writer) {
 /**
  * Écrit le code source proche des lieux où le problème a été trouvé.
  *
- * @param {Location[]}     locations Les positions, dans le code source, du
- *                                   problème.
- * @param {string[]}       content   Toutes les lignes du fichiers.
- * @param {WritableStream} writer    Le flux où afficher les lignes incriminées.
+ * @param {Location[]} locations Les positions, dans le code source, du
+ *                               problème.
+ * @param {string[]}   content   Toutes les lignes du fichier.
+ * @param {Writable}   writer    Le flux où afficher les lignes incriminées.
  */
 const printCodeSource = function (locations, content, writer) {
     const characters = [];
@@ -133,7 +133,7 @@ export default class ConsoleFormatter extends Formatter {
     /**
      * Le flux où écrire les résultats.
      *
-     * @type {WritableStream}
+     * @type {Writable}
      */
     #writer;
 
@@ -145,7 +145,7 @@ export default class ConsoleFormatter extends Formatter {
     #showZeroNotice;
 
     /**
-     * Le marque indiquant s'il  faut afficher les fichiers non-analysés.
+     * La marque indiquant s'il faut afficher les fichiers non-analysés.
      *
      * @type {boolean}
      */
@@ -154,20 +154,17 @@ export default class ConsoleFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level                    Le niveau de sévérité
-     *                                                  minimum des
-     *                                                  notifications affichées.
-     * @param {Object}         options                  Les options du
-     *                                                  formateur.
-     * @param {WritableStream} [options.writer]         Le flux où écrire les
-     *                                                  résultats.
-     * @param {boolean}        [options.showZeroNotice] La marque indiquant s'il
-     *                                                  faut afficher les
-     *                                                  fichiers sans
-     *                                                  notification.
-     * @param {boolean}        [options.showNoChecked]  Le marque indiquant s'il
-     *                                                  faut afficher les
-     *                                                  fichiers non-analysés.
+     * @param {Level}    level                    Le niveau de sévérité minimum
+     *                                            des notifications affichées.
+     * @param {Object}   options                  Les options du formateur.
+     * @param {Writable} [options.writer]         Le flux où écrire les
+     *                                            résultats.
+     * @param {boolean}  [options.showZeroNotice] La marque indiquant s'il faut
+     *                                            afficher les fichiers sans
+     *                                            notification.
+     * @param {boolean}  [options.showNoChecked]  Le marque indiquant s'il faut
+     *                                            afficher les fichiers
+     *                                            non-analysés.
      */
     constructor(level, options) {
         super(level);

package/src/core/formatter/csv.js

@@ -8,7 +8,7 @@ import process from "node:process";
 import Formatter from "./formatter.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
@@ -33,23 +33,23 @@ export default class CSVFormatter extends Formatter {
     /**
      * Le flux où écrire les résultats.
      *
-     * @type {WritableStream}
+     * @type {Writable}
      */
     #writer;
 
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
      */
     constructor(level, options) {
         super(level);
         this.#writer = options.writer ?? process.stdout;
 
-        // Ecrire la ligne des titres.
+        // Écrire la ligne des titres.
         this.#writer.write("file,line,column,message,linter,rule\r\n");
     }
 

package/src/core/formatter/github.js

@@ -9,7 +9,7 @@ import Severities from "../severities.js";
 import Formatter from "./formatter.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
@@ -23,17 +23,17 @@ export default class GitHubFormatter extends Formatter {
     /**
      * Le flux où écrire les résultats.
      *
-     * @type {WritableStream}
+     * @type {Writable}
      */
     #writer;
 
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
      */
     constructor(level, options) {
         super(level);

package/src/core/formatter/json.js

@@ -8,13 +8,13 @@ import process from "node:process";
 import Formatter from "./formatter.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
 
 /**
- * Le formateur qui écrit les résultats brut (au format JSON). La seul
+ * Le formateur qui écrit les résultats bruts (au format JSON). La seule
  * altération des résultats est le remplacement des <code>undefined</code> par
  * des <code>null</code>.
  *
@@ -24,7 +24,7 @@ export default class JSONFormatter extends Formatter {
     /**
      * Le flux où écrire les résultats.
      *
-     * @type {WritableStream}
+     * @type {Writable}
      */
     #writer;
 
@@ -46,12 +46,12 @@ export default class JSONFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
-     * @param {number}         [options.indent] La taille des indentations (en
-     *                                          espace).
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
+     * @param {number}   [options.indent] La taille des indentations (en
+     *                                    espace).
      */
     constructor(level, options) {
         super(level);

package/src/core/formatter/unix.js

@@ -8,7 +8,7 @@ import process from "node:process";
 import Formatter from "./formatter.js";
 
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
@@ -21,7 +21,7 @@ export default class UnixFormatter extends Formatter {
     /**
      * Le flux où écrire les résultats.
      *
-     * @type {WritableStream}
+     * @type {Writable}
      */
     #writer;
 
@@ -35,10 +35,10 @@ export default class UnixFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
      */
     constructor(level, options) {
         super(level);

package/src/core/index.js

@@ -64,8 +64,8 @@ const Results = class {
             this.#data[file] = [];
         }
         for (const notice of notices) {
-            // Vérifier aussi le fichier de la notification car il peut être
-            // différent du fichier d'origine (qui est peut être un répertoire
+            // Vérifier aussi le fichier de la notification, car il peut être
+            // différent du fichier d'origine (qui est peut-être un répertoire
             // ou une archive).
             if (undefined === this.#data[notice.file]) {
                 this.#data[notice.file] = [];
@@ -110,12 +110,12 @@ export default async function metalint(files, checkers, root) {
         for (const checker of checkers) {
             const glob = new Glob(checker.patterns, { root });
             if (glob.test(file)) {
-                const key = [glob];
+                let key = checker.patterns.join();
                 const values = [checker.linters];
                 for (const override of checker.overrides) {
                     const subglob = new Glob(override.patterns, { root });
                     if (subglob.test(file)) {
-                        key.push(subglob);
+                        key += "|" + override.patterns.join();
                         values.push(override.linters);
                     }
                 }

package/src/core/utils/array.js

@@ -9,7 +9,7 @@
  *
  * @template T
  * @param {T|T[]} value L'élément.
- * @returns {T[]} Un avec seulement l'élément d'entré ou l'élément.
+ * @returns {T[]} Un tableau avec seulement l'élément d'entrée ou l'élément.
  */
 export const wrap = function (value) {
     return Array.isArray(value) ? value : [value];

package/src/core/utils/glob.js

@@ -180,7 +180,7 @@ export default class Glob {
     /**
      * Teste si un fichier / répertoire respecte les patrons.
      *
-     * @param {string} file Le chemin du fichier / répertoire  qui sera vérifié.
+     * @param {string} file Le chemin du fichier / répertoire qui sera vérifié.
      * @returns {string} <code>"DEEP_NEGATIVE"</code> pour un répertoire ne
      *                   respectant pas un patron qui exclue aussi ses
      *                   fichiers ; <code>"NEGATIVE"</code> si le fichier /

package/src/core/wrapper/doiuse.js

@@ -7,8 +7,8 @@
 // Ne pas utiliser la version promise de fs car la fonction createReadStream()
 // n'y est pas. https://github.com/nodejs/node/issues/38627
 import { createReadStream } from "node:fs";
-// Désactiver deux règles ESLint pour cette import car elles ne supportent pas
-// la propriété "exports" du package.json.
+// Désactiver deux règles ESLint pour cet import, car elles ne supportent pas la
+// propriété "exports" du package.json.
 // https://github.com/import-js/eslint-plugin-import/issues/1810
 // https://github.com/eslint-community/eslint-plugin-n/issues/21
 // eslint-disable-next-line import/no-unresolved, n/file-extension-in-import

package/src/core/wrapper/eslint.js

@@ -6,10 +6,18 @@
 
 import fs from "node:fs/promises";
 import { ESLint } from "eslint";
+// Désactiver deux règles ESLint pour cet import, car elles ne supportent pas la
+// propriété "exports" du package.json.
+// https://github.com/import-js/eslint-plugin-import/issues/1810
+// https://github.com/eslint-community/eslint-plugin-n/issues/21
+// eslint-disable-next-line import/no-unresolved, n/file-extension-in-import
+import pkg from "eslint/use-at-your-own-risk";
 import Levels from "../levels.js";
 import Severities from "../severities.js";
 import Wrapper from "./wrapper.js";
 
+const { FlatESLint } = pkg;
+
 /**
  * @typedef {import("../../type/index.d.ts").Level} Level
  * @typedef {import("../../type/index.d.ts").PartialNotice} PartialNotice
@@ -46,13 +54,24 @@ export default class ESLintWrapper extends Wrapper {
      */
     constructor(context, options) {
         super(context);
-        this.#eslint = new ESLint({
-            globInputPaths: false,
-            ignore: false,
-            baseConfig: options,
-            useEslintrc: false,
-            fix: this.fix,
-        });
+        const { configType, ...baseConfig } = options;
+        if ("flat" === configType) {
+            this.#eslint = new FlatESLint({
+                globInputPaths: false,
+                ignore: false,
+                baseConfig,
+                fix: this.fix,
+                overrideConfigFile: true,
+            });
+        } else {
+            this.#eslint = new ESLint({
+                globInputPaths: false,
+                ignore: false,
+                baseConfig,
+                useEslintrc: false,
+                fix: this.fix,
+            });
+        }
     }
 
     /**

package/src/core/wrapper/npm-package-json-lint.js

@@ -46,10 +46,7 @@ export default class NpmPackageJSONLintWrapper extends Wrapper {
      */
     constructor(context, options) {
         super(context);
-        this.#options = {
-            rules: {},
-            ...options,
-        };
+        this.#options = options;
     }
 
     /**

package/src/core/wrapper/stylelint.js

@@ -15,7 +15,7 @@ import Wrapper from "./wrapper.js";
  */
 
 /**
- * L'enrobage du linter <strong>Stytelint</strong>.
+ * L'enrobage du linter <strong>Stylelint</strong>.
  *
  * @see https://www.npmjs.com/package/stylelint
  */
@@ -29,7 +29,7 @@ export default class StylelintWrapper extends Wrapper {
     #options;
 
     /**
-     * Crée un enrobage pour le linter <strong>Stytelint</strong>.
+     * Crée un enrobage pour le linter <strong>Stylelint</strong>.
      *
      * @param {Object}              context       Le contexte de l'enrobage.
      * @param {Level}               context.level Le niveau de sévérité minimum
@@ -46,9 +46,7 @@ export default class StylelintWrapper extends Wrapper {
     constructor(context, options) {
         super(context);
         this.#options = {
-            // Définir la propriété "rules" car celle-ci est obligatoire (même
-            // si aucune règle est spécifiée).
-            config: { rules: {}, ...options },
+            config: options,
             fix: this.fix,
             // Laisser à Metalint la gestion des fichiers à ignorer.
             disableDefaultIgnores: true,

package/src/core/wrapper/yaml-lint.js

@@ -71,7 +71,7 @@ export default class YAMLLintWrapper extends Wrapper {
                     locations: [
                         {
                             // Augmenter de un le numéro de la ligne et de la
-                            // colonne car YAML Lint commence les numérotations
+                            // colonne, car YAML Lint commence les numérotations
                             // à zéro.
                             line: err.mark.line + 1,
                             column: err.mark.column + 1,

package/types/configuration/flatten.d.ts

@@ -40,7 +40,6 @@ export function flatten(hierarchy: NormalizedConfig, argv: {
     level: Level;
 }): FlattenedConfig;
 export default flatten;
-export type WritableStream = NodeJS.WritableStream;
 export type TypeofFormatter = import("../formatter/formatter.js").default;
 export type FlattenedConfig = import("../../type/index.d.ts").FlattenedConfig;
 export type FlattenedConfigChecker = import("../../type/index.d.ts").FlattenedConfigChecker;

package/types/configuration/normalize.d.ts

@@ -39,7 +39,6 @@ export function normalize(partial: any, { dir }: {
     dir: string;
 }): Promise<NormalizedConfig>;
 export default normalize;
-export type WritableStream = NodeJS.WritableStream;
 export type Level = import("../../type/index.d.ts").Level;
 export type NormalizedConfig = import("../../type/index.d.ts").NormalizedConfig;
 export type NormalizedConfigChecker = import("../../type/index.d.ts").NormalizedConfigChecker;

package/types/formatter/checkstyle.d.ts

@@ -8,22 +8,21 @@ export default class CheckstyleFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
-     * @param {number}         [options.indent] La taille des indentations (en
-     *                                          espace) ou <code>-1</code> (par
-     *                                          défaut) pour ne pas mettre de
-     *                                          retour à la ligne.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
+     * @param {number}   [options.indent] La taille des indentations (en espace)
+     *                                    ou <code>-1</code> (par défaut) pour
+     *                                    ne pas mettre de retour à la ligne.
      */
     constructor(level: Level, options: {
-        writer?: WritableStream;
+        writer?: Writable;
         indent?: number;
     });
     #private;
 }
-export type WritableStream = NodeJS.WritableStream;
+export type Writable = import("node:stream").Writable;
 export type Level = import("../../type/index.js").Level;
 export type Notice = import("../../type/index.js").Notice;
 import Formatter from "./formatter.js";

package/types/formatter/console.d.ts

@@ -5,29 +5,26 @@ export default class ConsoleFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level                    Le niveau de sévérité
-     *                                                  minimum des
-     *                                                  notifications affichées.
-     * @param {Object}         options                  Les options du
-     *                                                  formateur.
-     * @param {WritableStream} [options.writer]         Le flux où écrire les
-     *                                                  résultats.
-     * @param {boolean}        [options.showZeroNotice] La marque indiquant s'il
-     *                                                  faut afficher les
-     *                                                  fichiers sans
-     *                                                  notification.
-     * @param {boolean}        [options.showNoChecked]  Le marque indiquant s'il
-     *                                                  faut afficher les
-     *                                                  fichiers non-analysés.
+     * @param {Level}    level                    Le niveau de sévérité minimum
+     *                                            des notifications affichées.
+     * @param {Object}   options                  Les options du formateur.
+     * @param {Writable} [options.writer]         Le flux où écrire les
+     *                                            résultats.
+     * @param {boolean}  [options.showZeroNotice] La marque indiquant s'il faut
+     *                                            afficher les fichiers sans
+     *                                            notification.
+     * @param {boolean}  [options.showNoChecked]  Le marque indiquant s'il faut
+     *                                            afficher les fichiers
+     *                                            non-analysés.
      */
     constructor(level: Level, options: {
-        writer?: WritableStream;
+        writer?: Writable;
         showZeroNotice?: boolean;
         showNoChecked?: boolean;
     });
     #private;
 }
-export type WritableStream = NodeJS.WritableStream;
+export type Writable = import("node:stream").Writable;
 export type Level = import("../../type/index.js").Level;
 export type Location = import("../../type/index.js").Location;
 export type Notice = import("../../type/index.js").Notice;

package/types/formatter/csv.d.ts

@@ -7,17 +7,17 @@ export default class CSVFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
      */
     constructor(level: Level, options: {
-        writer?: WritableStream;
+        writer?: Writable;
     });
     #private;
 }
-export type WritableStream = NodeJS.WritableStream;
+export type Writable = import("node:stream").Writable;
 export type Level = import("../../type/index.js").Level;
 export type Notice = import("../../type/index.js").Notice;
 import Formatter from "./formatter.js";

package/types/formatter/github.d.ts

@@ -1,5 +1,5 @@
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
@@ -12,17 +12,17 @@ export default class GitHubFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
      */
     constructor(level: Level, options: {
-        writer?: WritableStream;
+        writer?: Writable;
     });
     #private;
 }
-export type WritableStream = NodeJS.WritableStream;
+export type Writable = import("node:stream").Writable;
 export type Level = import("../../type/index.js").Level;
 export type Notice = import("../../type/index.js").Notice;
 import Formatter from "./formatter.js";

package/types/formatter/json.d.ts

@@ -1,10 +1,10 @@
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
 /**
- * Le formateur qui écrit les résultats brut (au format JSON). La seul
+ * Le formateur qui écrit les résultats bruts (au format JSON). La seule
  * altération des résultats est le remplacement des <code>undefined</code> par
  * des <code>null</code>.
  *
@@ -14,20 +14,20 @@ export default class JSONFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
-     * @param {number}         [options.indent] La taille des indentations (en
-     *                                          espace).
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
+     * @param {number}   [options.indent] La taille des indentations (en
+     *                                    espace).
      */
     constructor(level: Level, options: {
-        writer?: WritableStream;
+        writer?: Writable;
         indent?: number;
     });
     #private;
 }
-export type WritableStream = NodeJS.WritableStream;
+export type Writable = import("node:stream").Writable;
 export type Level = import("../../type/index.js").Level;
 export type Notice = import("../../type/index.js").Notice;
 import Formatter from "./formatter.js";

package/types/formatter/unix.d.ts

@@ -1,5 +1,5 @@
 /**
- * @typedef {NodeJS.WritableStream} WritableStream
+ * @typedef {import("node:stream").Writable} Writable
  * @typedef {import("../../type/index.js").Level} Level
  * @typedef {import("../../type/index.js").Notice} Notice
  */
@@ -11,17 +11,17 @@ export default class UnixFormatter extends Formatter {
     /**
      * Crée un formateur.
      *
-     * @param {Level}          level            Le niveau de sévérité minimum
-     *                                          des notifications affichées.
-     * @param {Object}         options          Les options du formateur.
-     * @param {WritableStream} [options.writer] Le flux où écrire les résultats.
+     * @param {Level}    level            Le niveau de sévérité minimum des
+     *                                    notifications affichées.
+     * @param {Object}   options          Les options du formateur.
+     * @param {Writable} [options.writer] Le flux où écrire les résultats.
      */
     constructor(level: Level, options: {
-        writer?: WritableStream;
+        writer?: Writable;
     });
     #private;
 }
-export type WritableStream = NodeJS.WritableStream;
+export type Writable = import("node:stream").Writable;
 export type Level = import("../../type/index.js").Level;
 export type Notice = import("../../type/index.js").Notice;
 import Formatter from "./formatter.js";

package/types/wrapper/stylelint.d.ts

@@ -3,13 +3,13 @@
  * @typedef {import("../../type/index.d.ts").PartialNotice} PartialNotice
  */
 /**
- * L'enrobage du linter <strong>Stytelint</strong>.
+ * L'enrobage du linter <strong>Stylelint</strong>.
  *
  * @see https://www.npmjs.com/package/stylelint
  */
 export default class StylelintWrapper extends Wrapper {
     /**
-     * Crée un enrobage pour le linter <strong>Stytelint</strong>.
+     * Crée un enrobage pour le linter <strong>Stylelint</strong>.
      *
      * @param {Object}              context       Le contexte de l'enrobage.
      * @param {Level}               context.level Le niveau de sévérité minimum