markdownlint-cli2 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.22.0
+
+- Make `--config` parameter more flexible
+- Support TOML with `--config` parameter
+- Add `--configPointer` parameter
+- Update dependencies
+
 ## 0.21.0
 
 - Refactor options/configuration file loading

package/README.md

@@ -67,7 +67,7 @@ As a [GitHub Action][github-action] via
 markdownlint-cli2 vX.Y.Z (markdownlint vX.Y.Z)
 https://github.com/DavidAnson/markdownlint-cli2
 
-Syntax: markdownlint-cli2 glob0 [glob1] [...] [globN] [--config file] [--fix] [--format] [--help] [--no-globs]
+Syntax: markdownlint-cli2 glob0 [glob1] [...] [globN] [--config file] [--configPointer pointer] [--fix] [--format] [--help] [--no-globs]
 
 Glob expressions (from the globby library):
 - * matches any number of characters, but not /
@@ -84,11 +84,12 @@ Dot-only glob:
 - To lint every file in the current directory tree, the command "markdownlint-cli2 **" can be used instead
 
 Optional parameters:
-- --config    specifies the path to a configuration file to define the base configuration
-- --fix       updates files to resolve fixable issues (can be overridden in configuration)
-- --format    reads standard input (stdin), applies fixes, writes standard output (stdout)
-- --help      writes this message to the console and exits without doing anything else
-- --no-globs  ignores the "globs" property if present in the top-level options object
+- --config        specifies the path to a configuration file to define the base configuration
+- --configPointer specifies a JSON Pointer to a configuration object within the --config file
+- --fix           updates files to resolve fixable issues (can be overridden in configuration)
+- --format        reads standard input (stdin), applies fixes, writes standard output (stdout)
+- --help          writes this message to the console and exits without doing anything else
+- --no-globs      ignores the "globs" property if present in the top-level options object
 
 Configuration via:
 - .markdownlint-cli2.jsonc
@@ -97,7 +98,6 @@ Configuration via:
 - .markdownlint.jsonc or .markdownlint.json
 - .markdownlint.yaml or .markdownlint.yml
 - .markdownlint.cjs or .markdownlint.mjs
-- package.json
 
 Cross-platform compatibility:
 - UNIX and Windows shells expand globs according to different rules; quoting arguments is recommended
@@ -133,24 +133,74 @@ markdownlint-cli2 --fix "**/*.md" "#node_modules"
 
 In cases where it is not convenient to store a configuration file in the root
 of a project, the `--config` argument can be used to provide a path to any
-supported configuration file (except `package.json`):
+supported configuration file/format:
 
 ```bash
 markdownlint-cli2 --config "config/.markdownlint-cli2.jsonc" "**/*.md" "#node_modules"
 ```
 
-The configuration file name must be (or end with) one of the supported names
+The configuration file name should be (or end with) one of the supported names
 above. For example, `.markdownlint.json` or `example.markdownlint-cli2.jsonc`.
-The specified configuration file will be loaded, parsed, and applied as a base
+Alternatively, the configuration file name should have a supported extension
+like `.jsonc`, `.yaml`, `.mjs`, or `.toml` and its kind (see below) will be
+inferred. The configuration file will be loaded, parsed, and applied as a base
 configuration for the current directory - which will then be handled normally.
 
+The `--configPointer` argument allows the use of [JSON Pointer][json-pointer]
+syntax to identify a sub-object within the configuration file specified by
+`--config` (see above). This argument can be used with any configuration file
+type and makes it possible to nest configuration data within another file like
+`package.json` or `pyproject.toml` (e.g., via `/key` or `/key/subkey`).
+
+For example, a `package.json` file like this:
+
+```json
+{
+  "...": "...",
+  "markdownlint-cli2": {
+    "config": {
+      "no-multiple-blanks": false
+    },
+    "noProgress": true
+  }
+}
+```
+
+Could be used like this:
+
+```bash
+markdownlint-cli2 --config package.json --configPointer /markdownlint-cli2 "*.md"
+```
+
+And a `pyproject.toml` file like this:
+
+```toml
+[project]
+# ...
+
+[tool.markdownlint-cli2]
+noProgress = true
+
+[tool.markdownlint-cli2.config]
+no-multiple-blanks = false
+```
+
+Could be used like this:
+
+```bash
+markdownlint-cli2 --config pyproject.toml --configPointer /tool/markdownlint-cli2 "*.md"
+```
+
+**Note**: The [TOML][toml] format is supported by `--config`, `--configPointer`,
+and the `extends` configuration property, but *not* for per-directory overrides.
+
 ### Container Image
 
 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.21.0 "**/*.md" "#node_modules"
+docker run -v $PWD:/workdir davidanson/markdownlint-cli2:v0.22.0 "**/*.md" "#node_modules"
 ```
 
 Notes:
@@ -167,7 +217,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.21.0 "**/*.md" "#node_modules"
+    docker run -w /myfolder -v $PWD:/myfolder davidanson/markdownlint-cli2:v0.22.0 "**/*.md" "#node_modules"
     ```
 
 For convenience, the container image
