Update input.h

Author: dreamer-coding

code/logic/fossil/io/input.h

@@ -145,6 +145,48 @@ int fossil_io_validate_sanitize_string(const char *input, char *output, size_t o
  */
 int fossil_io_validate_read_secure_line(char *buffer, size_t buffer_size);
 
+/**
+ * Displays a menu of choices and returns the selected choice.
+ * 
+ * @param prompt The prompt message before displaying the menu.
+ * @param choices Array of strings representing the choices.
+ * @param num_choices The number of choices.
+ * @return The index of the selected choice.
+ */
+int fossil_io_display_menu(const char *prompt, const char *choices[], int num_choices);
+
+/**
+ * Reads a password from the user with masked input (e.g., asterisks).
+ * 
+ * @param buffer The buffer to store the password.
+ * @param size The maximum size of the buffer.
+ * @return 1 if password was successfully read, 0 otherwise.
+ */
+int fossil_io_read_password(char *buffer, size_t size);
+
+/**
+ * Reads multiline input from the user, allowing the user to press Enter to add new lines.
+ * 
+ * @param buffer The buffer to store the input.
+ * @param size The maximum size of the buffer.
+ * @return 1 if the input was successfully received, 0 otherwise.
+ */
+int fossil_io_read_multiline_input(char *buffer, size_t size);
+
+/**
+ * Reads a single character from the user without echoing to the screen.
+ * 
+ * @return The character entered by the user.
+ */
+char fossil_io_getch(void);
+
+/**
+ * Displays a simple progress bar.
+ * 
+ * @param progress The current progress (0-100).
+ */
+void fossil_io_show_progress(int progress);
+
 #ifdef __cplusplus
 }
 
@@ -320,6 +362,26 @@ namespace fossil {
                 return fossil_io_validate_read_secure_line(buffer, buffer_size);
             }
 
+            /**
+             * @brief Override the output stream operator to display Input object details.
+             * 
+             * @param os The output stream where data will be printed.
+             * @param input The Input object to display.
+             * @return The modified output stream.
+             */
+            friend std::ostream& operator<<(std::ostream& os, const Input& input) {
+                // Example of what to output: printing the state or some meaningful data
+                os << "Input Stream Details:\n";
+                os << " - Max Buffer Size: " << input.max_buffer_size << "\n";
+                os << " - Input Stream: " << (input.stream ? "Valid Stream" : "Invalid Stream") << "\n";
+                
+                // Return the output stream
+                return os;
+            }
+
+        private:
+            size_t max_buffer_size;  // Example private member
+            FILE* stream;            // Example stream (pointer to the input stream, like stdin)
         };
 
     }