feat(chore): init project + add accessibility rules for img tags in Twig templates

Author: PhilDaiguille

.github/workflows/phpunit.yml

@@ -0,0 +1,43 @@
+name: Run tests
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  phpunit:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php: [ '8.2', '8.3', '8.4' ]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: mbstring, dom
+          coverage: none
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "COMPOSER_CACHE_DIR=$(composer config cache-files-dir)" >> $GITHUB_ENV
+
+      - name: Cache composer dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.COMPOSER_CACHE_DIR }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress --no-suggest --optimize-autoloader
+
+      - name: Run tests
+        run: composer test

.gitignore

@@ -0,0 +1,5 @@
+vendor
+.agents
+.php-cs-fixer.cache
+.phpunit.result.cache
+AGENT.md

.php-cs-fixer.dist.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+
+return (new Config())
+    ->setRiskyAllowed(false)
+    ->setRules([
+        '@auto' => true,
+        '@PhpCsFixer' => true
+    ])
+    ->setFinder(
+        (new Finder())
+            // 💡 root folder to check
+            ->in(__DIR__)
+            // 💡 additional files, eg bin entry file
+            // ->append([__DIR__.'/bin-entry-file'])
+            // 💡 folders to exclude, if any
+            // ->exclude([/* ... */])
+            // 💡 path patterns to exclude, if any
+            // ->notPath([/* ... */])
+            // 💡 extra configs
+            // ->ignoreDotFiles(false) // true by default in v3, false in v4 or future mode
+            // ->ignoreVCS(true) // true by default
+    )
+;

README.md

@@ -0,0 +1,29 @@
+Twig A11y Rules
+================
+
+Petit projet fournissant des règles d'accessibilité pour les templates Twig.
+
+Prerequis
+-
+- PHP >= 8.2
+- Composer
+
+Installer les dépendances
+-
+1. Installer les dépendances :
+
+   composer install
+
+Lancer les tests
+-
+1. Exécuter la suite de tests :
+
+   composer test
+
+Workflow CI
+-
+Un workflow GitHub Actions est fourni dans `.github/workflows/phpunit.yml`. Il installe PHP (8.2/8.3/8.4), installe les dépendances via Composer et exécute `composer test` sur chaque push et pull request vers `main` / `master`.
+
+Contribuer
+-
+Les contributions sont bienvenues — ouvrez une issue ou une PR.

composer.json

@@ -0,0 +1,32 @@
+{
+    "name": "phildaiguille/twig-a11y-rules",
+    "description": "Accessibility linting rules for Twig templates",
+    "type": "library",
+    "license": "MIT",
+    "version": "1.0.0",
+    "require": {
+        "php": "^8.2",
+        "vincentlanglet/twig-cs-fixer": "^3.14.0"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^13.1.7",
+        "friendsofphp/php-cs-fixer": "^3.95",
+        "rector/rector": "^2.4"
+    },
+    "autoload": {
+        "psr-4": {
+            "TwigA11y\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "TwigA11y\\Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "test": "phpunit tests --testdox",
+        "lint": "php-cs-fixer fix --dry-run --diff --verbose",
+        "fix": "php-cs-fixer fix",
+        "rector": "rector src"
+    }
+}