Struct App 

pub struct App {

    pub tasks: Vec<Task>,
    pub categories: Vec<Category>,
    pub labels: Vec<Label>,
    pub settings: Settings,
    pub focus: Focus,
    pub mode: Mode,
    pub cat_index: usize,
    pub task_index: usize,
    pub cat_state: ListState,
    pub task_state: TableState,
    pub view: Vec<usize>,
    pub list_rows: Vec<TaskListRow>,
    pub searching: bool,
    pub search_query: String,
    pub input: TextInput,
    pub slash_index: usize,
    pub form: Option<TaskForm>,
    pub category_form: Option<CategoryForm>,
    pub label_index: usize,
    pub label_editor: Option<LabelEditor>,
    pub label_error: Option<String>,
    pub settings_index: usize,
    pub help_scroll: usize,
    pub message: Option<Message>,
    pub pending: Option<(Confirm, Instant)>,
    pub should_quit: bool,
    pub areas: Areas,
    pub images: ImageStore,
    pub dirty: bool,
    pub data_gen: u64,
    pub preview_form: Option<TaskForm>,
    /* private fields */
}

Fields

tasks: Vec<Task>

categories: Vec<Category>

labels: Vec<Label>

settings: Settings

focus: Focus

mode: Mode

cat_index: usize

Index into categories.

task_index: usize

Index into view.

cat_state: ListState

Scroll position of the two panels. Selection is driven by the two indices above; ratatui keeps the offsets in these.

task_state: TableState

view: Vec<usize>

Indices into tasks, in display order.

list_rows: Vec<TaskListRow>

Table rows including category separators. Parallel to what is drawn; selection still uses task_index into view.

searching: bool

search_query: String

input: TextInput

slash_index: usize

Selected row in the / palette dropdown.

form: Option<TaskForm>

The open task dialog, if any.

category_form: Option<CategoryForm>

The open category dialog, if any.

label_index: usize

Selected row in the global label manager.

label_editor: Option<LabelEditor>

Inline create/rename editor with an explicit name/color focus.

label_error: Option<String>

settings_index: usize

help_scroll: usize

First help content row currently visible.

message: Option<Message>

pending: Option<(Confirm, Instant)>

Pending entity-bound destructive action and its deadline.

should_quit: bool

areas: Areas

images: ImageStore

Description/preview image store.

dirty: bool

Needs a redraw.

data_gen: u64

Incremented on task mutation (invalidates preview cache).

preview_form: Option<TaskForm>

Cached description editor for the read-only preview pane.

Implementations

impl App

pub fn new(version: &str) -> Result<Self, StoreError>

pub fn with_store(version: &str, store: Store) -> Result<Self, StoreError>

pub fn data_dir(&self) -> &Path

pub fn poll_external_changes(&mut self) -> bool

Refresh after another process commits. Dialogs deliberately defer the visual refresh: their entity snapshot is checked transactionally when the user saves, so typed work is never replaced under the cursor.

pub fn request_quit(&mut self)

pub fn mark_dirty(&mut self)

pub fn invalidate_preview(&mut self)

pub fn ensure_preview(&mut self)

Rebuild Self::preview_form if the selection or data_gen changed.

pub fn theme(&self) -> Theme

pub fn current_category_id(&self) -> &str

pub fn is_all_view(&self) -> bool

pub fn category_name(&self, id: &str) -> Option<&str>

pub fn label_name(&self, id: &str) -> Option<&str>

pub fn rebuild_view(&mut self)

Recompute which tasks are shown and in what order.

Sort applies inside each category. All Tasks (and search) stack those already-sorted groups in sidebar order; a single category is just one group.

pub fn selected_visual_row(&self) -> Option<usize>

Visual table row for the selected task, if any.

pub fn task_at_visual_row(&self, row: usize) -> Option<usize>

view index under a visual table row, or None for a separator.

pub fn task_count(&self) -> usize

pub fn visible_task(&self, pos: usize) -> Option<&Task>

pub fn selected_task(&self) -> Option<&Task>

pub fn done_count(&self) -> usize

pub fn move_task_selection(&mut self, delta: isize)

pub fn select_task(&mut self, pos: usize)

pub fn select_first_task(&mut self)

pub fn select_last_task(&mut self)

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

Type-to-jump: append c and select the best fuzzy match (list unchanged).

pub fn move_category_selection(&mut self, delta: isize)

pub fn navigate_vertical(&mut self, delta: isize)

