[FL-3965] Separate cli_shell into toolbox (#4175)

* cli_shell: separate into toolbox * fix: cmd flags * fix formatting * cli: increase default stack depth * cli_shell: fix loader lock logic * cli: fix command flags * fix f18 * speaker_debug: fix * cli_registry: fix docs * ufbt: rename cli target back * cli: rename app and record * cli: fix and simplify help command * cli_master_shell: fix ext commands * fix formatting * cli: rename master to main * fix formatting --------- Co-authored-by: hedger <hedger@users.noreply.github.com>
2025-12-12 20:49:49 +04:00 · 2025-04-05 02:58:58 +04:00
parent 6f852e646c
commit 7192c9e68b
60 changed files with 994 additions and 683 deletions
--- a/lib/toolbox/cli/cli_ansi.c
+++ b/lib/toolbox/cli/cli_ansi.c
@@ -0,0 +1,123 @@
+#include "cli_ansi.h"
+
+typedef enum {
+    CliAnsiParserStateInitial,
+    CliAnsiParserStateEscape,
+    CliAnsiParserStateEscapeBrace,
+    CliAnsiParserStateEscapeBraceOne,
+    CliAnsiParserStateEscapeBraceOneSemicolon,
+    CliAnsiParserStateEscapeBraceOneSemicolonModifiers,
+} CliAnsiParserState;
+
+struct CliAnsiParser {
+    CliAnsiParserState state;
+    CliModKey modifiers;
+};
+
+CliAnsiParser* cli_ansi_parser_alloc(void) {
+    CliAnsiParser* parser = malloc(sizeof(CliAnsiParser));
+    return parser;
+}
+
+void cli_ansi_parser_free(CliAnsiParser* parser) {
+    free(parser);
+}
+
+/**
+ * @brief Converts a single character representing a special key into the enum
+ * representation
+ */
+static CliKey cli_ansi_key_from_mnemonic(char c) {
+    switch(c) {
+    case 'A':
+        return CliKeyUp;
+    case 'B':
+        return CliKeyDown;
+    case 'C':
+        return CliKeyRight;
+    case 'D':
+        return CliKeyLeft;
+    case 'F':
+        return CliKeyEnd;
+    case 'H':
+        return CliKeyHome;
+    default:
+        return CliKeyUnrecognized;
+    }
+}
+
+#define PARSER_RESET_AND_RETURN(parser, modifiers_val, key_val) \
+    do {                                                        \
+        parser->state = CliAnsiParserStateInitial;              \
+        return (CliAnsiParserResult){                           \
+            .is_done = true,                                    \
+            .result = (CliKeyCombo){                            \
+                .modifiers = modifiers_val,                     \
+                .key = key_val,                                 \
+            }};                                                 \
+    } while(0);
+
+CliAnsiParserResult cli_ansi_parser_feed(CliAnsiParser* parser, char c) {
+    switch(parser->state) {
+    case CliAnsiParserStateInitial:
+        // <key> -> <key>
+        if(c != CliKeyEsc) PARSER_RESET_AND_RETURN(parser, CliModKeyNo, c); // -V1048
+
+        // <ESC> ...
+        parser->state = CliAnsiParserStateEscape;
+        break;
+
+    case CliAnsiParserStateEscape:
+        // <ESC> <ESC> -> <ESC>
+        if(c == CliKeyEsc) PARSER_RESET_AND_RETURN(parser, CliModKeyNo, c);
+
+        // <ESC> <key> -> Alt + <key>
+        if(c != '[') PARSER_RESET_AND_RETURN(parser, CliModKeyAlt, c);
+
+        // <ESC> [ ...
+        parser->state = CliAnsiParserStateEscapeBrace;
+        break;
+
+    case CliAnsiParserStateEscapeBrace:
+        // <ESC> [ <key mnemonic> -> <key>
+        if(c != '1') PARSER_RESET_AND_RETURN(parser, CliModKeyNo, cli_ansi_key_from_mnemonic(c));
+
+        // <ESC> [ 1 ...
+        parser->state = CliAnsiParserStateEscapeBraceOne;
+        break;
+
+    case CliAnsiParserStateEscapeBraceOne:
+        // <ESC> [ 1 <non-;> -> error
+        if(c != ';') PARSER_RESET_AND_RETURN(parser, CliModKeyNo, CliKeyUnrecognized);
+
+        // <ESC> [ 1 ; ...
+        parser->state = CliAnsiParserStateEscapeBraceOneSemicolon;
+        break;
+
+    case CliAnsiParserStateEscapeBraceOneSemicolon:
+        // <ESC> [ 1 ; <modifiers> ...
+        parser->modifiers = (c - '0');
+        parser->modifiers &= ~1;
+        parser->state = CliAnsiParserStateEscapeBraceOneSemicolonModifiers;
+        break;
+
+    case CliAnsiParserStateEscapeBraceOneSemicolonModifiers:
+        // <ESC> [ 1 ; <modifiers> <key mnemonic> -> <modifiers> + <key>
+        PARSER_RESET_AND_RETURN(parser, parser->modifiers, cli_ansi_key_from_mnemonic(c));
+    }
+
+    return (CliAnsiParserResult){.is_done = false};
+}
+
+CliAnsiParserResult cli_ansi_parser_feed_timeout(CliAnsiParser* parser) {
+    CliAnsiParserResult result = {.is_done = false};
+
+    if(parser->state == CliAnsiParserStateEscape) {
+        result.is_done = true;
+        result.result.key = CliKeyEsc;
+        result.result.modifiers = CliModKeyNo;
+    }
+
+    parser->state = CliAnsiParserStateInitial;
+    return result;
+}