chore: provider generics phpdoc (#4868)

Author: GregoireHebert

src/Doctrine/Orm/Extension/QueryResultCollectionExtensionInterface.php

@@ -22,13 +22,15 @@
  *
  * @author Samuel ROZE <[email protected]>
  * @author Kévin Dunglas <[email protected]>
+ *
+ * @template T of object
  */
 interface QueryResultCollectionExtensionInterface extends QueryCollectionExtensionInterface
 {
     public function supportsResult(string $resourceClass, Operation $operation = null, array $context = []): bool;
 
     /**
-     * @return iterable
+     * @return iterable<T>
      */
     public function getResult(QueryBuilder $queryBuilder, string $resourceClass = null, Operation $operation = null, array $context = []);
 }

src/Doctrine/Orm/Extension/QueryResultItemExtensionInterface.php

@@ -21,13 +21,15 @@
  * for specific cases such as Query alteration.
  *
  * @author Antoine BLUCHET <[email protected]>
+ *
+ * @template T of object
  */
 interface QueryResultItemExtensionInterface extends QueryItemExtensionInterface
 {
     public function supportsResult(string $resourceClass, Operation $operation = null, array $context = []): bool;
 
     /**
-     * @return object|null
+     * @return T|null
      */
     public function getResult(QueryBuilder $queryBuilder, string $resourceClass = null, Operation $operation = null, array $context = []);
 }

src/State/Pagination/PaginatorInterface.php

@@ -18,6 +18,10 @@
  * current page, as an integer.
  *
  * @author Kévin Dunglas <[email protected]>
+ *
+ * @template T of object
+ *
+ * @extends PartialPaginatorInterface<T>
  */
 interface PaginatorInterface extends PartialPaginatorInterface
 {

src/State/Pagination/PartialPaginatorInterface.php

@@ -17,6 +17,10 @@
  * Partial Paginator Interface.
  *
  * @author Baptiste Meyer <[email protected]>
+ *
+ * @template T of object
+ *
+ * @extends \Traversable<T>
  */
 interface PartialPaginatorInterface extends \Traversable, \Countable
 {

src/State/ProviderInterface.php

@@ -14,19 +14,22 @@
 namespace ApiPlatform\State;
 
 use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\Pagination\PartialPaginatorInterface;
 
 /**
  * Retrieves data from a persistence layer.
  *
  * @author Antoine Bluchet <[email protected]>
  * @experimental
+ *
+ * @template T of object
  */
 interface ProviderInterface
 {
     /**
      * Provides data.
      *
-     * @return object|array|null
+     * @return T|PartialPaginatorInterface<T>|iterable<T>|null
      */
     public function provide(Operation $operation, array $uriVariables = [], array $context = []);
 }