PHPStorm: correto PHPDoc para uma coleção de objetos?

Estou usando oPHPStorm IDE e ter problemas ao executar a inspeção de código.

Eu tenho um método que retorna uma coleção de objetos. oCollection em si é um objeto, que tem seus próprios métodos, e implementa oTraversable interface:

class Repository
{
    public function findByCustomer(Customer $user)
    {
        // ...
        return new Collection($orders);
    }
}

Se eu documentarfindByUser() para devolver umCollection, a inspeção de código entende os métodos nesse objeto, mas não entende quais objetos a coleção contém:

/**
 * @return Collection
 */
public function findByCustomer() { ... }

Se eu documentarfindByUser() para devolver uma coleção deOrder objetos, a inspeção de código agora entende o que está dentro da coleção, mas não os métodos noCollection em si:

/**
 * @return Order[]
 */
public function findByCustomer() { ... }

Existe uma maneira de especificar os dois ao mesmo tempo, algo como a sintaxe do Java?

/**
 * @return Collection<Order>
 */
public function findByCustomer() { ... }

questionAnswers(1)

yourAnswerToTheQuestion