chore: add php-cs-fixer with PSR-12 config and CI check

- Add friendsofphp/php-cs-fixer to require-dev
- Create .php-cs-fixer.dist.php configured for @PSR12 ruleset
- Add php-cs-fixer dry-run step to CI pipeline
- Auto-fix existing PSR-12 violations
- Document code style tooling in readme.md

tests/Unit/Trait/MakeNonceTraitTest.php

@@ -1,4 +1,5 @@
 <?php
+
 declare(strict_types=1);
 
 namespace App\Tests\Unit\Trait;
@@ -15,22 +16,27 @@ use Symfony\Component\HttpKernel\Exception\HttpException;
  * Wraps the trait in a concrete class with public proxies so the protected
  * methods can be exercised from test scope.
  */
-final class MakeNonceTraitTest extends TestCase {
-    private function makeObject(): object {
-        return new class {
+final class MakeNonceTraitTest extends TestCase
+{
+    private function makeObject(): object
+    {
+        return new class () {
             use MakeNonceTrait;
 
-            public function publicMakeNonce(int $retries = 3): string {
+            public function publicMakeNonce(int $retries = 3): string
+            {
                 return $this->makeNonce($retries);
             }
 
-            public function publicMakeCacheKey(string $name): string {
+            public function publicMakeCacheKey(string $name): string
+            {
                 return $this->makeCacheKey($name);
             }
         };
     }
 
-    public function testMakeNonceReturnsBase64UrlString(): void {
+    public function testMakeNonceReturnsBase64UrlString(): void
+    {
         $obj = $this->makeObject();
         $obj->setLogger(new NullLogger());
         $obj->setNonceCache(new ArrayAdapter());
@@ -44,7 +50,8 @@ final class MakeNonceTraitTest extends TestCase {
         self::assertMatchesRegularExpression('/^[A-Za-z0-9_-]+$/', $nonce);
     }
 
-    public function testMakeNonceStoresNonceInCache(): void {
+    public function testMakeNonceStoresNonceInCache(): void
+    {
         $pool = new ArrayAdapter();
         $obj = $this->makeObject();
         $obj->setLogger(new NullLogger());
@@ -59,7 +66,8 @@ final class MakeNonceTraitTest extends TestCase {
         self::assertTrue($item->get());
     }
 
-    public function testMakeNonceSetsExpiry(): void {
+    public function testMakeNonceSetsExpiry(): void
+    {
         $pool = new ArrayAdapter();
         $obj = $this->makeObject();
         $obj->setLogger(new NullLogger());
@@ -74,7 +82,8 @@ final class MakeNonceTraitTest extends TestCase {
         self::assertGreaterThan(time(), (int) $expiry);
     }
 
-    public function testTwoNoncesAreDifferent(): void {
+    public function testTwoNoncesAreDifferent(): void
+    {
         $pool = new ArrayAdapter();
         $obj = $this->makeObject();
         $obj->setLogger(new NullLogger());
@@ -86,7 +95,8 @@ final class MakeNonceTraitTest extends TestCase {
         self::assertNotSame($nonce1, $nonce2);
     }
 
-    public function testMakeNonceThrowsAfterMaxRetries(): void {
+    public function testMakeNonceThrowsAfterMaxRetries(): void
+    {
         // Create a stub pool that always reports every key as a hit (collision)
         $pool = $this->createStub(CacheItemPoolInterface::class);
         $item = $this->createStub(CacheItemInterface::class);
@@ -105,46 +115,93 @@ final class MakeNonceTraitTest extends TestCase {
         $obj->publicMakeNonce();
     }
 
-    public function testMakeNonceRetriesAndSucceedsAfterCollision(): void {
+    public function testMakeNonceRetriesAndSucceedsAfterCollision(): void
+    {
         // Use a spy pool that returns isHit=true on the first getItem call
         // (simulating a collision), then delegates to a real ArrayAdapter for
         // subsequent calls so the retry succeeds.
         $realPool = new ArrayAdapter();
         $collisionCount = 0;
 
-        $spyPool = new class($realPool, $collisionCount) implements CacheItemPoolInterface {
+        $spyPool = new class ($realPool, $collisionCount) implements CacheItemPoolInterface {
             private int $hits = 0;
             public function __construct(
                 private CacheItemPoolInterface $inner,
                 private int &$hitCounter,
-            ) {}
+            ) {
+            }
 
-            public function getItem(string $key): CacheItemInterface {
+            public function getItem(string $key): CacheItemInterface
+            {
                 $item = $this->inner->getItem($key);
                 // pretend the first requested key is already a hit (collision)
                 if ($this->hits === 0) {
                     $this->hits++;
                     $this->hitCounter++;
-                    return new class($key) implements CacheItemInterface {
-                        public function __construct(private string $key) {}
-                        public function getKey(): string { return $this->key; }
-                        public function get(): mixed { return true; }
-                        public function isHit(): bool { return true; }
-                        public function set(mixed $value): static { return $this; }
-                        public function expiresAt(?\DateTimeInterface $expiration): static { return $this; }
-                        public function expiresAfter(int|\DateInterval|null $time): static { return $this; }
+                    return new class ($key) implements CacheItemInterface {
+                        public function __construct(private string $key)
+                        {
+                        }
+                        public function getKey(): string
+                        {
+                            return $this->key;
+                        }
+                        public function get(): mixed
+                        {
+                            return true;
+                        }
+                        public function isHit(): bool
+                        {
+                            return true;
+                        }
+                        public function set(mixed $value): static
+                        {
+                            return $this;
+                        }
+                        public function expiresAt(?\DateTimeInterface $expiration): static
+                        {
+                            return $this;
+                        }
+                        public function expiresAfter(int|\DateInterval|null $time): static
+                        {
+                            return $this;
+                        }
                     };
                 }
                 return $item;
             }
-            public function getItems(array $keys = []): iterable { return $this->inner->getItems($keys); }
-            public function hasItem(string $key): bool { return $this->inner->hasItem($key); }
-            public function clear(): bool { return $this->inner->clear(); }
-            public function deleteItem(string $key): bool { return $this->inner->deleteItem($key); }
-            public function deleteItems(array $keys): bool { return $this->inner->deleteItems($keys); }
-            public function save(CacheItemInterface $item): bool { return $this->inner->save($item); }
-            public function saveDeferred(CacheItemInterface $item): bool { return $this->inner->saveDeferred($item); }
-            public function commit(): bool { return $this->inner->commit(); }
+            public function getItems(array $keys = []): iterable
+            {
+                return $this->inner->getItems($keys);
+            }
+            public function hasItem(string $key): bool
+            {
+                return $this->inner->hasItem($key);
+            }
+            public function clear(): bool
+            {
+                return $this->inner->clear();
+            }
+            public function deleteItem(string $key): bool
+            {
+                return $this->inner->deleteItem($key);
+            }
+            public function deleteItems(array $keys): bool
+            {
+                return $this->inner->deleteItems($keys);
+            }
+            public function save(CacheItemInterface $item): bool
+            {
+                return $this->inner->save($item);
+            }
+            public function saveDeferred(CacheItemInterface $item): bool
+            {
+                return $this->inner->saveDeferred($item);
+            }
+            public function commit(): bool
+            {
+                return $this->inner->commit();
+            }
         };
 
         $obj = $this->makeObject();
@@ -158,7 +215,8 @@ final class MakeNonceTraitTest extends TestCase {
         self::assertSame(1, $collisionCount, 'Expected exactly one collision before success');
     }
 
-    public function testMakeNonceThrowsImmediatelyWithZeroRetries(): void {
+    public function testMakeNonceThrowsImmediatelyWithZeroRetries(): void
+    {
         $pool = $this->createStub(CacheItemPoolInterface::class);
         $item = $this->createStub(CacheItemInterface::class);
         $item->method('isHit')->willReturn(true);