breadcrumb-the-shire/lib/App/registerContainer.php

<?php

use MintyPHP\App\AppContainer;
use MintyPHP\App\Container\ContainerRegistrar;
use MintyPHP\App\Container\Registrars\AccessRegistrar;
use MintyPHP\App\Container\Registrars\AppServicesRegistrar;
use MintyPHP\App\Container\Registrars\AuthRegistrar;
use MintyPHP\App\Container\Registrars\DirectoryRegistrar;
use MintyPHP\App\Container\Registrars\RepositoryFactoryRegistrar;
use MintyPHP\App\Container\Registrars\ServiceFactoryRegistrar;
use MintyPHP\App\Container\Registrars\SettingsRegistrar;
use MintyPHP\App\Container\Registrars\UserRegistrar;
use MintyPHP\App\Module\ModuleRegistry;

$container = new AppContainer();

// Order matters: RepositoryFactoryRegistrar and ServiceFactoryRegistrar must run first
// because later registrars pull concrete services from those factories.
$registrars = [
    new RepositoryFactoryRegistrar(),   // raw repository factories (no deps)
    new ServiceFactoryRegistrar(),      // service factories wired with their repo/gateway deps
    new AccessRegistrar(),              // RBAC: permissions, roles, authorization
    new AuthRegistrar(),               // authentication, SSO, tokens
    new DirectoryRegistrar(),           // tenants, departments, scope
    new UserRegistrar(),               // user services and repositories
    new SettingsRegistrar(),           // settings, branding
    new AppServicesRegistrar(),        // leaf services (stats, search, mail, scheduler, ...)
];

foreach ($registrars as $registrar) {
    $registrar->register($container);
}

// ── Module registrars (run after all Core registrars) ────────────────
// Module registrars MUST NOT overwrite existing container keys.
// The ModuleRegistry is stored in the container for downstream access.

$modulesConfig = is_file(__DIR__ . '/../../config/modules.php')
    ? (array) require __DIR__ . '/../../config/modules.php'
    : [];
$enabledModules = ModuleRegistry::resolveEnabledModules($modulesConfig);
$modulesDir = dirname(__DIR__, 2) . '/modules';
$moduleRegistry = ModuleRegistry::boot($modulesDir, $enabledModules);

$container->set(ModuleRegistry::class, static fn (): ModuleRegistry => $moduleRegistry);

$coreKeys = []; // snapshot keys before module registrars
// We use reflection-free approach: track what the container had before modules
foreach ($moduleRegistry->getContainerRegistrars() as $registrarClass) {
    if (!class_exists($registrarClass)) {
        throw new RuntimeException("Module container registrar class not found: {$registrarClass}");
    }
    $registrarInstance = new $registrarClass();
    if (!$registrarInstance instanceof ContainerRegistrar) {
        throw new RuntimeException(
            "Module container registrar '{$registrarClass}' must implement " . ContainerRegistrar::class
        );
    }
    $registrarInstance->register($container);
}

return $container;