feat(draw): Implemented pinning to the top of the taskbar

Author: vladelaina

include/window/window_desktop_integration.h

@@ -34,5 +34,16 @@ void SetWindowTopmost(HWND hwnd, BOOL topmost);
  */
 void ReattachToDesktop(HWND hwnd);
 
+/**
+ * @brief Enforce topmost when window overlaps taskbar
+ * @param hwnd Window handle
+ * @return TRUE if window overlaps taskbar area, FALSE otherwise
+ * 
+ * @details If window is in topmost mode and overlaps with taskbar area,
+ * re-apply topmost to ensure visibility. Called periodically by main timer.
+ * Uses standard SetWindowPos API - safe and game-compatible.
+ */
+BOOL EnforceTopmostOverTaskbar(HWND hwnd);
+
 #endif /* WINDOW_DESKTOP_INTEGRATION_H */
 

resource/resource.h

@@ -54,6 +54,7 @@
 #define TIMER_ID_VOLUME_PREVIEW 1007         /**< Volume preview auto-stop timer (3s limit) */
 #define TIMER_ID_EDIT_MODE_REFRESH 2001      /**< Edit mode refresh timer */
 #define TIMER_ID_RENDER_ANIMATION 2002       /**< Dedicated animation render timer (30-60 FPS) */
+#define TIMER_ID_TOPMOST_ENFORCE 2003        /**< Fast topmost enforcement when near taskbar (50ms) */
 #define TRAY_TIP_TIMER_ID 42421              /**< Tray tooltip update timer */
 
 /** @brief Timer interval constants */

src/timer/timer_events.c

@@ -21,6 +21,7 @@
 #include "tray/tray_animation_core.h"
 #include "utils/string_convert.h"
 #include "log.h"
+#include "window/window_desktop_integration.h"
 
 /* Pomodoro and timer constants:
  * - 1500s = 25 min (standard Pomodoro work duration)
@@ -45,6 +46,7 @@ static int pomodoro_initial_loop_count = 0;
 static DWORD last_timer_tick = 0;
 static int ms_accumulator = 0;
 static BOOL tail_fast_mode_active = FALSE;
+static BOOL topmost_fast_mode_active = FALSE;
 
 static inline void ForceWindowRedraw(HWND hwnd) {
     InvalidateRect(hwnd, NULL, TRUE);
@@ -477,6 +479,19 @@ static void HandleCountdownCompletion(HWND hwnd) {
 }
 
 static BOOL HandleMainTimer(HWND hwnd) {
+    /* Manage fast topmost enforcement based on taskbar overlap */
+    BOOL overlapsTaskbar = EnforceTopmostOverTaskbar(hwnd);
+    
+    if (overlapsTaskbar && !topmost_fast_mode_active) {
+        /* Window entered taskbar area - start fast timer (50ms) */
+        SetTimer(hwnd, TIMER_ID_TOPMOST_ENFORCE, 50, NULL);
+        topmost_fast_mode_active = TRUE;
+    } else if (!overlapsTaskbar && topmost_fast_mode_active) {
+        /* Window left taskbar area - stop fast timer */
+        KillTimer(hwnd, TIMER_ID_TOPMOST_ENFORCE);
+        topmost_fast_mode_active = FALSE;
+    }
+    
     if (CLOCK_SHOW_CURRENT_TIME) {
         extern int last_displayed_second;
         last_displayed_second = -1;
@@ -599,6 +614,11 @@ BOOL HandleTimerEvent(HWND hwnd, WPARAM wp) {
             InvalidateRect(hwnd, NULL, TRUE);
             return TRUE;
 
+        case TIMER_ID_TOPMOST_ENFORCE:
+            /* Fast topmost enforcement when overlapping taskbar (50ms) */
+            EnforceTopmostOverTaskbar(hwnd);
+            return TRUE;
+
         default:
             return FALSE;
     }

src/window/window_desktop_integration.c

@@ -127,3 +127,33 @@ void ReattachToDesktop(HWND hwnd) {
                  SWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE | SWP_SHOWWINDOW);
 }
 
+BOOL EnforceTopmostOverTaskbar(HWND hwnd) {
+    /* Only enforce if topmost mode is enabled */
+    if (!CLOCK_WINDOW_TOPMOST) return FALSE;
+    
+    /* Get our window position */
+    RECT rcWindow;
+    if (!GetWindowRect(hwnd, &rcWindow)) return FALSE;
+    
+    /* Get taskbar position */
+    HWND hTaskbar = FindWindowW(L"Shell_TrayWnd", NULL);
+    if (!hTaskbar) return FALSE;
+    
+    RECT rcTaskbar;
+    if (!GetWindowRect(hTaskbar, &rcTaskbar)) return FALSE;
+    
+    /* Check if our window overlaps with taskbar area */
+    BOOL overlaps = !(rcWindow.right < rcTaskbar.left ||
+                      rcWindow.left > rcTaskbar.right ||
+                      rcWindow.bottom < rcTaskbar.top ||
+                      rcWindow.top > rcTaskbar.bottom);
+    
+    if (overlaps) {
+        /* Re-apply topmost to ensure we stay above taskbar */
+        SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0,
+                     SWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE);
+    }
+    
+    return overlaps;
+}
+

src/window_procedure/window_events.c

@@ -100,6 +100,7 @@ void HandleWindowDestroy(HWND hwnd) {
     CleanupUpdateThread();
 
     KillTimer(hwnd, TIMER_ID_MAIN);
+    KillTimer(hwnd, TIMER_ID_TOPMOST_ENFORCE);
     extern UINT GetClickThroughTimerId(void);
     KillTimer(hwnd, GetClickThroughTimerId());
     LOG_INFO("Timers stopped");