markdown-tui-explorer 0.7.0

A terminal-based markdown file browser and viewer with search, syntax highlighting, and live reload
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

pub mod config_popup;
pub mod doc_search_bar;
pub mod file_tree;
pub mod goto_line_bar;
pub mod help;
pub mod markdown_view;
pub mod search_bar;
pub mod status_bar;
pub mod tab_bar;
pub mod tab_picker;
pub mod table_modal;
pub mod table_render;
pub mod tabs;

use crate::app::{App, Focus};
use ratatui::{
    Frame,
    layout::{Constraint, Direction, Layout},
};

pub fn draw(f: &mut Frame, app: &mut App) {
    let area = f.area();

    // Clear stale rects at the start of each draw so hit-tests against the
    // previous frame's layout never fire.
    app.tree_area_rect = None;
    app.viewer_area_rect = None;
    app.tab_bar_rects.clear();
    app.tab_picker_rects.clear();

    let outer_chunks = Layout::default()
        .direction(Direction::Vertical)
        .constraints([
            Constraint::Min(1),
            Constraint::Length(if app.search.active { 3 } else { 0 }),
            Constraint::Length(1),
        ])
        .split(area);

    let has_tabs = !app.tabs.is_empty();
    let tab_bar_height: u16 = if has_tabs { 1 } else { 0 };

    let viewer_area;

    if app.tree_hidden {
        // No tree panel — tab bar spans the full content width.
        let content_chunks = Layout::default()
            .direction(Direction::Vertical)
            .constraints([Constraint::Length(tab_bar_height), Constraint::Min(1)])
            .split(outer_chunks[0]);

        if has_tabs {
            tab_bar::draw(f, app, content_chunks[0]);
        }

        viewer_area = content_chunks[1];
        app.viewer_area_rect = Some(viewer_area);

        markdown_view::draw(f, app, viewer_area, is_viewer_focused(app.focus));
    } else {
        let main_chunks = Layout::default()
            .direction(Direction::Horizontal)
            .constraints([
                Constraint::Percentage(app.tree_width_pct),
                Constraint::Percentage(100 - app.tree_width_pct),
            ])
            .split(outer_chunks[0]);

        let tree_area = main_chunks[0];
        let viewer_col = main_chunks[1];

        file_tree::draw(f, app, tree_area, app.focus == Focus::Tree);
        app.tree_area_rect = Some(tree_area);

        // Tab bar sits above the viewer within the viewer column.
        let viewer_col_chunks = Layout::default()
            .direction(Direction::Vertical)
            .constraints([Constraint::Length(tab_bar_height), Constraint::Min(1)])
            .split(viewer_col);

        if has_tabs {
            tab_bar::draw(f, app, viewer_col_chunks[0]);
        }

        viewer_area = viewer_col_chunks[1];
        app.viewer_area_rect = Some(viewer_area);

        markdown_view::draw(f, app, viewer_area, is_viewer_focused(app.focus));
    }

    if app.search.active {
        search_bar::draw(f, app, outer_chunks[1]);
    }

    status_bar::draw(f, app, outer_chunks[2]);

    let doc_search_active = app.doc_search().map(|ds| ds.active).unwrap_or(false);
    if doc_search_active {
        doc_search_bar::draw(f, app, viewer_area);
    }

    if app.goto_line.active {
        goto_line_bar::draw(f, app, viewer_area);
    }

    if app.show_help {
        help::draw(f, app);
    }

    if app.tab_picker.is_some() {
        tab_picker::draw(f, app);
    }

    if app.table_modal.is_some() {
        table_modal::draw(f, app);
    }

    if let Some(popup_state) = &app.config_popup {
        let popup_state = popup_state.clone();
        config_popup::render_config_popup(
            f,
            &popup_state,
            app.theme,
            app.show_line_numbers,
            &app.palette,
        );
    }
}

/// Returns `true` when the viewer panel should render as focused.
fn is_viewer_focused(focus: Focus) -> bool {
    matches!(
        focus,
        Focus::Viewer
            | Focus::DocSearch
            | Focus::Config
            | Focus::GotoLine
            | Focus::TabPicker
            | Focus::TableModal
    )
}