From 8672ec72a4bf0b865fe5de98eb63fb52deacab69 Mon Sep 17 00:00:00 2001
From: Jay Potter <j@ypotter.ca>
Date: Sun, 31 May 2026 19:14:24 -0400
Subject: [PATCH] implement Potter\Aware

---
 composer.json                       |  6 ++++--
 src/Potter/Aware/AbstractAware.php  | 16 ++++++++++++++++
 src/Potter/Aware/Aware.php          | 10 ++++++++++
 src/Potter/Aware/AwareInterface.php | 14 ++++++++++++++
 src/Potter/Aware/AwareTrait.php     | 26 ++++++++++++++++++++++++++
 5 files changed, 70 insertions(+), 2 deletions(-)
 create mode 100644 src/Potter/Aware/AbstractAware.php
 create mode 100644 src/Potter/Aware/Aware.php
 create mode 100644 src/Potter/Aware/AwareInterface.php
 create mode 100644 src/Potter/Aware/AwareTrait.php

diff --git a/composer.json b/composer.json
index ccfcc21..50261f9 100644
--- a/composer.json
+++ b/composer.json
@@ -3,12 +3,14 @@
     "description": "Potter Framework Aware Implementation",
     "type": "library",
     "require": {
-        "php": "^8.5"
+        "php": "^8.5",
+        "potter/cloneable": "^0.0.1",
+        "potter/container": "^0.0.1"
     },
     "license": "MIT",
     "autoload": {
         "psr-4": {
-            "Potter\\Aware": "src/Potter/Aware/"
+            "Potter\\Aware\\": "src/Potter/Aware/"
         }
     },
     "authors": [
diff --git a/src/Potter/Aware/AbstractAware.php b/src/Potter/Aware/AbstractAware.php
new file mode 100644
index 0000000..90922d3
--- /dev/null
+++ b/src/Potter/Aware/AbstractAware.php
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Aware;
+
+use \Potter\Cloneable\CloneableTrait;
+use \Potter\Container\Container;
+
+abstract class AbstractAware extends Container
+{
+    use CloneableTrait;
+    
+    abstract public function with(string $key, mixed $value): static;
+    abstract public function without(string $key): static;
+}
diff --git a/src/Potter/Aware/Aware.php b/src/Potter/Aware/Aware.php
new file mode 100644
index 0000000..f513a34
--- /dev/null
+++ b/src/Potter/Aware/Aware.php
@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Aware;
+
+abstract class Aware extends AbstractAware
+{
+    use AwareTrait, CloneableTrait;
+}
diff --git a/src/Potter/Aware/AwareInterface.php b/src/Potter/Aware/AwareInterface.php
new file mode 100644
index 0000000..9c43f53
--- /dev/null
+++ b/src/Potter/Aware/AwareInterface.php
@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Aware;
+
+use \Potter\Cloneable\CloneableInterface;
+use \Potter\Container\ContainerInterface;
+
+interface AwareInterface extends CloneableInterface, ContainerInterface
+{
+    public function with(string $key, mixed $value): static;
+    public function without(string $key): static;
+}
diff --git a/src/Potter/Aware/AwareTrait.php b/src/Potter/Aware/AwareTrait.php
new file mode 100644
index 0000000..69c9e25
--- /dev/null
+++ b/src/Potter/Aware/AwareTrait.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Aware;
+
+trait AwareTrait 
+{
+    final public function with(string $key, mixed $value): static
+    {
+        $clone = $this->clone();
+        $clone->set($key, $value);
+        return $clone;
+    }
+    
+    final public function without(string $key): static
+    {
+        $clone = $this->clone();
+        $clone->unset($key);
+        return $clone;
+    }
+    
+    abstract public function clone(): static;
+    abstract protected function set(string $key, mixed $value): mixed;
+    abstract protected function unset(string $key): void;
+}