config: implement shortcut latching

toml-spec/spec/spec.generated.json

@@ -438,6 +438,10 @@
         "action": {
           "description": "The action to execute.\n\nOmitting this is the same as setting it to `\"none\"`.\n",
           "$ref": "#/$defs/Action"
+        },
+        "latch": {
+          "description": "An action to execute when the key is released.\n\nThis registers an action to be executed when the key triggering the shortcut is\nreleased. The active modifiers are ignored for this purpose.\n\n- Example:\n\n  To mute audio while the key is pressed:\n\n  ```toml\n  [complex-shortcuts.alt-x]\n  action = { type = \"exec\", exec = [\"pactl\", \"set-sink-mute\", \"0\", \"1\"] }\n  latch = { type = \"exec\", exec = [\"pactl\", \"set-sink-mute\", \"0\", \"0\"] }\n  ```\n\n  Audio will be un-muted once `x` key is released, regardless of any other keys\n  that are pressed at the time.\n",
+          "$ref": "#/$defs/Action"
         }
       },
       "required": []

toml-spec/spec/spec.generated.md

@@ -639,6 +639,28 @@ The table has the following fields:
 
   The value of this field should be a [Action](#types-Action).
 
+- `latch` (optional):
+
+  An action to execute when the key is released.
+  
+  This registers an action to be executed when the key triggering the shortcut is
+  released. The active modifiers are ignored for this purpose.
+  
+  - Example:
+  
+    To mute audio while the key is pressed:
+  
+    ```toml
+    [complex-shortcuts.alt-x]
+    action = { type = "exec", exec = ["pactl", "set-sink-mute", "0", "1"] }
+    latch = { type = "exec", exec = ["pactl", "set-sink-mute", "0", "0"] }
+    ```
+  
+    Audio will be un-muted once `x` key is released, regardless of any other keys
+    that are pressed at the time.
+
+  The value of this field should be a [Action](#types-Action).
+
 
 <a name="types-Config"></a>
 ### `Config`

toml-spec/spec/spec.yaml

@@ -2131,3 +2131,24 @@ ComplexShortcut:
         The action to execute.
         
         Omitting this is the same as setting it to `"none"`.
+    latch:
+      ref: Action
+      required: false
+      description: |
+        An action to execute when the key is released.
+        
+        This registers an action to be executed when the key triggering the shortcut is
+        released. The active modifiers are ignored for this purpose.
+        
+        - Example:
+        
+          To mute audio while the key is pressed:
+        
+          ```toml
+          [complex-shortcuts.alt-x]
+          action = { type = "exec", exec = ["pactl", "set-sink-mute", "0", "1"] }
+          latch = { type = "exec", exec = ["pactl", "set-sink-mute", "0", "0"] }
+          ```
+        
+          Audio will be un-muted once `x` key is released, regardless of any other keys
+          that are pressed at the time.