Clear native notifications in tests

Add platform-specific notification cleanup for tests and tidy docs. Implement Windows toast history clearing (RoInitialize, WindowsCreateString, RoGetActivationFactory + IToastNotificationHistory::Clear) and include necessary WinRT headers (with correct include order). Keep Linux desktop cleanup in namespace. Replace the long Windows test sleep with a call to dismissNativeNotifications(), and shorten wait logic. Also add 'runtimeobject' to WIN32 test link libs in CMakeLists and simplify README icon docs to a single supported-formats line.

Author: ReenigneArcher

README.md

@@ -133,10 +133,7 @@ The `icon` and `notification_icon` fields can be a path to an image file or an i
 are resolved from the process working directory, so applications should copy or install icon files where the running
 process can find them.
 
-| Component                               | Backend                                                      | Supported inputs                   | Notes                                                                                                                                      |
-|-----------------------------------------|--------------------------------------------------------------|------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|
-| Tray icon (`icon`)                      | Qt `QSystemTrayIcon` / `QIcon` on all platforms              | SVG, ICO, PNG, Qt theme icon names | Loaded through Qt's `QIcon` path; SVG, ICO, and PNG are tested. Theme icon names are resolved by Qt when the platform/theme supports them. |
-| Notification icon (`notification_icon`) | Qt `QSystemTrayIcon::showMessage` / `QIcon` on all platforms | SVG, ICO, PNG, Qt theme icon names | Loaded through Qt's `QIcon` path; SVG, ICO, and PNG are tested. Theme icon names are resolved by Qt when the platform/theme supports them. |
+SVG, ICO, PNG, and Qt theme icon names are supported.
 
 For the most predictable cross-platform behavior, use SVG or PNG files for both tray and notification icons. ICO is
 supported by the Qt-backed paths tested by this project.

tests/CMakeLists.txt

@@ -20,7 +20,7 @@ include_directories("${GTEST_SOURCE_DIR}/googletest/include" "${GTEST_SOURCE_DIR
 if (APPLE)
     set(TEST_LIBS "-framework Cocoa")
 elseif (WIN32)
-    set(TEST_LIBS gdi32 gdiplus)
+    set(TEST_LIBS gdi32 gdiplus runtimeobject)
 endif()
 
 file(GLOB_RECURSE TEST_SOURCES

tests/utils.cpp

@@ -8,10 +8,69 @@
 // standard includes
 #include <chrono>
 #include <cstdlib>
+#include <cwchar>
 #include <thread>
 
-#ifdef __linux__
+#ifdef _WIN32
+  // build fails if windows.ui.notifications.h is included before roapi.h
+  #include <roapi.h>
+// clang-format off
+  #include <windows.ui.notifications.h>
+// clang-format on
+  #include <winstring.h>
+#endif
+
+#if defined(_WIN32) || defined(__linux__)
 namespace {
+  #ifdef _WIN32
+  namespace notifications = ABI::Windows::UI::Notifications;
+
+  void clearToastNotificationHistory() {
+    const HRESULT init_result = RoInitialize(RO_INIT_MULTITHREADED);
+    const bool should_uninitialize = SUCCEEDED(init_result);
+
+    HSTRING class_id = nullptr;
+    HRESULT result = WindowsCreateString(
+      RuntimeClass_Windows_UI_Notifications_ToastNotificationManager,
+      static_cast<UINT32>(std::wcslen(RuntimeClass_Windows_UI_Notifications_ToastNotificationManager)),
+      &class_id
+    );
+    if (FAILED(result)) {
+      if (should_uninitialize) {
+        RoUninitialize();
+      }
+      return;
+    }
+
+    notifications::IToastNotificationManagerStatics2 *manager = nullptr;
+    result = RoGetActivationFactory(
+      class_id,
+      __uuidof(notifications::IToastNotificationManagerStatics2),
+      reinterpret_cast<void **>(&manager)
+    );
+    WindowsDeleteString(class_id);
+    if (FAILED(result) || manager == nullptr) {
+      if (should_uninitialize) {
+        RoUninitialize();
+      }
+      return;
+    }
+
+    notifications::IToastNotificationHistory *history = nullptr;
+    result = manager->get_History(&history);
+    manager->Release();
+    if (SUCCEEDED(result) && history != nullptr) {
+      (void) history->Clear();
+      history->Release();
+    }
+
+    if (should_uninitialize) {
+      RoUninitialize();
+    }
+  }
+  #endif
+
+  #ifdef __linux__
   void closeFreedesktopNotifications() {
     constexpr const char *close_notifications =
       "if command -v dbus-send >/dev/null 2>&1; then "
@@ -24,6 +83,7 @@ namespace {
       "fi";
     (void) std::system(close_notifications);  // NOSONAR(cpp:S4721) - test-only cleanup of desktop notifications
   }
+  #endif
 }  // namespace
 #endif
 
@@ -42,7 +102,11 @@ int setEnv(const std::string &name, const std::string &value) {
 }
 
 void dismissNativeNotifications() {
-#ifdef __linux__
+#ifdef _WIN32
+  clearToastNotificationHistory();
+  constexpr auto wait_timeout = std::chrono::milliseconds(500);
+  std::this_thread::sleep_for(wait_timeout);
+#elif defined(__linux__)
   closeFreedesktopNotifications();
   constexpr auto wait_timeout = std::chrono::milliseconds(500);
   std::this_thread::sleep_for(wait_timeout);
@@ -51,8 +115,7 @@ void dismissNativeNotifications() {
 
 void waitForNativeNotificationTimeout() {
 #ifdef _WIN32
-  constexpr auto wait_timeout = std::chrono::milliseconds(6000);
-  std::this_thread::sleep_for(wait_timeout);
+  dismissNativeNotifications();
 #elif defined(__linux__)
   dismissNativeNotifications();
 #endif