Add basic template annotations

WyriHaximus · WyriHaximus · commit 4cd23dc09419 · 2022-06-21T23:49:30.000+02:00
This adds basic type safety annotations for static analyzers like PHPStan and Psalm. This will cover around 80% of the use cases and a follow-up PR for all supported versions will be proposed later to get it to a 100% of close to a 100%. This PR is a requirement for reactphp/async#40
diff --git a/src/React/Promise/PromiseInterface.php b/src/React/Promise/PromiseInterface.php
@@ -2,7 +2,13 @@
 
 namespace React\Promise;
 
+/** @template T */
 interface PromiseInterface
 {
+    /**
+     * @template TReturn of mixed
+     * @param callable(T): TReturn $fulfilledHandler
+     * @return (TReturn is PromiseInterface ? TReturn : PromiseInterface<TReturn>)
+     */
     public function then($fulfilledHandler = null, $errorHandler = null, $progressHandler = null);
 }

Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,13 @@`
`2`	`2`
`3`	`3`	`namespace React\Promise;`
`4`	`4`
	`5`	`+/** @template T */`
`5`	`6`	`interface PromiseInterface`
`6`	`7`	`{`
	`8`	`+ /**`
	`9`	`+ * @template TReturn of mixed`
	`10`	`+ * @param callable(T): TReturn $fulfilledHandler`
	`11`	`+ * @return (TReturn is PromiseInterface ? TReturn : PromiseInterface<TReturn>)`
	`12`	`+ */`
`7`	`13`	`public function then($fulfilledHandler = null, $errorHandler = null, $progressHandler = null);`
`8`	`14`	`}`