Merge pull request #81 from bboczula/codex/issue-40-private-runtime-context

[codex] Create private runtime context implementation

Author: bboczula

README.md

@@ -179,7 +179,7 @@ Asset loading entry points will build on these handle and descriptor types as th
 
 Build the project with Premake-generated Visual Studio projects. The package output contains Debug and Release binaries plus the public SDK headers under `bin/<Config>/inc/AssetSuite`.
 
-The installed public header surface is validated by `PublicHeaderCompile`, which compiles an external-consumer translation unit and checks that installed headers do not expose platform-specific, legacy, or STL-owning API types.
+The installed public header surface is validated by `PublicHeaderCompile`, which compiles an external-consumer translation unit and checks that installed headers do not expose platform-specific, legacy, STL-owning, or private runtime implementation types. The validation flow also verifies that installed headers remain under `AssetSuite/*.h`.
 
 ## Installation
 

premake5.lua

@@ -9,6 +9,7 @@ COPY_RELEASE_LIB_FILE = "{COPY} %{cfg.targetdir}/assetsuite_r.lib %{cfg.targetdi
 COPY_DEBUG_LIB_FILE = "{COPY} %{cfg.targetdir}/assetsuite_d.lib %{cfg.targetdir}/../lib"
 COPY_PUBLIC_HEADER_FILES = "{COPY} %{cfg.targetdir}/../../../include/AssetSuite/*.h %{cfg.targetdir}/../inc/AssetSuite"
 RUN_PUBLIC_HEADER_HYGIENE_CHECK = "powershell -NoProfile -ExecutionPolicy Bypass -File %{cfg.targetdir}/../../../validation/public_header_hygiene/PublicHeaderHygiene.ps1 -Roots include/AssetSuite,bin/%{cfg.buildcfg}/inc"
+RUN_PUBLIC_INSTALL_SURFACE_CHECK = "powershell -NoProfile -ExecutionPolicy Bypass -File %{cfg.targetdir}/../../../validation/public_header_hygiene/AssertPublicInstallSurface.ps1 -InstalledIncludeRoot bin/%{cfg.buildcfg}/inc"
 LOCATION_DIRECTORY_NAME = "build"
 
 -- Global Functions
@@ -69,7 +70,8 @@ project "AssetSuite"
 	}
     files {
 		"include/AssetSuite/**.h",
-		"source/common/**.h", "source/common/**.cpp"
+		"source/common/**.h", "source/common/**.cpp",
+		"source/runtime/**.h", "source/runtime/**.cpp"
 	}
 	SetDebugFilters()
 	SetReleaseFilters()
@@ -165,8 +167,13 @@ project "UnitTest"
 	language "C++"
 	cppdialect "C++17"
 	targetdir "bin/%{cfg.buildcfg}/tests"
-	files { "unit_tests/**.h", "unit_tests/**.cpp" }
-	links { "AssetSuite", "zlib", "bmp", "png", "ppm", "wavefront", "bitstream" }
+	defines { "ASSETSUITE_UNIT_TEST_PRIVATE_RUNTIME" }
+	files {
+		"unit_tests/**.h", "unit_tests/**.cpp",
+		"source/common/AssetSuiteContext.cpp",
+		"source/runtime/**.cpp"
+	}
+	links { "AssetSuite", "zlib", "bmp", "png", "ppm", "bypass", "wavefront", "bitstream" }
 	includedirs { "include" }
 	SetDebugFilters()
 	SetReleaseFilters()
@@ -186,7 +193,10 @@ project "PublicHeaderCompile"
 	links { "AssetSuite" }
 	includedirs { "bin/%{cfg.buildcfg}/inc" }
 	dependson { "AssetSuite" }
-	prebuildcommands { RUN_PUBLIC_HEADER_HYGIENE_CHECK }
+	prebuildcommands {
+		RUN_PUBLIC_INSTALL_SURFACE_CHECK,
+		RUN_PUBLIC_HEADER_HYGIENE_CHECK
+	}
 	SetDebugFilters()
 	SetReleaseFilters()
 	filter "configurations:Debug"