[FL-1498] Keyboard save focus (#730)

* text_input: set focus on Save button if text is set
* text_input: add clear API, format documentation
* all: rework text input clean with new API

applications/gui/modules/text_input.h

@@ -9,32 +9,31 @@ extern "C" {
 typedef struct TextInput TextInput;
 typedef void (*TextInputCallback)(void* context);
 
-/** 
- * @brief Allocate and initialize text input
- *        This text input is used to enter string
- * 
+/** Allocate and initialize text input
+ * This text input is used to enter string
+ * @return TextInput instance
  */
 TextInput* text_input_alloc();
 
-/** 
- * @brief Deinitialize and free text input
- * 
- * @param text_input - Text input instance
+/** Deinitialize and free text input
+ * @param text_input - TextInput instance
  */
 void text_input_free(TextInput* text_input);
 
-/**
- * @brief Get text input view
- * 
+/** Clean text input view
+ * Note: this function does not free memory
  * @param text_input - Text input instance
+ */
+void text_input_clean(TextInput* text_input);
+
+/** Get text input view
+ * @param text_input - TextInput instance
  * @return View instance that can be used for embedding
  */
 View* text_input_get_view(TextInput* text_input);
 
-/**
- * @brief Set text input result callback
- * 
- * @param text_input - Text input instance
+/** Set text input result callback
+ * @param text_input - TextInput instance
  * @param callback - callback fn
  * @param callback_context - callback context
  * @param text_buffer - pointer to YOUR text buffer, that we going to modify
@@ -49,10 +48,8 @@ void text_input_set_result_callback(
     size_t text_buffer_size,
     bool clear_default_text);
 
-/** 
- * @brief Set text input header text
- * 
- * @param text input - Text input instance
+/** Set text input header text
+ * @param text_input - TextInput instance
  * @param text - text to be shown
  */
 void text_input_set_header_text(TextInput* text_input, const char* text);