Struct App 

pub struct App {

    pub document: Document,
    pub filename: String,
    pub tree: Vec<HeadingNode>,
    pub outline_state: ListState,
    pub outline_scroll_state: ScrollbarState,
    pub focus: Focus,
    pub outline_items: Vec<OutlineItem>,
    pub content_scroll: u16,
    pub content_scroll_state: ScrollbarState,
    pub content_height: u16,
    pub content_viewport_height: u16,
    pub show_help: bool,
    pub help_scroll: u16,
    pub show_search: bool,
    pub outline_search_active: bool,
    pub search_query: String,
    pub highlighter: SyntaxHighlighter,
    pub show_outline: bool,
    pub outline_width: u16,
    pub bookmark_position: Option<String>,
    pub current_theme: ThemeName,
    pub theme: Theme,
    pub show_theme_picker: bool,
    pub theme_picker_selected: usize,
    pub theme_picker_original: Option<ThemeName>,
    pub mode: AppMode,
    pub count_prefix: Option<usize>,
    pub current_file_path: PathBuf,
    pub file_path_changed: bool,
    pub suppress_file_watch: bool,
    pub links_in_view: Vec<Link>,
    pub filtered_link_indices: Vec<usize>,
    pub selected_link_idx: Option<usize>,
    pub link_search_query: String,
    pub link_search_active: bool,
    pub file_history: Vec<FileState>,
    pub file_future: Vec<FileState>,
    pub status_message: Option<String>,
    pub status_message_time: Option<Instant>,
    pub interactive_state: InteractiveState,
    pub cell_edit_value: String,
    pub cell_edit_original_value: String,
    pub cell_edit_row: usize,
    pub cell_edit_col: usize,
    pub pending_edits: Vec<PendingEdit>,
    pub has_unsaved_changes: bool,
    pub pending_editor_file: Option<PathBuf>,
    pub show_raw_source: bool,
    pub pending_file_create: Option<PathBuf>,
    pub pending_file_create_message: Option<String>,
    pub doc_search_query: String,
    pub doc_search_matches: Vec<SearchMatch>,
    pub doc_search_current_idx: Option<usize>,
    pub doc_search_active: bool,
    pub doc_search_from_interactive: bool,
    pub doc_search_selected_link_idx: Option<usize>,
    pub command_query: String,
    pub command_filtered: Vec<usize>,
    pub command_selected: usize,
    pub keybindings: Keybindings,
    pub pending_navigation: Option<PendingNavigation>,
    /* private fields */
}

Fields

document: Document

filename: String

tree: Vec<HeadingNode>

outline_state: ListState

outline_scroll_state: ScrollbarState

focus: Focus

outline_items: Vec<OutlineItem>

content_scroll: u16

content_scroll_state: ScrollbarState

content_height: u16

content_viewport_height: u16

show_help: bool

help_scroll: u16

show_search: bool

outline_search_active: bool

search_query: String

highlighter: SyntaxHighlighter

show_outline: bool

outline_width: u16

bookmark_position: Option<String>

current_theme: ThemeName

theme: Theme

show_theme_picker: bool

theme_picker_selected: usize

theme_picker_original: Option<ThemeName>

mode: AppMode

count_prefix: Option<usize>

Vim-style count prefix for motion commands (e.g., 5j moves down 5)

current_file_path: PathBuf

file_path_changed: bool

suppress_file_watch: bool

links_in_view: Vec<Link>

filtered_link_indices: Vec<usize>

selected_link_idx: Option<usize>

link_search_query: String

link_search_active: bool

file_history: Vec<FileState>

file_future: Vec<FileState>

status_message: Option<String>

status_message_time: Option<Instant>

interactive_state: InteractiveState

cell_edit_value: String

cell_edit_original_value: String

cell_edit_row: usize

cell_edit_col: usize

pending_edits: Vec<PendingEdit>

has_unsaved_changes: bool

pending_editor_file: Option<PathBuf>

show_raw_source: bool

pending_file_create: Option<PathBuf>

pending_file_create_message: Option<String>

doc_search_query: String

doc_search_matches: Vec<SearchMatch>

doc_search_current_idx: Option<usize>

doc_search_active: bool

doc_search_from_interactive: bool

doc_search_selected_link_idx: Option<usize>

command_query: String

command_filtered: Vec<usize>

command_selected: usize

keybindings: Keybindings

pending_navigation: Option<PendingNavigation>

Implementations

impl App

pub fn new( document: Document, filename: String, file_path: PathBuf, config: Config, color_mode: ColorMode, ) -> Self

pub fn set_viewport_height(&mut self, height: u16)

