Resolve class references in any PHPDoc tag containing "::"

Author: ruudk

src/BetterPhpDocParser/PhpDocParser/PhpDocTagGenericUsesDecorator.php

@@ -15,8 +15,7 @@
 use Rector\StaticTypeMapper\Naming\NameScopeFactory;
 
 /**
- * Decorate node with fully qualified class name for generic annotations for @uses, @used-by, and @see
- * e.g. @uses Direction::*
+ * Decorate node with fully qualified class name for any PHPDoc tag that references a class via "::".
  *
  * @see https://docs.phpdoc.org/guide/references/phpdoc/tags/uses.html
  */
@@ -46,10 +45,6 @@ public function decorate(PhpDocNode $phpDocNode, PhpNode $phpNode): void
                 return null;
             }
 
-            if (! in_array($node->name, ['@uses', '@used-by', '@see'], true)) {
-                return null;
-            }
-
             $reference = $node->value->value;
             if (! str_contains($reference, '::')) {
                 return null;

tests/Issues/CustomPhpDocTagClassReference/CustomPhpDocTagClassReferenceTest.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Rector\Tests\Issues\CustomPhpDocTagClassReference;
+
+use Iterator;
+use PHPUnit\Framework\Attributes\DataProvider;
+use Rector\Testing\PHPUnit\AbstractRectorTestCase;
+
+final class CustomPhpDocTagClassReferenceTest extends AbstractRectorTestCase
+{
+    #[DataProvider('provideData')]
+    public function test(string $filePath): void
+    {
+        $this->doTestFile($filePath);
+    }
+
+    public static function provideData(): Iterator
+    {
+        return self::yieldFilesFromDirectory(__DIR__ . '/Fixture');
+    }
+
+    public function provideConfigFilePath(): string
+    {
+        return __DIR__ . '/config/configured_rule.php';
+    }
+}

tests/Issues/CustomPhpDocTagClassReference/Fixture/skip_custom_tag_with_class_reference.php.inc

@@ -0,0 +1,12 @@
+<?php
+
+namespace Rector\Tests\Issues\CustomPhpDocTagClassReference\Fixture;
+
+use Rector\Tests\Issues\CustomPhpDocTagClassReference\Source\NotificationHandler;
+
+/**
+ * @throwable-from NotificationHandler::createPayload
+ */
+final class SkipCustomTagWithClassReference extends \Exception
+{
+}

tests/Issues/CustomPhpDocTagClassReference/Source/NotificationHandler.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Rector\Tests\Issues\CustomPhpDocTagClassReference\Source;
+
+final class NotificationHandler
+{
+    public function createPayload(): void
+    {
+    }
+}

tests/Issues/CustomPhpDocTagClassReference/config/configured_rule.php

@@ -0,0 +1,9 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+
+return static function (RectorConfig $rectorConfig): void {
+    $rectorConfig->removeUnusedImports();
+};