metalint 0.19.0 → 0.21.1

package/README.md

@@ -2,24 +2,21 @@
 
 <!-- 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="">
+<!-- markdownlint-disable-next-line no-inline-html -->
+<img src="asset/logo.svg" align="right" width="100" height="100" alt="">
 
 [![npm][img-npm]][link-npm] [![build][img-build]][link-build]
 [![coverage][img-coverage]][link-coverage] [![semver][img-semver]][link-semver]
 
-> _Un linter pour les gouverner tous._
+> _One linter to rule them all._
 
-## Description
-
-**Metalint** est un outil pour analyser tous les fichiers de votre projet.
-L'analyse est déléguée à des linters (outils d'analyse statique de code source)
-:
+**Metalint** is a tool for analyzing all the files in your project. Analysis is
+delegated to linters (static source code analysis tools):
 
 <!-- markdownlint-disable no-inline-html -->
 <table>
   <tr>
-    <th>Langage / Technologie</th>
+    <th>Language / Technology</th>
     <th>Linters</th>
   </tr>
   <tr>
@@ -32,6 +29,8 @@ L'analyse est déléguée à des linters (outils d'analyse statique de code sour
   <tr>
     <td>CSS</td>
     <td>
+      <a title="@biomejs/js-api"
+         href="https://www.npmjs.com/package/@biomejs/js-api">Biome</a>,
       <a title="doiuse" href="https://www.npmjs.com/package/doiuse">DoIUse</a>,
       <a title="prettier"
          href="https://www.npmjs.com/package/prettier">Prettier</a>,
@@ -57,6 +56,8 @@ L'analyse est déléguée à des linters (outils d'analyse statique de code sour
   <tr>
     <td>JavaScript</td>
     <td>
+      <a title="@biomejs/js-api"
+         href="https://www.npmjs.com/package/@biomejs/js-api">Biome</a>,
       <a title="eslint" href="https://www.npmjs.com/package/eslint">ESLint</a>,
       <a title="jshint" href="https://www.npmjs.com/package/jshint">JSHint</a>,
       <a title="standard"
@@ -70,6 +71,8 @@ L'analyse est déléguée à des linters (outils d'analyse statique de code sour
     <td>JSON</td>
     <td>
       <a title="ajv" href="https://www.npmjs.com/package/ajv">Ajv</a>,
+      <a title="@biomejs/js-api"
+         href="https://www.npmjs.com/package/@biomejs/js-api">Biome</a>,
       <a title="@mapbox/jsonlint-lines-primitives"
          href="https://www.npmjs.com/package/@mapbox/jsonlint-lines-primitives">@mapbox/JSON
         Lint lines-primitives</a>,
@@ -157,30 +160,36 @@ L'analyse est déléguée à des linters (outils d'analyse statique de code sour
          href="https://www.npmjs.com/package/prettier">Prettier</a>
     </td>
   </tr>
+  <tr>
+    <td></td>
+    <td>
+      <a title="secretlint"
+         href="https://www.npmjs.com/package/secretlint">Secretlint</a>
+    </td>
+  </tr>
 </table>
 <!-- markdownlint-enable no-inline-html -->
 
-## Installation
+## Install
 
-Vous pouvez installer Metalint en utilisant [npm][link-npm] :
+You can install Metalint using [npm][link-npm]:
 
 ```shell
-npm install --save-dev --save-exact metalint
+npm install --save-dev metalint
 ```
 
 ## Configuration
 
-Tous les fichiers de configuration sont à regrouper dans le répertoire
-`.metalint/` qui doit être placé à la racine du projet. Le fichier
-`metalint.config.js` export un objet JSON indiquant les linters à utiliser pour
-chaque fichier. Les autres fichiers contiennent les options spécifiques pour les
-linters.
+All configuration files are grouped together in the `.metalint/` directory,
+which should be placed at the root of the project. The `metalint.config.js` file
+exports a JSON object indicating the linters to be used for each file. The other
+files contain the specific options for the linters.
 
