Handle Mixed union type incl. array in LegacyTypeResolver (#1844)

Author: DerManoMann

src/Type/LegacyTypeResolver.php

@@ -192,6 +192,7 @@ protected function getDocblockTypeDetails(\Reflector $reflector, ?Context $conte
         }
 
         $docComment = str_replace("\r\n", "\n", $docComment);
+        $docComment = str_replace('list', 'array', $docComment);
         $docComment = preg_replace('/\*\/[ \t]*$/', '', $docComment); // strip '*/'
         preg_match($pattern, $docComment, $matches);
 
@@ -201,6 +202,11 @@ protected function getDocblockTypeDetails(\Reflector $reflector, ?Context $conte
         $nullable = in_array('null', explode('|', strtolower($type))) || str_contains($type, '?');
         $isArray = str_contains($type, '[]') || str_contains($type, 'array');
         $type = str_replace(['|null', 'null|', '?', 'null', '[]'], '', $type);
+        $isUnion = count(explode('|', $type)) > 1;
+        if ($isUnion && $isArray) {
+            $type = '';
+            $isArray = false;
+        }
 
         // typed array
         $result = preg_match('/([^<]+)<([^>]+)>/', $type, $matches);

tests/Fixtures/Scratch/MultiTypeProperty.php

@@ -13,6 +13,21 @@ class MultiTypeProperty
 {
     #[OAT\Property(example: true)]
     public int|bool|null $value;
+
+    /**
+     * @var string|list<string>
+     */
+    #[OAT\Property(example: 'My value')]
+    public string|array $mixedUnion;
+
+    /**
+     * @param string|list<string> $otherValue
+     */
+    public function __construct(
+        #[OAT\Property(example: 'My value')]
+        public string|array $otherValue,
+    ) {
+    }
 }
 
 #[OAT\Info(

tests/Fixtures/Scratch/MultiTypeProperty3.0.0.yaml

@@ -14,7 +14,11 @@ components:
   schemas:
     MultiTypeProperty:
       properties:
+        otherValue:
+          example: 'My value'
         value:
           example: true
           nullable: true
+        mixedUnion:
+          example: 'My value'
       type: object

tests/Fixtures/Scratch/MultiTypeProperty3.1.0.yaml

@@ -14,6 +14,10 @@ components:
   schemas:
     MultiTypeProperty:
       properties:
+        otherValue:
+          example: 'My value'
         value:
           example: true
+        mixedUnion:
+          example: 'My value'
       type: object