From 7c8d34a0cf3d95f3c000a58e427bff8317149ba4 Mon Sep 17 00:00:00 2001
From: Brett Zamir <brettz9@yahoo.com>
Date: Wed, 26 Jun 2024 16:45:47 +0800
Subject: [PATCH] feat(`check-param-names`): check `TSMethodSignature` (as on
 interface methods); fixes #1249

---
 docs/rules/check-param-names.md          |  8 ++++++++
 src/rules/checkParamNames.js             |  5 +++++
 test/rules/assertions/checkParamNames.js | 20 ++++++++++++++++++++
 3 files changed, 33 insertions(+)

diff --git a/docs/rules/check-param-names.md b/docs/rules/check-param-names.md
index 61ef59a39..5b3c74f35 100644
--- a/docs/rules/check-param-names.md
+++ b/docs/rules/check-param-names.md
@@ -657,6 +657,14 @@ function quux (foo) {
 }
 // "jsdoc/check-param-names": ["error"|"warn", {"disableMissingParamChecks":true}]
 // Message: @param "bar" does not match an existing function parameter.
+
+export interface B {
+    /**
+     * @param paramA Something something
+     */
+    methodB(paramB: string): void
+};
+// Message: Expected @param names to be "paramB". Got "paramA".
 ````
 
 
diff --git a/src/rules/checkParamNames.js b/src/rules/checkParamNames.js
index 3569efcd5..b1b8cd9ec 100644
--- a/src/rules/checkParamNames.js
+++ b/src/rules/checkParamNames.js
@@ -378,6 +378,11 @@ export default iterateJsdoc(({
     targetTagName, allowExtraTrailingParamDocs, jsdocParameterNamesDeep, jsdoc, report,
   );
 }, {
+  contextDefaults: [
+    'ArrowFunctionExpression', 'FunctionDeclaration', 'FunctionExpression', 'TSDeclareFunction',
+    // Add this to above defaults
+    'TSMethodSignature'
+  ],
   meta: {
     docs: {
       description: 'Ensures that parameter names in JSDoc match those in the function declaration.',
diff --git a/test/rules/assertions/checkParamNames.js b/test/rules/assertions/checkParamNames.js
index 44101afa3..173f565a8 100644
--- a/test/rules/assertions/checkParamNames.js
+++ b/test/rules/assertions/checkParamNames.js
@@ -1257,6 +1257,26 @@ export default {
         },
       ],
     },
+    {
+      code: `
+        export interface B {
+            /**
+             * @param paramA Something something
+             */
+            methodB(paramB: string): void
+        };
+      `,
+      errors: [
+        {
+          line: 4,
+          message: 'Expected @param names to be "paramB". Got "paramA".',
+        },
+      ],
+      languageOptions: {
+        parser: typescriptEslintParser,
+        sourceType: 'module',
+      },
+    }
   ],
   valid: [
     {