ClassReflection.php

<?php declare(strict_types = 1);

namespace PHPStan\Reflection;

use Attribute;
use PhpParser\Node\Arg;
use PhpParser\Node\Expr\StaticCall;
use PhpParser\Node\Identifier;
use PhpParser\Node\Name\FullyQualified;
use PHPStan\Analyser\ArgumentsNormalizer;
use PHPStan\Analyser\OutOfClassScope;
use PHPStan\BetterReflection\Reflection\Adapter\ReflectionClass;
use PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnum;
use PHPStan\BetterReflection\Reflection\Adapter\ReflectionEnumBackedCase;
use PHPStan\BetterReflection\Reflection\Adapter\ReflectionMethod;
use PHPStan\DependencyInjection\GenerateFactory;
use PHPStan\DependencyInjection\Reflection\ClassReflectionExtensionRegistryProvider;
use PHPStan\Php\PhpVersion;
use PHPStan\PhpDoc\PhpDocInheritanceResolver;
use PHPStan\PhpDoc\ResolvedPhpDocBlock;
use PHPStan\PhpDoc\StubPhpDocProvider;
use PHPStan\PhpDoc\Tag\ExtendsTag;
use PHPStan\PhpDoc\Tag\ImplementsTag;
use PHPStan\PhpDoc\Tag\MethodTag;
use PHPStan\PhpDoc\Tag\MixinTag;
use PHPStan\PhpDoc\Tag\PropertyTag;
use PHPStan\PhpDoc\Tag\RequireExtendsTag;
use PHPStan\PhpDoc\Tag\RequireImplementsTag;
use PHPStan\PhpDoc\Tag\SealedTypeTag;
use PHPStan\PhpDoc\Tag\TemplateTag;
use PHPStan\PhpDoc\Tag\TypeAliasImportTag;
use PHPStan\PhpDoc\Tag\TypeAliasTag;
use PHPStan\Reflection\Deprecation\DeprecationProvider;
use PHPStan\Reflection\Php\PhpPropertyReflection;
use PHPStan\Reflection\Php\UniversalObjectCratesClassReflectionExtension;
use PHPStan\Reflection\SignatureMap\SignatureMapProvider;
use PHPStan\ShouldNotHappenException;
use PHPStan\Type\CircularTypeAliasDefinitionException;
use PHPStan\Type\Constant\ConstantIntegerType;
use PHPStan\Type\ErrorType;
use PHPStan\Type\FileTypeMapper;
use PHPStan\Type\Generic\GenericObjectType;
use PHPStan\Type\Generic\TemplateType;
use PHPStan\Type\Generic\TemplateTypeFactory;
use PHPStan\Type\Generic\TemplateTypeHelper;
use PHPStan\Type\Generic\TemplateTypeMap;
use PHPStan\Type\Generic\TemplateTypeScope;
use PHPStan\Type\Generic\TemplateTypeVariance;
use PHPStan\Type\Generic\TemplateTypeVarianceMap;
use PHPStan\Type\Generic\TypeProjectionHelper;
use PHPStan\Type\MixedType;
use PHPStan\Type\ObjectType;
use PHPStan\Type\Type;
use PHPStan\Type\TypeAlias;
use PHPStan\Type\TypehintHelper;
use PHPStan\Type\VerbosityLevel;
use ReflectionClass as CoreReflectionClass;
use ReflectionException;
use function array_diff;
use function array_filter;
use function array_key_exists;
use function array_map;
use function array_merge;
use function array_shift;
use function array_unique;
use function array_values;
use function count;
use function implode;
use function in_array;
use function is_bool;
use function is_file;
use function is_int;
use function reset;
use function sprintf;
use function strtolower;

/**
 * @api
 */
#[GenerateFactory(interface: ClassReflectionFactory::class)]
final class ClassReflection
{

	/** @var ExtendedMethodReflection[] */
	private array $methods = [];

	/** @var ExtendedPropertyReflection[] */
	private array $properties = [];

	/** @var ExtendedPropertyReflection[] */
	private array $instanceProperties = [];

	/** @var ExtendedPropertyReflection[] */
	private array $staticProperties = [];

	/** @var RealClassClassConstantReflection[] */
	private array $constants = [];

	/** @var EnumCaseReflection[]|null  */
	private ?array $enumCases = null;

	/** @var int[]|null */
	private ?array $classHierarchyDistances = null;

	private ?string $deprecatedDescription = null;

	private ?bool $isDeprecated = null;

	private ?bool $isGeneric = null;

	private ?bool $isInternal = null;

	private ?bool $isFinal = null;

	private ?bool $isImmutable = null;

	private ?bool $hasConsistentConstructor = null;

	private ?bool $acceptsNamedArguments = null;

	private ?TemplateTypeMap $templateTypeMap = null;

	private ?TemplateTypeMap $activeTemplateTypeMap = null;

	private ?TemplateTypeVarianceMap $defaultCallSiteVarianceMap = null;

	private ?TemplateTypeVarianceMap $callSiteVarianceMap = null;

	/** @var array<string,ClassReflection>|null */
	private ?array $ancestors = null;

	private ?string $cacheKey = null;

	/** @var array<string, bool> */
	private array $subclasses = [];

	private string|false|null $filename = false;

	private string|false|null $reflectionDocComment = false;

	private false|ResolvedPhpDocBlock $resolvedPhpDocBlock = false;

	private false|ResolvedPhpDocBlock $traitContextResolvedPhpDocBlock = false;

	/** @var array<string, ClassReflection>|null */
	private ?array $cachedInterfaces = null;

	private ClassReflection|false|null $cachedParentClass = false;

	/** @var array<string, TypeAlias>|null */
	private ?array $typeAliases = null;

	/** @var array<string, true> */
	private static array $resolvingTypeAliasImports = [];

	/** @var array<string, bool> */
	private array $hasMethodCache = [];

	/** @var array<string, bool> */
	private array $hasPropertyCache = [];

	/** @var array<string, bool> */
	private array $hasInstancePropertyCache = [];

	/** @var array<string, bool> */
	private array $hasStaticPropertyCache = [];

	/**
	 * @param ReflectionClass|ReflectionEnum $reflection
	 */
	public function __construct(
		private ClassReflectionFactory $classReflectionFactory,
		private ReflectionProvider $reflectionProvider,
		private InitializerExprTypeResolver $initializerExprTypeResolver,
		private FileTypeMapper $fileTypeMapper,
		private StubPhpDocProvider $stubPhpDocProvider,
		private PhpDocInheritanceResolver $phpDocInheritanceResolver,
		private PhpVersion $phpVersion,
		private SignatureMapProvider $signatureMapProvider,
		private DeprecationProvider $deprecationProvider,
		private AttributeReflectionFactory $attributeReflectionFactory,
		private ClassReflectionExtensionRegistryProvider $classReflectionExtensionRegistryProvider,
		private string $displayName,
		private CoreReflectionClass $reflection,
		private ?string $anonymousFilename,
		private ?TemplateTypeMap $resolvedTemplateTypeMap,
		private ?ResolvedPhpDocBlock $stubPhpDocBlock,
		private ?string $extraCacheKey = null,
		private ?TemplateTypeVarianceMap $resolvedCallSiteVarianceMap = null,
		private ?bool $finalByKeywordOverride = null,
	)
	{
	}

	public function getNativeReflection(): ReflectionClass|ReflectionEnum
	{
		return $this->reflection;
	}

	public function getFileName(): ?string
	{
		if (!is_bool($this->filename)) {
			return $this->filename;
		}

		if ($this->anonymousFilename !== null) {
			return $this->filename = $this->anonymousFilename;
		}
		$fileName = $this->reflection->getFileName();
		if ($fileName === false) {
			return $this->filename = null;
		}

		if (!is_file($fileName)) {
			return $this->filename = null;
		}

		return $this->filename = $fileName;
	}

