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

When `removeUnusedImports()` is enabled, UnusedImportRemovingPostRector
collects the class names used inside doc blocks through
PhpDocInfo::getGenericTagClassNames(). For generic tags such as @see,
@uses and @link it only registered the full tag value.

A tag like `@see Foo some description` therefore produced the single
candidate "Foo some description", which never matches the imported short
name "Foo". As a result the `use` import for Foo was considered unused
and removed, leaving an unresolved reference (or, for a class in another
namespace, one that silently resolves to the wrong class).

Per the phpDocumentor syntax `@see [FQSEN] [<description>]`, the class
reference is the leading token of the value. Register that leading token
in addition to the full value, so the import is correctly kept when a
description follows the class name.

Author: ruudk

src/BetterPhpDocParser/PhpDocInfo/PhpDocInfo.php

@@ -461,6 +461,13 @@ public function getGenericTagClassNames(): array
 
             // add default original value
             $resolvedClasses[] = $genericTagValueNode->value;
+
+            // add the leading reference, so "@see Foo some description" keeps the import for Foo
+            $leadingReference = strtok($genericTagValueNode->value, " \t\n\r");
+            if ($leadingReference !== false && $leadingReference !== $genericTagValueNode->value) {
+                $resolvedClasses[] = $leadingReference;
+            }
+
             if (! str_contains($genericTagValueNode->value, '::')) {
                 continue;
             }

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
+{
+}