terminal.c File Reference

Terminal function stubs for WASM (functions not needed for mirror mode) More...

Go to the source code of this file.

Functions
asciichat_error_t	terminal_get_size (terminal_size_t *size)
	Get terminal size.
asciichat_error_t	terminal_cursor_hide (void)
	Hide terminal cursor.
asciichat_error_t	terminal_cursor_show (void)
	Show terminal cursor.
unsigned short int	terminal_get_effective_width (void)
	Get effective terminal width with fallback priority.
unsigned short int	terminal_get_effective_height (void)
	Get effective terminal height with fallback priority.
asciichat_error_t	terminal_fd_reader_create (int fd, int frame_height, terminal_fd_reader_t **out)
	Create a terminal FD reader from a file descriptor.
void	terminal_fd_reader_destroy (terminal_fd_reader_t *reader)
	Destroy terminal FD reader.
asciichat_error_t	terminal_fd_reader_next (terminal_fd_reader_t *reader, char **out_frame)
	Read next frame from file descriptor.

Detailed Description

Terminal function stubs for WASM (functions not needed for mirror mode)

Terminal control and cursor movement functions are implemented in wasm/terminal.c via ANSI escape sequences. This file contains only the stubs that return errors or no-ops for operations not supported in the browser environment.

Definition in file platform/wasm/stubs/terminal.c.

Function Documentation

terminal_fd_reader_create()

asciichat_error_t terminal_fd_reader_create	(	int	fd,
		int	frame_height,
		terminal_fd_reader_t **	out
	)

Create a terminal FD reader from a file descriptor.

Parameters

fd	File descriptor to read from (e.g., STDIN_FILENO, open file)
frame_height	Number of lines per frame (required - used for frame boundaries)
out	Pointer to store reader context

Returns

ASCIICHAT_OK on success

Width is auto-detected from the first frame's line length.

Definition at line 51 of file platform/wasm/stubs/terminal.c.

                                                                                                  {
  (void)fd;
  (void)frame_height;
  if (out)
    *out = NULL;
  return ASCIICHAT_OK; // Stub - no stdin available in WASM
}

References ASCIICHAT_OK.

Referenced by session_client_like_run().

terminal_fd_reader_destroy()

void terminal_fd_reader_destroy

(

terminal_fd_reader_t *

reader

)

Destroy terminal FD reader.

Parameters

reader

Reader context to destroy

Definition at line 59 of file platform/wasm/stubs/terminal.c.

                                                              {
  (void)reader;
  // No-op
}

Referenced by session_client_like_run().

terminal_fd_reader_next()

asciichat_error_t terminal_fd_reader_next	(	terminal_fd_reader_t *	reader,
		char **	out_frame
	)

Read next frame from file descriptor.

Reads frame_height lines from the FD and returns them as a single frame string. Returns NULL in out_frame when EOF is reached.

Parameters

reader	Reader context
out_frame	Pointer to store frame data (NULL when EOF, must free with SAFE_FREE)

Returns

ASCIICHAT_OK on success (including EOF)

Definition at line 64 of file platform/wasm/stubs/terminal.c.

                                                                                          {
  (void)reader;
  if (out_frame)
    *out_frame = NULL; // Signal EOF immediately
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK.

terminal_get_effective_height()

unsigned short int terminal_get_effective_height

(

void

)

Get effective terminal height with fallback priority.

Returns

Terminal height in characters with priority: option → detected → default

Returns the effective terminal height to use, checking in priority order:

1. Option value: If --height was set to a non-zero value, return it
2. Detected size: Try to detect actual terminal height via terminal_get_size()
3. Default: Return OPT_HEIGHT_DEFAULT (70) as final fallback

This function simplifies the common pattern of "use option if set, else detect, else use default" that appears throughout the codebase for terminal dimension handling.

Note

Safe to call from any thread (uses lock-free option access)

Detection may fail on non-TTY output (piped/redirected), falls back gracefully

Height option defaults to 0, so non-zero means it was explicitly set

Usage Example:

// Old pattern (scattered throughout code):
unsigned short int height = GET_OPTION(height);
if (height == 0) {
    terminal_size_t size;
    if (terminal_get_size(&size) == ASCIICHAT_OK) {
        height = size.rows;
    } else {
        height = OPT_HEIGHT_DEFAULT;
    }
}
 
// New pattern (unified):
unsigned short int height = terminal_get_effective_height();

Returns height in priority order:

1. Option height if set to non-zero value
2. Detected terminal height
3. OPT_HEIGHT_DEFAULT fallback

Definition at line 39 of file platform/wasm/stubs/terminal.c.

                                                       {
  int height = GET_OPTION(height);
  if (height > 0) {
    return (unsigned short int)height;
  }
  // For WASM, use default since terminal detection is stubbed
  return OPT_HEIGHT_DEFAULT;
}

References GET_OPTION, and OPT_HEIGHT_DEFAULT.

terminal_get_effective_width()

unsigned short int terminal_get_effective_width

(

void

)

Get effective terminal width with fallback priority.

Returns

Terminal width in characters with priority: option → detected → default

Returns the effective terminal width to use, checking in priority order:

1. Option value: If --width was set to a non-zero value, return it
2. Detected size: Try to detect actual terminal width via terminal_get_size()
3. Default: Return OPT_WIDTH_DEFAULT (110) as final fallback

This function simplifies the common pattern of "use option if set, else detect, else use default" that appears throughout the codebase for terminal dimension handling.

Note

Safe to call from any thread (uses lock-free option access)

Detection may fail on non-TTY output (piped/redirected), falls back gracefully

Width option defaults to 0, so non-zero means it was explicitly set

Usage Example:

// Old pattern (scattered throughout code):
unsigned short int width = GET_OPTION(width);
if (width == 0) {
    terminal_size_t size;
    if (terminal_get_size(&size) == ASCIICHAT_OK) {
        width = size.cols;
    } else {
        width = OPT_WIDTH_DEFAULT;
    }
}
 
// New pattern (unified):
unsigned short int width = terminal_get_effective_width();

Returns width in priority order:

1. Option width if set to non-zero value
2. Detected terminal width
3. OPT_WIDTH_DEFAULT fallback

Definition at line 29 of file platform/wasm/stubs/terminal.c.

                                                      {
  int width = GET_OPTION(width);
  if (width > 0) {
    return (unsigned short int)width;
  }
  // For WASM, use default since terminal detection is stubbed
  return OPT_WIDTH_DEFAULT;
}

References GET_OPTION, and OPT_WIDTH_DEFAULT.