	public function getParentClass(): ?ClassReflection
	{
		if (!is_bool($this->cachedParentClass)) {
			return $this->cachedParentClass;
		}

		$parentClass = $this->reflection->getParentClass();

		if ($parentClass === false) {
			return $this->cachedParentClass = null;
		}

		$extendsTag = $this->getFirstExtendsTag();

		if ($extendsTag !== null && $this->isValidAncestorType($extendsTag->getType(), [$parentClass->getName()])) {
			$extendedType = $extendsTag->getType();

			if ($this->isGeneric()) {
				$extendedType = TemplateTypeHelper::resolveTemplateTypes(
					$extendedType,
					$this->getActiveTemplateTypeMapForAncestorResolution(),
					$this->getCallSiteVarianceMap(),
					TemplateTypeVariance::createStatic(),
				);
			}

			if (!$extendedType instanceof GenericObjectType) {
				return $this->reflectionProvider->getClass($parentClass->getName());
			}

			return $extendedType->getClassReflection() ?? $this->reflectionProvider->getClass($parentClass->getName());
		}

		$parentReflection = $this->reflectionProvider->getClass($parentClass->getName());
		if ($parentReflection->isGeneric()) {
			return $parentReflection->withTypes(
				array_values($parentReflection->getTemplateTypeMap()->map(static fn (): Type => new ErrorType())->getTypes()),
			);
		}

		$this->cachedParentClass = $parentReflection;

		return $parentReflection;
	}

	/**
	 * @return class-string
	 */
	public function getName(): string
	{
		return $this->reflection->getName();
	}

	public function getDisplayName(bool $withTemplateTypes = true): string
	{
		if (
			$withTemplateTypes === false
			|| $this->resolvedTemplateTypeMap === null
			|| count($this->resolvedTemplateTypeMap->getTypes()) === 0
		) {
			return $this->displayName;
		}

		$templateTypes = [];
		$variances = $this->getCallSiteVarianceMap()->getVariances();
		foreach ($this->getActiveTemplateTypeMap()->getTypes() as $name => $templateType) {
			$variance = $variances[$name] ?? null;
			if ($variance === null) {
				continue;
			}

			$templateTypes[] = TypeProjectionHelper::describe($templateType, $variance, VerbosityLevel::typeOnly());
		}

		return $this->displayName . '<' . implode(',', $templateTypes) . '>';
	}

	public function getCacheKey(): string
	{
		$cacheKey = $this->cacheKey;
		if ($cacheKey !== null) {
			return $this->cacheKey;
		}

		$cacheKey = $this->displayName;

		if ($this->resolvedTemplateTypeMap !== null) {
			$templateTypes = [];
			$variances = $this->getCallSiteVarianceMap()->getVariances();
			foreach ($this->getActiveTemplateTypeMap()->getTypes() as $name => $templateType) {
				$variance = $variances[$name] ?? null;
				if ($variance === null) {
					continue;
				}

				$templateTypes[] = TypeProjectionHelper::describe($templateType, $variance, VerbosityLevel::cache());
			}

			$cacheKey .= '<' . implode(',', $templateTypes) . '>';
		}

		if ($this->hasFinalByKeywordOverride()) {
			$cacheKey .= '-f=' . ($this->isFinalByKeyword() ? 't' : 'f');
		}

		if ($this->extraCacheKey !== null) {
			$cacheKey .= '-' . $this->extraCacheKey;
		}

		$this->cacheKey = $cacheKey;

		return $cacheKey;
	}

	/**
	 * @return int[]
	 */
	public function getClassHierarchyDistances(): array
	{
		if ($this->classHierarchyDistances === null) {
			$distance = 0;
			$distances = [
				$this->getName() => $distance,
			];
			$currentClassReflection = $this->getNativeReflection();
			foreach ($this->collectTraits($this->getNativeReflection()) as $trait) {
				$distance++;
				if (array_key_exists($trait->getName(), $distances)) {
					continue;
				}

				$distances[$trait->getName()] = $distance;
			}

			while ($currentClassReflection->getParentClass() !== false) {
				$distance++;
				$parentClassName = $currentClassReflection->getParentClass()->getName();
				if (!array_key_exists($parentClassName, $distances)) {
					$distances[$parentClassName] = $distance;
				}
				$currentClassReflection = $currentClassReflection->getParentClass();
				foreach ($this->collectTraits($currentClassReflection) as $trait) {
					$distance++;
					if (array_key_exists($trait->getName(), $distances)) {
						continue;
					}

					$distances[$trait->getName()] = $distance;
				}
			}
			foreach ($this->getNativeReflection()->getInterfaces() as $interface) {
				$distance++;
				if (array_key_exists($interface->getName(), $distances)) {
					continue;
				}

				$distances[$interface->getName()] = $distance;
			}

			$this->classHierarchyDistances = $distances;
		}

		return $this->classHierarchyDistances;
	}

	/**
	 * @return list<ReflectionClass>
	 */
	private function collectTraits(ReflectionClass|ReflectionEnum $class): array
	{
		$traits = [];
		$traitsLeftToAnalyze = $class->getTraits();

		while (count($traitsLeftToAnalyze) !== 0) {
			$trait = reset($traitsLeftToAnalyze);
			$traits[] = $trait;

			foreach ($trait->getTraits() as $subTrait) {
				if (in_array($subTrait, $traits, true)) {
					continue;
				}

				$traitsLeftToAnalyze[] = $subTrait;
			}

			array_shift($traitsLeftToAnalyze);
		}

		return $traits;
	}

	public function allowsDynamicProperties(): bool
	{
		if ($this->isEnum()) {
			return false;
		}

		if (!$this->phpVersion->deprecatesDynamicProperties()) {
			return true;
		}

		$hasMagicMethod = $this->hasNativeMethod('__get') || $this->hasNativeMethod('__set') || $this->hasNativeMethod('__isset');
		if ($hasMagicMethod) {
			return true;
		}

		foreach ($this->getRequireExtendsTags() as $extendsTag) {
			$type = $extendsTag->getType();
			if (!$type instanceof ObjectType) {
				continue;
			}

			$reflection = $type->getClassReflection();
			if ($reflection === null || !$reflection->allowsDynamicProperties()) {
				continue;
			}

			return true;
		}

		if ($this->isReadOnly()) {
			return false;
		}

		if (UniversalObjectCratesClassReflectionExtension::isUniversalObjectCrate(
			$this->reflectionProvider,
			$this,
		)) {
			return true;
		}

		$class = $this;
		do {
			$attributes = $class->reflection->getAttributes('AllowDynamicProperties');
			$class = $class->getParentClass();
		} while ($attributes === [] && $class !== null);

		return $attributes !== [];
	}

	/**
	 * @deprecated Use hasInstanceProperty or hasStaticProperty instead
	 */
	public function hasProperty(string $propertyName): bool
	{
		if (array_key_exists($propertyName, $this->hasPropertyCache)) {
			return $this->hasPropertyCache[$propertyName];
		}

		if ($this->isEnum()) {
			return $this->hasPropertyCache[$propertyName] = $this->hasNativeProperty($propertyName);
		}

		if ($this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->hasProperty($this, $propertyName)) {
			return $this->hasPropertyCache[$propertyName] = true;
		}

		if ($this->allowsDynamicProperties()) {
			foreach ($this->classReflectionExtensionRegistryProvider->getRegistry()->getPropertiesClassReflectionExtensions() as $extension) {
				if ($extension->hasProperty($this, $propertyName)) {
					return $this->hasPropertyCache[$propertyName] = true;
				}
			}
		}

		if ($this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension()->hasProperty($this, $propertyName)) {
			return $this->hasPropertyCache[$propertyName] = true;
		}

		return $this->hasPropertyCache[$propertyName] = false;
	}

	public function hasInstanceProperty(string $propertyName): bool
	{
		if (array_key_exists($propertyName, $this->hasInstancePropertyCache)) {
			return $this->hasInstancePropertyCache[$propertyName];
		}

		if ($this->isEnum()) {
			return $this->hasInstancePropertyCache[$propertyName] = $this->hasNativeProperty($propertyName);
		}

		$phpClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension();
		if ($phpClassReflectionExtension->hasProperty($this, $propertyName)) {
			$property = $phpClassReflectionExtension->getNativeProperty($this, $propertyName);
			if (!$property->isStatic()) {
				return $this->hasInstancePropertyCache[$propertyName] = true;
			}
		}

		if ($this->allowsDynamicProperties()) {
			foreach ($this->classReflectionExtensionRegistryProvider->getRegistry()->getPropertiesClassReflectionExtensions() as $extension) {
				if ($extension->hasProperty($this, $propertyName)) {
					$property = $extension->getProperty($this, $propertyName);
					if ($property->isStatic()) {
						continue;
					}
					return $this->hasInstancePropertyCache[$propertyName] = true;
				}
			}
		}

		if ($this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension()->hasInstanceProperty($this, $propertyName)) {
			return $this->hasPropertyCache[$propertyName] = true;
		}

		return $this->hasPropertyCache[$propertyName] = false;
	}

