refactor(kernel): integrate new match-only Router and move controller execution into Kernel

Author: KolesnikovKirill

CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to **codemonster-ru/annabel** will be documented in this file.
 
+## [1.8.0] - 2025-11-16
+
+### Changed
+
+-   The HTTP Kernel has been redesigned to integrate with the updated Router architecture (match-only).
+-   The Kernel is now fully responsible for executing controllers, building the middleware pipeline, and generating Responses.
+-   The handler invocation logic has been moved from the Router and Dispatcher to the Kernel.
+-   Improved error handling: The Kernel now correctly passes exceptions to the ExceptionHandler, even if they occur within middleware or a controller.
+-   The structure of the `dispatch()` method has been optimized; it now works only with Routes and delegates execution to `runRoute()`.
+
+### Added
+
+-   The `runRoute()` method has been added—a single point of execution for controllers and middleware.
+-   Support for the Annabel DI container when creating controllers and middleware.
+-   Support for route-middleware at the Route object level.
+
+### Fixed
+
+-   Fixed an issue where Router would return the result of executing handler instead of Route, which would break the Kernel architecture.
+-   Fixed the middleware execution order (it now correctly wraps the controller, as in Laravel).
+-   Fixed bugs related to empty Response and rendering errors when there was no content.
+
 ## [1.7.0] - 2025-11-10
 
 ### Added

src/Bootstrap/Bootstrapper.php

@@ -106,8 +106,6 @@ protected function initKernel(): void
 
     protected function initErrorHandler(): void
     {
-        // Avoid installing a global exception handler in CLI/DBG modes
-        // to prevent PHPUnit from flagging tests as risky.
         if (PHP_SAPI === 'cli' || PHP_SAPI === 'phpdbg') {
             return;
         }

src/Http/Kernel.php

@@ -4,6 +4,7 @@
 
 use Codemonster\Annabel\Application;
 use Codemonster\Errors\Contracts\ExceptionHandlerInterface;
+use Codemonster\Router\Route;
 use Codemonster\Router\Router;
 use Codemonster\Http\Request;
 use Codemonster\Http\Response;
@@ -71,13 +72,13 @@ protected function handleException(Throwable $e): Response
 
     protected function dispatch(Request $request): mixed
     {
-        $result = $this->router->dispatch($request->method(), $request->uri());
+        $route = $this->router->dispatch($request->method(), $request->uri());
 
-        if ($result === null) {
+        if (!$route) {
             return $this->handleHttpError(404, 'Page not found');
         }
 
-        return $result;
+        return $this->runRoute($route, $request);
     }
 
     protected function handleHttpError(int $status, string $message = ''): Response
@@ -135,4 +136,39 @@ public function getRouter(): Router
     {
         return $this->router;
     }
+
+    protected function runRoute(Route $route, Request $request): mixed
+    {
+        $handler = $route->handler;
+        $middlewareList = $route->getMiddleware();
+
+        $kernel = $this;
+
+        $core = function (Request $req) use ($handler, $kernel) {
+
+            if (is_array($handler)) {
+                [$class, $method] = $handler;
+
+                $controller = $kernel->app->make($class);
+
+                return $controller->$method($req);
+            }
+
+            return $handler($req);
+        };
+
+        $pipeline = array_reduce(
+            array_reverse($middlewareList),
+            function ($next, $middlewareClass) use ($kernel) {
+                return function (Request $req) use ($middlewareClass, $next, $kernel) {
+                    $middleware = $kernel->app->make($middlewareClass);
+
+                    return $middleware->handle($req, $next);
+                };
+            },
+            $core
+        );
+
+        return $pipeline($request);
+    }
 }