Enum AppEvent 

pub enum AppEvent {
    Input(InputEvent),
    OpenScreen(ScreenEvent),
    Quit,
    Redraw,
    Autosave,
    AutosaveCompleted {
        path: VaultPath,
        saved_revision: Option<NonZeroU64>,
        title: Option<String>,
    },
    OpenPath {
        path: VaultPath,
        emphasis: Option<Vec<String>>,
    },
    FocusSidebar,
    OpenDrawerView(DrawerView),
    RunTagQuery(String),
    JumpToHeading(String),
    ExecuteLeaderAction(LeaderAction),
    FlashMessage(String),
    UpdateAvailable(UpdateStatus),
    ApplyUpdate,
    DismissUpdate(String),
    ShowUpdateDialog,
    UpdateApplied,
    ApplyTheme {
        theme: Box<Theme>,
        persist: bool,
    },
    LinkTargetMeta {
        target: String,
        count: usize,
    },
    BacklinkCountLoaded {
        path: VaultPath,
        count: usize,
    },
    GitStatusLoaded(Option<String>),
    PreferencesSaved,
    OnboardingFinished,
    ClosePreferences,
    OpenFileBrowser,
    TriggerFastReindex,
    TriggerFullReindex,
    IndexingDone(Result<Duration, String>),
    OpenJournal,
    CloseOverlay,
    FollowLink(String),
    FollowLabel(String),
    InsertAtCursor(String),
    ShowFileOpsMenu(VaultPath),
    ShowDeleteDialog(VaultPath),
    ShowRenameDialog(VaultPath),
    ShowMoveDialog(VaultPath),
    EntryDeleted(VaultPath),
    EntryRenamed {
        from: VaultPath,
        to: VaultPath,
    },
    EntryMoved {
        from: VaultPath,
        to: VaultPath,
    },
    EntryCreated(VaultPath),
    DialogError(String),
    VaultConflict(String),
    RenameValidation {
        available: bool,
    },
    MoveDirectoriesLoaded(Vec<VaultPath>),
    MoveFilterResults(Vec<VaultPath>),
    MoveDestValidation {
        available: bool,
    },
    SavedSearchNamesLoaded(Vec<String>),
    WorkspaceSwitched(String),
    SaveSearchConfirmed {
        name: String,
        query: String,
        source: SaveSource,
    },
    SavedSearchPersisted {
        name: String,
        query: String,
        source: SaveSource,
    },
    SavedSearchSaveFailed {
        name: String,
    },
    SavedSearchSelected {
        query: String,
        name: String,
    },
    SortChanged {
        target: SortTarget,
        field: SortField,
        order: SortOrder,
        group_directories: bool,
        persist: bool,
    },
}

All events that flow through the system — both input events (from crossterm) and app-level messages sent by components / screens to the main loop.

Variants

Input(InputEvent)

OpenScreen(ScreenEvent)

Quit

Redraw

Autosave

AutosaveCompleted

Background autosave task finished. saved_revision carries the editor’s content_revision at the moment the save was issued on success, None if the write failed. The editor screen uses path to ignore stale completions for notes the user has already navigated away from, and saved_revision to clear the dirty flag iff the buffer is still at that revision (i.e. no edits during the save). NonZeroU64 because the editor’s content_revision is never zero.

Fields

path: VaultPath

saved_revision: Option<NonZeroU64>

title: Option<String>

The note’s recomputed title (first body line) from the save, so the sidebar row can be retitled. None when the save failed.

OpenPath

Open a note (or directory) — emphasis carries the originating query’s needles when the open comes from a query result, so the editor lights up the matched spans (spec §5.1). Use AppEvent::open for the plain case.

Fields

path: VaultPath

emphasis: Option<Vec<String>>

FocusSidebar

OpenDrawerView(DrawerView)

Switch the drawer to the given view and reveal it (sent by the activity rail and, later, by leader paths / mouse clicks).

RunTagQuery(String)

Run the query #<label> in the FIND drawer (sent by the TAGS drawer).

JumpToHeading(String)

Jump the editor cursor to the first heading with this text (sent by the OUTLINE drawer).

ExecuteLeaderAction(LeaderAction)

Run a leader-tree action (sent by the command palette after it has closed itself, so the action sees no open overlay).

FlashMessage(String)

Show a transient footer flash — async tasks report results with it.

UpdateAvailable(UpdateStatus)

A newer release was found by the background update check. Stored on App and surfaced as a footer indicator on the editor screen.

ApplyUpdate

User chose “Update now” in the update dialog → run the self-update.

DismissUpdate(String)

User skipped a version in the update dialog → persist the dismissal and clear the indicator. Carries the version being skipped.

ShowUpdateDialog

Open the update dialog for the currently-known update (manual check).

UpdateApplied

Self-update finished installing → clear the pending notice (restart still required to run the new binary).

ApplyTheme

Apply (and optionally persist) a resolved theme — sent by the theme picker: previews on selection move, persists on Enter. Carries the full Theme so applying never re-reads the themes directory.

