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

The protocol is described here:

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

Check for kitty sequence when no entry is found in the keys tree, before
the sequence is discarded.

Resolves: #4762

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

@@ -4208,6 +4208,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

@@ -4663,6 +4663,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

@@ -4044,6 +4044,14 @@ clipboard_paste=xclip \-o
 .nf
 autodetect_codeset=russian
 .fi
+.TP
+.I kitty_keyboard_protocol
+Подразумевано, Midnight Commander шаље escape секвенцу која омогућава
+Kitty протокол тастатуре, што омогућава прецизно руковање тастатуром
+(укључујући комбинације тастера као што су C\-Enter или C\-S\-Enter)
+када се повезује са терминала који подржавају овај протокол. Ако је
+постављено на false, Midnight Commander неће покушати да омогући овај
+протокол.
 .\"NODE "Parameters for external editor or viewer"
 .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: