Fix FileVisitor issues with wrong class detection

It seems the php parser is using phpdocs and deciding that
 something like
/**
 * @return array<int, string|int>
 */
is a class with FQCN `My\Namespace\array<int, string|int>` which
then ofc fails to create a FullyQualifiedClassName.

Author: hgraca

src/Analyzer/FileVisitor.php

@@ -228,6 +228,10 @@ private function handleTypedProperty(Node $node): void
                 return;
             }
 
+            if (FullyQualifiedClassName::isNotAValidFqcn($type->toString())) {
+                return;
+            }
+
             try {
                 $this->classDescriptionBuilder
                     ->addDependency(new ClassDependency($type->toString(), $node->getLine()));
@@ -288,10 +292,17 @@ private function handleReturnTypeDependency(Node $node): void
     {
         if ($node instanceof Node\Stmt\ClassMethod) {
             $returnType = $node->returnType;
-            if ($returnType instanceof Node\Name\FullyQualified) {
-                $this->classDescriptionBuilder
-                    ->addDependency(new ClassDependency($returnType->toString(), $returnType->getLine()));
+
+            if (!$returnType instanceof Node\Name\FullyQualified) {
+                return;
             }
+
+            if (FullyQualifiedClassName::isNotAValidFqcn($returnType->toString())) {
+                return;
+            }
+
+            $this->classDescriptionBuilder
+                ->addDependency(new ClassDependency($returnType->toString(), $returnType->getLine()));
         }
     }
 
@@ -300,10 +311,16 @@ private function handleAttributeNode(Node $node): void
         if ($node instanceof Node\Attribute) {
             $nodeName = $node->name;
 
-            if ($nodeName instanceof Node\Name\FullyQualified) {
-                $this->classDescriptionBuilder
-                    ->addAttribute($node->name->toString(), $node->getLine());
+            if (!$nodeName instanceof Node\Name\FullyQualified) {
+                return;
+            }
+
+            if (FullyQualifiedClassName::isNotAValidFqcn($nodeName->toString())) {
+                return;
             }
+
+            $this->classDescriptionBuilder
+                ->addAttribute($nodeName->toString(), $node->getLine());
         }
     }
 
@@ -337,6 +354,10 @@ private function addParamDependency(Node\Param $node): void
             return;
         }
 
+        if (FullyQualifiedClassName::isNotAValidFqcn($type->toString())) {
+            return;
+        }
+
         $this->classDescriptionBuilder
             ->addDependency(new ClassDependency($type->toString(), $node->getLine()));
     }

src/Analyzer/FullyQualifiedClassName.php

@@ -27,7 +27,7 @@ public function toString(): string
 
     public function classMatches(string $pattern): bool
     {
-        if ($this->isNotAValidPattern($pattern)) {
+        if (self::isNotAValidFqcn($pattern)) {
             throw new InvalidPatternException("'$pattern' is not a valid class or namespace pattern. Regex are not allowed, only * and ? wildcard.");
         }
 
@@ -36,7 +36,7 @@ public function classMatches(string $pattern): bool
 
     public function matches(string $pattern): bool
     {
-        if ($this->isNotAValidPattern($pattern)) {
+        if (self::isNotAValidFqcn($pattern)) {
             throw new InvalidPatternException("'$pattern' is not a valid class or namespace pattern. Regex are not allowed, only * and ? wildcard.");
         }
 
@@ -69,12 +69,12 @@ public static function fromString(string $fqcn): self
         return new self(new PatternString($fqcn), new PatternString($namespace), new PatternString($className));
     }
 
-    public function isNotAValidPattern(string $pattern): bool
+    public static function isNotAValidFqcn(string $fqcn): bool
     {
         $validClassNameCharacters = '[a-zA-Z0-9_\x80-\xff]';
         $or = '|';
         $backslash = '\\\\';
 
-        return 0 === preg_match('/^('.$validClassNameCharacters.$or.$backslash.$or.'\*'.$or.'\?)*$/', $pattern);
+        return 0 === preg_match('/^('.$validClassNameCharacters.$or.$backslash.$or.'\*'.$or.'\?)*$/', $fqcn);
     }
 }