	public function hasStaticProperty(string $propertyName): bool
	{
		if (array_key_exists($propertyName, $this->hasStaticPropertyCache)) {
			return $this->hasStaticPropertyCache[$propertyName];
		}

		$phpClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension();
		if ($phpClassReflectionExtension->hasProperty($this, $propertyName)) {
			$property = $phpClassReflectionExtension->getNativeProperty($this, $propertyName);
			if ($property->isStatic()) {
				return $this->hasStaticPropertyCache[$propertyName] = true;
			}
		}

		if ($this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension()->hasStaticProperty($this, $propertyName)) {
			return $this->hasStaticPropertyCache[$propertyName] = true;
		}

		return $this->hasStaticPropertyCache[$propertyName] = false;
	}

	public function hasMethod(string $methodName): bool
	{
		if (array_key_exists($methodName, $this->hasMethodCache)) {
			return $this->hasMethodCache[$methodName];
		}

		if ($this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->hasMethod($this, $methodName)) {
			return $this->hasMethodCache[$methodName] = true;
		}

		foreach ($this->classReflectionExtensionRegistryProvider->getRegistry()->getMethodsClassReflectionExtensions() as $extension) {
			if ($extension->hasMethod($this, $methodName)) {
				return $this->hasMethodCache[$methodName] = true;
			}
		}

		if ($this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsMethodsClassReflectionExtension()->hasMethod($this, $methodName)) {
			return $this->hasMethodCache[$methodName] = true;
		}

		return $this->hasMethodCache[$methodName] = false;
	}

	public function getMethod(string $methodName, ClassMemberAccessAnswerer $scope): ExtendedMethodReflection
	{
		$key = $methodName;
		if ($scope->isInClass()) {
			$key = sprintf('%s-%s', $key, $scope->getClassReflection()->getCacheKey());
		}

		$phpClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension();
		if ($phpClassReflectionExtension->hasMethod($this, $methodName)) {
			$method = $phpClassReflectionExtension->getMethod($this, $methodName);
			if ($scope->canCallMethod($method)) {
				return $this->methods[$key] = $method;
			}
			$this->methods[$key] = $method;
		}

		foreach ($this->classReflectionExtensionRegistryProvider->getRegistry()->getMethodsClassReflectionExtensions() as $extension) {
			if (!$extension->hasMethod($this, $methodName)) {
				continue;
			}

			$method = $this->wrapExtendedMethod($extension->getMethod($this, $methodName));
			if ($scope->canCallMethod($method)) {
				return $this->methods[$key] = $method;
			}
			$this->methods[$key] = $method;
		}

		if (!isset($this->methods[$key])) {
			$requireExtendsMethodsClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsMethodsClassReflectionExtension();
			if ($requireExtendsMethodsClassReflectionExtension->hasMethod($this, $methodName)) {
				$method = $requireExtendsMethodsClassReflectionExtension->getMethod($this, $methodName);
				$this->methods[$key] = $method;
			}
		}

		if (!isset($this->methods[$key])) {
			throw new MissingMethodFromReflectionException($this->getName(), $methodName);
		}

		return $this->methods[$key];
	}

	private function wrapExtendedMethod(MethodReflection $method): ExtendedMethodReflection
	{
		if ($method instanceof ExtendedMethodReflection) {
			return $method;
		}

		return new WrappedExtendedMethodReflection($method);
	}

	private function wrapExtendedProperty(string $propertyName, PropertyReflection $method): ExtendedPropertyReflection
	{
		if ($method instanceof ExtendedPropertyReflection) {
			return $method;
		}

		return new WrappedExtendedPropertyReflection($propertyName, $method);
	}

	public function hasNativeMethod(string $methodName): bool
	{
		return $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->hasNativeMethod($this, $methodName);
	}

	public function getNativeMethod(string $methodName): ExtendedMethodReflection
	{
		if (!$this->hasNativeMethod($methodName)) {
			throw new MissingMethodFromReflectionException($this->getName(), $methodName);
		}
		return $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->getNativeMethod($this, $methodName);
	}

	public function hasConstructor(): bool
	{
		return $this->findConstructor() !== null;
	}

	public function getConstructor(): ExtendedMethodReflection
	{
		$constructor = $this->findConstructor();
		if ($constructor === null) {
			throw new ShouldNotHappenException();
		}
		return $this->getNativeMethod($constructor->getName());
	}

	private function findConstructor(): ?ReflectionMethod
	{
		$constructor = $this->reflection->getConstructor();
		if ($constructor === null) {
			return null;
		}

		if ($this->phpVersion->supportsLegacyConstructor()) {
			return $constructor;
		}

		if (strtolower($constructor->getName()) !== '__construct') {
			return null;
		}

		return $constructor;
	}

	/** @internal */
	public function evictPrivateSymbols(): void
	{
		foreach ($this->constants as $name => $constant) {
			if (!$constant->isPrivate()) {
				continue;
			}

			unset($this->constants[$name]);
		}
		foreach ($this->properties as $name => $property) {
			if (!$property->isPrivate()) {
				continue;
			}

			unset($this->properties[$name]);
		}
		foreach ($this->instanceProperties as $name => $property) {
			if (!$property->isPrivate()) {
				continue;
			}

			unset($this->instanceProperties[$name]);
		}
		foreach ($this->staticProperties as $name => $property) {
			if (!$property->isPrivate()) {
				continue;
			}

			unset($this->staticProperties[$name]);
		}
		foreach ($this->methods as $name => $method) {
			if (!$method->isPrivate()) {
				continue;
			}

			unset($this->methods[$name]);
		}
		$this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->evictPrivateSymbols($this->getCacheKey());
	}

	/** @deprecated Use getInstanceProperty or getStaticProperty */
	public function getProperty(string $propertyName, ClassMemberAccessAnswerer $scope): ExtendedPropertyReflection
	{
		if ($this->isEnum()) {
			return $this->getNativeProperty($propertyName);
		}

		$key = $propertyName;
		if ($scope->isInClass()) {
			$key = sprintf('%s-%s', $key, $scope->getClassReflection()->getCacheKey());
		}

		$phpClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension();
		if (!isset($this->properties[$key])) {
			if ($phpClassReflectionExtension->hasProperty($this, $propertyName)) {
				$property = $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->getProperty($this, $propertyName, $scope);
				if ($scope->canReadProperty($property)) {
					return $this->properties[$key] = $property;
				}
				$this->properties[$key] = $property;
			}

			if ($this->allowsDynamicProperties()) {
				foreach ($this->classReflectionExtensionRegistryProvider->getRegistry()->getPropertiesClassReflectionExtensions() as $extension) {
					if (!$extension->hasProperty($this, $propertyName)) {
						continue;
					}

					$property = $this->wrapExtendedProperty($propertyName, $extension->getProperty($this, $propertyName));
					if ($scope->canReadProperty($property)) {
						return $this->properties[$key] = $property;
					}
					$this->properties[$key] = $property;
				}
			}
		}

		// For BC purpose
		if ($phpClassReflectionExtension->hasProperty($this, $propertyName)) {
			$property = $phpClassReflectionExtension->getProperty($this, $propertyName, $scope);

			return $this->properties[$key] = $property;
		}

		if (!isset($this->properties[$key])) {
			$requireExtendsPropertiesClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension();
			if ($requireExtendsPropertiesClassReflectionExtension->hasProperty($this, $propertyName)) {
				$property = $requireExtendsPropertiesClassReflectionExtension->getProperty($this, $propertyName);
				$this->properties[$key] = $property;
			}
		}

		if (!isset($this->properties[$key])) {
			throw new MissingPropertyFromReflectionException($this->getName(), $propertyName);
		}

		return $this->properties[$key];
	}

