markdownlint-cli2 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.21.0
+
+- Refactor options/configuration file loading
+- Update dependencies
+
 ## 0.20.0
 
 - Update dependencies

package/README.md

@@ -150,7 +150,7 @@ A container image [`davidanson/markdownlint-cli2`][docker-hub-markdownlint-cli2]
 can also be used (e.g., as part of a CI pipeline):
 
 ```bash
-docker run -v $PWD:/workdir davidanson/markdownlint-cli2:v0.20.0 "**/*.md" "#node_modules"
+docker run -v $PWD:/workdir davidanson/markdownlint-cli2:v0.21.0 "**/*.md" "#node_modules"
 ```
 
 Notes:
@@ -167,7 +167,7 @@ Notes:
   - A custom working directory can be specified with Docker's `-w` flag:
 
     ```bash
-    docker run -w /myfolder -v $PWD:/myfolder davidanson/markdownlint-cli2:v0.20.0 "**/*.md" "#node_modules"
+    docker run -w /myfolder -v $PWD:/myfolder davidanson/markdownlint-cli2:v0.21.0 "**/*.md" "#node_modules"
     ```
 
 For convenience, the container image
@@ -301,12 +301,13 @@ supported by the `--format` command-line parameter. When `--format` is set:
     - For example: `(^---\s*$[^]*?^---\s*$)(\r\n|\r|\n|$)`
   - `gitignore`: `Boolean` or `String` value to automatically ignore files
     referenced by `.gitignore` (or similar) when linting
-    - When the value `true` is specified, all `.gitignore` files in the tree are
-      imported (default `git` behavior)
+    - When the value `true` is specified, all `.gitignore` files in the tree
+      *and up to the repository root* are used (default `git` behavior)
     - When a `String` value is specified, that glob pattern is used to identify
-      the set of ignore files to import
-      - The value `**/.gitignore` corresponds to the `Boolean` value `true`
-      - The value `.gitignore` imports only the file in the root of the tree;
+      the set of ignore files to use
+      - The value `**/.gitignore` corresponds to the `Boolean` value `true` *but
+        does not use `.gitignore` files up to the repository root*
+      - The value `.gitignore` uses only the file in the root of the tree;
         this is usually equivalent and can be much faster for large trees
     - This top-level setting is valid **only** in the directory from which
       `markdownlint-cli2` is run
@@ -452,7 +453,7 @@ reference to the `repos` list in that project's `.pre-commit-config.yaml` like:
 
 ```yaml
 - repo: https://github.com/DavidAnson/markdownlint-cli2
-  rev: v0.20.0
+  rev: v0.21.0
   hooks:
   - id: markdownlint-cli2
 ```

package/markdownlint-cli2.mjs

@@ -21,7 +21,7 @@ import yamlParse from "./parsers/yaml-parse.mjs";
 
 // Variables
 const packageName = "markdownlint-cli2";
-const packageVersion = "0.20.0";
+const packageVersion = "0.21.0";
 const libraryName = "markdownlint";
 const libraryVersion = getVersion();
 const bannerMessage = `${packageName} v${packageVersion} (${libraryName} v${libraryVersion})`;
@@ -50,20 +50,6 @@ const resolveModulePaths = (/** @type {string} */ dir, /** @type {string[]} */ m
   modulePaths.map((path) => pathDefault.resolve(dir, expandTildePath(path, os)))
 );
 