@@ -256,7 +306,6 @@ supported by the `--format` command-line parameter. When `--format` is set:
       2. `.markdownlint-cli2.yaml`
       3. `.markdownlint-cli2.cjs`
       4. `.markdownlint-cli2.mjs`
-      5. `package.json` (only supported in the current directory)
   - Configuration files like `.markdownlint.*` allow control over only the
     `markdownlint` `config` object and tend to be supported more broadly (such
     as by `markdownlint-cli`).
@@ -268,6 +317,8 @@ supported by the `--format` command-line parameter. When `--format` is set:
       4. `.markdownlint.yml`
       5. `.markdownlint.cjs`
       6. `.markdownlint.mjs`
+  - Both configuration file types can appear in any directory and will override
+    configuration defined in the project root or any directories in between.
 - The VS Code extension includes a [JSON Schema][json-schema] definition for the
   `JSON(C)` configuration files described below. This adds auto-complete and can
   make it easier to define proper structure.
@@ -282,10 +333,10 @@ supported by the `--format` command-line parameter. When `--format` is set:
 - Valid properties are:
   - `config`: [`markdownlint` `config` object][markdownlint-config] to configure
     rules for this part of the directory tree
-    - If a `.markdownlint.{jsonc,json,yaml,yml,js}` file (see below) is present
-      in the same directory, it overrides the value of this property
+    - If a `.markdownlint.{jsonc,json,yaml,yml,cjs,mjs}` file (see below) is
+      present in the same directory, it overrides the value of this property
     - If the `config` object contains an `extends` property, it will be resolved
-      the same as `.markdownlint.{jsonc,json,yaml,yml,js}` (see below)
+      the same as `.markdownlint.{jsonc,json,yaml,yml,cjs,mjs}` (see below)
   - `customRules`: `Array` of `String`s (or `Array`s of `String`s) of module
     names/paths of [custom rules][markdownlint-custom-rules] to load and use
     when linting
@@ -397,15 +448,6 @@ supported by the `--format` command-line parameter. When `--format` is set:
 - For example: [`.markdownlint-cli2.cjs`][markdownlint-cli2-cjs] or
   [`.markdownlint-cli2.mjs`][markdownlint-cli2-mjs]
 
-### `package.json`
-
-- The format of this file is a standard [npm `package.json`][package-json] file
-  including a `markdownlint-cli2` property at the root and a value corresponding
-  to the object described above for `.markdownlint-cli2.jsonc`.
-- `package.json` is only supported in the current directory.
-- `package.json` is not supported by the `--config` argument.
-- For example: [`package-json-sample`][package-json-sample]
-
 ### `.markdownlint.jsonc` or `.markdownlint.json`
 
 - The format of this file is a [JSONC][jsonc] or [JSON][json] object matching
