refactor(tui): drop keymap narration

Author: TheGreatAxios

docs/TUI-keymap-eval.md

@@ -6,7 +6,7 @@ Decision record for application key bindings on `@opentui/core` 0.6.6. The engin
 
 **Adopt** `@opentui/keymap` for application commands. Do not move widget-local editing, the scroll lease, or the kill ring into it.
 
-`createDefaultOpenTuiKeymap(renderer)` installs the default parser, the event matcher, and the enabled and metadata fields. The shell registers one layer. Each command `run` calls one existing function. There is no parallel key switch. Help lines are the keymap's registered `desc` values plus the widget-default rows.
+`keymapFor` builds `new Keymap(guardHost(renderer))`, then registers the default parser, the enabled fields, and the metadata fields. The shell registers one layer. Each command `run` calls one existing function. There is no parallel key switch. Help lines are the keymap's registered `desc` values plus the widget-default rows.
 
 Textarea defaults are not registered again. `renderables/Textarea.d.ts` `TextareaAction` and the shipped `defaultTextareaKeyBindings` already cover cursor motion, word motion, Ctrl+D, Ctrl+K/U/W, and Alt+D. `PROMPT_KEY_BINDINGS` already maps Enter to submit and Ctrl+Enter / Ctrl+J / Shift+Enter to newline. The kill ring only diffs those deletes and yanks.
 

src/tui/keybindings.ts

@@ -3,7 +3,6 @@
  * registration (`bindAppHelp`). Widget-default rows are the Textarea chords
  * `defaultTextareaKeyBindings` / `PROMPT_KEY_BINDINGS` already perform, plus
  * the kill-ring yank chords the textarea does not implement.
- * There is no second copy of the application chord table here.
  */
 
 export interface ShellShortcut {
@@ -80,7 +79,6 @@ let appRows: readonly ShellShortcut[] = [];
 let readAppHelp: () => readonly string[] = () =>
   appRows.map((row) => `${row.keys} — ${row.description}`);
 
-/** Called when the keymap module loads, and again from the live keymap. */
 export function setAppShortcutRows(rows: readonly ShellShortcut[]): void {
   appRows = rows;
 }
@@ -93,7 +91,6 @@ export function bindAppHelp(read: () => readonly string[]): () => void {
   };
 }
 
-/** Catalog the live tests drive. Application rows are whatever the keymap registered. */
 export function shellShortcuts(): readonly ShellShortcut[] {
   return [...appRows, ...WIDGET_DEFAULT_SHORTCUTS];
 }

src/tui/shell/keymap.ts

@@ -1,6 +1,5 @@
 /**
  * Registers `APP_CHORDS` on `@opentui/keymap`. Lookup belongs to the package.
- * There is no second switch from key name to handler.
  *
  * The default host keeps its keypress listener until the destroy event, but
  * `isDestroyed` flips first and leftover stdin then throws inside
@@ -90,7 +89,6 @@ function keymapFor(renderer: CliRenderer): ShellKeymap {
   return keymap;
 }
 
-/** True while this renderer's keymap is still subscribed to keypress. */
 export function shellKeymapListening(renderer: CliRenderer): boolean {
   return keymaps.has(renderer) && !detached.has(renderer);
 }