markdownlint-cli2 0.20.0 → 0.22.0

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.20.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(
@@ -50,20 +59,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,19 +113,10 @@ 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 {ExecutionContext} */ context, /** @type {Configuration} */ config, /** @type {string} */ configPath) => {
   if (config.extends) {
+    const { fs, parsers } = context;
     return extendConfig(
       config,
       configPath,
@@ -143,50 +129,64 @@ const getExtendedConfig = (/** @type {import("markdownlint").Configuration} */ c
 };
 
 // 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 };
 };
 
@@ -229,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 /
@@ -246,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
@@ -259,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
@@ -275,15 +275,61 @@ $ markdownlint-cli2 "**/*.md" "#node_modules"`
   return 2;
 };
 
+// Helpers for getAndProcessDirInfo/handleFirstMatchingConfigurationFile
+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", readJsoncWrapper ],
+  [ ".markdownlint-cli2.yaml", readYamlWrapper ],
+  [ ".markdownlint-cli2.cjs", importModuleWrapper ],
+  [ ".markdownlint-cli2.mjs", importModuleWrapper ]
+];
+
+/** @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 {ExecutionContext} context Execution context.
+ * @param {ConfigurationFileAndHandler[]} fileAndHandlers List of configuration files and handlers.
+ * @param {string} dir Configuration file directory.
+ * @param {(file: string) => void} memoizeFile Function to memoize file name.
+ * @returns {Promise<any>} Configuration file content.
+ */
+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 ]);
+    })
+  ).
+    then((values) => {
+      /** @type {ConfigurationFileAndHandler} */
+      const [ file, handler ] = values.find((result) => (result.status === "fulfilled"))?.value || [ "[UNUSED]", noop ];
+      memoizeFile(file);
+      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];
@@ -293,106 +339,37 @@ 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(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 a file in the right directory
-              markdownlintCli2Jsonc,
-              fs
+              // Just need to identify the right directory
+              pathPosix.join(dir, utf8)
             ).
               then((config) => {
                 options.config = config;
               });
         }).
         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(context, configurationFiles, dir, noop).
+        then((/** @type {Configuration | null} */ config) => {
           dirInfo.markdownlintConfig = config;
         })
     );
@@ -404,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
@@ -457,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} */
@@ -473,7 +445,7 @@ const enumerateFiles = async (
     "absolute": true,
     "cwd": baseDir,
     "dot": true,
-    "expandDirectories": false,
+    "expandNegationOnlyPatterns": false,
     gitignore,
     ignoreFiles,
     "suppressErrors": true,
@@ -501,41 +473,19 @@ 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) {
     const dir = pathPosix.dirname(file);
     const dirInfo = getAndProcessDirInfo(
-      fs,
+      context,
       tasks,
       dirToDirInfo,
       dir,
-      null,
-      noImport,
-      false
+      null
     );
     dirInfo.files.push(file);
   }
@@ -544,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 = [];
 
@@ -573,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;
@@ -595,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
@@ -635,6 +574,7 @@ const createDirInfos = async (
       }
       delete dirToDirInfo[dir];
     } else {
+      const { noImport } = context;
       const { markdownlintOptions, relativeDir } = dirInfo;
       const effectiveDir = relativeDir || dir;
       const effectiveModulePaths = resolveModulePaths(
@@ -704,8 +644,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 +658,7 @@ const createDirInfos = async (
       if (
         !markdownlintConfig &&
         parent.markdownlintConfig &&
-        !markdownlintOptions.config
+        !markdownlintOptions?.config
       ) {
         // eslint-disable-next-line prefer-destructuring
         markdownlintConfig = parent.markdownlintConfig;
@@ -735,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) {
@@ -743,6 +688,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 +712,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 +723,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 +745,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 +782,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>} */
@@ -907,7 +853,6 @@ export const main = async (/** @type {Parameters} */ params) => {
     optionsDefault,
     optionsOverride,
     fileContents,
-    noImport,
     allowStdin
   } = params;
   let {
@@ -917,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();
@@ -928,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;
@@ -936,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
@@ -943,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") {
@@ -960,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;
@@ -967,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) {
@@ -1026,24 +977,18 @@ 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,
-      baseDirSystem,
-      baseDir,
+      context,
       globPatterns,
       dirToDirInfo,
       optionsOverride,
       gitignore,
-      ignoreFiles,
-      Boolean(noImport)
+      ignoreFiles
     );
   // Output linting status
   if (showProgress) {
@@ -1060,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) {
@@ -1106,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.
@@ -1122,14 +1076,29 @@ export const main = async (/** @type {Parameters} */ params) => {
  * @property {Options} [optionsOverride] Options override.
  */
 
+/** @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.
+ */
+
+/** @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 +1107,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 +1134,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.