Add Php stan, fix errors to level 8

Author: jakubboucek

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "redbitcz/debug-mode-enabler",
-    "description": "Debug mode enabler (not only for Tracy debugger) - safe and clean way to manage Debug Mode in your app",
-    "keywords": ["nette", "tracy", "debug"],
+    "description": "Debug mode enabler - safe and clean way to manage Debug Mode in your app",
+    "keywords": ["debug"],
     "license": ["MIT"],
     "authors": [
         {
@@ -29,5 +29,11 @@
         "branch-alias": {
             "dev-master": "2.0-dev"
         }
+    },
+    "require-dev": {
+        "phpstan/phpstan": "^0.12.50"
+    },
+    "scripts": {
+        "phpstan": "phpstan analyze src --level 8"
     }
 }

src/Detector.php

@@ -25,7 +25,7 @@ public function getEnabler(): Enabler
         return $this->enabler;
     }
 
-    public function isDebugMode(?bool $default = false): bool
+    public function isDebugMode(?bool $default = false): ?bool
     {
         return $this->isDebugModeByEnabler()
             ?? $this->isDebugModeByEnv()
@@ -86,7 +86,7 @@ public function isDebugModeByIp(): ?bool
         return $result ?: null;
     }
 
-    public static function detect(string $tempDir, ?bool $default = false): bool
+    public static function detect(string $tempDir, ?bool $default = false): ?bool
     {
         return (new self($tempDir))->isDebugMode($default);
     }

src/Enabler.php

@@ -135,18 +135,32 @@ private function destroyToken(string $name): void
 
     // TOKEN LIST ------------------------------------------------------------------------------------------------------
 
+    /**
+     * @return array[]
+     */
     private function loadList(): array
     {
         return $this->readStorage();
     }
 
+    /**
+     * @param bool $value
+     * @param array<int, array> $list
+     * @return string
+     */
     private function addListToken(bool $value, array &$list): string
     {
+        /** @var string $name */
         [$name, $token] = $this->generateToken($value);
         $list[] = $token;
         return $name;
     }
 
+    /**
+     * @param string $name
+     * @param array<int, array> $list
+     * @return bool|null
+     */
     private function getListTokenValue(string $name, array $list): ?bool
     {
         $id = $this->getIdByName($name);
@@ -160,6 +174,10 @@ private function getListTokenValue(string $name, array $list): ?bool
     }
 
 
+    /**
+     * @param string $name
+     * @param array<int, array> $list
+     */
     private function dropListToken(string $name, array &$list): void
     {
         $id = $this->getIdByName($name);
@@ -171,6 +189,9 @@ static function ($token) use ($id) {
         );
     }
 
+    /**
+     * @param array<int, array> $list
+     */
     private function saveList(array $list): void
     {
         // Filter invalid and expired tokens
@@ -186,6 +207,11 @@ function ($token) {
 
     // TOKEN UTILS -----------------------------------------------------------------------------------------------------
 
+    /**
+     * @param array<string, string|bool|int> $token
+     * @param string|null $name
+     * @return bool
+     */
     private function isTokenValid(array $token, ?string $name = null): bool
     {
         $now = time();
@@ -206,6 +232,10 @@ private function isTokenValid(array $token, ?string $name = null): bool
         return $result;
     }
 
+    /**
+     * @param bool $value
+     * @return array<int, string|array>
+     */
     private function generateToken(bool $value): array
     {
         $name = $this->generateTokenName();
@@ -221,6 +251,9 @@ private function generateToken(bool $value): array
 
     // STORAGE ---------------------------------------------------------------------------------------------------------
 
+    /**
+     * @return array<int, array>
+     */
     private function readStorage(): array
     {
         $file = $this->getStorageFileName();
@@ -233,6 +266,10 @@ private function readStorage(): array
         }
     }
 
+    /**
+     * @param array<int, array> $list
+     * @throws JsonException
+     */
     private function writeStorage(array $list): void
     {
         $file = $this->getStorageFileName();