process cases of ALT as special rules

2026-09-10 18:17:09 +08:00
parent 8755185e78
commit f372f83171
18 changed files with 486 additions and 166 deletions
@@ -16,4 +16,36 @@ 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`:
+
+```powershell
+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:
+
+```powershell
+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.