Implement correct @templates for traits

Author: Hendrik Nijmeijer

src/Actions/Create.php

@@ -6,10 +6,13 @@
 
 use Swis\JsonApi\Client\Interfaces\ItemInterface;
 
+/**
+ * @template TItem of \Swis\JsonApi\Client\Interfaces\ItemInterface
+ */
 trait Create
 {
     /**
-     * @return \Swis\JsonApi\Client\Interfaces\DocumentInterface
+     * @return \Swis\JsonApi\Client\Interfaces\ItemDocumentInterface<TItem>
      */
     public function create(ItemInterface $item, array $parameters = [], array $headers = [])
     {

src/Actions/FetchMany.php

@@ -4,10 +4,13 @@
 
 namespace Swis\JsonApi\Client\Actions;
 
+/**
+ * @template TItem of \Swis\JsonApi\Client\Interfaces\ItemInterface
+ */
 trait FetchMany
 {
     /**
-     * @return \Swis\JsonApi\Client\Interfaces\DocumentInterface
+     * @return \Swis\JsonApi\Client\Interfaces\CollectionDocumentInterface<TItem>
      */
     public function all(array $parameters = [], array $headers = [])
     {

src/Actions/FetchOne.php

@@ -4,10 +4,13 @@
 
 namespace Swis\JsonApi\Client\Actions;
 
+/**
+ * @template TItem of \Swis\JsonApi\Client\Interfaces\ItemInterface
+ */
 trait FetchOne
 {
     /**
-     * @return \Swis\JsonApi\Client\Interfaces\DocumentInterface
+     * @return \Swis\JsonApi\Client\Interfaces\ItemDocumentInterface<TItem>
      */
     public function find(string $id, array $parameters = [], array $headers = [])
     {

src/Actions/Save.php

@@ -6,13 +6,19 @@
 
 use Swis\JsonApi\Client\Interfaces\ItemInterface;
 
+/**
+ * @template TItem of \Swis\JsonApi\Client\Interfaces\ItemInterface
+ */
 trait Save
 {
+    /** @use Create<TItem> */
     use Create { create as protected saveNew; }
+
+    /** @use Update<TItem> */
     use Update { update as protected saveExisting; }
 
     /**
-     * @return \Swis\JsonApi\Client\Interfaces\DocumentInterface
+     * @return \Swis\JsonApi\Client\Interfaces\ItemDocumentInterface<TItem>
      */
     public function save(ItemInterface $item, array $parameters = [], array $headers = [])
     {

src/Actions/TakeOne.php

@@ -4,10 +4,13 @@
 
 namespace Swis\JsonApi\Client\Actions;
 
+/**
+ * @template TItem of \Swis\JsonApi\Client\Interfaces\ItemInterface
+ */
 trait TakeOne
 {
     /**
-     * @return \Swis\JsonApi\Client\Interfaces\DocumentInterface
+     * @return \Swis\JsonApi\Client\Interfaces\ItemDocumentInterface<TItem>
      */
     public function take(array $parameters = [], array $headers = [])
     {

src/Actions/Update.php

@@ -6,10 +6,13 @@
 
 use Swis\JsonApi\Client\Interfaces\ItemInterface;
 
+/**
+ * @template TItem of \Swis\JsonApi\Client\Interfaces\ItemInterface
+ */
 trait Update
 {
     /**
-     * @return \Swis\JsonApi\Client\Interfaces\DocumentInterface
+     * @return \Swis\JsonApi\Client\Interfaces\ItemDocumentInterface<TItem>
      */
     public function update(ItemInterface $item, array $parameters = [], array $headers = [])
     {

src/Repository.php

@@ -11,11 +11,23 @@
 use Swis\JsonApi\Client\Actions\TakeOne;
 use Swis\JsonApi\Client\Interfaces\RepositoryInterface;
 
+/**
+ * @template TItem of \Swis\JsonApi\Client\Interfaces\ItemInterface
+ * @implements RepositoryInterface<TItem>
+ */
 class Repository extends BaseRepository implements RepositoryInterface
 {
     use Delete;
+
+    /** @use FetchMany<TItem> */
     use FetchMany;
+
+    /** @use FetchOne<TItem> */
     use FetchOne;
+
+    /** @use Save<TItem> */
     use Save;
+
+    /** @use TakeOne<TItem> */
     use TakeOne;
 }