Release v2.4.2

.claude/agents/cleanup-agent.md

@@ -70,7 +70,7 @@ Successfully cleaned files meet:
 - Applies "Full Cleanup" profile from `Terminal.sln.DotSettings`
 - Uses `--include` parameter to target specific files
 - Respects all project code style settings
-- Command: `jb cleanupcode Terminal.sln --profile="Full Cleanup" --include="path/to/file.cs" --no-build`
+- Command: `jb cleanupcode Terminal.slnx --profile="Full Cleanup" --include="path/to/file.cs" --no-build`
 
 ### 3. Backing Field Reordering
 - Places backing fields immediately before their properties
@@ -118,7 +118,7 @@ The `--include` parameter **WORKS CORRECTLY** for single-file cleanup:
 
 ```powershell
 # Cleanup a single file
-jb cleanupcode Terminal.sln `
+jb cleanupcode Terminal.slnx `
     --profile="Full Cleanup" `
     --include="Terminal.Gui/Views/TableView/TableView.cs" `
     --no-build `
@@ -139,7 +139,7 @@ jb cleanupcode Terminal.sln `
 
 ```powershell
 # Inspect a single file for warnings
-jb inspectcode Terminal.sln `
+jb inspectcode Terminal.slnx `
     --output="inspect-report.xml" `
     --include="Terminal.Gui/Views/TableView/TableView.cs" `
     --severity=WARNING `

.claude/rules/event-patterns.md

@@ -69,13 +69,13 @@ void OnTextChanged (object sender, EventArgs e) { }
 
 ## Local Function Naming
 
-**Use camelCase for local functions:**
+**Use PascalCase for local functions** (the `.editorconfig` `local_functions_rule` enforces `upper_camel_case_style` at `warning` severity):
 
 ```csharp
 // CORRECT
-void textViewDrawContent (object? sender, DrawEventArgs e) { }
+void TextViewDrawContent (object? sender, DrawEventArgs e) { }
 
 // WRONG
 void TextView_DrawContent (object? sender, DrawEventArgs e) { }
-void TextViewDrawContent (object? sender, DrawEventArgs e) { }
+void textViewDrawContent (object? sender, DrawEventArgs e) { }
 ```

.claude/rules/testing-patterns.md

@@ -27,7 +27,7 @@
 3. **Follow existing test patterns**
    - Study tests in respective test projects before writing new ones
 
-4. **Avoid adding new tests to `UnitTests` Project**
+4. **Never add new tests to `UnitTests.Legacy`**
    - Make them parallelizable and add them to `UnitTestsParallelizable`
 
 5. **Avoid static dependencies**
@@ -38,7 +38,7 @@
 
 ## Test Projects
 
-### 1. Non-Parallel Tests (`Tests/UnitTests/`)
+### 1. Non-Parallel Tests (`Tests/UnitTests.NonParallelizable/`)
 
 **When to use:**
 - Testing functionality that depends on static state
@@ -48,11 +48,10 @@
 - ~10 min timeout
 - Uses `Application.Init` and static state
 - Cannot run in parallel
-- Includes `--diagnostic` flag for logging
 
 **Command:**
 ```bash
-dotnet test --project Tests/UnitTests --no-build --verbosity normal
+dotnet test --project Tests/UnitTests.NonParallelizable --no-build --verbosity normal
 ```
 
 ### 2. Parallel Tests (`Tests/UnitTestsParallelizable/`) - **PREFERRED**
@@ -84,8 +83,9 @@ dotnet test --project Tests/IntegrationTests --no-build --verbosity normal
 
 ## Test Configuration Files
 
-- `xunit.runner.json` - xUnit configuration
-- `coverlet.runsettings` - Coverage settings (currently unused, pending MTP integration)
+- `xunit.runner.json` - Per-project xUnit configuration (parallelization, etc.)
+- `Tests/TestEnvironmentSetup.cs` - Compiled into every test project; its `[ModuleInitializer]` sets `DisableRealDriverIO=1` before any test code runs
+- Coverage tooling: each test project references the `coverlet.collector` package, but coverage is not actively collected in CI yet (see "Code Coverage" above — pending an MTP-compatible solution). `.runsettings` files are ignored by Microsoft Testing Platform (MTP).
 
 ## Example Test Pattern
 

.claude/tasks/build-app.md

@@ -142,10 +142,9 @@ See `.claude/cookbook/common-patterns.md` for recipes including:
 
 | Example | Location | Description |
 |---------|----------|-------------|
-| Hello World | `Examples/Example/` | Minimal login form |
 | All Controls | `Examples/UICatalog/` | Comprehensive demo app |
-| MVVM | `Examples/CommunityToolkitExample/` | CommunityToolkit MVVM |
-| Reactive | `Examples/ReactiveExample/` | ReactiveUI integration |
+| Scenario automation | `Examples/ScenarioRunner/` | Run UICatalog scenarios from the CLI |
+| Additional samples | `gui-cs/Examples` | Standalone example applications |
 
 ## Event Handling Patterns
 

.claude/workflows/build-test-workflow.md

@@ -80,13 +80,13 @@ dotnet test --project Tests/UnitTests --no-build --verbosity normal && dotnet te
 
 ## Common Build Issues
 
-### Issue: NativeAot/SelfContained Build Failures
+### Issue: AOT validation failures
 
-**Solution:** Restore these projects explicitly:
+**Solution:** Build and publish the in-repo AOT smoke app:
 
 ```bash
