@markuplint/file-resolver 4.9.17 → 5.0.0-alpha.0

package/CHANGELOG.md

@@ -3,13 +3,37 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [4.9.17](https://github.com/markuplint/markuplint/compare/@markuplint/file-resolver@4.9.16...@markuplint/file-resolver@4.9.17) (2025-11-05)
+# [5.0.0-alpha.0](https://github.com/markuplint/markuplint/compare/v4.14.1...v5.0.0-alpha.0) (2026-02-20)
 
-**Note:** Version bump only for package @markuplint/file-resolver
+### Bug Fixes
+
+- **file-resolver:** use "options" instead of deprecated "option" in test fixtures ([98a53f2](https://github.com/markuplint/markuplint/commit/98a53f27c4a6e640f20e2c74421c1cdeba3e7db5))
+
+- refactor(file-resolver)!: drop MLMarkupLanguageParser support ([3272ee7](https://github.com/markuplint/markuplint/commit/3272ee72a7c4fb3105fbecd41ec4ba5eff030092))
+
+### Features
+
+- **file-resolver:** add .jsonc config file support via cosmiconfig ([755848d](https://github.com/markuplint/markuplint/commit/755848dbec75105e3cdf9de6becb84546b66deec))
 
+### BREAKING CHANGES
 
+- Remove MLMarkupLanguageParser compatibility from
+  resolve-parser. Parser modules must now export MLParserModule
+  with a parser property.
 
+* Remove MLMarkupLanguageParser import and union types
+* Remove deprecated 'parser' in parserMod check
+* Update test mock to use Parser class instance
 
+Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
+
+## [4.9.18](https://github.com/markuplint/markuplint/compare/@markuplint/file-resolver@4.9.17...@markuplint/file-resolver@4.9.18) (2026-02-10)
+
+**Note:** Version bump only for package @markuplint/file-resolver
+
+## [4.9.17](https://github.com/markuplint/markuplint/compare/@markuplint/file-resolver@4.9.16...@markuplint/file-resolver@4.9.17) (2025-11-05)
+
+**Note:** Version bump only for package @markuplint/file-resolver
 
 ## [4.9.16](https://github.com/markuplint/markuplint/compare/@markuplint/file-resolver@4.9.15...@markuplint/file-resolver@4.9.16) (2025-08-24)
 

package/lib/config-load-error.js

@@ -1,7 +1,9 @@
 export class ConfigLoadError extends Error {
+    filePath;
+    name = 'ConfigLoadError';
+    referrer;
     constructor(message, filePath, referrer) {
         super(message + ` in ${referrer}`);
-        this.name = 'ConfigLoadError';
         this.filePath = filePath;
         this.referrer = referrer;
     }

package/lib/config-provider.d.ts

@@ -2,14 +2,51 @@ import type { MLFile } from './ml-file/index.js';
 import type { ConfigSet } from './types.js';
 import type { OptimizedConfig } from '@markuplint/ml-config';
 import type { Nullable } from '@markuplint/shared';
+/**
+ * Manages loading, caching, and resolving markuplint configuration files.
+ *
+ * Handles `extends` chains, plugins, presets, overrides, and circular reference detection.
+ * Configuration files are searched via cosmiconfig and cached by file path.
+ */
 export declare class ConfigProvider {
     #private;
+    /**
+     * Recursively loads a configuration and all its `extends` dependencies.
+     *
+     * @param key - The config file path or module name to load
+     * @param cache - Whether to use cached results
+     * @param referrer - The file path of the config that referenced this key
+     * @param depth - Current recursion depth (for circular reference detection)
+     * @returns A set of loaded config keys and any errors encountered
+     */
     recursiveLoad(key: string, cache: boolean, referrer: string, depth?: number): Promise<{
         stack: Set<string>;
         errs: Error[];
     }>;
+    /**
+     * Resolves the full configuration for a target file by merging all named configs,
+     * resolving plugins, and applying file-specific overrides.
+     *
+     * @param targetFile - The file being linted
+     * @param names - Config file paths or module names to merge
+     * @param cache - Whether to use cached results
+     * @returns The fully resolved configuration set including plugins and errors
+     */
     resolve(targetFile: Readonly<MLFile>, names: readonly Nullable<string>[], cache?: boolean): Promise<ConfigSet>;
+    /**
+     * Searches for a markuplint configuration file starting from the target file's directory.
+     *
+     * @param targetFile - The file whose directory to search from
+     * @returns The file path of the found config, or `null` if none was found
+     */
     search(targetFile: Readonly<MLFile>): Promise<string | null>;
+    /**
+     * Stores a pre-built configuration in the provider's internal store.
+     *
+     * @param config - The optimized configuration to store
+     * @param key - An optional key to store the config under; auto-generated if omitted
+     * @returns The key under which the config was stored
+     */
     set(config: OptimizedConfig, key?: string): string;
     private _load;
     private _mergeConfigs;

package/lib/config-provider.js

@@ -1,9 +1,3 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _ConfigProvider_cache, _ConfigProvider_held, _ConfigProvider_recursiveLoadKeyAndDepth, _ConfigProvider_store;
 import path from 'node:path';
 import { mergeConfig } from '@markuplint/ml-config';
 import { ConfigParserError } from '@markuplint/parser-utils';
@@ -22,25 +16,38 @@ import { cacheClear, resolvePlugins } from './resolve-plugins.js';
 import { fileExists, uuid } from './utils.js';
 const cpLog = log.extend('config-provider');
 const KEY_SEPARATOR = '__ML_CONFIG_MERGE__';
+/**
+ * Manages loading, caching, and resolving markuplint configuration files.
+ *
+ * Handles `extends` chains, plugins, presets, overrides, and circular reference detection.
+ * Configuration files are searched via cosmiconfig and cached by file path.
+ */
 export class ConfigProvider {
-    constructor() {
-        _ConfigProvider_cache.set(this, new Map());
-        _ConfigProvider_held.set(this, new Set());
-        _ConfigProvider_recursiveLoadKeyAndDepth.set(this, new Map());
-        _ConfigProvider_store.set(this, new Map());
-    }
+    #cache = new Map();
+    #held = new Set();
+    #recursiveLoadKeyAndDepth = new Map();
+    #store = new Map();
+    /**
+     * Recursively loads a configuration and all its `extends` dependencies.
+     *
+     * @param key - The config file path or module name to load
+     * @param cache - Whether to use cached results
+     * @param referrer - The file path of the config that referenced this key
+     * @param depth - Current recursion depth (for circular reference detection)
+     * @returns A set of loaded config keys and any errors encountered
+     */
     async recursiveLoad(key, cache, referrer, depth = 1) {
         const stack = new Set();
         const errs = [];
-        const ancestorDepth = __classPrivateFieldGet(this, _ConfigProvider_recursiveLoadKeyAndDepth, "f").get(key);
+        const ancestorDepth = this.#recursiveLoadKeyAndDepth.get(key);
         if (ancestorDepth != null && ancestorDepth < depth) {
             return {
                 stack,
                 errs: [new CircularReferenceError(`Circular reference detected: ${key}`)],
             };
         }
-        __classPrivateFieldGet(this, _ConfigProvider_recursiveLoadKeyAndDepth, "f").set(key, depth);
-        let config = __classPrivateFieldGet(this, _ConfigProvider_store, "f").get(key);
+        this.#recursiveLoadKeyAndDepth.set(key, depth);
+        let config = this.#store.get(key);
         if (!config) {
             config = await this._load(key, cache, referrer);
         }
@@ -67,20 +74,29 @@ export class ConfigProvider {
         stack.add(key);
         return { stack, errs };
     }
+    /**
+     * Resolves the full configuration for a target file by merging all named configs,
+     * resolving plugins, and applying file-specific overrides.
+     *
+     * @param targetFile - The file being linted
+     * @param names - Config file paths or module names to merge
+     * @param cache - Whether to use cached results
+     * @returns The fully resolved configuration set including plugins and errors
+     */
     async resolve(targetFile, names, cache = true) {
         if (!cache) {
-            __classPrivateFieldGet(this, _ConfigProvider_store, "f").clear();
-            __classPrivateFieldGet(this, _ConfigProvider_cache, "f").clear();
+            this.#store.clear();
+            this.#cache.clear();
             cacheClear();
         }
         const keys = names.filter(nonNullableFilter);
         const key = keys.join(KEY_SEPARATOR);
-        const currentConfig = __classPrivateFieldGet(this, _ConfigProvider_cache, "f").get(key);
+        const currentConfig = this.#cache.get(key);
         if (currentConfig) {
             return currentConfig;
         }
         let configSet = await this._mergeConfigs(keys, cache, targetFile.path);
-        const filePath = [...configSet.files].reverse()[0];
+        const filePath = [...configSet.files].toReversed()[0];
         if (!filePath) {
             throw new ConfigParserError('Config file not found', {
                 filePath: targetFile.path,
@@ -90,8 +106,8 @@ export class ConfigProvider {
         configSet.errs.push(...errors);
         const { plugins, errors: pluginErrors } = await resolvePlugins(configSet.config.plugins);
         configSet.errs.push(...pluginErrors);
-        if (__classPrivateFieldGet(this, _ConfigProvider_held, "f").size > 0) {
-            const extendHelds = [...__classPrivateFieldGet(this, _ConfigProvider_held, "f").values()];
+        if (this.#held.size > 0) {
+            const extendHelds = [...this.#held.values()];
             for (const held of extendHelds) {
                 const [, prefix, namespace, name] = held.match(/^([a-z]+:)([^/]+)(?:\/(.+))?$/) ?? [];
                 switch (prefix) {
@@ -106,7 +122,7 @@ export class ConfigProvider {
                 }
             }
             configSet = await this._mergeConfigs([...keys, ...extendHelds], cache, targetFile.path);
-            __classPrivateFieldGet(this, _ConfigProvider_held, "f").clear();
+            this.#held.clear();
         }
         // Resolves `overrides`
         if (configSet.config.overrides) {
@@ -133,9 +149,15 @@ export class ConfigProvider {
             ...configSet,
             plugins,
         };
-        __classPrivateFieldGet(this, _ConfigProvider_cache, "f").set(key, result);
+        this.#cache.set(key, result);
         return result;
     }
+    /**
+     * Searches for a markuplint configuration file starting from the target file's directory.
+     *
+     * @param targetFile - The file whose directory to search from
+     * @returns The file path of the found config, or `null` if none was found
+     */
     async search(targetFile) {
         const isExists = await targetFile.dirExists();
         cpLog('search: %s', targetFile.path);
@@ -150,17 +172,24 @@ export class ConfigProvider {
         }
         const { filePath, config } = res;
         const pathResolvedConfig = await this._pathResolve(config, filePath);
-        __classPrivateFieldGet(this, _ConfigProvider_store, "f").set(filePath, pathResolvedConfig);
+        this.#store.set(filePath, pathResolvedConfig);
         cpLog('Store key: %s', filePath);
         return filePath;
     }
+    /**
+     * Stores a pre-built configuration in the provider's internal store.
+     *
+     * @param config - The optimized configuration to store
+     * @param key - An optional key to store the config under; auto-generated if omitted
+     * @returns The key under which the config was stored
+     */
     set(config, key) {
         key = key ?? uuid();
-        __classPrivateFieldGet(this, _ConfigProvider_store, "f").set(key, config);
+        this.#store.set(key, config);
         return key;
     }
     async _load(filePath, cache, referrer) {
-        const entity = __classPrivateFieldGet(this, _ConfigProvider_store, "f").get(filePath);
+        const entity = this.#store.get(filePath);
         if (entity) {
             return entity;
         }
@@ -168,11 +197,11 @@ export class ConfigProvider {
             const [, name] = filePath.match(/^markuplint:(.+)$/i) ?? [];
             const config = await getPreset(name ?? filePath);
             const pathResolvedConfig = await this._pathResolve(config, filePath);
-            __classPrivateFieldGet(this, _ConfigProvider_store, "f").set(filePath, pathResolvedConfig);
+            this.#store.set(filePath, pathResolvedConfig);
             return pathResolvedConfig;
         }
         if (isPluginModuleName(filePath)) {
-            __classPrivateFieldGet(this, _ConfigProvider_held, "f").add(filePath);
+            this.#held.add(filePath);
             return;
         }
         if (!(await moduleExists(filePath)) && !path.isAbsolute(filePath)) {
@@ -183,21 +212,21 @@ export class ConfigProvider {
             return config;
         }
         const pathResolvedConfig = await this._pathResolve(config, filePath);
-        __classPrivateFieldGet(this, _ConfigProvider_store, "f").set(filePath, pathResolvedConfig);
+        this.#store.set(filePath, pathResolvedConfig);
         return pathResolvedConfig;
     }
     async _mergeConfigs(keys, cache, referrer) {
         const resolvedKeys = new Set();
         const errs = [];
         for (const key of keys) {
-            __classPrivateFieldGet(this, _ConfigProvider_recursiveLoadKeyAndDepth, "f").clear();
+            this.#recursiveLoadKeyAndDepth.clear();
             const keySet = await this.recursiveLoad(key, cache, referrer);
             for (const k of keySet.stack) {
                 resolvedKeys.add(k);
             }
             errs.push(...keySet.errs);
         }
-        const configs = [...resolvedKeys].map(name => __classPrivateFieldGet(this, _ConfigProvider_store, "f").get(name)).filter(nonNullableFilter);
+        const configs = [...resolvedKeys].map(name => this.#store.get(name)).filter(nonNullableFilter);
         let resultConfig = {};
         for (const config of configs) {
             if (config instanceof ConfigLoadError) {
@@ -252,7 +281,6 @@ export class ConfigProvider {
         return errors;
     }
 }
-_ConfigProvider_cache = new WeakMap(), _ConfigProvider_held = new WeakMap(), _ConfigProvider_recursiveLoadKeyAndDepth = new WeakMap(), _ConfigProvider_store = new WeakMap();
 async function load(filePath, cache, referrer) {
     if (!fileExists(filePath) && (await moduleExists(filePath))) {
         const config = (await generalImport(filePath)) ?? new ConfigLoadError('Module is not found', filePath, referrer);
@@ -270,8 +298,5 @@ async function load(filePath, cache, referrer) {
     return res.config;
 }
 class CircularReferenceError extends ReferenceError {
-    constructor() {
-        super(...arguments);
-        this.name = 'CircularReferenceError';
-    }
+    name = 'CircularReferenceError';
 }

package/lib/cosmiconfig.js

@@ -5,19 +5,38 @@ import { jsonc } from 'jsonc';
 import { ConfigLoadError } from './config-load-error.js';
 import { log } from './debug.js';
 const searchLog = log.extend('search');
+const jsoncLoader = (path, content) => {
+    try {
+        return jsonc.parse(content);
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'JSONError') {
+            return defaultLoaders['noExt'](path, content);
+        }
+        throw error;
+    }
+};
 const explorer = cosmiconfig('markuplint', {
+    searchPlaces: [
+        'package.json',
+        '.markuplintrc',
+        '.markuplintrc.json',
+        '.markuplintrc.jsonc',
+        '.markuplintrc.yaml',
+        '.markuplintrc.yml',
+        '.markuplintrc.js',
+        '.markuplintrc.ts',
+        '.markuplintrc.cjs',
+        '.markuplintrc.mjs',
+        'markuplint.config.js',
+        'markuplint.config.ts',
+        'markuplint.config.cjs',
+        'markuplint.config.mjs',
+        'markuplint.config.jsonc',
+    ],
     loaders: {
-        noExt: ((path, content) => {
-            try {
-                return jsonc.parse(content);
-            }
-            catch (error) {
-                if (error instanceof Error && error.name === 'JSONError') {
-                    return defaultLoaders['noExt'](path, content);
-                }
-                throw error;
-            }
-        }),
+        noExt: jsoncLoader,
+        '.jsonc': jsoncLoader,
     },
     searchStrategy: 'project',
 });

package/lib/ml-file/ml-file.js

@@ -1,51 +1,39 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _MLFile_basename, _MLFile_code, _MLFile_dirname, _MLFile_stat, _MLFile_type;
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import ignore from 'ignore';
 import { minimatch } from 'minimatch';
 export class MLFile {
+    #basename;
+    #code;
+    #dirname;
+    /**
+     * - `Stats`: Exists
+     * - `null`: Not exists
+     * - `undefined`: Doesn't read yet
+     */
+    #stat = undefined;
+    #type;
     constructor(target) {
-        _MLFile_basename.set(this, void 0);
-        _MLFile_code.set(this, void 0);
-        _MLFile_dirname.set(this, void 0);
-        /**
-         * - `Stats`: Exists
-         * - `null`: Not exists
-         * - `undefined`: Doesn't read yet
-         */
-        _MLFile_stat.set(this, undefined);
-        _MLFile_type.set(this, void 0);
         if (typeof target === 'string') {
-            __classPrivateFieldSet(this, _MLFile_basename, path.basename(target), "f");
-            __classPrivateFieldSet(this, _MLFile_dirname, path.dirname(target), "f");
-            __classPrivateFieldSet(this, _MLFile_code, null, "f");
-            __classPrivateFieldSet(this, _MLFile_type, 'file-base', "f");
+            this.#basename = path.basename(target);
+            this.#dirname = path.dirname(target);
+            this.#code = null;
+            this.#type = 'file-base';
             return;
         }
         if (!target.workspace && target.name && path.isAbsolute(target.name)) {
-            __classPrivateFieldSet(this, _MLFile_basename, path.basename(target.name), "f");
-            __classPrivateFieldSet(this, _MLFile_dirname, path.dirname(target.name), "f");
+            this.#basename = path.basename(target.name);
+            this.#dirname = path.dirname(target.name);
         }
         else {
-            __classPrivateFieldSet(this, _MLFile_basename, target.name ?? '<AnonymousFile>', "f");
-            __classPrivateFieldSet(this, _MLFile_dirname, target.workspace ?? process.cwd(), "f");
+            this.#basename = target.name ?? '<AnonymousFile>';
+            this.#dirname = target.workspace ?? process.cwd();
         }
-        __classPrivateFieldSet(this, _MLFile_code, target.sourceCode, "f");
-        __classPrivateFieldSet(this, _MLFile_type, 'code-base', "f");
+        this.#code = target.sourceCode;
+        this.#type = 'code-base';
     }
     get dirname() {
-        return __classPrivateFieldGet(this, _MLFile_dirname, "f");
+        return this.#dirname;
     }
     /**
      * Normalized `MLFile.dirname`
@@ -60,16 +48,16 @@ export class MLFile {
         return pathNormalize(this.path);
     }
     get path() {
-        return path.resolve(__classPrivateFieldGet(this, _MLFile_dirname, "f"), __classPrivateFieldGet(this, _MLFile_basename, "f"));
+        return path.resolve(this.#dirname, this.#basename);
     }
     async dirExists() {
-        return !!(await stat(__classPrivateFieldGet(this, _MLFile_dirname, "f")));
+        return !!(await stat(this.#dirname));
     }
     async getCode() {
-        if (__classPrivateFieldGet(this, _MLFile_code, "f") != null) {
-            return __classPrivateFieldGet(this, _MLFile_code, "f");
+        if (this.#code != null) {
+            return this.#code;
         }
-        if (__classPrivateFieldGet(this, _MLFile_type, "f") === 'file-base' && (await this.isExist())) {
+        if (this.#type === 'file-base' && (await this.isExist())) {
             return await this._fetch();
         }
         return '';
@@ -83,14 +71,14 @@ export class MLFile {
         return ignored;
     }
     async isExist() {
-        if (__classPrivateFieldGet(this, _MLFile_type, "f") === 'code-base') {
+        if (this.#type === 'code-base') {
             return true;
         }
         const stat = await this._stat();
         return !!stat;
     }
     async isFile() {
-        if (__classPrivateFieldGet(this, _MLFile_type, "f") === 'code-base') {
+        if (this.#type === 'code-base') {
             return true;
         }
         const stat = await this._stat();
@@ -100,25 +88,24 @@ export class MLFile {
         return minimatch(this.nPath, pathNormalize(globPath));
     }
     setCode(code) {
-        if (__classPrivateFieldGet(this, _MLFile_type, "f") === 'file-base') {
+        if (this.#type === 'file-base') {
             throw new Error(`This file object is readonly (File-base: ${this.path})`);
         }
-        __classPrivateFieldSet(this, _MLFile_code, code, "f");
+        this.#code = code;
     }
     async _fetch() {
         const code = await fs.readFile(this.path, { encoding: 'utf8' });
-        __classPrivateFieldSet(this, _MLFile_code, code, "f");
+        this.#code = code;
         return code;
     }
     async _stat() {
-        if (__classPrivateFieldGet(this, _MLFile_stat, "f")) {
-            return __classPrivateFieldGet(this, _MLFile_stat, "f");
+        if (this.#stat) {
+            return this.#stat;
         }
-        __classPrivateFieldSet(this, _MLFile_stat, await stat(this.path), "f");
-        return __classPrivateFieldGet(this, _MLFile_stat, "f");
+        this.#stat = await stat(this.path);
+        return this.#stat;
     }
 }
-_MLFile_basename = new WeakMap(), _MLFile_code = new WeakMap(), _MLFile_dirname = new WeakMap(), _MLFile_stat = new WeakMap(), _MLFile_type = new WeakMap();
 async function stat(filePath) {
     try {
         return await fs.stat(filePath);

package/lib/resolve-files.d.ts

@@ -1,3 +1,11 @@
 import type { MLFile } from './ml-file/index.js';
 import type { Target } from './types.js';
+/**
+ * Resolves a list of targets (file globs or inline source code objects) into
+ * an array of {@link MLFile} instances.
+ *
+ * @param targetList - An array of file path globs or inline source code targets
+ * @param ignoreGlob - An optional glob pattern for files to exclude
+ * @returns An array of resolved MLFile instances
+ */
 export declare function resolveFiles(targetList: readonly Readonly<Target>[], ignoreGlob?: string): Promise<MLFile[]>;

package/lib/resolve-files.js

@@ -1,4 +1,12 @@
 import { getAnonymousFile, getFiles } from './ml-file/index.js';
+/**
+ * Resolves a list of targets (file globs or inline source code objects) into
+ * an array of {@link MLFile} instances.
+ *
+ * @param targetList - An array of file path globs or inline source code targets
+ * @param ignoreGlob - An optional glob pattern for files to exclude
+ * @returns An array of resolved MLFile instances
+ */
 export async function resolveFiles(targetList, ignoreGlob) {
     const res = [];
     for (const target of targetList) {

package/lib/resolve-parser.d.ts

@@ -1,9 +1,20 @@
 import type { MLFile } from './ml-file/index.js';
-import type { MLMarkupLanguageParser, MLParser, ParserOptions } from '@markuplint/ml-ast';
+import type { MLParser, ParserOptions } from '@markuplint/ml-ast';
 import type { ParserConfig } from '@markuplint/ml-config';
+/**
+ * Resolves the appropriate parser for a given file based on the parser configuration.
+ *
+ * Matches the file's basename against patterns in the parser config to find
+ * the correct parser module. Falls back to the HTML parser if no pattern matches.
+ *
+ * @param file - The file to find a parser for
+ * @param parserConfig - A mapping of file extension patterns to parser module names
+ * @param parserOptions - Parser options to pass through
+ * @returns The resolved parser, its module name, parser options, and whether a pattern matched
+ */
 export declare function resolveParser(file: Readonly<MLFile>, parserConfig?: ParserConfig, parserOptions?: ParserOptions): Promise<{
     parserModName: string;
-    parser: MLParser | MLMarkupLanguageParser;
+    parser: MLParser;
     parserOptions: ParserOptions;
     matched: boolean;
 }>;

package/lib/resolve-parser.js

@@ -2,6 +2,17 @@ import path from 'node:path';
 import { generalImport } from './general-import.js';
 import { toRegexp } from './utils.js';
 const parsers = new Map();
+/**
+ * Resolves the appropriate parser for a given file based on the parser configuration.
+ *
+ * Matches the file's basename against patterns in the parser config to find
+ * the correct parser module. Falls back to the HTML parser if no pattern matches.
+ *
+ * @param file - The file to find a parser for
+ * @param parserConfig - A mapping of file extension patterns to parser module names
+ * @param parserOptions - Parser options to pass through
+ * @returns The resolved parser, its module name, parser options, and whether a pattern matched
+ */
 export async function resolveParser(file, parserConfig, parserOptions) {
     parserConfig = {
         ...parserConfig,
@@ -39,9 +50,5 @@ async function importParser(parserModName) {
     if (!parserMod) {
         throw new Error(`Parser module "${parserModName}" is not found.`);
     }
-    // TODO: To be dropped in v5
-    if (!('parser' in parserMod)) {
-        return parserMod;
-    }
     return parserMod.parser;
 }

package/lib/resolve-pretenders.d.ts

@@ -1,4 +1,11 @@
 import type { OptimizedConfig, Pretender } from '@markuplint/ml-config';
 type PretendersConfig = OptimizedConfig['pretenders'];
+/**
+ * Resolves pretender definitions from files, imported modules, and inline data
+ * in the configuration.
+ *
+ * @param config - The pretenders configuration section from the optimized config
+ * @returns An array of all resolved pretender definitions
+ */
 export declare function resolvePretenders(config: PretendersConfig): Promise<Pretender[]>;
 export {};

package/lib/resolve-pretenders.js

@@ -1,4 +1,11 @@
 import { generalImport } from './general-import.js';
+/**
+ * Resolves pretender definitions from files, imported modules, and inline data
+ * in the configuration.
+ *
+ * @param config - The pretenders configuration section from the optimized config
+ * @returns An array of all resolved pretender definitions
+ */
 export async function resolvePretenders(config) {
     if (!config) {
         return [];

package/lib/resolve-rules.d.ts

@@ -1,4 +1,16 @@
 import type { AnyMLRule, Ruleset, Plugin } from '@markuplint/ml-core';
+/**
+ * Resolves all rules from preset rules, plugins, and auto-loaded rules into
+ * a flat array of {@link MLRule} instances.
+ *
+ * @param plugins - The resolved plugins that may provide custom rules
+ * @param ruleset - The current ruleset (used for auto-loading)
+ * @param importPreset - Whether to import the built-in preset rules from `@markuplint/rules`
+ * @param autoLoad - Whether to auto-load rules referenced in the ruleset
+ * @returns An array of all resolved MLRule instances
+ *
+ * @deprecated The `autoLoad` parameter is deprecated
+ */
 export declare function resolveRules(plugins: readonly Plugin[], ruleset: Ruleset, importPreset: boolean, 
 /**
  * @deprecated

package/lib/resolve-rules.js

@@ -1,6 +1,18 @@
 import { MLRule } from '@markuplint/ml-core';
 import { autoLoadRules } from './auto-load-rules.js';
 let cachedPresetRules = null;
+/**
+ * Resolves all rules from preset rules, plugins, and auto-loaded rules into
+ * a flat array of {@link MLRule} instances.
+ *
+ * @param plugins - The resolved plugins that may provide custom rules
+ * @param ruleset - The current ruleset (used for auto-loading)
+ * @param importPreset - Whether to import the built-in preset rules from `@markuplint/rules`
+ * @param autoLoad - Whether to auto-load rules referenced in the ruleset
+ * @returns An array of all resolved MLRule instances
+ *
+ * @deprecated The `autoLoad` parameter is deprecated
+ */
 export async function resolveRules(plugins, ruleset, importPreset, 
 /**
  * @deprecated

package/lib/resolve-specs.d.ts

@@ -26,9 +26,9 @@ import type { ExtendedSpec, MLMLSpec } from '@markuplint/ml-spec';
  * }
  * ```
  *
- * @param filePath The lintee file path
- * @param specConfig The `spec` property part of the config
- * @returns
+ * @param filePath - The path of the file being linted, used for pattern matching
+ * @param specConfig - The `specs` property from the config, mapping file patterns to spec module names
+ * @returns An object containing the base HTML spec and any matched extended specs as a schemas tuple
  */
 export declare function resolveSpecs(filePath: string, specConfig?: SpecConfig): Promise<{
     schemas: readonly [MLMLSpec, ...ExtendedSpec[]];

package/lib/resolve-specs.js

@@ -28,9 +28,9 @@ const caches = new Map();
  * }
  * ```
  *
- * @param filePath The lintee file path
- * @param specConfig The `spec` property part of the config
- * @returns
+ * @param filePath - The path of the file being linted, used for pattern matching
+ * @param specConfig - The `specs` property from the config, mapping file patterns to spec module names
+ * @returns An object containing the base HTML spec and any matched extended specs as a schemas tuple
  */
 export async function resolveSpecs(filePath, specConfig) {
     const htmlSpec = await importSpecs('@markuplint/html-spec');

package/lib/types.d.ts

@@ -1,11 +1,22 @@
 import type { OptimizedConfig } from '@markuplint/ml-config';
 import type { Plugin } from '@markuplint/ml-core';
+/**
+ * A fully resolved configuration set including merged config, plugins, source file paths,
+ * and any errors encountered during resolution.
+ */
 export interface ConfigSet {
+    /** The merged and optimized configuration */
     readonly config: OptimizedConfig;
+    /** The resolved plugins */
     readonly plugins: readonly Plugin[];
+    /** The set of config file paths that contributed to this configuration */
     readonly files: ReadonlySet<string>;
+    /** Errors encountered during config loading or resolution */
     readonly errs: readonly Readonly<Error>[];
 }
+/**
+ * A lint target: either a file path/glob string, or an inline source code object.
+ */
 export type Target = string | {
     /**
      * Target source code of evaluation

package/package.json

@@ -1,10 +1,13 @@
 {
 	"name": "@markuplint/file-resolver",
-	"version": "4.9.17",
+	"version": "5.0.0-alpha.0",
 	"description": "The file resolver of markuplint",
 	"repository": "git@github.com:markuplint/markuplint.git",
 	"author": "Yusuke Hirao <yusukehirao@me.com>",
 	"license": "MIT",
+	"engines": {
+		"node": ">=22"
+	},
 	"type": "module",
 	"exports": {
 		".": {
@@ -27,21 +30,21 @@
 		"@types/node": "24.5.1"
 	},
 	"dependencies": {
-		"@markuplint/html-parser": "4.6.22",
-		"@markuplint/ml-ast": "4.4.10",
-		"@markuplint/ml-config": "4.8.14",
-		"@markuplint/ml-core": "4.13.2",
-		"@markuplint/ml-spec": "4.10.1",
-		"@markuplint/parser-utils": "4.8.10",
-		"@markuplint/selector": "4.7.7",
-		"@markuplint/shared": "4.4.12",
+		"@markuplint/html-parser": "5.0.0-alpha.0",
+		"@markuplint/ml-ast": "5.0.0-alpha.0",
+		"@markuplint/ml-config": "5.0.0-alpha.0",
+		"@markuplint/ml-core": "5.0.0-alpha.0",
+		"@markuplint/ml-spec": "5.0.0-alpha.0",
+		"@markuplint/parser-utils": "5.0.0-alpha.0",
+		"@markuplint/selector": "5.0.0-alpha.0",
+		"@markuplint/shared": "5.0.0-alpha.0",
 		"cosmiconfig": "9.0.0",
 		"debug": "4.4.3",
-		"glob": "11.0.3",
+		"glob": "13.0.6",
 		"ignore": "7.0.5",
 		"import-meta-resolve": "4.2.0",
 		"jsonc": "2.0.0",
-		"minimatch": "10.0.3"
+		"minimatch": "10.2.2"
 	},
-	"gitHead": "6213ea30269ef404f030e67bbcc7fc7443ec1060"
+	"gitHead": "13dcfc84ec83d87360c720e253383b60767e1b56"
 }