config: allow consuming/forwarding key events

toml-spec/spec/spec.generated.json

@@ -1053,6 +1053,8 @@
         "quit",
         "reload-config-toml",
         "reload-config-to",
+        "consume",
+        "forward",
         "none"
       ]
     },

toml-spec/spec/spec.generated.md

@@ -2224,6 +2224,26 @@ The string should have one of the following values:
 
   Reload the `config.so`.
 
+- `consume`:
+
+  Consume the current key event. Don't forward it to the focused application.
+  
+  This action only has an effect in shortcuts.
+  
+  Key-press events events that trigger shortcuts are consumed by default.
+  Key-release events events that trigger shortcuts are forwarded by default.
+  
+  Note that consuming key-release events can cause keys to get stuck in the focused
+  application.
+  
+  See the `forward` action to achieve the opposite effect.
+
+- `forward`:
+
+  Forward the current key event to the focused application.
+  
+  See the `consume` action for more details.
+
 - `none`:
 
   Perform no action.

toml-spec/spec/spec.yaml

@@ -668,6 +668,24 @@ SimpleActionName:
       description: Reload the `config.toml`.
     - value: reload-config-to
       description: Reload the `config.so`.
+    - value: consume
+      description: |
+        Consume the current key event. Don't forward it to the focused application.
+        
+        This action only has an effect in shortcuts.
+        
+        Key-press events events that trigger shortcuts are consumed by default.
+        Key-release events events that trigger shortcuts are forwarded by default.
+        
+        Note that consuming key-release events can cause keys to get stuck in the focused
+        application.
+        
+        See the `forward` action to achieve the opposite effect.
+    - value: forward
+      description: |
+        Forward the current key event to the focused application.
+        
+        See the `consume` action for more details.
     - value: none
       description: |
         Perform no action.