eslint 9.22.0 → 9.24.0

package/lib/shared/stats.js

@@ -10,7 +10,7 @@
  * @returns {[number, number]} t variable for tracking time
  */
 function startTime() {
-    return process.hrtime();
+	return process.hrtime();
 }
 
 /**
@@ -19,12 +19,12 @@ function startTime() {
  * @returns {number} The measured time in milliseconds
  */
 function endTime(t) {
-    const time = process.hrtime(t);
+	const time = process.hrtime(t);
 
-    return time[0] * 1e3 + time[1] / 1e6;
+	return time[0] * 1e3 + time[1] / 1e6;
 }
 
 module.exports = {
-    startTime,
-    endTime
+	startTime,
+	endTime,
 };

package/lib/shared/string-utils.js

@@ -25,10 +25,10 @@ let segmenter;
  * @returns {string} The converted string
  */
 function upperCaseFirst(string) {
-    if (string.length <= 1) {
-        return string.toUpperCase();
-    }
-    return string[0].toUpperCase() + string.slice(1);
+	if (string.length <= 1) {
+		return string.toUpperCase();
+	}
+	return string[0].toUpperCase() + string.slice(1);
 }
 
 /**
@@ -37,22 +37,22 @@ function upperCaseFirst(string) {
  * @returns {number} The number of graphemes in `value`.
  */
 function getGraphemeCount(value) {
-    if (ASCII_REGEX.test(value)) {
-        return value.length;
-    }
+	if (ASCII_REGEX.test(value)) {
+		return value.length;
+	}
 
-    segmenter ??= new Intl.Segmenter("en-US"); // en-US locale should be supported everywhere
-    let graphemeCount = 0;
+	segmenter ??= new Intl.Segmenter("en-US"); // en-US locale should be supported everywhere
+	let graphemeCount = 0;
 
-    // eslint-disable-next-line no-unused-vars -- for-of needs a variable
-    for (const unused of segmenter.segment(value)) {
-        graphemeCount++;
-    }
+	// eslint-disable-next-line no-unused-vars -- for-of needs a variable
+	for (const unused of segmenter.segment(value)) {
+		graphemeCount++;
+	}
 
-    return graphemeCount;
+	return graphemeCount;
 }
 
 module.exports = {
-    upperCaseFirst,
-    getGraphemeCount
+	upperCaseFirst,
+	getGraphemeCount,
 };

package/lib/shared/text-table.js

@@ -32,36 +32,37 @@
 
 "use strict";
 
