feat: Release v3.0.0 - PHPStan-style analysis, configuration, baseline, and advanced WCAG rules

src/Rules/MediaAutoplay.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace YakNet\AccessibilityConsole\Rules;
+
+use DOMElement;
+use YakNet\AccessibilityConsole\Core\Severity;
+use YakNet\AccessibilityConsole\Core\Violation;
+use YakNet\AccessibilityConsole\Core\WCAGStandard;
+
+class MediaAutoplay extends AbstractRule
+{
+    public function getId(): string { return 'WCAG_1_4_2_AUTOPLAY'; }
+    public function getDescription(): string { return 'Audio and video elements must not autoplay with sound, as it interferes with screen readers and user control.'; }
+    public function getStandard(): WCAGStandard { return WCAGStandard::A; }
+    public function getSeverity(): Severity { return Severity::ERROR; }
+    public function getLevel(): int { return 2; }
+
+    public function check(DOMElement $element): ?Violation
+    {
+        $tagName = strtolower($element->tagName);
+        if ($tagName !== 'video' && $tagName !== 'audio') {
+            return null;
+        }
+
+        if ($element->hasAttribute('autoplay')) {
+            // If autoplay is active, it must be muted to be acceptable
+            if (!$element->hasAttribute('muted')) {
+                return $this->createViolation(
+                    $element,
+                    $this->getDescription(),
+                    'Remove the autoplay attribute, or add the muted attribute to prevent the media from playing sound automatically.'
+                );
+            }
+        }
+
+        return null;
+    }
+}