@typescript-eslint/eslint-plugin 8.25.1-alpha.9 → 8.26.0

package/dist/configs/eslint-recommended-raw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslint-recommended-raw.d.ts","sourceRoot":"","sources":["../../src/configs/eslint-recommended-raw.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,QAAA,MAAM,MAAM,UACH,MAAM,GAAG,WAAW,KAC1B;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAiChD,CAAC;AAEH,SAAS,MAAM,CAAC"}
+{"version":3,"file":"eslint-recommended-raw.d.ts","sourceRoot":"","sources":["../../src/configs/eslint-recommended-raw.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,QAAA,MAAM,MAAM,GACV,OAAO,MAAM,GAAG,WAAW,KAC1B;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAiChD,CAAC;AAEH,SAAS,MAAM,CAAC"}

package/dist/rules/explicit-module-boundary-types.d.ts

@@ -5,6 +5,7 @@ export type Options = [
         allowedNames?: string[];
         allowHigherOrderFunctions?: boolean;
         allowTypedFunctionExpressions?: boolean;
+        allowOverloadFunctions?: boolean;
     }
 ];
 export type MessageIds = 'anyTypedArg' | 'anyTypedArgUnnamed' | 'missingArgType' | 'missingArgTypeUnnamed' | 'missingReturnType';