	public function getInstanceProperty(string $propertyName, ClassMemberAccessAnswerer $scope): ExtendedPropertyReflection
	{
		if ($this->isEnum()) {
			return $this->getNativeProperty($propertyName);
		}

		$key = $propertyName;
		if ($scope->isInClass()) {
			$key = sprintf('%s-%s', $key, $scope->getClassReflection()->getCacheKey());
		}

		if (!isset($this->instanceProperties[$key])) {
			$phpClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension();
			if ($phpClassReflectionExtension->hasProperty($this, $propertyName)) {
				$property = $phpClassReflectionExtension->getProperty($this, $propertyName, $scope);
				if (!$property->isStatic()) {
					if ($scope->canReadProperty($property)) {
						return $this->instanceProperties[$key] = $property;
					}
					$this->instanceProperties[$key] = $property;
				}
			}

			if ($this->allowsDynamicProperties()) {
				foreach ($this->classReflectionExtensionRegistryProvider->getRegistry()->getPropertiesClassReflectionExtensions() as $extension) {
					if (!$extension->hasProperty($this, $propertyName)) {
						continue;
					}

					$nakedProperty = $extension->getProperty($this, $propertyName);
					if ($nakedProperty->isStatic()) {
						continue;
					}

					$property = $this->wrapExtendedProperty($propertyName, $nakedProperty);
					if ($scope->canReadProperty($property)) {
						return $this->instanceProperties[$key] = $property;
					}
					$this->instanceProperties[$key] = $property;
				}
			}
		}

		if (!isset($this->instanceProperties[$key])) {
			$requireExtendsPropertiesClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension();
			if ($requireExtendsPropertiesClassReflectionExtension->hasInstanceProperty($this, $propertyName)) {
				$property = $requireExtendsPropertiesClassReflectionExtension->getInstanceProperty($this, $propertyName);
				$this->instanceProperties[$key] = $property;
			}
		}

		if (!isset($this->instanceProperties[$key])) {
			throw new MissingPropertyFromReflectionException($this->getName(), $propertyName);
		}

		return $this->instanceProperties[$key];
	}

	public function getStaticProperty(string $propertyName): ExtendedPropertyReflection
	{
		$key = $propertyName;
		if (isset($this->staticProperties[$key])) {
			return $this->staticProperties[$key];
		}

		$phpClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension();
		if ($phpClassReflectionExtension->hasProperty($this, $propertyName)) {
			$nakedProperty = $phpClassReflectionExtension->getProperty($this, $propertyName, new OutOfClassScope());
			if ($nakedProperty->isStatic()) {
				$property = $this->wrapExtendedProperty($propertyName, $nakedProperty);
				if ($property->isStatic()) {
					return $this->staticProperties[$key] = $property;
				}
			}
		}

		$requireExtendsPropertiesClassReflectionExtension = $this->classReflectionExtensionRegistryProvider->getRegistry()->getRequireExtendsPropertyClassReflectionExtension();
		if ($requireExtendsPropertiesClassReflectionExtension->hasStaticProperty($this, $propertyName)) {
			$property = $requireExtendsPropertiesClassReflectionExtension->getStaticProperty($this, $propertyName);
			return $this->staticProperties[$key] = $property;
		}

		throw new MissingPropertyFromReflectionException($this->getName(), $propertyName);
	}

	public function hasNativeProperty(string $propertyName): bool
	{
		return $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->hasProperty($this, $propertyName);
	}

	public function getNativeProperty(string $propertyName): PhpPropertyReflection
	{
		if (!$this->hasNativeProperty($propertyName)) {
			throw new MissingPropertyFromReflectionException($this->getName(), $propertyName);
		}

		return $this->classReflectionExtensionRegistryProvider->getRegistry()->getPhpClassReflectionExtension()->getNativeProperty($this, $propertyName);
	}

	public function isAbstract(): bool
	{
		return $this->reflection->isAbstract();
	}

	public function isInterface(): bool
	{
		return $this->reflection->isInterface();
	}

	public function isTrait(): bool
	{
		return $this->reflection->isTrait();
	}

	/**
	 * @phpstan-assert-if-true ReflectionEnum $this->reflection
	 * @phpstan-assert-if-true ReflectionEnum $this->getNativeReflection()
	 */
	public function isEnum(): bool
	{
		return $this->reflection instanceof ReflectionEnum && $this->reflection->isEnum();
	}

	/**
	 * @return 'Interface'|'Trait'|'Enum'|'Class'
	 */
	public function getClassTypeDescription(): string
	{
		if ($this->isInterface()) {
			return 'Interface';
		} elseif ($this->isTrait()) {
			return 'Trait';
		} elseif ($this->isEnum()) {
			return 'Enum';
		}

		return 'Class';
	}

	public function isReadOnly(): bool
	{
		return $this->reflection->isReadOnly();
	}

	public function isBackedEnum(): bool
	{
		if (!$this->reflection instanceof ReflectionEnum) {
			return false;
		}

		return $this->reflection->isBacked();
	}

	public function getBackedEnumType(): ?Type
	{
		if (!$this->reflection instanceof ReflectionEnum) {
			return null;
		}

		if (!$this->reflection->isBacked()) {
			return null;
		}

		return TypehintHelper::decideTypeFromReflection($this->reflection->getBackingType());
	}

	public function hasEnumCase(string $name): bool
	{
		if (!$this->isEnum()) {
			return false;
		}

		return $this->reflection->hasCase($name);
	}

	/**
	 * @return array<string, EnumCaseReflection>
	 */
	public function getEnumCases(): array
	{
		if (!$this->isEnum()) {
			throw new ShouldNotHappenException();
		}

		if ($this->enumCases !== null) {
			return $this->enumCases;
		}

		$cases = [];
		$initializerExprContext = InitializerExprContext::fromClassReflection($this);
		foreach ($this->reflection->getCases() as $case) {
			$valueType = null;
			if ($case instanceof ReflectionEnumBackedCase && $case->hasBackingValue()) {
				$valueType = $this->initializerExprTypeResolver->getType($case->getValueExpression(), $initializerExprContext);
			}
			$caseName = $case->getName();
			$attributes = $this->attributeReflectionFactory->fromNativeReflection($case->getAttributes(), InitializerExprContext::fromClass($this->getName(), $this->getFileName()));
			$cases[$caseName] = new EnumCaseReflection($this, $case, $valueType, $attributes, $this->deprecationProvider);
		}

		return $this->enumCases = $cases;
	}

	public function getEnumCase(string $name): EnumCaseReflection
	{
		if (!$this->hasEnumCase($name)) {
			throw new ShouldNotHappenException(sprintf('Enum case %s::%s does not exist.', $this->getDisplayName(), $name));
		}

		if (!$this->reflection instanceof ReflectionEnum) {
			throw new ShouldNotHappenException();
		}

		if ($this->enumCases !== null && array_key_exists($name, $this->enumCases)) {
			return $this->enumCases[$name];
		}

		$case = $this->reflection->getCase($name);
		$valueType = null;
		if ($case instanceof ReflectionEnumBackedCase && $case->hasBackingValue()) {
			$valueType = $this->initializerExprTypeResolver->getType($case->getValueExpression(), InitializerExprContext::fromClassReflection($this));
		}

		$attributes = $this->attributeReflectionFactory->fromNativeReflection($case->getAttributes(), InitializerExprContext::fromClass($this->getName(), $this->getFileName()));

		return new EnumCaseReflection($this, $case, $valueType, $attributes, $this->deprecationProvider);
	}

	public function isClass(): bool
	{
		return !$this->isInterface() && !$this->isTrait() && !$this->isEnum();
	}

	public function isAnonymous(): bool
	{
		return $this->anonymousFilename !== null;
	}

	public function is(string $className): bool
	{
		return $this->getName() === $className || $this->isSubclassOf($className);
	}

	/**
	 * @deprecated Use isSubclassOfClass instead.
	 */
	public function isSubclassOf(string $className): bool
	{
		if (!$this->reflectionProvider->hasClass($className)) {
			return false;
		}

		return $this->isSubclassOfClass($this->reflectionProvider->getClass($className));
	}

