Add ViewMatched event

src/Events/ViewMatched.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace Laravel\Folio\Events;
+
+use Laravel\Folio\MountPath;
+use Laravel\Folio\Pipeline\MatchedView;
+
+class ViewMatched
+{
+    public function __construct(
+        public readonly MatchedView $matchedView,
+        public readonly MountPath $mountPath,
+    ) {}
+}

src/RequestHandler.php

@@ -3,6 +3,7 @@
 namespace Laravel\Folio;
 
 use Closure;
+use Illuminate\Contracts\Events\Dispatcher;
 use Illuminate\Http\Request;
 use Illuminate\Http\Response;
 use Illuminate\Routing\Pipeline;
@@ -30,6 +31,8 @@ public function __invoke(Request $request, string $uri): mixed
             $this->mountPath->path
         ))->match($request, $uri) ?? abort(404);
 
+        app(Dispatcher::class)->dispatch(new Events\ViewMatched($matchedView, $this->mountPath));
+
         return (new Pipeline(app()))
             ->send($request)
             ->through($this->middleware($matchedView))

tests/Feature/ManagerTest.php

@@ -1,7 +1,9 @@
 <?php
 
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Route;
+use Laravel\Folio\Events\ViewMatched;
 use Laravel\Folio\Folio;
 use Laravel\Folio\Pipeline\MatchedView;
 
@@ -52,3 +54,29 @@
         ->and($data)->toBe(['id' => 'Taylor'])
         ->and($mountPath)->toBe(__DIR__.'/resources/views/pages');
 });
+
+it('fires view matched event on route', function () {
+    Folio::route(__DIR__.'/resources/views/pages');
+
+    $events = Event::fake(ViewMatched::class);
+
+    $response = $this->get('/users/Taylor');
+
+    $response->assertOk();
+
+    $events->assertDispatched(ViewMatched::class, function ($event) {
+        return $event->matchedView->path === __DIR__.'/resources/views/pages/users/[id].blade.php';
+    });
+});
+
+it('doesn\'t fire view matched event on 404', function () {
+    Folio::route(__DIR__.'/resources/views/pages');
+
+    $events = Event::fake(ViewMatched::class);
+
+    $response = $this->get('/invalid-route');
+
+    $response->assertNotFound();
+
+    $events->assertNotDispatched(ViewMatched::class);
+});