Struct SidebarComponent 

pub struct SidebarComponent { /* private fields */ }

Implementations

impl SidebarComponent

pub fn from_settings(vault: Arc<NoteVault>, settings: &AppSettings) -> Self

Build a sidebar from the application settings, pulling its key bindings and icons from settings. The shared constructor for the screens that host a sidebar (Editor and Browse), so the kb/icons wiring lives once.

pub fn new( key_bindings: KeyBindings, vault: Arc<NoteVault>, icons: Icons, settings: &AppSettings, ) -> Self

pub fn current_dir(&self) -> &VaultPath

pub fn is_empty(&self) -> bool

true until a directory has been loaded (no engine yet). The editor uses this to decide whether to issue the first-open navigation.

pub fn navigate(&mut self, dir: VaultPath, tx: &AppTx)

(Re)build the engine for dir, replacing any prior listing. This is the single directory-navigation entry point: changing directory = rebuild the engine with a fresh DirListingSource for the new dir.

pub fn refresh_if_showing(&mut self, dir: &VaultPath, tx: &AppTx)

Rebuild the listing only when it is currently showing dir, so a create/rename/delete/move in that directory is reflected without yanking the user away from an unrelated directory they browsed to. A no-op otherwise. Shared by every screen that hosts a sidebar.

pub fn set_open_note(&mut self, path: Option<VaultPath>)

Set (or clear) the note the editor currently has open, then re-stamp the marker on the live rows. The editor calls this on every open and on an open-note rename.

pub fn update_note_row(&mut self, path: &VaultPath, new_title: &str)

Update the title of the row whose note path matches path, if it is in the current listing. Called when a note is saved and its title (first body line) may have changed. Position is left unchanged (no re-sort).

pub fn rename_note_row(&mut self, from: &VaultPath, to: &VaultPath)

Move the row at from to to (path + filename + journal_date) in place, for a same-directory note rename. Position is left unchanged (no re-sort). journal_date is recomputed so a rename into/out of a YYYY-MM-DD name under the journal directory flips the glyph and the secondary date line correctly.

pub fn set_current_dir(&mut self, dir: VaultPath)

Seed the directory the sidebar will show before its first navigate. Lets a screen open at a non-root path while keeping current_dir the single source of truth for the browsed directory.

pub fn current_sort(&self) -> (SortField, SortOrder)

Current sort field/order for the active listing.

pub fn group_dirs(&self) -> bool

Current “group directories first” flag.

pub fn apply_sort( &mut self, field: SortField, order: SortOrder, group_dirs: bool, )

Apply a sort selection from the sort dialog and reload so the source re-orders the listing.

pub fn is_current_journal(&self) -> bool

true when the active directory is the journal (so its sort default is the journal one). Lets the caller persist to the matching settings.

pub fn save_default( &mut self, field: SortField, order: SortOrder, group_dirs: bool, )

Save the dialog’s selection as the in-session default for the active context (journal vs. normal), then apply it live. Without this, the cached per-context defaults that sort_for/navigate read stay at their construction-time values, so a saved default would have no effect until restart. The caller is responsible for persisting to the settings file.

Trait Implementations

impl Component for SidebarComponent

fn handle_input(&mut self, event: &InputEvent, tx: &AppTx) -> EventState

Handle an event. Send AppEvents through tx for app-level effects. Returns whether this component consumed the event.

fn hint_shortcuts(&self) -> Vec<(String, String)>

Context-sensitive shortcut hints shown in the hints bar when this component is focused. Each entry is (key_display, label).

fn render( &mut self, f: &mut Frame<'_>, rect: Rect, theme: &Theme, focused: bool, )