Skip to content

cmdio: make Alt+non-letter keys inert and route paste as text - #7741

Draft
pietern wants to merge 2 commits into
pietern/charm-v2/03b-teainputfrom
pietern/charm-v2/03c-key-changes
Draft

pietern wants to merge 2 commits into
pietern/charm-v2/03b-teainputfrom
pietern/charm-v2/03c-key-changes

Conversation

@pietern

@pietern pietern commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Changes

These are the deliberate v1 behaviour changes, each with its golden rows:

  • Alt with a key that isn't a letter is inert. Alt+Enter, Alt+arrows, Alt+Ctrl+C and Alt+Space match no key and do nothing in prompts, selection lists and the pager. v1 acted as the plain key, because it ignored Alt on those keys. Goldens: TestKeysPin_PromptAltEnter (typed abc, not submitted), TestKeysPin_PromptAltLeft (abcX), TestKeysPin_SelectAltEnter (the list stays on screen and a later Enter picks id-02).
  • Selection lists: paste is text. A paste is literal search text when search is open and is ignored otherwise. v1 treated a paste like typed keys: a pasted j moved the cursor and a pasted / opened search. Unit test: TestSelectPaste.
  • Table view search takes the typed text, not the key's string. v1 appended alt+f for Alt+F and [text] for a paste. Golden: TestTableviewPin_SearchInput (search reads item-1; status reads match 1/10).

Changelog: .nextchanges/cli/alt-keys-inert.md.

Why

Alt+Enter submitting a prompt and Alt+Left moving the cursor were v1 side effects of ignoring Alt, not designed behaviour. No standard gives those keys a meaning, and on macOS Option sends Meta only with "Option as Meta". Making them inert also keeps the v2 key names unambiguous for the v2 swap.

Tests

  • go build ./..., golangci-lint (0 issues), gofmt clean.
  • TERM=xterm-256color go test -race -count=3 ./libs/cmdio/... ./libs/tableview/... passes.
  • Golden changes (seven files):
    • TestKeysPin_PromptAltEnter/{01-after-alt-enter,02-result}: Value: ab becomes ✔ Value: abc█.
    • TestKeysPin_PromptAltLeft/{01-after-alt-left,02-result}: abXc becomes abcX.
    • TestKeysPin_SelectAltEnter/01-after-alt-enter: the list stays on screen.
    • TestTableviewPin_SearchInput/{02-search-input,03-after-search.styled}: / italt+f[em-1]█ becomes / item-1█; no matches becomes match 1/10.
  • The pins pass otherwise without -update.
  • Full acceptance suite (go test ./acceptance/...) passes.

Stack: based on pietern/charm-v2/03b-teainput.

Manual checks for real terminals:

  • databricks selftest tui prompt, type ab, Alt+Enter, c, Enter: Entered: abc (v1: Entered: ab).
  • databricks selftest tui select --n 3, Alt+Enter: nothing happens; Enter selects the highlighted item.
  • databricks selftest tui table --rows 50: /, Alt+F, then type: the search text has no alt+f.

This pull request and its description were written by Isaac.

@eng-dev-ecosystem-bot

eng-dev-ecosystem-bot commented Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator

✅ Integration test report

Commit: 94fea4a

Run: 44310868830

