Struct App 

pub struct App {

    pub state: AppState,
    pub scan_mode: ScanMode,
    pub menu_index: usize,
    pub projects: Vec<ProjectEntry>,
    pub caches: Vec<CacheEntry>,
    pub cleaners: Vec<CleanerEntry>,
    pub selected: usize,
    pub scroll_offset: usize,
    pub expanded: HashSet<usize>,
    pub status_message: Option<String>,
    pub should_quit: bool,
    pub show_help: bool,
    pub current_tab: usize,
    pub tabs: Vec<String>,
    pub search_query: String,
    pub is_searching: bool,
    pub scan_paths: Vec<PathBuf>,
    pub scan_progress: f64,
    pub scan_message: String,
    pub dirs_scanned: usize,
    pub total_size: u64,
    pub anim_frame: usize,
    pub permanent_delete: bool,
    pub pending_delete_items: Vec<(PathBuf, Option<String>)>,
    /* private fields */
}

Main TUI application state

Fields

state: AppState

Current screen/state

scan_mode: ScanMode

Selected scan mode

menu_index: usize

Menu selection index (for ready screen)

projects: Vec<ProjectEntry>

Projects to display

caches: Vec<CacheEntry>

Caches to display

cleaners: Vec<CleanerEntry>

Cleaner items to display

selected: usize

Currently selected index

scroll_offset: usize

Scroll offset for the list

expanded: HashSet<usize>

Expanded project indices

status_message: Option<String>

Status message

should_quit: bool

Should quit

show_help: bool

Show help popup

current_tab: usize

Current tab/category

tabs: Vec<String>

Available tabs

search_query: String

Search query

is_searching: bool

Is searching

scan_paths: Vec<PathBuf>

Scan paths

scan_progress: f64

Scan progress (0.0 - 1.0)

scan_message: String

Scan message

dirs_scanned: usize

Directories scanned

total_size: u64

Total size found

anim_frame: usize

Animation frame counter

permanent_delete: bool

Use permanent delete (rm -rf) instead of trash

pending_delete_items: Vec<(PathBuf, Option<String>)>

Items pending deletion (path, optional clean_command)

Implementations

impl App

pub fn new(paths: Vec<PathBuf>) -> Self

Create a new app with scan paths

pub fn toggle_permanent_delete(&mut self)

Toggle permanent delete option

pub fn tick_animation(&mut self)

Tick the animation frame (call on every tick for smooth animations)

pub fn menu_up(&mut self)

Move menu selection up

pub fn menu_down(&mut self)

Move menu selection down

pub fn start_scan(&mut self)

Start scanning based on current mode

pub fn check_scan_progress(&mut self)

Check for scan updates (call this on tick)

pub fn select_up(&mut self)

Move selection up

pub fn select_down(&mut self)

Move selection down

pub fn page_up(&mut self, page_size: usize)

Page up

pub fn page_down(&mut self, page_size: usize)

Page down

pub fn go_top(&mut self)

Go to top

pub fn go_bottom(&mut self)

Go to bottom

pub fn ensure_visible_with_height(&mut self, viewport_height: usize)

Ensure selected item is visible with viewport height

pub fn toggle_select(&mut self)

Toggle selection of current item

pub fn toggle_expand(&mut self)

Toggle expanded state of current item

pub fn expand(&mut self)

Expand current item (right arrow)

pub fn collapse(&mut self)

Collapse current item (left arrow)

pub fn scroll_up(&mut self)

Scroll up by one item

pub fn scroll_down(&mut self)

Scroll down by one item

pub fn select_all(&mut self)

Select all visible items

pub fn deselect_all(&mut self)

Deselect all items

pub fn visible_projects(&self) -> Vec<&ProjectEntry>

Get visible projects

pub fn visible_count(&self) -> usize

Count visible projects

pub fn selected_projects(&self) -> Vec<&ProjectEntry>

Get selected projects

pub fn selected_size(&self) -> u64

Get total selected size

pub fn selected_count(&self) -> usize

Get number of selected items

pub fn filter_by_tab(&mut self)

Filter projects by current tab

pub fn next_tab(&mut self)

Switch to next tab

pub fn prev_tab(&mut self)

Switch to previous tab

pub fn toggle_help(&mut self)

Toggle help

pub fn start_search(&mut self)

Enter search mode

pub fn end_search(&mut self)

Exit search mode

pub fn search_push(&mut self, c: char)

Add character to search query

pub fn search_pop(&mut self)

Remove last character from search query

pub fn current_project(&self) -> Option<&ProjectEntry>

Get current project (selected)

pub fn is_expanded(&self, visible_index: usize) -> bool

Is project expanded

pub fn request_delete(&mut self)

Request deletion confirmation

pub fn cancel_delete(&mut self)

Cancel deletion

pub fn start_delete(&mut self)

Start deletion - collects paths and sets Cleaning state Actual deletion happens on next tick to allow UI to render

pub fn has_pending_delete(&self) -> bool

Check if we have pending deletions to process

pub fn take_pending_delete_items(&mut self) -> Vec<(PathBuf, Option<String>)>

Take pending delete items (clears them)

pub fn deletion_complete( &mut self, success_count: usize, fail_count: usize, freed: u64, )

Mark deletion complete

pub fn go_back(&mut self)

Go back to menu

Trait Implementations

impl Default for App

fn default() -> Self

Returns the “default value” for a type.