eslint 9.24.0 → 9.25.1

package/README.md

@@ -319,10 +319,11 @@ Percy Ma
 The following companies, organizations, and individuals support ESLint's ongoing maintenance and development. [Become a Sponsor](https://eslint.org/donate)
 to get your logo on our READMEs and [website](https://eslint.org/sponsors).
 
-<h3>Platinum Sponsors</h3>
+<h3>Diamond Sponsors</h3>
+<p><a href="https://www.ag-grid.com/"><img src="https://images.opencollective.com/ag-grid/2c8d545/logo.png" alt="AG Grid" height="128"></a></p><h3>Platinum Sponsors</h3>
 <p><a href="https://automattic.com"><img src="https://images.opencollective.com/automattic/d0ef3e1/logo.png" alt="Automattic" height="128"></a> <a href="https://www.airbnb.com/"><img src="https://images.opencollective.com/airbnb/d327d66/logo.png" alt="Airbnb" height="128"></a></p><h3>Gold Sponsors</h3>
-<p><a href="https://qlty.sh/"><img src="https://images.opencollective.com/qltysh/33d157d/logo.png" alt="Qlty Software" height="96"></a> <a href="https://trunk.io/"><img src="https://images.opencollective.com/trunkio/fb92d60/avatar.png" alt="trunk.io" height="96"></a></p><h3>Silver Sponsors</h3>
-<p><a href="https://vite.dev/"><img src="https://images.opencollective.com/vite/e6d15e1/logo.png" alt="Vite" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/5c4fa84/logo.png" alt="Liftoff" height="64"></a> <a href="https://stackblitz.com"><img src="https://avatars.githubusercontent.com/u/28635252" alt="StackBlitz" height="64"></a></p><h3>Bronze Sponsors</h3>
+<p><a href="https://qlty.sh/"><img src="https://images.opencollective.com/qltysh/33d157d/logo.png" alt="Qlty Software" height="96"></a> <a href="https://trunk.io/"><img src="https://images.opencollective.com/trunkio/fb92d60/avatar.png" alt="trunk.io" height="96"></a> <a href="https://shopify.engineering/"><img src="https://avatars.githubusercontent.com/u/8085" alt="Shopify" height="96"></a></p><h3>Silver Sponsors</h3>
+<p><a href="https://vite.dev/"><img src="https://images.opencollective.com/vite/e6d15e1/logo.png" alt="Vite" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/5c4fa84/logo.png" alt="Liftoff" height="64"></a> <a href="https://americanexpress.io"><img src="https://avatars.githubusercontent.com/u/3853301" alt="American Express" height="64"></a> <a href="https://stackblitz.com"><img src="https://avatars.githubusercontent.com/u/28635252" alt="StackBlitz" height="64"></a></p><h3>Bronze Sponsors</h3>
 <p><a href="https://cybozu.co.jp/"><img src="https://images.opencollective.com/cybozu/933e46d/logo.png" alt="Cybozu" height="32"></a> <a href="https://www.crosswordsolver.org/anagram-solver/"><img src="https://images.opencollective.com/anagram-solver/2666271/logo.png" alt="Anagram Solver" height="32"></a> <a href="https://icons8.com/"><img src="https://images.opencollective.com/icons8/7fa1641/logo.png" alt="Icons8" height="32"></a> <a href="https://discord.com"><img src="https://images.opencollective.com/discordapp/f9645d9/logo.png" alt="Discord" height="32"></a> <a href="https://www.gitbook.com"><img src="https://avatars.githubusercontent.com/u/7111340" alt="GitBook" height="32"></a> <a href="https://nolebase.ayaka.io"><img src="https://avatars.githubusercontent.com/u/11081491" alt="Neko" height="32"></a> <a href="https://nx.dev"><img src="https://avatars.githubusercontent.com/u/23692104" alt="Nx" height="32"></a> <a href="https://opensource.mercedes-benz.com/"><img src="https://avatars.githubusercontent.com/u/34240465" alt="Mercedes-Benz Group" height="32"></a> <a href="https://herocoders.com"><img src="https://avatars.githubusercontent.com/u/37549774" alt="HeroCoders" height="32"></a> <a href="https://www.lambdatest.com"><img src="https://avatars.githubusercontent.com/u/171592363" alt="LambdaTest" height="32"></a></p>
 <h3>Technology Sponsors</h3>
 Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.

package/lib/cli-engine/formatters/html.js

@@ -182,7 +182,7 @@ function pageTemplate(it) {
 /**
  * Given a word and a count, append an s if count is not one.
  * @param {string} word A word in its singular form.
- * @param {int} count A number controlling whether word should be pluralized.
+ * @param {number} count A number controlling whether word should be pluralized.
  * @returns {string} The original word with an s on the end if count is not one.
  */
 function pluralize(word, count) {
@@ -209,7 +209,7 @@ function renderSummary(totalErrors, totalWarnings) {
  * Get the color based on whether there are errors/warnings...
  * @param {string} totalErrors Total errors
  * @param {string} totalWarnings Total warnings
- * @returns {int} The color code (0 = green, 1 = yellow, 2 = red)
+ * @returns {number} The color code (0 = green, 1 = yellow, 2 = red)
  */
 function renderColor(totalErrors, totalWarnings) {
 	if (totalErrors !== 0) {
@@ -253,7 +253,7 @@ function messageTemplate(it) {
 /**
  * Get HTML (table rows) describing the messages.
  * @param {Array} messages Messages.
- * @param {int} parentIndex Index of the parent HTML row.
+ * @param {number} parentIndex Index of the parent HTML row.
  * @param {Object} rulesMeta Dictionary containing metadata for each rule executed by the analysis.
  * @returns {string} HTML (table rows) describing the messages.
  */

package/lib/cli-engine/formatters/stylish.js

@@ -15,7 +15,7 @@ const chalk = require("chalk"),
 /**
  * Given a word and a count, append an s if count is not one.
  * @param {string} word A word in its singular form.
- * @param {int} count A number controlling whether word should be pluralized.
+ * @param {number} count A number controlling whether word should be pluralized.
  * @returns {string} The original word with an s on the end if count is not one.
  */
 function pluralize(word, count) {

package/lib/languages/js/source-code/source-code.js

@@ -511,8 +511,8 @@ class SourceCode extends TokenStore {
 	/**
 	 * Gets the source code for the given node.
 	 * @param {ASTNode} [node] The AST node to get the text for.
-	 * @param {int} [beforeCount] The number of characters before the node to retrieve.
-	 * @param {int} [afterCount] The number of characters after the node to retrieve.
+	 * @param {number} [beforeCount] The number of characters before the node to retrieve.
+	 * @param {number} [afterCount] The number of characters after the node to retrieve.
 	 * @returns {string} The text representing the AST node.
 	 * @public
 	 */
@@ -627,7 +627,7 @@ class SourceCode extends TokenStore {
 
 	/**
 	 * Gets the deepest node containing a range index.
-	 * @param {int} index Range index of the desired node.
+	 * @param {number} index Range index of the desired node.
 	 * @returns {ASTNode} The node if found or null if not found.
 	 * @public
 	 */

package/lib/languages/js/source-code/token-store/index.js

@@ -605,8 +605,8 @@ module.exports = class TokenStore {
 	/**
 	 * Gets all tokens that are related to the given node.
 	 * @param {ASTNode} node The AST node.
-	 * @param {int} [beforeCount=0] The number of tokens before the node to retrieve.
-	 * @param {int} [afterCount=0] The number of tokens after the node to retrieve.
+	 * @param {number} [beforeCount=0] The number of tokens before the node to retrieve.
+	 * @param {number} [afterCount=0] The number of tokens after the node to retrieve.
 	 * @returns {Token[]} Array of objects representing tokens.
 	 */
 	getTokens(node, beforeCount, afterCount) {
@@ -635,7 +635,7 @@ module.exports = class TokenStore {
 	 * Gets all of the tokens between two non-overlapping nodes.
 	 * @param {ASTNode|Token|Comment} left Node before the desired token range.
 	 * @param {ASTNode|Token|Comment} right Node after the desired token range.
-	 * @param {int} [padding=0] Number of extra tokens on either side of center.
+	 * @param {number} [padding=0] Number of extra tokens on either side of center.
 	 * @returns {Token[]} Tokens between left and right.
 	 */
 	getTokensBetween(left, right, padding) {

package/lib/linter/node-event-generator.js

@@ -346,11 +346,13 @@ class NodeEventGenerator {
 	 * @returns {void}
 	 */
 	applySelectors(node, isExit) {
+		const nodeTypeKey = this.esqueryOptions?.nodeTypeKey || "type";
+
 		const selectorsByNodeType =
 			(isExit
 				? this.exitSelectorsByNodeType
 				: this.enterSelectorsByNodeType
-			).get(node.type) || [];
+			).get(node[nodeTypeKey]) || [];
 		const anyTypeSelectors = isExit
 			? this.anyTypeExitSelectors
 			: this.anyTypeEnterSelectors;

package/lib/linter/report-translator.js

@@ -133,7 +133,7 @@ function assertValidFix(fix) {
  * Compares items in a fixes array by range.
  * @param {Fix} a The first message.
  * @param {Fix} b The second message.
- * @returns {int} -1 if a comes before b, 1 if a comes after b, 0 if equal.
+ * @returns {number} -1 if a comes before b, 1 if a comes after b, 0 if equal.
  * @private
  */
 function compareFixesByRange(a, b) {

package/lib/linter/rule-fixer.js

@@ -4,6 +4,14 @@
  */
 "use strict";
 
+//------------------------------------------------------------------------------
+// Typedefs
+//------------------------------------------------------------------------------
+
+/**
+ * @import { SourceRange } from "@eslint/core";
+ */
+
 /* eslint class-methods-use-this: off -- Methods desired on instance */
 
 //------------------------------------------------------------------------------
@@ -18,7 +26,7 @@
 
 /**
  * Creates a fix command that inserts text at the specified index in the source text.
- * @param {int} index The 0-based index at which to insert the new text.
+ * @param {number} index The 0-based index at which to insert the new text.
  * @param {string} text The text to insert.
  * @returns {Object} The fix command.
  * @private
@@ -69,7 +77,7 @@ class RuleFixer {
 	/**
 	 * Creates a fix command that inserts text after the specified range in the source text.
 	 * The fix is not applied until applyFixes() is called.
-	 * @param {int[]} range The range to replace, first item is start of range, second
+	 * @param {SourceRange} range The range to replace, first item is start of range, second
 	 *      is end of range.
 	 * @param {string} text The text to insert.
 	 * @returns {Object} The fix command.
@@ -94,7 +102,7 @@ class RuleFixer {
 	/**
 	 * Creates a fix command that inserts text before the specified range in the source text.
 	 * The fix is not applied until applyFixes() is called.
-	 * @param {int[]} range The range to replace, first item is start of range, second
+	 * @param {SourceRange} range The range to replace, first item is start of range, second
 	 *      is end of range.
 	 * @param {string} text The text to insert.
 	 * @returns {Object} The fix command.
@@ -119,7 +127,7 @@ class RuleFixer {
 	/**
 	 * Creates a fix command that replaces text at the specified range in the source text.
 	 * The fix is not applied until applyFixes() is called.
-	 * @param {int[]} range The range to replace, first item is start of range, second
+	 * @param {SourceRange} range The range to replace, first item is start of range, second
 	 *      is end of range.
 	 * @param {string} text The text to insert.
 	 * @returns {Object} The fix command.
@@ -146,7 +154,7 @@ class RuleFixer {
 	/**
 	 * Creates a fix command that removes the specified range of text from the source.
 	 * The fix is not applied until applyFixes() is called.
-	 * @param {int[]} range The range to remove, first item is start of range, second
+	 * @param {SourceRange} range The range to remove, first item is start of range, second
 	 *      is end of range.
 	 * @returns {Object} The fix command.
 	 */

package/lib/linter/source-code-fixer.js

@@ -20,7 +20,7 @@ const BOM = "\uFEFF";
  * Compares items in a messages array by range.
  * @param {Message} a The first message.
  * @param {Message} b The second message.
- * @returns {int} -1 if a comes before b, 1 if a comes after b, 0 if equal.
+ * @returns {number} -1 if a comes before b, 1 if a comes after b, 0 if equal.
  * @private
  */
 function compareMessagesByFixRange(a, b) {
@@ -31,7 +31,7 @@ function compareMessagesByFixRange(a, b) {
  * Compares items in a messages array by line and column.
  * @param {Message} a The first message.
  * @param {Message} b The second message.
- * @returns {int} -1 if a comes before b, 1 if a comes after b, 0 if equal.
+ * @returns {number} -1 if a comes before b, 1 if a comes after b, 0 if equal.
  * @private
  */
 function compareMessagesByLocation(a, b) {

package/lib/linter/timing.js

@@ -15,7 +15,7 @@ const { startTime, endTime } = require("../shared/stats");
 /**
  * Align the string to left
  * @param {string} str string to evaluate
- * @param {int} len length of the string
+ * @param {number} len length of the string
  * @param {string} ch delimiter character
  * @returns {string} modified string
  * @private
@@ -28,7 +28,7 @@ function alignLeft(str, len, ch) {
 /**
  * Align the string to right
  * @param {string} str string to evaluate
- * @param {int} len length of the string
+ * @param {number} len length of the string
  * @param {string} ch delimiter character
  * @returns {string} modified string
  * @private

package/lib/rules/for-direction.js

@@ -54,8 +54,8 @@ module.exports = {
 		/**
 		 * check the right side of the assignment
 		 * @param {ASTNode} update UpdateExpression to check
-		 * @param {int} dir expected direction that could either be turned around or invalidated
-		 * @returns {int} return dir, the negated dir, or zero if the counter does not change or the direction is not clear
+		 * @param {number} dir expected direction that could either be turned around or invalidated
+		 * @returns {number} return dir, the negated dir, or zero if the counter does not change or the direction is not clear
 		 */
 		function getRightDirection(update, dir) {
 			const staticValue = getStaticValue(
@@ -80,7 +80,7 @@ module.exports = {
 		 * check UpdateExpression add/sub the counter
 		 * @param {ASTNode} update UpdateExpression to check
 		 * @param {string} counter variable name to check
-		 * @returns {int} if add return 1, if sub return -1, if nochange, return 0
+		 * @returns {number} if add return 1, if sub return -1, if nochange, return 0
 		 */
 		function getUpdateDirection(update, counter) {
 			if (
@@ -101,7 +101,7 @@ module.exports = {
 		 * check AssignmentExpression add/sub the counter
 		 * @param {ASTNode} update AssignmentExpression to check
 		 * @param {string} counter variable name to check
-		 * @returns {int} if add return 1, if sub return -1, if nochange, return 0
+		 * @returns {number} if add return 1, if sub return -1, if nochange, return 0
 		 */
 		function getAssignmentDirection(update, counter) {
 			if (update.left.name === counter) {

package/lib/rules/func-name-matching.js

@@ -49,7 +49,7 @@ function isModuleExports(pattern) {
 /**
  * Determines if a string name is a valid identifier
  * @param {string} name The string to be checked
- * @param {int} ecmaVersion The ECMAScript version if specified in the parserOptions config
+ * @param {number} ecmaVersion The ECMAScript version if specified in the parserOptions config
  * @returns {boolean} True if the string is a valid identifier
  */
 function isIdentifier(name, ecmaVersion) {

package/lib/rules/indent-legacy.js

@@ -302,9 +302,9 @@ module.exports = {
 
 		/**
 		 * Creates an error message for a line, given the expected/actual indentation.
-		 * @param {int} expectedAmount The expected amount of indentation characters for this line
-		 * @param {int} actualSpaces The actual number of indentation spaces that were found on this line
-		 * @param {int} actualTabs The actual number of indentation tabs that were found on this line
+		 * @param {number} expectedAmount The expected amount of indentation characters for this line
+		 * @param {number} actualSpaces The actual number of indentation spaces that were found on this line
+		 * @param {number} actualTabs The actual number of indentation tabs that were found on this line
 		 * @returns {string} An error message for this line
 		 */
 		function createErrorMessageData(
@@ -345,9 +345,9 @@ module.exports = {
 		/**
 		 * Reports a given indent violation
 		 * @param {ASTNode} node Node violating the indent rule
-		 * @param {int} needed Expected indentation character count
-		 * @param {int} gottenSpaces Indentation space count in the actual node/code
-		 * @param {int} gottenTabs Indentation tab count in the actual node/code
+		 * @param {number} needed Expected indentation character count
+		 * @param {number} gottenSpaces Indentation space count in the actual node/code
+		 * @param {number} gottenTabs Indentation tab count in the actual node/code
 		 * @param {Object} [loc] Error line and column location
 		 * @param {boolean} isLastNodeCheck Is the error for last node check
 		 * @returns {void}
@@ -449,7 +449,7 @@ module.exports = {
 		/**
 		 * Check indent for node
 		 * @param {ASTNode} node Node to check
-		 * @param {int} neededIndent needed indent
+		 * @param {number} neededIndent needed indent
 		 * @returns {void}
 		 */
 		function checkNodeIndent(node, neededIndent) {
@@ -502,7 +502,7 @@ module.exports = {
 		/**
 		 * Check indent for nodes list
 		 * @param {ASTNode[]} nodes list of node objects
-		 * @param {int} indent needed indent
+		 * @param {number} indent needed indent
 		 * @returns {void}
 		 */
 		function checkNodesIndent(nodes, indent) {
@@ -512,7 +512,7 @@ module.exports = {
 		/**
 		 * Check last node line indent this detects, that block closed correctly
 		 * @param {ASTNode} node Node to examine
-		 * @param {int} lastLineIndent needed indent
+		 * @param {number} lastLineIndent needed indent
 		 * @returns {void}
 		 */
 		function checkLastNodeLineIndent(node, lastLineIndent) {
@@ -542,7 +542,7 @@ module.exports = {
 		 * Check last node line indent this detects, that block closed correctly
 		 * This function for more complicated return statement case, where closing parenthesis may be followed by ';'
 		 * @param {ASTNode} node Node to examine
-		 * @param {int} firstLineIndent first line needed indent
+		 * @param {number} firstLineIndent first line needed indent
 		 * @returns {void}
 		 */
 		function checkLastReturnStatementLineIndent(node, firstLineIndent) {
@@ -583,7 +583,7 @@ module.exports = {
 		/**
 		 * Check first node line indent is correct
 		 * @param {ASTNode} node Node to examine
-		 * @param {int} firstLineIndent needed indent
+		 * @param {number} firstLineIndent needed indent
 		 * @returns {void}
 		 */
 		function checkFirstNodeLineIndent(node, firstLineIndent) {
@@ -1130,8 +1130,8 @@ module.exports = {
 		/**
 		 * Returns the expected indentation for the case statement
 		 * @param {ASTNode} node node to examine
-		 * @param {int} [providedSwitchIndent] indent for switch statement
-		 * @returns {int} indent size
+		 * @param {number} [providedSwitchIndent] indent for switch statement
+		 * @returns {number} indent size
 		 */
 		function expectedCaseIndent(node, providedSwitchIndent) {
 			const switchNode =

package/lib/rules/indent.js

@@ -743,9 +743,9 @@ module.exports = {
 
 		/**
 		 * Creates an error message for a line, given the expected/actual indentation.
-		 * @param {int} expectedAmount The expected amount of indentation characters for this line
-		 * @param {int} actualSpaces The actual number of indentation spaces that were found on this line
-		 * @param {int} actualTabs The actual number of indentation tabs that were found on this line
+		 * @param {number} expectedAmount The expected amount of indentation characters for this line
+		 * @param {number} actualSpaces The actual number of indentation spaces that were found on this line
+		 * @param {number} actualTabs The actual number of indentation tabs that were found on this line
 		 * @returns {string} An error message for this line
 		 */
 		function createErrorMessageData(

package/lib/rules/key-spacing.js

@@ -489,7 +489,7 @@ module.exports = {
 		 * @param {ASTNode} property Key-value pair in an object literal.
 		 * @param {string} side Side being verified - either "key" or "value".
 		 * @param {string} whitespace Actual whitespace string.
-		 * @param {int} expected Expected whitespace length.
+		 * @param {number} expected Expected whitespace length.
 		 * @param {string} mode Value of the mode as "strict" or "minimum"
 		 * @returns {void}
 		 */
@@ -591,7 +591,7 @@ module.exports = {
 		 * Gets the number of characters in a key, including quotes around string
 		 * keys and braces around computed property keys.
 		 * @param {ASTNode} property Property of on object literal.
-		 * @returns {int} Width of the key.
+		 * @returns {number} Width of the key.
 		 */
 		function getKeyWidth(property) {
 			const startToken = sourceCode.getFirstToken(property);

package/lib/rules/linebreak-style.js

@@ -6,6 +6,14 @@
 
 "use strict";
 
+//------------------------------------------------------------------------------
+// Typedefs
+//------------------------------------------------------------------------------
+
+/**
+ * @import { SourceRange } from "@eslint/core";
+ */
+
 //------------------------------------------------------------------------------
 // Requirements
 //------------------------------------------------------------------------------
@@ -70,7 +78,7 @@ module.exports = {
 
 		/**
 		 * Builds a fix function that replaces text at the specified range in the source text.
-		 * @param {int[]} range The range to replace
+		 * @param {SourceRange} range The range to replace
 		 * @param {string} text The text to insert.
 		 * @returns {Function} Fixer function
 		 * @private

package/lib/rules/max-len.js

@@ -125,8 +125,8 @@ module.exports = {
 		 * Computes the length of a line that may contain tabs. The width of each
 		 * tab will be the number of spaces to the next tab stop.
 		 * @param {string} line The line.
-		 * @param {int} tabWidth The width of each tab stop in spaces.
-		 * @returns {int} The computed line length.
+		 * @param {number} tabWidth The width of each tab stop in spaces.
+		 * @returns {number} The computed line length.
 		 * @private
 		 */
 		function computeLineLength(line, tabWidth) {

package/lib/rules/max-statements.js

@@ -92,8 +92,8 @@ module.exports = {
 		/**
 		 * Reports a node if it has too many statements
 		 * @param {ASTNode} node node to evaluate
-		 * @param {int} count Number of statements in node
-		 * @param {int} max Maximum number of statements allowed
+		 * @param {number} count Number of statements in node
+		 * @param {number} max Maximum number of statements allowed
 		 * @returns {void}
 		 * @private
 		 */

package/lib/rules/no-empty-function.js

@@ -26,6 +26,10 @@ const ALLOW_OPTIONS = Object.freeze([
 	"constructors",
 	"asyncFunctions",
 	"asyncMethods",
+	"privateConstructors",
+	"protectedConstructors",
+	"decoratedFunctions",
+	"overrideMethods",
 ]);
 
 /**
@@ -83,6 +87,15 @@ function getKind(node) {
 	return prefix + kind[0].toUpperCase() + kind.slice(1);
 }
 
+/**
+ * Checks if a constructor function has parameter properties.
+ * @param {ASTNode} node The function node to examine.
+ * @returns {boolean} True if the constructor has parameter properties, false otherwise.
+ */
+function isParameterPropertiesConstructor(node) {
+	return node.params.some(param => param.type === "TSParameterProperty");
+}
+
 //------------------------------------------------------------------------------
 // Rule Definition
 //------------------------------------------------------------------------------
@@ -90,6 +103,8 @@ function getKind(node) {
 /** @type {import('../types').Rule.RuleModule} */
 module.exports = {
 	meta: {
+		dialects: ["javascript", "typescript"],
+		language: "javascript",
 		type: "suggestion",
 
 		defaultOptions: [{ allow: [] }],
@@ -123,6 +138,43 @@ module.exports = {
 		const [{ allow }] = context.options;
 		const sourceCode = context.sourceCode;
 
+		/**
+		 * Checks if the given function node is allowed to be empty.
+		 * @param {ASTNode} node The function node to check.
+		 * @returns {boolean} True if the function is allowed to be empty, false otherwise.
+		 */
+		function isAllowedEmptyFunction(node) {
+			const kind = getKind(node);
+
+			if (allow.includes(kind)) {
+				return true;
+			}
+
+			if (kind === "constructors") {
+				if (
+					(node.parent.accessibility === "private" &&
+						allow.includes("privateConstructors")) ||
+					(node.parent.accessibility === "protected" &&
+						allow.includes("protectedConstructors")) ||
+					isParameterPropertiesConstructor(node)
+				) {
+					return true;
+				}
+			}
+
+			if (/(g|s)etters|methods$/iu.test(kind)) {
+				if (
+					(node.parent.decorators?.length &&
+						allow.includes("decoratedFunctions")) ||
+					(node.parent.override && allow.includes("overrideMethods"))
+				) {
+					return true;
+				}
+			}
+
+			return false;
+		}
+
 		/**
 		 * Reports a given function node if the node matches the following patterns.
 		 *
@@ -135,7 +187,6 @@ module.exports = {
 		 * @returns {void}
 		 */
 		function reportIfEmpty(node) {
-			const kind = getKind(node);
 			const name = astUtils.getFunctionNameWithKind(node);
 			const innerComments = sourceCode.getTokens(node.body, {
 				includeComments: true,
@@ -143,7 +194,7 @@ module.exports = {
 			});
 
 			if (
-				!allow.includes(kind) &&
+				!isAllowedEmptyFunction(node) &&
 				node.body.type === "BlockStatement" &&
 				node.body.body.length === 0 &&
 				innerComments.length === 0

package/lib/rules/no-global-assign.js

@@ -50,7 +50,7 @@ module.exports = {
 		/**
 		 * Reports write references.
 		 * @param {Reference} reference A reference to check.
-		 * @param {int} index The index of the reference in the references.
+		 * @param {number} index The index of the reference in the references.
 		 * @param {Reference[]} references The array that the reference belongs to.
 		 * @returns {void}
 		 */

package/lib/rules/no-invalid-this.js

@@ -36,6 +36,8 @@ function isCodePathWithLexicalThis(codePath, node) {
 /** @type {import('../types').Rule.RuleModule} */
 module.exports = {
 	meta: {
+		dialects: ["javascript", "typescript"],
+		language: "javascript",
 		type: "suggestion",
 
 		defaultOptions: [{ capIsConstructor: true }],
@@ -140,8 +142,28 @@ module.exports = {
 				stack.pop();
 			},
 
+			"AccessorProperty > *.value"(node) {
+				stack.push({
+					init: true,
+					node,
+					valid: true,
+				});
+			},
+
+			"AccessorProperty:exit"() {
+				stack.pop();
+			},
+
 			// Reports if `this` of the current context is invalid.
 			ThisExpression(node) {
+				// Special case: skip `this` if it's the value of an AccessorProperty
+				if (
+					node.parent.type === "AccessorProperty" &&
+					node.parent.value === node
+				) {
+					return;
+				}
+
 				const current = stack.getCurrent();
 
 				if (current && !current.valid) {

package/lib/rules/no-loop-func.js

@@ -32,6 +32,8 @@ function isIIFE(node) {
 module.exports = {
 	meta: {
 		type: "suggestion",
+		dialects: ["typescript", "javascript"],
+		language: "javascript",
 
 		docs: {
 			description:

package/lib/rules/no-native-reassign.js

@@ -65,7 +65,7 @@ module.exports = {
 		/**
 		 * Reports write references.
 		 * @param {Reference} reference A reference to check.
-		 * @param {int} index The index of the reference in the references.
+		 * @param {number} index The index of the reference in the references.
 		 * @param {Reference[]} references The array that the reference belongs to.
 		 * @returns {void}
 		 */

package/lib/rules/no-nonoctal-decimal-escape.js

@@ -5,6 +5,14 @@
 
 "use strict";
 
+//------------------------------------------------------------------------------
+// Typedefs
+//------------------------------------------------------------------------------
+
+/**
+ * @import { SourceRange } from "@eslint/core";
+ */
+
 //------------------------------------------------------------------------------
 // Helpers
 //------------------------------------------------------------------------------
@@ -57,7 +65,7 @@ module.exports = {
 		/**
 		 * Creates a new Suggestion object.
 		 * @param {string} messageId "refactor" or "escapeBackslash".
-		 * @param {int[]} range The range to replace.
+		 * @param {SourceRange} range The range to replace.
 		 * @param {string} replacement New text for the range.
 		 * @returns {Object} Suggestion
 		 */

package/lib/rules/no-param-reassign.js

@@ -182,7 +182,7 @@ module.exports = {
 		/**
 		 * Reports a reference if is non initializer and writable.
 		 * @param {Reference} reference A reference to check.
-		 * @param {int} index The index of the reference in the references.
+		 * @param {number} index The index of the reference in the references.
 		 * @param {Reference[]} references The array that the reference belongs to.
 		 * @returns {void}
 		 */

package/lib/rules/no-restricted-properties.js

@@ -25,41 +25,37 @@ module.exports = {
 		schema: {
 			type: "array",
 			items: {
+				type: "object",
+				properties: {
+					object: {
+						type: "string",
+					},
+					property: {
+						type: "string",
+					},
+					allowObjects: {
+						type: "array",
+						items: {
+							type: "string",
+						},
+						uniqueItems: true,
+					},
+					message: {
+						type: "string",
+					},
+				},
 				anyOf: [
-					// `object` and `property` are both optional, but at least one of them must be provided.
 					{
-						type: "object",
-						properties: {
-							object: {
-								type: "string",
-							},
-							property: {
-								type: "string",
-							},
-							message: {
-								type: "string",
-							},
-						},
-						additionalProperties: false,
 						required: ["object"],
 					},
 					{
-						type: "object",
-						properties: {
-							object: {
-								type: "string",
-							},
-							property: {
-								type: "string",
-							},
-							message: {
-								type: "string",
-							},
-						},
-						additionalProperties: false,
 						required: ["property"],
 					},
 				],
+				not: {
+					required: ["allowObjects", "object"],
+				},
+				additionalProperties: false,
 			},
 			uniqueItems: true,
 		},
@@ -91,6 +87,7 @@ module.exports = {
 
 			if (typeof objectName === "undefined") {
 				globallyRestrictedProperties.set(propertyName, {
+					allowObjects: option.allowObjects,
 					message: option.message,
 				});
 			} else if (typeof propertyName === "undefined") {
@@ -108,6 +105,20 @@ module.exports = {
 			}
 		});
 
+		/**
+		 * Checks if an object name is in the allowed objects list.
+		 * @param {string} objectName The name of the object to check
+		 * @param {string[]} [allowObjects] The list of objects to allow
+		 * @returns {boolean} True if the object is allowed, false otherwise
+		 */
+		function isAllowedObject(objectName, allowObjects) {
+			if (!allowObjects) {
+				return false;
+			}
+
+			return allowObjects.includes(objectName);
+		}
+
 		/**
 		 * Checks to see whether a property access is restricted, and reports it if so.
 		 * @param {ASTNode} node The node to report
@@ -140,7 +151,10 @@ module.exports = {
 						message,
 					},
 				});
-			} else if (globalMatchedProperty) {
+			} else if (
+				globalMatchedProperty &&
+				!isAllowedObject(objectName, globalMatchedProperty.allowObjects)
+			) {
 				const message = globalMatchedProperty.message
 					? ` ${globalMatchedProperty.message}`
 					: "";

package/lib/rules/no-return-await.js

@@ -30,7 +30,6 @@ module.exports = {
 		deprecated: {
 			message:
 				"The original assumption of the rule no longer holds true because of engine optimization.",
-			url: "https://eslint.org/docs/latest/rules/no-return-await",
 			deprecatedSince: "8.46.0",
 			availableUntil: null,
 			replacedBy: [],

package/lib/rules/no-trailing-spaces.js

@@ -5,6 +5,14 @@
  */
 "use strict";
 
+//------------------------------------------------------------------------------
+// Typedefs
+//------------------------------------------------------------------------------
+
+/**
+ * @import { SourceLocation, SourceRange } from "@eslint/core";
+ */
+
 //------------------------------------------------------------------------------
 // Requirements
 //------------------------------------------------------------------------------
@@ -85,8 +93,8 @@ module.exports = {
 		/**
 		 * Report the error message
 		 * @param {ASTNode} node node to report
-		 * @param {int[]} location range information
-		 * @param {int[]} fixRange Range based on the whole program
+		 * @param {SourceLocation} location range information
+		 * @param {SourceRange} fixRange Range based on the whole program
 		 * @returns {void}
 		 */
 		function report(node, location, fixRange) {

package/lib/rules/no-unused-expressions.js

@@ -29,6 +29,8 @@ function alwaysFalse() {
 /** @type {import('../types').Rule.RuleModule} */
 module.exports = {
 	meta: {
+		dialects: ["javascript", "typescript"],
+		language: "javascript",
 		type: "suggestion",
 
 		docs: {
@@ -190,6 +192,19 @@ module.exports = {
 			UnaryExpression(node) {
 				return node.operator !== "void" && node.operator !== "delete";
 			},
+			// TypeScript-specific node types
+			TSAsExpression(node) {
+				return Checker.isDisallowed(node.expression);
+			},
+			TSTypeAssertion(node) {
+				return Checker.isDisallowed(node.expression);
+			},
+			TSNonNullExpression(node) {
+				return Checker.isDisallowed(node.expression);
+			},
+			TSInstantiationExpression(node) {
+				return Checker.isDisallowed(node.expression);
+			},
 		});
 
 		return {

package/lib/rules/prefer-reflect.js

@@ -22,7 +22,6 @@ module.exports = {
 
 		deprecated: {
 			message: "The original intention of this rule was misguided.",
-			url: "https://eslint.org/docs/latest/rules/prefer-reflect",
 			deprecatedSince: "3.9.0",
 			availableUntil: null,
 			replacedBy: [],

package/lib/rules/utils/ast-utils.js

@@ -65,7 +65,7 @@ const ECMASCRIPT_GLOBALS = globals[`es${LATEST_ECMA_VERSION}`];
 /**
  * Checks reference if is non initializer and writable.
  * @param {Reference} reference A reference to check.
- * @param {int} index The index of the reference in the references.
+ * @param {number} index The index of the reference in the references.
  * @param {Reference[]} references The array that the reference belongs to.
  * @returns {boolean} Success/Failure
  * @private
@@ -1088,13 +1088,13 @@ function isConstant(scope, node, inBooleanPosition) {
 }
 
 /**
- * Checks whether a node is an ExpressionStatement at the top level of a file or function body.
+ * Checks whether a node is an ExpressionStatement at the top level of a file, function body, or TypeScript module block.
  * A top-level ExpressionStatement node is a directive if it contains a single unparenthesized
  * string literal and if it occurs either as the first sibling or immediately after another
  * directive.
  * @param {ASTNode} node The node to check.
  * @returns {boolean} Whether or not the node is an ExpressionStatement at the top level of a
- * file or function body.
+ * file, function body, or TypeScript module block.
  */
 function isTopLevelExpressionStatement(node) {
 	if (node.type !== "ExpressionStatement") {
@@ -1104,6 +1104,7 @@ function isTopLevelExpressionStatement(node) {
 
 	return (
 		parent.type === "Program" ||
+		parent.type === "TSModuleBlock" ||
 		(parent.type === "BlockStatement" && isFunction(parent.parent))
 	);
 }
@@ -1488,6 +1489,17 @@ module.exports = {
 			return false;
 		}
 
+		// Check if the function has a parameter named `this`.
+		if (
+			(node.type === "FunctionDeclaration" ||
+				node.type === "FunctionExpression") &&
+			node.params.some(
+				param => param.type === "Identifier" && param.name === "this",
+			)
+		) {
+			return false;
+		}
+
 		if (
 			(capIsConstructor && isES5Constructor(node)) ||
 			hasJSDocThisTag(node, sourceCode)
@@ -1662,7 +1674,7 @@ module.exports = {
 	/**
 	 * Get the precedence level based on the node type
 	 * @param {ASTNode} node node to evaluate
-	 * @returns {int} precedence level
+	 * @returns {number} precedence level
 	 * @private
 	 */
 	getPrecedence(node) {

package/lib/rules/utils/fix-tracker.js

@@ -4,6 +4,14 @@
  */
 "use strict";
 
+//------------------------------------------------------------------------------
+// Typedefs
+//------------------------------------------------------------------------------
+
+/**
+ * @import { SourceRange } from "@eslint/core";
+ */
+
 //------------------------------------------------------------------------------
 // Requirements
 //------------------------------------------------------------------------------
@@ -34,7 +42,7 @@ class FixTracker {
 	/**
 	 * Mark the given range as "retained", meaning that other fixes may not
 	 * may not modify this region in the same pass.
-	 * @param {int[]} range The range to retain.
+	 * @param {SourceRange} range The range to retain.
 	 * @returns {FixTracker} The same RuleFixer, for chained calls.
 	 */
 	retainRange(range) {
@@ -79,7 +87,7 @@ class FixTracker {
 	/**
 	 * Create a fix command that replaces the given range with the given text,
 	 * accounting for any retained ranges.
-	 * @param {int[]} range The range to remove in the fix.
+	 * @param {SourceRange} range The range to remove in the fix.
 	 * @param {string} text The text to insert in place of the range.
 	 * @returns {Object} The fix command.
 	 */

package/lib/types/index.d.ts

@@ -1262,6 +1262,29 @@ export namespace Rule {
 	}
 }
 
+export type JSRuleDefinitionTypeOptions = {
+	RuleOptions: unknown[];
+	MessageIds: string;
+	ExtRuleDocs: Record<string, unknown>;
+};
+
+export type JSRuleDefinition<
+	Options extends Partial<JSRuleDefinitionTypeOptions> = {},
+> = RuleDefinition<
+	// Language specific type options (non-configurable)
+	{
+		LangOptions: Linter.LanguageOptions;
+		Code: SourceCode;
+		Visitor: Rule.NodeListener;
+		Node: ESTree.Node;
+	} & Required<
+		// Rule specific type options (custom)
+		Options &
+			// Rule specific type options (defaults)
+			Omit<JSRuleDefinitionTypeOptions, keyof Options>
+	>
+>;
+
 // #region Linter
 
 export class Linter {

package/lib/types/rules.d.ts

@@ -422,6 +422,15 @@ export interface ESLintRules extends Linter.RulesRecord {
 		[
 			Partial<{
 				exceptMethods: string[];
+				/**
+				 * @default true
+				 */
+				enforceForClassFields: boolean;
+				/**
+				 * @default false
+				 */
+				ignoreOverrideMethods: boolean;
+				ignoreClassesWithImplements: "all" | "public-fields";
 			}>,
 		]
 	>;
@@ -2350,6 +2359,10 @@ export interface ESLintRules extends Linter.RulesRecord {
 					| "constructors"
 					| "asyncFunctions"
 					| "asyncMethods"
+					| "privateConstructors"
+					| "protectedConstructors"
+					| "decoratedFunctions"
+					| "overrideMethods"
 				>;
 			}>,
 		]
@@ -3430,6 +3443,7 @@ export interface ESLintRules extends Linter.RulesRecord {
 				  }
 				| {
 						property: string;
+						allowObjects?: string[];
 						message?: string | undefined;
 				  }
 			>,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint",
-  "version": "9.24.0",
+  "version": "9.25.1",
   "author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
   "description": "An AST-based pattern checker for JavaScript.",
   "type": "commonjs",
@@ -107,11 +107,11 @@
     "@eslint-community/eslint-utils": "^4.2.0",
     "@eslint-community/regexpp": "^4.12.1",
     "@eslint/config-array": "^0.20.0",
-    "@eslint/config-helpers": "^0.2.0",
-    "@eslint/core": "^0.12.0",
+    "@eslint/config-helpers": "^0.2.1",
+    "@eslint/core": "^0.13.0",
     "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "9.24.0",
-    "@eslint/plugin-kit": "^0.2.7",
+    "@eslint/js": "9.25.1",
+    "@eslint/plugin-kit": "^0.2.8",
     "@humanfs/node": "^0.16.6",
     "@humanwhocodes/module-importer": "^1.0.1",
     "@humanwhocodes/retry": "^0.4.2",
@@ -146,7 +146,7 @@
     "@babel/preset-env": "^7.4.3",
     "@cypress/webpack-preprocessor": "^6.0.2",
     "@eslint/json": "^0.11.0",
-    "@trunkio/launcher": "^1.3.0",
+    "@trunkio/launcher": "^1.3.4",
     "@types/node": "^22.13.14",
     "@typescript-eslint/parser": "^8.4.0",
     "babel-loader": "^8.0.5",