feat(router): add high level tests for optional parameters in router

Author: xHeaven

tests/Fixtures/Controllers/OptionalParametersController.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Tempest\Fixtures\Controllers;
+
+use Tempest\Http\Response;
+use Tempest\Http\Responses\Ok;
+use Tempest\Router\Get;
+
+final readonly class OptionalParametersController
+{
+    #[Get('/articles/{id}/{?slug}')]
+    public function articles(string $id, ?string $slug = null): Response
+    {
+        if ($slug === null) {
+            return new Ok("Article {$id} without slug");
+        }
+
+        return new Ok("Article {$id} with slug {$slug}");
+    }
+
+    #[Get('/users/{?id}')]
+    public function users(?string $id = null): Response
+    {
+        if ($id === null) {
+            return new Ok('All users');
+        }
+
+        return new Ok("User {$id}");
+    }
+
+    #[Get('/posts/{?id}/{?category}')]
+    public function posts(?string $id = null, ?string $category = null): Response
+    {
+        if ($id === null && $category === null) {
+            return new Ok('All posts');
+        }
+
+        if ($category === null) {
+            return new Ok("Post {$id}");
+        }
+
+        return new Ok("Post {$id} in category {$category}");
+    }
+}

tests/Integration/Route/RouterTest.php

@@ -291,4 +291,48 @@ public function test_without_middleware_decorator(): void
             ->assertOk()
             ->assertDoesNotHaveCookie(VerifyCsrfMiddleware::CSRF_COOKIE_KEY);
     }
+
+    public function test_optional_parameter_with_required_parameter(): void
+    {
+        $this->http
+            ->get('/articles/123')
+            ->assertOk()
+            ->assertSee('Article 123 without slug');
+
+        $this->http
+            ->get('/articles/123/my-article')
+            ->assertOk()
+            ->assertSee('Article 123 with slug my-article');
+    }
+
+    public function test_optional_parameter_only(): void
+    {
+        $this->http
+            ->get('/users')
+            ->assertOk()
+            ->assertSee('All users');
+
+        $this->http
+            ->get('/users/456')
+            ->assertOk()
+            ->assertSee('User 456');
+    }
+
+    public function test_multiple_optional_parameters(): void
+    {
+        $this->http
+            ->get('/posts')
+            ->assertOk()
+            ->assertSee('All posts');
+
+        $this->http
+            ->get('/posts/789')
+            ->assertOk()
+            ->assertSee('Post 789');
+
+        $this->http
+            ->get('/posts/789/tech')
+            ->assertOk()
+            ->assertSee('Post 789 in category tech');
+    }
 }