PHPStan tweaks

Author: GrahamCampbell

phpstan.neon.dist

@@ -9,3 +9,4 @@ parameters:
     - '#Method Dotenv\\Repository\\AbstractRepository::offset[a-zA-Z\(\)\$ ]* typehint specified.#'
     - '#Method Dotenv\\Loader\\Lines::getCharPairs\(\) should return array\(array\(string, string\|null\)\) but returns array\<int, mixed\>.#'
     - '#Unable to resolve the template type S in call to method PhpOption\\Option<mixed>::flatMap\(\)#'
+    - '#Method Dotenv\\Loader\\Parser::processChar\(\) should return Dotenv\\Result\\Result<array<int, bool\|int\|string>, string> but returns Dotenv\\Result\\Result<array<int, [a-z\|\,]+>, mixed>.#'

src/Result/Error.php

@@ -32,9 +32,11 @@ private function __construct($value)
     /**
      * Create a new error value.
      *
-     * @param E $value
+     * @template F
+     *
+     * @param F $value
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @return \Dotenv\Result\Result<T,F>
      */
     public static function create($value)
     {
@@ -54,9 +56,11 @@ public function success()
     /**
      * Map over the success value.
      *
-     * @param callable $f
+     * @template S
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @param callable(T): S $f
+     *
+     * @return \Dotenv\Result\Result<S,E>
      */
     public function mapSuccess(callable $f)
     {
@@ -76,9 +80,11 @@ public function error()
     /**
      * Map over the error value.
      *
-     * @param callable $f
+     * @template F
+     *
+     * @param callable(E): F $f
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @return \Dotenv\Result\Result<T,F>
      */
     public function mapError(callable $f)
     {

src/Result/Result.php

@@ -30,9 +30,11 @@ public function getSuccess()
     /**
      * Map over the success value.
      *
-     * @param callable $f
+     * @template S
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @param callable(T): S $f
+     *
+     * @return \Dotenv\Result\Result<S,E>
      */
     abstract public function mapSuccess(callable $f);
 
@@ -58,9 +60,11 @@ public function getError()
     /**
      * Map over the error value.
      *
-     * @param callable $f
+     * @template F
+     *
+     * @param callable(E): F $f
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @return \Dotenv\Result\Result<T,F>
      */
     abstract public function mapError(callable $f);
 }

src/Result/Success.php

@@ -30,11 +30,13 @@ private function __construct($value)
     }
 
     /**
-     * Create a new success value.
+     * Create a new error value.
      *
-     * @param T $value
+     * @template S
+     *
+     * @param S $value
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @return \Dotenv\Result\Result<S,E>
      */
     public static function create($value)
     {
@@ -54,9 +56,11 @@ public function success()
     /**
      * Map over the success value.
      *
-     * @param callable $f
+     * @template S
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @param callable(T): S $f
+     *
+     * @return \Dotenv\Result\Result<S,E>
      */
     public function mapSuccess(callable $f)
     {
@@ -76,9 +80,11 @@ public function error()
     /**
      * Map over the error value.
      *
-     * @param callable $f
+     * @template F
+     *
+     * @param callable(E): F $f
      *
-     * @return \Dotenv\Result\Result<T,E>
+     * @return \Dotenv\Result\Result<T,F>
      */
     public function mapError(callable $f)
     {