Update the docs for version 7.0.3

Author: TolikPylypchuk

CHANGELOG.md

@@ -1,5 +1,12 @@
 # SharpHook Changelog
 
+## [v7.0.3](https://github.com/TolikPylypchuk/SharpHook/releases/tag/v7.0.3) (October 5, 2025)
+
+- Mouse button release events for button 4 and 5 are now correctly dispatched on macOS.
+
+- libuiohook was updated to commit
+[b1888a6](https://github.com/TolikPylypchuk/libuiohook/tree/b1888a65ebe1705d92e9c1916e81b52083876007).
+
 ## [v7.0.2](https://github.com/TolikPylypchuk/SharpHook/releases/tag/v7.0.2) (September 21, 2025)
 
 - Mouse move events are not dropped based on previous click positions on Windows anymore.

docs/articles/about.md

@@ -55,6 +55,13 @@ You need .NET 9 to build SharpHook.
 
 ## Changelog
 
+### [v7.0.3](https://github.com/TolikPylypchuk/SharpHook/releases/tag/v7.0.3) (October 5, 2025)
+
+- Mouse button release events for button 4 and 5 are now correctly dispatched on macOS.
+
+- libuiohook was updated to commit
+[b1888a6](https://github.com/TolikPylypchuk/libuiohook/tree/b1888a65ebe1705d92e9c1916e81b52083876007).
+
 ### [v7.0.2](https://github.com/TolikPylypchuk/SharpHook/releases/tag/v7.0.2) (September 21, 2025)
 
 - Mouse move events are not dropped based on previous click positions on Windows anymore.

docs/articles/os-constraints.md

@@ -75,7 +75,46 @@ On macOS running the global hook requires that the main run-loop be present. lib
 is run on the main thread. It's also taken care of by UI frameworks since they need an event loop on the main thread
 to run. But if you're using a global hook in a console app or a background service and want to run it on some thread
 other than the main one then you should take care of it yourself. You can do that by P/Invoking the native
-`CFRunLoopRun` function on the main thread.
+`CFRunLoopRun` function on the main thread:
+
+
+```c#
+internal static partial class CoreFoundation
+{
+    private const string CoreFoundationLib = "/System/Library/Frameworks/CoreFoundation.framework/CoreFoundation";
+
+    [LibraryImport(CoreFoundationLib)]
+    public static partial void CFRelease(IntPtr @ref);
+
+    // It's better to use a type derived from SafeHandle as the return type, but it's omitted for brevity
+    [LibraryImport(CoreFoundationLib)]
+    public static partial IntPtr CFRunLoopGetCurrent();
+
+    [LibraryImport(CoreFoundationLib)]
+    public static partial void CFRunLoopRun();
+
+    [LibraryImport(CoreFoundationLib)]
+    public static partial void CFRunLoopStop(IntPtr rl);
+}
+
+// ...
+
+// This method must be called on the main thread
+public static void RunMainLoop(CancellationToken token)
+{
+    var loop = CoreFoundation.CFRunLoopGetCurrent();
+    token.Register(() => CoreFoundation.CFRunLoopStop(loop));
+    CoreFoundation.CFRunLoopRun(); // This method will block the current thread until CFRunLoopStop is called
+    CoreFoundation.CFRelease(loop); // Ideally, this method should be called when a SafeHandle is released instead
+}
+
+// ...
+
+var tokenSource = new CancellationTokenSource();
+hook.HookDisabled += (sender, e) => tokenSource.Cancel();
+_ = hook.RunAsync(); // Ignore the result of RunAsync, do not await it
+RunMainLoop(tokenSource.Token);
+```
 
 ### Simulating Multiple Mouse Clicks