Improve token type phpdoc

Author: mvorisek

src/CliHighlighter.php

@@ -44,6 +44,7 @@ public function highlightToken(int $type, string $value): string
         return $prefix . $value . "\x1b[0m";
     }
 
+    /** @param self::TOKEN_TYPE_* $type */
     private function prefix(int $type): string|null
     {
         if (! isset(self::TOKEN_TYPE_TO_HIGHLIGHT[$type])) {

src/Cursor.php

@@ -14,6 +14,7 @@ public function __construct(
     ) {
     }
 
+    /** @param self::TOKEN_TYPE_* $exceptTokenType */
     public function next(int|null $exceptTokenType = null): Token|null
     {
         while ($token = $this->tokens[++$this->position] ?? null) {
@@ -27,6 +28,7 @@ public function next(int|null $exceptTokenType = null): Token|null
         return null;
     }
 
+    /** @param self::TOKEN_TYPE_* $exceptTokenType */
     public function previous(int|null $exceptTokenType = null): Token|null
     {
         while ($token = $this->tokens[--$this->position] ?? null) {

src/Highlighter.php

@@ -32,6 +32,8 @@ interface Highlighter
 
     /**
      * Highlights a token depending on its type.
+     *
+     * @param self::TOKEN_TYPE_* $type
      */
     public function highlightToken(int $type, string $value): string;
 

src/HtmlHighlighter.php

@@ -56,6 +56,7 @@ public function highlightToken(int $type, string $value): string
         return '<span ' . $attributes . '>' . $value . '</span>';
     }
 
+    /** @param self::TOKEN_TYPE_* $type */
     public function attributes(int $type): string|null
     {
         if (! isset(self::TOKEN_TYPE_TO_HIGHLIGHT[$type])) {

src/Token.php

@@ -43,6 +43,7 @@ public function type(): int
         return $this->type;
     }
 
+    /** @param self::TOKEN_TYPE_* ...$types */
     public function isOfType(int ...$types): bool
     {
         return in_array($this->type, $types, true);