@@ -453,7 +495,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.21.0
+  rev: v0.22.0
   hooks:
   - id: markdownlint-cli2
 ```
@@ -461,6 +503,11 @@ reference to the `repos` list in that project's `.pre-commit-config.yaml` like:
 > Depending on the environment that workflow runs in, it may be necessary to
 > [override the version of Node.js used by pre-commit][pre-commit-version].
 
+Setting the `id` above to `markdownlint-cli2-docker` uses the Docker container
+image instead. That image bundles Node.js and all dependencies and provides the
+most consistent experience because it is not affected by new releases of any
+dependencies.
+
 ## History
 
 See [CHANGELOG.md][changelog].
@@ -468,7 +515,7 @@ See [CHANGELOG.md][changelog].
 [changelog]: CHANGELOG.md
 [command-line]: #command-line
 [commonmark]: https://commonmark.org/
-[commonjs-module]: https://nodejs.org/api/modules.html#modules_modules_commonjs_modules
+[commonjs-module]: https://nodejs.org/api/modules.html#modules-commonjs-modules
 [ecmascript-module]: https://nodejs.org/api/esm.html#modules-ecmascript-modules
 [docker]: https://www.docker.com
 [docker-bind-mounts]: https://docs.docker.com/storage/bind-mounts/
@@ -480,6 +527,7 @@ See [CHANGELOG.md][changelog].
 [homebrew]: https://brew.sh
 [html-comment]: https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started
 [json]: https://wikipedia.org/wiki/JSON
+[json-pointer]: https://datatracker.ietf.org/doc/html/rfc6901
 [json-schema]: https://json-schema.org
 [jsonc]: https://code.visualstudio.com/Docs/languages/json#_json-with-comments
 [license-image]: https://img.shields.io/npm/l/markdownlint-cli2.svg
@@ -515,16 +563,15 @@ See [CHANGELOG.md][changelog].
 [nodejs-docker-non-root]: https://github.com/nodejs/docker-node/blob/main/docs/BestPractices.md#non-root-user
 [nodejs-import-expression]: https://nodejs.org/api/esm.html#import-expressions
 [nodejs-import-meta-resolve]: https://nodejs.org/api/esm.html#importmetaresolvespecifier
-[nodejs-require]: https://nodejs.org/api/modules.html#modules_require_id
+[nodejs-require]: https://nodejs.org/api/modules.html#requireid
 [npm-image]: https://img.shields.io/npm/v/markdownlint-cli2.svg
 [npm-url]: https://www.npmjs.com/package/markdownlint-cli2
 [output-formatters]: doc/OutputFormatters.md
-[package-json]: https://docs.npmjs.com/cli/v9/configuring-npm/package-json
-[package-json-sample]: test/package-json/package.json
 [pre-commit]: https://pre-commit.com/
 [pre-commit-version]: https://pre-commit.com/#overriding-language-version
 [regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp
 [regexp-constructor]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/RegExp
+[toml]: https://wikipedia.org/wiki/TOML
 [validating-configuration]: schema/ValidatingConfiguration.md
 [vscode]: https://code.visualstudio.com/
 [vscode-markdownlint]: https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint

package/constants.mjs

@@ -0,0 +1,30 @@
+// @ts-check
+
+const packageName = "markdownlint-cli2";
+const packageVersion = "0.22.0";
+
+const libraryName = "markdownlint";
+
+const cli2SchemaKeys = new Set([
+  "config",
+  "customRules",
+  "fix",
+  "frontMatter",
+  "gitignore",
+  "globs",
+  "ignores",
+  "markdownItPlugins",
+  "modulePaths",
+  "noBanner",
+  "noInlineConfig",
+  "noProgress",
+  "outputFormatters",
+  "showFound"
+]);
+
+export {
+  cli2SchemaKeys,
+  libraryName,
+  packageName,
+  packageVersion
+};

package/markdownlint-cli2.mjs

@@ -7,22 +7,22 @@ import pathDefault from "node:path";
 const pathPosix = pathDefault.posix;
 import { pathToFileURL } from "node:url";
 import { globby } from "globby";
+import jsonpointer from "jsonpointer";
 import micromatch from "micromatch";
 import { applyFixes, getVersion, resolveModule } from "markdownlint";
 import { lint, extendConfig, readConfig } from "markdownlint/promise";
 import { expandTildePath } from "markdownlint/helpers";
 import appendToArray from "./append-to-array.mjs";
+import { cli2SchemaKeys, libraryName, packageName, packageVersion } from "./constants.mjs";
 import mergeOptions from "./merge-options.mjs";
-import parsers from "./parsers/parsers.mjs";
+import allParsers from "./parsers/parsers.mjs";
 import jsoncParse from "./parsers/jsonc-parse.mjs";
+import tomlParse from "./parsers/toml-parse.mjs";
 import yamlParse from "./parsers/yaml-parse.mjs";
 
 /* eslint-disable jsdoc/reject-any-type */
 
 // Variables
-const packageName = "markdownlint-cli2";
-const packageVersion = "0.21.0";
-const libraryName = "markdownlint";
 const libraryVersion = getVersion();
 const bannerMessage = `${packageName} v${packageVersion} (${libraryName} v${libraryVersion})`;
 const dotOnlySubstitute = "*.{md,markdown}";
@@ -34,6 +34,15 @@ const noop = () => null;
 // Negates a glob
 const negateGlob = (/** @type {string} */ glob) => `!${glob}`;
 
+// Reads and parses a JSONC file
+const readJsonc = (/** @type {string} */ file, /** @type {FsLike} */ fs) => fs.promises.readFile(file, utf8).then(jsoncParse);
+
+// Reads and parses a TOML file
+const readToml = (/** @type {string} */ file, /** @type {FsLike} */ fs) => fs.promises.readFile(file, utf8).then(tomlParse);
+
+// Reads and parses a YAML file
+const readYaml = (/** @type {string} */ file, /** @type {FsLike} */ fs) => fs.promises.readFile(file, utf8).then(yamlParse);
+
 // Throws a meaningful exception for an unusable configuration file
 const throwForConfigurationFile = (/** @type {string} */ file, /** @type {Error | any} */ error) => {
   throw new Error(
@@ -105,8 +114,9 @@ const importModuleIdsAndParams = (/** @type {string[]} */ dirs, /** @type {strin
 );
 
 // Extend a config object if it has 'extends' property
-const getExtendedConfig = (/** @type {Configuration} */ config, /** @type {string} */ configPath, /** @type {FsLike} */ fs) => {
+const getExtendedConfig = (/** @type {ExecutionContext} */ context, /** @type {Configuration} */ config, /** @type {string} */ configPath) => {
   if (config.extends) {
+    const { fs, parsers } = context;
     return extendConfig(
       config,
       configPath,
@@ -119,50 +129,64 @@ const getExtendedConfig = (/** @type {Configuration} */ config, /** @type {strin
 };
 
 // Read an options or config file in any format and return the object
-const readOptionsOrConfig = async (/** @type {string} */ configPath, /** @type {FsLike} */ fs, /** @type {boolean} */ noImport) => {
+const readOptionsOrConfig = async (/** @type {ExecutionContext} */ context, /** @type {string} */ configPath, /** @type {string | undefined} */ configPointer) => {
+  const { fs, noImport } = context;
   const basename = pathPosix.basename(configPath);
   const dirname = pathPosix.dirname(configPath);
   let options = null;
   let config = null;
+  let unknown = null;
   try {
     if (basename.endsWith(".markdownlint-cli2.jsonc")) {
-      options = jsoncParse(await fs.promises.readFile(configPath, utf8));
+      options = await readJsonc(configPath, fs);
     } else if (basename.endsWith(".markdownlint-cli2.yaml")) {
-      options = yamlParse(await fs.promises.readFile(configPath, utf8));
-    } else if (
-      basename.endsWith(".markdownlint-cli2.cjs") ||
-      basename.endsWith(".markdownlint-cli2.mjs")
-    ) {
+      options = await readYaml(configPath, fs);
+    } else if (basename.endsWith(".markdownlint-cli2.cjs") || basename.endsWith(".markdownlint-cli2.mjs")) {
       options = await importModule(dirname, basename, noImport);
-    } else if (
-      basename.endsWith(".markdownlint.jsonc") ||
-      basename.endsWith(".markdownlint.json") ||
-      basename.endsWith(".markdownlint.yaml") ||
-      basename.endsWith(".markdownlint.yml")
-    ) {
-      config = await readConfig(configPath, parsers, fs);
-    } else if (
-      basename.endsWith(".markdownlint.cjs") ||
-      basename.endsWith(".markdownlint.mjs")
-    ) {
+    } else if (basename.endsWith(".markdownlint.jsonc") || basename.endsWith(".markdownlint.json")) {
+      config = await readJsonc(configPath, fs);
+    } else if (basename.endsWith(".markdownlint.yaml") || basename.endsWith(".markdownlint.yml")) {
+      config = await readYaml(configPath, fs);
+    } else if (basename.endsWith(".markdownlint.cjs") || basename.endsWith(".markdownlint.mjs")) {
       config = await importModule(dirname, basename, noImport);
+    } else if (basename.endsWith(".jsonc") || basename.endsWith(".json")) {
+      unknown = await readJsonc(configPath, fs);
+    } else if (basename.endsWith(".toml")) {
+      unknown = await readToml(configPath, fs);
+    } else if (basename.endsWith(".yaml") || basename.endsWith(".yml")) {
+      unknown = await readYaml(configPath, fs);
+    } else if (basename.endsWith(".cjs") || basename.endsWith(".mjs")) {
+      unknown = await importModule(dirname, basename, noImport);
     } else {
       throw new Error(
         "Configuration file should be one of the supported names " +
         "(e.g., '.markdownlint-cli2.jsonc') or a prefix with a supported name " +
-        "(e.g., 'example.markdownlint-cli2.jsonc')."
+        "(e.g., 'example.markdownlint-cli2.jsonc') or have a supported extension " +
+        "(e.g., jsonc, json, yaml, yml, cjs, mjs)."
       );
     }
   } catch (error) {
     throwForConfigurationFile(configPath, error);
   }
+  if (configPointer) {
+    const objects = [ options, config, unknown ];
+    [ options, config, unknown ] = objects.map((obj) => obj && (jsonpointer.get(obj, configPointer) || {}));
+  }
+  if (unknown) {
+    const keys = Object.keys(unknown);
+    if (keys.some((key) => cli2SchemaKeys.has(key))) {
+      options = unknown;
+    } else {
+      config = unknown;
+    }
+  }
   if (options) {
     if (options.config) {
-      options.config = await getExtendedConfig(options.config, configPath, fs);
+      options.config = await getExtendedConfig(context, options.config, configPath);
     }
     return options;
   }
-  config = await getExtendedConfig(config, configPath, fs);
+  config = await getExtendedConfig(context, config, configPath);
   return { config };
 };
 
@@ -205,7 +229,7 @@ const showHelp = (/** @type {Logger} */ logMessage, /** @type {boolean} */ showB
   }
   logMessage(`https://github.com/DavidAnson/markdownlint-cli2
 
