Enforce Windows header order and update examples

Added documentation and code changes to ensure windows.h is included before shellapi.h in Windows platform files, with clang-format disabled for header ordering. Updated keyboard example output to remove emoji for consistency. Fixed COM initialization flag in application_windows.cpp and switched to LoadImageW for wide string icon loading.

Author: lijy91

.cursor/rules/platform-implementation.mdc

@@ -43,7 +43,10 @@ Each platform file defines the `Impl` class declared in the cross-platform heade
 #### Windows Example ([platform/windows/window_windows.cpp](mdc:src/platform/windows))
 
 ```cpp
+// clang-format off
 #include <windows.h>
+#include <shellapi.h>
+// clang-format on
 #include "../../window.h"
 
 namespace nativeapi {
@@ -279,7 +282,10 @@ Managers also use PIMPL for platform event monitoring:
 
 ```cpp
 // window_manager_windows.cpp
+// clang-format off
 #include <windows.h>
+#include <shellapi.h>
+// clang-format on
 #include "../../window_manager.h"
 
 namespace nativeapi {
@@ -543,6 +549,32 @@ Use example applications for manual testing:
 - [examples/menu_example/](mdc:examples/menu_example)
 - [examples/tray_icon_example/](mdc:examples/tray_icon_example)
 
+## Windows Platform Header Rules
+
+For all Windows platform implementation files, follow these header inclusion and formatting rules:
+
+### Header Ordering
+
+Always include `windows.h` before `shellapi.h`:
+
+```cpp
+// clang-format off
+#include <windows.h>
+#include <shellapi.h>
+// clang-format on
+```
+
+### Formatting Control
+
+Use `// clang-format off` and `// clang-format on` comments to disable automatic formatting for Windows-specific includes. This prevents formatters from reordering platform-specific headers that must be included in a specific order.
+
+### Rationale
+
+- `windows.h` defines fundamental Windows types and macros
+- `shellapi.h` depends on definitions from `windows.h`
+- Header order matters for Windows API compilation
+- Disabling formatting preserves the required inclusion order
+
 ## Best Practices
 
 1. **Validate handles** - Always check for null/nil/nullptr before using
@@ -552,6 +584,7 @@ Use example applications for manual testing:
 5. **Keep implementations similar** - Same structure across platforms for maintainability
 6. **Document platform quirks** - Note any platform-specific behavior differences
 7. **Test thoroughly** - Each platform has unique edge cases
+8. **Follow Windows header ordering** - Always include `windows.h` before `shellapi.h` with formatting disabled
 
 ## Common Pitfalls
 

examples/keyboard_example/main.cpp

@@ -69,24 +69,24 @@ int main() {
   // Create keyboard monitor
   g_monitor = native_keyboard_monitor_create();
   if (!g_monitor) {
-    std::cout << "❌ Failed to create keyboard monitor\n";
+    std::cout << "Failed to create keyboard monitor\n";
     return 1;
   }
-  std::cout << "✅ Keyboard monitor created successfully\n";
+  std::cout << "Keyboard monitor created successfully\n";
 
   // Set up callbacks
   if (!native_keyboard_monitor_set_callbacks(
           g_monitor, on_key_pressed, on_key_released, on_modifier_keys_changed,
           nullptr)) {
-    std::cout << "❌ Failed to set callbacks\n";
+    std::cout << "Failed to set callbacks\n";
     native_keyboard_monitor_destroy(g_monitor);
     return 1;
   }
-  std::cout << "✅ Callbacks set successfully\n";
+  std::cout << "Callbacks set successfully\n";
 
   // Start monitoring
   if (!native_keyboard_monitor_start(g_monitor)) {
-    std::cout << "❌ Failed to start keyboard monitoring\n";
+    std::cout << "Failed to start keyboard monitoring\n";
     native_keyboard_monitor_destroy(g_monitor);
     return 1;
   }

src/platform/windows/application_windows.cpp

@@ -1,5 +1,7 @@
-#include <shellapi.h>
+// clang-format off
 #include <windows.h>
+#include <shellapi.h>
+// clang-format on
 #include <iostream>
 #include <string>
 #include <vector>
@@ -17,8 +19,7 @@ class Application::Impl {
 
   bool Initialize() {
     // Initialize COM
-    HRESULT hr =
-        CoInitializeEx(nullptr, COINIT_APPMODEL | COINIT_DISABLE_OLE1DDE);
+    HRESULT hr = CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE);
     if (FAILED(hr)) {
       return false;
     }
@@ -100,9 +101,9 @@ class Application::Impl {
     // Convert to wide string
     std::wstring wide_path(icon_path.begin(), icon_path.end());
 
-    // Load icon from file
+    // Load icon from file using LoadImageW for wide strings
     HICON icon =
-        static_cast<HICON>(LoadImage(nullptr, wide_path.c_str(), IMAGE_ICON, 0,
+        static_cast<HICON>(LoadImageW(nullptr, wide_path.c_str(), IMAGE_ICON, 0,
                                      0, LR_LOADFROMFILE | LR_DEFAULTSIZE));
 
     if (!icon) {