Struct BoxDimensions 

pub struct BoxDimensions {
    pub total_bounds: Bounds,
    pub content_bounds: Bounds,
    pub viewable_width: usize,
    pub viewable_height: usize,
    pub content_width: usize,
    pub content_height: usize,
    pub horizontal_scroll: f64,
    pub vertical_scroll: f64,
    pub border_thickness: usize,
    pub tab_height: usize,
    pub vertical_scrollbar_width: usize,
    pub horizontal_scrollbar_height: usize,
}

Box dimensions and coordinate system definitions

This module formalizes the coordinate systems and size measurements for boxes:

• Box Span: Total space including borders, tabs, scrollbars, all attachments
• Content Area: Space available for renderable content (inside borders/scrollbars)
• Screen Coordinates: Absolute terminal coordinates (0,0 = top-left terminal)
• Inbox Coordinates: Content-local coordinates (0,0 = top-left content cell)

Fields

total_bounds: Bounds

Total box span including all attachments (borders, scrollbars, tabs)

content_bounds: Bounds

Content area bounds (where renderable content is placed)

viewable_width: usize

Dimensions of the viewable content area

viewable_height: usize

content_width: usize

Actual content dimensions (may exceed viewable area)

content_height: usize

horizontal_scroll: f64

Current scroll positions (0-100 percentage)

vertical_scroll: f64

border_thickness: usize

Border thickness

tab_height: usize

Tab bar height (if tabs are present)

vertical_scrollbar_width: usize

Scrollbar dimensions

horizontal_scrollbar_height: usize

Implementations

impl BoxDimensions

pub fn new( muxbox: &MuxBox, bounds: &Bounds, content_width: usize, content_height: usize, ) -> Self

Create new BoxDimensions from MuxBox state with explicit content size.

This is the single canonical coordinate authority shared by rendering and hit-testing. content_bounds is computed purely from the box’s border and tab presence (inclusive coordinates), and one column/row is always reserved for scrollbars so the viewable region never depends on whether a scrollbar happens to be visible. inbox_to_screen/screen_to_inbox are exact inverses over this region, so any cell a renderer draws via inbox_to_screen is hit-tested back to the same inbox coordinate.

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

Convert screen coordinates to box span coordinates Box span includes borders, tabs, scrollbars - the total area the box occupies

pub fn box_span_to_screen(&self, box_x: usize, box_y: usize) -> (usize, usize)

Convert box span coordinates to screen coordinates

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

Convert screen coordinates to inbox (content-local) coordinates. Exact inverse of inbox_to_screen over the viewable window. The viewable window is [content_left, content_left + viewable_width) horizontally and [content_top, content_top + viewable_height) vertically, so the last viewable cell is reachable (no off-by-one) and the reserved scrollbar column/row is excluded.

pub fn inbox_to_screen(&self, inbox_x: usize, inbox_y: usize) -> (usize, usize)

Convert inbox coordinates to screen coordinates. Returns (usize::MAX, usize::MAX) when the inbox cell is outside content or scrolled out of the viewable window. Exact inverse of screen_to_inbox.

pub fn contains_screen_point(&self, screen_x: usize, screen_y: usize) -> bool

Check if screen coordinates are within the content area

pub fn contains_screen_point_in_span( &self, screen_x: usize, screen_y: usize, ) -> bool

Check if screen coordinates are within the total box span

pub fn calculate_from_muxbox(muxbox: &MuxBox, total_bounds: Bounds) -> Self

Calculate BoxDimensions from MuxBox and bounds

pub fn is_inbox_visible(&self, inbox_x: usize, inbox_y: usize) -> bool

Check if inbox coordinates are currently visible in the viewable area

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

Get the visible inbox region (scroll window)

Trait Implementations

impl Clone for BoxDimensions

fn clone(&self) -> BoxDimensions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BoxDimensions

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

Formats the value using the given formatter.