Using @phpstan-type and returning said type in a docblock attempts to load a non-existing class

[nesl247]

API Platform version(s) affected: 3.3.12

Description
When viewing documentation and using @phpstan-type CustomType array{} and @returns CustomType, an error is thrown.

  "@context": "/contexts/Error",
  "@type": "hydra:Error",
  "hydra:title": "An error occurred",
  "hydra:description": "Class \"Satws\\Scarface\\Insight\\Reports\\InsightReportInsights\" does not exist",
  "trace": [
    {
      "namespace": "",
      "short_class": "",
      "class": "",
      "type": "",
      "function": "",
      "file": "/srv/app/vendor/api-platform/core/src/JsonSchema/DefinitionNameFactory.php",
      "line": 35,
      "args": []
    },
    {
      "namespace": "",
      "short_class": "ReflectionClass",
      "class": "ReflectionClass",
      "type": "-\u003E",
      "function": "__construct",
      "file": "/srv/app/vendor/api-platform/core/src/JsonSchema/DefinitionNameFactory.php",
      "line": 35,
      "args": [
        [
          "string",
          "Satws\\Scarface\\Insight\\Reports\\InsightReportInsights"
        ]
      ]
    },

If you use @phpstan-returns instead, the error will go away.

How to reproduce

<?php

#[ApiResource]
/**
* @phpstan-type CustomType array{test: string}
*/
class Test 
{
  /**
   * @returns CustomType
   */
  public function __construct(public array $property) {}
}

Possible Solution

Additional Context

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[nesl247]

This is still relevant.

[dunglas]

This looks like a PHPStan-specific feature. The easiest way to support it would be to support for this in Symfony TypeInfo.