Mike Hall

This commit introduces a **new feature** to the **CursorWrap** utility, allowing users to **disable cursor wrapping automatically when only a single monitor is detected**. This enhances the user experience for those who frequently switch between multi-monitor and single-monitor setups, such as docking and undocking a laptop. The change involves modifications to the core `CursorWrap` logic in `CursorWrapCore.cpp` and `CursorWrapCore.h`, the `MouseUtils` module's `dllmain.cpp`, and integrates a new `DisableCursorWrapOnSingleMonitor` setting into the **PowerToys Settings UI** via `MouseUtilsPage.xaml` and `MouseUtilsViewModel.cs`. This provides greater flexibility and control over cursor behavior based on the current display configuration.

This commit significantly **enhances the CursorWrap module** within **MouseUtils** by introducing **improved multi-monitor support** and a new user-configurable **wrap mode setting**. It refactors the core logic into `CursorWrapCore` and `MonitorTopology` to dynamically update monitor topology, addressing scenarios like closing a laptop lid. Users can now select whether cursor wrapping occurs horizontally, vertically, or both via the **Settings UI**, providing greater control and robustness for this **Mouse Utilities** feature.

This commit introduces **new capabilities** to the `Capture-MonitorLayout.ps1` script, part of the **MouseUtils** module's **CursorWrap** testing. It adds command-line parameters to explicitly control the inclusion of user, machine, and device names in the generated JSON output. By default, these potentially sensitive details are now excluded, enhancing privacy and offering greater flexibility for script users. This **enhancement** also includes a new `-help` parameter for improved script usability, allowing users to customize the output content as needed.

This commit significantly **improves the CursorWrap utility's coordinate mapping** and wrapping behavior, especially for **multi-monitor setups**. It **refactors the monitor topology detection** in `dllmain.cpp` to use an edge-based alignment algorithm, which prevents incorrect cursor wrapping when adjacent monitors exist in coordinate space. This **enhancement** provides a more accurate and intuitive user experience for cursor movement across display boundaries. Additionally, **new testing tools** are introduced within the `CursorWrapTests` module, including PowerShell and Python scripts, to validate monitor layouts and analyze test results for better debugging.

This commit introduces a **new developer tool**, `ModuleLoader.exe`, designed to facilitate **rapid testing of individual PowerToys modules**. This standalone Win32 executable allows developers to load, configure, and interact with PowerToys module DLLs, such as `powertoys.cursorwrap.dll`, outside of the full PowerToys application environment. It provides a console interface to load module settings, register hotkeys, and enable/disable module functionality, significantly streamlining the **PowerToys module development and debugging workflow**. This utility does not integrate with the main PowerToys settings UI but offers a dedicated environment for isolated module validation.

This commit **enhances the CursorWrap module** by modifying its activation behavior to improve user experience. It ensures that the 'Activate on Startup' setting is automatically enabled whenever **CursorWrap** is turned on, streamlining its persistent activation. The `Enable` function in `src/modules/MouseUtils/CursorWrap/dllmain.cpp` now consistently starts the mouse hook, and the **Settings UI** (`src/settings-ui/Settings.UI/ViewModels/MouseUtilsViewModel.cs`) handles the automatic `CursorWrapAutoActivate` setting. This **behavior modification** clarifies that while CursorWrap is active when enabled, its startup behavior is now more intuitive, though manual deactivation of 'Activate on Startup' is still required when CursorWrap is disabled.

This commit introduces the **Cursor Wrap** functionality, a **new capability** within the **PowerToys Mouse Utilities** module. This feature allows the mouse cursor to seamlessly wrap from one edge of a display (or logical display stack) to the opposite edge, improving navigation across single or multi-monitor setups. The implementation includes a dedicated `CursorWrap` module, comprehensive integration into the **PowerToys Settings UI** for user configuration, and support for Group Policy Object (GPO) management. This provides users with an intuitive new way to traverse their screen real estate.

This commit introduces a **new capability** that allows users to seamlessly switch between the **Mouse Pointer Crosshairs** and **Gliding Cursor** features within the **Mouse Module**. It primarily involves modifying the shared underlying state machine and activation logic, particularly in `src/modules/MouseUtils/MousePointerCrosshairs/dllmain.cpp`, to ensure proper state management and cancellation during transitions. This **feature enhancement** improves user experience by enabling direct toggling between these mouse utilities without requiring intermediate deactivation.

This commit introduces a **new capability** to the **Gliding Cursor** feature, enabling users to **cancel** the active gliding sequence. A low-level keyboard hook is implemented within the `MousePointerCrosshairs` module to detect the **Escape key** press. This allows users to interrupt the multi-stage gliding process at any point, immediately resetting its state and improving overall user control.

This commit introduces a **new capability** for the **MousePointerCrosshairs** module, allowing users to configure the crosshairs to display only horizontal, only vertical, or both lines. It addresses issues #24944 and #31817 by integrating a new `CrosshairsOrientation` setting into the **PowerToys Mouse Utilities** configuration. This involves updating the core crosshair rendering logic in `InclusiveCrosshairs.cpp`, extending the settings model via `MousePointerCrosshairsProperties.cs`, and adding a new ComboBox to `MouseUtilsPage.xaml` for user selection, significantly enhancing the tool's flexibility.

This commit **implements the new "Gliding Cursor" accessibility feature** as an extension to the **Mouse Pointer Crosshairs** module. This **new capability** allows users to precisely control cursor movement and perform clicks using a single hotkey, enhancing usability for adaptive input devices. The feature integrates new settings for activation shortcut and speed within the **Mouse Utilities settings UI**, and modifies the core mouse hook logic in `dllmain.cpp` and `InclusiveCrosshairs.cpp` to manage the gliding state and cursor positioning. This provides a significant **accessibility enhancement** by offering an alternative, controlled method for mouse interaction.