config: add fallback output mode

toml-spec/spec/spec.generated.json

@@ -1068,6 +1068,10 @@
         "simple-im": {
           "description": "Configures the simple, XCompose based input method.\n\nBy default, the input method is enabled. \n\nEven if the input method is enabled, it will only be used if there is no\nrunning external IM.\n\n- Example:\n\n  ```toml\n  [simple-im]\n  enabled = false\n  ```\n",
           "$ref": "#/$defs/SimpleIm"
+        },
+        "fallback-output-mode": {
+          "description": "Sets the fallback output mode.\n\nThe default is `cursor`.\n\n- Example:\n\n  ```toml\n  fallback-output-mode = \"focus\"\n  ```\n",
+          "$ref": "#/$defs/FallbackOutputMode"
         }
       },
       "required": []
@@ -1284,6 +1288,14 @@
         }
       ]
     },
+    "FallbackOutputMode": {
+      "type": "string",
+      "description": "Defines which output is used when no particular output is specified.\n\nThis configures where to place a newly opened window or workspace, what window to focus when a\nwindow is closed, which workspace is moved with move-to-output, and similar actions.\n",
+      "enum": [
+        "cursor",
+        "focus"
+      ]
+    },
     "Float": {
       "description": "Describes settings of floating windows.\n\n- Example:\n\n  ```toml\n  [float]\n  show-pin-icon = true\n  ```\n",
       "type": "object",

toml-spec/spec/spec.generated.md

@@ -2218,6 +2218,20 @@ The table has the following fields:
 
   The value of this field should be a [SimpleIm](#types-SimpleIm).
 
+- `fallback-output-mode` (optional):
+
+  Sets the fallback output mode.
+  
+  The default is `cursor`.
+  
+  - Example:
+  
+    ```toml
+    fallback-output-mode = "focus"
+    ```
+
+  The value of this field should be a [FallbackOutputMode](#types-FallbackOutputMode).
+
 
 <a name="types-Connector"></a>
 ### `Connector`
@@ -2694,6 +2708,28 @@ The table has the following fields:
   The value of this field should be a boolean.
 
 
+<a name="types-FallbackOutputMode"></a>
+### `FallbackOutputMode`
+
+Defines which output is used when no particular output is specified.
+
+This configures where to place a newly opened window or workspace, what window to focus when a
+window is closed, which workspace is moved with move-to-output, and similar actions.
+
+Values of this type should be strings.
+
+The string should have one of the following values:
+
+- `cursor`:
+
+  Use the output the cursor is on.
+
+- `focus`:
+
+  Use the output the focus is on (highlighted window).
+
+
+
 <a name="types-Float"></a>
 ### `Float`
 

toml-spec/spec/spec.yaml

@@ -2986,6 +2986,19 @@ Config:
           [simple-im]
           enabled = false
           ```
+    fallback-output-mode:
+      ref: FallbackOutputMode
+      required: false
+      description: |
+        Sets the fallback output mode.
+       
+        The default is `cursor`.
+
+        - Example:
+
+          ```toml
+          fallback-output-mode = "focus"
+          ```
 
 
 Idle:
@@ -4351,3 +4364,17 @@ BarPosition:
       description: The bar is at the top of the output.
     - value: bottom
       description: The bar is at the bottom of the output.
+
+
+FallbackOutputMode:
+  kind: string
+  description: |
+    Defines which output is used when no particular output is specified.
+    
+    This configures where to place a newly opened window or workspace, what window to focus when a
+    window is closed, which workspace is moved with move-to-output, and similar actions.
+  values:
+    - value: cursor
+      description: Use the output the cursor is on.
+    - value: focus
+      description: Use the output the focus is on (highlighted window).