(Positioner) Allow for Screen constrained positioning when using tray-icon feature

.changes/positioner-move-window-constrained-js.md

@@ -0,0 +1,6 @@
+---
+"positioner-js": minor
+---
+
+Add `moveWindowConstrained` function that is similar to `moveWindow` but constrains the window to the screen dimensions in case of tray icon positions.
+

.changes/positioner-move-window-constrained.md

@@ -0,0 +1,6 @@
+---
+"positioner": minor
+---
+
+Add `WindowExt::move_window_constrained` method that is similar to `WindowExt::move_window` but constrains the window to the screen dimensions in case of tray icon positions.
+

plugins/positioner/build.rs

@@ -2,7 +2,11 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-License-Identifier: MIT
 
-const COMMANDS: &[&str] = &["move_window", "set_tray_icon_state"];
+const COMMANDS: &[&str] = &[
+    "move_window",
+    "move_window_constrained",
+    "set_tray_icon_state",
+];
 
 fn main() {
     tauri_plugin::Builder::new(COMMANDS)

plugins/positioner/guest-js/index.ts

@@ -39,6 +39,19 @@ export async function moveWindow(to: Position): Promise<void> {
   })
 }
 
+/**
+ * Moves the `Window` to the given {@link Position} using `WindowExt.move_window_constrained()`
+ *
+ * This move operation constrains the window to the screen dimensions in case of
+ * tray-icon positions.
+ * @param to The (tray) {@link Position} to move to.
+ */
+export async function moveWindowConstrained(to: Position): Promise<void> {
+  await invoke('plugin:positioner|move_window_constrained', {
+    position: to
+  })
+}
+
 export async function handleIconState(event: TrayIconEvent): Promise<void> {
   await invoke('plugin:positioner|set_tray_icon_state', {
     position: event.rect.position,

plugins/positioner/permissions/autogenerated/commands/move_window_constrained.toml

@@ -0,0 +1,13 @@
+# Automatically generated - DO NOT EDIT!
+
+"$schema" = "../../schemas/schema.json"
+
+[[permission]]
+identifier = "allow-move-window-constrained"
+description = "Enables the move_window_constrained command without any pre-configured scope."
+commands.allow = ["move_window_constrained"]
+
+[[permission]]
+identifier = "deny-move-window-constrained"
+description = "Denies the move_window_constrained command without any pre-configured scope."
+commands.deny = ["move_window_constrained"]

plugins/positioner/permissions/autogenerated/reference.md

@@ -3,7 +3,8 @@
 Allows the moveWindow and handleIconState APIs
 
 - `allow-move-window`
-- `set-tray-icon-state`
+- `allow-move-window-constrained`
+- `allow-set-tray-icon-state`
 
 ## Permission Table
 
@@ -43,6 +44,32 @@ Denies the move_window command without any pre-configured scope.
 <tr>
 <td>
 
+`positioner:allow-move-window-constrained`
+
+</td>
+<td>
+
+Enables the move_window_constrained command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+`positioner:deny-move-window-constrained`
+
+</td>
+<td>
+
+Denies the move_window_constrained command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
 `positioner:allow-set-tray-icon-state`
 
 </td>

plugins/positioner/permissions/default.toml

@@ -1,4 +1,8 @@
 "$schema" = "schemas/schema.json"
 [default]
 description = "Allows the moveWindow and handleIconState APIs"
-permissions = ["allow-move-window", "set-tray-icon-state"]
+permissions = [
+    "allow-move-window",
+    "allow-move-window-constrained",
+    "allow-set-tray-icon-state",
+]

plugins/positioner/permissions/schemas/schema.json

@@ -304,6 +304,16 @@
           "type": "string",
           "const": "deny-move-window"
         },
+        {
+          "description": "Enables the move_window_constrained command without any pre-configured scope.",
+          "type": "string",
+          "const": "allow-move-window-constrained"
+        },
+        {
+          "description": "Denies the move_window_constrained command without any pre-configured scope.",
+          "type": "string",
+          "const": "deny-move-window-constrained"
+        },
         {
           "description": "Enables the set_tray_icon_state command without any pre-configured scope.",
           "type": "string",