feat: implement VSCode-style -command unbinding for keybindings

Both unbinding mechanisms now work:
- "-block:close" prefix removes all default keys for that command
- { key: null, command: "block:close" } does the same thing
Both append null-handler entries that shadow defaults via reverse iteration.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: mswiszcz

docs/docs/keybindings.mdx

@@ -132,6 +132,13 @@ Key combinations use colon-separated format:
 
 **Disable a keybinding:** Remove <Kbd k="Cmd:w"/> close block:
 ```json
+[
+  { "command": "-block:close" }
+]
+```
+
+You can also set `key` to `null` to unbind:
+```json
 [
   { "key": null, "command": "block:close" }
 ]

frontend/app/store/keymodel.ts

@@ -51,7 +51,7 @@ type ChordActionDef = {
     handler: KeyHandler;
 };
 
-type KeyMapEntry<T = KeyHandler> = { key: string; handler: T };
+type KeyMapEntry<T = KeyHandler> = { key: string; handler: T | null };
 type ChordEntry = { key: string; subKeys: KeyMapEntry[] };
 
 const simpleControlShiftAtom = jotai.atom(false);
@@ -442,10 +442,14 @@ async function handleSplitVertical(position: "before" | "after") {
 let lastHandledEvent: KeyboardEvent | null = null;
 
 // returns [keymatch, T] — iterates in reverse so later entries (user overrides) win
+// a null handler means the key was explicitly unbound (via -command)
 function checkKeyArray<T>(waveEvent: WaveKeyboardEvent, entries: KeyMapEntry<T>[]): [string, T] {
     for (let i = entries.length - 1; i >= 0; i--) {
         const entry = entries[i];
         if (keyutil.checkKeyPressed(waveEvent, entry.key)) {
+            if (entry.handler == null) {
+                return [null, null]; // unbound
+            }
             return [entry.key, entry.handler];
         }
     }
@@ -910,9 +914,28 @@ function buildKeyMaps(userOverrides: KeybindingEntry[]): void {
             console.warn(`Skipping keybinding entry with invalid key type for command: ${override.command}`);
             continue;
         }
+        // Handle -command unbinding (VSCode convention)
+        if (override.command.startsWith("-")) {
+            const commandId = override.command.substring(1);
+            const action = defaultActions.find((a) => a.id === commandId);
+            if (action) {
+                // Append null-handler entries for all default keys to shadow them
+                for (const key of action.defaultKeys) {
+                    bindings.push({ key, handler: null });
+                }
+            }
+            continue;
+        }
         const commandId = override.command;
         if (override.key == null) {
-            continue; // null key = no binding, handled by reverse iteration skipping
+            // null key = unbind all default keys for this command
+            const action = defaultActions.find((a) => a.id === commandId);
+            if (action) {
+                for (const key of action.defaultKeys) {
+                    bindings.push({ key, handler: null });
+                }
+            }
+            continue;
         }
         const handler = actionHandlers.get(commandId);
         if (handler) {

schema/keybindings.json

@@ -14,7 +14,7 @@
       },
       "command": {
         "type": "string",
-        "description": "Action ID to bind.",
+        "description": "Action ID to bind. Prefix with '-' to unbind all default keys for that action.",
         "enum": [
           "tab:new", "tab:close", "tab:prev", "tab:next",
           "tab:switchto1", "tab:switchto2", "tab:switchto3", "tab:switchto4", "tab:switchto5",
@@ -29,7 +29,21 @@
           "block:splitchord", "block:splitchordup", "block:splitchorddown", "block:splitchordleft", "block:splitchordright",
           "app:search", "app:openconnection", "app:toggleaipanel", "app:togglewidgetssidebar",
           "term:togglemultiinput",
-          "generic:cancel"
+          "generic:cancel",
+          "-tab:new", "-tab:close", "-tab:prev", "-tab:next",
+          "-tab:switchto1", "-tab:switchto2", "-tab:switchto3", "-tab:switchto4", "-tab:switchto5",
+          "-tab:switchto6", "-tab:switchto7", "-tab:switchto8", "-tab:switchto9",
+          "-block:new", "-block:close", "-block:splitright", "-block:splitdown",
+          "-block:magnify", "-block:refocus",
+          "-block:navup", "-block:navdown", "-block:navleft", "-block:navright",
+          "-block:focusnext", "-block:focusprev",
+          "-block:switchto1", "-block:switchto2", "-block:switchto3", "-block:switchto4", "-block:switchto5",
+          "-block:switchto6", "-block:switchto7", "-block:switchto8", "-block:switchto9", "-block:switchtoai",
+          "-block:replacewithlauncher",
+          "-block:splitchord", "-block:splitchordup", "-block:splitchorddown", "-block:splitchordleft", "-block:splitchordright",
+          "-app:search", "-app:openconnection", "-app:toggleaipanel", "-app:togglewidgetssidebar",
+          "-term:togglemultiinput",
+          "-generic:cancel"
         ]
       }
     },