Document token array format

Author: ondrejmirtes

src/Lexer/Lexer.php

@@ -92,6 +92,9 @@ class Lexer
 	/** @var string|null */
 	private $regexp;
 
+	/**
+	 * @return list<array{string, int}>
+	 */
 	public function tokenize(string $s): array
 	{
 		if ($this->regexp === null) {

src/Parser/TokenIterator.php

@@ -12,7 +12,7 @@
 class TokenIterator
 {
 
-	/** @var mixed[][] */
+	/** @var list<array{string, int}> */
 	private $tokens;
 
 	/** @var int */
@@ -21,6 +21,9 @@ class TokenIterator
 	/** @var int[] */
 	private $savePoints = [];
 
+	/**
+	 * @param list<array{string, int}> $tokens
+	 */
 	public function __construct(array $tokens, int $index = 0)
 	{
 		$this->tokens = $tokens;