Struct App 

pub struct App {

    pub snapshot: Option<Arc<Snapshot>>,
    pub tab: Tab,
    pub explorer: ExplorerState,
    pub graph: GraphState,
    pub trust: TrustState,
    pub computations: ComputationsState,
    pub overlays: Vec<Overlay>,
    pub toasts: VecDeque<Toast>,
    pub loading: LoadPhase,
    pub theme: Theme,
    pub author: String,
    pub pending_commands: Vec<Command>,
    pub editor_request: Option<PathBuf>,
    pub copy_request: Option<String>,
    pub should_quit: bool,
    pub tick: u64,
    pub reload_queued: bool,
    pub next_request: u64,
    pub root_name: String,
    pub load_error: Option<String>,
    pub no_watch: bool,
    /* private fields */
}

The whole application state.

Fields

snapshot: Option<Arc<Snapshot>>

The immutable world model (absent until the first load lands).

tab: Tab

The active workspace.

explorer: ExplorerState

Explorer state.

graph: GraphState

Graph state.

trust: TrustState

Mission-control state.

computations: ComputationsState

Computations state.

overlays: Vec<Overlay>

The overlay stack.

toasts: VecDeque<Toast>

Transient status messages.

loading: LoadPhase

Background work indicator.

theme: Theme

The theme.

author: String

Author identity for stamps and log entries.

pending_commands: Vec<Command>

Commands awaiting dispatch to the worker (drained by the main loop).

editor_request: Option<PathBuf>

A file to open in $EDITOR (handled by the main loop).

copy_request: Option<String>

Text to copy to the clipboard via OSC 52 (handled by the main loop).

should_quit: bool

Set when the user quits.

tick: u64

Tick counter.

reload_queued: bool

A reload arrived while one was in flight.

next_request: u64

Monotonic preview-request counter.

root_name: String

The bundle directory’s display name.

load_error: Option<String>

A fatal load error, shown instead of a workspace.

no_watch: bool

Whether the watcher is disabled.

Implementations

impl App

pub fn new(options: &StudioOptions) -> Self

Creates the initial state from the launch options.

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

Pushes a toast.

pub fn selected_concept(&self) -> Option<ConceptId>

The concept the current selection denotes, if any — the subject every contextual verb acts on.

pub fn selected_path(&self) -> Option<PathBuf>

The on-disk file the current selection denotes (for $EDITOR).

pub fn tree_rows(&self) -> Vec<TreeRow>

The visible tree rows given the current collapse state.

pub fn filtered_queue(&self) -> Vec<AttentionItem>

The attention queue after the cohort filter and sort.

pub fn update(&mut self, msg: Msg)

Applies one message. Never blocks, never touches disk.

pub fn graph_included(&self, snapshot: &Snapshot) -> Vec<bool>

The nodes currently visible in the graph, honoring toggles, focus mode, and the fuzzy filter (filtered nodes stay visible but dimmed — they remain in layout).

impl App

pub fn run_action(&mut self, action: Action)

Executes one keymap action (also the palette command executor).

pub fn open_concept(&mut self, id: &ConceptId)

Jumps the explorer to a concept, recording history.

impl App

pub fn palette_results(&self, state: &PaletteState) -> PaletteResults

Computes the palette’s result rows for its current input.

pub fn diag_rows(&self, filter: DiagFilter) -> Vec<DiagRow>

The merged validation + lint rows for a diagnostics filter.