package/dist/rules/explicit-module-boundary-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explicit-module-boundary-types.d.ts","sourceRoot":"","sources":["../../src/rules/explicit-module-boundary-types.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,OAAO,GAAG;IACpB;QACE,kCAAkC,CAAC,EAAE,OAAO,CAAC;QAC7C,yCAAyC,CAAC,EAAE,OAAO,CAAC;QACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,yBAAyB,CAAC,EAAE,OAAO,CAAC;QACpC,6BAA6B,CAAC,EAAE,OAAO,CAAC;KACzC;CACF,CAAC;AACF,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,oBAAoB,GACpB,gBAAgB,GAChB,uBAAuB,GACvB,mBAAmB,CAAC;;AAExB,wBAmdG"}
+{"version":3,"file":"explicit-module-boundary-types.d.ts","sourceRoot":"","sources":["../../src/rules/explicit-module-boundary-types.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,OAAO,GAAG;IACpB;QACE,kCAAkC,CAAC,EAAE,OAAO,CAAC;QAC7C,yCAAyC,CAAC,EAAE,OAAO,CAAC;QACpD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,yBAAyB,CAAC,EAAE,OAAO,CAAC;QACpC,6BAA6B,CAAC,EAAE,OAAO,CAAC;QACxC,sBAAsB,CAAC,EAAE,OAAO,CAAC;KAClC;CACF,CAAC;AACF,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,oBAAoB,GACpB,gBAAgB,GAChB,uBAAuB,GACvB,mBAAmB,CAAC;;AAExB,wBAweG"}

package/dist/rules/explicit-module-boundary-types.js

@@ -48,6 +48,10 @@ exports.default = (0, util_1.createRule)({
                             'You must still type the parameters of the function.',
                         ].join('\n'),
                     },
+                    allowOverloadFunctions: {
+                        type: 'boolean',
+                        description: 'Whether to ignore return type annotations on functions with overload signatures.',
+                    },
                     allowTypedFunctionExpressions: {
                         type: 'boolean',
                         description: 'Whether to ignore type annotations on the variable of a function expression.',
@@ -62,6 +66,7 @@ exports.default = (0, util_1.createRule)({
             allowDirectConstAssertionInArrowFunctions: true,
             allowedNames: [],
             allowHigherOrderFunctions: true,
+            allowOverloadFunctions: false,
             allowTypedFunctionExpressions: true,
         },
     ],
@@ -342,6 +347,11 @@ exports.default = (0, util_1.createRule)({
                 (0, explicitReturnTypeUtils_1.ancestorHasReturnType)(node)) {
                 return;
             }
+            if (options.allowOverloadFunctions &&
+                node.parent.type === utils_1.AST_NODE_TYPES.MethodDefinition &&
+                (0, util_1.hasOverloadSignatures)(node.parent, context)) {
+                return;
+            }
             (0, explicitReturnTypeUtils_1.checkFunctionExpressionReturnType)({ node, returns }, options, context.sourceCode, loc => {
                 context.report({
                     loc,
@@ -359,6 +369,10 @@ exports.default = (0, util_1.createRule)({
             if (isAllowedName(node) || (0, explicitReturnTypeUtils_1.ancestorHasReturnType)(node)) {
                 return;
             }
+            if (options.allowOverloadFunctions &&
+                (0, util_1.hasOverloadSignatures)(node, context)) {
+                return;
+            }
             (0, explicitReturnTypeUtils_1.checkFunctionReturnType)({ node, returns }, options, context.sourceCode, loc => {
                 context.report({
                     loc,

package/dist/rules/no-invalid-void-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-invalid-void-type.d.ts","sourceRoot":"","sources":["../../src/rules/no-invalid-void-type.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,OAAO;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,2BAA2B,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,UAAU,GAClB,uBAAuB,GACvB,sBAAsB,GACtB,+BAA+B,GAC/B,iCAAiC,GACjC,0CAA0C,GAC1C,6BAA6B,CAAC;;AAElC,wBA0OG"}
+{"version":3,"file":"no-invalid-void-type.d.ts","sourceRoot":"","sources":["../../src/rules/no-invalid-void-type.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,OAAO;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,2BAA2B,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,UAAU,GAClB,uBAAuB,GACvB,sBAAsB,GACtB,+BAA+B,GAC/B,iCAAiC,GACjC,0CAA0C,GAC1C,6BAA6B,CAAC;;AAElC,wBA2OG"}

package/dist/rules/no-invalid-void-type.js

@@ -57,6 +57,7 @@ exports.default = (0, util_1.createRule)({
             utils_1.AST_NODE_TYPES.TSPropertySignature,
             utils_1.AST_NODE_TYPES.CallExpression,
             utils_1.AST_NODE_TYPES.PropertyDefinition,
+            utils_1.AST_NODE_TYPES.AccessorProperty,
             utils_1.AST_NODE_TYPES.Identifier,
         ];
         const validUnionMembers = [

package/dist/rules/no-unnecessary-type-assertion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-unnecessary-type-assertion.d.ts","sourceRoot":"","sources":["../../src/rules/no-unnecessary-type-assertion.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,OAAO,GAAG;IACpB;QACE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B;CACF,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,yBAAyB,GAAG,sBAAsB,CAAC;;AAE5E,wBAiXG"}
+{"version":3,"file":"no-unnecessary-type-assertion.d.ts","sourceRoot":"","sources":["../../src/rules/no-unnecessary-type-assertion.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,OAAO,GAAG;IACpB;QACE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B;CACF,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,yBAAyB,GAAG,sBAAsB,CAAC;;AAE5E,wBAwXG"}

package/dist/rules/no-unnecessary-type-assertion.js

@@ -260,6 +260,10 @@ exports.default = (0, util_1.createRule)({
                     // so figure out if the variable is used in a place that accepts nullable types
                     const contextualType = (0, util_1.getContextualType)(checker, originalNode);
                     if (contextualType) {
+                        if ((0, util_1.isTypeFlagSet)(type, ts.TypeFlags.Unknown) &&
+                            !(0, util_1.isTypeFlagSet)(contextualType, ts.TypeFlags.Unknown)) {
+                            return;
+                        }
                         // in strict mode you can't assign null to undefined, so we have to make sure that
                         // the two types share a nullable type
                         const typeIncludesUndefined = (0, util_1.isTypeFlagSet)(type, ts.TypeFlags.Undefined);

package/dist/rules/no-unnecessary-type-parameters.js

@@ -185,7 +185,12 @@ function isTypeParameterRepeatedInAST(node, references, startOfBody = Infinity)
         if (reference.identifier.parent.type === utils_1.AST_NODE_TYPES.TSTypeReference) {
             const grandparent = skipConstituentsUpward(reference.identifier.parent.parent);
             if (grandparent.type === utils_1.AST_NODE_TYPES.TSTypeParameterInstantiation &&
-                grandparent.params.includes(reference.identifier.parent)) {
+                grandparent.params.includes(reference.identifier.parent) &&
+                // Array and ReadonlyArray must be handled carefully
+                // let's defer the check to the type-aware phase
+                !(grandparent.parent.type === utils_1.AST_NODE_TYPES.TSTypeReference &&
+                    grandparent.parent.typeName.type === utils_1.AST_NODE_TYPES.Identifier &&
+                    ['Array', 'ReadonlyArray'].includes(grandparent.parent.typeName.name))) {
                 return true;
             }
         }
@@ -215,14 +220,14 @@ function countTypeParameterUsage(checker, node) {
     const counts = new Map();
     if (ts.isClassLike(node)) {
         for (const typeParameter of node.typeParameters) {
-            collectTypeParameterUsageCounts(checker, typeParameter, counts);
+            collectTypeParameterUsageCounts(checker, typeParameter, counts, true);
         }
         for (const member of node.members) {
-            collectTypeParameterUsageCounts(checker, member, counts);
+            collectTypeParameterUsageCounts(checker, member, counts, true);
         }
     }
     else {
-        collectTypeParameterUsageCounts(checker, node, counts);
+        collectTypeParameterUsageCounts(checker, node, counts, false);
     }
     return counts;
 }
@@ -231,7 +236,7 @@ function countTypeParameterUsage(checker, node) {
  * appears in the given type by checking its uses through its type references.
  * This is essentially a limited subset of the scope manager, but for types.
  */
-function collectTypeParameterUsageCounts(checker, node, foundIdentifierUsages) {
+function collectTypeParameterUsageCounts(checker, node, foundIdentifierUsages, fromClass) {
     const visitedSymbolLists = new Set();
     const type = checker.getTypeAtLocation(node);
     const typeUsages = new Map();
@@ -246,7 +251,7 @@ function collectTypeParameterUsageCounts(checker, node, foundIdentifierUsages) {
     if (!functionLikeType) {
         visitType(type, false);
     }
-    function visitType(type, assumeMultipleUses) {
+    function visitType(type, assumeMultipleUses, isReturnType = false) {
         // Seeing the same type > (threshold=3 ** 2) times indicates a likely
         // recursive type, like `type T = { [P in keyof T]: T }`.
         // If it's not recursive, then heck, we've seen it enough times that any
@@ -288,9 +293,21 @@ function collectTypeParameterUsageCounts(checker, node, foundIdentifierUsages) {
         }
         // Tuple types like `[K, V]`
         // Generic type references like `Map<K, V>`
-        else if (tsutils.isTupleType(type) || tsutils.isTypeReference(type)) {
+        else if (tsutils.isTypeReference(type)) {
             for (const typeArgument of type.typeArguments ?? []) {
-                visitType(typeArgument, true);
+                // currently, if we are in a "class context", everything is accepted
+                let thisAssumeMultipleUses = fromClass || assumeMultipleUses;
+                // special cases - readonly arrays/tuples are considered only to use the
+                // type parameter once. Mutable arrays/tuples are considered to use the
+                // type parameter multiple times if and only if they are returned.
+                // other kind of type references always count as multiple uses
+                thisAssumeMultipleUses ||= tsutils.isTupleType(type.target)
+                    ? isReturnType && !type.target.readonly
+                    : checker.isArrayType(type.target)
+                        ? isReturnType &&
+                            type.symbol?.getName() === 'Array'
+                        : true;
+                visitType(typeArgument, thisAssumeMultipleUses, isReturnType);
             }
         }
         // Template literals like `a${T}b`
@@ -359,7 +376,7 @@ function collectTypeParameterUsageCounts(checker, node, foundIdentifierUsages) {
             visitType(typeParameter, false);
         }
         visitType(checker.getTypePredicateOfSignature(signature)?.type ??
-            signature.getReturnType(), false);
+            signature.getReturnType(), false, true);
     }
     function visitSymbolsListOnce(symbols, assumeMultipleUses) {
         if (visitedSymbolLists.has(symbols)) {

package/dist/rules/no-unused-vars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-unused-vars.d.ts","sourceRoot":"","sources":["../../src/rules/no-unused-vars.ts"],"names":[],"mappings":"AAUA,OAAO,EAAkB,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAapE,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAC3E,MAAM,MAAM,OAAO,GAAG;IAClB,KAAK,GACL,OAAO,GACP;QACE,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;QACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,8BAA8B,CAAC,EAAE,MAAM,CAAC;QACxC,8BAA8B,CAAC,EAAE,OAAO,CAAC;QACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;CACJ,CAAC;;AAqBF,wBA0sBG"}
+{"version":3,"file":"no-unused-vars.d.ts","sourceRoot":"","sources":["../../src/rules/no-unused-vars.ts"],"names":[],"mappings":"AAUA,OAAO,EAAkB,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAepE,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAC3E,MAAM,MAAM,OAAO,GAAG;IAClB,KAAK,GACL,OAAO,GACP;QACE,IAAI,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;QACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;QAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,8BAA8B,CAAC,EAAE,MAAM,CAAC;QACxC,8BAA8B,CAAC,EAAE,OAAO,CAAC;QACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B;CACJ,CAAC;;AA0BF,wBAuuBG"}

package/dist/rules/no-unused-vars.js

@@ -396,24 +396,40 @@ exports.default = (0, util_1.createRule)({
             return unusedVariablesReturn;
         }
         return {
-            // declaration file handling
-            [ambientDeclarationSelector(utils_1.AST_NODE_TYPES.Program, true)](node) {
+            // top-level declaration file handling
+            [ambientDeclarationSelector(utils_1.AST_NODE_TYPES.Program)](node) {
                 if (!(0, util_1.isDefinitionFile)(context.filename)) {
                     return;
                 }
+                const moduleDecl = (0, util_1.nullThrows)(node.parent, util_1.NullThrowsReasons.MissingParent);
+                if (checkForOverridingExportStatements(moduleDecl)) {
+                    return;
+                }
                 markDeclarationChildAsUsed(node);
             },
             // children of a namespace that is a child of a declared namespace are auto-exported
-            [ambientDeclarationSelector('TSModuleDeclaration[declare = true] > TSModuleBlock TSModuleDeclaration > TSModuleBlock', false)](node) {
+            [ambientDeclarationSelector('TSModuleDeclaration[declare = true] > TSModuleBlock TSModuleDeclaration > TSModuleBlock')](node) {
+                const moduleDecl = (0, util_1.nullThrows)(node.parent.parent, util_1.NullThrowsReasons.MissingParent);
+                if (checkForOverridingExportStatements(moduleDecl)) {
+                    return;
+                }
                 markDeclarationChildAsUsed(node);
             },
             // declared namespace handling
-            [ambientDeclarationSelector('TSModuleDeclaration[declare = true] > TSModuleBlock', false)](node) {
+            [ambientDeclarationSelector('TSModuleDeclaration[declare = true] > TSModuleBlock')](node) {
+                const moduleDecl = (0, util_1.nullThrows)(node.parent.parent, util_1.NullThrowsReasons.MissingParent);
+                if (checkForOverridingExportStatements(moduleDecl)) {
+                    return;
+                }
+                markDeclarationChildAsUsed(node);
+            },
+            // namespace handling in definition files
+            [ambientDeclarationSelector('TSModuleDeclaration > TSModuleBlock')](node) {
+                if (!(0, util_1.isDefinitionFile)(context.filename)) {
+                    return;
+                }
                 const moduleDecl = (0, util_1.nullThrows)(node.parent.parent, util_1.NullThrowsReasons.MissingParent);
-                // declared ambient modules with an `export =` statement will only export that one thing
-                // all other statements are not automatically exported in this case
-                if (moduleDecl.id.type === utils_1.AST_NODE_TYPES.Literal &&
-                    checkModuleDeclForExportEquals(moduleDecl)) {
+                if (checkForOverridingExportStatements(moduleDecl)) {
                     return;
                 }
                 markDeclarationChildAsUsed(node);
@@ -467,23 +483,20 @@ exports.default = (0, util_1.createRule)({
                 }
             },
         };
-        function checkModuleDeclForExportEquals(node) {
+        function checkForOverridingExportStatements(node) {
             const cached = MODULE_DECL_CACHE.get(node);
             if (cached != null) {
                 return cached;
             }
-            if (node.body) {
-                for (const statement of node.body.body) {
-                    if (statement.type === utils_1.AST_NODE_TYPES.TSExportAssignment) {
-                        MODULE_DECL_CACHE.set(node, true);
-                        return true;
-                    }
-                }
+            const body = getStatementsOfNode(node);
+            if (hasOverridingExportStatement(body)) {
+                MODULE_DECL_CACHE.set(node, true);
+                return true;
             }
             MODULE_DECL_CACHE.set(node, false);
             return false;
         }
-        function ambientDeclarationSelector(parent, childDeclare) {
+        function ambientDeclarationSelector(parent) {
             return [
                 // Types are ambiently exported
                 `${parent} > :matches(${[
@@ -497,7 +510,7 @@ exports.default = (0, util_1.createRule)({
                     utils_1.AST_NODE_TYPES.TSEnumDeclaration,
                     utils_1.AST_NODE_TYPES.TSModuleDeclaration,
                     utils_1.AST_NODE_TYPES.VariableDeclaration,
-                ].join(', ')})${childDeclare ? '[declare = true]' : ''}`,
+                ].join(', ')})`,
             ].join(', ');
         }
         function markDeclarationChildAsUsed(node) {
@@ -546,6 +559,27 @@ exports.default = (0, util_1.createRule)({
         }
     },
 });
+function hasOverridingExportStatement(body) {
+    for (const statement of body) {
+        if ((statement.type === utils_1.AST_NODE_TYPES.ExportNamedDeclaration &&
+            statement.declaration == null) ||
+            statement.type === utils_1.AST_NODE_TYPES.ExportAllDeclaration ||
+            statement.type === utils_1.AST_NODE_TYPES.TSExportAssignment) {
+            return true;
+        }
+        if (statement.type === utils_1.AST_NODE_TYPES.ExportDefaultDeclaration &&
+            statement.declaration.type === utils_1.AST_NODE_TYPES.Identifier) {
+            return true;
+        }
+    }
+    return false;
+}
+function getStatementsOfNode(block) {
+    if (block.type === utils_1.AST_NODE_TYPES.Program) {
+        return block.body;
+    }
+    return block.body.body;
+}
 /*
 
 ###### TODO ######

package/dist/rules/unified-signatures.d.ts

@@ -2,6 +2,7 @@ export type MessageIds = 'omittingRestParameter' | 'omittingSingleParameter' | '
 export type Options = [
     {
         ignoreDifferentlyNamedParameters?: boolean;
+        ignoreOverloadsWithDifferentJSDoc?: boolean;
     }
 ];
 declare const _default: import("@typescript-eslint/utils/ts-eslint").RuleModule<MessageIds, Options, import("../../rules").ESLintPluginDocs, import("@typescript-eslint/utils/ts-eslint").RuleListener>;

package/dist/rules/unified-signatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-signatures.d.ts","sourceRoot":"","sources":["../../src/rules/unified-signatures.ts"],"names":[],"mappings":"AAuDA,MAAM,MAAM,UAAU,GAClB,uBAAuB,GACvB,yBAAyB,GACzB,2BAA2B,CAAC;AAEhC,MAAM,MAAM,OAAO,GAAG;IACpB;QACE,gCAAgC,CAAC,EAAE,OAAO,CAAC;KAC5C;CACF,CAAC;;AAEF,wBA2gBG"}
+{"version":3,"file":"unified-signatures.d.ts","sourceRoot":"","sources":["../../src/rules/unified-signatures.ts"],"names":[],"mappings":"AAuDA,MAAM,MAAM,UAAU,GAClB,uBAAuB,GACvB,yBAAyB,GACzB,2BAA2B,CAAC;AAEhC,MAAM,MAAM,OAAO,GAAG;IACpB;QACE,gCAAgC,CAAC,EAAE,OAAO,CAAC;QAC3C,iCAAiC,CAAC,EAAE,OAAO,CAAC;KAC7C;CACF,CAAC;;AAEF,wBAyiBG"}

package/dist/rules/unified-signatures.js

@@ -25,6 +25,10 @@ exports.default = (0, util_1.createRule)({
                         type: 'boolean',
                         description: 'Whether two parameters with different names at the same index should be considered different even if their types are the same.',
                     },
+                    ignoreOverloadsWithDifferentJSDoc: {
+                        type: 'boolean',
+                        description: 'Whether two overloads with different JSDoc comments should be considered different even if their parameter and return types are the same.',
+                    },
                 },
             },
         ],
@@ -32,9 +36,10 @@ exports.default = (0, util_1.createRule)({
     defaultOptions: [
         {
             ignoreDifferentlyNamedParameters: false,
+            ignoreOverloadsWithDifferentJSDoc: false,
         },
     ],
-    create(context, [{ ignoreDifferentlyNamedParameters }]) {
+    create(context, [{ ignoreDifferentlyNamedParameters, ignoreOverloadsWithDifferentJSDoc }]) {
         //----------------------------------------------------------------------
         // Helpers
         //----------------------------------------------------------------------
@@ -126,6 +131,13 @@ exports.default = (0, util_1.createRule)({
                     }
                 }
             }
+            if (ignoreOverloadsWithDifferentJSDoc) {
+                const aComment = getBlockCommentForNode(getExportingNode(a) ?? a);
+                const bComment = getBlockCommentForNode(getExportingNode(b) ?? b);
+                if (aComment?.value !== bComment?.value) {
+                    return false;
+                }
+            }
             return (typesAreEqual(a.returnType, b.returnType) &&
                 // Must take the same type parameters.
                 // If one uses a type parameter (from outside) and the other doesn't, they shouldn't be joined.
@@ -306,6 +318,15 @@ exports.default = (0, util_1.createRule)({
             addFailures(failures);
             currentScope = scopes.pop();
         }
+        /**
+         * @returns the first valid JSDoc comment annotating `node`
+         */
+        function getBlockCommentForNode(node) {
+            return context.sourceCode
+                .getCommentsBefore(node)
+                .reverse()
+                .find(comment => comment.type === utils_1.AST_TOKEN_TYPES.Block);
+        }
         function addOverload(signature, key, containingNode) {
             key ??= getOverloadKey(signature);
             if (currentScope &&
@@ -383,7 +404,13 @@ function getOverloadInfo(node) {
             return '()';
         default: {
             const { key } = node;
-            return isIdentifier(key) ? key.name : key.raw;
+            if (isPrivateIdentifier(key)) {
+                return `private_identifier_${key.name}`;
+            }
+            if (isIdentifier(key)) {
+                return `identifier_${key.name}`;
+            }
+            return key.raw;
         }
     }
 }
@@ -400,6 +427,9 @@ function getStaticParameterName(param) {
 function isIdentifier(node) {
     return node.type === utils_1.AST_NODE_TYPES.Identifier;
 }
+function isPrivateIdentifier(node) {
+    return node.type === utils_1.AST_NODE_TYPES.PrivateIdentifier;
+}
 function isGetterOrSetter(node) {
     return node.kind === 'get' || node.kind === 'set';
 }

package/dist/util/getESLintCoreRule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getESLintCoreRule.d.ts","sourceRoot":"","sources":["../../src/util/getESLintCoreRule.ts"],"names":[],"mappings":"AAGA,UAAU,OAAO;IAEf,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,mBAAmB,EAAE,cAAc,oCAAoC,CAAC,CAAC;IACzE,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,mBAAmB,EAAE,cAAc,oCAAoC,CAAC,CAAC;IACzE,YAAY,EAAE,cAAc,6BAA6B,CAAC,CAAC;IAC3D,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,mBAAmB,EAAE,cAAc,oCAAoC,CAAC,CAAC;IACzE,qBAAqB,EAAE,cAAc,sCAAsC,CAAC,CAAC;IAC7E,iBAAiB,EAAE,cAAc,kCAAkC,CAAC,CAAC;IACrE,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,sBAAsB,EAAE,cAAc,uCAAuC,CAAC,CAAC;IAC/E,kBAAkB,EAAE,cAAc,mCAAmC,CAAC,CAAC;IACvE,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,UAAU,EAAE,cAAc,2BAA2B,CAAC,CAAC;IACvD,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,wBAAwB,EAAE,cAAc,yCAAyC,CAAC,CAAC;IACnF,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,sBAAsB,EAAE,cAAc,uCAAuC,CAAC,CAAC;IAC/E,MAAM,EAAE,cAAc,yBAAyB,CAAC,CAAC;CAElD;AAED,KAAK,MAAM,GAAG,MAAM,OAAO,CAAC;AAE5B,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,UAAU,CAAC,KAAG,OAAO,CAAC,CAAC,CAItE,CAAC;AAEJ,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAMnB"}
+{"version":3,"file":"getESLintCoreRule.d.ts","sourceRoot":"","sources":["../../src/util/getESLintCoreRule.ts"],"names":[],"mappings":"AAGA,UAAU,OAAO;IAEf,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,mBAAmB,EAAE,cAAc,oCAAoC,CAAC,CAAC;IACzE,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,mBAAmB,EAAE,cAAc,oCAAoC,CAAC,CAAC;IACzE,YAAY,EAAE,cAAc,6BAA6B,CAAC,CAAC;IAC3D,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,mBAAmB,EAAE,cAAc,oCAAoC,CAAC,CAAC;IACzE,qBAAqB,EAAE,cAAc,sCAAsC,CAAC,CAAC;IAC7E,iBAAiB,EAAE,cAAc,kCAAkC,CAAC,CAAC;IACrE,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,sBAAsB,EAAE,cAAc,uCAAuC,CAAC,CAAC;IAC/E,kBAAkB,EAAE,cAAc,mCAAmC,CAAC,CAAC;IACvE,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,UAAU,EAAE,cAAc,2BAA2B,CAAC,CAAC;IACvD,uBAAuB,EAAE,cAAc,wCAAwC,CAAC,CAAC;IACjF,wBAAwB,EAAE,cAAc,yCAAyC,CAAC,CAAC;IACnF,cAAc,EAAE,cAAc,+BAA+B,CAAC,CAAC;IAC/D,sBAAsB,EAAE,cAAc,uCAAuC,CAAC,CAAC;IAC/E,MAAM,EAAE,cAAc,yBAAyB,CAAC,CAAC;CAElD;AAED,KAAK,MAAM,GAAG,MAAM,OAAO,CAAC;AAE5B,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAAE,QAAQ,CAAC,KAAG,OAAO,CAAC,CAAC,CAItE,CAAC;AAEJ,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAMnB"}

package/dist/util/getValueOfLiteralType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getValueOfLiteralType.d.ts","sourceRoot":"","sources":["../../src/util/getValueOfLiteralType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAYtC,eAAO,MAAM,qBAAqB,SAC1B,EAAE,CAAC,WAAW,KACnB,MAAM,GAAG,MAAM,GAAG,MAKpB,CAAC"}
+{"version":3,"file":"getValueOfLiteralType.d.ts","sourceRoot":"","sources":["../../src/util/getValueOfLiteralType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAYtC,eAAO,MAAM,qBAAqB,GAChC,MAAM,EAAE,CAAC,WAAW,KACnB,MAAM,GAAG,MAAM,GAAG,MAKpB,CAAC"}

package/dist/util/misc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/util/misc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/util/misc.ts"],"names":[],"mappings":"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"}

package/dist/util/truthinessAndNullishUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"truthinessAndNullishUtils.d.ts","sourceRoot":"","sources":["../../src/util/truthinessAndNullishUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AASjC,eAAO,MAAM,eAAe,SAAU,EAAE,CAAC,IAAI,KAAG,OAS0B,CAAC;AAE3E,eAAO,MAAM,gBAAgB,SAAU,EAAE,CAAC,IAAI,KAAG,OAQ5C,CAAC;AAON,eAAO,MAAM,iBAAiB,SAAU,EAAE,CAAC,IAAI,KAAG,OACA,CAAC;AAEnD,eAAO,MAAM,eAAe,SAAU,EAAE,CAAC,IAAI,KAAG,OACG,CAAC"}
+{"version":3,"file":"truthinessAndNullishUtils.d.ts","sourceRoot":"","sources":["../../src/util/truthinessAndNullishUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AASjC,eAAO,MAAM,eAAe,GAAI,MAAM,EAAE,CAAC,IAAI,KAAG,OAS0B,CAAC;AAE3E,eAAO,MAAM,gBAAgB,GAAI,MAAM,EAAE,CAAC,IAAI,KAAG,OAQ5C,CAAC;AAON,eAAO,MAAM,iBAAiB,GAAI,MAAM,EAAE,CAAC,IAAI,KAAG,OACA,CAAC;AAEnD,eAAO,MAAM,eAAe,GAAI,MAAM,EAAE,CAAC,IAAI,KAAG,OACG,CAAC"}

package/docs/rules/consistent-return.mdx

@@ -12,7 +12,7 @@ import TabItem from '@theme/TabItem';
 It adds support for functions that return `void` or `Promise<void>`.
 
 :::danger warning
-If possible, it is recommended to use tsconfig's `noImplicitReturns` option rather than this rule. `noImplicitReturns` is powered by TS's type information and control-flow analysis so it has better coverage than this rule.
+If possible, it is recommended to use tsconfig's [`noImplicitReturns`](https://www.typescriptlang.org/tsconfig/#noImplicitReturns) option rather than this rule. `noImplicitReturns` is powered by TS's type information and control-flow analysis so it has better coverage than this rule.
 :::
 
 <Tabs>

package/docs/rules/explicit-module-boundary-types.mdx

@@ -260,6 +260,20 @@ export const foo: FooType = bar => {};
 </TabItem>
 </Tabs>
 
+### `allowOverloadFunctions`
+
+{/* insert option description */}
+
+Examples of correct code when `allowOverloadFunctions` is set to `true`:
+
+```ts option='{ "allowOverloadFunctions": true }' showPlaygroundButton
+export function test(a: string): string;
+export function test(a: number): number;
+export function test(a: unknown) {
+  return a;
+}
+```
+
 ## When Not To Use It
 
 If your project is not used by downstream consumers that are sensitive to API types, you can disable this rule.

package/docs/rules/no-unnecessary-type-parameters.mdx

@@ -82,10 +82,30 @@ For example, the following `T` is used multiple times by virtue of being in an `
 declare function createStateHistory<T>(): T[];
 ```
 
-This is because the type parameter `T` relates multiple methods in the `T[]` together, making it used more than once.
+This is because the type parameter `T` relates multiple methods in `T[]` (`Array<T>`) together, making it used more than once.
 
 Therefore, this rule won't report on type parameters used as a type argument.
-That includes type arguments given to global types such as `Array` (including the `T[]` shorthand and in tuples), `Map`, and `Set`.
+This includes type arguments provided to global types such as `Array`, `Map`, and `Set` that have multiple methods and properties that can change values based on the type parameter.
+
+On the other hand, readonly and fixed array-likes such as `readonly T[]`, `ReadonlyArray`, and tuples such as `[T]` are special cases that are specifically reported on when used as input types, or as `readonly` output types.
+The following example will be reported because `T` is used only once as type argument for the `ReadonlyArray` global type:
+
+<Tabs>
+<TabItem value="❌ Incorrect">
+
+```ts
+declare function length<T>(array: ReadonlyArray<T>): number;
+```
+
+</TabItem>
+<TabItem value="✅ Correct">
+
+```ts
+declare function length(array: ReadonlyArray<unknown>): number;
+```
+
+</TabItem>
+</Tabs>
 
 ## FAQ
 

package/docs/rules/unified-signatures.mdx

@@ -78,6 +78,50 @@ function f(b: string): void;
 </TabItem>
 </Tabs>
 
+### `ignoreOverloadsWithDifferentJSDoc`
+
+{/* insert option description */}
+
+Examples of code for this rule with `ignoreOverloadsWithDifferentJSDoc`:
+
+<Tabs>
+<TabItem value="❌ Incorrect">
+
+```ts option='{ "ignoreOverloadsWithDifferentJSDoc": true }'
+declare function f(x: string): void;
+declare function f(x: boolean): void;
+/**
+ * @deprecate
+ */
+declare function f(x: number): void;
+/**
+ * @deprecate
+ */
+declare function f(x: null): void;
+```
+
+</TabItem>
+<TabItem value="✅ Correct">
+
+```ts option='{ "ignoreOverloadsWithDifferentJSDoc": true }'
+declare function f(x: string): void;
+/**
+ * This signature does something else.
+ */
+declare function f(x: boolean): void;
+/**
+ * @async
+ */
+declare function f(x: number): void;
+/**
+ * @deprecate
+ */
+declare function f(x: null): void;
+```
+
+</TabItem>
+</Tabs>
+
 ## When Not To Use It
 
 This is purely a stylistic rule to help with readability of function signature overloads.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typescript-eslint/eslint-plugin",
-  "version": "8.25.1-alpha.9",
+  "version": "8.26.0",
   "description": "TypeScript plugin for ESLint",
   "files": [
     "dist",
@@ -62,10 +62,10 @@
   },
   "dependencies": {
     "@eslint-community/regexpp": "^4.10.0",
-    "@typescript-eslint/scope-manager": "8.25.1-alpha.9",
-    "@typescript-eslint/type-utils": "8.25.1-alpha.9",
-    "@typescript-eslint/utils": "8.25.1-alpha.9",
-    "@typescript-eslint/visitor-keys": "8.25.1-alpha.9",
+    "@typescript-eslint/scope-manager": "8.26.0",
+    "@typescript-eslint/type-utils": "8.26.0",
+    "@typescript-eslint/utils": "8.26.0",
+    "@typescript-eslint/visitor-keys": "8.26.0",
     "graphemer": "^1.4.0",
     "ignore": "^5.3.1",
     "natural-compare": "^1.4.0",
@@ -76,8 +76,8 @@
     "@types/marked": "^5.0.2",
     "@types/mdast": "^4.0.3",
     "@types/natural-compare": "*",
-    "@typescript-eslint/rule-schema-to-typescript-types": "8.25.1-alpha.9",
-    "@typescript-eslint/rule-tester": "8.25.1-alpha.9",
+    "@typescript-eslint/rule-schema-to-typescript-types": "8.26.0",
+    "@typescript-eslint/rule-tester": "8.26.0",
     "ajv": "^6.12.6",
     "cross-env": "^7.0.3",
     "cross-fetch": "*",
@@ -100,7 +100,7 @@
   "peerDependencies": {
     "@typescript-eslint/parser": "^8.0.0 || ^8.0.0-alpha.0",
     "eslint": "^8.57.0 || ^9.0.0",
-    "typescript": ">=4.8.4 <5.8.0"
+    "typescript": ">=4.8.4 <5.9.0"
   },
   "funding": {
     "type": "opencollective",