Game picker and save browser: menu window shell, background warm-up

The main menu warms every ready game's mods up into the assembly cache in the
background (last played first), so picking a game only loads cached assemblies.
Game picker and save browser are scenes on the shared MenuWindowShell (also used by
the settings): caps title, close on the right, footer hint; the picker footer shows
the warm-up state, cards get framed covers with a letter placeholder and Continue as
the main action; the save browser shows 3x2 large cards with the game selector in
the header. new_game waits for the warm-up; menu_flow takes --shots.

test_suites/menu_flow/src/MenuFlowTestDriverNode.cs

@@ -19,7 +19,8 @@ namespace Mods.MenuFlowTest
     /// without a game); Play opens a card per game; the save browser lists a
     /// game's save; a player's own game can be deleted from the collection
     /// editor (a built-in one cannot) while its mods stay; the composition of
-    /// a game is computed without loading it; Continue sees the last session. Prints <c>[TEST_RESULT] name=menu_flow</c>.
+    /// a game is computed without loading it; Continue sees the last session.
+    /// <c>--shots=&lt;dir&gt;</c> saves the game picker and the save browser. Prints <c>[TEST_RESULT] name=menu_flow</c>.
     /// </summary>
     public partial class MenuFlowTestDriverNode : Node
     {
@@ -96,6 +97,7 @@ namespace Mods.MenuFlowTest
                 {
                     var picker = Menu.GetNodeOrNull<GamePickerPanel>("GamePickerPanel");
                     Check("Play opens the game picker", picker?.Visible == true);
+                    Shot("game_picker");
                     var games = GameCatalog.Games();
                     var newGameText = TranslationServer.Translate("menu/play/new_game").ToString();
                     var startButtons = Buttons(picker).Where(b => b.Text == newGameText).ToList();
@@ -155,6 +157,7 @@ namespace Mods.MenuFlowTest
                     var slots = browser.FindChildren("*", "", true, false).OfType<SaveSlotItem>().ToList();
                     Check("save browser lists the game's save", slots.Any(s => s.Model?.FileName == Slot));
                     Check("save list carries the game id", SaveService.ListSaves(GameId).Any(s => s.FileName == Slot && s.GameId == GameId));
+                    Shot("save_browser");
                     browser.Visible = false;
 
                     var composition = GameCatalog.Composition(GameId);
@@ -175,6 +178,22 @@ namespace Mods.MenuFlowTest
             step++;
         }
 
+        /// <summary>With <c>--shots=&lt;dir&gt;</c> saves the window as <paramref name="name"/>.png (windowed runs only).</summary>
+        private void Shot(string name)
+        {
+            string dir = null;
+            foreach (var arg in OS.GetCmdlineUserArgs())
+            {
+                if (arg.StartsWith("--shots="))
+                    dir = arg.Substring("--shots=".Length);
+            }
+            if (string.IsNullOrEmpty(dir) || DisplayServer.GetName() == "headless")
+                return;
+            dir = ProjectSettings.GlobalizePath(dir);
+            Directory.CreateDirectory(dir);
+            GetViewport().GetTexture().GetImage().SavePng(Path.Combine(dir, name + ".png"));
+        }
+
         private Button DeleteButton()
         {
             var text = TranslationServer.Translate("mod_manager/collection_delete").ToString();

test_suites/new_game/src/NewGameTestDriverNode.cs

@@ -17,7 +17,8 @@ namespace Mods.NewGameTest
     /// Plays the games the way a player does, in ONE process: no restart
     /// happens anywhere, every game switch replaces the mod set in place.
     /// <list type="number">
-    /// <item>Front-end menu → Play → the <c>cthangover</c> card → New game: the
+    /// <item>The front-end menu warms every game's mods up in the background;
+    /// once done, Play → the <c>cthangover</c> card → New game: the
     /// process switches to the game, enters <c>prolog_alley</c> and the opening
     /// dialog about the hungover Marao is clicked through.</item>
     /// <item>Hot reload inside the game (forced reload of <c>cthangover_party</c>):
@@ -105,8 +106,13 @@ namespace Mods.NewGameTest
             switch (step)
             {
                 case 0:
-                    if (!Boot.IsReady || !PressMenuPlay())
+                    // The menu compiles the games' mods in the background; the switch
+                    // below must then only load them from the cache (see the log).
+                    if (!Boot.IsReady || GetTree().CurrentScene is not Cthangover.BaseMenu.MainMenu || GameSession.IsWarmingUp)
                         return;
+                    if (!PressMenuPlay())
+                        return;
+                    Check("the menu warmed the games up in the background", true);
                     Check("front-end menu offers Play", ActiveGame.IsFrontendOnly);
                     break;