fix: resolve PHPStan level 9 errors and bump version to v3.1.3

src/Rules/ButtonName.php

@@ -27,10 +27,63 @@ class ButtonName extends AbstractRule
         }
 
         $text = trim($element->textContent);
-        if ($text === '' && !$element->hasAttribute('aria-label') && !$element->hasAttribute('title')) {
-            return $this->createViolation($element, $this->getDescription(), 'Add text or an aria-label to the button.');
+        if ($text !== '') {
+            return null;
         }
 
-        return null;
+        if ($element->hasAttribute('aria-label') && trim($element->getAttribute('aria-label')) !== '') {
+            return null;
+        }
+
+        if ($element->hasAttribute('title') && trim($element->getAttribute('title')) !== '') {
+            return null;
+        }
+
+        if ($element->hasAttribute('aria-labelledby')) {
+            $id = $element->getAttribute('aria-labelledby');
+            $doc = $element->ownerDocument;
+            if ($doc !== null) {
+                $xpath = new \DOMXPath($doc);
+                $labels = $xpath->query("//*[@id='$id']");
+                if ($labels !== false && $labels->length > 0) {
+                    $labelNode = $labels->item(0);
+                    if ($labelNode instanceof \DOMNode && trim($labelNode->textContent) !== '') {
+                        return null;
+                    }
+                }
+            }
+        }
+
+        $imgs = $element->getElementsByTagName('img');
+        foreach ($imgs as $img) {
+            if ($img->hasAttribute('alt') && trim($img->getAttribute('alt')) !== '') {
+                return null;
+            }
+        }
+
+        $svgs = $element->getElementsByTagName('svg');
+        foreach ($svgs as $svg) {
+            $titles = $svg->getElementsByTagName('title');
+            foreach ($titles as $title) {
+                if (trim($title->textContent) !== '') {
+                    return null;
+                }
+            }
+        }
+
+        $doc = $element->ownerDocument;
+        if ($doc !== null) {
+            $xpath = new \DOMXPath($doc);
+            $roleImgs = $xpath->query('.//*[@role="img"]', $element);
+            if ($roleImgs !== false) {
+                foreach ($roleImgs as $roleImg) {
+                    if ($roleImg instanceof DOMElement && $roleImg->hasAttribute('aria-label') && trim($roleImg->getAttribute('aria-label')) !== '') {
+                        return null;
+                    }
+                }
+            }
+        }
+
+        return $this->createViolation($element, $this->getDescription(), 'Add text or an aria-label to the button.');
     }
 }