-## Exemple
+## Example
 
-Dans cet exemple des fichiers de configuration, Metalint analyse les fichiers
-JavaScript (non-minifiés), HTML et CSS ; avec respectivement les linters ESLint,
-HTMLHint et Stylelint.
+In this example of configuration files, Metalint analyzes JavaScript
+(non-minified), HTML and CSS files; with ESLint, HTMLHint and Stylelint linters
+respectively.
 
 ```javascript
 // .metalint/metalint.config.js
@@ -229,12 +238,18 @@ export default {
 };
 ```
 
-## Intégration
+If you want to see real configurations, you've got the
+[Metalint configuration](https://github.com/regseb/metalint/tree/HEAD/.metalint)
+itself; or the
+[Cast Kodi configuration](https://github.com/regseb/castkodi/tree/HEAD/.metalint)
+(a browser WebExtension developed in JavaScript, HTML, CSS).
+
+## Integration
 
 ### npm
 
-Après avoir installé Metalint et les linters dans votre projet npm, vous pouvez
-ajouter le script suivant dans votre `package.json` :
+After installing Metalint and the linters in your npm project, you can add the
+following script to your `package.json`:
 
 ```json
 {
@@ -245,23 +260,23 @@ ajouter le script suivant dans votre `package.json` :
 }
 ```
 
-Metalint est maintenant utilisable avec les commandes : `npm run lint` et
-`npm run lint:fix`
+Metalint can now be used with the following commands: `npm run lint` and
+`npm run lint:fix`.
 
 ### GitHub Actions
 
-Pour lancer Metalint dans vos GitHub Actions, vous pouvez utiliser le formateur
-`github` pour rapporter les problèmes dans les pull requests.
+To launch Metalint in your GitHub Actions, you can use the `github` formatter to
+report problems in pull requests.
 
 ```yaml
 jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           persist-credentials: false
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v5
       - name: Install dependencies
         run: npm ci
       - name: Lint files

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "metalint",
-  "version": "0.19.0",
-  "description": "Un linter pour les gouverner tous.",
+  "version": "0.21.1",
+  "description": "One linter to rule them all.",
   "keywords": [
     "checker",
     "lint",
@@ -44,8 +44,13 @@
   },
   "main": "./src/core/index.js",
   "types": "./types/core/index.d.ts",
-  "bin": "./src/bin/index.js",
-  "repository": "regseb/metalint",
+  "bin": {
+    "metalint": "src/bin/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/regseb/metalint.git"
+  },
   "type": "module",
   "scripts": {
     "lint": "node src/bin/index.js",
@@ -54,64 +59,177 @@
     "test": "npm run test:unit",
     "test:unit": "node --test 'test/unit/**/*.js'",
     "test:coverage": "stryker run",
+    "test:fuzz": "node --test 'test/fuzz/**/*.js'",
     "jsdocs": "typedoc --tsconfig .tsconfig_jsdocs.json",
     "prepare": "tsc --project .tsconfig_types.json",
     "clean": "node .script/clean.js"
   },
-  "dependencies": {
-    "chalk": "5.4.1",
-    "yargs": "17.7.2"
-  },
   "devDependencies": {
+    "@biomejs/js-api": "4.0.0",
+    "@biomejs/wasm-nodejs": "2.3.1",
     "@coffeelint/cli": "5.2.11",
     "@mapbox/jsonlint-lines-primitives": "2.0.2",
     "@prantlf/jsonlint": "16.0.0",
-    "@prettier/plugin-xml": "3.4.1",
-    "@stryker-mutator/core": "8.7.1",
-    "@stryker-mutator/tap-runner": "8.7.1",
-    "@types/eslint-plugin-mocha": "10.4.0",
+    "@prettier/plugin-xml": "3.4.2",
+    "@secretlint/secretlint-rule-github": "11.2.5",
+    "@secretlint/secretlint-rule-npm": "11.2.5",
+    "@stryker-mutator/core": "9.2.0",
+    "@stryker-mutator/tap-runner": "9.2.0",
     "@types/htmlhint": "1.1.5",
     "@types/js-yaml": "4.0.9",
     "@types/jshint": "2.12.4",
     "@types/semver-utils": "1.1.3",
-    "@types/yargs": "17.0.33",
-    "addons-linter": "7.7.0",
+    "addons-linter": "8.4.0",
     "ajv": "8.17.1",
     "depcheck": "1.4.7",
     "doiuse": "6.0.5",
-    "eslint": "9.17.0",
-    "eslint-plugin-array-func": "5.0.2",
+    "eslint": "9.38.0",
+    "eslint-plugin-array-func": "5.1.0",
     "eslint-plugin-eslint-comments": "3.2.0",
-    "eslint-plugin-import": "2.31.0",
-    "eslint-plugin-jsdoc": "50.6.1",
-    "eslint-plugin-mocha": "10.5.0",
-    "eslint-plugin-n": "17.15.1",
-    "eslint-plugin-no-unsanitized": "4.1.2",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-jsdoc": "61.1.9",
+    "eslint-plugin-mocha": "11.2.0",
+    "eslint-plugin-n": "17.23.1",
+    "eslint-plugin-no-unsanitized": "4.1.4",
     "eslint-plugin-promise": "7.2.1",
-    "eslint-plugin-regexp": "2.7.0",
-    "eslint-plugin-unicorn": "56.0.1",
-    "globals": "15.14.0",
-    "htmlhint": "1.1.4",
+    "eslint-plugin-regexp": "2.10.0",
+    "eslint-plugin-unicorn": "62.0.0",
+    "fast-check": "4.3.0",
+    "globals": "16.4.0",
+    "htmlhint": "1.7.1",
     "htmllint": "0.8.0",
     "jshint": "2.13.6",
     "jsonlint-mod": "1.7.6",
     "jszip": "3.10.1",
-    "markdownlint": "0.37.3",
-    "markuplint": "4.11.4",
-    "npm-check-updates": "17.1.13",
-    "npm-package-json-lint": "8.0.0",
-    "prettier": "3.4.2",
-    "publint": "0.2.12",
+    "markdownlint": "0.39.0",
+    "markuplint": "4.13.1",
+    "npm-check-updates": "19.1.1",
+    "npm-package-json-lint": "9.0.0",
+    "prettier": "3.6.2",
+    "publint": "0.3.15",
     "purgecss": "7.0.2",
-    "sort-package-json": "2.12.0",
+    "secretlint": "11.2.5",
+    "sort-package-json": "3.4.0",
     "standard": "17.1.2",
-    "stylelint": "16.12.0",
-    "svglint": "3.1.0",
-    "typedoc": "0.27.6",
-    "typescript": "5.7.2",
+    "stylelint": "16.25.0",
+    "svglint": "4.1.2",
+    "typedoc": "0.28.14",
+    "typescript": "5.9.3",
     "yaml-lint": "1.7.0"
   },
+  "peerDependencies": {
+    "@biomejs/js-api": ">=4.0.0",
+    "@biomejs/wasm-nodejs": ">=2.3.1",
+    "@coffeelint/cli": ">=5.2.11",
+    "@mapbox/jsonlint-lines-primitives": ">=2.0.2",
+    "@prantlf/jsonlint": ">=16.0.0",
+    "addons-linter": ">=8.4.0",
+    "ajv": ">=8.17.1",
+    "depcheck": ">=1.4.7",
+    "doiuse": ">=6.0.5",
+    "eslint": ">=9.38.0",
+    "htmlhint": ">=1.7.1",
+    "htmllint": ">=0.8.0",
+    "jshint": ">=2.13.6",
+    "jsonlint-mod": ">=1.7.6",
+    "markdownlint": ">=0.39.0",
+    "markuplint": ">=4.13.1",
+    "npm-check-updates": ">=19.1.1",
+    "npm-package-json-lint": ">=9.0.0",
+    "prettier": ">=3.6.2",
+    "publint": ">=0.3.15",
+    "purgecss": ">=7.0.2",
+    "secretlint": ">=11.2.3",
+    "sort-package-json": ">=3.4.0",
+    "standard": ">=17.1.2",
+    "stylelint": ">=16.25.0",
+    "svglint": ">=4.1.2",
+    "yaml-lint": ">=1.7.0"
+  },
+  "peerDependenciesMeta": {
+    "@biomejs/js-api": {
+      "optional": true
+    },
+    "@biomejs/wasm-nodejs": {
+      "optional": true
+    },
+    "@coffeelint/cli": {
+      "optional": true
+    },
+    "@mapbox/jsonlint-lines-primitives": {
+      "optional": true
+    },
+    "@prantlf/jsonlint": {
+      "optional": true
+    },
+    "addons-linter": {
+      "optional": true
+    },
+    "ajv": {
+      "optional": true
+    },
+    "depcheck": {
+      "optional": true
+    },
+    "doiuse": {
+      "optional": true
+    },
+    "eslint": {
+      "optional": true
+    },
+    "htmlhint": {
+      "optional": true
+    },
+    "htmllint": {
+      "optional": true
+    },
+    "jshint": {
+      "optional": true
+    },
+    "jsonlint-mod": {
+      "optional": true
+    },
+    "markdownlint": {
+      "optional": true
+    },
+    "markuplint": {
+      "optional": true
+    },
+    "npm-check-updates": {
+      "optional": true
+    },
+    "npm-package-json-lint": {
+      "optional": true
+    },
+    "prettier": {
+      "optional": true
+    },
+    "publint": {
+      "optional": true
+    },
+    "purgecss": {
+      "optional": true
+    },
+    "secretlint": {
+      "optional": true
+    },
+    "sort-package-json": {
+      "optional": true
+    },
+    "standard": {
+      "optional": true
+    },
+    "stylelint": {
+      "optional": true
+    },
+    "svglint": {
+      "optional": true
+    },
+    "yaml-lint": {
+      "optional": true
+    }
+  },
   "engines": {
-    "node": ">=22.12"
+    "node": ">=22.13.0"
   }
 }

package/src/bin/argv.js

@@ -6,24 +6,21 @@
 
 import fs from "node:fs/promises";
 import process from "node:process";
-import yargs from "yargs";
-import { hideBin } from "yargs/helpers";
+import { parseArgs } from "node:util";
 import {
     normalizeFix,
     normalizeFormatter,
     normalizeLevel,
 } from "../core/configuration/normalize.js";
-import { FORMATTERS } from "../core/formatter/formatter.js";
-import Levels from "../core/levels.js";
 
 /**
- * @import { Level } from "../core/levels.js"
  * @import { TypeofFormatter } from "../core/formatter/formatter.js"
+ * @import { Level } from "../core/levels.js"
  */
 
 /**
  * @typedef {Object} Argv
- * @prop {string[]}        _           Les paramètres de la ligne de commande.
+ * @prop {string[]}        bases       Les paramètres de la ligne de commande.
  * @prop {string}          config      L'option `--config` de la ligne de
  *                                     commande.
  * @prop {boolean}         [fix]       L'option `--fix` de la ligne de commande.
@@ -42,65 +39,54 @@ import Levels from "../core/levels.js";
  * @param {string[]} argv Les paramètres et les options de la ligne de commande.
  * @returns {Promise<Argv>} Les paramètres et les options normalisés.
  */
-export const parse = async function (argv = hideBin(process.argv)) {
-    // Désactiver cette règle, car il y a un faux-positif avec la méthode
-    // yargs.parseSync().
-    // eslint-disable-next-line n/no-sync
-    const args = yargs(argv)
-        .options({
+export const parse = async (argv = process.argv) => {
+    const { values, positionals } = parseArgs({
+        // Enlever les deux premiers arguments de la ligne de commande qui sont
+        // "node" et "index.js".
+        args: argv.slice(2),
+        options: {
             config: {
-                alias: "c",
-                default: ".metalint/metalint.config.js",
-                requiresArg: true,
                 type: "string",
+                short: "c",
+                default: ".metalint/metalint.config.js",
             },
             fix: {
                 type: "boolean",
             },
             formatter: {
-                alias: "f",
-                choices: FORMATTERS,
-                requiresArg: true,
                 type: "string",
+                short: "f",
             },
             level: {
-                alias: "l",
-                choices: Object.keys(Levels).map((l) => l.toLowerCase()),
-                default: undefined,
-                requiresArg: true,
                 type: "string",
+                short: "l",
             },
             help: {
-                default: false,
                 type: "boolean",
+                default: false,
             },
-        })
-        .help(false)
-        .parseSync();
+        },
+        allowPositionals: true,
+    });
 
     return {
         // Ajouter une barre oblique à la fin pour les répertoires.
-        _:
-            0 === args._.length
+        bases:
+            0 === positionals.length
                 ? ["./"]
                 : await Promise.all(
-                      args._.map(async (base) => {
-                          const stats = await fs.lstat(base.toString());
-                          return (
-                              base.toString() + (stats.isDirectory() ? "/" : "")
-                          );
+                      positionals.map(async (positional) => {
+                          const stats = await fs.lstat(positional);
+                          return positional + (stats.isDirectory() ? "/" : "");
                       }),
                   ),
-        config: args.config,
-        fix: normalizeFix(args.fix),
-        // 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
+        config: values.config,
+        fix: normalizeFix(values.fix),
         formatter:
-            undefined === args.formatter
+            undefined === values.formatter
                 ? undefined
-                : await normalizeFormatter(args.formatter),
-        level: normalizeLevel(args.level),
-        help: args.help,
+                : await normalizeFormatter(values.formatter),
+        level: normalizeLevel(values.level),
+        help: values.help,
     };
 };

package/src/bin/index.js

@@ -22,7 +22,7 @@ try {
         formatter: argv.formatter,
         level: argv.level,
     });
-    const results = await metalint.lintFiles(argv._);
+    const results = await metalint.lintFiles(argv.bases);
     const severity = await metalint.report(results);
 
     let code;

package/src/core/configuration/flatten.js

@@ -8,14 +8,14 @@ import Levels from "../levels.js";
 import { merge } from "../utils/object.js";
 
 /**
+ * @import { TypeofFormatter } from "../formatter/formatter.js"
+ * @import { Level } from "../levels.js"
+ * @import { TypeofWrapper } from "../wrapper/wrapper.js"
  * @import { NormalizedConfig } from "./normalize.js"
  * @import { NormalizedConfigChecker } from "./normalize.js"
  * @import { NormalizedConfigLinter } from "./normalize.js"
  * @import { NormalizedConfigOverride } from "./normalize.js"
  * @import { NormalizedConfigReporter } from "./normalize.js"
- * @import { Level } from "../levels.js"
- * @import { TypeofFormatter } from "../formatter/formatter.js"
- * @import { TypeofWrapper } from "../wrapper/wrapper.js"
  */
 
 /**
@@ -74,7 +74,7 @@ import { merge } from "../utils/object.js";
  *                                    parente.
  * @returns {string[]} La valeur fusionnée.
  */
-export const flattenPatterns = function (hierarchies, { patterns }) {
+export const flattenPatterns = (hierarchies, { patterns }) => {
     return [...patterns, ...hierarchies];
 };
 
@@ -88,7 +88,7 @@ export const flattenPatterns = function (hierarchies, { patterns }) {
  *                                        parente.
  * @returns {boolean} La valeur fusionnée.
  */
-export const flattenFix = function (hierarchy, { fix }) {
+export const flattenFix = (hierarchy, { fix }) => {
     return hierarchy ?? fix;
 };
 
@@ -102,7 +102,7 @@ export const flattenFix = function (hierarchy, { fix }) {
  *                                        parente.
  * @returns {Level} La valeur fusionnée.
  */
-export const flattenLevel = function (hierarchy, { level }) {
+export const flattenLevel = (hierarchy, { level }) => {
     return hierarchy ?? level;
 };
 
@@ -116,7 +116,7 @@ export const flattenLevel = function (hierarchy, { level }) {
  *                                                    `"options"` parente.
  * @returns {Record<string, unknown>} La valeur fusionnée.
  */
-export const flattenOptions = function (hierarchies, { options }) {
+export const flattenOptions = (hierarchies, { options }) => {
     return [options, ...hierarchies].reduce(merge);
 };
 
@@ -130,7 +130,7 @@ export const flattenOptions = function (hierarchies, { options }) {
  *                                                 `"level"` parente.
  * @returns {FlattenedConfigReporter} La valeur fusionnée.
  */
-export const flattenReporter = function (hierarchy, { level }) {
+export const flattenReporter = (hierarchy, { level }) => {
     return {
         formatter: hierarchy.formatter,
         level: flattenLevel(hierarchy.level, { level }),
@@ -155,7 +155,7 @@ export const flattenReporter = function (hierarchy, { level }) {
  *                                                         parente.
  * @returns {FlattenedConfigReporter[]} La valeur fusionnée.
  */
-export const flattenReporters = function (hierarchies, { formatter, level }) {
+export const flattenReporters = (hierarchies, { formatter, level }) => {
     if (undefined === formatter) {
         return hierarchies.map((r) => flattenReporter(r, { level }));
     }
@@ -183,7 +183,7 @@ export const flattenReporters = function (hierarchies, { formatter, level }) {
  *                                                  `"options"` parente.
  * @returns {FlattenedConfigLinter} La valeur fusionnée.
  */
-export const flattenLinter = function (hierarchy, { fix, level, options }) {
+export const flattenLinter = (hierarchy, { fix, level, options }) => {
     return {
         wrapper: hierarchy.wrapper,
         fix: flattenFix(hierarchy.fix, { fix }),
@@ -204,7 +204,7 @@ export const flattenLinter = function (hierarchy, { fix, level, options }) {
  *                                                 `"level"` parente.
  * @returns {FlattenedConfigLinter[]} La valeur fusionnée.
  */
-export const flattenLinters = function (hierarchies, { fix, level }) {
+export const flattenLinters = (hierarchies, { fix, level }) => {
     const map = new Map();
     for (const hierarchy of hierarchies) {
         if (map.has(hierarchy.wrapper)) {
@@ -243,7 +243,7 @@ export const flattenLinters = function (hierarchies, { fix, level }) {
  *                                                 `"level"` parente.
  * @returns {FlattenedConfigOverride} La valeur fusionnée.
  */
-export const flattenOverride = function (hierarchy, { fix, level }) {
+export const flattenOverride = (hierarchy, { fix, level }) => {
     return {
         patterns: hierarchy.patterns,
         linters: flattenLinters(hierarchy.linters, {
@@ -265,7 +265,7 @@ export const flattenOverride = function (hierarchy, { fix, level }) {
  *                                                `"level"` parente.
  * @returns {FlattenedConfigChecker} La valeur fusionnée.
  */
-export const flattenChecker = function (hierarchy, { fix, level }) {
+export const flattenChecker = (hierarchy, { fix, level }) => {
     const base = {
         fix: flattenFix(hierarchy.fix, { fix }),
         level: flattenLevel(hierarchy.level, { level }),
@@ -298,7 +298,7 @@ export const flattenChecker = function (hierarchy, { fix, level }) {
  *                                            commande.
  * @returns {FlattenedConfig} L'objet JSON fusionné.
  */
-export const flatten = function (hierarchy, argv) {
+export const flatten = (hierarchy, argv) => {
     const fix = flattenFix(argv.fix ?? hierarchy.fix, { fix: false });
     const level = flattenLevel(argv.level ?? hierarchy.level, {
         level: Levels.INFO,