metalint 0.14.1 → 0.16.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2023 Sébastien Règne
+Copyright (c) 2020-2024 Sébastien Règne
 
 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/README.md

@@ -1,6 +1,7 @@
 # Metalint
 
-<!-- Utiliser du HTML pour faire flotter l'image à droite. -->
+<!-- Utiliser du HTML (avec l'attribut "align" obsolète) pour faire flotter
+     l'image à droite. -->
 <!-- markdownlint-disable-next-line no-inline-html-->
 <img src="asset/logo.svg" align="right" alt="">
 
@@ -72,6 +73,7 @@ source) :
   <tr>
     <td>JSON</td>
     <td>
+      <a title="ajv" href="https://www.npmjs.com/package/ajv">Ajv</a>,
       <a title="@prantlf/jsonlint"
          href="https://www.npmjs.com/package/@prantlf/jsonlint">@prantlf/JSON
         Lint</a>,
@@ -100,18 +102,16 @@ source) :
   <tr>
     <td>package.json</td>
     <td>
-      <!-- markdownlint-disable no-bare-urls -->
-      <!-- https://github.com/DavidAnson/markdownlint/issues/961 -->
+      <a title="depcheck"
+         href="https://www.npmjs.com/package/depcheck">Depcheck</a>,
       <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="publint"
+         href="https://www.npmjs.com/package/publint">publint</a>,
       <a title="sort-package-json"
          href="https://www.npmjs.com/package/sort-package-json">Sort
         Package.json</a>
@@ -133,6 +133,15 @@ source) :
          href="https://www.npmjs.com/package/stylelint">Stylelint</a>
     </td>
   </tr>
+  <tr>
+    <td>SVG</td>
+    <td>
+      <a title="prettier"
+         href="https://www.npmjs.com/package/prettier">Prettier</a>,
+      <a title="svglint"
+         href="https://www.npmjs.com/package/svglint">SVGLint</a>
+    </td>
+  </tr>
   <tr>
     <td>WebExtension</td>
     <td>
