Add update-available badge to system tray icon

When an update is available (readyToDownload or readyToInstall), the tray icon
switches to a badged variant with an orange dot. Works for both default mode
(color icon.ico) and theme-adaptive mode (light/dark variants).

Changes:
- Add 3 badged icon variants (placeholder assets, to be replaced with designs)
- Extend get_icon() to select badged variant based on update_available state
- Add set_tray_icon_update_available() for runtime icon switching
- Hook into UpdateUtils.cpp state transitions via dispatch_run_on_main_ui_thread
- Check UpdateState at startup to show badge immediately if update pending
- Add 'Update available' context menu item at top of tray menu when active

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: niels9001

src/runner/Resources.resx

@@ -197,4 +197,7 @@
     <value>Close</value>
     <comment>Close as a verb, as in Close the application</comment>
   </data>
+  <data name="UPDATE_AVAILABLE_MENU_TEXT" xml:space="preserve">
+    <value>Update available</value>
+  </data>
 </root>

src/runner/UpdateUtils.cpp

@@ -5,6 +5,7 @@
 #include "ActionRunnerUtils.h"
 #include "general_settings.h"
 #include "trace.h"
+#include "tray_icon.h"
 #include "UpdateUtils.h"
 
 #include <common/utils/gpo.h>
@@ -130,6 +131,7 @@ void ProcessNewVersionInfo(const github_version_info& version_info,
         state.releasePageUrl = {};
         state.downloadedInstallerFilename = {};
         Logger::trace(L"Version is up to date");
+        dispatch_run_on_main_ui_thread([](PVOID) { set_tray_icon_update_available(false); }, nullptr);
         return;
     }
     const auto new_version_info = std::get<new_version_download_info>(version_info);