-dotnet restore ./Examples/NativeAot/NativeAot.csproj -f
-dotnet restore ./Examples/SelfContained/SelfContained.csproj -f
+dotnet publish ./Tests/NativeAotSmoke/NativeAotSmoke.csproj --configuration Release --output ./aot-publish
+./aot-publish/NativeAotSmoke --smoke-test
 ```
 
 ## Build Order Best Practice

.cursorrules

@@ -122,4 +122,4 @@ Input flows: Driver → `IInputProcessor` → `KeyBindings`/`MouseBindings` →
 | Common UI patterns | `.claude/cookbook/common-patterns.md` |
 | App building guide | `.claude/tasks/build-app.md` |
 | Deep-dive docs | `docfx/docs/` |
-| Working examples | `Examples/Example/`, `Examples/UICatalog/` |
+| Working examples | `Examples/UICatalog/`, `Examples/ScenarioRunner/`, `gui-cs/Examples` |

.github/workflows/README.md

@@ -16,8 +16,7 @@ The repository uses multiple GitHub Actions workflows. What runs and when:
 - Build Debug: `dotnet build --configuration Debug --no-restore -property:NoWarn=0618%3B0612`
 - Build Release (library): `dotnet build Terminal.Gui/Terminal.Gui.csproj --configuration Release --no-incremental --force -property:NoWarn=0618%3B0612`
 - Pack Release: `dotnet pack Terminal.Gui/Terminal.Gui.csproj --configuration Release --output ./local_packages -property:NoWarn=0618%3B0612`
-- Restore NativeAot/SelfContained examples, then restore solution again
-- Build Release for `Examples/NativeAot` and `Examples/SelfContained`
+- Publish `Tests/NativeAotSmoke` with AOT and run `--smoke-test`
 - Build Release solution
 
 ### 2) Build & Run Unit Tests (`.github/workflows/unit-tests.yml`)

.github/workflows/api-docs.yml

@@ -3,17 +3,21 @@ name: Build and publish v2 API docs
 on:
   push:
     branches: [develop]
+  workflow_dispatch:
+    inputs:
+      regenerate-views:
+        description: Regenerate views.md and view GIF assets
+        type: boolean
+        default: true
 
 permissions:
+  contents: write
   id-token: write 
   pages: write
 
 jobs:
-  deploy:
-    name: Build and Deploy v2 API docs to github-pages ${{ github.ref_name }}
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+  build:
+    name: Build v2 API docs ${{ github.ref_name }}
     runs-on: windows-latest
     steps:
     - name: Checkout
@@ -27,6 +31,31 @@ jobs:
         dotnet-version: 10.x
         dotnet-quality: 'ga'
 
+    - name: Detect view docs changes
+      id: view-docs
+      shell: pwsh
+      run: |
+        $shouldGenerate = $false
+
+        if ("${{ github.event_name }}" -eq "workflow_dispatch") {
+          $shouldGenerate = "${{ inputs.regenerate-views }}" -eq "true"
+        } else {
+          $before = "${{ github.event.before }}"
+
+          if ($before -match "^0+$") {
+            $before = "HEAD~1"
+          }
+
+          $changedFiles = git diff --name-only $before "${{ github.sha }}"
+          $shouldGenerate = [bool]($changedFiles | Where-Object {
+            $_ -match "^Terminal\.Gui/Views/" -or
+            $_ -match "^docfx/scripts/OutputView/" -or
+            $_ -match "^docfx/scripts/generate-views-doc\.ps1$"
+          } | Select-Object -First 1)
+        }
+
+        "should_generate=$($shouldGenerate.ToString().ToLowerInvariant())" >> $env:GITHUB_OUTPUT
+
     - name: Restore dependencies
       run: dotnet restore
 
@@ -36,23 +65,76 @@ jobs:
     - name: Build EditorRef (for Terminal.Gui.Editor docs)
       run: dotnet build docfx/EditorRef/EditorRef.csproj --configuration Release
 
-    - name: DocFX Build
-      working-directory: docfx
+    - name: Install DocFX
       run: |
         dotnet tool install -g docfx
+
+    - name: Setup Go
+      if: steps.view-docs.outputs.should_generate == 'true'
+      uses: actions/setup-go@v6
+      with:
+        go-version: stable
+
+    - name: Install views docs tools
+      if: steps.view-docs.outputs.should_generate == 'true'
+      run: |
+        go install github.com/gui-cs/tuirec/cmd/tuirec@latest
+        Add-Content $env:GITHUB_PATH "$(go env GOPATH)\bin"
+        Install-Module powershell-yaml -Scope CurrentUser -Force
+
+    - name: Generate API metadata
+      working-directory: docfx
+      run: |
         $env:DOCFX_SOURCE_BRANCH_NAME="${{ github.ref_name }}"
         docfx metadata
+
+    - name: Generate views docs
+      if: steps.view-docs.outputs.should_generate == 'true'
+      working-directory: docfx
+      run: |
+        ./scripts/generate-views-doc.ps1
+
+    - name: DocFX Build
+      working-directory: docfx
+      run: |
         docfx build
       continue-on-error: false
 
+    - name: Commit regenerated views assets
+      if: github.event_name == 'workflow_dispatch' && steps.view-docs.outputs.should_generate == 'true'
+      shell: pwsh
+      run: |
+        git config user.name "github-actions[bot]"
+        git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+        git add docfx/docs/views.md docfx/images/views
+
+        if (git diff --cached --quiet) {
+          Write-Host "No regenerated view assets to commit."
+          exit 0
+        }
+
+        git commit -m "Regenerate docfx view GIF assets via CI"
+        git push
+
     - name: Setup Pages
+      if: github.event_name == 'push' && github.ref_name == 'develop'
       uses: actions/configure-pages@v6
-
+       
     - name: Upload artifact
+      if: github.event_name == 'push' && github.ref_name == 'develop'
       uses: actions/upload-pages-artifact@v5
       with:
         path: docfx/_site
-
+
+  deploy:
+    name: Deploy v2 API docs to github-pages ${{ github.ref_name }}
+    if: github.event_name == 'push' && github.ref_name == 'develop'
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: windows-latest
+    steps:
     - name: Deploy to GitHub Pages
       id: deployment
       uses: actions/deploy-pages@v5

.github/workflows/build-validation.yml

@@ -50,36 +50,23 @@ jobs:
     - name: Pack Release Terminal.Gui
       run: dotnet pack Terminal.Gui/Terminal.Gui.csproj --configuration Release --output ./local_packages -property:NoWarn=0618%3B0612
 
-    - name: Restore AOT and Self-Contained projects
-      run: |
-        dotnet restore ./Examples/NativeAot/NativeAot.csproj -f
-        dotnet restore ./Examples/SelfContained/SelfContained.csproj -f
-
-    - name: Restore Solution Packages
-      run: dotnet restore
-
-    - name: Build Release AOT and Self-Contained
-      run: |
-        dotnet build ./Examples/NativeAot/NativeAot.csproj --configuration Release -property:NoWarn=0618%3B0612
-        dotnet build ./Examples/SelfContained/SelfContained.csproj --configuration Release -property:NoWarn=0618%3B0612
-
-    - name: AOT Publish (catches trimming and reflection errors)
-      run: dotnet publish ./Examples/NativeAot/NativeAot.csproj --configuration Release --output ./aot-publish -property:NoWarn=0618%3B0612
+    - name: AOT Publish Test App (catches trimming and reflection errors)
+      run: dotnet publish ./Tests/NativeAotSmoke/NativeAotSmoke.csproj --configuration Release --output ./aot-publish -property:NoWarn=0618%3B0612
 
     - name: AOT Smoke Test (run the published AOT binary on Linux)
       if: runner.os == 'Linux'
       env:
         DisableRealDriverIO: "1"
       run: |
-        chmod +x ./aot-publish/NativeAot
-        ./aot-publish/NativeAot --smoke-test
+        chmod +x ./aot-publish/NativeAotSmoke
+        ./aot-publish/NativeAotSmoke --smoke-test
 
     - name: AOT Smoke Test (run the published AOT binary on Windows)
       if: runner.os == 'Windows'
       env:
         DisableRealDriverIO: "1"
       shell: pwsh
-      run: ./aot-publish/NativeAot.exe --smoke-test
+      run: ./aot-publish/NativeAotSmoke.exe --smoke-test
 
     - name: Build Release Solution
       run: dotnet build --configuration Release --no-restore -property:NoWarn=0618%3B0612

.gitignore

@@ -82,3 +82,9 @@ log.*
 .mcp.json
 .env
 tmpclaude-*-cwd
+
+# tuirec artifacts
+artifacts/
+docfx/artifacts/
+local_packages/
+*.cast

.windsurfrules

@@ -122,4 +122,4 @@ Input flows: Driver → `IInputProcessor` → `KeyBindings`/`MouseBindings` →
 | Common UI patterns | `.claude/cookbook/common-patterns.md` |
 | App building guide | `.claude/tasks/build-app.md` |
 | Deep-dive docs | `docfx/docs/` |
-| Working examples | `Examples/Example/`, `Examples/UICatalog/` |
+| Working examples | `Examples/UICatalog/`, `Examples/ScenarioRunner/`, `gui-cs/Examples` |

AGENTS.md

@@ -62,7 +62,7 @@ dotnet run
 ### Key Resources
 - **App Building Guide**: [.claude/tasks/build-app.md](.claude/tasks/build-app.md)
 - **Common Patterns**: [.claude/cookbook/common-patterns.md](.claude/cookbook/common-patterns.md)
-- **Examples**: `Examples/Example/` (minimal), `Examples/UICatalog/` (comprehensive)
+- **Examples**: `Examples/UICatalog/`, `Examples/ScenarioRunner/`, and [gui-cs/Examples](https://github.com/gui-cs/Examples)
 
 ### API Reference (Compressed)
 | Namespace | Contents |
@@ -547,6 +547,5 @@ Implementing `IValue<T>` requires `ValueChanging`, `ValueChanged`, and `ValueCha
 
 
 