	public function isSubclassOfClass(self $class): bool
	{
		$cacheKey = $class->getCacheKey();
		if (isset($this->subclasses[$cacheKey])) {
			return $this->subclasses[$cacheKey];
		}

		if ($class->isFinalByKeyword() || $class->isAnonymous()) {
			return $this->subclasses[$cacheKey] = false;
		}

		try {
			return $this->subclasses[$cacheKey] = $this->reflection->isSubclassOf($class->getName());
		} catch (ReflectionException) {
			return $this->subclasses[$cacheKey] = false;
		}
	}

	public function implementsInterface(string $className): bool
	{
		try {
			return $this->reflection->implementsInterface($className);
		} catch (ReflectionException) {
			return false;
		}
	}

	/**
	 * @return list<ClassReflection>
	 */
	public function getParents(): array
	{
		$parents = [];
		$parent = $this->getParentClass();
		while ($parent !== null) {
			$parents[] = $parent;
			$parent = $parent->getParentClass();
		}

		return $parents;
	}

	/**
	 * @return array<string, ClassReflection>
	 */
	public function getInterfaces(): array
	{
		if ($this->cachedInterfaces !== null) {
			return $this->cachedInterfaces;
		}

		$interfaces = $this->getImmediateInterfaces();
		$immediateInterfaces = $interfaces;
		$parent = $this->getParentClass();
		while ($parent !== null) {
			foreach ($parent->getImmediateInterfaces() as $parentInterface) {
				$interfaces[$parentInterface->getName()] = $parentInterface;
				foreach ($this->collectInterfaces($parentInterface) as $parentInterfaceInterface) {
					$interfaces[$parentInterfaceInterface->getName()] = $parentInterfaceInterface;
				}
			}

			$parent = $parent->getParentClass();
		}

		foreach ($immediateInterfaces as $immediateInterface) {
			foreach ($this->collectInterfaces($immediateInterface) as $interfaceInterface) {
				$interfaces[$interfaceInterface->getName()] = $interfaceInterface;
			}
		}

		$this->cachedInterfaces = $interfaces;

		return $interfaces;
	}

	/**
	 * @return array<string, ClassReflection>
	 */
	private function collectInterfaces(ClassReflection $interface): array
	{
		$interfaces = [];
		foreach ($interface->getImmediateInterfaces() as $immediateInterface) {
			$interfaces[$immediateInterface->getName()] = $immediateInterface;
			foreach ($this->collectInterfaces($immediateInterface) as $immediateInterfaceInterface) {
				$interfaces[$immediateInterfaceInterface->getName()] = $immediateInterfaceInterface;
			}
		}

		return $interfaces;
	}

	/**
	 * @return array<string, ClassReflection>
	 */
	public function getImmediateInterfaces(): array
	{
		$indirectInterfaceNames = [];
		$parent = $this->getParentClass();
		while ($parent !== null) {
			foreach ($parent->getNativeReflection()->getInterfaceNames() as $parentInterfaceName) {
				$indirectInterfaceNames[] = $parentInterfaceName;
			}

			$parent = $parent->getParentClass();
		}

		foreach ($this->getNativeReflection()->getInterfaces() as $interfaceInterface) {
			foreach ($interfaceInterface->getInterfaceNames() as $interfaceInterfaceName) {
				$indirectInterfaceNames[] = $interfaceInterfaceName;
			}
		}

		if ($this->reflection->isInterface()) {
			$implementsTags = $this->getExtendsTags();
		} else {
			$implementsTags = $this->getImplementsTags();
		}

		$immediateInterfaceNames = array_diff($this->getNativeReflection()->getInterfaceNames(), $indirectInterfaceNames);
		$immediateInterfaces = [];
		foreach ($immediateInterfaceNames as $immediateInterfaceName) {
			if (!$this->reflectionProvider->hasClass($immediateInterfaceName)) {
				continue;
			}

			$immediateInterface = $this->reflectionProvider->getClass($immediateInterfaceName);
			if (array_key_exists($immediateInterface->getName(), $implementsTags)) {
				$implementsTag = $implementsTags[$immediateInterface->getName()];
				$implementedType = $implementsTag->getType();
				if ($this->isGeneric()) {
					$implementedType = TemplateTypeHelper::resolveTemplateTypes(
						$implementedType,
						$this->getActiveTemplateTypeMapForAncestorResolution(),
						$this->getCallSiteVarianceMap(),
						TemplateTypeVariance::createStatic(),
						true,
					);
				}

				if (
					$implementedType instanceof GenericObjectType
					&& $implementedType->getClassReflection() !== null
				) {
					$immediateInterfaces[$immediateInterface->getName()] = $implementedType->getClassReflection();
					continue;
				}
			}

			if ($immediateInterface->isGeneric()) {
				$immediateInterfaces[$immediateInterface->getName()] = $immediateInterface->withTypes(
					array_values($immediateInterface->getTemplateTypeMap()->map(static fn (): Type => new ErrorType())->getTypes()),
				);
				continue;
			}

			$immediateInterfaces[$immediateInterface->getName()] = $immediateInterface;
		}

		return $immediateInterfaces;
	}

	/**
	 * @return array<string, ClassReflection>
	 */
	public function getTraits(bool $recursive = false): array
	{
		$traits = [];

		if ($recursive) {
			foreach ($this->collectTraits($this->getNativeReflection()) as $trait) {
				$traits[$trait->getName()] = $trait;
			}
		} else {
			$traits = $this->getNativeReflection()->getTraits();
		}

		$traits = array_map(fn (ReflectionClass $trait): ClassReflection => $this->reflectionProvider->getClass($trait->getName()), $traits);

		if ($recursive) {
			$parentClass = $this->getNativeReflection()->getParentClass();

			if ($parentClass !== false) {
				return array_merge(
					$traits,
					$this->reflectionProvider->getClass($parentClass->getName())->getTraits(true),
				);
			}
		}

		return $traits;
	}

	/**
	 * @return list<class-string>
	 */
	public function getParentClassesNames(): array
	{
		$parentNames = [];
		$parentClass = $this->getParentClass();
		while ($parentClass !== null) {
			$parentNames[] = $parentClass->getName();
			$parentClass = $parentClass->getParentClass();
		}

		return $parentNames;
	}

	public function hasConstant(string $name): bool
	{
		if (!$this->getNativeReflection()->hasConstant($name)) {
			return false;
		}

		$reflectionConstant = $this->getNativeReflection()->getReflectionConstant($name);
		if ($reflectionConstant === false) {
			return false;
		}

		return $this->reflectionProvider->hasClass($reflectionConstant->getDeclaringClass()->getName());
	}

	public function getConstant(string $name): ClassConstantReflection
	{
		if (!isset($this->constants[$name])) {
			$reflectionConstant = $this->getNativeReflection()->getReflectionConstant($name);
			if ($reflectionConstant === false) {
				throw new MissingConstantFromReflectionException($this->getName(), $name);
			}

			$deprecation = $this->deprecationProvider->getClassConstantDeprecation($reflectionConstant);
			$deprecatedDescription = $deprecation === null ? null : $deprecation->getDescription();
			$isDeprecated = $deprecation !== null;

			$declaringClass = $this->getAncestorWithClassName($reflectionConstant->getDeclaringClass()->getName());
			if ($declaringClass === null) {
				throw new ShouldNotHappenException();
			}
			$fileName = $declaringClass->getFileName();
			$phpDocType = null;
			$currentResolvedPhpDoc = $this->stubPhpDocProvider->findClassConstantPhpDoc(
				$declaringClass->getName(),
				$name,
			);
			if ($currentResolvedPhpDoc === null) {
				if ($reflectionConstant->getDocComment() !== false) {
					$currentResolvedPhpDoc = $this->fileTypeMapper->getResolvedPhpDoc(
						$fileName,
						$declaringClass->getName(),
						null,
						null,
						$reflectionConstant->getDocComment(),
					);
				}

			}

			$nativeType = null;
			if ($reflectionConstant->getType() !== null) {
				$nativeType = TypehintHelper::decideTypeFromReflection($reflectionConstant->getType(), selfClass: $declaringClass);
			} elseif ($this->signatureMapProvider->hasClassConstantMetadata($declaringClass->getName(), $name)) {
				$nativeType = $this->signatureMapProvider->getClassConstantMetadata($declaringClass->getName(), $name)['nativeType'];
			}

			$resolvedPhpDoc = $this->phpDocInheritanceResolver->resolvePhpDocForConstant(
				$declaringClass,
				$name,
				$currentResolvedPhpDoc,
			);

			$isInternal = false;
			$isFinal = false;
			if ($resolvedPhpDoc !== null) {
				if (!$isDeprecated) {
					$deprecatedDescription = $resolvedPhpDoc->getDeprecatedTag() !== null ? $resolvedPhpDoc->getDeprecatedTag()->getMessage() : null;
					$isDeprecated = $resolvedPhpDoc->isDeprecated();
				}
				$isInternal = $resolvedPhpDoc->isInternal();
				$isFinal = $resolvedPhpDoc->isFinal();
				$varTags = $resolvedPhpDoc->getVarTags();
				if (isset($varTags[0]) && count($varTags) === 1) {
					$varTag = $varTags[0];
					if ($varTag->isExplicit() || $nativeType === null || $nativeType->isSuperTypeOf($varTag->getType())->yes()) {
						$phpDocType = TemplateTypeHelper::resolveTemplateTypes(
							$varTag->getType(),
							$declaringClass->getActiveTemplateTypeMap(),
							$declaringClass->getCallSiteVarianceMap(),
							TemplateTypeVariance::createInvariant(),
						);
					}
				}
			}

			$this->constants[$name] = new RealClassClassConstantReflection(
				$this->initializerExprTypeResolver,
				$declaringClass,
				$reflectionConstant,
				$nativeType,
				$phpDocType,
				$resolvedPhpDoc,
				$deprecatedDescription,
				$isDeprecated,
				$isInternal,
				$isFinal,
				$this->attributeReflectionFactory->fromNativeReflection($reflectionConstant->getAttributes(), InitializerExprContext::fromClass($declaringClass->getName(), $fileName)),
			);
		}
		return $this->constants[$name];
	}

