config: add mouse-follows-focus option

toml-spec/spec/spec.generated.json

@@ -1061,6 +1061,10 @@
           "type": "boolean",
           "description": "Configures whether moving the mouse over a window automatically moves the keyboard\nfocus to that window.\n\nThe default is `true`.\n"
         },
+        "unstable-mouse-follows-focus": {
+          "type": "boolean",
+          "description": "Configures whether the mouse cursor is automatically centered on the active window\nwhen focus changes via keyboard commands.\n\nWhen enabled, the cursor will be automatically positioned to the center of the\nactive window when focus changes through keyboard commands such as `focus-left`,\n`focus-right`, `show-workspace`, etc.\n\nThe default is `false`.\n\nThis option is unstable due to various issues. It is not subject to the usual\nsemver guarantees.\n\n- Example:\n\n  ```toml\n  unstable-mouse-follows-focus = true\n  ```\n"
+        },
         "window-management-key": {
           "type": "string",
           "description": "Configures a key that will enable window management mode while pressed.\n\nIn window management mode, floating windows can be moved by pressing the left\nmouse button and all windows can be resize by pressing the right mouse button.\n\n- Example:\n\n  ```toml\n  window-management-key = \"Alt_L\"\n  ```\n"

toml-spec/spec/spec.generated.md

@@ -2076,6 +2076,28 @@ The table has the following fields:
 
   The value of this field should be a boolean.
 
+- `unstable-mouse-follows-focus` (optional):
+
+  Configures whether the mouse cursor is automatically centered on the active window
+  when focus changes via keyboard commands.
+  
+  When enabled, the cursor will be automatically positioned to the center of the
+  active window when focus changes through keyboard commands such as `focus-left`,
+  `focus-right`, `show-workspace`, etc.
+  
+  The default is `false`.
+  
+  This option is unstable due to various issues. It is not subject to the usual
+  semver guarantees.
+  
+  - Example:
+  
+    ```toml
+    unstable-mouse-follows-focus = true
+    ```
+
+  The value of this field should be a boolean.
+
 - `window-management-key` (optional):
 
   Configures a key that will enable window management mode while pressed.

toml-spec/spec/spec.yaml

@@ -2865,6 +2865,27 @@ Config:
         focus to that window.
 
         The default is `true`.
+    unstable-mouse-follows-focus:
+      kind: boolean
+      required: false
+      description: |
+        Configures whether the mouse cursor is automatically centered on the active window
+        when focus changes via keyboard commands.
+
+        When enabled, the cursor will be automatically positioned to the center of the
+        active window when focus changes through keyboard commands such as `focus-left`,
+        `focus-right`, `show-workspace`, etc.
+
+        The default is `false`.
+        
+        This option is unstable due to various issues. It is not subject to the usual
+        semver guarantees.
+
+        - Example:
+
+          ```toml
+          unstable-mouse-follows-focus = true
+          ```
     window-management-key:
       kind: string
       required: false