breadcrumb-the-shire/config/router.php

<?php

use MintyPHP\App\Module\ModuleRegistry;
use MintyPHP\Router;

$routesFile = __DIR__ . '/routes.php';
$routeDefinitions = defined('APP_ROUTE_DEFINITIONS') ? APP_ROUTE_DEFINITIONS : [];
if (!is_array($routeDefinitions) || !$routeDefinitions) {
    $routeDefinitions = is_file($routesFile) ? include $routesFile : [];
}

$coreRoutePaths = [];
if (is_array($routeDefinitions)) {
    foreach ($routeDefinitions as $route) {
        $path = trim((string) ($route['path'] ?? ''));
        $target = trim((string) ($route['target'] ?? ''));
        if ($path === '' || $target === '') {
            continue;
        }
        $coreRoutePaths[$path] = $target;
        Router::addRoute($path, $target);
    }
}

// ── Module routes ────────────────────────────────────────────────────
// Module routes are merged after core routes. web/index.php includes this file
// only after container bootstrap, so ModuleRegistry is available here.
if (app(ModuleRegistry::class) instanceof ModuleRegistry) {
    $moduleRegistry = app(ModuleRegistry::class);
    $modulePaths = [];
    foreach ($moduleRegistry->getRoutes() as $route) {
        $path = trim((string) $route['path']);
        $target = trim((string) $route['target']);
        $moduleId = trim((string) $route['module_id']);
        if ($path !== '' && $target !== '') {
            if (isset($coreRoutePaths[$path])) {
                throw new RuntimeException(
                    "Module route path conflict: '{$path}' from module '{$moduleId}' collides with core route target '{$coreRoutePaths[$path]}'."
                );
            }
            if (isset($modulePaths[$path])) {
                throw new RuntimeException(
                    "Module route path conflict: '{$path}' from module '{$moduleId}' collides with module '{$modulePaths[$path]}'."
                );
            }
            $modulePaths[$path] = $moduleId;
            Router::addRoute($path, $target);
        }
    }
}