update docs

core/tauri/src/app.rs

@@ -597,7 +597,14 @@ macro_rules! shared_app_impl {
         })
       }
 
-      /// Get the cursor position relative to the top-left hand corner of the main monitor.
+      /// Get the cursor position relative to the top-left hand corner of the desktop.
+      ///
+      /// Note that the top-left hand corner of the desktop is not necessarily the same as the screen.
+      /// If the user uses a desktop with multiple monitors,
+      /// the top-left hand corner of the desktop is the top-left hand corner of the main monitor on Windows and macOS
+      /// or the top-left of the leftmost monitor on X11.
+      ///
+      /// The coordinates can be negative if the top-left hand corner of the window is outside of the visible screen region.
       pub fn cursor_position(&self) -> crate::Result<PhysicalPosition<f64>> {
         Ok(match self.runtime() {
           RuntimeOrDispatch::Runtime(h) => h.cursor_position()?,

core/tauri/src/webview/mod.rs

@@ -895,7 +895,14 @@ impl<R: Runtime> Webview<R> {
     self.webview.dispatcher.print().map_err(Into::into)
   }
 
-  /// Get the cursor position relative to the top-left hand corner of the main monitor.
+  /// Get the cursor position relative to the top-left hand corner of the desktop.
+  ///
+  /// Note that the top-left hand corner of the desktop is not necessarily the same as the screen.
+  /// If the user uses a desktop with multiple monitors,
+  /// the top-left hand corner of the desktop is the top-left hand corner of the main monitor on Windows and macOS
+  /// or the top-left of the leftmost monitor on X11.
+  ///
+  /// The coordinates can be negative if the top-left hand corner of the window is outside of the visible screen region.
   pub fn cursor_position(&self) -> crate::Result<PhysicalPosition<f64>> {
     self.app_handle.cursor_position()
   }

core/tauri/src/webview/webview_window.rs

@@ -1224,7 +1224,14 @@ impl<R: Runtime> WebviewWindow<R> {
 /// Desktop window getters.
 #[cfg(desktop)]
 impl<R: Runtime> WebviewWindow<R> {
-  /// Get the cursor position relative to the top-left hand corner of the main monitor.
+  /// Get the cursor position relative to the top-left hand corner of the desktop.
+  ///
+  /// Note that the top-left hand corner of the desktop is not necessarily the same as the screen.
+  /// If the user uses a desktop with multiple monitors,
+  /// the top-left hand corner of the desktop is the top-left hand corner of the main monitor on Windows and macOS
+  /// or the top-left of the leftmost monitor on X11.
+  ///
+  /// The coordinates can be negative if the top-left hand corner of the window is outside of the visible screen region.
   pub fn cursor_position(&self) -> crate::Result<PhysicalPosition<f64>> {
     self.webview.cursor_position()
   }

core/tauri/src/window/mod.rs

@@ -1556,7 +1556,14 @@ impl<R: Runtime> Window<R> {
 /// Desktop window getters.
 #[cfg(desktop)]
 impl<R: Runtime> Window<R> {
-  /// Get the cursor position relative to the top-left hand corner of the main monitor.
+  /// Get the cursor position relative to the top-left hand corner of the desktop.
+  ///
+  /// Note that the top-left hand corner of the desktop is not necessarily the same as the screen.
+  /// If the user uses a desktop with multiple monitors,
+  /// the top-left hand corner of the desktop is the top-left hand corner of the main monitor on Windows and macOS
+  /// or the top-left of the leftmost monitor on X11.
+  ///
+  /// The coordinates can be negative if the top-left hand corner of the window is outside of the visible screen region.
   pub fn cursor_position(&self) -> crate::Result<PhysicalPosition<f64>> {
     self.app_handle.cursor_position()
   }

tooling/api/src/window.ts

@@ -2256,11 +2256,13 @@ async function availableMonitors(): Promise<Monitor[]> {
   )
 }
 
-/** Get the cursor position relative to the top-left hand corner of the desktop.
+/**
+ * Get the cursor position relative to the top-left hand corner of the desktop.
  *
  * Note that the top-left hand corner of the desktop is not necessarily the same as the screen.
  * If the user uses a desktop with multiple monitors,
- * the top-left hand corner of the desktop is the top-left hand corner of the monitor at the top-left of the desktop.
+ * the top-left hand corner of the desktop is the top-left hand corner of the main monitor on Windows and macOS
+ * or the top-left of the leftmost monitor on X11.
  *
  * The coordinates can be negative if the top-left hand corner of the window is outside of the visible screen region.
  */