Struct Resizer

pub struct Resizer {
    pub table_width: i32,
    pub table_height: i32,
    pub headers: Vec<String>,
    pub all_rows: Vec<Vec<String>>,
    pub row_heights: Vec<usize>,
    pub columns: Vec<ResizerColumn>,
    pub wrap: bool,
    pub border_column: bool,
    pub y_paddings: Vec<Vec<usize>>,
}

A comprehensive table resizing engine that calculates optimal layouts.

The Resizer analyzes table content, applies constraints, and computes the best possible layout for tables within specified dimensions. It handles content analysis, width distribution, padding calculations, and height management to create well-formatted tables.

Fields

table_width: i32

Target width for the entire table in characters.

table_height: i32

Target height for the table (used for height constraints).

headers: Vec<String>

Column headers as strings (empty if no headers).

all_rows: Vec<Vec<String>>

All table rows including headers, organized as vectors of cell content.

row_heights: Vec<usize>

Calculated height for each row in the table.

columns: Vec<ResizerColumn>

Column analysis data with width statistics and content.

wrap: bool

Whether text wrapping is enabled for content that exceeds column width.

border_column: bool

Whether column separators/borders are enabled between columns.

y_paddings: Vec<Vec<usize>>

Vertical padding requirements for each cell, organized by row.

Implementations

impl Resizer

pub fn new( table_width: i32, table_height: i32, headers: Vec<String>, rows: Vec<Vec<String>>, ) -> Self

Creates a new table resizer with the specified dimensions and content.

This constructor initializes a complete resizing system that analyzes the provided table content to determine optimal column widths and row heights. It processes both headers and data rows, calculating statistical information (min, max, median) for each column to enable intelligent resizing decisions.

The resizer automatically:

• Combines headers and data rows into a unified structure
• Creates ResizerColumn instances for each column in the content
• Calculates width statistics (min, max, median) for each column
• Prepares the foundation for width optimization algorithms

Arguments

• table_width - Target width for the entire table in characters
• table_height - Target height for the table (used for future height constraints)
• headers - Column headers as strings (can be empty if no headers)
• rows - Data rows, where each row is a vector of cell content strings

Returns

Returns a new Resizer instance ready for width optimization, with:

• All content processed and stored in all_rows
• Column analysis completed with width statistics
• Default settings for wrapping and borders enabled

Examples

use lipgloss_table::resizing::Resizer;

let headers = vec!["Name".to_string(), "Age".to_string()];
let rows = vec![
    vec!["Alice".to_string(), "30".to_string()],
    vec!["Bob".to_string(), "25".to_string()],
];

let resizer = Resizer::new(80, 24, headers, rows);
assert_eq!(resizer.table_width, 80);
assert_eq!(resizer.columns.len(), 2);
assert_eq!(resizer.all_rows.len(), 3); // headers + 2 data rows

Notes

• If headers is empty, only data rows will be processed
• The number of columns is determined by the row with the most cells
• Column width calculations use Unicode-aware width detection
• The resizer defaults to enabling text wrapping and column borders

pub fn default_row_heights(&self) -> Vec<usize>

Returns the default row heights (all 1).

pub fn detect_table_width(&self) -> i32

Detects the table width automatically based on content.

pub fn max_total(&self) -> usize

Returns the total width with maximum column widths.

pub fn max_column_widths(&self) -> Vec<usize>

Returns the maximum column widths.

pub fn total_horizontal_border(&self) -> usize

Calculates total horizontal border width.

pub fn optimized_widths(&mut self) -> (Vec<usize>, Vec<usize>)

Main method to get optimized column widths and row heights.

Trait Implementations

impl Debug for Resizer

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

Formats the value using the given formatter.