From c38310faf7daeaaa33299838d0fbcf6aa3ace681 Mon Sep 17 00:00:00 2001
From: jay <j@ypotter.ca>
Date: Fri, 5 Jun 2026 15:46:29 -0400
Subject: [PATCH] 0.0.1

---
 README.md                               |  4 ++--
 composer.json                           | 10 ++++++----
 src/Potter/Uri/UriFragmentInterface.php | 13 +++++++++++++
 src/Potter/Uri/UriHostInterface.php     | 13 +++++++++++++
 src/Potter/Uri/UriInterface.php         | 17 +++++++++++++++++
 src/Potter/Uri/UriPathInterface.php     | 13 +++++++++++++
 src/Potter/Uri/UriPortInterface.php     | 13 +++++++++++++
 src/Potter/Uri/UriQueryInterface.php    | 13 +++++++++++++
 src/Potter/Uri/UriSchemeInterface.php   | 13 +++++++++++++
 src/Potter/Uri/UriUserInterface.php     | 13 +++++++++++++
 10 files changed, 116 insertions(+), 6 deletions(-)
 create mode 100644 src/Potter/Uri/UriFragmentInterface.php
 create mode 100644 src/Potter/Uri/UriHostInterface.php
 create mode 100644 src/Potter/Uri/UriInterface.php
 create mode 100644 src/Potter/Uri/UriPathInterface.php
 create mode 100644 src/Potter/Uri/UriPortInterface.php
 create mode 100644 src/Potter/Uri/UriQueryInterface.php
 create mode 100644 src/Potter/Uri/UriSchemeInterface.php
 create mode 100644 src/Potter/Uri/UriUserInterface.php

diff --git a/README.md b/README.md
index ab05ff6..94821be 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,3 @@
-# Template
+# Uri
 
-Potter Framework Component Template
\ No newline at end of file
+Potter Framework Uri Interface
\ No newline at end of file
diff --git a/composer.json b/composer.json
index 632d3fd..2a3a248 100644
--- a/composer.json
+++ b/composer.json
@@ -1,14 +1,16 @@
 {
-    "name": "potter/template",
-    "description": "Potter Framework Component Template",
+    "name": "potter/uri",
+    "description": "Potter Framework Uri Template",
     "type": "library",
     "require": {
-        "php": "^8.5"
+        "php": "^8.5",
+        "psr/http-message": "^2.0",
+        "potter/stringable": "^0.0.1"
     },
     "license": "MIT",
     "autoload": {
         "psr-4": {
-            "Potter\\": "src/Potter/"
+            "Potter\\Uri\\": "src/Potter/Uri/"
         }
     },
     "authors": [
diff --git a/src/Potter/Uri/UriFragmentInterface.php b/src/Potter/Uri/UriFragmentInterface.php
new file mode 100644
index 0000000..6e9f91b
--- /dev/null
+++ b/src/Potter/Uri/UriFragmentInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+
+interface UriFragmentInterface 
+{
+    public function getFragment(): string;
+    public function withFragment(string $fragment): PsrUriInterface;
+}
diff --git a/src/Potter/Uri/UriHostInterface.php b/src/Potter/Uri/UriHostInterface.php
new file mode 100644
index 0000000..73103b2
--- /dev/null
+++ b/src/Potter/Uri/UriHostInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+
+interface UriHostInterface 
+{
+    public function getHost(): string;
+    public function withHost(string $host): PsrUriInterface;
+}
diff --git a/src/Potter/Uri/UriInterface.php b/src/Potter/Uri/UriInterface.php
new file mode 100644
index 0000000..517f91f
--- /dev/null
+++ b/src/Potter/Uri/UriInterface.php
@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+use \Potter\Stringable\StringableInterface;
+
+interface UriInterface extends PsrUriInterface, 
+    UriFragmentInterface, UriHostInterface, 
+    UriPathInterface, UriPortInterface, 
+    UriQueryInterface, UriSchemeInterface, 
+    UriUserInterface, StringableInterface
+{
+    public function getAuthority(): string;
+}
diff --git a/src/Potter/Uri/UriPathInterface.php b/src/Potter/Uri/UriPathInterface.php
new file mode 100644
index 0000000..ebfcb60
--- /dev/null
+++ b/src/Potter/Uri/UriPathInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+
+interface UriPathInterface 
+{
+    public function getPath(): string;
+    public function withPath(string $path): PsrUriInterface;
+}
diff --git a/src/Potter/Uri/UriPortInterface.php b/src/Potter/Uri/UriPortInterface.php
new file mode 100644
index 0000000..087f18d
--- /dev/null
+++ b/src/Potter/Uri/UriPortInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+
+interface UriPortInterface 
+{
+    public function getPort(): ?int;
+    public function withPort(?int $port): PsrUriInterface;
+}
diff --git a/src/Potter/Uri/UriQueryInterface.php b/src/Potter/Uri/UriQueryInterface.php
new file mode 100644
index 0000000..3b0ea20
--- /dev/null
+++ b/src/Potter/Uri/UriQueryInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+
+interface UriQueryInterface 
+{
+    public function getQuery(): string;
+    public function withQuery(string $query): PsrUriInterface;
+}
diff --git a/src/Potter/Uri/UriSchemeInterface.php b/src/Potter/Uri/UriSchemeInterface.php
new file mode 100644
index 0000000..1419a75
--- /dev/null
+++ b/src/Potter/Uri/UriSchemeInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+
+interface UriSchemeInterface 
+{
+    public function getScheme(): string;
+    public function withScheme(string $scheme): PsrUriInterface;
+}
diff --git a/src/Potter/Uri/UriUserInterface.php b/src/Potter/Uri/UriUserInterface.php
new file mode 100644
index 0000000..c54bf98
--- /dev/null
+++ b/src/Potter/Uri/UriUserInterface.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Potter\Uri;
+
+use \Psr\Http\Message\UriInterface as PsrUriInterface;
+
+interface UriUserInterface 
+{
+    public function getUserInfo(): string;
+    public function withUserInfo(string $user, ?string $password = null): PsrUriInterface;
+}