This directory contains automated tests, manual diagnostic programs, and standalone experiments. It is separate from src so test-only dependencies and exploratory code are not included in production assemblies.

Directory map

Directory	Purpose
`StgSharpDebug`	Executable test harness for manual debugging and stress testing of allocators, matrices, rendering, NGRA, and other subsystems. This is not an automated unit-test suite.
`STgSharpTest`	Older MSTest-based tests for the former Script/EXPRESS and related projects. Some references and machine-specific test data are legacy and may require repair before the project can run.
`SingleFile`	Standalone source experiments and generated-code samples that are not part of a project or the normal build.

Run the active debug harness directly when investigating a subsystem:

dotnet run --project test/StgSharpDebug/StgSharpDebug.csproj

NGRA generation preview

StgSharpDebug/TestRegexGenerate.cs contains a standalone debugging routine that calls the existing NGRA emitter without Roslyn attribute binding. Select it from the debug Main:

dotnet run --project test/StgSharpDebug/StgSharpDebug.csproj -- --regex-preview

This branch returns before World or native-memory initialization. Without the switch, the existing debug flow is unchanged. You can also call TestRegexGenerate.Run() directly from Main while debugging; pass a pattern to Run("abc") for a single preview. The switch only selects runtime behavior; building the debug project still builds its normal project references, including Graphics and Mathematics, and prepares the native library with CMake. BuildNativeBeforeManaged defaults to true; Debug selects clang-debug, and other configurations select clang-release. RequireNativeLibrary reports a missing DLL at build time instead of allowing the default runtime path to fail later.

For managed-only preview work without a native toolchain or DLL, add -p:BuildNativeBeforeManaged=false -p:RequireNativeLibrary=false before -- in the run command.

Enter raw regular expressions without C# string delimiters. The routine prints only the emitted code, without status headers or file output. Exceptions propagate directly to the caller/debugger. Use :exit or end-of-input to leave the loop. Empty input is an empty regex. For one-shot mode:

dotnet run --project test/StgSharpDebug/StgSharpDebug.csproj -- --regex-preview 'a{2,3}'

Set breakpoints in TestRegexGenerate.cs or any existing Generate* method. The output is a method-body fragment; this routine does not compile or execute it.

New repeatable tests should use a test project and avoid machine-specific paths, external mutable data, and dependencies on previous test execution. Keep one-off investigations in SingleFile or the manual debug harness until their expected behavior is stable enough for automation.