lib/tty/key.c: Add Kitty Keyboard Protocol support

The protocol is described here:

https://sw.kovidgoyal.net/kitty/keyboard-protocol/

The old functionality that "eats" all characters following an unknown
escape sequence has been removed, as it causes severe side effects (such
as not responding to any keys following an unknown sequence for some
time). This is superseded by parsing CSI and SS3 sequences, which are
the de facto standard for sending any function keys.

Signed-off-by: Jakub Horký <jakub.git@horky.net>

Author: Jakub Horký

doc/man/es/mc.1.in

@@ -3965,6 +3965,13 @@ For example:
 .nf
 autodetect_codeset=russian
 .fi
+.TP
+.I kitty_keyboard_protocol
+De forma predeterminada, Midnight Commander envía una secuencia de escape que habilita el
+protocolo de teclado de Kitty, lo que permite un manejo preciso del teclado (incluyendo
+combinaciones de teclas como C\-Enter o C\-S\-Enter) cuando se conecta desde terminales
+que admiten este protocolo. Si se establece en falso, Midnight Commander no intentará
+habilitar este protocolo.
 .\"NODE "Parameters for external editor or viewer"
 .SH "Parámetros para editor o visor externo"
 Midnight Commander permite especificar opciones para editores y visores

doc/man/hu/mc.1.in

@@ -3014,6 +3014,14 @@ utolsó fájl a panelben.
 .IP
 Ha ez a változó be van állítva (alapértelmezésben) meg foja jelölni azt
 a fájl parancsot, amelyhez a
+.PP
+.I kitty_keyboard_protocol
+Alapértelmezés szerint a Midnight Commander egy olyan escape szekvenciát
+küld, amely engedélyezi a Kitty billentyűzetprotokollt. Ez lehetővé teszi
+a billentyűzet pontos kezelését (beleértve az olyan billentyűkombinációkat
+is, mint a C\-Enter vagy a C\-S\-Enter), amikor olyan terminálról
+csatlakoznak, amely támogatja ezt a protokollt. Ha az érték hamisra van
+állítva, a Midnight Commander nem próbálja meg engedélyezni ezt a protokollt.
 .\"LINK2"
 Társításokban
 .\"Edit Extension File"

doc/man/it/mc.1.in

@@ -3014,6 +3014,14 @@ pannello.
 .I use_file_to_guess_type
 Se questa variabile è abilitata (valore predefinito) userà il comando
 file per trovare delle corrispondenze sui tipi di file elencati nel
+.TP
+.I kitty_keyboard_protocol
+Per impostazione predefinita, Midnight Commander invia una sequenza di
+escape che abilita il Kitty Keyboard Protocol, il quale consente una
+gestione precisa della tastiera (incluse combinazioni di tasti come
+C\-Enter o C\-S\-Enter) quando ci si connette da terminali che supportano
+questo protocollo. Se impostato su false, Midnight Commander non tenterà
+di abilitare questo protocollo.
 .\"LINK2"
 file mc.ext.ini\&.
 .\"Edit Extension File"

doc/man/mc.1.in

@@ -4190,6 +4190,13 @@ For example:
 .nf
 autodetect_codeset=russian
 .fi
+.TP
+.I kitty_keyboard_protocol
+By default, Midnight Commander sends an escape sequence that enables the Kitty
+Keyboard Protocol, which allows precise keyboard handling (including key
+combinations such as C\-Enter or C\-S\-Enter) when connected from terminals that
+support this protocol. If set to false, Midnight Commander will not attempt to
+enable this protocol.
 .\"NODE "Parameters for external editor or viewer"
 .SH "Parameters for external editor or viewer"
 Midnight Commander provides a way for specify an options for external editors

doc/man/pl/mc.1.in

@@ -2708,6 +2708,13 @@ Jeśli ta opcja jest włączona (standardowo tak nie jest) kiedy przeglądasz pl
 w panelu drzewa, będzie on automatycznie przeładowywał drugi panel na
 zawartość wybranego katalogu.
 .PP
+.I kitty_keyboard_protocol
+Domyślnie Midnight Commander wysyła sekwencję escape, która włącza protokół
+klawiatury Kitty. Umożliwia on precyzyjną obsługę klawiatury (w tym kombinacje
+klawiszy takie jak C\-Enter czy C\-S\-Enter) podczas połączenia z terminalami
+obsługującymi ten protokół. Jeśli ustawione na false, Midnight Commander
+nie będzie próbował włączyć tego protokołu.
+.PP
 .\"NODE "Terminal databases"
 .SH Baza danych terminali (Terminal databases)
 Midnight Commander pozwala ci na naprawienie bazy danych terminali bez

doc/man/ru/mc.1.in

@@ -4660,6 +4660,13 @@ clipboard_paste=xclip \-o
 .nf
 autodetect_codeset=russian
 .fi
+.PP
+.I kitty_keyboard_protocol
+По умолчанию Midnight Commander отправляет управляющую последовательность, которая
+включает протокол клавиатуры Kitty. Этот протокол обеспечивает точную обработку
+клавиатуры (включая такие комбинации клавиш, как C\-Enter или C\-S\-Enter) при
+подключении из терминалов, поддерживающих данный протокол. Если установить значение
+в false, Midnight Commander не будет пытаться включить этот протокол.
 .\"NODE "Parameters for external editor or viewer"
 .SH "Параметры для внешних редакторов и программ просмотра"
 Midnight Commander позволяет задать некоторые параметрыы для внешних редакторов

doc/man/sr/mc.1.in

@@ -3006,6 +3006,14 @@ base_color=normal=white,default:marked=magenta,default
 Уколико је ова променљива укључена (подразумевано је искључена),
 приликом разгледања система датотека у окну које је у режиму Стабла,
 друго окно ће се аутоматски поново учитати у изабраном директоријуму.
+.TP
+.I kitty_keyboard_protocol
+Подразумевано, Midnight Commander шаље escape секвенцу која омогућава
+Kitty протокол тастатуре, што омогућава прецизно руковање тастатуром
+(укључујући комбинације тастера као што су C\-Enter или C\-S\-Enter)
+када се повезује са терминала који подржавају овај протокол. Ако је
+постављено на false, Midnight Commander неће покушати да омогући овај
+протокол.
 .\"NODE "Terminal databases"
 .SH "Базе терминала"
 Поноћни наредник обезбеђује начин да поправи вашу системску базу

lib/global.c

@@ -103,7 +103,8 @@ mc_global_t mc_global =
         .disable_colors = FALSE,
         .ugly_line_drawing = FALSE,
         .old_mouse = FALSE,
-        .alternate_plus_minus = FALSE
+        .alternate_plus_minus = FALSE,
+        .kitty_keyboard_protocol = TRUE
     },
 
     .vfs =

lib/global.h

@@ -206,6 +206,10 @@ typedef struct
         /* If true, use + and \ keys normally and select/unselect do if M-+ / M-\.
            and M-- and keypad + / - */
         gboolean alternate_plus_minus;
+
+        // If true, send Kitty Keyboard Protocol initialization string to the terminal
+        // Defaults to true, because terminals that don't support it simply do nothing
+        gboolean kitty_keyboard_protocol;
     } tty;
 
     struct

lib/terminal.c

@@ -156,6 +156,7 @@ parse_csi (csi_command_t *out, const char **sptr, const char *end)
     {
         out->private_mode = private_mode;
         out->param_count = param_count;
+        out->final_byte = c;
     }
 
 invalid_sequence: