Proof of concept implementation improvements

- Added NavigateBack support
- Only accept input when it is presented
- Updated visual logic for number keys menu with new navigation

Author: AshleighAdams

tests/ProofOfConcepts/NumberKeysMenuAPI.cs

@@ -116,9 +116,16 @@ void writeLine(string line = "", bool background = false)
 				}
 
 				bool showExitButton = focusedMenu.Parents.Where(x => !x.PlayerCanClose).Any() == false;
-				bool showBackButton = showExitButton
-					? itemsStart == 0 && focusedMenu.PlayerCanClose && focusedMenu.Parent is not null
-					: itemsStart == 0 && focusedMenu.PlayerCanClose;
+				bool showBackButton = focusedMenu switch
+				{
+					{ CurrentPage: not 0 } => false,
+					{ NavigateBack: not null } => true,
+					_ => showExitButton switch
+					{
+						true => focusedMenu.PlayerCanClose && focusedMenu.Parent is not null,
+						false => focusedMenu.PlayerCanClose,
+					},
+				};
 				bool showPrevButton = itemsStart > 0;
 				bool showNextButton = itemsStart + itemsInPage < focusedMenu.Items.Count;
 				bool showNavigation = showBackButton || showPrevButton || showNextButton;
@@ -169,11 +176,20 @@ void ISampleMenu.HandleKey(CCSPlayerController player, ConsoleKeyInfo key)
 		var itemsStart = focusedMenu.CurrentPage * ItemsPerPage;
 		var itemsInPage = Math.Min(focusedMenu.Items.Count, itemsStart + ItemsPerPage) - itemsStart;
 
-		bool showBackButton = itemsStart == 0 && focusedMenu.PlayerCanClose;
+		bool showExitButton = focusedMenu.Parents.Where(x => !x.PlayerCanClose).Any() == false;
+		bool showBackButton = focusedMenu switch
+		{
+			{ CurrentPage: not 0 } => false,
+			{ NavigateBack: not null } => true,
+			_ => showExitButton switch
+			{
+				true => focusedMenu.PlayerCanClose && focusedMenu.Parent is not null,
+				false => focusedMenu.PlayerCanClose,
+			},
+		};
 		bool showPrevButton = itemsStart > 0;
 		bool showNextButton = itemsStart + itemsInPage < focusedMenu.Items.Count;
 		bool showNavigation = showBackButton || showPrevButton || showNextButton;
-		bool showExitButton = focusedMenu.Parents.Where(x => !x.PlayerCanClose).Any() == false;
 
 		switch (key.Key)
 		{
@@ -186,7 +202,12 @@ void ISampleMenu.HandleKey(CCSPlayerController player, ConsoleKeyInfo key)
 				if (showPrevButton)
 					focusedMenu.CurrentPage--;
 				else if (showBackButton)
-					focusedMenu.Close();
+				{
+					if (focusedMenu.NavigateBack is not null)
+						focusedMenu.NavigateBack(focusedMenu);
+					else
+						focusedMenu.Close();
+				}
 				break;
 			case ConsoleKey.D9:
 				if (showNextButton)
@@ -229,7 +250,7 @@ public void SortPriorities()
 	}
 }
 
-internal class NumberKeysMenu : IMenu, IMenuPriorityExtension
+internal class NumberKeysMenu : IMenu, IMenuPriorityExtension, INavigateBackMenuExtension
 {
 	public required NumbersPlayerMenuState MenuState { get; init; }
 	public required List<NumberKeysMenu> Parents { get; init; }
@@ -284,6 +305,9 @@ public double Priority
 		}
 	}
 	public bool IsFocused => MenuState.FocusStack.Count > 0 && MenuState.FocusStack[0] == this;
+
+	// INavigateBackMenuExtension
+	public Action<IMenu>? NavigateBack { get; set; }
 }
 
 internal class NumbersMenuItem : IMenuItem, IMenuItemSubtitleExtension

tests/ProofOfConcepts/WASDMenuAPI.cs

@@ -145,7 +145,10 @@ void ISampleMenu.HandleKey(CCSPlayerController player, ConsoleKeyInfo key)
 					focusedMenu.Items[focusedMenu.CurrentPosition].RaiseSelected();
 				break;
 			case ConsoleKey.A:
-				focusedMenu.Close();
+				if (focusedMenu.NavigateBack is not null)
+					focusedMenu.NavigateBack(focusedMenu);
+				else if (focusedMenu.PlayerCanClose)
+					focusedMenu.Close();
 				break;
 			case ConsoleKey.W:
 				focusedMenu.CurrentPosition = Math.Max(focusedMenu.CurrentPosition - 1, 0);
@@ -190,7 +193,7 @@ public void SortPriorities()
 	}
 }
 
-internal class WASDMenu : IMenu, IMenuPriorityExtension
+internal class WASDMenu : IMenu, IMenuPriorityExtension, INavigateBackMenuExtension
 {
 	public required WASDPlayerMenuState MenuState { get; init; }
 	public required List<WASDMenu> Parents { get; init; }
@@ -246,6 +249,9 @@ public double Priority
 		}
 	}
 	public bool IsFocused => MenuState.FocusStack.Count > 0 && MenuState.FocusStack[0] == this;
+
+	// INavigateBackMenuExtension
+	public Action<IMenu>? NavigateBack { get; set; }
 }
 
 internal class WASDMenuItem : IMenuItem