Env 💚​RECOVERED ✅​pass 🙈​skip Time
💚​ aws linux-2core-8gb 1 272 19 19:18
💚​ aws-windows-latest-4core-16gb 1 274 17 12:32
💚​ azure linux-2core-8gb 1 271 19 17:16
💚​ azure-windows-latest-4core-16gb 1 273 17 9:43
💚​ gcp linux-2core-8gb 1 272 19 15:58
💚​ gcp-windows-latest-4core-16gb 1 274 17 10:54
Test Name aws linux-2core-8gb aws-windows-latest-4core-16gb azure linux-2core-8gb azure-windows-latest-4core-16gb gcp linux-2core-8gb gcp-windows-latest-4core-16gb
💚​ TestAccept 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R
Top 40 slowest tests (at least 2 minutes):
duration env testname
7:12 aws-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsDelete
6:13 aws linux-2core-8gb TestFilerWorkspaceFilesExtensionsReadDir
5:58 azure-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsDelete
5:14 azure linux-2core-8gb TestFilerRecursiveDelete/workspace_files_extensions
5:14 aws-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsReadDir
5:13 azure linux-2core-8gb TestFilerWorkspaceFilesExtensionsRead
3:52 azure linux-2core-8gb TestImportDirDoesNotOverwrite
3:45 aws linux-2core-8gb TestLock
3:42 aws-windows-latest-4core-16gb TestSyncIncrementalFileSync
3:42 gcp-windows-latest-4core-16gb TestSyncIncrementalFileSync
3:40 aws-windows-latest-4core-16gb TestAccept
3:32 azure-windows-latest-4core-16gb TestAccept
3:30 gcp-windows-latest-4core-16gb TestAccept
3:24 aws linux-2core-8gb TestImportDirWithOverwriteFlag
3:23 gcp-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsRead
3:10 gcp linux-2core-8gb TestFilerWorkspaceNotebook/scalaNb.scala
3:10 azure linux-2core-8gb TestFilerWorkspaceFilesExtensionsReadDir
3:06 gcp-windows-latest-4core-16gb TestImportDir
3:04 aws linux-2core-8gb TestFilerWorkspaceFilesExtensionsStat
2:58 gcp linux-2core-8gb TestFilerReadDir/workspace_files
2:58 aws linux-2core-8gb TestFilerWorkspaceFilesExtensionsDelete
2:55 gcp linux-2core-8gb TestFilerWorkspaceFilesExtensionsStat
2:48 gcp-windows-latest-4core-16gb TestSyncFullFileSync
2:46 aws-windows-latest-4core-16gb TestFilerReadWrite/workspace_files
2:45 gcp-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsDelete
2:41 azure-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsReadDir
2:39 azure-windows-latest-4core-16gb TestFilerWorkspaceFilesExtensionsRead
2:37 aws linux-2core-8gb TestFilerRecursiveDelete/workspace_files_extensions
2:27 gcp linux-2core-8gb TestImportDirDoesNotOverwrite
2:25 gcp linux-2core-8gb TestFilerRecursiveDelete/workspace_files_extensions
2:25 aws-windows-latest-4core-16gb TestFilerWorkspaceNotebook/rJupyterNb.ipynb
2:16 gcp-windows-latest-4core-16gb TestFilerRecursiveDelete/workspace_files
2:15 aws-windows-latest-4core-16gb TestImportDirDoesNotOverwrite
2:10 gcp-windows-latest-4core-16gb TestFilerReadWrite/workspace_files_extensions
2:10 gcp linux-2core-8gb TestFilerWorkspaceFilesExtensionsReadDir
2:09 gcp linux-2core-8gb TestFilerReadWrite/workspace_files_extensions
2:09 azure linux-2core-8gb TestFilerWorkspaceNotebook/scalaJupyterNb.ipynb
2:07 aws-windows-latest-4core-16gb TestFilerRecursiveDelete/workspace_files
2:05 azure-windows-latest-4core-16gb TestImportDirDoesNotOverwrite
2:00 aws linux-2core-8gb TestAccept

@pietern
pietern added this pull request to stack #7754 November 18, 2026 08:35
@pietern

pietern commented Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

/review

}

case tea.KeyMsg:
if in, ok := teainput.Decode(msg); ok {

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

The select model (line 256) and pager (line 186) both guard against paste before dispatching, but the table view doesn't. In normal mode a paste event has in.Key == "", so the updateNormal switch falls through and m.viewport.Update(msg) receives the raw tea.KeyMsg. If the viewport has a key binding that matches the pasted text (e.g. a single pasted "d" hitting HalfPageDown), it would scroll. Can we add a paste guard here like the other two models?

@pietern
pietern force-pushed the pietern/charm-v2/03c-key-changes branch from 78b2bf2 to 94fea4a Compare November 18, 2026 13:07
@pietern
pietern force-pushed the pietern/charm-v2/03c-key-changes branch from 94fea4a to 558222b Compare November 18, 2026 15:55
pietern and others added 2 commits November 18, 2026 16:06
…paste as text

These are the deliberate v1 behaviour changes, each with its golden rows:

- Alt stays in the key name for every non-rune key, so Alt+Enter,
  Alt+arrows, Alt+Ctrl+C and Alt+Space match no case and do nothing in
  prompts, selection lists and the pager. v1 acted as the plain key,
  because it ignored Alt on those keys. Goldens: TestKeysPin_PromptAltEnter,
  TestKeysPin_PromptAltLeft, TestKeysPin_SelectAltEnter.
- A paste in a selection list is literal search text when search is open
  and is ignored otherwise. v1 treated a paste like typed keys, so a pasted
  "j" moved the cursor and a pasted "/" opened search. Pinned by
  TestSelectPaste.
- The table view's search takes Text, not msg.String(). v1 appended
  "alt+f" for Alt+F and "[text]" for a paste. Goldens:
  TestTableviewPin_SearchInput (search input and status line now read
  "match 1/10").

Changelog: .nextchanges/cli/alt-keys-inert.md.

Co-authored-by: Isaac <no-reply@databricks.com>
Co-authored-by: Isaac <no-reply@databricks.com>
@pietern
pietern force-pushed the pietern/charm-v2/03c-key-changes branch from 558222b to c254801 Compare November 18, 2026 16:08

This branch has not been deployed

No deployments
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.

2 participants