[BetterPhpDocParser] Keep import referenced by @see/@uses tag with a trailing description

src/BetterPhpDocParser/PhpDocInfo/PhpDocInfo.php

@@ -35,6 +35,8 @@
 use Rector\Exception\ShouldNotHappenException;
 use Rector\PhpDocParser\PhpDocParser\PhpDocNodeTraverser;
 use Rector\StaticTypeMapper\StaticTypeMapper;
+use Rector\Validation\RectorAssert;
+use Webmozart\Assert\InvalidArgumentException;
 
 /**
  * @see \Rector\Tests\BetterPhpDocParser\PhpDocInfo\PhpDocInfo\PhpDocInfoTest
@@ -461,7 +463,19 @@ public function getGenericTagClassNames(): array
 
             // add default original value
             $resolvedClasses[] = $genericTagValueNode->value;
+
             if (! str_contains($genericTagValueNode->value, '::')) {
+                // keep the import for the leading class reference in "@see Foo some description"
+                $leadingReference = strtok($genericTagValueNode->value, " \t\n\r");
+                if ($leadingReference !== false && $leadingReference !== $genericTagValueNode->value) {
+                    try {
+                        RectorAssert::className($leadingReference);
+                        $resolvedClasses[] = $leadingReference;
+                    } catch (InvalidArgumentException) {
+                        continue;
+                    }
+                }
+
                 continue;
             }
 

tests/Issues/NamespacedUse/Fixture/see_with_non_class_description.php.inc

@@ -0,0 +1,23 @@
+<?php
+
+namespace Rector\Tests\Issues\NamespacedUse\Fixture;
+
+use Rector\Renaming\Rector\Name\RenameClassRector;
+
+/**
+ * @see some description that does not start with a class reference
+ */
+final class SeeWithNonClassDescription
+{
+}
+-----
+<?php
+
+namespace Rector\Tests\Issues\NamespacedUse\Fixture;
+
+/**
+ * @see some description that does not start with a class reference
+ */
+final class SeeWithNonClassDescription
+{
+}

tests/Issues/NamespacedUse/Fixture/skip_used_see_with_description.php.inc

@@ -0,0 +1,12 @@
+<?php
+
+namespace Rector\Tests\Issues\NamespacedUse\Fixture;
+
+use Rector\Renaming\Rector\Name\RenameClassRector;
+
+/**
+ * @see RenameClassRector some description after the class reference
+ */
+final class SkipUsedSeeWithDescription
+{
+}