config: add Seat::show_workspace_on

toml-spec/spec/spec.generated.json

@@ -125,7 +125,7 @@
               ]
             },
             {
-              "description": "Switches to a workspace.\n\n- Example:\n\n  ```toml\n  [shortcuts]\n  alt-F1 = { type = \"show-workspace\", name = \"1\" }\n  ```\n",
+              "description": "Switches to a workspace.\n\n- Example 1:\n\n  ```toml\n  [shortcuts]\n  alt-F1 = { type = \"show-workspace\", name = \"1\" }\n  ```\n\n- Example 2:\n\n  ```toml\n  [shortcuts]\n  alt-F1 = { type = \"show-workspace\", name = \"1\", output.name = \"left\" }\n  ```\n",
               "type": "object",
               "properties": {
                 "type": {
@@ -134,6 +134,10 @@
                 "name": {
                   "type": "string",
                   "description": "The name of the workspace."
+                },
+                "output": {
+                  "description": "The output to show a newly created workspace on. This has no effect on\nworkspaces that already exist.\n\nIf this is not set, then a new workspace is shown on the output that\ncontains the cursor.\n\nIf multiple outputs match, the workspace is shown on the first matching\noutput.\n",
+                  "$ref": "#/$defs/OutputMatch"
                 }
               },
               "required": [

toml-spec/spec/spec.generated.md

@@ -232,12 +232,19 @@ This table is a tagged union. The variant is determined by the `type` field. It
 
   Switches to a workspace.
   
-  - Example:
+  - Example 1:
   
     ```toml
     [shortcuts]
     alt-F1 = { type = "show-workspace", name = "1" }
     ```
+  
+  - Example 2:
+  
+    ```toml
+    [shortcuts]
+    alt-F1 = { type = "show-workspace", name = "1", output.name = "left" }
+    ```
 
   The table has the following fields:
 
@@ -247,6 +254,19 @@ This table is a tagged union. The variant is determined by the `type` field. It
 
     The value of this field should be a string.
 
+  - `output` (optional):
+
+    The output to show a newly created workspace on. This has no effect on
+    workspaces that already exist.
+    
+    If this is not set, then a new workspace is shown on the output that
+    contains the cursor.
+    
+    If multiple outputs match, the workspace is shown on the first matching
+    output.
+
+    The value of this field should be a [OutputMatch](#types-OutputMatch).
+
 - `move-to-workspace`:
 
   Moves the currently focused window to a workspace.

toml-spec/spec/spec.yaml

@@ -239,17 +239,36 @@ Action:
           description: |
             Switches to a workspace.
             
-            - Example:
+            - Example 1:
             
               ```toml
               [shortcuts]
               alt-F1 = { type = "show-workspace", name = "1" }
               ```
+            
+            - Example 2:
+            
+              ```toml
+              [shortcuts]
+              alt-F1 = { type = "show-workspace", name = "1", output.name = "left" }
+              ```
           fields:
             name:
               description: The name of the workspace.
               required: true
               kind: string
+            output:
+              description: |
+                The output to show a newly created workspace on. This has no effect on
+                workspaces that already exist.
+                
+                If this is not set, then a new workspace is shown on the output that
+                contains the cursor.
+                
+                If multiple outputs match, the workspace is shown on the first matching
+                output.
+              required: false
+              ref: OutputMatch
         move-to-workspace:
           description: |
             Moves the currently focused window to a workspace.