Update the content viewport height (called by UI when terminal size is known)

pub fn current_keybinding_mode(&self) -> KeybindingMode

Get the current keybinding mode based on app state

pub fn get_action_for_key( &mut self, code: KeyCode, modifiers: KeyModifiers, ) -> Option<Action>

Get the action for a key press in the current mode

pub fn execute_action(&mut self, action: Action) -> ActionResult

Execute an action, returning the result type

Returns:

• ActionResult::Continue - continue the main loop
• ActionResult::Quit - exit the application
• ActionResult::RunEditor(PathBuf, Option<u32>) - run editor on file at optional line

pub fn toggle_raw_source(&mut self)

Toggle between raw source view and rendered markdown view

pub fn set_status_message(&mut self, msg: &str)

Set a status message with automatic timeout tracking

pub fn clear_expired_status_message(&mut self)

Clear status message if it has expired (default 1 second timeout)

pub fn accumulate_count_digit(&mut self, digit: char) -> bool

Accumulate a digit into the vim-style count prefix Returns true if the digit was handled as a count prefix

pub fn take_count(&mut self) -> usize

Get and consume the count prefix, returning at least 1

pub fn clear_count(&mut self)

Clear the count prefix without consuming it

pub fn has_count(&self) -> bool

Check if there’s an active count prefix

pub fn update_content_metrics(&mut self)

Update content height based on current selection and reset scroll if selection changed

pub fn next(&mut self)

pub fn previous(&mut self)

pub fn first(&mut self)

pub fn last(&mut self)

pub fn jump_to_parent(&mut self)

pub fn toggle_help(&mut self)

pub fn scroll_help_down(&mut self)

pub fn scroll_help_up(&mut self)

pub fn scroll_help_page_down(&mut self)

Scroll help popup down by half a page

pub fn scroll_help_page_up(&mut self)

Scroll help popup up by half a page

pub fn toggle_search(&mut self)

pub fn toggle_search_mode(&mut self)

Toggle between outline search and document search, preserving the query. After search is accepted (Enter pressed), Tab cycles through matches instead.

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

pub fn search_backspace(&mut self)

pub fn filter_outline(&mut self)

pub fn enter_doc_search(&mut self)

Enter document search mode (activated by / when content is focused or in interactive mode) If in accepted outline search state, re-enter outline search input instead If already in accepted doc search state, re-enter doc search input

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

Add a character to the document search query

pub fn doc_search_backspace(&mut self)

Remove the last character from the document search query

pub fn update_doc_search_matches(&mut self)

Update search matches based on current query (supports fuzzy and exact matching)

pub fn accept_doc_search(&mut self)

Accept search and exit search input mode (keep matches for n/N navigation)

pub fn cancel_doc_search(&mut self)

Cancel search and return to previous mode (interactive or normal)

pub fn clear_doc_search(&mut self)

Clear search highlighting and return to previous mode (interactive or normal)

pub fn next_doc_match(&mut self)

Navigate to next search match Handles both doc search matches and accepted outline search navigation

pub fn prev_doc_match(&mut self)

Navigate to previous search match Handles both doc search matches and accepted outline search navigation

pub fn doc_search_status(&self) -> String

Get document search status text for status bar

pub fn scroll_page_down(&mut self)

pub fn scroll_page_up(&mut self)

pub fn scroll_page_down_interactive(&mut self)

Scroll page down in interactive mode (bypasses focus check)

pub fn scroll_page_up_interactive(&mut self)

Scroll page up in interactive mode (bypasses focus check)

pub fn scroll_to_interactive_element(&mut self, viewport_height: u16)

Auto-scroll to keep the selected interactive element in view viewport_height: height of the visible content area (in lines)

pub fn toggle_expand(&mut self)

pub fn expand(&mut self)

pub fn collapse(&mut self)

pub fn collapse_all(&mut self)

Collapse all headings that have children

pub fn expand_all(&mut self)

Expand all headings

pub fn collapse_level(&mut self, level: usize)

Collapse all headings at a specific level (1-6)

pub fn expand_level(&mut self, level: usize)

Expand all headings at a specific level (1-6)

pub fn toggle_focus(&mut self)

pub fn toggle_focus_back(&mut self)

Toggle focus backwards (Shift+Tab) - cycles to previous item when search is locked in

pub fn toggle_outline(&mut self)

pub fn cycle_outline_width(&mut self, increase: bool)

Cycle outline width between 20%, 30%, and 40%.

Behavior depends on user’s config:

• New users (default or standard width in config): Changes are persisted to config file for a seamless experience.
• Power users (custom width like 25% in config): Changes are session-only to protect their carefully crafted config from accidental overwrites. They can explicitly save with S key.

