(#3357) provide a mechanism to move the cursor to a position immediately

[mattkae]

What's new?

Compositor implementers can now control the cursor like so:

bool FloatingWindowManagerPolicy::handle_keyboard_event(MirKeyboardEvent const* event)
{
    // ...

    auto const action = mir_keyboard_event_action(event);
    auto const scan_code = mir_keyboard_event_scan_code(event);
    auto const modifiers = mir_keyboard_event_modifiers(event) & modifier_mask;

    if (action == mir_keyboard_action_down && modifiers == mir_input_event_modifier_alt && scan_code == KEY_0)
    {
        tools.move_cursor_to(mir::geometry::PointF(0, 0)); // Move the cursor to top left corner
    }

    // ...
}

All bounds checking is handled by the internal input code, so no need for bounds checking at the interface layer :)

[codecov]

Codecov Report

Attention: Patch coverage is 33.33333% with 26 lines in your changes are missing coverage. Please review.

Project coverage is 77.50%. Comparing base (4128d65) to head (0b981ae).
Report is 21 commits behind head on main.

Files	Patch %	Lines
src/miral/basic_window_manager.cpp	30.00%	14 Missing ⚠️
src/miral/window_management_trace.cpp	0.00%	6 Missing ⚠️
src/miral/set_window_management_policy.cpp	50.00%	2 Missing ⚠️
src/miral/window_management_options.cpp	0.00%	2 Missing ⚠️
src/miral/window_manager_tools.cpp	0.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3370      +/-   ##
==========================================
- Coverage   77.52%   77.50%   -0.03%     
==========================================
  Files        1065     1066       +1     
  Lines       67869    67937      +68     
==========================================
+ Hits        52618    52657      +39     
- Misses      15251    15280      +29     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.