完善辅助函数注释

Author: ChinaMoli

src/helper.php

@@ -16,12 +16,15 @@
     /**
      * 按条件抛异常
      *
-     * @param mixed            $condition
-     * @param Throwable|string $exception
-     * @param array            ...$parameters
-     * @return mixed
+     * @template TValue
+     * @template TException of \Throwable
+     *
+     * @param TValue                                     $condition
+     * @param TException|class-string<TException>|string $exception
+     * @param mixed                                      ...$parameters
+     * @return TValue
      *
-     * @throws Throwable
+     * @throws TException
      */
     function throw_if($condition, $exception, ...$parameters)
     {
@@ -37,11 +40,15 @@ function throw_if($condition, $exception, ...$parameters)
     /**
      * 按条件抛异常
      *
-     * @param mixed            $condition
-     * @param Throwable|string $exception
-     * @param array            ...$parameters
-     * @return mixed
-     * @throws Throwable
+     * @template TValue
+     * @template TException of \Throwable
+     *
+     * @param TValue                                     $condition
+     * @param TException|class-string<TException>|string $exception
+     * @param mixed                                      ...$parameters
+     * @return TValue
+     *
+     * @throws TException
      */
     function throw_unless($condition, $exception, ...$parameters)
     {
@@ -57,9 +64,11 @@ function throw_unless($condition, $exception, ...$parameters)
     /**
      * 对一个值调用给定的闭包，然后返回该值
      *
-     * @param mixed         $value
-     * @param callable|null $callback
-     * @return mixed
+     * @template TValue
+     *
+     * @param TValue                         $value
+     * @param (callable(TValue): mixed)|null $callback
+     * @return TValue
      */
     function tap($value, $callback = null)
     {
@@ -77,8 +86,10 @@ function tap($value, $callback = null)
     /**
      * Return the default value of the given value.
      *
-     * @param mixed $value
-     * @return mixed
+     * @template TValue
+     *
+     * @param TValue|\Closure(): TValue $value
+     * @return TValue
      */
     function value($value)
     {