	public function hasTraitUse(string $traitName): bool
	{
		return in_array($traitName, $this->getTraitNames(), true);
	}

	/**
	 * @return list<string>
	 */
	private function getTraitNames(): array
	{
		$class = $this->reflection;
		$traitNames = array_map(static fn (ReflectionClass $class) => $class->getName(), $this->collectTraits($class));
		while ($class->getParentClass() !== false) {
			$traitNames = array_values(array_unique(array_merge($traitNames, $class->getParentClass()->getTraitNames())));
			$class = $class->getParentClass();
		}

		return $traitNames;
	}

	/**
	 * @return array<string, TypeAlias>
	 */
	public function getTypeAliases(): array
	{
		if ($this->typeAliases === null) {
			$resolvedPhpDoc = $this->getResolvedPhpDoc();
			if ($resolvedPhpDoc === null) {
				return $this->typeAliases = [];
			}

			$typeAliasImportTags = $resolvedPhpDoc->getTypeAliasImportTags();
			$typeAliasTags = $resolvedPhpDoc->getTypeAliasTags();
			$localAliases = array_map(static fn (TypeAliasTag $typeAliasTag): TypeAlias => $typeAliasTag->getTypeAlias(), $typeAliasTags);

			// prevent circular imports
			if (array_key_exists($this->getName(), self::$resolvingTypeAliasImports)) {
				if ($localAliases !== []) {
					return $this->typeAliases = $localAliases;
				}
				throw new CircularTypeAliasDefinitionException();
			}

			self::$resolvingTypeAliasImports[$this->getName()] = true;

			$importedAliases = array_map(function (TypeAliasImportTag $typeAliasImportTag): ?TypeAlias {
				$importedAlias = $typeAliasImportTag->getImportedAlias();
				$importedFromClassName = $typeAliasImportTag->getImportedFrom();

				if (!$this->reflectionProvider->hasClass($importedFromClassName)) {
					return null;
				}

				$importedFromReflection = $this->reflectionProvider->getClass($importedFromClassName);

				try {
					$typeAliases = $importedFromReflection->getTypeAliases();
				} catch (CircularTypeAliasDefinitionException) {
					return TypeAlias::invalid();
				}

				if (!array_key_exists($importedAlias, $typeAliases)) {
					return null;
				}

				return $typeAliases[$importedAlias];
			}, $typeAliasImportTags);

			unset(self::$resolvingTypeAliasImports[$this->getName()]);

			$this->typeAliases = array_filter(
				array_merge($importedAliases, $localAliases),
				static fn (?TypeAlias $typeAlias): bool => $typeAlias !== null,
			);
		}

		return $this->typeAliases;
	}

	public function getDeprecatedDescription(): ?string
	{
		if ($this->isDeprecated === null) {
			$this->resolveDeprecation();
		}

		return $this->deprecatedDescription;
	}

	public function isDeprecated(): bool
	{
		if ($this->isDeprecated === null) {
			$this->resolveDeprecation();
		}

		return $this->isDeprecated;
	}

	/**
	 * @phpstan-assert bool $this->isDeprecated
	 */
	private function resolveDeprecation(): void
	{
		$deprecation = $this->deprecationProvider->getClassDeprecation($this->reflection);
		if ($deprecation !== null) {
			$this->isDeprecated = true;
			$this->deprecatedDescription = $deprecation->getDescription();
			return;
		}

		$resolvedPhpDoc = $this->getResolvedPhpDoc();

		if ($resolvedPhpDoc !== null && $resolvedPhpDoc->isDeprecated()) {
			$this->isDeprecated = true;
			$this->deprecatedDescription = $resolvedPhpDoc->getDeprecatedTag() !== null ? $resolvedPhpDoc->getDeprecatedTag()->getMessage() : null;
			return;
		}

		if ($this->isTrait() && count($this->getNativeReflection()->getAttributes('Deprecated')) > 0) {
			$this->isDeprecated = true;
			$this->deprecatedDescription = null;
			return;
		}

		$this->isDeprecated = false;
		$this->deprecatedDescription = null;
	}

	public function isBuiltin(): bool
	{
		return $this->reflection->isInternal();
	}

	public function isInternal(): bool
	{
		if ($this->isInternal === null) {
			$resolvedPhpDoc = $this->getResolvedPhpDoc();
			$this->isInternal = $resolvedPhpDoc !== null && $resolvedPhpDoc->isInternal();
		}

		return $this->isInternal;
	}

	public function isFinal(): bool
	{
		if ($this->isFinalByKeyword()) {
			return true;
		}

		if ($this->isFinal === null) {
			$resolvedPhpDoc = $this->getResolvedPhpDoc();
			$this->isFinal = $resolvedPhpDoc !== null && $resolvedPhpDoc->isFinal();
		}

		return $this->isFinal;
	}

	public function isImmutable(): bool
	{
		if ($this->isImmutable === null) {
			$resolvedPhpDoc = $this->getResolvedPhpDoc();
			$this->isImmutable = $resolvedPhpDoc !== null && ($resolvedPhpDoc->isImmutable() || $resolvedPhpDoc->isReadOnly());

			$parentClass = $this->getParentClass();
			if ($parentClass !== null && !$this->isImmutable) {
				$this->isImmutable = $parentClass->isImmutable();
			}
		}

		return $this->isImmutable;
	}

	public function hasConsistentConstructor(): bool
	{
		if ($this->hasConsistentConstructor === null) {
			$resolvedPhpDoc = $this->getResolvedPhpDoc();
			$this->hasConsistentConstructor = $resolvedPhpDoc !== null && $resolvedPhpDoc->hasConsistentConstructor();
		}

		return $this->hasConsistentConstructor;
	}

	public function acceptsNamedArguments(): bool
	{
		if ($this->acceptsNamedArguments === null) {
			$resolvedPhpDoc = $this->getResolvedPhpDoc();
			$this->acceptsNamedArguments = $resolvedPhpDoc === null || $resolvedPhpDoc->acceptsNamedArguments();
		}

		return $this->acceptsNamedArguments;
	}

	public function hasFinalByKeywordOverride(): bool
	{
		return $this->finalByKeywordOverride !== null;
	}

	public function isFinalByKeyword(): bool
	{
		if ($this->isAnonymous()) {
			return true;
		}

		if ($this->finalByKeywordOverride !== null) {
			return $this->finalByKeywordOverride;
		}

		return $this->reflection->isFinal();
	}

	public function isAttributeClass(): bool
	{
		return $this->findAttributeFlags() !== null;
	}