-// Read a JSON(C) or YAML file and return the object
-const readConfigFile = (/** @type {FsLike} */ fs, /** @type {string} */ dir, /** @type {string} */ name, /** @type {() => void} */ otherwise) => () => {
-  const file = pathPosix.join(dir, name);
-  return fs.promises.access(file).
-    then(
-      () => readConfig(
-        file,
-        parsers,
-        fs
-      ),
-      otherwise
-    );
-};
-
 // Import a module ID with a custom directory in the path
 const importModule = async (/** @type {string[] | string} */ dirOrDirs, /** @type {string} */ id, /** @type {boolean} */ noImport) => {
   if (typeof id !== "string") {
@@ -118,18 +104,8 @@ const importModuleIdsAndParams = (/** @type {string[]} */ dirs, /** @type {strin
   ).then((results) => results.filter(Boolean))
 );
 
-// Import a JavaScript file and return the exported object
-const importConfig = (/** @type {FsLike} */ fs, /** @type {string} */ dir, /** @type {string} */ name, /** @type {boolean} */ noImport, /** @type {() => void} */ otherwise) => () => {
-  const file = pathPosix.join(dir, name);
-  return fs.promises.access(file).
-    then(
-      () => importModule(dir, name, noImport),
-      otherwise
-    );
-};
-
 // Extend a config object if it has 'extends' property
-const getExtendedConfig = (/** @type {import("markdownlint").Configuration} */ config, /** @type {string} */ configPath, /** @type {FsLike} */ fs) => {
+const getExtendedConfig = (/** @type {Configuration} */ config, /** @type {string} */ configPath, /** @type {FsLike} */ fs) => {
   if (config.extends) {
     return extendConfig(
       config,
@@ -275,6 +251,54 @@ $ markdownlint-cli2 "**/*.md" "#node_modules"`
   return 2;
 };
 
+// Helpers for getAndProcessDirInfo/handleFirstMatchingConfigurationFile
+const readFileParseJson = (/** @type {ConfigurationHandlerParams} */ { file, fs }) => fs.promises.readFile(file, utf8).then(jsoncParse);
+const readFileParseYaml = (/** @type {ConfigurationHandlerParams} */ { file, fs }) => fs.promises.readFile(file, utf8).then(yamlParse);
+const readConfigWrapper = (/** @type {ConfigurationHandlerParams} */ { file, fs }) => readConfig(file, parsers, fs);
+const importModuleWrapper = (/** @type {ConfigurationHandlerParams} */ { dir, file, noImport }) => importModule(dir, file, noImport);
+
+/** @type {ConfigurationFileAndHandler[] } */
+const optionsFiles = [
+  [ ".markdownlint-cli2.jsonc", readFileParseJson ],
+  [ ".markdownlint-cli2.yaml", readFileParseYaml ],
+  [ ".markdownlint-cli2.cjs", importModuleWrapper ],
+  [ ".markdownlint-cli2.mjs", importModuleWrapper ],
+  [ "package.json", (params) => readFileParseJson(params).then((/** @type {any} */ obj) => (obj || {})[packageName]) ]
+];
+
+/** @type {ConfigurationFileAndHandler[] } */
+const configurationFiles = [
+  [ ".markdownlint.jsonc", readConfigWrapper ],
+  [ ".markdownlint.json", readConfigWrapper ],
+  [ ".markdownlint.yaml", readConfigWrapper ],
+  [ ".markdownlint.yml", readConfigWrapper ],
+  [ ".markdownlint.cjs", importModuleWrapper ],
+  [ ".markdownlint.mjs", importModuleWrapper ]
+];
+
+/**
+ * Processes the first matching configuration file.
+ * @param {ConfigurationFileAndHandler[]} fileAndHandlers List of configuration files and handlers.
+ * @param {string} dir Configuration file directory.
+ * @param {FsLike} fs File system object.
+ * @param {boolean} noImport No import.
+ * @param {(file: string) => void} memoizeFile Function to memoize file name.
+ * @returns {Promise<any>} Configuration file content.
+ */
+const processFirstMatchingConfigurationFile = (fileAndHandlers, dir, fs, noImport, memoizeFile) =>
+  Promise.allSettled(
+    fileAndHandlers.map(([ name, handler ]) => {
+      const file = pathPosix.join(dir, name);
+      return fs.promises.access(file).then(() => [ file, handler ]);
+    })
+  ).
+    then((values) => {
+      /** @type {ConfigurationFileAndHandler} */
+      const [ file, handler ] = values.find((result) => (result.status === "fulfilled"))?.value || [ "[UNUSED]", noop ];
+      memoizeFile(file);
+      return handler({ dir, file, fs, noImport });
+    });
+
 // Get (creating if necessary) and process a directory's info object
 const getAndProcessDirInfo = (
   /** @type {FsLike} */ fs,
@@ -293,57 +317,30 @@ const getAndProcessDirInfo = (
       relativeDir,
       "parent": null,
       "files": [],
-      "markdownlintConfig": {},
-      "markdownlintOptions": {}
+      "markdownlintConfig": null,
+      "markdownlintOptions": null
     };
     dirToDirInfo[dir] = dirInfo;
 
-    // Load markdownlint-cli2 object(s)
-    const markdownlintCli2Jsonc = pathPosix.join(dir, ".markdownlint-cli2.jsonc");
-    const markdownlintCli2Yaml = pathPosix.join(dir, ".markdownlint-cli2.yaml");
-    const markdownlintCli2Cjs = pathPosix.join(dir, ".markdownlint-cli2.cjs");
-    const markdownlintCli2Mjs = pathPosix.join(dir, ".markdownlint-cli2.mjs");
-    const packageJson = pathPosix.join(dir, "package.json");
-    let file = "[UNKNOWN]";
-    // eslint-disable-next-line no-return-assign
-    const captureFile = (/** @type {string} */ f) => file = f;
+    let cli2File = "[UNKNOWN]";
     tasks.push(
-      fs.promises.access(captureFile(markdownlintCli2Jsonc)).
-        then(
-          () => fs.promises.readFile(file, utf8).then(jsoncParse),
-          () => fs.promises.access(captureFile(markdownlintCli2Yaml)).
-            then(
-              () => fs.promises.readFile(file, utf8).then(yamlParse),
-              () => fs.promises.access(captureFile(markdownlintCli2Cjs)).
-                then(
-                  () => importModule(dir, file, noImport),
-                  () => fs.promises.access(captureFile(markdownlintCli2Mjs)).
-                    then(
-                      () => importModule(dir, file, noImport),
-                      () => (allowPackageJson
-                        ? fs.promises.access(captureFile(packageJson))
-                        // eslint-disable-next-line prefer-promise-reject-errors
-                        : Promise.reject()
-                      ).
-                        then(
-                          () => fs.promises.
-                            readFile(file, utf8).
-                            then(jsoncParse).
-                            then((/** @type {any} */ obj) => obj[packageName]),
-                          noop
-                        )
-                    )
-                )
-            )
-        ).
-        then((/** @type {Options} */ options) => {
+
+      // Load markdownlint-cli2 object(s)
+      processFirstMatchingConfigurationFile(
+        allowPackageJson ? optionsFiles : optionsFiles.slice(0, -1),
+        dir,
+        fs,
+        noImport,
+        (file) => { cli2File = file; }
+      ).
+        then((/** @type {Options | null} */ options) => {
           dirInfo.markdownlintOptions = options;
           return options &&
             options.config &&
             getExtendedConfig(
               options.config,
-              // Just need to identify a file in the right directory
-              markdownlintCli2Jsonc,
+              // Just need to identify the right directory
+              pathPosix.join(dir, utf8),
               fs
             ).
               then((config) => {
@@ -351,48 +348,12 @@ const getAndProcessDirInfo = (
               });
         }).
         catch((/** @type {Error} */ error) => {
-          throwForConfigurationFile(file, error);
-        })
-    );
+          throwForConfigurationFile(cli2File, error);
+        }),
 
-    // Load markdownlint object(s)
-    const readConfigs =
-      readConfigFile(
-        fs,
-        dir,
-        ".markdownlint.jsonc",
-        readConfigFile(
-          fs,
-          dir,
-          ".markdownlint.json",
-          readConfigFile(
-            fs,
-            dir,
-            ".markdownlint.yaml",
-            readConfigFile(
-              fs,
-              dir,
-              ".markdownlint.yml",
-              importConfig(
-                fs,
-                dir,
-                ".markdownlint.cjs",
-                noImport,
-                importConfig(
-                  fs,
-                  dir,
-                  ".markdownlint.mjs",
-                  noImport,
-                  noop
-                )
-              )
-            )
-          )
-        )
-      );
-    tasks.push(
-      readConfigs().
-        then((/** @type {import("markdownlint").Configuration} */ config) => {
+      // Load markdownlint object(s)
+      processFirstMatchingConfigurationFile(configurationFiles, dir, fs, noImport, noop).
+        then((/** @type {Configuration | null} */ config) => {
           dirInfo.markdownlintConfig = config;
         })
     );
@@ -473,7 +434,7 @@ const enumerateFiles = async (
     "absolute": true,
     "cwd": baseDir,
     "dot": true,
-    "expandDirectories": false,
+    "expandNegationOnlyPatterns": false,
     gitignore,
     ignoreFiles,
     "suppressErrors": true,
@@ -501,29 +462,9 @@ const enumerateFiles = async (
     ((literalFiles.length > 0) && (globsForIgnore.length > 0))
       ? removeIgnoredFiles(baseDir, literalFiles, globsForIgnore)
       : literalFiles;
-  // Manually expand directories to avoid globby call to dir-glob.sync
-  const expandedDirectories = await Promise.all(
-    filteredGlobPatterns.map((globPattern) => {
-      const barePattern =
-        globPattern.startsWith("!")
-          ? globPattern.slice(1)
-          : globPattern;
-      const globPath = (
-        pathPosix.isAbsolute(barePattern) ||
-        pathDefault.isAbsolute(barePattern)
-      )
-        ? barePattern
-        : pathPosix.join(baseDir, barePattern);
-      return fs.promises.stat(globPath).
-        then((/** @type {import("node:fs").Stats} */ stats) => (stats.isDirectory()
-          ? pathPosix.join(globPattern, "**")
-          : globPattern)).
-        catch(() => globPattern);
-    })
-  );
   // Process glob patterns
   const files = [
-    ...await globby(expandedDirectories, globbyOptions),
+    ...await globby(filteredGlobPatterns, globbyOptions),
     ...filteredLiteralFiles
   ];
   for (const file of files) {
@@ -704,8 +645,7 @@ const createDirInfos = async (
 
   // Merge configuration by inheritance
   for (const dirInfo of dirInfos) {
-    let markdownlintOptions = dirInfo.markdownlintOptions || {};
-    let { markdownlintConfig } = dirInfo;
+    let { markdownlintConfig, markdownlintOptions } = dirInfo;
     /** @type {DirInfo | null} */
     let parent = dirInfo;
     // eslint-disable-next-line prefer-destructuring
@@ -719,7 +659,7 @@ const createDirInfos = async (
       if (
         !markdownlintConfig &&
         parent.markdownlintConfig &&
-        !markdownlintOptions.config
+        !markdownlintOptions?.config
       ) {
         // eslint-disable-next-line prefer-destructuring
         markdownlintConfig = parent.markdownlintConfig;
@@ -743,6 +683,7 @@ const lintFiles = (/** @type {FsLike} */ fs, /** @type {DirInfo[]} */ dirInfos,
     // Filter file/string inputs to only those in the dirInfo
     let filesAfterIgnores = files;
     if (
+      markdownlintOptions &&
       markdownlintOptions.ignores &&
       (markdownlintOptions.ignores.length > 0)
     ) {
@@ -766,7 +707,7 @@ const lintFiles = (/** @type {FsLike} */ fs, /** @type {DirInfo[]} */ dirInfos,
       // eslint-disable-next-line no-inline-comments
       const module = await import(/* webpackMode: "eager" */ "markdown-it");
       const markdownIt = module.default({ "html": true });
-      for (const plugin of (markdownlintOptions.markdownItPlugins || [])) {
+      for (const plugin of (markdownlintOptions?.markdownItPlugins || [])) {
         // @ts-ignore
         markdownIt.use(...plugin);
       }
@@ -777,16 +718,16 @@ const lintFiles = (/** @type {FsLike} */ fs, /** @type {DirInfo[]} */ dirInfos,
     const options = {
       "files": filteredFiles,
       "strings": filteredStrings,
-      "config": markdownlintConfig || markdownlintOptions.config,
+      "config": markdownlintConfig || markdownlintOptions?.config,
       "configParsers": parsers,
       // @ts-ignore
       "customRules": markdownlintOptions.customRules,
-      "frontMatter": markdownlintOptions.frontMatter
-        ? new RegExp(markdownlintOptions.frontMatter, "u")
+      "frontMatter": markdownlintOptions?.frontMatter
+        ? new RegExp(markdownlintOptions?.frontMatter, "u")
         : undefined,
       "handleRuleFailures": true,
       markdownItFactory,
-      "noInlineConfig": Boolean(markdownlintOptions.noInlineConfig),
+      "noInlineConfig": Boolean(markdownlintOptions?.noInlineConfig),
       fs
     };
     // Invoke markdownlint
@@ -799,7 +740,7 @@ const lintFiles = (/** @type {FsLike} */ fs, /** @type {DirInfo[]} */ dirInfos,
         formattingContext.formatted = applyFixes(original, errorInfos);
         return {};
       });
-    } else if (markdownlintOptions.fix) {
+    } else if (markdownlintOptions?.fix) {
       // For any fixable errors, read file, apply fixes, write it back, and re-lint
       task = task.then((results) => {
         options.files = [];
@@ -836,7 +777,7 @@ const lintFiles = (/** @type {FsLike} */ fs, /** @type {DirInfo[]} */ dirInfos,
 };
 
 // Create list of results
-const createResults = (/** @type {string} */ baseDir, /** @type {import("markdownlint").LintResults[]} */ taskResults) => {
+const createResults = (/** @type {string} */ baseDir, /** @type {LintResults[]} */ taskResults) => {
   /** @type {LintResult[]} */
   const results = [];
   /** @type {Map<LintResult, number>} */
@@ -1026,13 +967,10 @@ export const main = async (/** @type {Parameters} */ params) => {
     logMessage(`Finding: ${globPatterns.join(" ")}`);
   }
   // Create linting tasks
-  const gitignore =
-    // https://github.com/sindresorhus/globby/issues/265
-    (!params.fs && (baseMarkdownlintOptions.gitignore === true));
-  const ignoreFiles =
-    (!params.fs && (typeof baseMarkdownlintOptions.gitignore === "string"))
-      ? baseMarkdownlintOptions.gitignore
-      : undefined;
+  const gitignore = (baseMarkdownlintOptions.gitignore === true);
+  const ignoreFiles = (typeof baseMarkdownlintOptions.gitignore === "string")
+    ? baseMarkdownlintOptions.gitignore
+    : undefined;
   const dirInfos =
     await createDirInfos(
       fs,
@@ -1122,14 +1060,26 @@ export const main = async (/** @type {Parameters} */ params) => {
  * @property {Options} [optionsOverride] Options override.
  */
 
+/** @typedef {import("markdownlint").Configuration} Configuration */
+
+/**
+ * @typedef ConfigurationHandlerParams
+ * @property {string} dir Configuration file directory.
+ * @property {string} file Configuration file.
+ * @property {FsLike} fs File system object.
+ * @property {boolean} noImport No import.
+ */
+
+/** @typedef {[ string, (params: ConfigurationHandlerParams) => Promise<any> ] } ConfigurationFileAndHandler */
+
 /**
  * @typedef DirInfo
  * @property {string} dir Directory.
  * @property {string | null} relativeDir Relative directory.
  * @property {DirInfo | null} parent Parent.
  * @property {string[]} files Files.
- * @property {import("markdownlint").Configuration} markdownlintConfig Configuration.
- * @property {Options} markdownlintOptions Options.
+ * @property {Configuration | null} markdownlintConfig Configuration.
+ * @property {Options | null} markdownlintOptions Options.
  */
 
 /** @typedef {Record<string, DirInfo>} DirToDirInfo */
@@ -1138,10 +1088,12 @@ export const main = async (/** @type {Parameters} */ params) => {
 
 /** @typedef {[string]} OutputFormatterConfiguration */
 
+/** @typedef {import("markdownlint").Rule} Rule */
+
 /**
  * @typedef Options
- * @property {import("markdownlint").Configuration} [config] Config.
- * @property {import("markdownlint").Rule[] | string[]} [customRules] Custom rules.
+ * @property {Configuration} [config] Config.
+ * @property {Rule[] | string[]} [customRules] Custom rules.
  * @property {boolean} [fix] Fix.
  * @property {string} [frontMatter] Front matter.
  * @property {boolean | string} [gitignore] Git ignore.
@@ -1163,6 +1115,8 @@ export const main = async (/** @type {Parameters} */ params) => {
 
 /** @typedef {import("markdownlint").LintError & LintContext} LintResult */
 
+/** @typedef {import("markdownlint").LintResults} LintResults */
+
 /**
  * @typedef FormattingContext
  * @property {boolean} [formatting] True iff formatting.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdownlint-cli2",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "A fast, flexible, configuration-based command-line interface for linting Markdown/CommonMark files with the `markdownlint` library",
   "author": {
     "name": "David Anson",
@@ -35,11 +35,11 @@
     "lint-dockerfile": "docker run --rm -i hadolint/hadolint:latest-alpine < docker/Dockerfile",
     "lint-watch": "git ls-files | entr npm run lint",
     "playwright-install-bare": "npm run playwright-install-npm && playwright install",
-    "playwright-install-npm": "npm install --no-save playwright@1.57.0",
+    "playwright-install-npm": "npm install --no-save playwright@1.58.2",
     "playwright-test": "playwright test --config ./webworker/playwright.config.mjs",
-    "playwright-test-docker": "docker run --rm --volume $PWD:/home/workdir --workdir /home/workdir --ipc=host mcr.microsoft.com/playwright:v1.57.0 npm run playwright-test",
+    "playwright-test-docker": "docker run --rm --volume $PWD:/home/workdir --workdir /home/workdir --ipc=host mcr.microsoft.com/playwright:v1.58.2 npm run playwright-test",
     "schema": "cpy ./node_modules/markdownlint/schema/markdownlint-config-schema.json ./schema --flat",
-    "test": "ava --timeout=1m test/append-to-array-test.mjs test/fs-mock-test.mjs test/fs-virtual-test.mjs test/markdownlint-cli2-test.mjs test/markdownlint-cli2-test-exec.mjs test/markdownlint-cli2-test-exports.mjs test/markdownlint-cli2-test-formatters.mjs test/markdownlint-cli2-test-fs.mjs test/markdownlint-cli2-test-main.mjs test/merge-options-test.mjs",
+    "test": "ava --timeout=1m test/append-to-array-test.mjs test/fs-virtual-test.mjs test/markdownlint-cli2-test.mjs test/markdownlint-cli2-test-exec.mjs test/markdownlint-cli2-test-exports.mjs test/markdownlint-cli2-test-formatters.mjs test/markdownlint-cli2-test-fs.mjs test/markdownlint-cli2-test-main.mjs test/merge-options-test.mjs",
     "test-cover": "c8 --100 npm test",
     "test-docker-hub-image": "VERSION=$(node -e \"process.stdout.write(require('./package.json').version)\") && docker image rm davidanson/markdownlint-cli2:v$VERSION davidanson/markdownlint-cli2:latest || true && docker run --rm -v $PWD:/workdir davidanson/markdownlint-cli2:v$VERSION \"*.md\" && docker run --rm -v $PWD:/workdir davidanson/markdownlint-cli2:latest \"*.md\"",
     "test-docker-hub-image-rules": "VERSION=$(node -e \"process.stdout.write(require('./package.json').version)\") && docker image rm davidanson/markdownlint-cli2-rules:v$VERSION davidanson/markdownlint-cli2-rules:latest || true && docker run --rm -v $PWD:/workdir davidanson/markdownlint-cli2-rules:v$VERSION \"*.md\" && docker run --rm -v $PWD:/workdir davidanson/markdownlint-cli2-rules:latest \"*.md\"",
@@ -73,28 +73,28 @@
     "schema/ValidatingConfiguration.md"
   ],
   "dependencies": {
-    "globby": "15.0.0",
+    "globby": "16.1.0",
     "js-yaml": "4.1.1",
     "jsonc-parser": "3.3.1",
     "markdownlint": "0.40.0",
     "markdownlint-cli2-formatter-default": "0.0.6",
-    "markdown-it": "14.1.0",
+    "markdown-it": "14.1.1",
     "micromatch": "4.0.8"
   },
   "devDependencies": {
-    "@eslint/js": "9.39.1",
-    "@playwright/test": "1.57.0",
-    "@stylistic/eslint-plugin": "5.6.1",
+    "@eslint/js": "9.39.2",
+    "@playwright/test": "1.58.2",
+    "@stylistic/eslint-plugin": "5.8.0",
     "ajv": "8.17.1",
     "ava": "6.4.1",
     "c8": "10.1.3",
     "chalk": "5.6.2",
-    "cpy": "12.1.0",
-    "cpy-cli": "6.0.0",
-    "eslint": "9.39.1",
-    "eslint-plugin-jsdoc": "61.4.1",
-    "eslint-plugin-n": "17.23.1",
-    "eslint-plugin-unicorn": "62.0.0",
+    "cpy": "13.2.1",
+    "cpy-cli": "7.0.0",
+    "eslint": "9.39.2",
+    "eslint-plugin-jsdoc": "62.5.4",
+    "eslint-plugin-n": "17.23.2",
+    "eslint-plugin-unicorn": "63.0.0",
     "execa": "9.6.1",
     "markdown-it-emoji": "3.0.0",
     "markdown-it-for-inline": "2.0.1",

package/schema/markdownlint-cli2-config-schema.json

@@ -1,13 +1,13 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.20.0/schema/markdownlint-cli2-config-schema.json",
+  "$id": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.21.0/schema/markdownlint-cli2-config-schema.json",
   "title": "markdownlint-cli2 configuration schema",
   "type": "object",
   "properties": {
     "$schema": {
       "description": "JSON Schema URI (expected by some editors)",
       "type": "string",
-      "default": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.20.0/schema/markdownlint-cli2-config-schema.json"
+      "default": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.21.0/schema/markdownlint-cli2-config-schema.json"
     },
     "config": {
       "description": "markdownlint configuration schema : https://github.com/DavidAnson/markdownlint/blob/v0.40.0/schema/.markdownlint.jsonc",
@@ -15,7 +15,7 @@
       "default": {}
     },
     "customRules": {
-      "description": "Module names or paths of custom rules to load and use when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Module names or paths of custom rules to load and use when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "array",
       "default": [],
       "items": {
@@ -25,18 +25,18 @@
       }
     },
     "fix": {
-      "description": "Whether to enable fixing of linting errors reported by rules that emit fix information : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Whether to enable fixing of linting errors reported by rules that emit fix information : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "boolean",
       "default": false
     },
     "frontMatter": {
-      "description": "Regular expression used to match and ignore any front matter at the beginning of a document : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Regular expression used to match and ignore any front matter at the beginning of a document : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "string",
       "minLength": 1,
       "default": ""
     },
     "gitignore": {
-      "description": "Whether to ignore files referenced by .gitignore (or glob expression) (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Whether to ignore files referenced by .gitignore (or glob expression) (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": [
         "boolean",
         "string"
@@ -44,7 +44,7 @@
       "default": false
     },
     "globs": {
-      "description": "Glob expressions to include when linting (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Glob expressions to include when linting (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "array",
       "default": [],
       "items": {
@@ -54,7 +54,7 @@
       }
     },
     "ignores": {
-      "description": "Glob expressions to ignore when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Glob expressions to ignore when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "array",
       "default": [],
       "items": {
@@ -64,7 +64,7 @@
       }
     },
     "markdownItPlugins": {
-      "description": "markdown-it plugins to load and use when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "markdown-it plugins to load and use when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "array",
       "default": [],
       "items": {
@@ -84,7 +84,7 @@
       }
     },
     "modulePaths": {
-      "description": "Additional paths to resolve module locations from : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Additional paths to resolve module locations from : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "array",
       "default": [],
       "items": {
@@ -94,22 +94,22 @@
       }
     },
     "noBanner": {
-      "description": "Whether to disable the display of the banner message and version numbers on stdout (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Whether to disable the display of the banner message and version numbers on stdout (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "boolean",
       "default": false
     },
     "noInlineConfig": {
-      "description": "Whether to disable support of HTML comments within Markdown content : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Whether to disable support of HTML comments within Markdown content : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "boolean",
       "default": false
     },
     "noProgress": {
-      "description": "Whether to disable the display of progress on stdout (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Whether to disable the display of progress on stdout (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "boolean",
       "default": false
     },
     "outputFormatters": {
-      "description": "Output formatters to load and use to customize markdownlint-cli2 output (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Output formatters to load and use to customize markdownlint-cli2 output (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "array",
       "default": [],
       "items": {
@@ -129,7 +129,7 @@
       }
     },
     "showFound": {
-      "description": "Whether to show the list of found files on stdout (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.20.0/README.md#markdownlint-cli2jsonc",
+      "description": "Whether to show the list of found files on stdout (only valid at the root) : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.21.0/README.md#markdownlint-cli2jsonc",
       "type": "boolean",
       "default": false
     }