feat: add TableHeaderRule and InputTypeRule with tests (WCAG 1.3.1, 1.3.5)

Author: PhilDaiguille

src/Rules/Forms/InputTypeRule.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TwigA11y\Rules\Forms;
+
+use TwigA11y\Rules\AbstractA11yRule;
+use TwigCsFixer\Token\Tokens;
+
+final class InputTypeRule extends AbstractA11yRule
+{
+    /**
+     * Check inputs with certain types have an autocomplete attribute.
+     */
+    protected function process(int $tokenIndex, Tokens $tokens): void
+    {
+        if (0 !== $tokenIndex) {
+            return;
+        }
+
+        $full = '';
+        foreach ($tokens->toArray() as $t) {
+            $full .= $t->getValue();
+        }
+
+        // quick bail
+        if (!str_contains($full, '<input')) {
+            return;
+        }
+
+        // find inputs of type email/tel/name etc - we'll check only email for now
+        if (!preg_match_all('/<input\b([^>]*\btype\s*=\s*(?:"|\')email(?:"|\')[^>]*)>/i', $full, $m, PREG_SET_ORDER)) {
+            return;
+        }
+
+        foreach ($m as $set) {
+            $attrs = $set[1];
+            if (!preg_match('/\bautocomplete\b\s*=\s*(?:"|\')/i', $attrs)) {
+                $token = $tokens->get(0);
+                $this->addError('Input of type "email" should include an autocomplete attribute.', $token, 'InputType.MissingAutocomplete');
+                return;
+            }
+        }
+    }
+}

src/Rules/Structure/TableHeaderRule.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TwigA11y\Rules\Structure;
+
+use TwigA11y\Rules\AbstractA11yRule;
+use TwigCsFixer\Token\Tokens;
+
+final class TableHeaderRule extends AbstractA11yRule
+{
+    protected function process(int $tokenIndex, Tokens $tokens): void
+    {
+        if (0 !== $tokenIndex) {
+            return;
+        }
+
+        $full = '';
+        foreach ($tokens->toArray() as $t) {
+            $full .= $t->getValue();
+        }
+
+        if (!str_contains($full, '<table')) {
+            return;
+        }
+
+        // Find th elements
+        if (!preg_match_all('/<th\b([^>]*)>/i', $full, $m, PREG_SET_ORDER)) {
+            return;
+        }
+
+        foreach ($m as $set) {
+            $attrs = $set[1];
+            if (!preg_match('/\bscope\b\s*=\s*(?:"|\')/i', $attrs)) {
+                $token = $tokens->get(0);
+                $this->addError('Table header <th> elements should include a scope attribute.', $token, 'TableHeader.MissingScope');
+                return;
+            }
+        }
+    }
+}

tests/Rules/Forms/Fixtures/invalid/input_missing_autocomplete.html.twig

@@ -0,0 +1,3 @@
+<form>
+  <input type="email" name="email">
+</form>

tests/Rules/Forms/Fixtures/valid/input_with_autocomplete.html.twig

@@ -0,0 +1,3 @@
+<form>
+  <input type="email" name="email" autocomplete="email">
+</form>

tests/Rules/Forms/InputTypeRuleTest.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TwigA11y\Tests\Rules\Forms;
+
+use PHPUnit\Framework\Attributes\CoversNothing;
+use PHPUnit\Framework\Attributes\DataProvider;
+use TwigA11y\Rules\Forms\InputTypeRule;
+use TwigCsFixer\Test\AbstractRuleTestCase;
+
+#[CoversNothing]
+/** @internal */
+final class InputTypeRuleTest extends AbstractRuleTestCase
+{
+    #[DataProvider('provideFixtures')]
+    public function testRule(string $fixture, array $expectedErrors): void
+    {
+        $this->checkRule(new InputTypeRule(), $expectedErrors, $fixture);
+    }
+
+    public static function provideFixtures(): iterable
+    {
+        yield 'with autocomplete' => [__DIR__.'/Fixtures/valid/input_with_autocomplete.html.twig', []];
+
+        yield 'missing autocomplete' => [
+            __DIR__.'/Fixtures/invalid/input_missing_autocomplete.html.twig',
+            ['InputType.InputType.MissingAutocomplete:1:1' => 'Input of type "email" should include an autocomplete attribute.'],
+        ];
+    }
+}

tests/Rules/Structure/Fixtures/invalid/table_missing_th_scope.html.twig

@@ -0,0 +1,14 @@
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Age</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Alice</td>
+      <td>30</td>
+    </tr>
+  </tbody>
+</table>

tests/Rules/Structure/Fixtures/valid/table_with_th_scope.html.twig

@@ -0,0 +1,14 @@
+<table>
+  <thead>
+    <tr>
+      <th scope="col">Name</th>
+      <th scope="col">Age</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Alice</td>
+      <td>30</td>
+    </tr>
+  </tbody>
+</table>

tests/Rules/Structure/TableHeaderRuleTest.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TwigA11y\Tests\Rules\Structure;
+
+use PHPUnit\Framework\Attributes\CoversNothing;
+use PHPUnit\Framework\Attributes\DataProvider;
+use TwigA11y\Rules\Structure\TableHeaderRule;
+use TwigCsFixer\Test\AbstractRuleTestCase;
+
+#[CoversNothing]
+/** @internal */
+final class TableHeaderRuleTest extends AbstractRuleTestCase
+{
+    #[DataProvider('provideFixtures')]
+    public function testRule(string $fixture, array $expectedErrors): void
+    {
+        $this->checkRule(new TableHeaderRule(), $expectedErrors, $fixture);
+    }
+
+    public static function provideFixtures(): iterable
+    {
+        yield 'valid table' => [__DIR__.'/Fixtures/valid/table_with_th_scope.html.twig', []];
+
+        yield 'missing th scope' => [
+            __DIR__.'/Fixtures/invalid/table_missing_th_scope.html.twig',
+            ['TableHeader.TableHeader.MissingScope:1:1' => 'Table header <th> elements should include a scope attribute.'],
+        ];
+    }
+}