	private function findAttributeFlags(): ?int
	{
		if ($this->isInterface() || $this->isTrait() || $this->isEnum()) {
			return null;
		}

		$nativeAttributes = $this->reflection->getAttributes(Attribute::class);
		if (count($nativeAttributes) === 1) {
			if (!$this->reflectionProvider->hasClass(Attribute::class)) {
				return null;
			}

			$attributeClass = $this->reflectionProvider->getClass(Attribute::class);
			$arguments = [];
			foreach ($nativeAttributes[0]->getArgumentsExpressions() as $i => $expression) {
				if ($i === '') {
					throw new ShouldNotHappenException();
				}
				$arguments[] = new Arg($expression, name: is_int($i) ? null : new Identifier($i));
			}

			if (!$attributeClass->hasConstructor()) {
				return null;
			}
			$attributeConstructor = $attributeClass->getConstructor();
			$attributeConstructorVariant = $attributeConstructor->getOnlyVariant();

			if (count($arguments) === 0) {
				$flagType = $attributeConstructorVariant->getParameters()[0]->getDefaultValue();
			} else {
				$staticCall = ArgumentsNormalizer::reorderStaticCallArguments(
					$attributeConstructorVariant,
					new StaticCall(new FullyQualified(Attribute::class), $attributeConstructor->getName(), $arguments),
				);
				if ($staticCall === null) {
					return null;
				}
				$flagExpr = $staticCall->getArgs()[0]->value;
				$flagType = $this->initializerExprTypeResolver->getType($flagExpr, InitializerExprContext::fromClassReflection($this));
			}

			if (!$flagType instanceof ConstantIntegerType) {
				return null;
			}

			return $flagType->getValue();
		}

		return null;
	}

	/**
	 * @return list<AttributeReflection>
	 */
	public function getAttributes(): array
	{
		return $this->attributeReflectionFactory->fromNativeReflection($this->reflection->getAttributes(), InitializerExprContext::fromClass($this->getName(), $this->getFileName()));
	}

	public function getAttributeClassFlags(): int
	{
		$flags = $this->findAttributeFlags();
		if ($flags === null) {
			throw new ShouldNotHappenException();
		}

		return $flags;
	}

	public function getObjectType(): ObjectType
	{
		if (!$this->isGeneric()) {
			return new ObjectType($this->getName());
		}

		return new GenericObjectType(
			$this->getName(),
			$this->typeMapToList($this->getActiveTemplateTypeMap()),
			variances: $this->varianceMapToList($this->getCallSiteVarianceMap()),
		);
	}

	public function getTemplateTypeMap(): TemplateTypeMap
	{
		if ($this->templateTypeMap !== null) {
			return $this->templateTypeMap;
		}

		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			$this->templateTypeMap = TemplateTypeMap::createEmpty();
			return $this->templateTypeMap;
		}

		$templateTypeScope = TemplateTypeScope::createWithClass($this->getName());

		$templateTypeMap = new TemplateTypeMap(array_map(static fn (TemplateTag $tag): Type => TemplateTypeFactory::fromTemplateTag($templateTypeScope, $tag), $this->getTemplateTags()));

		$this->templateTypeMap = $templateTypeMap;

