Files
eepp/docs/articles/eterm_kitty_keyboard.md
Martín Lucas Golini ee0d9378ad Expand UI documentation and refine link context menus
Add guides for native UI authoring, layouts, application CSS, and HTML
compatibility. Update the CSS reference, rename article files consistently,
and point README links to the local guides.

Add Copy Link for HTML and Markdown anchors when no text is selected.
Resolve relative links against the document URI before copying, and cover
Markdown and WebView behavior with tests.

Fix layout width policy serialization to use the widget's width.
2026-09-28 19:20:34 -03:00

1.1 KiB

eterm Kitty keyboard protocol

eterm implements Kitty keyboard protocol progressive enhancement. Applications negotiate it at runtime with CSI ? u, CSI > flags u, CSI < count u, and CSI = flags ; mode u; changing TERM to xterm-kitty is neither necessary nor recommended.

The implementation accepts all standardized flags. Main and alternate screens have independent bounded mode stacks. Alternate-key reporting derives the standard PC-layout key from EEPP's layout-independent scancode and the shifted key from committed text. Associated committed text is reported when available from text input.

SDL2 and SDL3 repeat markers are preserved, so press, repeat, and release events are distinct when event reporting is enabled. IME pre-edit input remains local; only committed text is forwarded.

For a raw diagnostic, an application can push report-all mode with ESC [ > 8 u. In that mode, Ctrl+Enter is sent as ESC [ 13 ; 5 u. It must pop the mode with ESC [ < u before exiting. Intermediaries such as tmux or screen must independently support and forward the protocol.