Support visual vim paste replace

Author: SqlRush

docs/cc-100-roadmap.md

@@ -744,6 +744,8 @@ M7 补充：prompt history `LogEntry` 读取现在接受 `sessionID`/`session`/`
 
 本轮补充：TUI Vim prompt editing 增加 visual/visual-line `J`/`gJ` 行拼接，支持选择范围内的 whitespace-normalized join 和 raw join，并沿用 undo、`gv` selection 记忆和 dot-repeat change 记录。
 
+本轮补充：TUI Vim prompt editing 增加 visual/visual-line `p`/`P` 粘贴替换 selection，支持 characterwise 和 linewise register，替换出的文本会回写 unnamed register，并避免行选择替换到末尾时留下额外空行。
+
 本轮补充：prompt history 写入现在保留 image pasted-content 的 media type、filename、dimensions 和 image-cache source path 元数据，同时继续不把 inline base64 image bytes 或 text-paste hash 写进图片历史记录。
 
 本轮补充：prompt history 读取旧 image pasted-content 记录时，如果缺少 source path 但对应 session 的 image-cache 文件仍存在，会自动补回 source path 并刷新内存 image path cache。

docs/claude-code-go-rewrite-plan.md

@@ -238,6 +238,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：TUI Vim prompt editing 增加 `gu`/`gU`/`g~` case-conversion operator，复用 motion、linewise、find/till、text-object 和 dot-repeat operator 管线，并保持大小写转换不写入 yank register。
 - 本轮补充：TUI Vim prompt editing 增加 normal-mode `gJ` raw line join，不插入/规范化空格，并接入 dot-repeat。
 - 本轮补充：TUI Vim prompt editing 增加 visual/visual-line `J`/`gJ` 行拼接，支持选择范围内的 whitespace-normalized join 和 raw join，并沿用 undo、`gv` selection 记忆和 dot-repeat change 记录。
+- 本轮补充：TUI Vim prompt editing 增加 visual/visual-line `p`/`P` 粘贴替换 selection，支持 characterwise 和 linewise register，替换出的文本会回写 unnamed register，并避免行选择替换到末尾时留下额外空行。
 - 本轮补充：prompt history 写入现在保留 image pasted-content 的 media type、filename、dimensions 和 image-cache source path 元数据，同时继续不把 inline base64 image bytes 或 text-paste hash 写进图片历史记录。
 - 本轮补充：prompt history 读取旧 image pasted-content 记录时，如果缺少 source path 但对应 session 的 image-cache 文件仍存在，会自动补回 source path 并刷新内存 image path cache。
 - 本轮补充：interaction script key 字段现在接受 DOM-style key event object，可从 `key`/`code`（包括 `Numpad*`、扩展数字区括号/hash/backspace 和标点 key code）、旧式 `keyIdentifier`、数字 `keyCode`/`which`/`charCode`（包括标点和数字区运算符）、`keypress.which` 字符码、`ctrlKey`/`altKey`/`metaKey`/`shiftKey` 和 `modifiers` 数组还原现有 key 名，wrapper payload 中的 key event 也可驱动脚本回放。

docs/first-second-parity-audit.md

@@ -235,6 +235,7 @@ M7 progress now includes:
 - `internal/tui`: Vim prompt editing now includes `gu`/`gU`/`g~` case-conversion operators across motion, linewise, find/till, text-object, and dot-repeat paths without updating the yank register.
 - `internal/tui`: Vim prompt editing now includes normal-mode `gJ` raw line joins that do not insert or normalize whitespace and can be dot-repeated.
 - `internal/tui`: Vim prompt editing now includes visual and visual-line `J`/`gJ` joins across selected line ranges, sharing the normal whitespace-normalized and raw join semantics plus undo, `gv`, and dot-repeat recording.
+- `internal/tui`: Vim prompt editing now includes visual and visual-line `p`/`P` paste-over-selection behavior for characterwise and linewise registers, updating the unnamed register with the replaced text and avoiding extra trailing blank lines for end-of-buffer line replacements.
 - `internal/session`: prompt history now persists image pasted-content metadata such as media type, filename, dimensions, and image-cache source path while still omitting inline base64 image bytes and text-paste hashes for images.
 - `internal/session`: prompt history loading now backfills missing image source paths from existing per-session image-cache files and refreshes the in-memory image path cache when those files exist.
 - `internal/tui`: interaction script key fields now accept DOM-style key event objects with `key`/`code` including `Numpad*`, extended numpad paren/hash/backspace codes, and punctuation key codes, legacy `keyIdentifier`, numeric `keyCode`/`which`/`charCode` including punctuation and numpad operators, `keypress.which` char-code replay, modifier booleans such as `ctrlKey`/`altKey`/`metaKey`/`shiftKey`, and modifier arrays, including wrapper payloads and modifier-only event filtering.

internal/tui/tui_test.go

@@ -3891,6 +3891,28 @@ func TestREPLScreenVimVisualCharOperators(t *testing.T) {
 	if screen.VimMode != VimNormal || screen.Prompt.Text != "  one\n  two\nthree" || screen.Prompt.Cursor != len([]rune("  ")) {
 		t.Fatalf("after visual indent screen = %#v", screen)
 	}
+
+	screen = NewREPLScreen(40, 8, nil)
+	screen.SetVimEnabled(true)
+	typePromptText(&screen, "alpha beta gamma")
+	screen.ApplyKey(ParseKey("\x1b"))
+	for _, seq := range []string{"0", "w", "v", "e", "y", "$", "b", "v", "e", "p"} {
+		screen.ApplyKey(ParseKey(seq))
+	}
+	if screen.VimMode != VimNormal || screen.Prompt.Text != "alpha beta beta" || screen.Prompt.Cursor != len([]rune("alpha beta beta"))-1 || screen.VimRegister != "gamma" || screen.VimRegisterLinewise {
+		t.Fatalf("after visual paste screen = %#v", screen)
+	}
+
+	screen = NewREPLScreen(40, 8, nil)
+	screen.SetVimEnabled(true)
+	typePromptText(&screen, "red blue green")
+	screen.ApplyKey(ParseKey("\x1b"))
+	for _, seq := range []string{"0", "w", "v", "e", "y", "$", "b", "v", "e", "P"} {
+		screen.ApplyKey(ParseKey(seq))
+	}
+	if screen.VimMode != VimNormal || screen.Prompt.Text != "red blue blue" || screen.Prompt.Cursor != len([]rune("red blue blue"))-1 || screen.VimRegister != "green" || screen.VimRegisterLinewise {
+		t.Fatalf("after visual P screen = %#v", screen)
+	}
 }
 
 func TestREPLScreenVimVisualLineOperators(t *testing.T) {
@@ -4040,6 +4062,17 @@ func TestREPLScreenVimVisualLineOperators(t *testing.T) {
 	if screen.VimMode != VimNormal || screen.Prompt.Text != "one two\nthree" || screen.Prompt.Cursor != len([]rune("one")) {
 		t.Fatalf("after visual J screen = %#v", screen)
 	}
+
+	screen = NewREPLScreen(40, 8, nil)
+	screen.SetVimEnabled(true)
+	typePromptText(&screen, "one\ntwo\nthree\nfour")
+	screen.ApplyKey(ParseKey("\x1b"))
+	for _, seq := range []string{"g", "g", "y", "y", "j", "V", "j", "p"} {
+		screen.ApplyKey(ParseKey(seq))
+	}
+	if screen.VimMode != VimNormal || screen.Prompt.Text != "one\none\nfour" || screen.Prompt.Cursor != len([]rune("one\n")) || screen.VimRegister != "two\nthree\n" || !screen.VimRegisterLinewise {
+		t.Fatalf("after visual line paste screen = %#v", screen)
+	}
 }
 
 func TestREPLScreenVimGLineNavigationAndOperators(t *testing.T) {

internal/tui/vim.go

@@ -315,6 +315,8 @@ func (s *REPLScreen) applyVimVisualRune(r rune) ScreenEvent {
 		s.applyVimVisualJoin(false)
 	case 'y', 'd', 'c':
 		s.applyVimVisualOperator(r)
+	case 'p', 'P':
+		s.applyVimVisualPaste()
 	case 'x':
 		s.applyVimVisualOperator('d')
 	case 's':
@@ -467,6 +469,26 @@ func (s *REPLScreen) applyVimVisualJoin(raw bool) {
 	s.clearVimVisualState()
 }
 
+func (s *REPLScreen) applyVimVisualPaste() {
+	if s.VimRegister == "" {
+		s.exitVimVisual()
+		return
+	}
+	start, end, linewise, ok := s.vimVisualSelectionRange()
+	if !ok {
+		s.exitVimVisual()
+		return
+	}
+	replacement := s.VimRegister
+	replacementLinewise := s.VimRegisterLinewise || strings.HasSuffix(replacement, "\n")
+	replaced := s.Prompt.rangeText(start, end)
+	s.rememberVimVisualSelection()
+	s.recordVimUndo()
+	s.Prompt.replaceRangeWithPaste(start, end, linewise, replacement, replacementLinewise)
+	s.setVimRegister(replaced, linewise)
+	s.clearVimVisualState()
+}
+
 func (s *REPLScreen) applyVimOperator(r rune) ScreenEvent {
 	if isVimCountRune(r) && (r != '0' || s.VimCount > 0) {
 		s.VimCount = s.VimCount*10 + int(r-'0')
@@ -1624,6 +1646,70 @@ func (p *PromptState) pasteLinewise(content string, after bool, count int) {
 	p.resetHistoryCursor()
 }
 
+func (p *PromptState) replaceRangeWithPaste(start int, end int, linewise bool, content string, contentLinewise bool) {
+	if linewise || contentLinewise {
+		p.replaceLineRangeWithPaste(start, end, content)
+		return
+	}
+	runes := []rune(p.Text)
+	start = p.clampCursor(start)
+	end = p.clampCursor(end)
+	if end < start {
+		start, end = end, start
+	}
+	insert := []rune(content)
+	replaced := make([]rune, 0, len(runes)-(end-start)+len(insert))
+	replaced = append(replaced, runes[:start]...)
+	replaced = append(replaced, insert...)
+	replaced = append(replaced, runes[end:]...)
+	p.Text = string(replaced)
+	if len(insert) > 0 {
+		p.Cursor = start + len(insert) - 1
+	} else {
+		p.Cursor = start
+	}
+	p.resetHistoryCursor()
+}
+
+func (p *PromptState) replaceLineRangeWithPaste(start int, end int, content string) {
+	lines := strings.Split(p.Text, "\n")
+	if len(lines) == 0 {
+		return
+	}
+	start = p.clampCursor(start)
+	end = p.clampCursor(end)
+	if end < start {
+		start, end = end, start
+	}
+	inclusiveEnd := end
+	if inclusiveEnd > start {
+		inclusiveEnd--
+	}
+	startLine := p.lineIndexAtCursor(start)
+	endLine := p.lineIndexAtCursor(inclusiveEnd)
+	if startLine < 0 {
+		startLine = 0
+	}
+	if endLine < startLine {
+		startLine, endLine = endLine, startLine
+	}
+	if startLine >= len(lines) {
+		startLine = len(lines) - 1
+	}
+	if endLine >= len(lines) {
+		endLine = len(lines) - 1
+	}
+	content = strings.TrimSuffix(content, "\n")
+	insertLines := strings.Split(content, "\n")
+	newLines := make([]string, 0, len(lines)-(endLine-startLine+1)+len(insertLines))
+	newLines = append(newLines, lines[:startLine]...)
+	newLines = append(newLines, insertLines...)
+	newLines = append(newLines, lines[endLine+1:]...)
+	p.Text = strings.Join(newLines, "\n")
+	p.Cursor = lineStartOffset(newLines, startLine)
+	p.resetHistoryCursor()
+}
+
 func lineStartOffset(lines []string, lineIndex int) int {
 	if lineIndex <= 0 {
 		return 0