@@ -221,6 +230,8 @@ export default {
 
 ## Intégration
 
+### npm
+
 Après avoir installé Metalint et les linters dans votre projet npm, vous pouvez
 ajouter le script suivant dans votre `package.json` :
 
@@ -234,9 +245,29 @@ ajouter le script suivant dans votre `package.json` :
 
 Metalint est maintenant utilisable avec la commande : `npm run lint`
 
+### GitHub Actions
+
+Pour lancer Metalint dans vos GitHub Actions, vous pouvez utiliser le formateur
+`github` pour rapporter les problèmes dans les pull requests.
+
+```YAML
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Install dependencies
+        run: npm ci
+      - name: Lint files
+        run: npm run lint -- --formatter github
+```
+
 [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-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=whitesmoke
 [link-npm]: https://www.npmjs.com/package/metalint
 [link-build]: https://github.com/regseb/metalint/actions/workflows/ci.yml?query=branch%3Amain

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metalint",
-  "version": "0.14.1",
+  "version": "0.16.0",
   "description": "Un linter pour les gouverner tous.",
   "keywords": [
     "checker",
@@ -24,7 +24,7 @@
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
-      "default": "./src/code/index.js"
+      "default": "./src/core/index.js"
     },
     "./api/formatter": {
       "types": "./types/formatter/formatter.d.ts",
@@ -34,6 +34,9 @@
       "types": "./types/wrapper/wrapper.d.ts",
       "default": "./src/core/wrapper/wrapper.js"
     },
+    "./types/config": {
+      "types": "./src/types/config.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "main": "./src/core/index.js",
@@ -47,7 +50,7 @@
     "lint:types": "tsc --project .tsconfig_lint.json",
     "test": "npm run test:unit",
     "test:unit": "mocha --config test/unit/mocharc.json",
-    "test:coverage": "stryker run .stryker.config.js",
+    "test:coverage": "stryker run",
     "jsdocs": "typedoc --tsconfig .tsconfig_jsdocs.json",
     "prepare": "tsc --project .tsconfig_types.json",
     "clean": "node .script/clean.js"
@@ -59,51 +62,56 @@
   "devDependencies": {
     "@coffeelint/cli": "5.2.11",
     "@prantlf/jsonlint": "14.0.3",
-    "@prettier/plugin-xml": "3.2.0",
-    "@stryker-mutator/core": "7.1.1",
-    "@stryker-mutator/mocha-runner": "7.1.1",
-    "@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/sinon": "10.0.16",
-    "@types/yargs": "17.0.24",
-    "addons-linter": "6.13.0",
+    "@prettier/plugin-xml": "3.4.1",
+    "@stryker-mutator/core": "8.2.6",
+    "@stryker-mutator/mocha-runner": "8.2.6",
+    "@types/eslint": "8.56.7",
+    "@types/htmlhint": "1.1.5",
+    "@types/jshint": "2.12.4",
+    "@types/mocha": "10.0.6",
+    "@types/sinon": "17.0.3",
+    "@types/yargs": "17.0.32",
+    "@typescript-eslint/eslint-plugin": "7.5.0",
+    "@typescript-eslint/parser": "7.5.0",
+    "addons-linter": "6.25.0",
+    "ajv": "8.12.0",
     "csslint": "1.0.5",
+    "depcheck": "1.4.7",
     "doiuse": "6.0.2",
-    "eslint": "8.49.0",
-    "eslint-plugin-array-func": "3.1.8",
+    "eslint": "8.57.0",
+    "eslint-plugin-array-func": "4.0.0",
     "eslint-plugin-eslint-comments": "3.2.0",
-    "eslint-plugin-import": "2.28.1",
-    "eslint-plugin-jsdoc": "46.5.1",
-    "eslint-plugin-mocha": "10.1.0",
-    "eslint-plugin-n": "16.0.2",
+    "eslint-plugin-import": "2.29.1",
+    "eslint-plugin-jsdoc": "48.2.2",
+    "eslint-plugin-mocha": "10.4.1",
+    "eslint-plugin-n": "16.6.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.1",
+    "eslint-plugin-regexp": "2.4.0",
+    "eslint-plugin-unicorn": "51.0.1",
     "htmlhint": "1.1.4",
     "htmllint": "0.8.0",
     "jshint": "2.13.6",
     "jsonlint-mod": "1.7.6",
-    "markdownlint": "0.31.0",
-    "markuplint": "3.12.1",
-    "mocha": "10.2.0",
-    "mock-fs": "5.2.0",
-    "npm-check-updates": "16.13.3",
-    "npm-package-json-lint": "7.0.0",
-    "prettier": "3.0.3",
-    "purgecss": "5.0.0",
-    "sinon": "15.2.0",
-    "sort-package-json": "2.5.1",
+    "jszip": "3.10.1",
+    "markdownlint": "0.34.0",
+    "markuplint": "4.5.0",
+    "mocha": "10.4.0",
+    "npm-check-updates": "16.14.18",
+    "npm-package-json-lint": "7.1.0",
+    "prettier": "3.2.5",
+    "publint": "0.2.7",
+    "purgecss": "6.0.0",
+    "sinon": "17.0.1",
+    "sort-package-json": "2.10.0",
     "standard": "17.1.0",
-    "stylelint": "15.10.3",
-    "typedoc": "0.25.1",
-    "typescript": "5.2.2",
+    "stylelint": "16.3.1",
+    "svglint": "2.7.1",
+    "typedoc": "0.25.12",
+    "typescript": "5.4.3",
     "yaml-lint": "1.7.0"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.6.0"
   }
 }

package/src/bin/argv.js

@@ -15,8 +15,8 @@ import { FORMATTERS } from "../core/formatter/formatter.js";
 import Levels from "../core/levels.js";
 
 /**
- * @typedef {import("../core/formatter/formatter.js").default} TypeofFormatter
- * @typedef {import("../type/index.d.ts").Level} Level
+ * @typedef {import("../types/level.d.ts").Level} Level
+ * @typedef {import("../types/typeofformatter.d.ts").default} TypeofFormatter
  */
 
 /**
@@ -31,11 +31,13 @@ import Levels from "../core/levels.js";
  * @property {TypeofFormatter|undefined} formatter L'option
  *                                                 <code>--formatter</code> de
  *                                                 la ligne de commande.
- * @property {Level}                     level     L'option <code>--level</code>
- *                                                 de la ligne de commande.
+ * @property {Level}                     level     L'option
+ *                                                 <code>--level</code> de la
+ *                                                 ligne de commande.
  * @property {boolean}                   help      L'option <code>--help</code>
  *                                                 de la ligne de commande.
  */
+
 /**
  * Extrait, vérifie et normalise les paramètres et les options de la ligne de
  * commande.

package/src/bin/index.js

@@ -1,86 +1,12 @@
 #!/usr/bin/env node
 
-// 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
 import fs from "node:fs/promises";
-import path from "node:path";
 import process from "node:process";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import flatten from "../core/configuration/flatten.js";
-import normalize from "../core/configuration/normalize.js";
-import metalint from "../core/index.js";
+import { fileURLToPath } from "node:url";
+import Metalint from "../core/index.js";
 import Severities from "../core/severities.js";
-import { exists } from "../core/utils/file.js";
-import Glob from "../core/utils/glob.js";
 import { parse } from "./argv.js";
 
-/**
- * @typedef {import("../core/formatter/formatter.js")} Formatter
- * @typedef {import("../type/index.d.ts").FlattenedConfigChecker} FlattenedConfigChecker
- * @typedef {import("../type/index.d.ts").FlattenedConfigReporter} FlattenedConfigReporter
- * @typedef {import("../type/index.d.ts").Severity} Severity
- */
-
-if (undefined === import.meta.resolve) {
-    /**
-     * Résous un chemin relatif à partir du module.
-     *
-     * @param {string} specifier Le chemin relatif vers un fichier ou un
-     *                           répertoire.
-     * @returns {string} L'URL absolue vers le fichier ou le répertoire.
-     * @see https://nodejs.org/api/esm.html#importmetaresolvespecifier-parent
-     */
-    import.meta.resolve = (specifier) => {
-        return new URL(specifier, import.meta.url).href;
-    };
-}
-
-/**
- * Vérifie (en appelant des linters) une liste de fichiers.
- *
- * @param {string[]}                  files     La liste des fichiers.
- * @param {FlattenedConfigChecker[]}  checkers  La liste des vérifications
- *                                              faites sur les fichiers.
- * @param {string}                    root      L'adresse du répertoire où se
- *                                              trouve le répertoire
- *                                              <code>.metalint/</code>.
- * @param {FlattenedConfigReporter[]} reporters La liste des rapporteurs
- *                                              utilisés pour afficher les
- *                                              résultats.
- * @returns {Promise<Severity|undefined>} La sévérité la plus élevée des
- *                                        résultats.
- */
-const check = async function (files, checkers, root, reporters) {
-    let severity;
-
-    const formatters = reporters.map((reporter) => {
-        // eslint-disable-next-line new-cap
-        return new reporter.formatter(reporter.level, reporter.options);
-    });
-    const results = await metalint(files, checkers, root);
-    for (const [file, notices] of Object.entries(results)) {
-        // 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) {
-                    severity = notice.severity;
-                }
-            }
-        }
-
-        // Afficher les notifications avec chaque rapporteur.
-        for (const formatter of formatters) {
-            await formatter.notify(file, notices);
-        }
-    }
-
-    // Attendre tous les rapporteurs.
-    await Promise.all(formatters.map((f) => f.finalize()));
-    return severity;
-};
-
 const argv = await parse();
 if (argv.help) {
     process.stdout.write(
@@ -89,37 +15,16 @@ if (argv.help) {
     process.exit(0);
 }
 
-let root = process.cwd();
-// Rechercher le fichier de configuration dans le répertoire courant, puis dans
-// les parents, grands-parents...
-while (!(await exists(path.join(root, argv.config)))) {
-    // Si on est remonté à la racine.
-    if (path.join(root, "..") === root) {
-        process.stderr.write("metalint: no such config file.\n");
-        process.exit(10);
-    }
-    root = path.join(root, "..");
-}
-
 try {
-    // eslint-disable-next-line no-unsanitized/method
-    const { default: config } = await import(
-        pathToFileURL(path.join(root, argv.config))
-    );
-    const { patterns, reporters, checkers } = flatten(
-        await normalize(config, {
-            dir: path.dirname(path.join(root, argv.config)),
-        }),
-        argv,
-    );
-
-    const glob = new Glob(patterns, { root });
-    const files = [];
-    for (const base of argv._) {
-        files.push(...(await glob.walk(base)));
-    }
+    const metalint = await Metalint.fromFileSystem({
+        config: argv.config,
+        fix: argv.fix,
+        formatter: argv.formatter,
+        level: argv.level,
+    });
+    const results = await metalint.lintFiles(argv._);
+    const severity = await metalint.report(results);
 
-    const severity = await check(files, checkers, root, reporters);
     let code;
     switch (severity) {
         case Severities.FATAL:

package/src/core/configuration/flatten.js

@@ -8,18 +8,18 @@ import Levels from "../levels.js";
 import { merge } from "../utils/object.js";
 
 /**
- * @typedef {import("../formatter/formatter.js").default} TypeofFormatter
- * @typedef {import("../../type/index.d.ts").FlattenedConfig} FlattenedConfig
- * @typedef {import("../../type/index.d.ts").FlattenedConfigChecker} FlattenedConfigChecker
- * @typedef {import("../../type/index.d.ts").FlattenedConfigLinter} FlattenedConfigLinter
- * @typedef {import("../../type/index.d.ts").FlattenedConfigOverride} FlattenedConfigOverride
- * @typedef {import("../../type/index.d.ts").FlattenedConfigReporter} FlattenedConfigReporter
- * @typedef {import("../../type/index.d.ts").Level} Level
- * @typedef {import("../../type/index.d.ts").NormalizedConfig} NormalizedConfig
- * @typedef {import("../../type/index.d.ts").NormalizedConfigChecker} NormalizedConfigChecker
- * @typedef {import("../../type/index.d.ts").NormalizedConfigLinter} NormalizedConfigLinter
- * @typedef {import("../../type/index.d.ts").NormalizedConfigOverride} NormalizedConfigOverride
- * @typedef {import("../../type/index.d.ts").NormalizedConfigReporter} NormalizedConfigReporter
+ * @typedef {import("../../types/configuration/flattened.d.ts").FlattenedConfig} FlattenedConfig
+ * @typedef {import("../../types/configuration/flattened.d.ts").FlattenedConfigChecker} FlattenedConfigChecker
+ * @typedef {import("../../types/configuration/flattened.d.ts").FlattenedConfigLinter} FlattenedConfigLinter
+ * @typedef {import("../../types/configuration/flattened.d.ts").FlattenedConfigOverride} FlattenedConfigOverride
+ * @typedef {import("../../types/configuration/flattened.d.ts").FlattenedConfigReporter} FlattenedConfigReporter
+ * @typedef {import("../../types/configuration/normalized.d.ts").NormalizedConfig} NormalizedConfig
+ * @typedef {import("../../types/configuration/normalized.d.ts").NormalizedConfigChecker} NormalizedConfigChecker
+ * @typedef {import("../../types/configuration/normalized.d.ts").NormalizedConfigLinter} NormalizedConfigLinter
+ * @typedef {import("../../types/configuration/normalized.d.ts").NormalizedConfigOverride} NormalizedConfigOverride
+ * @typedef {import("../../types/configuration/normalized.d.ts").NormalizedConfigReporter} NormalizedConfigReporter
+ * @typedef {import("../../types/level.d.ts").default} Level
+ * @typedef {import("../../types/typeofformatter.js").default} TypeofFormatter
  */
 
 /**
@@ -42,9 +42,9 @@ export const flattenPatterns = function (hierarchies, { patterns }) {
  * @param {boolean|undefined} hierarchy   La valeur d'une des propriétés
  *                                        <code>"fix"</code>.
  * @param {Object}            context     Le contexte de la fusion.
- * @param {boolean|undefined} context.fix La valeur de la propriété
+ * @param {boolean}           context.fix La valeur de la propriété
  *                                        <code>"fix"</code> parente.
- * @returns {boolean|undefined} La valeur fusionnée.
+ * @returns {boolean} La valeur fusionnée.
  */
 export const flattenFix = function (hierarchy, { fix }) {
     return hierarchy ?? fix;
@@ -67,13 +67,14 @@ export const flattenLevel = function (hierarchy, { level }) {
 /**
  * Fusionne une propriété <code>"options"</code>.
  *
- * @param {Record<string, any>[]} hierarchies     La valeur d'une des propriétés
- *                                                <code>"options"</code>.
- * @param {Object}                context         Le contexte de la fusion.
- * @param {Record<string, any>}   context.options La valeur de la propriété
- *                                                <code>"options"</code>
- *                                                parente.
- * @returns {Record<string, any>} La valeur fusionnée.
+ * @param {Record<string, unknown>[]} hierarchies     La valeur d'une des
+ *                                                    propriétés
+ *                                                    <code>"options"</code>.
+ * @param {Object}                    context         Le contexte de la fusion.
+ * @param {Record<string, unknown>}   context.options La valeur de la propriété
+ *                                                    <code>"options"</code>
+ *                                                    parente.
+ * @returns {Record<string, unknown>} La valeur fusionnée.
  */
 export const flattenOptions = function (hierarchies, { options }) {
     return [options, ...hierarchies].reduce(merge);
@@ -87,8 +88,7 @@ export const flattenOptions = function (hierarchies, { options }) {
  *                                                 <code>"reporters"</code>.
  * @param {Object}                   context       Le contexte de la fusion.
  * @param {Level}                    context.level La valeur de la propriété
- *                                                 <code>"level"</code>
- *                                                 parente.
+ *                                                 <code>"level"</code> parente.
  * @returns {FlattenedConfigReporter} La valeur fusionnée.
  */
 export const flattenReporter = function (hierarchy, { level }) {
@@ -107,7 +107,7 @@ export const flattenReporter = function (hierarchy, { level }) {
  *                                                       <code>"reporters"</code>.
  * @param {Object}                     context           Le contexte de la
  *                                                       fusion.
- * @param {TypeofFormatter}            context.formatter La valeur de la
+ * @param {TypeofFormatter|undefined}  context.formatter La valeur de la
  *                                                       propriété
  *                                                       <code>"formatter"</code>
  *                                                       parente.
@@ -134,18 +134,18 @@ export const flattenReporters = function (hierarchies, { formatter, level }) {
 /**
  * Fusionne un élément d'une propriété <code>"linters"</code>.
  *
- * @param {NormalizedConfigLinter} hierarchy       La valeur de l'élément d'une
- *                                                 des propriétés
- *                                                 <code>"linters"</code>.
- * @param {Object}                 context         Le contexte de la fusion.
- * @param {boolean|undefined}      context.fix     La valeur de la propriété
- *                                                 <code>"fix"</code> parente.
- * @param {Level}                  context.level   La valeur de la propriété
- *                                                 <code>"level"</code>
- *                                                 parente.
- * @param {Record<string, any>}    context.options La valeur de la propriété
- *                                                 <code>"options"</code>
- *                                                 parente.
+ * @param {NormalizedConfigLinter}  hierarchy       La valeur de l'élément d'une
+ *                                                  des propriétés
+ *                                                  <code>"linters"</code>.
+ * @param {Object}                  context         Le contexte de la fusion.
+ * @param {boolean}                 context.fix     La valeur de la propriété
+ *                                                  <code>"fix"</code> parente.
+ * @param {Level}                   context.level   La valeur de la propriété
+ *                                                  <code>"level"</code>
+ *                                                  parente.
+ * @param {Record<string, unknown>} context.options La valeur de la propriété
+ *                                                  <code>"options"</code>
+ *                                                  parente.
  * @returns {FlattenedConfigLinter} La valeur fusionnée.
  */
 export const flattenLinter = function (hierarchy, { fix, level, options }) {
@@ -164,7 +164,7 @@ export const flattenLinter = function (hierarchy, { fix, level, options }) {
  *                                                 propriétés
  *                                                 <code>"linters"</code>.
  * @param {Object}                   context       Le contexte de la fusion.
- * @param {boolean|undefined}        context.fix   La valeur de la propriété
+ * @param {boolean}                  context.fix   La valeur de la propriété
  *                                                 <code>"fix"</code> parente.
  * @param {Level}                    context.level La valeur de la propriété
  *                                                 <code>"level"</code> parente.
@@ -200,15 +200,14 @@ export const flattenLinters = function (hierarchies, { fix, level }) {
 /**
  * Fusionne un élément d'une propriété <code>"overrides"</code>.
  *
- * @param {NormalizedConfigOverride} hierarchy     La valeur de l'élément
- *                                                 d'une des propriétés
+ * @param {NormalizedConfigOverride} hierarchy     La valeur de l'élément d'une
+ *                                                 des propriétés
  *                                                 <code>"overrides"</code>.
  * @param {Object}                   context       Le contexte de la fusion.
- * @param {boolean|undefined}        context.fix   La valeur de la propriété
+ * @param {boolean}                  context.fix   La valeur de la propriété
  *                                                 <code>"fix"</code> parente.
  * @param {Level}                    context.level La valeur de la propriété
- *                                                 <code>"level"</code>
- *                                                 parente.
+ *                                                 <code>"level"</code> parente.
  * @returns {FlattenedConfigOverride} La valeur fusionnée.
  */
 export const flattenOverride = function (hierarchy, { fix, level }) {
@@ -228,7 +227,7 @@ export const flattenOverride = function (hierarchy, { fix, level }) {
  *                                                propriété
  *                                                <code>"checkers"</code>.
  * @param {Object}                  context       Le contexte de la fusion.
- * @param {boolean|undefined}       context.fix   La valeur de la propriété
+ * @param {boolean}                 context.fix   La valeur de la propriété
  *                                                <code>"fix"</code> parente.
  * @param {Level}                   context.level La valeur de la propriété
  *                                                <code>"level"</code> parente.
@@ -255,16 +254,20 @@ export const flattenChecker = function (hierarchy, { fix, level }) {
 /**
  * Fusionne la configuration.
  *
- * @param {NormalizedConfig}  hierarchy      L'objet JSON normalisé contenant la
- *                                           configuration.
- * @param {Object}            argv           Certaines options de la ligne de
- *                                           commande.
- * @param {boolean|undefined} argv.fix       L'option <code>--fix</code> de la
- *                                           ligne de commande.
- * @param {TypeofFormatter}   argv.formatter L'option <code>--formatter</code>
- *                                           de la ligne de commande.
- * @param {Level}             argv.level     L'options <code>--level</code> de
- *                                           la ligne de commande.
+ * @param {NormalizedConfig}          hierarchy        L'objet JSON normalisé
+ *                                                     contenant la
+ *                                                     configuration.
+ * @param {Object}                    argv             Certaines options de la
+ *                                                     ligne de commande.
+ * @param {boolean|undefined}         [argv.fix]       L'option
+ *                                                     <code>--fix</code> de la
+ *                                                     ligne de commande.
+ * @param {TypeofFormatter|undefined} [argv.formatter] L'option
+ *                                                     <code>--formatter</code>
+ *                                                     de la ligne de commande.
+ * @param {Level|undefined}           [argv.level]     L'options
+ *                                                     <code>--level</code> de
+ *                                                     la ligne de commande.
  * @returns {FlattenedConfig} L'objet JSON fusionné.
  */
 export const flatten = function (hierarchy, argv) {
@@ -272,7 +275,6 @@ export const flatten = function (hierarchy, argv) {
     const level = flattenLevel(argv.level ?? Levels.INFO, {
         level: hierarchy.level,
     });
-    // TODO Vérifier que checkers n'est pas vide.
     return {
         patterns: hierarchy.patterns,
         reporters: flattenReporters(hierarchy.reporters, {