Fields

theme: Box<Theme>

persist: bool

LinkTargetMeta

Async-loaded backlink count for the link target under the editor cursor (status line 2’s → target · N backlinks affordance).

Fields

target: String

count: usize

BacklinkCountLoaded

Async-loaded backlink count for the note at path (status line 2).

Fields

path: VaultPath

count: usize

GitStatusLoaded(Option<String>)

Async-loaded workspace git summary for the status bar, None when the workspace is not a git repository.

PreferencesSaved

Sent by PreferencesScreen when user confirms Save. The shared settings reference already contains the updated values.

OnboardingFinished

Sent by OnboardingScreen when the user confirms Finish on the summary step. The shared settings already contain the committed draft; main.rs rebuilds the vault and navigates to Start (same as PreferencesSaved).

ClosePreferences

Sent by PreferencesScreen when user discards or closes unchanged.

OpenFileBrowser

Sent by VaultSection; PreferencesScreen::handle_app_message intercepts.

TriggerFastReindex

Sent by IndexingSection; PreferencesScreen intercepts.

TriggerFullReindex

IndexingDone(Result<Duration, String>)

Sent by indexing tokio task on completion.

OpenJournal

Open (or create) today’s journal entry and switch to it in the editor.

CloseOverlay

Dismiss the active editor overlay (note browser, Saved Searches modal, or dialog). The single close path for everything owned by OverlayHost.

FollowLink(String)

Follow the link under the editor cursor: note name/path or external URL.

FollowLabel(String)

Open the search modal pre-filled with #<name> to browse notes by label.

InsertAtCursor(String)

Insert raw text at the editor’s cursor (replacing any active selection). Used by the screen layer to deliver async results back to the editor — e.g. the markdown link generated after a clipboard image is saved as an attachment.

ShowFileOpsMenu(VaultPath)

Request to show the file-operations menu (delete / rename / move).

ShowDeleteDialog(VaultPath)

Request to show the delete confirmation dialog for the given entry.

ShowRenameDialog(VaultPath)

Request to show the rename dialog for the given entry.

ShowMoveDialog(VaultPath)

Request to show the move dialog for the given entry.

EntryDeleted(VaultPath)

Confirmation that the given entry was successfully deleted.

EntryRenamed

Confirmation that an entry was successfully renamed.

Fields

from: VaultPath

to: VaultPath

EntryMoved

Confirmation that an entry was successfully moved.

Fields

from: VaultPath

to: VaultPath

EntryCreated(VaultPath)

Notification that a note was just created at this path. The current screen refreshes its sidebar if it is browsing the note’s directory. Opening the note is a separate concern (the creator emits OpenPath).

DialogError(String)

A dialog operation failed; carries a human-readable error message.

VaultConflict(String)

A vault was found to be structurally unusable (conflicts, invalid layout, etc.). Carries a formatted, human-readable error message.

Handled by handle_app_message in main.rs, which clears the workspace, saves settings, and opens the settings screen with an error overlay. To add a new conflict source: emit this event from the detection site; no other files need to change.

RenameValidation

Rename dialog: name availability check result.

Fields

available: bool

MoveDirectoriesLoaded(Vec<VaultPath>)

Move dialog: directory list has loaded.

MoveFilterResults(Vec<VaultPath>)

Move dialog: fuzzy filter results are ready.

MoveDestValidation

Move dialog: destination existence check result.

Fields

available: bool

SavedSearchNamesLoaded(Vec<String>)

Save-search dialog: existing saved-search names have loaded (drives the update/overwrite/save-new hint).

WorkspaceSwitched(String)

User switched to a different workspace. Carries the workspace name. Handled by main.rs to rebuild the vault and navigate to StartScreen.

SaveSearchConfirmed

Persist a saved search (emitted by the save-search dialog on submit). source is the surface the query was sourced from, decided when the dialog opened — it drives whether the panel breadcrumb re-pins.

Fields

name: String

query: String

source: SaveSource

SavedSearchPersisted

A saved search was written to disk (success path of SaveSearchConfirmed). The editor re-pins the panel breadcrumb here — only once the write actually succeeded.

Fields

name: String

query: String

source: SaveSource

SavedSearchSaveFailed

The background saved-search write failed; surface it to the user.

Fields

name: String

SavedSearchSelected

A saved search was chosen in the Saved Searches modal.

Fields

query: String

name: String

SortChanged

Sort selection changed in the sort dialog — apply live to target. When persist is set (sidebar’s “save as default”), also write the choice to settings. group_directories is sidebar-only (the query panel ignores it).

Fields

target: SortTarget

field: SortField

order: SortOrder

group_directories: bool

persist: bool

Implementations

impl AppEvent

pub fn send_input(event: InputEvent) -> Self

pub fn open(path: VaultPath) -> Self

OpenPath without query emphasis — the common case.

Trait Implementations

impl Clone for AppEvent

fn clone(&self) -> AppEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AppEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.