improved phpDoc

Author: dg

src/Utils/ArrayList.php

@@ -21,6 +21,7 @@
  */
 class ArrayList implements \ArrayAccess, \Countable, \IteratorAggregate
 {
+	/** @var list<T> */
 	private array $list = [];
 
 

src/Utils/Callback.php

@@ -22,6 +22,7 @@ final class Callback
 
 	/**
 	 * Invokes internal PHP function with own error handler.
+	 * @param  array<mixed>  $args
 	 */
 	public static function invokeSafe(string $function, array $args, callable $onError): mixed
 	{

src/Utils/Image.php

@@ -146,6 +146,7 @@ class Image
 	/**
 	 * Returns RGB color (0..255) and transparency (0..127).
 	 * @deprecated use ImageColor::rgb()
+	 * @return array{red: int, green: int, blue: int, alpha: int}
 	 */
 	public static function rgb(int $red, int $green, int $blue, int $transparency = 0): array
 	{

src/Utils/Strings.php

@@ -659,6 +659,10 @@ public static function replace(
 	}
 
 
+	/**
+	 * @param  array<array<array{string, int}>>  $groups
+	 * @return array<array<array{string, int}>>
+	 */
 	private static function bytesToChars(string $s, array $groups): array
 	{
 		$lastBytes = $lastChars = 0;

src/Utils/Validators.php

@@ -290,6 +290,7 @@ public static function isList(mixed $value): bool
 	/**
 	 * Checks if the value is in the given range [min, max], where the upper or lower limit can be omitted (null).
 	 * Numbers, strings and DateTime objects can be compared.
+	 * @param  array{0?: int|float|string|\DateTimeInterface, 1?: int|float|string|\DateTimeInterface}  $range
 	 */
 	public static function isInRange(mixed $value, array $range): bool
 	{