Fix circular @phpstan-import-type between classes making aliases unresolvable

- When two classes have mutual @phpstan-import-type tags (FooType imports Bar
  from BarType, BarType imports Foo from FooType), the circular detection in
  ClassReflection::getTypeAliases() was too aggressive
- The fix returns local type aliases (defined via @phpstan-type) when circular
  import resolution is detected, since local aliases don't depend on imports
- Added regression test in tests/PHPStan/Rules/PhpDoc/data/bug-11463.php

Closes phpstan/phpstan#11463

Author: phpstan-bot

src/Reflection/ClassReflection.php

@@ -1376,6 +1376,13 @@ public function getTypeAliases(): array
 
 			// prevent circular imports
 			if (array_key_exists($this->getName(), self::$resolvingTypeAliasImports)) {
+				// Return only local type aliases to break the cycle.
+				// Imported aliases are not available yet, but local ones
+				// don't depend on other classes and can be returned safely.
+				$localAliases = array_map(static fn (TypeAliasTag $typeAliasTag): TypeAlias => $typeAliasTag->getTypeAlias(), $typeAliasTags);
+				if ($localAliases !== []) {
+					return $localAliases;
+				}
 				throw new CircularTypeAliasDefinitionException();
 			}
 

tests/PHPStan/Rules/PhpDoc/IncompatiblePhpDocTypeRuleTest.php

@@ -487,4 +487,9 @@ public function testBug9708(): void
 		$this->analyse([__DIR__ . '/data/bug-9708.php'], []);
 	}
 
+	public function testBug11463(): void
+	{
+		$this->analyse([__DIR__ . '/data/bug-11463.php'], []);
+	}
+
 }

tests/PHPStan/Rules/PhpDoc/data/bug-11463.php

@@ -0,0 +1,28 @@
+<?php declare(strict_types = 1);
+
+namespace Bug11463;
+
+/**
+ * @phpstan-type Foo 'foo'
+ *
+ * @phpstan-import-type Bar from BarType
+ */
+class FooType
+{
+	/**
+	 * @param Bar $bar
+	 */
+	public function foo(string $bar): void {}
+}
+
+/**
+ * @phpstan-import-type Foo from FooType
+ *
+ * @phpstan-type Bar 'bar'
+ */
+class BarType {
+	/**
+	 * @param Foo $foo
+	 */
+	public function bar($foo): string { return $foo; }
+}