Refactor methods and add mouse position model

Updated using directives in PublicExtensions.cs and UiaDriverTests.cs. Renamed several methods to use User32 naming convention. Added MoveUser32Mouse method for native mouse operations. Removed redundant check in WebDriverBase.cs. Introduced MousePositionInputModel class in G4.WebDriver.Models.

Author: gravity-api

src/G4.WebDriver.Remote.Uia/Extensions/PublicExtensions.cs

@@ -1,11 +1,10 @@
-using G4.WebDriver.Remote;
+using G4.WebDriver.Models;
+using G4.WebDriver.Remote;
 
 using System.Collections.Generic;
 using System.Net.Http;
-using System.Reflection;
 using System.Text.Json;
 
-#pragma warning disable S3011 // Necessary to interact with internal fields for sending native actions.
 namespace G4.WebDriver.Extensions
 {
     /// <summary>
@@ -29,7 +28,7 @@ public static class UiaExtensions
         /// <param name="element">The web element to get the attribute from.</param>
         /// <param name="name">The name of the attribute.</param>
         /// <returns>The attribute value as a string.</returns>
-        public static string GetUiaAttribute(this IWebElement element, string name)
+        public static string GetUser32Attribute(this IWebElement element, string name)
         {
             // Get the session ID and element ID from the web element
             var (sessionId, elementId) = GetRouteData(element);
@@ -63,11 +62,61 @@ public static string GetUiaAttribute(this IWebElement element, string name)
             return isValue ? $"{value}" : string.Empty;
         }
 
+        /// <summary>
+        /// Moves the mouse pointer over the specified web element using default mouse position data.
+        /// </summary>
+        /// <param name="element">The target web element over which the mouse will be moved.</param>
+        /// <remarks>This method is designed for Windows environments only, utilizing the user32.dll for native mouse operations.</remarks>
+        public static void MoveUser32Mouse(this IWebElement element)
+        {
+            // Call the overload with a default MousePositionInputModel.
+            MoveUser32Mouse(element, new MousePositionInputModel());
+        }
+
+        /// <summary>
+        /// Moves the mouse pointer over the specified web element using the provided mouse position data.
+        /// </summary>
+        /// <param name="element">The target web element over which the mouse will be moved.</param>
+        /// <param name="positionData">The mouse position data to use when moving the mouse.</param>
+        /// <remarks>This method is designed for Windows environments only, utilizing the user32.dll for native mouse operations.</remarks>
+        public static void MoveUser32Mouse(this IWebElement element, MousePositionInputModel positionData)
+        {
+            // Retrieve the session ID and element ID from the web element for routing.
+            var (sessionId, elementId) = GetRouteData(element);
+
+            // Retrieve the WebDriver instance associated with the element.
+            var driver = element.Driver;
+
+            // Get the URI of the remote server from the command executor.
+            var url = GetRemoteServerUri(driver);
+
+            // Construct the request URI for the native mouse move command.
+            var requestUri = $"{url}/session/{sessionId}/user32/element/{elementId}/mouse/move";
+
+            // Serialize the mouse position input model to JSON.
+            var jsonData = JsonSerializer.Serialize(positionData, JsonSerializerOptions);
+
+            // Create the HTTP content using the serialized JSON, specifying the content type.
+            var content = new StringContent(jsonData, System.Text.Encoding.UTF8, "application/json");
+
+            // Construct the HTTP POST request with the target URI and content.
+            var request = new HttpRequestMessage(HttpMethod.Post, requestUri)
+            {
+                Content = content
+            };
+
+            // Send the HTTP request to move the mouse.
+            var response = HttpClient.Send(request);
+
+            // Ensure that the HTTP response indicates a successful request.
+            response.EnsureSuccessStatusCode();
+        }
+
         /// <summary>
         /// Sends a native click command to a web element.
         /// </summary>
         /// <param name="element">The web element to click.</param>
-        public static void SendNativeClick(this IWebElement element)
+        public static void SendUser32Click(this IWebElement element)
         {
             // Get the session ID and element ID from the web element
             var (sessionId, elementId) = GetRouteData(element);
@@ -95,7 +144,7 @@ public static void SendNativeClick(this IWebElement element)
         /// Sends a native double-click command to a web element.
         /// </summary>
         /// <param name="element">The web element to double-click.</param>
-        public static void SendNativeDoubleClick(this IWebElement element)
+        public static void SendUser32DoubleClick(this IWebElement element)
         {
             // Get the session ID and element ID from the web element
             var (sessionId, elementId) = GetRouteData(element);
@@ -123,7 +172,7 @@ public static void SendNativeDoubleClick(this IWebElement element)
         /// Sets focus on a web element.
         /// </summary>
         /// <param name="element">The web element to set focus on.</param>
-        public static void SetFocus(this IWebElement element)
+        public static void SetUser32Focus(this IWebElement element)
         {
             // Get the session ID and element ID from the web element
             var (sessionId, elementId) = GetRouteData(element);
@@ -157,8 +206,6 @@ private static string GetRemoteServerUri(IWebDriver driver)
         // Gets the session ID and element ID from a web element.
         private static (string SessionId, string ElementId) GetRouteData(IWebElement element)
         {
-            const BindingFlags bindingFlags = BindingFlags.Instance | BindingFlags.NonPublic;
-
             // Get the WebDriver instance from the web element
             var driver = element.Driver;
 
@@ -169,4 +216,4 @@ private static (string SessionId, string ElementId) GetRouteData(IWebElement ele
             return (sessionId, element.Id);
         }
     }
-}
+}

src/G4.WebDriver.Tests/UiaDriverTests.cs

@@ -1,8 +1,10 @@
-using G4.WebDriver.Models;
+using G4.WebDriver.Extensions;
+using G4.WebDriver.Models;
 using G4.WebDriver.Remote.Uia;
 
 using Microsoft.VisualStudio.TestTools.UnitTesting;
 
+using System;
 using System.IO;
 
 namespace G4.WebDriver.Tests

src/G4.WebDriver/Models/MousePositionInputModel.cs

@@ -0,0 +1,38 @@
+namespace G4.WebDriver.Models
+{
+    /// <summary>
+    /// Represents the input model for specifying a mouse position.
+    /// </summary>
+    public class MousePositionInputModel
+    {
+        /// <summary>
+        /// Gets or sets the alignment for the mouse position.
+        /// </summary>
+        /// <value>The alignment for the mouse position (e.g., TopLeft, MiddleCenter).</value>
+        public string Alignment { get; set; } = "TopLeft";
+
+        /// <summary>
+        /// Gets or sets the offset from the X-coordinate.
+        /// </summary>
+        /// <value>The offset from the X-coordinate.</value>
+        public int OffsetX { get; set; } = 1;
+
+        /// <summary>
+        /// Gets or sets the offset from the Y-coordinate.
+        /// </summary>
+        /// <value>The offset from the Y-coordinate.</value>
+        public int OffsetY { get; set; } = 1;
+
+        /// <summary>
+        /// Gets or sets the X-coordinate of the mouse position.
+        /// </summary>
+        /// <value>The X-coordinate of the mouse position.</value>
+        public int X { get; set; }
+
+        /// <summary>
+        /// Gets or sets the Y-coordinate of the mouse position.
+        /// </summary>
+        /// <value>The Y-coordinate of the mouse position.</value>
+        public int Y { get; set; }
+    }
+}

src/G4.WebDriver/Remote/WebDriverBase.cs

@@ -55,7 +55,6 @@ void AddCustomCommands()
             AddCustomCommands();
 
             // If a new session is not required, exit the constructor early.
-            
             if (!session.StartNewSession)
             {
                 return;