perf: speed up Views rendering and add render verification

Avoid redundant Views reconstruct/layout work, cache native render resources, and reduce repeated text normalization in hot paths.

Add render snapshot verification, timing scenarios, trace parsing, baseline assets, and helper entry points so render behavior and performance can be checked repeatably.

Author: johnml1135

.gitattributes

@@ -34,3 +34,7 @@ Src/LexText/ParserCore/ParserCoreTests/**/*.txt -whitespace
 Src/Utilities/pcpatrflex/DisambiguateInFLExDB/DisambiguateInFLExDBTests/TestData/*.* -whitespace
 Src/Utilities/pcpatrflex/PcPatrBrowserDll/Transforms/*.* -whitespace
 Src/Utilities/HCSynthByGloss/HCSynthByGloss/TestData/*.txt -whitespace
+
+# Verify snapshot testing
+*.verified.png binary
+*.received.png binary

.gitignore

@@ -100,6 +100,8 @@ _UpgradeReport_Files/
 /Release/
 Output/
 Output
+Output/RenderBenchmarks/
+Output/RenderBenchmarks/**
 Output_i686/
 Output_x86_64/
 __pycache__/
@@ -186,6 +188,7 @@ CrashLog.txt
 # VSTest Artifacts
 TestResults/
 *.trx
+TestResult.xml
 
 # WPF markup compilation temp projects
 *_wpftmp.csproj
@@ -201,3 +204,8 @@ FLExInstaller/wix6/cabcache/*
 
 # Claude Code worktrees
 .claude/worktrees/*
+
+# Verify snapshot testing - received files are transient
+*.received.png
+*.diff.png
+DataTreeTimingBaselines.json

.vscode/tasks.json

@@ -85,15 +85,29 @@
     }
   ],
   "tasks": [
+    {
+      "label": "Test: RenderBaselineTests",
+      "type": "shell",
+      "command": ".\\test.ps1 -TestProject \"RootSiteTests\" -TestFilter \"FullyQualifiedName~RenderBaselineTests\"",
+      "options": {
+        "shell": {
+          "executable": "powershell.exe",
+          "args": ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command"]
+        }
+      },
+      "problemMatcher": [],
+      "group": "test",
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared"
+      }
+    },
     // ==================== Setup Tasks ====================
     {
       "label": "Setup: Colorize Worktree",
       "type": "shell",
       "command": "./scripts/Setup-WorktreeColor.ps1 -VSCodeWorkspaceFile \"${workspaceFile}\"",
-      "detail": "Sets a unique window color from a deterministic palette slot",
-      "runOptions": {
-        "runOn": "folderOpen"
-      },
+      "detail": "Windows only: sets a unique window color from a deterministic palette slot",
       "options": {
         "shell": {
           "executable": "powershell.exe",
@@ -216,7 +230,7 @@
         "kind": "build",
         "isDefault": true
       },
-      "detail": "Build FieldWorks (auto-detects worktree)",
+      "detail": "Windows only: build FieldWorks (auto-detects worktree)",
       "options": {
         "shell": {
           "executable": "powershell.exe",
@@ -230,7 +244,21 @@
       "type": "shell",
       "command": "./build.ps1 -Configuration Release",
       "group": "build",
-      "detail": "Build FieldWorks in Release configuration",
+      "detail": "Windows only: build FieldWorks in Release configuration",
+      "options": {
+        "shell": {
+          "executable": "powershell.exe",
+          "args": ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command"]
+        }
+      },
+      "problemMatcher": "$msCompile"
+    },
+    {
+      "label": "Build Tests",
+      "type": "shell",
+      "command": "./build.ps1 -BuildTests",
+      "group": "build",
+      "detail": "Windows only: build FieldWorks including test projects (required for ReSharper Test Explorer)",
       "options": {
         "shell": {
           "executable": "powershell.exe",
@@ -249,7 +277,7 @@
         "kind": "test",
         "isDefault": true
       },
-      "detail": "Run all tests (auto-detects worktree). See specs/007-test-modernization-vstest/IGNORED_TESTS.md for the tracked skip/ignore inventory.",
+      "detail": "Windows only execution. On Linux/macOS this exits with a not-supported message. See specs/007-test-modernization-vstest/IGNORED_TESTS.md for the tracked skip/ignore inventory.",
       "options": {
         "shell": {
           "executable": "powershell.exe",
@@ -263,7 +291,7 @@
       "type": "shell",
       "command": "./test.ps1 -ListTests -NoBuild -Configuration ${input:testConfiguration} -Verbosity ${input:testVerbosity}",
       "group": "test",
-      "detail": "List tests via test.ps1 (requires existing built test assemblies). For known skips/ignores see specs/007-test-modernization-vstest/IGNORED_TESTS.md.",
+      "detail": "Windows only execution. On Linux/macOS this exits with a not-supported message. For known skips/ignores see specs/007-test-modernization-vstest/IGNORED_TESTS.md.",
       "options": {
         "shell": {
           "executable": "powershell.exe",
@@ -277,7 +305,7 @@
       "type": "shell",
       "command": "./test.ps1 -TestFilter '${input:testFilter}' -Configuration ${input:testConfiguration} -Verbosity ${input:testVerbosity}",
       "group": "test",
-      "detail": "Run tests with a filter expression. If failures correspond to known ignores/skips, see specs/007-test-modernization-vstest/IGNORED_TESTS.md.",
+      "detail": "Windows only execution. On Linux/macOS this exits with a not-supported message. If failures correspond to known ignores/skips, see specs/007-test-modernization-vstest/IGNORED_TESTS.md.",
       "options": {
         "shell": {
           "executable": "powershell.exe",
@@ -291,7 +319,7 @@
       "type": "shell",
       "command": "./test.ps1 -TestProject '${input:testProject}' -Configuration ${input:testConfiguration} -Verbosity ${input:testVerbosity}",
       "group": "test",
-      "detail": "Run tests from a specific project. Track known skips/ignores in specs/007-test-modernization-vstest/IGNORED_TESTS.md.",
+      "detail": "Windows only execution. On Linux/macOS this exits with a not-supported message. Track known skips/ignores in specs/007-test-modernization-vstest/IGNORED_TESTS.md.",
       "options": {
         "shell": {
           "executable": "powershell.exe",

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.'

Directory.Packages.props

@@ -153,5 +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>

FieldWorks.sln

@@ -18,6 +18,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DetailControls", "Src\Commo
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DetailControlsTests", "Src\Common\Controls\DetailControls\DetailControlsTests\DetailControlsTests.csproj", "{36F2A7A6-C7F9-5D3D-87D7-B4C0D5C51C0E}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RenderTestInfrastructure", "Src\Common\RenderTestInfrastructure\RenderTestInfrastructure.csproj", "{B53C715F-2F97-4E2B-9C10-5BFF1C04A446}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RenderVerification", "Src\Common\RenderVerification\RenderVerification.csproj", "{6F7A4D9C-5B44-4D0E-ABAA-8D6F38F30C6A}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Discourse", "Src\LexText\Discourse\Discourse.csproj", "{A51BAFC3-1649-584D-8D25-101884EE9EAA}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "DiscourseTests", "Src\LexText\Discourse\DiscourseTests\DiscourseTests.csproj", "{1CE6483D-5D10-51AD-B2A7-FD7F82CCBAB2}"
@@ -335,6 +339,18 @@ Global
 		{36F2A7A6-C7F9-5D3D-87D7-B4C0D5C51C0E}.Debug|x64.Build.0 = Debug|x64
 		{36F2A7A6-C7F9-5D3D-87D7-B4C0D5C51C0E}.Release|x64.ActiveCfg = Release|x64
 		{36F2A7A6-C7F9-5D3D-87D7-B4C0D5C51C0E}.Release|x64.Build.0 = Release|x64
+		{B53C715F-2F97-4E2B-9C10-5BFF1C04A446}.Bounds|x64.ActiveCfg = Release|x64
+		{B53C715F-2F97-4E2B-9C10-5BFF1C04A446}.Bounds|x64.Build.0 = Release|x64
+		{B53C715F-2F97-4E2B-9C10-5BFF1C04A446}.Debug|x64.ActiveCfg = Debug|x64
+		{B53C715F-2F97-4E2B-9C10-5BFF1C04A446}.Debug|x64.Build.0 = Debug|x64
+		{B53C715F-2F97-4E2B-9C10-5BFF1C04A446}.Release|x64.ActiveCfg = Release|x64
+		{B53C715F-2F97-4E2B-9C10-5BFF1C04A446}.Release|x64.Build.0 = Release|x64
+		{6F7A4D9C-5B44-4D0E-ABAA-8D6F38F30C6A}.Bounds|x64.ActiveCfg = Release|x64
+		{6F7A4D9C-5B44-4D0E-ABAA-8D6F38F30C6A}.Bounds|x64.Build.0 = Release|x64
+		{6F7A4D9C-5B44-4D0E-ABAA-8D6F38F30C6A}.Debug|x64.ActiveCfg = Debug|x64
+		{6F7A4D9C-5B44-4D0E-ABAA-8D6F38F30C6A}.Debug|x64.Build.0 = Debug|x64
+		{6F7A4D9C-5B44-4D0E-ABAA-8D6F38F30C6A}.Release|x64.ActiveCfg = Release|x64
+		{6F7A4D9C-5B44-4D0E-ABAA-8D6F38F30C6A}.Release|x64.Build.0 = Release|x64
 		{A51BAFC3-1649-584D-8D25-101884EE9EAA}.Bounds|x64.ActiveCfg = Release|x64
 		{A51BAFC3-1649-584D-8D25-101884EE9EAA}.Bounds|x64.Build.0 = Release|x64
 		{A51BAFC3-1649-584D-8D25-101884EE9EAA}.Debug|x64.ActiveCfg = Debug|x64