fix(tui): preserve legacy option enter newlines

packages/tui/src/config/v1/keybind.ts

@@ -18,6 +18,7 @@ const BindingObject = Schema.StructWithRest(
   Schema.Struct({
     key: Schema.Union([Schema.String, KeyStroke]),
     event: Schema.optional(Schema.Literals(["press", "release"])),
+    source: Schema.optional(Schema.Literals(["raw", "kitty"])),
     preventDefault: Schema.optional(Schema.Boolean),
     fallthrough: Schema.optional(Schema.Boolean),
   }),
@@ -162,7 +163,7 @@ export const Definitions = {
   display_thinking: keybind("none", "Toggle thinking blocks visibility"),
 
   prompt_submit: keybind("none", "Submit prompt"),
-  prompt_queue: keybind("alt+return", "Queue prompt"),
+  prompt_queue: keybind({ key: "alt+return", source: "kitty" }, "Queue prompt"),
   prompt_editor_context_clear: keybind("none", "Clear editor context"),
   prompt_skills: keybind("none", "Open skill selector"),
   prompt_stash: keybind("none", "Stash prompt"),
@@ -172,7 +173,7 @@ export const Definitions = {
   input_clear: keybind("ctrl+c", "Clear input field"),
   input_paste: keybind({ key: "ctrl+v", preventDefault: false }, "Paste from clipboard"),
   input_submit: keybind("return", "Submit input"),
-  input_newline: keybind("shift+return,ctrl+return,ctrl+j", "Insert newline in input"),
+  input_newline: keybind("shift+return,ctrl+return,alt+return,ctrl+j", "Insert newline in input"),
   input_move_left: keybind("left,ctrl+b", "Move cursor left in input"),
   input_move_right: keybind("right,ctrl+f", "Move cursor right in input"),
   input_move_up: keybind("up", "Move cursor up in input"),

packages/tui/src/context/keymap.tsx

@@ -66,6 +66,32 @@ function Provider(props: ParentProps<{ config?: KeymapConfig }>) {
     }
   }
   const dispose = [
+    keymap.registerBindingFields({
+      source: (source, context) => {
+        if (source !== "raw" && source !== "kitty") throw new Error(`Invalid key source: ${String(source)}`)
+        context.attr("source", source)
+      },
+    }),
+    keymap.appendBindingTransformer((binding, context) => {
+      const source = binding.source
+      if (source !== "raw" && source !== "kitty") return
+      const command = binding.cmd
+      if (!command) return
+      context.add({
+        ...binding,
+        cmd: (commandContext) => {
+          if (commandContext.event.source !== source) return false
+          if (typeof command === "function") return command(commandContext)
+          return commandContext.keymap.runCommand(command, {
+            event: commandContext.event,
+            focused: commandContext.focused,
+            target: commandContext.target,
+            payload: commandContext.payload,
+          })
+        },
+      })
+      context.skipOriginal()
+    }),
     registerCommaBindings(keymap),
     keymap.appendBindingExpander((context) => {
       const key = Object.entries({ enter: "return", esc: "escape", pgdown: "pagedown", pgup: "pageup" }).reduce(

packages/tui/test/keymap.test.tsx

@@ -1,5 +1,6 @@
 /** @jsxImportSource @opentui/solid */
 import { testRender } from "@opentui/solid"
+import type { TextareaRenderable } from "@opentui/core"
 import { expect, test } from "bun:test"
 import { ConfigProvider } from "../src/config"
 import { Keymap } from "../src/context/keymap"
@@ -139,3 +140,39 @@ test("global commands stay reachable when the mode changes", async () => {
     app.renderer.destroy()
   }
 })
+
+test("queues explicit option enter and keeps raw option enter as newline", async () => {
+  async function exercise(kittyKeyboard: boolean) {
+    let area: TextareaRenderable | undefined
+    let queued = 0
+
+    function Harness() {
+      Keymap.createLayer(() => ({
+        priority: 1,
+        commands: [{ id: "prompt.queue", run: () => void queued++ }],
+      }))
+      return <textarea ref={(value) => (area = value)} focused />
+    }
+
+    const app = await testRender(
+      () => (
+        <ConfigProvider config={createTuiResolvedConfig()}>
+          <Keymap.Provider>
+            <Harness />
+          </Keymap.Provider>
+        </ConfigProvider>
+      ),
+      { kittyKeyboard },
+    )
+    try {
+      app.mockInput.pressEnter({ meta: true })
+      await app.renderOnce()
+      return { queued, text: area?.plainText }
+    } finally {
+      app.renderer.destroy()
+    }
+  }
+
+  expect(await exercise(true)).toEqual({ queued: 1, text: "" })
+  expect(await exercise(false)).toEqual({ queued: 0, text: "\n" })
+})

packages/tui/test/mini/runtime.boot.test.ts

@@ -82,8 +82,8 @@ describe("run runtime boot", () => {
     expect(result.keybinds.get("prompt.history.next")?.[0]?.key).toBe("down")
     expect(result.keybinds.get("prompt.clear")?.[0]?.key).toBe("ctrl+c")
     expect(result.keybinds.get("input.submit")?.[0]?.key).toBe("return")
-    expect(result.keybinds.get("input.newline")?.[0]?.key).toBe("shift+return,ctrl+return,ctrl+j")
-    expect(result.keybinds.get("prompt.queue")?.[0]?.key).toBe("alt+return")
+    expect(result.keybinds.get("input.newline")?.[0]?.key).toBe("shift+return,ctrl+return,alt+return,ctrl+j")
+    expect(result.keybinds.get("prompt.queue")?.[0]).toMatchObject({ key: "alt+return", source: "kitty" })
   })
 
   test("preserves disabled leader from resolved tui config", async () => {