		return $templateTypeMap;
	}

	public function getActiveTemplateTypeMap(): TemplateTypeMap
	{
		if ($this->activeTemplateTypeMap !== null) {
			return $this->activeTemplateTypeMap;
		}
		$resolved = $this->resolvedTemplateTypeMap;
		if ($resolved !== null) {
			$templateTypeMap = $this->getTemplateTypeMap();
			return $this->activeTemplateTypeMap = $resolved->map(static function (string $name, Type $type) use ($templateTypeMap): Type {
				if ($type instanceof ErrorType) {
					$templateType = $templateTypeMap->getType($name);
					if ($templateType !== null) {
						return TemplateTypeHelper::resolveToDefaults($templateType);
					}
				}

				return $type;
			});
		}

		return $this->activeTemplateTypeMap = $this->getTemplateTypeMap();
	}

	public function getPossiblyIncompleteActiveTemplateTypeMap(): TemplateTypeMap
	{
		return $this->resolvedTemplateTypeMap ?? $this->getTemplateTypeMap();
	}

	/**
	 * Returns a template type map for resolving ancestor type declarations (@extends, @implements).
	 * Like getPossiblyIncompleteActiveTemplateTypeMap(), but resolves ErrorType entries
	 * to their template bounds when the bound is not mixed. This ensures that when a child
	 * class narrows a template bound (e.g. `@template T of SpecificType`), the narrowed bound
	 * is propagated to ancestor declarations instead of being lost as ErrorType.
	 */
	private function getActiveTemplateTypeMapForAncestorResolution(): TemplateTypeMap
	{
		$map = $this->getPossiblyIncompleteActiveTemplateTypeMap();
		$templateTypeMap = $this->getTemplateTypeMap();

		return $map->map(static function (string $name, Type $type) use ($templateTypeMap): Type {
			if (!$type instanceof ErrorType) {
				return $type;
			}

			$templateType = $templateTypeMap->getType($name);
			if (!$templateType instanceof TemplateType) {
				return $type;
			}

			$bound = $templateType->getBound();
			if ($bound instanceof MixedType) {
				return $type;
			}

			return TemplateTypeHelper::resolveToDefaults($templateType);
		});
	}

	private function getDefaultCallSiteVarianceMap(): TemplateTypeVarianceMap
	{
		if ($this->defaultCallSiteVarianceMap !== null) {
			return $this->defaultCallSiteVarianceMap;
		}

		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			$this->defaultCallSiteVarianceMap = TemplateTypeVarianceMap::createEmpty();
			return $this->defaultCallSiteVarianceMap;
		}

		$map = [];
		foreach ($this->getTemplateTags() as $templateTag) {
			$map[$templateTag->getName()] = TemplateTypeVariance::createInvariant();
		}

		$this->defaultCallSiteVarianceMap = new TemplateTypeVarianceMap($map);
		return $this->defaultCallSiteVarianceMap;
	}

	public function getCallSiteVarianceMap(): TemplateTypeVarianceMap
	{
		return $this->callSiteVarianceMap ??= $this->resolvedCallSiteVarianceMap ?? $this->getDefaultCallSiteVarianceMap();
	}

	public function isGeneric(): bool
	{
		if ($this->isGeneric === null) {
			if ($this->isEnum()) {
				return $this->isGeneric = false;
			}

			$this->isGeneric = count($this->getTemplateTags()) > 0;
		}

		return $this->isGeneric;
	}

	/**
	 * @param array<int, Type> $types
	 */
	public function typeMapFromList(array $types): TemplateTypeMap
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return TemplateTypeMap::createEmpty();
		}

		$map = [];
		$i = 0;
		$className = $this->getName();
		foreach ($resolvedPhpDoc->getTemplateTags() as $tag) {
			$type = $types[$i] ?? $tag->getDefault() ?? $tag->getBound();
			if ($type instanceof TemplateType && $type->getScope()->getClassName() === $className) {
				$resolved = $map[$type->getName()] ?? null;
				if ($resolved !== null && !$resolved instanceof TemplateType) {
					$type = $resolved;
				}
			}
			$map[$tag->getName()] = $type;
			$i++;
		}

		return new TemplateTypeMap($map);
	}

	/**
	 * @param array<int, TemplateTypeVariance> $variances
	 */
	public function varianceMapFromList(array $variances): TemplateTypeVarianceMap
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return new TemplateTypeVarianceMap([]);
		}

		$map = [];
		$i = 0;
		foreach ($resolvedPhpDoc->getTemplateTags() as $tag) {
			$map[$tag->getName()] = $variances[$i] ?? TemplateTypeVariance::createInvariant();
			$i++;
		}

		return new TemplateTypeVarianceMap($map);
	}

	/** @return list<Type> */
	public function typeMapToList(TemplateTypeMap $typeMap): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		$list = [];
		foreach ($resolvedPhpDoc->getTemplateTags() as $tag) {
			$list[] = $typeMap->getType($tag->getName()) ?? $tag->getDefault() ?? $tag->getBound();
		}

		return $list;
	}

	/** @return list<TemplateTypeVariance> */
	public function varianceMapToList(TemplateTypeVarianceMap $varianceMap): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		$list = [];
		foreach ($resolvedPhpDoc->getTemplateTags() as $tag) {
			$list[] = $varianceMap->getVariance($tag->getName()) ?? TemplateTypeVariance::createInvariant();
		}

		return $list;
	}

	/**
	 * @param array<int, Type> $types
	 */
	public function withTypes(array $types): self
	{
		return $this->classReflectionFactory->create(
			$this->displayName,
			$this->reflection,
			$this->anonymousFilename,
			$this->typeMapFromList($types),
			$this->stubPhpDocBlock,
			null,
			$this->resolvedCallSiteVarianceMap,
			$this->finalByKeywordOverride,
		);
	}

	/**
	 * @param array<int, TemplateTypeVariance> $variances
	 */
	public function withVariances(array $variances): self
	{
		return $this->classReflectionFactory->create(
			$this->displayName,
			$this->reflection,
			$this->anonymousFilename,
			$this->resolvedTemplateTypeMap,
			$this->stubPhpDocBlock,
			null,
			$this->varianceMapFromList($variances),
			$this->finalByKeywordOverride,
		);
	}

	public function asFinal(): self
	{
		if ($this->getNativeReflection()->isFinal()) {
			return $this;
		}
		if ($this->finalByKeywordOverride === true) {
			return $this;
		}
		if (!$this->isClass()) {
			return $this;
		}
		if ($this->isAbstract()) {
			return $this;
		}

		return $this->classReflectionFactory->create(
			$this->displayName,
			$this->reflection,
			$this->anonymousFilename,
			$this->resolvedTemplateTypeMap,
			$this->stubPhpDocBlock,
			null,
			$this->resolvedCallSiteVarianceMap,
			true,
		);
	}

	public function removeFinalKeywordOverride(): self
	{
		if ($this->getNativeReflection()->isFinal()) {
			return $this;
		}
		if ($this->finalByKeywordOverride === false) {
			return $this;
		}
		if (!$this->isClass()) {
			return $this;
		}
		if ($this->isAbstract()) {
			return $this;
		}

		return $this->classReflectionFactory->create(
			$this->displayName,
			$this->reflection,
			$this->anonymousFilename,
			$this->resolvedTemplateTypeMap,
			$this->stubPhpDocBlock,
			null,
			$this->resolvedCallSiteVarianceMap,
			false,
		);
	}

	public function getResolvedPhpDoc(): ?ResolvedPhpDocBlock
	{
		if ($this->stubPhpDocBlock !== null) {
			return $this->stubPhpDocBlock;
		}

		$fileName = $this->getFileName();
		if (is_bool($this->reflectionDocComment)) {
			$docComment = $this->reflection->getDocComment();
			$this->reflectionDocComment = $docComment !== false ? $docComment : null;
		}

		if ($this->reflectionDocComment === null) {
			return null;
		}

		if ($this->resolvedPhpDocBlock !== false) {
			return $this->resolvedPhpDocBlock;
		}

		return $this->resolvedPhpDocBlock = $this->fileTypeMapper->getResolvedPhpDoc($fileName, $this->getName(), null, null, $this->reflectionDocComment);
	}

	public function getTraitContextResolvedPhpDoc(self $implementingClass): ?ResolvedPhpDocBlock
	{
		if (!$this->isTrait()) {
			throw new ShouldNotHappenException();
		}
		if ($implementingClass->isTrait()) {
			throw new ShouldNotHappenException();
		}
		$fileName = $this->getFileName();
		if (is_bool($this->reflectionDocComment)) {
			$docComment = $this->reflection->getDocComment();
			$this->reflectionDocComment = $docComment !== false ? $docComment : null;
		}

		if ($this->reflectionDocComment === null) {
			return null;
		}

		if ($this->traitContextResolvedPhpDocBlock !== false) {
			return $this->traitContextResolvedPhpDocBlock;
		}

		return $this->traitContextResolvedPhpDocBlock = $this->fileTypeMapper->getResolvedPhpDoc($fileName, $implementingClass->getName(), $this->getName(), null, $this->reflectionDocComment);
	}

	private function getFirstExtendsTag(): ?ExtendsTag
	{
		foreach ($this->getExtendsTags() as $tag) {
			return $tag;
		}

		return null;
	}

	/** @return array<string, ExtendsTag> */
	public function getExtendsTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getExtendsTags();
	}

	/** @return array<string, ImplementsTag> */
	public function getImplementsTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getImplementsTags();
	}

	/** @return array<string,TemplateTag> */
	public function getTemplateTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getTemplateTags();
	}

	/**
	 * @return array<string,ClassReflection>
	 */
	public function getAncestors(): array
	{
		$ancestors = $this->ancestors;

		if ($ancestors === null) {
			$ancestors = [
				$this->getName() => $this,
			];

			$addToAncestors = static function (string $name, ClassReflection $classReflection) use (&$ancestors): void {
				if (array_key_exists($name, $ancestors)) {
					return;
				}

				$ancestors[$name] = $classReflection;
			};

			foreach ($this->getInterfaces() as $interface) {
				$addToAncestors($interface->getName(), $interface);
				foreach ($interface->getAncestors() as $name => $ancestor) {
					$addToAncestors($name, $ancestor);
				}
			}

			foreach ($this->getTraits() as $trait) {
				$addToAncestors($trait->getName(), $trait);
				foreach ($trait->getAncestors() as $name => $ancestor) {
					$addToAncestors($name, $ancestor);
				}
			}

			$parent = $this->getParentClass();
			if ($parent !== null) {
				$addToAncestors($parent->getName(), $parent);
				foreach ($parent->getAncestors() as $name => $ancestor) {
					$addToAncestors($name, $ancestor);
				}
			}

			$this->ancestors = $ancestors;
		}

		return $ancestors;
	}

	public function getAncestorWithClassName(string $className): ?self
	{
		return $this->getAncestors()[$className] ?? null;
	}

	/**
	 * @param string[] $ancestorClasses
	 */
	private function isValidAncestorType(Type $type, array $ancestorClasses): bool
	{
		if (!$type instanceof GenericObjectType) {
			return false;
		}

		$reflection = $type->getClassReflection();
		if ($reflection === null) {
			return false;
		}

		return in_array($reflection->getName(), $ancestorClasses, true);
	}

	/**
	 * @return array<MixinTag>
	 */
	public function getMixinTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getMixinTags();
	}

	/**
	 * @return array<RequireExtendsTag>
	 */
	public function getRequireExtendsTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getRequireExtendsTags();
	}

	/**
	 * @return array<RequireImplementsTag>
	 */
	public function getRequireImplementsTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getRequireImplementsTags();
	}

	/**
	 * @return array<SealedTypeTag>
	 */
	public function getSealedTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getSealedTags();
	}

	/**
	 * @return array<string, PropertyTag>
	 */
	public function getPropertyTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getPropertyTags();
	}

	/**
	 * @return array<string, MethodTag>
	 */
	public function getMethodTags(): array
	{
		$resolvedPhpDoc = $this->getResolvedPhpDoc();
		if ($resolvedPhpDoc === null) {
			return [];
		}

		return $resolvedPhpDoc->getMethodTags();
	}

	/**
	 * @return list<Type>
	 */
	public function getResolvedMixinTypes(): array
	{
		$types = [];
		foreach ($this->getMixinTags() as $mixinTag) {
			if (!$this->isGeneric()) {
				$types[] = $mixinTag->getType();
				continue;
			}

			$types[] = TemplateTypeHelper::resolveTemplateTypes(
				$mixinTag->getType(),
				$this->getActiveTemplateTypeMap(),
				$this->getCallSiteVarianceMap(),
				TemplateTypeVariance::createStatic(),
			);
		}

		return $types;
	}

	/**
	 * @return array<Type>|null
	 */
	public function getAllowedSubTypes(): ?array
	{
		foreach ($this->classReflectionExtensionRegistryProvider->getRegistry()->getAllowedSubTypesClassReflectionExtensions() as $allowedSubTypesClassReflectionExtension) {
			if ($allowedSubTypesClassReflectionExtension->supports($this)) {
				return $allowedSubTypesClassReflectionExtension->getAllowedSubTypes($this);
			}
		}

		return null;
	}

}