From dbdde9fcaf3dc34f521b96ba4c0491a6d9c01bdb Mon Sep 17 00:00:00 2001
From: Victor Westerlund <victor@vlw.se>
Date: Thu, 30 Oct 2025 17:41:31 +0100
Subject: [PATCH] feat: add dedicated class for crosstalk between Vegvisir and
 Reflect (#2)

In this PR we move the Vegvisir `VV` class import into Reflect from the API class into its own `Scaffold` class. This new class will include everything that is required for crosstalk between Vegvisir and Reflect.

Reviewed-on: https://codeberg.org/vlw/scaffold/pulls/2
---
 src/API/API.php  |  4 ----
 src/Scaffold.php | 29 +++++++++++++++++++++++++++++
 2 files changed, 29 insertions(+), 4 deletions(-)
 create mode 100644 src/Scaffold.php

diff --git a/src/API/API.php b/src/API/API.php
index 2b4c726..b9b5f2d 100644
--- a/src/API/API.php
+++ b/src/API/API.php
@@ -7,12 +7,8 @@
 
 	namespace vlw\Scaffold\API;
 
-	use Reflect\Path;
 	use Reflect\Rules\Ruleset;
 
-	require_once Path::root("vegvisir/src/kernel/Init.php");
-	require_once Path::root("vegvisir/src/request/VV.php");
-
 	class API {
 		/**
 		 * Create a new API request with automatic request validation
diff --git a/src/Scaffold.php b/src/Scaffold.php
new file mode 100644
index 0000000..313bb7d
--- /dev/null
+++ b/src/Scaffold.php
@@ -0,0 +1,29 @@
+<?php
+
+	namespace vlw\Scaffold;
+
+	use VV;
+	use Reflect\Path;
+
+	class Scaffold {
+		/**
+		 * Include a source file
+		 * 
+		 * @param string $pathname Relative path from project root to a source file
+		 */
+		public static function include(string $pathname): void {
+			if (!class_exists("VV")) {
+				self::load_vegvisir_kernel();
+			}
+
+			require_once VV::root($pathname);
+		}
+
+		/**
+		 * Load the Vegvisir VV class from Reflect
+		 */
+		private static function load_vegvisir_kernel(): void {
+			require_once Path::root("vegvisir/src/kernel/Init.php");
+			require_once Path::root("vegvisir/src/request/VV.php");
+		}
+	}
\ No newline at end of file