Add template annotations

Source: https://github.com/Bocmah/psalm-reactphp-promise-plugin

Co-authored-by: Artem Trushkin <[email protected]>

Author: simPod

src/PromiseInterface.php

@@ -2,6 +2,7 @@
 
 namespace React\Promise;
 
+/** @psalm-template T */
 interface PromiseInterface
 {
     /**
@@ -28,9 +29,12 @@ interface PromiseInterface
      *  2. `$onFulfilled` and `$onRejected` will never be called more
      *      than once.
      *
-     * @param callable|null $onFulfilled
-     * @param callable|null $onRejected
-     * @return PromiseInterface
+     * @psalm-template TResolved
+     *
+     * @psalm-param callable(T):(PromiseInterface<TResolved>|TResolved)|null $onFulfilled
+     * @psalm-param callable(mixed):(PromiseInterface|mixed)|null $onRejected
+     *
+     * @return PromiseInterface<TResolved>
      */
     public function then(?callable $onFulfilled = null, ?callable $onRejected = null): PromiseInterface;
 
@@ -44,7 +48,7 @@ public function then(?callable $onFulfilled = null, ?callable $onRejected = null
      * Since the purpose of `done()` is consumption rather than transformation,
      * `done()` always returns `null`.
      *
-     * @param callable|null $onFulfilled
+     * @param callable(mixed):TResolve|null $onFulfilled
      * @param callable|null $onRejected
      * @return void
      */
@@ -60,8 +64,9 @@ public function done(callable $onFulfilled = null, callable $onRejected = null):
      * Additionally, you can type hint the `$reason` argument of `$onRejected` to catch
      * only specific errors.
      *
-     * @param callable $onRejected
-     * @return PromiseInterface
+     * @param callable(mixed):(PromiseInterface<T>|mixed) $onRejected
+     *
+     * @return PromiseInterface<T>
      */
     public function otherwise(callable $onRejected): PromiseInterface;
 
@@ -108,7 +113,7 @@ public function otherwise(callable $onRejected): PromiseInterface;
      * ```
      *
      * @param callable $onFulfilledOrRejected
-     * @return PromiseInterface
+     * @return PromiseInterface<T>
      */
     public function always(callable $onFulfilledOrRejected): PromiseInterface;
 

src/PromisorInterface.php

@@ -2,12 +2,13 @@
 
 namespace React\Promise;
 
+/** @psalm-template T */
 interface PromisorInterface
 {
     /**
      * Returns the promise of the deferred.
      *
-     * @return PromiseInterface
+     * @return PromiseInterface<T>
      */
     public function promise(): PromiseInterface;
 }