Enhance debug logging in SpecialTypeResolver; add detailed output for key type resolution and constant reflection

Author: rcalicdan

.github/workflows/ci.yml

@@ -36,4 +36,4 @@ jobs:
         run: php bin/typephp cache:clear
 
       - name: Run Test Suite (Pest) with Live Debug
-        run: ./vendor/bin/pest tests/TypeChecking/ArraysAndShapes/ClassConstKeyShapeTest.php --ci
+        run: ./vendor/bin/pest tests/TypeChecking/ArraysAndShapes/ClassConstKeyShapeTest.php 

src/Resolver/SpecialTypeResolver.php

@@ -356,27 +356,31 @@ private static function resolveArrayShape(ArrayShapeNode $node, \ReflectionClass
             /** @var ConstExprIntegerNode|ConstExprStringNode|ConstFetchNode|IdentifierTypeNode|null $keyName */
             $keyName = $item->keyName;
 
-            // --- CRASH AND DUMP AST NODE CLASS ON PHP 8.2 ---
-            if ($keyName !== null) {
-                $classStr = get_class($keyName);
-                $valStr = method_exists($keyName, '__toString') ? (string) $keyName : 'unknown';
-
-                if (str_contains($valStr, 'self::')) {
-                    throw new \RuntimeException("[DEBUG PHP 8.2] AST Class: {$classStr} | Value: {$valStr}");
-                }
-            }
-            // -------------------------------------------------
-
             $className = null;
             $constName = null;
 
+            $debugClass = $keyName !== null ? get_class($keyName) : 'null';
+            $debugVal = $keyName !== null && method_exists($keyName, '__toString') ? (string) $keyName : 'unknown';
+            fwrite(STDERR, "\n[DEBUG] ArrayShapeItem KeyType: {$debugClass} | Value: {$debugVal}\n");
+
+            if ($keyName instanceof IdentifierTypeNode) {
+                fwrite(STDERR, "[DEBUG] IdentifierName: {$keyName->name}\n");
+            }
+
             if ($keyName instanceof ConstFetchNode && $keyName->className !== '') {
                 $className = $keyName->className;
                 $constName = $keyName->name;
             } elseif ($keyName instanceof IdentifierTypeNode && str_contains($keyName->name, '::')) {
+                // Fallback for phpstan/phpdoc-parser v1.x/v2.0 which parses constants as Identifiers
                 [$className, $constName] = explode('::', $keyName->name, 2);
             }
 
+            if ($className !== null && $constName !== null) {
+                fwrite(STDERR, "[DEBUG] Split into Class: {$className} | Const: {$constName}\n");
+            } else {
+                fwrite(STDERR, "[DEBUG] Did NOT split into Class and Const.\n");    
+            }
+
             if ($className !== null && $constName !== null) {
                 $lowerClassName = strtolower($className);
                 $declaringClass = $ref instanceof \ReflectionMethod ? $ref->getDeclaringClass()->getName() : null;
@@ -390,9 +394,14 @@ private static function resolveArrayShape(ArrayShapeNode $node, \ReflectionClass
                     $resolvedClass = self::resolveFqcn($className, $ref);
                 }
 
+                fwrite(STDERR, "[DEBUG] Resolved Target Class for Reflection: {$resolvedClass}\n");
+
                 $resolvedKeyNode = self::resolveConstantKeyValue($resolvedClass, $constName);
                 if ($resolvedKeyNode !== null) {
+                    fwrite(STDERR, "[DEBUG] Successfully Reflected Constant! New Value: {$resolvedKeyNode->value}\n");
                     $keyName = $resolvedKeyNode;
+                } else {
+                    fwrite(STDERR, "[DEBUG] FAILED to Reflect Constant!\n");
                 }
             }