perf(render): expand benchmark coverage and stabilize render test infrastructure

- add broader DataTree and RootSite render scenarios, baselines, and timing catalogs
- tighten the render harness and verification infrastructure for benchmark and baseline runs
- fix font/color cache behavior, refresh policies, and warm scrolling/layout follow-up cases
- update native render tracing and Views support code to match the new benchmark coverage
- add the agent render runner and related docs/project wiring needed for repeatable runs

Author: johnml1135

.gitignore

@@ -197,3 +197,5 @@ FLExInstaller/wix6/cabcache/*
 
 # Verify snapshot testing - received files are transient
 *.received.png
+*.diff.png
+DataTreeTimingBaselines.json

Build/Agent/README.md

@@ -11,6 +11,7 @@ PowerShell scripts for build, test, and CI orchestration.
 
 | Script | Purpose |
 |--------|---------|
+| `Run-AllRenders.ps1` | Runs the DetailControls and RootSite render suites sequentially from one command without adding a meta test project. |
 | `Summarize-NativeTestResults.ps1` | Parses native Unit++ logs and appends a pass/fail summary table to GitHub step summary. |
 
 ## GitHub Actions usage

Build/Agent/Run-AllRenders.ps1

@@ -0,0 +1,131 @@
+<#
+.SYNOPSIS
+    Runs the render-focused test suites for FieldWorks.
+
+.DESCRIPTION
+    Executes the DetailControls render tests and the RootSite render tests sequentially.
+    This script is intentionally outside the product project graph so developers can use a
+    single entrypoint without introducing a meta test project into the repository architecture.
+
+.PARAMETER Scope
+    Which render suites to run. Default is All.
+
+.PARAMETER Configuration
+    The build configuration to test. Default is Debug.
+
+.PARAMETER NoBuild
+    Skip building before running tests.
+
+.PARAMETER Verbosity
+    Test output verbosity: quiet, minimal, normal, detailed.
+
+.PARAMETER SkipDependencyCheck
+    Skip dependency preflight checks inside test.ps1.
+#>
+[CmdletBinding()]
+param(
+    [ValidateSet('All', 'DetailControls', 'RootSite')]
+    [string]$Scope = 'All',
+    [string]$Configuration = 'Debug',
+    [switch]$NoBuild,
+    [ValidateSet('quiet', 'minimal', 'normal', 'detailed', 'q', 'm', 'n', 'd')]
+    [string]$Verbosity = 'normal',
+    [switch]$SkipDependencyCheck
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$repoRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..\..'))
+$buildScript = Join-Path $repoRoot 'build.ps1'
+$testScript = Join-Path $repoRoot 'test.ps1'
+
+if (-not (Test-Path $buildScript)) {
+    throw "build.ps1 not found at $buildScript"
+}
+
+if (-not (Test-Path $testScript)) {
+    throw "test.ps1 not found at $testScript"
+}
+
+$requestedScopes = switch ($Scope) {
+    'All' { @('DetailControls', 'RootSite') }
+    default { @($Scope) }
+}
+
+function Invoke-RenderSuite {
+    param(
+        [Parameter(Mandatory = $true)]
+        [string]$Name,
+        [Parameter(Mandatory = $true)]
+        [string]$BuildProject,
+        [Parameter(Mandatory = $true)]
+        [string]$TestProject,
+        [Parameter(Mandatory = $true)]
+        [string[]]$TestFilters
+    )
+
+    if (-not $NoBuild) {
+        Write-Output "Building $Name render tests..."
+
+        $buildArgs = @{
+            Configuration = $Configuration
+            Project = $BuildProject
+            Verbosity = $Verbosity
+        }
+
+        if ($SkipDependencyCheck) {
+            $buildArgs['SkipDependencyCheck'] = $true
+        }
+
+        & $buildScript @buildArgs
+        if ($LASTEXITCODE -ne 0) {
+            throw "$Name render build failed with exit code $LASTEXITCODE."
+        }
+    }
+
+    foreach ($testFilter in $TestFilters) {
+        Write-Output "Running $Name render tests with filter '$testFilter'..."
+
+        $testArgs = @{
+            Configuration = $Configuration
+            TestProject = $TestProject
+            TestFilter = $testFilter
+            Verbosity = $Verbosity
+            NoBuild = $true
+            SkipDependencyCheck = $true
+        }
+
+        & $testScript @testArgs
+        if ($LASTEXITCODE -ne 0) {
+            throw "$Name render tests failed with exit code $LASTEXITCODE for filter '$testFilter'."
+        }
+    }
+
+    Write-Output "[OK] $Name render tests passed."
+}
+
+foreach ($requestedScope in $requestedScopes) {
+    switch ($requestedScope) {
+        'DetailControls' {
+            Invoke-RenderSuite `
+                -Name 'DetailControls' `
+                -BuildProject 'Src/Common/Controls/DetailControls/DetailControlsTests/DetailControlsTests.csproj' `
+                -TestProject 'Src/Common/Controls/DetailControls/DetailControlsTests' `
+                -TestFilters 'FullyQualifiedName~DataTreeRenderTests'
+        }
+        'RootSite' {
+            Invoke-RenderSuite `
+                -Name 'RootSite' `
+                -BuildProject 'Src/Common/RootSite/RootSiteTests/RootSiteTests.csproj' `
+                -TestProject 'Src/Common/RootSite/RootSiteTests' `
+                -TestFilters @(
+                    'FullyQualifiedName~RenderBaselineTests',
+                    'FullyQualifiedName~RenderTimingSuiteTests',
+                    'FullyQualifiedName~RenderVerifyTests'
+                )
+        }
+    }
+}
+
+Write-Output 'All requested render suites passed.'

Build/Agent/Verify-FwDependencies.ps1

@@ -49,25 +49,27 @@ function Test-Dependency {
         [string]$Required = "Required"
     )
 
+    $isRequired = ($Required -eq "Required")
+
     try {
         $result = & $Check
         if ($result) {
             Write-Host "[OK]   $Name" -ForegroundColor Green
             if ($result -is [string] -and $result.Length -gt 0 -and $result.Length -lt 100) {
                 Write-Host "       $result" -ForegroundColor DarkGray
             }
-            return @{ Name = $Name; Found = $true; Info = $result }
+            return @{ Name = $Name; Found = $true; Required = $isRequired; Info = $result }
         }
         else {
             throw "Check returned null/false"
         }
     }
     catch {
-        $color = if ($Required -eq "Required") { "Red" } else { "Yellow" }
-        $status = if ($Required -eq "Required") { "[FAIL]" } else { "[WARN]" }
+        $color = if ($isRequired) { "Red" } else { "Yellow" }
+        $status = if ($isRequired) { "[FAIL]" } else { "[WARN]" }
         Write-Host "$status $Name" -ForegroundColor $color
         Write-Host "       $_" -ForegroundColor DarkGray
-        return @{ Name = $Name; Found = $false; Required = ($Required -eq "Required"); Error = $_.ToString() }
+        return @{ Name = $Name; Found = $false; Required = $isRequired; Error = $_.ToString() }
     }
 }
 
@@ -268,9 +270,9 @@ if ($IncludeOptional) {
 Write-Host ""
 Write-Host "=== Summary ===" -ForegroundColor Cyan
 
-$required = $results | Where-Object { $_.Required -ne $false }
-$missing = $required | Where-Object { -not $_.Found }
-$optional = $results | Where-Object { $_.Required -eq $false }
+$required = @($results | Where-Object { $_.Required -ne $false })
+$missing = @($required | Where-Object { -not $_.Found })
+$optional = @($results | Where-Object { $_.Required -eq $false })
 
 $totalRequired = ($required | Measure-Object).Count
 $foundRequired = ($required | Where-Object { $_.Found } | Measure-Object).Count

Directory.Packages.props

@@ -153,6 +153,7 @@
 		<PackageVersion Include="NUnit3TestAdapter" Version="4.6.0" />
 		<PackageVersion Include="NUnitForms" Version="1.3.1" />
 		<PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
+		<!-- Can be changed to NUnit.Verify when NUnit is updated to v4 -->
 		<PackageVersion Include="Verify" Version="31.11.0" />
 	</ItemGroup>
 </Project>