config: implement shortcut latching

docs/config.md

@@ -208,6 +208,23 @@ The right-hand side should be an action.
 
 See [spec.generated.md](../toml-spec/spec/spec.generated.md) for a full list of actions.
 
+### Complex Shortcuts
+
+If you need more control over shortcut execution, you can use the `complex-shortcuts` table.
+
+```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"] }
+```
+
+This mutes the audio output while the key is pressed and un-mutes once the `x` key is released.
+The order in which `alt` and `x` are released does not matter for this.
+
+This can also be used to implement push to talk.
+
+See the specification for more details.
+
 ### Running Multiple Actions
 
 In every place that accepts an action, you can also run multiple actions by wrapping them

docs/features.md

@@ -108,6 +108,10 @@ By default, applications only have access to unprivileged protocols.
 
 You can explicitly opt into giving applications access to privileged protocols via the Jay CLI or shortcuts.
 
+## Push to Talk
+
+Jay's shortcut system allows you to execute an action when a key is pressed and to execute a different action when the key is released.
+
 ## Protocol Support
 
 Jay supports the following wayland protocols: