Added phpdocs (#72)

Author: staabm

phpstan-config.neon

@@ -1,5 +1,5 @@
 parameters:
-    level: 1
+    level: 5
 
     paths:
         - src/

src/Seld/JsonLint/JsonParser.php

@@ -38,6 +38,9 @@ class JsonParser
     private $vstack; // semantic value stack
     private $lstack; // location stack
 
+    /**
+     * @phpstan-var array<string, int>
+     */
     private $symbols = array(
         'error'                 => 2,
         'JSONString'            => 3,
@@ -67,6 +70,9 @@ class JsonParser
         '$end'                  => 1,
     );
 
+    /**
+     * @phpstan-var array<int, string>
+     */
     private $terminals_ = array(
         2   => "error",
         4   => "STRING",
@@ -127,6 +133,7 @@ public function lint($input, $flags = 0)
         } catch (ParsingException $e) {
             return $e;
         }
+        return null;
     }
 
     /**
@@ -325,8 +332,6 @@ public function parse($input, $flags = 0)
                     return true;
             }
         }
-
-        return true;
     }
 
     protected function parseError($str, $hash)

src/Seld/JsonLint/Lexer.php

@@ -19,6 +19,9 @@
 class Lexer
 {
     private $EOF = 1;
+    /**
+     * @phpstan-var array<int, string>
+     */
     private $rules = array(
         0 => '/\G\s+/',
         1 => '/\G-?([0-9]|[1-9][0-9]+)(\.[0-9]+)?([eE][+-]?[0-9]+)?\b/',
@@ -199,7 +202,6 @@ private function performAction($avoiding_name_collisions, $YY_START)
             break;
         case 1:
             return 6;
-           break;
         case 2:
             $this->yytext = substr($this->yytext, 1, $this->yyleng-2);
 

src/Seld/JsonLint/ParsingException.php

@@ -17,7 +17,7 @@ class ParsingException extends \Exception
 
     /**
      * @param string $message
-     * @psalm-param array{text?: string, token?: string, line?: int, loc?: array, expected?: array} $details
+     * @psalm-param array{text?: string, token?: string, line?: int, loc?: array{first_line: int, first_column: int, last_line: int, last_column: int}, expected?: string[]} $details
      */
     public function __construct($message, $details = array())
     {
@@ -26,7 +26,7 @@ public function __construct($message, $details = array())
     }
 
     /**
-     * @psalm-return array{text?: string, token?: string, line?: int, loc?: array, expected?: array}
+     * @psalm-return array{text?: string, token?: string, line?: int, loc?: array{first_line: int, first_column: int, last_line: int, last_column: int}, expected?: string[]}
      */
     public function getDetails()
     {