@@ -415,7 +415,11 @@ export interface KeymapCommand {
   readonly group?: string
   /** Enables or disables the command. */
   readonly enabled?: boolean | (() => boolean)
-  /** Configures automatic binding, or disables it for a named command. */
+  /**
+   * Configures automatic binding, or disables it for a named command.
+   * Release bindings only fire when the terminal reports key releases;
+   * the TUI does not enable release reporting today.
+   */
   readonly bind?: false | string | { key: string; event?: "press" | "release" }
   /** Adds a named command to the command palette. */
   readonly palette?: true
 
@@ -272,6 +272,7 @@ function groupCommands(commands: readonly KeymapCommand[] = []) {
       }
       if (command.palette) throw new Error("Palette commands require an ID")
       if (command.slash) throw new Error("Slash commands require an ID")
+      if (typeof command.bind === "object") throw new Error("Object keymap bindings require an ID")
       if (typeof command.bind !== "string") throw new Error("Inline keymap commands require bind")
       if (!command.bind) throw new Error("Keymap command bindings cannot be empty")
       result.inline.push({ ...command, id: undefined, bind: command.bind })
 
@@ -168,3 +168,9 @@ test("layer object bindings carry release events", async () => {
     app.renderer.destroy()
   }
 })
+
+test("object bindings without an ID fail validation", () => {
+  expect(() => Keymap.validateCommands([{ bind: { key: "f9", event: "release" }, run() {} }])).toThrow(
+    "Object keymap bindings require an ID",
+  )
+})
Original file line number	Diff line number	Diff line change
`@@ -272,6 +272,7 @@ function groupCommands(commands: readonly KeymapCommand[] = []) {`
`272`	`272`	`}`
`273`	`273`	`if (command.palette) throw new Error("Palette commands require an ID")`
`274`	`274`	`if (command.slash) throw new Error("Slash commands require an ID")`
	`275`	`+ if (typeof command.bind === "object") throw new Error("Object keymap bindings require an ID")`
`275`	`276`	`if (typeof command.bind !== "string") throw new Error("Inline keymap commands require bind")`
`276`	`277`	`if (!command.bind) throw new Error("Keymap command bindings cannot be empty")`
`277`	`278`	`result.inline.push({ ...command, id: undefined, bind: command.bind })`