refactor: Add type hinting to tap function and HigherOrderTapProxy cl…

…ass (#6922)

src/Functions.php

@@ -14,10 +14,10 @@
 
 /**
  * Call the given Closure with the given value then return the value.
- *
- * @param mixed $value
+ * @template TValue
+ * @param TValue $value
  * @param null|callable $callback
- * @return mixed
+ * @return ($callback is null ? HigherOrderTapProxy<TValue> : TValue)
  */
 function tap($value, $callback = null)
 {

src/HigherOrderTapProxy.php

@@ -12,19 +12,22 @@
 
 namespace Hyperf\Tappable;
 
+/**
+ * @template TValue
+ */
 class HigherOrderTapProxy
 {
  /**
  * The target being tapped.
  *
- * @var mixed
+ * @var TValue
  */
  public $target;
 
  /**
  * Create a new tap proxy instance.
  *
- * @param mixed $target
+ * @param TValue of object $target
  */
  public function __construct($target)
  {
@@ -36,7 +39,7 @@ public function __construct($target)
  *
  * @param string $method
  * @param array $parameters
- * @return mixed
+ * @return TValue
  */
  public function __call($method, $parameters)
  {

src/Tappable.php

@@ -18,7 +18,7 @@ trait Tappable
  * Call the given Closure with this instance then return the instance.
  *
  * @param null|callable $callback
- * @return $this|HigherOrderTapProxy
+ * @return ($callback is null ? HigherOrderTapProxy : $this)
  */
  public function tap($callback = null)
  {