refactor(panel): move StartMenu config into StartMenuElement

StartMenuElement now owns its own Options, keyboard shortcut,
actions registry, and menu window tracking. Each element is
self-contained, enabling multiple independent start menus.

- Add Options, ShortcutKey, ShortcutModifiers, RegisterAction/
  UnregisterAction/GetActions, Show(), MenuWindow to StartMenuElement
- Update StartMenuElementBuilder with WithOptions, WithShortcutKey
- Change StartMenuDialog.Show() to accept element instead of reading
  global state from PanelStateService
- InputCoordinator iterates all StartMenuElements for shortcuts
- Remove all StartMenu state from PanelStateService
- Remove StartMenu/StartMenuShortcutKey/StartMenuShortcutModifiers
  from ConsoleWindowSystemOptions
- Update StartMenuDemo and DemoApp examples

Author: nickprotop

Examples/DemoApp/Program.cs

@@ -20,21 +20,22 @@ static async Task<int> Main(string[] args)
         try
         {
             var options = new ConsoleWindowSystemOptions(
-                StartMenu: new StartMenuOptions
-                {
-                    AppName = "SharpConsoleUI Demo",
-                    SidebarStyle = StartMenuSidebarStyle.IconLabel,
-                    BackgroundGradient = new GradientBackground(
-                        ColorGradient.FromColors(new Color(25, 25, 60), new Color(15, 15, 35)),
-                        GradientDirection.Vertical)
-                },
                 TopPanelConfig: panel => panel
                     .Left(Elements.StatusText("[bold cyan]SharpConsoleUI Demo[/]"))
                     .Left(Elements.Separator())
                     .Left(Elements.StatusText("[dim]Ctrl+T: Theme[/]"))
                     .Right(Elements.Performance()),
                 BottomPanelConfig: panel => panel
-                    .Left(Elements.StartMenu().WithText("\u2630 Start"))
+                    .Left(Elements.StartMenu()
+                        .WithText("\u2630 Start")
+                        .WithOptions(new StartMenuOptions
+                        {
+                            AppName = "SharpConsoleUI Demo",
+                            SidebarStyle = StartMenuSidebarStyle.IconLabel,
+                            BackgroundGradient = new GradientBackground(
+                                ColorGradient.FromColors(new Color(25, 25, 60), new Color(15, 15, 35)),
+                                GradientDirection.Vertical)
+                        }))
                     .Center(Elements.TaskBar())
                     .Right(Elements.Clock().WithFormat("HH:mm:ss"))
             );

Examples/StartMenuDemo/Program.cs

@@ -7,6 +7,7 @@
 using SharpConsoleUI.Helpers;
 using SharpConsoleUI.Panel;
 using SharpConsoleUI.Plugins.DeveloperTools;
+using SharpConsoleUI.Rendering;
 
 namespace StartMenuDemo;
 
@@ -20,14 +21,17 @@ static async Task<int> Main(string[] args)
 
 			var options = new ConsoleWindowSystemOptions(
 				EnablePerformanceMetrics: false,
-				StartMenu: new StartMenuOptions
-				{
-					ShowWindowList = true,
-					SidebarStyle = StartMenuSidebarStyle.IconLabel
-				},
 				TopPanelConfig: panel => panel.Left(Elements.StatusText("")),
 				BottomPanelConfig: panel => panel
-					.Left(Elements.StartMenu())
+					.Left(Elements.StartMenu()
+						.WithOptions(new StartMenuOptions
+						{
+							ShowWindowList = true,
+							SidebarStyle = StartMenuSidebarStyle.IconLabel,
+							BackgroundGradient = new GradientBackground(
+								ColorGradient.FromColors(new Color(25, 25, 60), new Color(15, 15, 35)),
+								GradientDirection.Vertical)
+						}))
 					.Center(Elements.TaskBar())
 			);
 
@@ -52,8 +56,11 @@ static async Task<int> Main(string[] args)
 				Console.WriteLine($"\x1b[33mNote: DeveloperTools plugin not available: {ex.Message}\x1b[0m");
 			}
 
+			// Get the start menu element to register actions on it
+			var startMenu = windowSystem.BottomPanel!.FindElement<StartMenuElement>("startmenu")!;
+
 			// Register user actions - File category
