ensure FunctionProxy instances are always recognized as callable

Author: mikey179

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 8.0.2 (2023-22-26)
+
+* Added proper return type hints to `bovigo\callmap\FunctionProxy::returns()` and `bovigo\callmap\FunctionProxy::throws()` so the instance is further recognized as a callable.
+
 ## 8.0.1 (2023-12-25)
 
 * Provide more details about mocked method/function in deprecation notice when method or function doesn't have a return type declaration.

src/main/php/FunctionProxy.php

@@ -74,6 +74,7 @@ public function preventParentCalls(): void
      * sets the call map to use
      *
      * @api
+     * @return callable&FunctionProxy
      * @throws LogicException when mapped function is declared as returning void
      * @since  3.2.0
      */
@@ -96,6 +97,7 @@ public function returns(mixed $returnValue): self
      * shortcut for returns(throws($e))
      *
      * @api
+     * @return callable&FunctionProxy
      * @since 3.2.0
      */
     public function throws(Throwable $e): self