-
 
 

CLAUDE.md

@@ -55,6 +55,7 @@ See `.claude/rules/` for detailed guidance:
 - `event-patterns.md` - Lambdas, closures, handlers
 - `early-return.md` - **Guard clauses, minimal nesting** (commonly violated!)
 - `collection-expressions.md` - Use `[...]` syntax
+- `unicode-graphemes.md` - **Think in graphemes** - `GetColumns()`, `GraphemeHelper.GetGraphemes()`
 - `cwp-pattern.md` - Cancellable Workflow Pattern
 - `code-layout.md` - Backing fields, member ordering
 - `api-documentation.md` - XML documentation requirements
@@ -63,7 +64,6 @@ See `.claude/rules/` for detailed guidance:
 ## Task-Specific Guides
 
 See `.claude/tasks/` for task checklists:
-- `scenario-modernization.md` - Upgrading UICatalog scenarios
 - `clean-code-review.md` - Creating clean git commit histories
 - `build-app.md` - Building applications with Terminal.Gui
 
@@ -100,8 +100,11 @@ dotnet test --project Tests/UnitTests.NonParallelizable --no-build
 # Legacy tests — do NOT add new tests here; candidates for rewrite/deletion
 dotnet test --project Tests/UnitTests.Legacy --no-build
 
-# Run a single test by fully-qualified name
-dotnet test --project Tests/UnitTestsParallelizable --no-build --filter "FullyQualifiedName~MyTestClass.MyTestMethod"
+# Run a single test by method name (Microsoft Testing Platform)
+dotnet test --project Tests/UnitTestsParallelizable --no-build --filter-method "*MyTestMethod"
+
+# Run all tests in a class
+dotnet test --project Tests/UnitTestsParallelizable --no-build --filter-class "*MyTestClass"
 ```
 
 See `Tests/README.md` for the full list of test projects (including `IntegrationTests`, `StressTests`, `Benchmarks`) and the static-state classification that determines where a new test belongs.