↑/↓ stay inside the focused panel. Cross-panel moves use ←/→ or Tab.

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

pub fn select_last_category(&mut self)

pub fn toggle_focus(&mut self)

pub fn set_focus(&mut self, focus: Focus) -> bool

Move keyboard focus. A locked search owns the task list until Esc.

pub fn cancel_pending(&mut self)

pub fn toggle_done(&mut self, pos: usize)

pub fn cycle_importance(&mut self, pos: usize)

Steps a task’s importance up, wrapping back to none after three.

pub fn move_task_order(&mut self, delta: isize) -> bool

Reorder the selected task inside its category when using manual sort. In All Tasks, crossing a category section boundary is intentionally blocked; changing category belongs in the task form.

pub fn open_new_task(&mut self)

Opens the dialog for a new task, unless the list is full.

pub fn open_edit_task(&mut self)

Opens the dialog on the selected task.

pub fn close_form(&mut self)

pub fn submit_form(&mut self)

Validates the open form and writes it back to the task list.

pub fn create_task(&mut self, draft: &TaskDraft) -> Option<String>

Creates a task in the chosen category and selects it. A [date] left in the title is moved into due when due is empty.

pub fn update_task(&mut self, id: &str, draft: &TaskDraft) -> bool

pub fn delete_task(&mut self, pos: usize)

pub fn delete_task_by_id(&mut self, id: &str) -> bool

pub fn purge(&mut self) -> usize

Permanently remove done tasks. In All Tasks → every done task; in a category → only that category’s done tasks. Nothing is archived.

pub fn purge_candidate_ids(&self) -> Vec<String>

Completed task ids in the current purge scope, captured for confirmation.

pub fn purge_ids(&mut self, ids: &[String]) -> usize

Purge exactly the confirmed ids; newly completed tasks are never swept in.

pub fn toggle_hide_done(&mut self) -> Option<bool>

/done — show or hide completed tasks in the list (still on disk).

pub fn open_new_category(&mut self)

Opens the dialog for a new category.

pub fn open_edit_category(&mut self)

Opens the dialog on the selected category. “All Tasks” is not a real category and cannot be edited.

pub fn close_category_form(&mut self)

pub fn submit_category_form(&mut self)

pub fn delete_category(&mut self)

Deletes the category while preserving its tasks as Uncategorized. Category ids are stable UUIDs — no renumbering.

pub fn delete_category_by_id(&mut self, id: &str) -> bool

pub fn open_labels(&mut self)

pub fn open_labels_from_form(&mut self)

pub fn close_labels(&mut self)

pub fn move_label_selection(&mut self, delta: isize)

pub fn begin_new_label(&mut self)

pub fn begin_rename_label(&mut self)

pub fn cancel_label_editor(&mut self)

pub fn submit_label_editor(&mut self)

pub fn selected_label(&self) -> Option<&Label>

pub fn delete_label_by_id(&mut self, id: &str) -> bool

pub fn create_label(&mut self, name: &str) -> Result<String, String>

pub fn set_task_labels( &mut self, task_id: &str, label_ids: Vec<String>, ) -> Result<(), String>

pub fn move_category_order(&mut self, delta: isize) -> bool

Reorder real categories while keeping the virtual All Tasks row fixed.

pub fn category_progress(&self, id: &str) -> (usize, usize)

(done, total) for a category. All Tasks counts every task.

pub fn open_slash(&mut self)

Open the / command palette.

pub fn start_search(&mut self, query: &str)

Enter live search, optionally with an initial query.

pub fn update_search(&mut self)

pub fn resume_search(&mut self)

Return keyboard input to an already locked search without rebuilding the view or moving its selected task.

pub fn end_search(&mut self)

pub fn clamp_slash_index(&mut self)

pub fn info(&mut self, text: impl Into<String>)

pub fn error(&mut self, text: impl Into<String>)

pub fn expire_message(&mut self) -> bool

Drop expired status messages. Returns true when the UI should redraw.

pub fn ask_confirm(&mut self, confirm: Confirm, prompt: impl Into<String>)

Arm a destructive action for its explicit confirmation step, and say so.

pub fn awaiting(&self, confirm: Confirm) -> bool

Whether confirm is armed and still inside its window.

pub fn pending_confirmation(&self) -> Option<&Confirm>

pub fn cycle_setting(&mut self, index: usize, delta: isize)

Step a settings row by delta (+1 forward, −1 back), wrapping.

pub fn setting_value(&self, index: usize) -> String