@@ -179,6 +181,7 @@ void ProcessNewVersionInfo(const github_version_info& version_info,
             state.state = UpdateState::readyToInstall;
             state.downloadedInstallerFilename = new_version_info.installer_filename;
             Trace::UpdateDownloadCompleted(true, new_version_info.version.toWstring());
+            dispatch_run_on_main_ui_thread([](PVOID) { set_tray_icon_update_available(true); }, nullptr);
             if (show_notifications)
             {
                 ShowNewVersionAvailable(new_version_info);
@@ -197,6 +200,7 @@ void ProcessNewVersionInfo(const github_version_info& version_info,
         Logger::trace(L"New version is ready to download, showing notification");
         state.state = UpdateState::readyToDownload;
         state.downloadedInstallerFilename = {};
+        dispatch_run_on_main_ui_thread([](PVOID) { set_tray_icon_update_available(true); }, nullptr);
         if (show_notifications)
         {
             ShowOpenSettingsForUpdate();

src/runner/resource.base.h

@@ -14,10 +14,12 @@
 
 #define APPICON 101
 #define ID_TRAY_MENU 102
+#define APPICON_UPDATE 103
 
 #define ID_CLOSE_MENU_COMMAND 40001
 #define ID_SETTINGS_MENU_COMMAND 40002
 #define ID_ABOUT_MENU_COMMAND 40003
 #define ID_REPORT_BUG_COMMAND 40004
 #define ID_DOCUMENTATION_MENU_COMMAND 40005
 #define ID_QUICK_ACCESS_MENU_COMMAND 40006
+#define ID_UPDATE_MENU_COMMAND 40007

src/runner/svgs/PowerToysDark.ico

@@ -17,6 +17,7 @@
 #include <common/Themes/theme_listener.h>
 #include <common/Themes/theme_helpers.h>
 #include "bug_report.h"
+#include <common/updating/updateState.h>
 
 namespace
 {
@@ -45,6 +46,7 @@ namespace
 
     static ThemeListener theme_listener;
     static bool theme_adaptive_enabled = false;
+    static bool update_available = false;
 }
 
 // Struct to fill with callback and the data. The window_proc is responsible for cleaning it.
@@ -124,6 +126,11 @@ void handle_tray_command(HWND window, const WPARAM command_id, LPARAM lparam)
         open_quick_access_flyout_window();
         break;
     }
+    case ID_UPDATE_MENU_COMMAND:
+    {
+        open_settings_window(std::nullopt);
+        break;
+    }
     }
 }
 
@@ -260,6 +267,15 @@ LRESULT __stdcall tray_icon_window_proc(HWND window, UINT message, WPARAM wparam
                 {
                     h_sub_menu = GetSubMenu(h_menu, 0);
                 }
+
+                // Dynamically add/remove "Update available" menu item
+                DeleteMenu(h_sub_menu, ID_UPDATE_MENU_COMMAND, MF_BYCOMMAND);
+                if (update_available)
+                {
+                    InsertMenuW(h_sub_menu, 0, MF_BYPOSITION | MF_STRING, ID_UPDATE_MENU_COMMAND, GET_RESOURCE_STRING(IDS_UPDATE_AVAILABLE_MENU_TEXT).c_str());
+                    InsertMenuW(h_sub_menu, 1, MF_BYPOSITION | MF_SEPARATOR, 0, nullptr);
+                }
+
                 POINT mouse_pointer;
                 GetCursorPos(&mouse_pointer);
                 SetForegroundWindow(window); // Needed for the context menu to disappear.
@@ -318,7 +334,14 @@ LRESULT __stdcall tray_icon_window_proc(HWND window, UINT message, WPARAM wparam
 static HICON get_icon(Theme theme)
 {
     std::wstring icon_path = get_module_folderpath();
-    icon_path += theme == Theme::Dark ? L"\\svgs\\PowerToysWhite.ico" : L"\\svgs\\PowerToysDark.ico";
+    if (theme == Theme::Dark)
+    {
+        icon_path += update_available ? L"\\svgs\\PowerToysWhiteUpdate.ico" : L"\\svgs\\PowerToysWhite.ico";
+    }
+    else
+    {
+        icon_path += update_available ? L"\\svgs\\PowerToysDarkUpdate.ico" : L"\\svgs\\PowerToysDark.ico";
+    }
     Logger::trace(L"get_icon: Loading icon from path: {}", icon_path);
 
     HICON icon = static_cast<HICON>(LoadImage(NULL,
@@ -356,7 +379,14 @@ void start_tray_icon(bool isProcessElevated, bool theme_adaptive)
 {
     theme_adaptive_enabled = theme_adaptive;
     auto h_instance = reinterpret_cast<HINSTANCE>(&__ImageBase);
-    HICON const icon = theme_adaptive ? get_icon(ThemeHelpers::GetSystemTheme()) : LoadIcon(h_instance, MAKEINTRESOURCE(APPICON));
+
+    // Check if an update is available at startup
+    auto state = UpdateState::read();
+    update_available = (state.state == UpdateState::readyToDownload || state.state == UpdateState::readyToInstall);
+
+    HICON const icon = theme_adaptive
+                           ? get_icon(ThemeHelpers::GetSystemTheme())
+                           : LoadIcon(h_instance, MAKEINTRESOURCE(update_available ? APPICON_UPDATE : APPICON));
     if (icon)
     {
         UINT id_tray_icon = 1;
@@ -425,6 +455,29 @@ void set_tray_icon_visible(bool shouldIconBeVisible)
     Shell_NotifyIcon(NIM_MODIFY, &tray_icon_data);
 }
 
+void set_tray_icon_update_available(bool available)
+{
+    if (update_available == available)
+    {
+        return;
+    }
+
+    update_available = available;
+    Logger::info(L"set_tray_icon_update_available: update_available={}", update_available);
+
+    if (theme_adaptive_enabled)
+    {
+        tray_icon_data.hIcon = get_icon(ThemeHelpers::GetSystemTheme());
+    }
+    else
+    {
+        auto h_instance = reinterpret_cast<HINSTANCE>(&__ImageBase);
+        tray_icon_data.hIcon = LoadIcon(h_instance, MAKEINTRESOURCE(available ? APPICON_UPDATE : APPICON));
+    }
+
+    Shell_NotifyIcon(NIM_MODIFY, &tray_icon_data);
+}
+
 void set_tray_icon_theme_adaptive(bool theme_adaptive)
 {
     Logger::info(L"set_tray_icon_theme_adaptive: Called with theme_adaptive={}, current theme_adaptive_enabled={}",