Organize tests into src/tests/ and update README packaging guide

- Moved DevDecoder.GpioSimulator.Tests and DevDecoder.GpioSimulator.OfficialTests into src/tests/
- Updated GpioSimulator.slnx and relative project references to match the new structure
- Clarified in README that users should install either DevDecoder.GpioSimulator or DevDecoder.GpioSimulator.Drivers, and that Common is transitively included

Author: thargy

GpioSimulator.slnx

@@ -3,9 +3,11 @@
     <Project Path="src/DevDecoder.GpioSimulator.Common/DevDecoder.GpioSimulator.Common.csproj" />
     <Project Path="src/DevDecoder.GpioSimulator.Drivers/DevDecoder.GpioSimulator.Drivers.csproj" />
     <Project Path="src/DevDecoder.GpioSimulator.Sample/DevDecoder.GpioSimulator.Sample.csproj" />
-    <Project Path="src/DevDecoder.GpioSimulator.Tests/DevDecoder.GpioSimulator.Tests.csproj" />
     <Project Path="src/DevDecoder.GpioSimulator.Web/DevDecoder.GpioSimulator.Web.csproj" />
     <Project Path="src/System.Device.Gpio/System.Device.Gpio.csproj" />
-    <Project Path="src/DevDecoder.GpioSimulator.OfficialTests/DevDecoder.GpioSimulator.OfficialTests.csproj" />
+  </Folder>
+  <Folder Name="/tests/">
+    <Project Path="src/tests/DevDecoder.GpioSimulator.Tests/DevDecoder.GpioSimulator.Tests.csproj" />
+    <Project Path="src/tests/DevDecoder.GpioSimulator.OfficialTests/DevDecoder.GpioSimulator.OfficialTests.csproj" />
   </Folder>
 </Solution>

README.md

@@ -20,7 +20,10 @@ An extensible, drop-in C# NuGet replacement library for `System.Device.Gpio` tha
 
 ## 📦 The Packages & Target Scenarios
 
-The simulator is modularly split into **three NuGet packages** depending on your usage scenario:
+The simulator is modularly split into **three NuGet packages** depending on your usage scenario.
+
+> [!IMPORTANT]
+> In most target scenarios, you should **only install either** `DevDecoder.GpioSimulator` (Scenario A) **OR** `DevDecoder.GpioSimulator.Drivers` (Scenario B). You **do not** need to explicitly install `DevDecoder.GpioSimulator.Common` as it is automatically pulled in as a dependency by the other packages.
 
 ### 1. `DevDecoder.GpioSimulator` (Drop-in Web & Visual Shim)
 * **What it is:** The complete drop-in replacement library that replaces the standard `System.Device.Gpio` namespace.
@@ -42,7 +45,7 @@ The simulator is modularly split into **three NuGet packages** depending on your
 
 ### 3. `DevDecoder.GpioSimulator.Common` (Shared State Simulation Engine)
 * **What it is:** The pure class library containing the thread-safe state containers, logical-to-physical conversions, and owner tracking.
-* **When to use:** Used under the hood by both of the packages above. You can also use it to implement your own custom GPIO driver/mock entirely decoupled from presentation or transportation details.
+* **When to use:** Used under the hood by both of the packages above. You **do not need to install this package directly**, as it is transitively included by both the shim and drivers packages. You only need to explicitly install this if you are building your own completely independent custom GPIO drivers or presentation layers decoupled from our visual simulator.
 * **Installation:**
   ```bash
   dotnet add package DevDecoder.GpioSimulator.Common --version 0.5.0-beta

…coder.GpioSimulator.OfficialTests.csproj …coder.GpioSimulator.OfficialTests.csprojsrc/DevDecoder.GpioSimulator.OfficialTests/DevDecoder.GpioSimulator.OfficialTests.csproj renamed to src/tests/DevDecoder.GpioSimulator.OfficialTests/DevDecoder.GpioSimulator.OfficialTests.csproj src/DevDecoder.GpioSimulator.OfficialTests/DevDecoder.GpioSimulator.OfficialTests.csproj renamed to src/tests/DevDecoder.GpioSimulator.OfficialTests/DevDecoder.GpioSimulator.OfficialTests.csproj

@@ -25,7 +25,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\DevDecoder.GpioSimulator.Drivers\DevDecoder.GpioSimulator.Drivers.csproj" />
+    <ProjectReference Include="..\..\DevDecoder.GpioSimulator.Drivers\DevDecoder.GpioSimulator.Drivers.csproj" />
   </ItemGroup>
 
   <ItemGroup>

…ts/DevDecoder.GpioSimulator.Tests.csproj …ts/DevDecoder.GpioSimulator.Tests.csprojsrc/DevDecoder.GpioSimulator.Tests/DevDecoder.GpioSimulator.Tests.csproj renamed to src/tests/DevDecoder.GpioSimulator.Tests/DevDecoder.GpioSimulator.Tests.csproj src/DevDecoder.GpioSimulator.Tests/DevDecoder.GpioSimulator.Tests.csproj renamed to src/tests/DevDecoder.GpioSimulator.Tests/DevDecoder.GpioSimulator.Tests.csproj

@@ -20,7 +20,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <ProjectReference Include="..\System.Device.Gpio\System.Device.Gpio.csproj" />
+    <ProjectReference Include="..\..\System.Device.Gpio\System.Device.Gpio.csproj" />
+    <ProjectReference Include="..\..\DevDecoder.GpioSimulator.Common\DevDecoder.GpioSimulator.Common.csproj" />
   </ItemGroup>
 
   <ItemGroup>