--- lbbs/include/screen.h	2025/04/30 09:19:42	1.1
+++ lbbs/include/screen.h	2025/11/07 13:22:57	1.23
@@ -1,48 +1,61 @@
-/***************************************************************************
-                            screen.h  -  description
-                             -------------------
-    begin                : Mon Oct 18 2004
-    copyright            : (C) 2004 by Leaflet
-    email                : leaflet@leafok.com
- ***************************************************************************/
-
-/***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
+/* SPDX-License-Identifier: GPL-3.0-or-later */
+/*
+ * screen
+ *   - advanced telnet-based user interactive input / output features
+ *
+ * Copyright (C) 2004-2025  Leaflet <leaflet@leafok.com>
+ */
 
 #ifndef _SCREEN_H_
 #define _SCREEN_H_
 
-extern void moveto(int row, int col);
+#include "io.h"
+#include <stddef.h>
 
-extern void clrtoeol();
+extern const char CTRL_SEQ_CLR_LINE[];
 
-extern void clrline(int line_begin, int line_end);
+enum display_constant_t
+{
+   MSG_EXT_MAX_LEN = 400,
+};
+
+struct display_ctx_t
+{
+   int reach_begin;
+   int reach_end;
+   long line_top;
+   long line_bottom;
+   char msg[MSG_EXT_MAX_LEN];
+};
+typedef struct display_ctx_t DISPLAY_CTX;
 
-extern void clrtobot(int line_begin);
+typedef int (*display_data_key_handler)(int *p_key, DISPLAY_CTX *p_ctx);
 
+extern void moveto(int row, int col);
+extern void clrtoeol();
+extern void clrline(int line_begin, int line_end);
+extern void clrtobot(int line_begin);
 extern void clearscr();
 
 extern int press_any_key();
+extern int press_any_key_ex(const char *msg, int sec);
 
 extern void set_input_echo(int echo);
 
-extern int str_input(char *buffer, int buffer_length, int echo_mode);
-
-extern int get_data(int row, int col, char *prompt, char *buffer, int buffer_length, int echo_mode);
-
-extern int display_file(const char *filename);
+extern int str_input(char *buffer, int buffer_length, enum io_echo_t echo_mode);
+extern int get_data(int row, int col, char *prompt, char *buffer, int buffer_length, int max_display_len);
 
-extern int display_file_ex(const char *filename, int begin_line, int wait);
+// eof_exit = 0 : Do not exit at EOF
+//            1 : Prompt for any key at EOF, then exit
+//            2 : Exit at EOF without prompt
+extern int display_data(const void *p_data, long display_line_total, const long *p_line_offsets, int eof_exit,
+                        display_data_key_handler key_handler, const char *help_filename);
+extern int display_file(const char *filename, int eof_exit);
 
-extern int show_top(char *status);
+extern int display_file_key_handler(int *p_key, DISPLAY_CTX *p_ctx);
 
-extern int show_bottom(char *msg);
+extern int show_top(const char *str_left, const char *str_center, const char *str_right);
+extern int show_bottom(const char *msg);
 
 extern int show_active_board();