From 9e1aedfbadeee99afd91b54d8fed2c443e91e6a1 Mon Sep 17 00:00:00 2001
From: Funky Waddle <paul@funkywaddle.com>
Date: Thu, 10 Sep 2026 15:42:16 -0500
Subject: [PATCH] Add custom Container extending League\Container

---
 config/bootstrap.php        |  2 +-
 src/Site/Core/Container.php | 38 +++++++++++++++++++++++++++++++++++++
 2 files changed, 39 insertions(+), 1 deletion(-)
 create mode 100644 src/Site/Core/Container.php

diff --git a/config/bootstrap.php b/config/bootstrap.php
index b095f67..eda6522 100644
--- a/config/bootstrap.php
+++ b/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();
diff --git a/src/Site/Core/Container.php b/src/Site/Core/Container.php
new file mode 100644
index 0000000..b8c4c32
--- /dev/null
+++ b/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);
+        }
+    }
+}