Improve token type phpdoc

src/CliHighlighter.php

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

src/SqlFormatter.php

@@ -175,7 +175,7 @@ public function format(string $string, string $indentString = '  '): string
                 for ($j = 1; $j <= 250; $j++) {
                     // Reached end of string
                     $next = $subCursor->next(Token::TOKEN_TYPE_WHITESPACE);
-                    if (! $next) {
+                    if ($next === null) {
                         break;
                     }
 
@@ -215,7 +215,7 @@ public function format(string $string, string $indentString = '  '): string
 
                 // Take out the preceding space unless there was whitespace there in the original query
                 $prevToken = $cursor->subCursor()->previous();
-                if ($prevToken && ! $prevToken->isOfType(Token::TOKEN_TYPE_WHITESPACE)) {
+                if ($prevToken !== null && ! $prevToken->isOfType(Token::TOKEN_TYPE_WHITESPACE)) {
                     $return = rtrim($return, ' ');
                 }
 
@@ -328,9 +328,9 @@ public function format(string $string, string $indentString = '  '): string
             } elseif ($token->isOfType(Token::TOKEN_TYPE_BOUNDARY)) {
                 // Multiple boundary characters in a row should not have spaces between them (not including parentheses)
                 $prevNotWhitespaceToken = $cursor->subCursor()->previous(Token::TOKEN_TYPE_WHITESPACE);
-                if ($prevNotWhitespaceToken && $prevNotWhitespaceToken->isOfType(Token::TOKEN_TYPE_BOUNDARY)) {
+                if ($prevNotWhitespaceToken !== null && $prevNotWhitespaceToken->isOfType(Token::TOKEN_TYPE_BOUNDARY)) {
                     $prevToken = $cursor->subCursor()->previous();
-                    if ($prevToken && ! $prevToken->isOfType(Token::TOKEN_TYPE_WHITESPACE)) {
+                    if ($prevToken !== null && ! $prevToken->isOfType(Token::TOKEN_TYPE_WHITESPACE)) {
                         $return = rtrim($return, ' ');
                     }
                 }
@@ -358,12 +358,12 @@ public function format(string $string, string $indentString = '  '): string
             }
 
             $nextNotWhitespace = $cursor->subCursor()->next(Token::TOKEN_TYPE_WHITESPACE);
-            if (! $nextNotWhitespace || ! $nextNotWhitespace->isOfType(Token::TOKEN_TYPE_NUMBER)) {
+            if ($nextNotWhitespace === null || ! $nextNotWhitespace->isOfType(Token::TOKEN_TYPE_NUMBER)) {
                 continue;
             }
 
             $prev = $cursor->subCursor()->previous(Token::TOKEN_TYPE_WHITESPACE);
-            if (! $prev) {
+            if ($prev === null) {
                 continue;
             }
 

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);