normal Esc toggles document/terminal focus

2 files changed, 4 insertions, 2 deletions

diff --git a/docs/design.typ b/docs/design.typ
index 9cc05cab..69c138f2 100644
--- a/docs/design.typ
+++ b/docs/design.typ
@@ -200,7 +200,9 @@ the source (cursor row kept visible); dying pane's weight absorbed by one
 sibling; emptied column hands width to a neighbor; border-drag resize on a
 pane's own trailing edge (v and h), hover shows `╎`/`╌` glyph-only hints;
 move-drag via the gutter box with preview; Alt-n new shell below, Alt-c move
-pane to new column; Ctrl-w h/j/k/l directional focus; `--tty` single-pane mode.
+pane to new column; Ctrl-w h/j/k/l directional focus; body-normal Esc toggles
+between the latest document and terminal (the same builtin as SPC w t);
+`--tty` single-pane mode.
 
 *Mouse.* Left: select (block, stays highlighted after drag, pins cursor,
 enters normal), click clears, tag-row click enters tag edit, scrollbar
diff --git a/docs/helix-keys.md b/docs/helix-keys.md
index 839550a2..7fc318ba 100644
--- a/docs/helix-keys.md
+++ b/docs/helix-keys.md
@@ -83,7 +83,7 @@ with a reason in `test/hxcases/waivers.jsonl`.
 | `y` | yank selection; bare cursor yanks the 1-wide selection (char under cursor) | line-yank vim-ism removed (phase 5); yank keeps selection AND cursor (helix). Also emits `set_clipboard` (OSC 52 out) | helix-verified |
 | `u` / `U` | undo / redo | restores the pre-edit selection (helix); snapshot granularity, no `Alt-u`/`Alt-U` history walking (skipped) | helix-verified |
 | `p` (normal) | paste the core's yank register after the selection | helix default-register semantics; yank still mirrors OUT via OSC 52 (`set_clipboard`) but `p` never reads the system clipboard back — most terminals refuse the OSC 52 read, which left `p` a silent no-op | helix-verified |
-| `Esc` (normal) | cancel pending prefix / exit select mode; the selection is KEPT | helix Esc does not collapse selections; never drops to tty mode | helix-verified |
+| `Esc` (body normal) | clear a pending modal prefix / exit select mode, keeping the selection, then run `Toggleterm`: hop between the most recently focused document and terminal, exactly like `SPC w t` | Pardes-specific focus binding layered on helix's cleanup. A leader path, tag, topbar or search owns Esc while it is active; raw tty forwards it | pardes-specific (cleanup helix-verified) |
 | `Esc` (insert) | back to normal mode, cursor right after the insertion (no vim left-step) | | helix-verified |
 | `Enter` (normal) | acme **look** chord: EXPLICIT selection, else file-ish word under cursor | pardes-specific, keep (helix normal-mode Enter unbound). Covers helix `gf`. Implicit motion residue falls back to the cursor word | pardes-specific |
 | `Tab` (normal) | acme **execute** chord | pardes-specific, keep; explicit-selection rule as Enter | pardes-specific |