-module.exports = function(rows_, opts) {
-    const hsep = "  ";
-    const align = opts.align;
-    const stringLength = opts.stringLength;
+module.exports = function (rows_, opts) {
+	const hsep = "  ";
+	const align = opts.align;
+	const stringLength = opts.stringLength;
 
-    const sizes = rows_.reduce((acc, row) => {
-        row.forEach((c, ix) => {
-            const n = stringLength(c);
+	const sizes = rows_.reduce((acc, row) => {
+		row.forEach((c, ix) => {
+			const n = stringLength(c);
 
-            if (!acc[ix] || n > acc[ix]) {
-                acc[ix] = n;
-            }
-        });
-        return acc;
-    }, []);
+			if (!acc[ix] || n > acc[ix]) {
+				acc[ix] = n;
+			}
+		});
+		return acc;
+	}, []);
 
-    return rows_
-        .map(row =>
-            row
-                .map((c, ix) => {
-                    const n = sizes[ix] - stringLength(c) || 0;
-                    const s = Array(Math.max(n + 1, 1)).join(" ");
+	return rows_
+		.map(row =>
+			row
+				.map((c, ix) => {
+					const n = sizes[ix] - stringLength(c) || 0;
+					const s = Array(Math.max(n + 1, 1)).join(" ");
 
-                    if (align[ix] === "r") {
-                        return s + c;
-                    }
+					if (align[ix] === "r") {
+						return s + c;
+					}
 
-                    return c + s;
-                })
-                .join(hsep)
-                .trimEnd())
-        .join("\n");
+					return c + s;
+				})
+				.join(hsep)
+				.trimEnd(),
+		)
+		.join("\n");
 };

package/lib/shared/traverser.js

@@ -21,8 +21,7 @@ const debug = require("debug")("eslint:traverser");
  * @returns {void}
  */
 function noop() {
-
-    // do nothing.
+	// do nothing.
 }
 
 /**
@@ -31,7 +30,7 @@ function noop() {
  * @returns {boolean} `true` if the value is an ASTNode.
  */
 function isNode(x) {
-    return x !== null && typeof x === "object" && typeof x.type === "string";
+	return x !== null && typeof x === "object" && typeof x.type === "string";
 }
 
 /**
@@ -41,155 +40,163 @@ function isNode(x) {
  * @returns {string[]} The visitor keys of the node.
  */
 function getVisitorKeys(visitorKeys, node) {
-    let keys = visitorKeys[node.type];
-
-    if (!keys) {
-        keys = vk.getKeys(node);
-        debug("Unknown node type \"%s\": Estimated visitor keys %j", node.type, keys);
-    }
-
-    return keys;
+	let keys = visitorKeys[node.type];
+
+	if (!keys) {
+		keys = vk.getKeys(node);
+		debug(
+			'Unknown node type "%s": Estimated visitor keys %j',
+			node.type,
+			keys,
+		);
+	}
+
+	return keys;
 }
 
 /**
  * The traverser class to traverse AST trees.
  */
 class Traverser {
-    constructor() {
-        this._current = null;
-        this._parents = [];
-        this._skipped = false;
-        this._broken = false;
-        this._visitorKeys = null;
-        this._enter = null;
-        this._leave = null;
-    }
-
-    /**
-     * Gives current node.
-     * @returns {ASTNode} The current node.
-     */
-    current() {
-        return this._current;
-    }
-
-    /**
-     * Gives a copy of the ancestor nodes.
-     * @returns {ASTNode[]} The ancestor nodes.
-     */
-    parents() {
-        return this._parents.slice(0);
-    }
-
-    /**
-     * Break the current traversal.
-     * @returns {void}
-     */
-    break() {
-        this._broken = true;
-    }
-
-    /**
-     * Skip child nodes for the current traversal.
-     * @returns {void}
-     */
-    skip() {
-        this._skipped = true;
-    }
-
-    /**
-     * Traverse the given AST tree.
-     * @param {ASTNode} node The root node to traverse.
-     * @param {Object} options The option object.
-     * @param {Object} [options.visitorKeys=DEFAULT_VISITOR_KEYS] The keys of each node types to traverse child nodes. Default is `./default-visitor-keys.json`.
-     * @param {Function} [options.enter=noop] The callback function which is called on entering each node.
-     * @param {Function} [options.leave=noop] The callback function which is called on leaving each node.
-     * @returns {void}
-     */
-    traverse(node, options) {
-        this._current = null;
-        this._parents = [];
-        this._skipped = false;
-        this._broken = false;
-        this._visitorKeys = options.visitorKeys || vk.KEYS;
-        this._enter = options.enter || noop;
-        this._leave = options.leave || noop;
-        this._traverse(node, null);
-    }
-
-    /**
-     * Traverse the given AST tree recursively.
-     * @param {ASTNode} node The current node.
-     * @param {ASTNode|null} parent The parent node.
-     * @returns {void}
-     * @private
-     */
-    _traverse(node, parent) {
-        if (!isNode(node)) {
-            return;
-        }
-
-        this._current = node;
-        this._skipped = false;
-        this._enter(node, parent);
-
-        if (!this._skipped && !this._broken) {
-            const keys = getVisitorKeys(this._visitorKeys, node);
-
-            if (keys.length >= 1) {
-                this._parents.push(node);
-                for (let i = 0; i < keys.length && !this._broken; ++i) {
-                    const child = node[keys[i]];
-
-                    if (Array.isArray(child)) {
-                        for (let j = 0; j < child.length && !this._broken; ++j) {
-                            this._traverse(child[j], node);
-                        }
-                    } else {
-                        this._traverse(child, node);
-                    }
-                }
-                this._parents.pop();
-            }
-        }
-
-        if (!this._broken) {
-            this._leave(node, parent);
-        }
-
-        this._current = parent;
-    }
-
-    /**
-     * Calculates the keys to use for traversal.
-     * @param {ASTNode} node The node to read keys from.
-     * @returns {string[]} An array of keys to visit on the node.
-     * @private
-     */
-    static getKeys(node) {
-        return vk.getKeys(node);
-    }
-
-    /**
-     * Traverse the given AST tree.
-     * @param {ASTNode} node The root node to traverse.
-     * @param {Object} options The option object.
-     * @param {Object} [options.visitorKeys=DEFAULT_VISITOR_KEYS] The keys of each node types to traverse child nodes. Default is `./default-visitor-keys.json`.
-     * @param {Function} [options.enter=noop] The callback function which is called on entering each node.
-     * @param {Function} [options.leave=noop] The callback function which is called on leaving each node.
-     * @returns {void}
-     */
-    static traverse(node, options) {
-        new Traverser().traverse(node, options);
-    }
-
-    /**
-     * The default visitor keys.
-     * @type {Object}
-     */
-    static get DEFAULT_VISITOR_KEYS() {
-        return vk.KEYS;
-    }
+	constructor() {
+		this._current = null;
+		this._parents = [];
+		this._skipped = false;
+		this._broken = false;
+		this._visitorKeys = null;
+		this._enter = null;
+		this._leave = null;
+	}
+
+	/**
+	 * Gives current node.
+	 * @returns {ASTNode} The current node.
+	 */
+	current() {
+		return this._current;
+	}
+
+	/**
+	 * Gives a copy of the ancestor nodes.
+	 * @returns {ASTNode[]} The ancestor nodes.
+	 */
+	parents() {
+		return this._parents.slice(0);
+	}
+
+	/**
+	 * Break the current traversal.
+	 * @returns {void}
+	 */
+	break() {
+		this._broken = true;
+	}
+
+	/**
+	 * Skip child nodes for the current traversal.
+	 * @returns {void}
+	 */
+	skip() {
+		this._skipped = true;
+	}
+
+	/**
+	 * Traverse the given AST tree.
+	 * @param {ASTNode} node The root node to traverse.
+	 * @param {Object} options The option object.
+	 * @param {Object} [options.visitorKeys=DEFAULT_VISITOR_KEYS] The keys of each node types to traverse child nodes. Default is `./default-visitor-keys.json`.
+	 * @param {Function} [options.enter=noop] The callback function which is called on entering each node.
+	 * @param {Function} [options.leave=noop] The callback function which is called on leaving each node.
+	 * @returns {void}
+	 */
+	traverse(node, options) {
+		this._current = null;
+		this._parents = [];
+		this._skipped = false;
+		this._broken = false;
+		this._visitorKeys = options.visitorKeys || vk.KEYS;
+		this._enter = options.enter || noop;
+		this._leave = options.leave || noop;
+		this._traverse(node, null);
+	}
+
+	/**
+	 * Traverse the given AST tree recursively.
+	 * @param {ASTNode} node The current node.
+	 * @param {ASTNode|null} parent The parent node.
+	 * @returns {void}
+	 * @private
+	 */
+	_traverse(node, parent) {
+		if (!isNode(node)) {
+			return;
+		}
+
+		this._current = node;
+		this._skipped = false;
+		this._enter(node, parent);
+
+		if (!this._skipped && !this._broken) {
+			const keys = getVisitorKeys(this._visitorKeys, node);
+
+			if (keys.length >= 1) {
+				this._parents.push(node);
+				for (let i = 0; i < keys.length && !this._broken; ++i) {
+					const child = node[keys[i]];
+
+					if (Array.isArray(child)) {
+						for (
+							let j = 0;
+							j < child.length && !this._broken;
+							++j
+						) {
+							this._traverse(child[j], node);
+						}
+					} else {
+						this._traverse(child, node);
+					}
+				}
+				this._parents.pop();
+			}
+		}
+
+		if (!this._broken) {
+			this._leave(node, parent);
+		}
+
+		this._current = parent;
+	}
+
+	/**
+	 * Calculates the keys to use for traversal.
+	 * @param {ASTNode} node The node to read keys from.
+	 * @returns {string[]} An array of keys to visit on the node.
+	 * @private
+	 */
+	static getKeys(node) {
+		return vk.getKeys(node);
+	}
+
+	/**
+	 * Traverse the given AST tree.
+	 * @param {ASTNode} node The root node to traverse.
+	 * @param {Object} options The option object.
+	 * @param {Object} [options.visitorKeys=DEFAULT_VISITOR_KEYS] The keys of each node types to traverse child nodes. Default is `./default-visitor-keys.json`.
+	 * @param {Function} [options.enter=noop] The callback function which is called on entering each node.
+	 * @param {Function} [options.leave=noop] The callback function which is called on leaving each node.
+	 * @returns {void}
+	 */
+	static traverse(node, options) {
+		new Traverser().traverse(node, options);
+	}
+
+	/**
+	 * The default visitor keys.
+	 * @type {Object}
+	 */
+	static get DEFAULT_VISITOR_KEYS() {
+		return vk.KEYS;
+	}
 }
 
 module.exports = Traverser;

package/lib/shared/types.js

@@ -124,6 +124,10 @@ module.exports = {};
  * @property {Array<{desc?: string, messageId?: string, fix: {range: [number, number], text: string}}>} [suggestions] Information for suggestions.
  */
 
+/**
+ * @typedef {Record<string, Record<string, { count: number }>>} SuppressedViolations
+ */
+
 /**
  * @typedef {Object} SuggestionResult
  * @property {string} desc A short description.
@@ -162,25 +166,6 @@ module.exports = {};
  * @property {{ name?: string, url?: string }} [rule] Name and information of the replacement rule
  */
 
-/**
- * @typedef {Object} RuleMeta
- * @property {boolean|DeprecatedInfo} [deprecated] If `true` then the rule has been deprecated.
- * @property {Array} [defaultOptions] Default options for the rule.
- * @property {RuleMetaDocs} docs The document information of the rule.
- * @property {"code"|"whitespace"} [fixable] The autofix type.
- * @property {boolean} [hasSuggestions] If `true` then the rule provides suggestions.
- * @property {Record<string,string>} [messages] The messages the rule reports.
- * @property {string[]} [replacedBy] The IDs of the alternative rules.
- * @property {Array|Object} schema The option schema of the rule.
- * @property {"problem"|"suggestion"|"layout"} type The rule type.
- */
-
-/**
- * @typedef {Object} Rule
- * @property {Function} create The factory of the rule.
- * @property {RuleMeta} meta The meta data of the rule.
- */
-
 /**
  * @typedef {Object} Plugin
  * @property {Record<string, ConfigData>} [configs] The definition of plugin configs.
@@ -259,11 +244,3 @@ module.exports = {};
  * @typedef {Object} ResultsMeta
  * @property {MaxWarningsExceeded} [maxWarningsExceeded] Present if the maxWarnings threshold was exceeded.
  */
-
-/**
- * A formatter function.
- * @callback FormatterFunction
- * @param {LintResult[]} results The list of linting results.
- * @param {{cwd: string, maxWarningsExceeded?: MaxWarningsExceeded, rulesMeta: Record<string, RuleMeta>}} context A context object.
- * @returns {string | Promise<string>} Formatted text.
- */