Struct MouseDimensions 

pub struct MouseDimensions { /* private fields */ }

MouseDimensions - Centralizes ALL mouse coordinate translation and hit testing

Eliminates ad hoc coordinate math like:

• column as usize, row as usize conversions from crossterm
• inbox_x = screen_x.saturating_sub(content_start_x.saturating_sub(horizontal_offset))
• Complex coordinate system translations between screen, content, and scrolled spaces
• Hit testing scattered across multiple files

Replaces scattered coordinate translation from box_renderer.rs, draw_loop.rs, input_loop.rs

Implementations

impl MouseDimensions

pub fn new( screen_bounds: Bounds, content_bounds: Bounds, scroll_offset: (usize, usize), content_size: (usize, usize), ) -> Self

Create new mouse dimensions

pub fn set_scroll_offset(&mut self, horizontal: usize, vertical: usize)

Update scroll offset

pub fn crossterm_to_internal(&self, column: u16, row: u16) -> (usize, usize)

Convert crossterm coordinates (u16) to internal coordinates (usize) Centralizes: column as usize, row as usize conversions

pub fn internal_to_crossterm(&self, x: usize, y: usize) -> (u16, u16)

Convert internal coordinates back to crossterm (for event generation)

pub fn is_within_screen_bounds(&self, x: usize, y: usize) -> bool

Test if screen coordinates are within component bounds

pub fn is_within_content_bounds(&self, x: usize, y: usize) -> bool

Test if screen coordinates are within content area

pub fn screen_to_content( &self, screen_x: usize, screen_y: usize, ) -> Option<(usize, usize)>

Convert screen coordinates to content coordinates (accounting for scroll) Centralizes complex translation logic from box_renderer.rs

pub fn content_to_screen( &self, content_x: usize, content_y: usize, ) -> Option<(usize, usize)>

Convert content coordinates to screen coordinates (reverse translation)

pub fn get_visible_content_range(&self) -> ((usize, usize), (usize, usize))

Get the content coordinate range that’s currently visible

pub fn is_content_coordinate_visible( &self, content_x: usize, content_y: usize, ) -> bool

Test if content coordinates are currently visible on screen

pub fn screen_y_to_content_line(&self, screen_y: usize) -> Option<usize>

Calculate which content line a screen Y coordinate corresponds to Useful for text selection and choice navigation

pub fn screen_x_to_content_column(&self, screen_x: usize) -> Option<usize>

Calculate which content column a screen X coordinate corresponds to
Useful for text cursor positioning

pub fn detect_click_region(&self, x: usize, y: usize) -> ClickRegion

Calculate click regions for UI components Centralizes region detection logic

pub fn calculate_distance( &self, x1: usize, y1: usize, x2: usize, y2: usize, ) -> f64

Calculate distance between two points (for drag detection)

pub fn is_drag_operation( &self, start_x: usize, start_y: usize, current_x: usize, current_y: usize, threshold: f64, ) -> bool

Test if mouse movement constitutes a drag (beyond threshold)

pub fn calculate_selection_bounds( &self, start_x: usize, start_y: usize, end_x: usize, end_y: usize, ) -> SelectionBounds

Calculate bounding box for a selection region

pub fn clamp_to_screen_bounds(&self, x: usize, y: usize) -> (usize, usize)

Clamp coordinates to valid screen bounds Prevents out-of-bounds coordinate issues

pub fn clamp_to_content_bounds(&self, x: usize, y: usize) -> (usize, usize)

Clamp coordinates to valid content bounds

pub fn calculate_scroll_to_visible( &self, content_x: usize, content_y: usize, ) -> (i32, i32)

Calculate scroll delta needed to make content coordinate visible

pub fn update_bounds(&mut self, screen_bounds: Bounds, content_bounds: Bounds)

Update mouse dimensions for window/content resize

pub fn update_content_size(&mut self, width: usize, height: usize)

Update content size (when content changes)

Trait Implementations

impl Clone for MouseDimensions

fn clone(&self) -> MouseDimensions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MouseDimensions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.