fix: restore JSDoc component detection on ESLint 10

ESLint 10 removed SourceCode#getJSDocComment, which this plugin still relies on for JSDoc-based component detection. Reintroduce the ESLint 9 getJSDocComment logic in the shared eslint util.

Author: ledsun

lib/util/componentUtil.js

@@ -4,8 +4,8 @@ const doctrine = require('doctrine');
 const pragmaUtil = require('./pragma');
 const eslintUtil = require('./eslint');
 
+const getJSDocComment = eslintUtil.getJSDocComment;
 const getScope = eslintUtil.getScope;
-const getSourceCode = eslintUtil.getSourceCode;
 const getText = eslintUtil.getText;
 
 // eslint-disable-next-line valid-jsdoc
@@ -62,14 +62,13 @@ function isES5Component(node, context) {
  * @returns {boolean}
  */
 function isExplicitComponent(node, context) {
-  const sourceCode = getSourceCode(context);
   let comment;
   // Sometimes the passed node may not have been parsed yet by eslint, and this function call crashes.
   // Can be removed when eslint sets "parent" property for all nodes on initial AST traversal: https://github.com/eslint/eslint-scope/issues/27
   // eslint-disable-next-line no-warning-comments
   // FIXME: Remove try/catch when https://github.com/eslint/eslint-scope/issues/27 is implemented.
   try {
-    comment = sourceCode.getJSDocComment(node);
+    comment = getJSDocComment(context, node);
   } catch (e) {
     comment = null;
   }

lib/util/eslint.js

@@ -1,5 +1,8 @@
 'use strict';
 
+const semver = require('semver');
+const eslintVersion = require('eslint/package.json').version;
+
 function getSourceCode(context) {
   return context.getSourceCode ? context.getSourceCode() : context.sourceCode;
 }
@@ -40,6 +43,90 @@ function getText(context) {
   return sourceCode.getText ? sourceCode.getText.apply(sourceCode, args) : context.getSource.apply(context, args);
 }
 
+function getJSDocComment(context, node) {
+  const sourceCode = getSourceCode(context);
+
+  // ESLint 10 removed the deprecated SourceCode#getJSDocComment API, but we
+  // still rely on its behavior for JSDoc-based React component detection.
+  // Reuse the ESLint 9 SourceCode#getJSDocComment logic as a compatibility
+  // fallback when the built-in helper is no longer available.
+  if (semver.major(eslintVersion) < 10 && sourceCode.getJSDocComment) {
+    return sourceCode.getJSDocComment(node);
+  }
+
+  function findJSDocComment(astNode) {
+    const tokenBefore = sourceCode.getTokenBefore(astNode, {
+      includeComments: true,
+    });
+
+    if (
+      tokenBefore
+      && (tokenBefore.type === 'Block' || tokenBefore.type === 'Line')
+      && tokenBefore.type === 'Block'
+      && tokenBefore.value.charAt(0) === '*'
+      && astNode.loc.start.line - tokenBefore.loc.end.line <= 1
+    ) {
+      return tokenBefore;
+    }
+
+    return null;
+  }
+
+  function looksLikeExport(astNode) {
+    return astNode
+      && (
+        astNode.type === 'ExportDefaultDeclaration'
+        || astNode.type === 'ExportNamedDeclaration'
+        || astNode.type === 'ExportAllDeclaration'
+        || astNode.type === 'ExportSpecifier'
+      );
+  }
+
+  let parent = node.parent;
+
+  switch (node.type) {
+    case 'ClassDeclaration':
+    case 'FunctionDeclaration':
+      return findJSDocComment(looksLikeExport(parent) ? parent : node);
+
+    case 'ClassExpression':
+      return findJSDocComment(parent.parent);
+
+    case 'ArrowFunctionExpression':
+    case 'FunctionExpression':
+      if (
+        parent.type !== 'CallExpression'
+        && parent.type !== 'NewExpression'
+      ) {
+        while (
+          !sourceCode.getCommentsBefore(parent).length
+          && !/Function/u.test(parent.type)
+          && parent.type !== 'MethodDefinition'
+          && parent.type !== 'Property'
+        ) {
+          parent = parent.parent;
+
+          if (!parent) {
+            break;
+          }
+        }
+
+        if (
+          parent
+          && parent.type !== 'FunctionDeclaration'
+          && parent.type !== 'Program'
+        ) {
+          return findJSDocComment(parent);
+        }
+      }
+
+      return findJSDocComment(node);
+
+    default:
+      return null;
+  }
+}
+
 function isSpaceBetweenTokens(context, leftToken, rightToken) {
   const sourceCode = getSourceCode(context);
 
@@ -71,6 +158,7 @@ module.exports = {
   getFilename,
   getFirstTokens,
   getScope,
+  getJSDocComment,
   getSourceCode,
   getText,
   isSpaceBetweenTokens,