Resolve enumCase fetch over interface

Author: janedbal

composer.json

@@ -13,7 +13,7 @@
     ],
     "require": {
         "php": "^7.4 || ^8.0",
-        "phpstan/phpstan": "^2.1.9"
+        "phpstan/phpstan": "^2.1.12"
     },
     "require-dev": {
         "composer-runtime-api": "^2.0",

composer.lock

@@ -207,15 +207,15 @@ private function getDeclaringTypesWithConstant(
             $possibleDescendant = $isPossibleDescendant ?? !$classReflection->isFinal();
 
             if ($mayBeEnum) {
-                $result[] = new EnumCaseRef($classReflection->getName(), $constantName);
+                $result[] = new EnumCaseRef($classReflection->getName(), $constantName, $typeNormalized->isEnum()->maybe());
             }
 
             $result[] = new ClassConstantRef($classReflection->getName(), $constantName, $possibleDescendant);
         }
 
         if ($result === []) { // call over unknown type
             $result[] = new ClassConstantRef(null, $constantName, true);
-            $result[] = new EnumCaseRef(null, $constantName);
+            $result[] = new EnumCaseRef(null, $constantName, true);
         }
 
         return $result;

src/Collector/ConstantFetchCollector.php

@@ -125,7 +125,7 @@ public static function deserialize(
         } elseif ($memberType === MemberType::ENUM_CASE) {
             $usage = new EnumCaseUsage(
                 $origin,
-                new EnumCaseRef($result['m']['c'], $result['m']['m']),
+                new EnumCaseRef($result['m']['c'], $result['m']['m'], $result['m']['d']),
             );
         } else {
             throw new LogicException('Unknown member type: ' . $memberType);

src/Graph/CollectedUsage.php

@@ -10,12 +10,16 @@
 final class EnumCaseRef extends ClassMemberRef
 {
 
+    /**
+     * @param bool $possibleDescendant Can be true only for maybe-enums (interfaces)
+     */
     public function __construct(
         ?string $className,
-        ?string $enumCaseName
+        ?string $enumCaseName,
+        bool $possibleDescendant
     )
     {
-        parent::__construct($className, $enumCaseName, false);
+        parent::__construct($className, $enumCaseName, $possibleDescendant);
     }
 
     public static function buildKey(string $typeName, string $memberName): string

src/Graph/EnumCaseRef.php

@@ -51,6 +51,7 @@ public function concretizeMixedClassNameUsage(string $className): self
             new EnumCaseRef(
                 $className,
                 $this->enumCase->getMemberName(),
+                $this->enumCase->isPossibleDescendant(),
             ),
         );
     }

src/Graph/EnumCaseUsage.php

@@ -280,6 +280,7 @@ private function getUsagesOfEnumColumn(string $className, string $propertyName,
                         new EnumCaseRef(
                             $constantString->getValue(),
                             null,
+                            false,
                         ),
                     );
                 }

src/Provider/DoctrineUsageProvider.php

@@ -72,7 +72,7 @@ private function getTryFromUsages(StaticCall $staticCall, Scope $scope): array
                     continue;
                 }
 
-                $valueToCaseMapping = $this->getValueToEnumCaseMapping($classReflection->getNativeReflection()); // @phpstan-ignore argument.type (https://github.com/phpstan/phpstan-src/pull/3925)
+                $valueToCaseMapping = $this->getValueToEnumCaseMapping($classReflection->getNativeReflection());
                 $triedValues = $firstArgType->getConstantScalarValues() === []
                     ? [null]
                     : array_filter($firstArgType->getConstantScalarValues(), static fn($value): bool => is_string($value) || is_int($value));
@@ -81,7 +81,7 @@ private function getTryFromUsages(StaticCall $staticCall, Scope $scope): array
                     $enumCase = $value === null ? null : $valueToCaseMapping[$value] ?? null;
                     $result[] = new EnumCaseUsage(
                         UsageOrigin::createRegular($staticCall, $scope),
-                        new EnumCaseRef($classReflection->getName(), $enumCase),
+                        new EnumCaseRef($classReflection->getName(), $enumCase, false),
                     );
                 }
             }

src/Provider/EnumUsageProvider.php

@@ -168,6 +168,7 @@ private function createEnumCaseUsage(ReflectionEnumUnitCase $enumCaseReflection,
             new EnumCaseRef(
                 $enumCaseReflection->getDeclaringClass()->getName(),
                 $enumCaseReflection->getName(),
+                false,
             ),
         );
     }

src/Provider/ReflectionBasedMemberUsageProvider.php

@@ -251,6 +251,7 @@ private function createEnumCaseUsage(
             new EnumCaseRef(
                 $className,
                 $enumCaseName,
+                false,
             ),
         );
     }