fix: expose raw mouse button transition

Author: developer239

include/robot/Mouse.h

@@ -51,6 +51,12 @@ class Mouse {
   [[nodiscard]] std::expected<void, Error> press(MouseButton button);
   [[nodiscard]] std::expected<void, Error> release(MouseButton button);
 
+  // Raw button transition with an explicit click count. This is the atom used by
+  // higher-level language bindings that compose multi-click gestures themselves.
+  [[nodiscard]] std::expected<void, Error> button(
+      MouseButton button, ButtonAction action, int clickCount
+  );
+
   // Press then release at the current position. X1/X2 require
   // supportsExtraMouseButtons or the call fails with Unsupported.
   [[nodiscard]] std::expected<void, Error> click(
@@ -82,4 +88,4 @@ class Mouse {
   backend::IMouseBackend* backend_;
 };
 
-}  // namespace robot
+}  // namespace robot

src/common/Mouse.cpp

@@ -62,6 +62,12 @@ std::expected<void, Error> Mouse::release(const MouseButton button) {
   return backend_->button(button, ButtonAction::Up, 1);
 }
 
+std::expected<void, Error> Mouse::button(
+    const MouseButton button, const ButtonAction action, const int clickCount
+) {
+  return backend_->button(button, action, clickCount);
+}
+
 std::expected<void, Error> Mouse::click(const MouseButton button) {
   if (auto r = backend_->button(button, ButtonAction::Down, 1); !r) return r;
   return backend_->button(button, ButtonAction::Up, 1);
@@ -110,4 +116,4 @@ std::expected<void, Error> Mouse::scroll(const ScrollDelta delta) {
   return backend_->scroll(delta);
 }
 
-}  // namespace robot
+}  // namespace robot