Use Promise v3 template types

Author: SimonFrings

src/functions.php

@@ -189,6 +189,7 @@
  */
 function async(callable $function): callable
 {
+    /** @var callable(A1=,A2=,A3=,A4=,A5=): PromiseInterface<T> */
     return static function (mixed ...$args) use ($function): PromiseInterface {
         $fiber = null;
         $promise = new Promise(function (callable $resolve, callable $reject) use ($function, $args, &$fiber): void {
@@ -673,6 +674,7 @@ function coroutine(callable $function, mixed ...$args): PromiseInterface
     };
     $next();
 
+    /** @var PromiseInterface<T> */
     return $deferred->promise();
 }
 
@@ -734,6 +736,7 @@ function parallel(iterable $tasks): PromiseInterface
         $deferred->resolve($results);
     }
 
+    /** @var PromiseInterface<array<T>> */
     return $deferred->promise();
 }
 
@@ -789,6 +792,7 @@ function series(iterable $tasks): PromiseInterface
 
     $next();
 
+    /** @var PromiseInterface<array<T>> */
     return $deferred->promise();
 }
 
@@ -838,5 +842,6 @@ function waterfall(iterable $tasks): PromiseInterface
 
     $next();
 
+    /** @var PromiseInterface<T> */
     return $deferred->promise();
 }

tests/AwaitTest.php

@@ -129,7 +129,7 @@ public function testAwaitThrowsUnexpectedValueExceptionWhenPromiseIsRejectedWith
         }
 
         $promise = new Promise(function ($_, $reject) {
-            $reject(false);
+            $reject(false); // @phpstan-ignore-line
         });
 
         $this->expectException(\UnexpectedValueException::class);
@@ -147,7 +147,7 @@ public function testAwaitThrowsUnexpectedValueExceptionWhenPromiseIsRejectedWith
         }
 
         $promise = new Promise(function ($_, $reject) {
-            $reject(null);
+            $reject(null); // @phpstan-ignore-line
         });
 
         try {
@@ -331,7 +331,7 @@ public function testAwaitShouldNotCreateAnyGarbageReferencesForPromiseRejectedWi
         gc_collect_cycles();
 
         $promise = new Promise(function ($_, $reject) {
-            $reject(null);
+            $reject(null); // @phpstan-ignore-line
         });
         try {
             $await($promise);