This respects the principle that user config should always take precedence.

pub fn show_save_width_confirmation(&mut self)

Show confirmation modal for saving outline width. Called when user presses S.

pub fn confirm_save_outline_width(&mut self)

Confirm and save outline width to config file.

pub fn cancel_save_width_confirmation(&mut self)

Cancel the save width confirmation modal.

pub fn open_command_palette(&mut self)

Open command palette (triggered by :)

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

Add a character to command palette search

pub fn command_palette_backspace(&mut self)

Remove last character from command palette search

pub fn command_palette_next(&mut self)

Move selection down in command palette

pub fn command_palette_prev(&mut self)

Move selection up in command palette

pub fn command_palette_autocomplete(&mut self)

Autocomplete command palette with selected command’s alias

pub fn close_command_palette(&mut self)

Close command palette without executing

pub fn execute_selected_command(&mut self) -> bool

Execute selected command and return whether to quit

pub fn selected_command(&self) -> Option<&'static PaletteCommand>

Get selected command for display

pub fn jump_to_heading(&mut self, index: usize)

pub fn set_bookmark(&mut self)

pub fn jump_to_bookmark(&mut self)

pub fn selected_heading_text(&self) -> Option<&str>

pub fn selected_heading_source_line(&self) -> Option<u32>

Get the source line number (1-indexed) for the currently selected heading.

Returns None if no heading is selected or if the selection is the document overview.

pub fn sync_previous_selection(&mut self)

Sync previous_selection to current selection (prevents spurious scroll resets)

pub fn toggle_theme_picker(&mut self)

pub fn theme_picker_next(&mut self)

pub fn theme_picker_previous(&mut self)

pub fn apply_selected_theme(&mut self)

pub fn editor_config(&self) -> EditorConfig

Get the editor configuration for external file editing

pub fn copy_content(&mut self)

pub fn copy_anchor(&mut self)

pub fn enter_link_follow_mode(&mut self)

Enter link follow mode - extract links from current section and highlight them

pub fn exit_link_follow_mode(&mut self)

Exit link follow mode and return to normal mode

pub fn start_link_search(&mut self)

Start link search mode

pub fn stop_link_search(&mut self)

Stop link search mode (but keep the filter)

pub fn clear_link_search(&mut self)

Clear link search and show all links

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

Add a character to the link search query

pub fn link_search_pop(&mut self)

Remove the last character from the link search query

pub fn next_link(&mut self)

Cycle to the next link (Tab in link follow mode)

pub fn previous_link(&mut self)

Cycle to the previous link (Shift+Tab in link follow mode)

pub fn jump_to_parent_links(&mut self)

Jump to parent heading while staying in link follow mode

pub fn get_selected_link(&self) -> Option<&Link>

Get the currently selected link (from filtered list)

pub fn follow_selected_link(&mut self) -> Result<(), String>

Follow the currently selected link

pub fn go_back(&mut self) -> Result<(), String>

Navigate back in file history

pub fn go_forward(&mut self) -> Result<(), String>

Navigate forward in file history

pub fn reload_current_file(&mut self) -> Result<(), String>

Reload current file from disk (used after external editing)

pub fn enter_interactive_mode(&mut self)

Enter interactive mode - build element index and enter mode

pub fn exit_interactive_mode(&mut self)

Exit interactive mode and return to normal

pub fn confirm_file_create(&mut self) -> Result<(), String>

Confirm file creation and open the new file

pub fn cancel_file_create(&mut self)

Cancel file creation and return to previous mode

pub fn get_selected_interactive_element(&self) -> Option<&InteractiveElement>

Get the currently selected interactive element

pub fn activate_interactive_element(&mut self) -> Result<(), String>

Activate the currently selected interactive element

pub fn reindex_interactive_elements(&mut self)

Re-index interactive elements after state changes

pub fn copy_table_cell(&mut self) -> Result<(), String>

Copy table cell to clipboard

pub fn copy_table_row(&mut self) -> Result<(), String>

Copy table row to clipboard (tab-separated)

pub fn copy_table_markdown(&mut self) -> Result<(), String>

Copy entire table as markdown

pub fn enter_cell_edit_mode(&mut self) -> Result<(), String>

Enter cell edit mode for the currently selected table cell

pub fn save_edited_cell(&mut self) -> Result<(), String>

Buffer the edited cell value in memory (does not write to file) Use save_pending_edits_to_file() to write changes to disk

pub fn save_pending_edits_to_file(&mut self) -> Result<(), String>

Write all pending edits to the file

pub fn undo_last_edit(&mut self) -> Result<(), String>

Undo the last pending edit