config: add mouse-follows-focus option

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