Augment fold() and reduce() with type variables (#132)

Author: sanmai

src/Standard.php

@@ -478,10 +478,12 @@ public function skipWhile(callable $predicate): self
     /**
      * Reduces input values to a single value. Defaults to summation. This is a terminal operation.
      *
+     * @template T
+     *
      * @param ?callable $func    function (mixed $carry, mixed $item) { must return updated $carry }
-     * @param ?mixed    $initial initial value for a $carry
+     * @param T         $initial The initial initial value for a $carry
      *
-     * @return ?mixed
+     * @return int|T
      */
     public function reduce(?callable $func = null, $initial = null)
     {
@@ -491,10 +493,12 @@ public function reduce(?callable $func = null, $initial = null)
     /**
      * Reduces input values to a single value. Defaults to summation. Requires an initial value. This is a terminal operation.
      *
-     * @param mixed     $initial initial value for a $carry
+     * @template T
+     *
+     * @param T         $initial initial value for a $carry
      * @param ?callable $func    function (mixed $carry, mixed $item) { must return updated $carry }
      *
-     * @return ?mixed
+     * @return T
      */
     public function fold($initial, ?callable $func = null)
     {