-			windowSystem.PanelStateService.RegisterStartMenuAction("New Document", () =>
+			startMenu.RegisterAction("New Document", () =>
 			{
 				var window = new Window(windowSystem)
 				{
@@ -74,7 +81,7 @@ static async Task<int> Main(string[] args)
 				windowSystem.SetActiveWindow(window);
 			}, category: "File", order: 10);
 
-			windowSystem.PanelStateService.RegisterStartMenuAction("Open File", () =>
+			startMenu.RegisterAction("Open File", () =>
 			{
 				var window = new Window(windowSystem)
 				{
@@ -94,7 +101,7 @@ static async Task<int> Main(string[] args)
 				windowSystem.SetActiveWindow(window);
 			}, category: "File", order: 20);
 
-			windowSystem.PanelStateService.RegisterStartMenuAction("Save File", () =>
+			startMenu.RegisterAction("Save File", () =>
 			{
 				windowSystem.NotificationStateService.ShowNotification(
 					"Save",
@@ -104,7 +111,7 @@ static async Task<int> Main(string[] args)
 			}, category: "File", order: 30);
 
 			// Register user actions - Tools category
-			windowSystem.PanelStateService.RegisterStartMenuAction("Calculator", () =>
+			startMenu.RegisterAction("Calculator", () =>
 			{
 				var window = new Window(windowSystem)
 				{

SharpConsoleUI/Configuration/ConsoleWindowSystemOptions.cs

@@ -80,11 +80,6 @@ public record ConsoleWindowSystemOptions(
     bool EnableQualityAnalysis = false,
     bool EnablePerformanceProfiling = false,
 
-    // Start menu configuration
-    StartMenuOptions? StartMenu = null,
-    ConsoleKey StartMenuShortcutKey = ConsoleKey.Spacebar,
-    ConsoleModifiers StartMenuShortcutModifiers = ConsoleModifiers.Control,
-
     // Panel system configuration
     Func<SharpConsoleUI.Panel.PanelBuilder, SharpConsoleUI.Panel.PanelBuilder>? TopPanelConfig = null,
     Func<SharpConsoleUI.Panel.PanelBuilder, SharpConsoleUI.Panel.PanelBuilder>? BottomPanelConfig = null,

SharpConsoleUI/Core/PanelStateService.cs

@@ -7,23 +7,17 @@
 // -----------------------------------------------------------------------
 
 using SharpConsoleUI.Configuration;
-using SharpConsoleUI.Dialogs;
 using SharpConsoleUI.Logging;
-using SharpConsoleUI.Models;
 
 namespace SharpConsoleUI.Core
 {
 	/// <summary>
-	/// Manages panel state, start menu actions, and panel visibility.
+	/// Manages panel state and visibility.
 	/// </summary>
 	public class PanelStateService
 	{
 		private readonly ILogService _logService;
 		private readonly Func<ConsoleWindowSystem> _getWindowSystem;
-		private readonly List<StartMenuAction> _startMenuActions = new();
-
-		// Start menu window tracking
-		private Window? _startMenuWindow;
 
 		// Panel references
 		private Panel.Panel? _topPanel;
@@ -33,11 +27,6 @@ public class PanelStateService
 		private bool _showTopPanel = true;
 		private bool _showBottomPanel = true;
 
-		// Start menu configuration
-		private StartMenuOptions _startMenuOptions = new();
-		private ConsoleKey _startMenuShortcutKey = ConsoleKey.Spacebar;
-		private ConsoleModifiers _startMenuShortcutModifiers = ConsoleModifiers.Control;
-
 		/// <summary>
 		/// Initializes a new instance of the PanelStateService class.
 		/// </summary>
@@ -68,28 +57,6 @@ public PanelStateService(ILogService logService, Func<ConsoleWindowSystem> getWi
 			(_topPanel?.IsDirty ?? false)
 			|| (_bottomPanel?.IsDirty ?? false);
 
-		/// <summary>
-		/// Gets the start menu options configuration.
-		/// </summary>
-		public StartMenuOptions StartMenuOptions => _startMenuOptions;
-
-		/// <summary>
-		/// Gets the shortcut key for toggling the start menu.
-		/// </summary>
-		public ConsoleKey StartMenuShortcutKey => _startMenuShortcutKey;
-
-		/// <summary>
-		/// Gets the shortcut modifier keys for toggling the start menu.
-		/// </summary>
-		public ConsoleModifiers StartMenuShortcutModifiers => _startMenuShortcutModifiers;
-
-		/// <summary>
-		/// Gets whether any panel contains a StartMenuElement.
-		/// </summary>
-		public bool HasStartMenu =>
-			(_topPanel?.HasElement<Panel.StartMenuElement>() ?? false) ||
-			(_bottomPanel?.HasElement<Panel.StartMenuElement>() ?? false);
-
 		/// <summary>
 		/// Marks both panels as dirty, forcing a re-render on the next frame.
 		/// </summary>
@@ -175,98 +142,6 @@ public string BottomStatus
 
 		#endregion
 
-		#region Start Menu Actions
-
-		/// <summary>
-		/// Registers a new action in the Start menu.
-		/// </summary>
-		/// <param name="name">Display name of the action.</param>
-		/// <param name="callback">Callback to execute when action is selected.</param>
-		/// <param name="category">Optional category for grouping actions.</param>
-		/// <param name="order">Display order (lower values appear first).</param>
-		public void RegisterStartMenuAction(string name, Action callback, string? category = null, int order = 0)
-		{
-			_logService.LogDebug($"Registering Start menu action: {name}", category: "StartMenu");
-			var action = new StartMenuAction(name, callback, category, order);
-			_startMenuActions.Add(action);
-		}
-
-		/// <summary>
-		/// Removes an action from the Start menu by name.
-		/// </summary>
-		/// <param name="name">Name of the action to remove.</param>
-		public void UnregisterStartMenuAction(string name)
-		{
-			_logService.LogDebug($"Unregistering Start menu action: {name}", category: "StartMenu");
-			_startMenuActions.RemoveAll(a => a.Name == name);
-		}
-
-		/// <summary>
-		/// Gets all registered Start menu actions.
-		/// </summary>
-		/// <returns>Read-only list of actions.</returns>
-		public IReadOnlyList<StartMenuAction> GetStartMenuActions() => _startMenuActions.AsReadOnly();
-
-		#endregion
-
-		#region Start Menu Display
-
-		/// <summary>
-		/// Gets or sets the currently open Start menu window, if any.
-		/// Used for toggle behavior — if non-null, the Start menu is open.
-		/// </summary>
-		internal Window? StartMenuWindow
-		{
-			get => _startMenuWindow;
-			set => _startMenuWindow = value;
-		}
-
-		/// <summary>
-		/// Gets the screen bounds and panel location of the start menu element.
-		/// Returns null if no start menu element exists in any panel.
-		/// </summary>
-		internal (System.Drawing.Rectangle bounds, bool isBottom)? GetStartMenuBounds()
-		{
-			var ws = _getWindowSystem();
-			var screenHeight = ws.DesktopDimensions.Height
-				+ (_topPanel?.Height ?? 0)
-				+ (_bottomPanel?.Height ?? 0);
-
-			if (_bottomPanel != null)
-			{
-				var b = _bottomPanel.GetElementBounds<Panel.StartMenuElement>();
-				if (b.HasValue)
-					return (new System.Drawing.Rectangle(b.Value.x, screenHeight - 1, b.Value.width, 1), true);
-			}
-			if (_topPanel != null)
-			{
-				var b = _topPanel.GetElementBounds<Panel.StartMenuElement>();
-				if (b.HasValue)
-					return (new System.Drawing.Rectangle(b.Value.x, 0, b.Value.width, 1), false);
-			}
-			return null;
-		}
-
-		/// <summary>
-		/// Shows the Start menu dialog.
-		/// </summary>
-		public void ShowStartMenu()
-		{
-			_logService.LogDebug("Showing Start menu", category: "StartMenu");
-			var windowSystem = _getWindowSystem();
-
-			if (windowSystem is ConsoleWindowSystem consoleWindowSystem)
-			{
-				StartMenuDialog.Show(consoleWindowSystem);
-			}
-			else
-			{
-				_logService.LogWarning("Cannot show Start menu: window system is not ConsoleWindowSystem", category: "StartMenu");
-			}
-		}
-
-		#endregion
-
 		#region Panel Initialization
 
 		/// <summary>
@@ -279,12 +154,6 @@ public void InitializePanels(ConsoleWindowSystemOptions options)
 		{
 			var ws = _getWindowSystem();
 
-			// Apply start menu config
-			if (options.StartMenu != null)
-				_startMenuOptions = options.StartMenu;
-			_startMenuShortcutKey = options.StartMenuShortcutKey;
-			_startMenuShortcutModifiers = options.StartMenuShortcutModifiers;
-
 			// Top panel: user config or default (status text + clock)
 			if (options.TopPanelConfig != null)
 			{