-Syntax: markdownlint-cli2 glob0 [glob1] [...] [globN] [--config file] [--fix] [--format] [--help] [--no-globs]
+Syntax: markdownlint-cli2 glob0 [glob1] [...] [globN] [--config file] [--configPointer pointer] [--fix] [--format] [--help] [--no-globs]
 
 Glob expressions (from the globby library):
 - * matches any number of characters, but not /
@@ -222,11 +246,12 @@ Dot-only glob:
 - To lint every file in the current directory tree, the command "markdownlint-cli2 **" can be used instead
 
 Optional parameters:
-- --config    specifies the path to a configuration file to define the base configuration
-- --fix       updates files to resolve fixable issues (can be overridden in configuration)
-- --format    reads standard input (stdin), applies fixes, writes standard output (stdout)
-- --help      writes this message to the console and exits without doing anything else
-- --no-globs  ignores the "globs" property if present in the top-level options object
+- --config        specifies the path to a configuration file to define the base configuration
+- --configPointer specifies a JSON Pointer to a configuration object within the --config file
+- --fix           updates files to resolve fixable issues (can be overridden in configuration)
+- --format        reads standard input (stdin), applies fixes, writes standard output (stdout)
+- --help          writes this message to the console and exits without doing anything else
+- --no-globs      ignores the "globs" property if present in the top-level options object
 
 Configuration via:
 - .markdownlint-cli2.jsonc
