Skip to content

feat(tui): support mouse text selection in prompt editor#2202

Open
FeiZhuLulu wants to merge 1 commit into
MoonshotAI:mainfrom
FeiZhuLulu:feat/mouse-selection
Open

feat(tui): support mouse text selection in prompt editor#2202
FeiZhuLulu wants to merge 1 commit into
MoonshotAI:mainfrom
FeiZhuLulu:feat/mouse-selection

Conversation

@FeiZhuLulu

Copy link
Copy Markdown

Related Issue

Related to #1174

Problem

The prompt editor currently relies on keyboard navigation for cursor placement and text editing. Editing longer multi-line prompts is slow, while enabling terminal mouse reporting can interfere with native terminal selection unless the feature is explicitly gated and restores terminal state reliably.

What changed

Add experimental mouse text selection to the main prompt editor, enabled with KIMI_CODE_EXPERIMENTAL_TERMINAL_MOUSE_INPUT=1.

The editor now supports click-to-position, forward and reverse drag selection, wrapped and multi-line ranges, grapheme-safe deletion and replacement, atomic undo, and selected-text retrieval. Ctrl+C copies an active selection while preserving the existing cancel/exit behavior when no selection exists.

Kimi Code handles SGR mouse input only while the main editor is mounted, coalesces high-frequency drag events, maps coordinates from the latest rendered layout and actual viewport, and disables mouse reporting around dialogs, external editing, reloads, normal exit, and emergency terminal restoration. Holding Shift keeps terminal-native selection and scrollback behavior available.

English and Chinese documentation, package changesets, and regression coverage are included.

Checklist

  • I have read the CONTRIBUTING document.
  • I have linked a related issue, or explained the problem above.
  • I have added tests that prove my feature works.
  • Ran gen-changesets skill, or this PR needs no changeset.
  • Updated the English and Chinese docs; the gen-docs skill is not present in this checkout.

Verification

  • pnpm --filter @moonshot-ai/pi-tui typecheck
  • pnpm --filter @moonshot-ai/pi-tui exec node --test test/editor.test.ts test/tui-render.test.ts — 254 passed
  • pnpm --filter @moonshot-ai/kimi-code typecheck
  • pnpm --filter @moonshot-ai/kimi-code exec vitest run test/tui/editor-mouse.test.ts test/tui/components/editor/custom-editor.test.ts test/tui/controllers/editor-keyboard.test.ts test/tui/commands/reload.test.ts test/tui/kimi-tui-startup.test.ts test/utils/terminal-restore.test.ts — 131 passed
  • pnpm exec vitest run packages/node-sdk/test/config.test.ts — 12 passed
  • pnpm --filter @moonshot-ai/pi-tui build
  • pnpm --filter @moonshot-ai/kimi-code build
  • pnpm exec changeset status --since=origin/main
  • git diff origin/main...HEAD --check
  • Staged diff audit found no local paths, account identifiers, or credentials.
  • Manual Windows Terminal validation covered repeated drag/delete cycles, wrapped multi-line text, CJK and ZWJ emoji, selection copy with Ctrl+C, lifecycle restoration, and coordinate stability after prompt shrinkage.

@changeset-bot

changeset-bot Bot commented Jul 26, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: ac60db7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages
Name Type
@moonshot-ai/pi-tui Minor
@moonshot-ai/kimi-code Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ac60db7e61

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +205 to +207
return {
row: Math.max(0, Math.min(layout.endRow - layout.startRow - 1, localRow)),
col: Math.max(1, Math.min(editorWidth - 2, localCol)),

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Allow selection drags to scroll beyond the visible editor

When a prompt exceeds the editor's five-row-or-30% viewport, dragging above or below the editor clamps every event to the first or last currently rendered row. Because moving the selection head to that still-visible row never advances scrollOffset, there is no way to extend a mouse selection into the hidden lines; for example, a ten-line prompt initially showing lines 5–9 can never be dragged upward to select lines 0–4. Add edge-driven scrolling or map out-of-bounds drags to adjacent hidden rows.

Useful? React with 👍 / 👎.

Comment on lines +622 to +624
const start = Math.max(line.startCol, startCol);
const end = Math.min(line.endCol, endCol);
return end > start ? { start: start - line.startCol, end: end - line.startCol } : undefined;

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Render newline-only selections visibly

When the selected range contains only a line break—such as dragging from the end of one line to column 0 of the next—or passes through an empty line, every affected visual line has end === start, so this returns no highlighted span. The editor still reports an active selection and Backspace or typing removes the newline, leaving users with an apparently unselected cursor that can unexpectedly join lines; render an end-of-line or empty-line cell for these ranges.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant