Add custom Container extending League\Container

config/bootstrap.php

@@ -17,7 +17,7 @@ $dotenv->safeLoad();
 
 $mergedEnv = $_ENV + $_SERVER;
 
-use League\Container\Container;
+use SiteWeaver\Core\Container;
 use SiteWeaver\Core\Config;
 use SiteWeaver\Core\Router;
 $container = new Container();

src/Site/Core/Container.php

@@ -0,0 +1,38 @@
+<?php
+/**
+ * File: src/Site/Core/Container.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   A thin wrapper around League\Container\Container to enable future custom
+ *   functionality while preserving the existing API.
+ */
+declare(strict_types=1);
+
+namespace SiteWeaver\Core;
+
+use League\Container\Container as LeagueContainer;
+
+/**
+ * Custom DI container that extends League's container.
+ * It can be extended with additional methods without affecting
+ * existing code that relies on the League implementation.
+ */
+class Container extends LeagueContainer
+{
+    /**
+     * Construct a new custom container.
+     *
+     * @param array<string, mixed> $services Optional initial service definitions
+     */
+    public function __construct(array $services = [])
+    {
+        parent::__construct();
+
+        foreach ($services as $key=>$svc) {
+            $this->add($key, $svc);
+        }
+    }
+}