@@ -235,7 +260,6 @@ Configuration via:
 - .markdownlint.jsonc or .markdownlint.json
 - .markdownlint.yaml or .markdownlint.yml
 - .markdownlint.cjs or .markdownlint.mjs
-- package.json
 
 Cross-platform compatibility:
 - UNIX and Windows shells expand globs according to different rules; quoting arguments is recommended
@@ -252,18 +276,17 @@ $ markdownlint-cli2 "**/*.md" "#node_modules"`
 };
 
 // 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 readJsoncWrapper = (/** @type {ConfigurationHandlerParams} */ { file, fs }) => readJsonc(file, fs);
+const readYamlWrapper = (/** @type {ConfigurationHandlerParams} */ { file, fs }) => readYaml(file, fs);
+const readConfigWrapper = (/** @type {ConfigurationHandlerParams} */ { file, fs, parsers }) => 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.jsonc", readJsoncWrapper ],
+  [ ".markdownlint-cli2.yaml", readYamlWrapper ],
   [ ".markdownlint-cli2.cjs", importModuleWrapper ],
-  [ ".markdownlint-cli2.mjs", importModuleWrapper ],
-  [ "package.json", (params) => readFileParseJson(params).then((/** @type {any} */ obj) => (obj || {})[packageName]) ]
+  [ ".markdownlint-cli2.mjs", importModuleWrapper ]
 ];
 
 /** @type {ConfigurationFileAndHandler[] } */
@@ -278,15 +301,15 @@ const configurationFiles = [
 
 /**
  * Processes the first matching configuration file.
+ * @param {ExecutionContext} context Execution context.
  * @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(
+const processFirstMatchingConfigurationFile = (context, fileAndHandlers, dir, memoizeFile) => {
+  const { fs, noImport, parsers } = context;
+  return Promise.allSettled(
     fileAndHandlers.map(([ name, handler ]) => {
       const file = pathPosix.join(dir, name);
       return fs.promises.access(file).then(() => [ file, handler ]);
@@ -296,18 +319,17 @@ const processFirstMatchingConfigurationFile = (fileAndHandlers, dir, fs, noImpor
       /** @type {ConfigurationFileAndHandler} */
       const [ file, handler ] = values.find((result) => (result.status === "fulfilled"))?.value || [ "[UNUSED]", noop ];
       memoizeFile(file);
-      return handler({ dir, file, fs, noImport });
+      return handler({ dir, file, fs, noImport, parsers });
     });
+};
 
 // Get (creating if necessary) and process a directory's info object
 const getAndProcessDirInfo = (
-  /** @type {FsLike} */ fs,
+  /** @type {ExecutionContext} */ context,
   /** @type {Task[]} */ tasks,
   /** @type {DirToDirInfo} */ dirToDirInfo,
   /** @type {string} */ dir,
-  /** @type {string | null} */ relativeDir,
-  /** @type {boolean} */ noImport,
-  /** @type {boolean} */ allowPackageJson
+  /** @type {string | null} */ relativeDir
 ) => {
   // Create dirInfo
   let dirInfo = dirToDirInfo[dir];
@@ -326,22 +348,16 @@ const getAndProcessDirInfo = (
     tasks.push(
 
       // Load markdownlint-cli2 object(s)
-      processFirstMatchingConfigurationFile(
-        allowPackageJson ? optionsFiles : optionsFiles.slice(0, -1),
-        dir,
-        fs,
-        noImport,
-        (file) => { cli2File = file; }
-      ).
+      processFirstMatchingConfigurationFile(context, optionsFiles, dir, (file) => { cli2File = file; }).
         then((/** @type {Options | null} */ options) => {
           dirInfo.markdownlintOptions = options;
           return options &&
             options.config &&
             getExtendedConfig(
+              context,
               options.config,
               // Just need to identify the right directory
-              pathPosix.join(dir, utf8),
-              fs
+              pathPosix.join(dir, utf8)
             ).
               then((config) => {
                 options.config = config;
@@ -352,7 +368,7 @@ const getAndProcessDirInfo = (
         }),
 
       // Load markdownlint object(s)
-      processFirstMatchingConfigurationFile(configurationFiles, dir, fs, noImport, noop).
+      processFirstMatchingConfigurationFile(context, configurationFiles, dir, noop).
         then((/** @type {Configuration | null} */ config) => {
           dirInfo.markdownlintConfig = config;
         })
@@ -365,27 +381,24 @@ const getAndProcessDirInfo = (
 
 // Get base markdownlint-cli2 options object
 const getBaseOptions = async (
-  /** @type {FsLike} */ fs,
-  /** @type {string} */ baseDir,
+  /** @type {ExecutionContext} */ context,
   /** @type {string | null} */ relativeDir,
   /** @type {string[]} */ globPatterns,
   /** @type {Options} */ options,
   /** @type {boolean} */ fixDefault,
-  /** @type {boolean} */ noGlobs,
-  /** @type {boolean} */ noImport
+  /** @type {boolean} */ noGlobs
 ) => {
+  const { baseDir } = context;
   /** @type {Task[]} */
   const tasks = [];
   /** @type {DirToDirInfo} */
   const dirToDirInfo = {};
   getAndProcessDirInfo(
-    fs,
+    context,
     tasks,
     dirToDirInfo,
     baseDir,
-    relativeDir,
-    noImport,
-    true
+    relativeDir
   );
   await Promise.all(tasks);
   // eslint-disable-next-line no-multi-assign
@@ -418,15 +431,13 @@ const getBaseOptions = async (
 
 // Enumerate files from globs and build directory infos
 const enumerateFiles = async (
-  /** @type {FsLike} */ fs,
-  /** @type {string} */ baseDirSystem,
-  /** @type {string} */ baseDir,
+  /** @type {ExecutionContext} */ context,
   /** @type {string[]} */ globPatterns,
   /** @type {DirToDirInfo} */ dirToDirInfo,
   /** @type {boolean} */ gitignore,
-  /** @type {string | undefined} */ ignoreFiles,
-  /** @type {boolean} */ noImport
+  /** @type {string | undefined} */ ignoreFiles
 ) => {
+  const { baseDir, baseDirSystem, fs } = context;
   /** @type {Task[]} */
   const tasks = [];
   /** @type {import("globby").Options} */
@@ -470,13 +481,11 @@ const enumerateFiles = async (
   for (const file of files) {
     const dir = pathPosix.dirname(file);
     const dirInfo = getAndProcessDirInfo(
-      fs,
+      context,
       tasks,
       dirToDirInfo,
       dir,
-      null,
-      noImport,
-      false
+      null
     );
     dirInfo.files.push(file);
   }
@@ -485,11 +494,10 @@ const enumerateFiles = async (
 
 // Enumerate (possibly missing) parent directories and update directory infos
 const enumerateParents = async (
-  /** @type {FsLike} */ fs,
-  /** @type {string} */ baseDir,
-  /** @type {DirToDirInfo} */ dirToDirInfo,
-  /** @type {boolean} */ noImport
+  /** @type {ExecutionContext} */ context,
+  /** @type {DirToDirInfo} */ dirToDirInfo
 ) => {
+  const { baseDir } = context;
   /** @type {Task[]} */
   const tasks = [];
 
@@ -514,13 +522,11 @@ const enumerateParents = async (
       lastDir = dir;
       const dirInfo =
         getAndProcessDirInfo(
-          fs,
+          context,
           tasks,
           dirToDirInfo,
           dir,
-          null,
-          noImport,
-          false
+          null
         );
       lastDirInfo.parent = dirInfo;
       lastDirInfo = dirInfo;
@@ -536,31 +542,23 @@ const enumerateParents = async (
 
 // Create directory info objects by enumerating file globs
 const createDirInfos = async (
-  /** @type {FsLike} */ fs,
-  /** @type {string} */ baseDirSystem,
-  /** @type {string} */ baseDir,
+  /** @type {ExecutionContext} */ context,
   /** @type {string[]} */ globPatterns,
   /** @type {DirToDirInfo} */ dirToDirInfo,
   /** @type {Options | undefined} */ optionsOverride,
   /** @type {boolean} */ gitignore,
-  /** @type {string | undefined} */ ignoreFiles,
-  /** @type {boolean} */ noImport
+  /** @type {string | undefined} */ ignoreFiles
 ) => {
   await enumerateFiles(
-    fs,
-    baseDirSystem,
-    baseDir,
+    context,
     globPatterns,
     dirToDirInfo,
     gitignore,
-    ignoreFiles,
-    noImport
+    ignoreFiles
   );
   await enumerateParents(
-    fs,
-    baseDir,
-    dirToDirInfo,
-    noImport
+    context,
+    dirToDirInfo
   );
 
   // Merge file lists with identical configuration
@@ -576,6 +574,7 @@ const createDirInfos = async (
       }
       delete dirToDirInfo[dir];
     } else {
+      const { noImport } = context;
       const { markdownlintOptions, relativeDir } = dirInfo;
       const effectiveDir = relativeDir || dir;
       const effectiveModulePaths = resolveModulePaths(
@@ -675,7 +674,13 @@ const createDirInfos = async (
 };
 
 // Lint files in groups by shared configuration
-const lintFiles = (/** @type {FsLike} */ fs, /** @type {DirInfo[]} */ dirInfos, /** @type {Record<string, string>} */ fileContents, /** @type {FormattingContext} */ formattingContext) => {
+const lintFiles = (
+  /** @type {ExecutionContext} */ context,
+  /** @type {DirInfo[]} */ dirInfos,
+  /** @type {Record<string, string>} */ fileContents,
+  /** @type {FormattingContext} */ formattingContext
+) => {
+  const { fs, parsers } = context;
   const tasks = [];
   // For each dirInfo
   for (const dirInfo of dirInfos) {
@@ -848,7 +853,6 @@ export const main = async (/** @type {Parameters} */ params) => {
     optionsDefault,
     optionsOverride,
     fileContents,
-    noImport,
     allowStdin
   } = params;
   let {
@@ -858,6 +862,7 @@ export const main = async (/** @type {Parameters} */ params) => {
   const logMessage = params.logMessage || noop;
   const logError = params.logError || noop;
   const fs = params.fs || fsNode;
+  const noImport = Boolean(params.noImport);
   const baseDirSystem =
     (directory && pathDefault.resolve(directory)) ||
     process.cwd();
@@ -869,6 +874,9 @@ export const main = async (/** @type {Parameters} */ params) => {
   /** @type {undefined | null | string} */
   // eslint-disable-next-line unicorn/no-useless-undefined
   let configPath = undefined;
+  /** @type {undefined | null | string} */
+  // eslint-disable-next-line unicorn/no-useless-undefined
+  let configPointer = undefined;
   let useStdin = false;
   let sawDashDash = false;
   let shouldShowHelp = false;
@@ -877,6 +885,8 @@ export const main = async (/** @type {Parameters} */ params) => {
       return true;
     } else if (configPath === null) {
       configPath = arg;
+    } else if (configPointer === null) {
+      configPointer = arg;
     } else if ((arg === "-") && allowStdin) {
       useStdin = true;
       // eslint-disable-next-line unicorn/prefer-switch
@@ -884,6 +894,8 @@ export const main = async (/** @type {Parameters} */ params) => {
       sawDashDash = true;
     } else if (arg === "--config") {
       configPath = null;
+    } else if (arg === "--configPointer") {
+      configPointer = null;
     } else if (arg === "--fix") {
       fixDefault = true;
     } else if (arg === "--format") {
@@ -901,6 +913,8 @@ export const main = async (/** @type {Parameters} */ params) => {
   if (shouldShowHelp) {
     return showHelp(logMessage, true);
   }
+  /** @type {ExecutionContext} */
+  const context = { baseDir, baseDirSystem, fs, noImport, "parsers": allParsers };
   // Read argv configuration file (if relevant and present)
   let optionsArgv = null;
   let relativeDir = null;
@@ -908,23 +922,19 @@ export const main = async (/** @type {Parameters} */ params) => {
   let baseOptions = null;
   try {
     if (configPath) {
-      const resolvedConfigPath =
-        posixPath(pathDefault.resolve(baseDirSystem, configPath));
-      optionsArgv =
-        await readOptionsOrConfig(resolvedConfigPath, fs, Boolean(noImport));
+      const resolvedConfigPath = posixPath(pathDefault.resolve(baseDirSystem, configPath));
+      optionsArgv = await readOptionsOrConfig(context, resolvedConfigPath, configPointer);
       relativeDir = pathPosix.dirname(resolvedConfigPath);
     }
     // Process arguments and get base options
     globPatterns = processArgv(argvFiltered);
     baseOptions = await getBaseOptions(
-      fs,
-      baseDir,
+      context,
       relativeDir,
       globPatterns,
       optionsArgv || optionsDefault,
       fixDefault,
-      Boolean(noGlobs),
-      Boolean(noImport)
+      Boolean(noGlobs)
     );
   } finally {
     if (!baseOptions?.baseMarkdownlintOptions.noBanner && !formattingContext.formatting) {
@@ -973,15 +983,12 @@ export const main = async (/** @type {Parameters} */ params) => {
     : undefined;
   const dirInfos =
     await createDirInfos(
-      fs,
-      baseDirSystem,
-      baseDir,
+      context,
       globPatterns,
       dirToDirInfo,
       optionsOverride,
       gitignore,
-      ignoreFiles,
-      Boolean(noImport)
+      ignoreFiles
     );
   // Output linting status
   if (showProgress) {
@@ -998,7 +1005,7 @@ export const main = async (/** @type {Parameters} */ params) => {
     logMessage(`Linting: ${fileCount} file(s)`);
   }
   // Lint files
-  const lintResults = await lintFiles(fs, dirInfos, resolvedFileContents, formattingContext);
+  const lintResults = await lintFiles(context, dirInfos, resolvedFileContents, formattingContext);
   // Output summary
   const results = createResults(baseDir, lintResults);
   if (showProgress) {
@@ -1044,6 +1051,15 @@ export const main = async (/** @type {Parameters} */ params) => {
 
 /** @typedef {Promise<any>} Task */
 
+/**
+ * @typedef ExecutionContext
+ * @property {string} baseDir Base directory (POSIX).
+ * @property {string} baseDirSystem Base directory (non-POSIX).
+ * @property {FsLike} fs File system object.
+ * @property {boolean} noImport No import.
+ * @property {ConfigurationParser[]} parsers Configuration file parsers.
+ */
+
 /**
  * @typedef Parameters
  * @property {boolean} [allowStdin] Allow stdin.
@@ -1062,11 +1078,14 @@ export const main = async (/** @type {Parameters} */ params) => {
 
 /** @typedef {import("markdownlint").Configuration} Configuration */
 
+/** @typedef {import("markdownlint").ConfigurationParser} ConfigurationParser */
+
 /**
  * @typedef ConfigurationHandlerParams
  * @property {string} dir Configuration file directory.
  * @property {string} file Configuration file.
  * @property {FsLike} fs File system object.
+ * @property {ConfigurationParser[]} parsers Configuration file parsers.
  * @property {boolean} noImport No import.
  */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdownlint-cli2",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "A fast, flexible, configuration-based command-line interface for linting Markdown/CommonMark files with the `markdownlint` library",
   "author": {
     "name": "David Anson",
@@ -15,6 +15,7 @@
     "./markdownlint/promise": "./export-markdownlint-promise.mjs",
     "./parsers": "./parsers/parsers.mjs",
     "./parsers/jsonc": "./parsers/jsonc-parse.mjs",
+    "./parsers/toml": "./parsers/toml-parse.mjs",
     "./parsers/yaml": "./parsers/yaml-parse.mjs"
   },
   "bin": {
@@ -39,7 +40,7 @@
     "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.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-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/constants-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\"",
@@ -57,6 +58,7 @@
   "files": [
     "append-to-array.mjs",
     "CHANGELOG.md",
+    "constants.mjs",
     "export-markdownlint.mjs",
     "export-markdownlint-helpers.mjs",
     "export-markdownlint-promise.mjs",
@@ -66,6 +68,7 @@
     "merge-options.mjs",
     "parsers/parsers.mjs",
     "parsers/jsonc-parse.mjs",
+    "parsers/toml-parse.mjs",
     "parsers/yaml-parse.mjs",
     "README.md",
     "schema/markdownlint-cli2-config-schema.json",
@@ -73,27 +76,28 @@
     "schema/ValidatingConfiguration.md"
   ],
   "dependencies": {
-    "globby": "16.1.0",
+    "globby": "16.1.1",
     "js-yaml": "4.1.1",
     "jsonc-parser": "3.3.1",
+    "jsonpointer": "5.0.1",
     "markdownlint": "0.40.0",
     "markdownlint-cli2-formatter-default": "0.0.6",
     "markdown-it": "14.1.1",
-    "micromatch": "4.0.8"
+    "micromatch": "4.0.8",
+    "smol-toml": "1.6.0"
   },
   "devDependencies": {
-    "@eslint/js": "9.39.2",
+    "@eslint/js": "10.0.1",
     "@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",
+    "@stylistic/eslint-plugin": "5.10.0",
+    "ajv": "8.18.0",
+    "ava": "7.0.0",
+    "c8": "11.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": "10.1.0",
+    "eslint-plugin-jsdoc": "62.8.0",
+    "eslint-plugin-n": "17.24.0",
     "eslint-plugin-unicorn": "63.0.0",
     "execa": "9.6.1",
     "markdown-it-emoji": "3.0.0",
@@ -101,7 +105,7 @@
     "markdownlint-cli2-formatter-codequality": "0.0.7",
     "markdownlint-cli2-formatter-json": "0.0.9",
     "markdownlint-cli2-formatter-junit": "0.0.14",
-    "markdownlint-cli2-formatter-pretty": "0.0.9",
+    "markdownlint-cli2-formatter-pretty": "0.0.10",
     "markdownlint-cli2-formatter-sarif": "0.0.4",
     "markdownlint-cli2-formatter-summarize": "0.0.8",
     "markdownlint-cli2-formatter-template": "0.0.4",

package/parsers/parsers.mjs

@@ -1,6 +1,7 @@
 // @ts-check
 
 import jsoncParse from "./jsonc-parse.mjs";
+import tomlParse from "./toml-parse.mjs";
 import yamlParse from "./yaml-parse.mjs";
 
 /**
@@ -9,6 +10,7 @@ import yamlParse from "./yaml-parse.mjs";
  */
 const parsers = [
   jsoncParse,
+  tomlParse,
   yamlParse
 ];
 

package/parsers/toml-parse.mjs

@@ -0,0 +1,11 @@
+// @ts-check
+
+import { parse } from "smol-toml";
+
+/**
+ * Parses a TOML string, returning the corresponding object.
+ * @type {import("markdownlint").ConfigurationParser}
+ */
+const tomlParse = (text) => parse(text);
+
+export default tomlParse;

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.21.0/schema/markdownlint-cli2-config-schema.json",
+  "$id": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.22.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.21.0/schema/markdownlint-cli2-config-schema.json"
+      "default": "https://raw.githubusercontent.com/DavidAnson/markdownlint-cli2/v0.22.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.21.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.22.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.21.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.22.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.21.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.22.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.21.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.22.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.21.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.22.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.21.0/README.md#markdownlint-cli2jsonc",
+      "description": "Glob expressions to ignore when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.22.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.21.0/README.md#markdownlint-cli2jsonc",
+      "description": "markdown-it plugins to load and use when linting : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.22.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.21.0/README.md#markdownlint-cli2jsonc",
+      "description": "Additional paths to resolve module locations from : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.22.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.21.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.22.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.21.0/README.md#markdownlint-cli2jsonc",
+      "description": "Whether to disable support of HTML comments within Markdown content : https://github.com/DavidAnson/markdownlint-cli2/blob/v0.22.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.21.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.22.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.21.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.22.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.21.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.22.0/README.md#markdownlint-cli2jsonc",
       "type": "boolean",
       "default": false
     }