backport static analysis fixes to 1.7 (#221)

src/Psl/Math/mean.php

@@ -9,7 +9,7 @@
 /**
  * Return the arithmetic mean of the numbers in the given iterable.
  *
- * @param iterable<numeric> $numbers
+ * @param iterable<int|float> $numbers
  */
 function mean(iterable $numbers): ?float
 {
@@ -20,8 +20,8 @@ function mean(iterable $numbers): ?float
 
     $mean = 0.0;
     foreach ($numbers as $number) {
-        $mean += $number / $count;
+        $mean += (float)$number / $count;
     }
 
-    return (float) $mean;
+    return $mean;
 }

src/Psl/Math/sum_floats.php

@@ -7,16 +7,16 @@
 /**
  * Returns the float sum of the values of the given iterable.
  *
- * @param list<numeric> $numbers
+ * @param list<int|float> $numbers
  *
  * @pure
  */
 function sum_floats(array $numbers): float
 {
     $result = 0.0;
     foreach ($numbers as $number) {
-        $result += $number;
+        $result += (float)$number;
     }
 
-    return (float) $result;
+    return $result;
 }

src/Psl/Regex/every_match.php

@@ -45,6 +45,7 @@ static function () use ($subject, $pattern, $offset): ?array {
     $capture_groups ??= Type\dict(Type\array_key(), Type\string());
 
     try {
+        /** @psalm-suppress InvalidArgument  */
         return Type\vec($capture_groups)->coerce($matching);
     } catch (InvariantViolationException | Type\Exception\CoercionException $e) {
         throw new Exception\RuntimeException('Invalid capture groups', 0, $e);

src/Psl/Regex/replace_with.php

@@ -15,7 +15,7 @@
  * `$callback`.
  *
  * @param non-empty-string $pattern The pattern to search for.
- * @param (callable(array<int, string>): string) $callback The replacement callable.
+ * @param (callable(array<array-key, string>): string) $callback The replacement callable.
  * @param null|positive-int $limit The maximum possible replacements for
  *                                 $pattern within $haystack.
  *

src/Psl/Str/Byte/words.php

@@ -19,10 +19,8 @@
 function words(string $string, ?string $characters_list = null): array
 {
     if (null === $characters_list) {
-        /** @var array<int, string> $words */
         $words = str_word_count($string, 2);
     } else {
-        /** @var array<int, string> $words */
         $words = str_word_count($string, 2, $characters_list);
     }
 

src/Psl/Type/Type.php

@@ -8,7 +8,7 @@
 use Psl\Type\Exception\TypeTrace;
 
 /**
- * @template T
+ * @template-covariant T
  *
  * @implements TypeInterface<T>
  */

src/Psl/Type/TypeInterface.php

@@ -9,7 +9,7 @@
 use Psl\Type\Exception\TypeTrace;
 
 /**
- * @template T
+ * @template-covariant T
  */
 interface TypeInterface
 {