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, sorted by that directory’s default.

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. The active sort is kept (a property sort refetches its values). 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. The row is re-sorted into its new spot under the active listing_order (a Name sort reads the very field this changes) and keeps the highlight if it had it. 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_sort_chip(&mut self, show: bool)

Draw (and accept clicks on) the sort chip — on by default; off for a host that cannot open the sort dialog.

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: the engine re-orders the rows it already holds — no second walk of the directory. A property sort orders by the values cached for its key; without them the current order stays until they arrive (see SortableList::apply_sort).

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 remember_default(&mut self, field: SortField, order: SortOrder)

Record field / order as the in-session default for the active context (journal vs. normal) without re-sorting — the sidebar’s “save as default”, for callers that already applied the sort. Without it the cached per-context defaults that sort_for/navigate read stay at their construction-time values until restart. Never called with a property sort (it can’t be a default).

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, )

impl SortableList for SidebarComponent

fn apply_sort(&mut self, state: &SortState, tx: &AppTx)

A None group flag keeps the current grouping. A property sort on a new key fetches its values from the index and re-sorts when they land; on the same key (an Order / Group toggle) it reuses the cached values. One with no key yet is ignored.

fn sort_state(&self) -> SortState

fn allows_property(&self) -> bool

Whether the dialog offers Property. Query-backed lists put the key in the query; listings fetch values with PropertySort.

fn is_unsorted(&self) -> bool

The rows are in the list’s natural order (recency, match rank), not any sort the dialog offers — it then shows “Unsorted” until a pick. Self::sort_state still names the field / order the first toggle starts from. Only the file finder and the Ctrl+K recents say so.