Display Utilities

Display utilities for terminal interfaces.

This module provides utilities for calculating display dimensions and managing terminal interface layouts.

simulchip.display.calculate_viewport_size(console, interface_type='default')

Calculate optimal viewport size based on terminal height and interface type.

Parameters:

• console (Console) – Rich console instance

• interface_type (str) – Type of interface (“pack”, “card”, or “default”)

Return type:

int

Returns:

Number of table rows that can fit in the terminal

simulchip.display.calculate_viewport_window(selected_idx, total_items, viewport_size)

Calculate viewport window start and end positions.

Parameters:

• selected_idx (int) – Currently selected item index

• total_items (int) – Total number of items

• viewport_size (int) – Size of the viewport

Return type:

Dict[str, int]

Returns:

Dictionary with ‘start’ and ‘end’ keys for viewport window

simulchip.display.format_viewport_status(selected_idx, total_items, viewport_start, viewport_end, viewport_size)

Format viewport status text for display.

Parameters:

• selected_idx (int) – Currently selected item index

• total_items (int) – Total number of items

• viewport_start (int) – Start of viewport window

• viewport_end (int) – End of viewport window

• viewport_size (int) – Size of the viewport

Return type:

str

Returns:

Formatted status string

simulchip.display.get_completion_color(completion_percentage)

Get color for completion percentage display.

Parameters:

completion_percentage (float) – Completion percentage (0-100)

Return type:

str

Returns:

Color string for rich console display