Improvements of phpdocs and fix phpstan reported errors

.github/workflows/test.yml

@@ -1,5 +1,8 @@
 name: "Run unit tests"
 
+permissions:
+  contents: read
+
 on:
   - push
   - pull_request

composer.json

@@ -26,6 +26,6 @@
     "sabberworm/php-css-parser": "^8.4"
   },
   "require-dev": {
-    "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11"
+    "phpunit/phpunit": "^7.5 || ^8 || ^9 || ^10 || ^11 || ^12"
   }
 }

src/Svg/Document.php

@@ -357,7 +357,7 @@ private function _tagStart($parser, $name, $attributes)
                 $this->enterDefs();
                 $tag = new Symbol($this, $name);
                 break;
-    
+
             case 'clippath':
                 $tag = new ClipPath($this, $name);
                 break;
@@ -403,7 +403,7 @@ function _charData($parser, $data)
 
     function _tagEnd($parser, $name)
     {
-        /** @var AbstractTag $tag */
+        /** @var AbstractTag|null $tag */
         $tag = null;
         switch (strtolower($name)) {
             case 'defs':
@@ -414,7 +414,7 @@ function _tagEnd($parser, $name)
                 $this->exitDefs();
                 $tag = array_pop($this->stack);
                 break;
-    
+
             case 'svg':
             case 'path':
             case 'rect':
@@ -437,8 +437,8 @@ function _tagEnd($parser, $name)
                 break;
         }
 
-        if ((!$this->inDefs && $tag) || $tag instanceof StyleTag) {
+        if ((!$this->inDefs && $tag !== null) || $tag instanceof StyleTag) {
             $tag->handleEnd();
         }
     }
-} 
+}

src/Svg/Style.php

@@ -78,9 +78,9 @@ protected function getStyleMap()
     }
 
     /**
-     * @param $attributes
+     * @param array<string,string|float|int|null> $attributes
      *
-     * @return Style
+     * @return void
      */
     public function fromAttributes($attributes)
     {
@@ -151,6 +151,11 @@ public function fromStyleSheets(AbstractTag $tag, $attributes) {
         $this->fillStyles($styles);
     }
 
+    /**
+     * @param array<string,string|float|int|null> $styles
+     *
+     * @return void
+     */
     protected function fillStyles($styles)
     {
         $style_map = $this->getStyleMap();