Struct App 

pub struct App {

    pub mode: AppMode,
    pub active_tab: TabKind,
    pub data: DataContext,
    pub tabs: TabStates,
    pub overlays: AppOverlays,
    pub scroll_state: ScrollbarState,
    pub should_quit: bool,
    pub status_message: Option<String>,
    pub tick: u64,
    pub last_export_path: Option<String>,
    pub navigation_ctx: NavigationContext,
    pub security_cache: SecurityAnalysisCache,
    pub compliance_state: PolicyComplianceState,
    pub quality_view: Option<QualityView>,
}

Main application state

Fields

mode: AppMode

Current mode (diff or view)

active_tab: TabKind

Active tab

data: DataContext

SBOM data, diff results, indexes, quality, and compliance

tabs: TabStates

Per-tab UI state

overlays: AppOverlays

Overlay UI state

scroll_state: ScrollbarState

Scrollbar state

should_quit: bool

Should quit

status_message: Option<String>

Status message to display temporarily

tick: u64

Animation tick counter

last_export_path: Option<String>

Last exported file path

navigation_ctx: NavigationContext

Navigation context for cross-view navigation

security_cache: SecurityAnalysisCache

Security analysis cache for blast radius, risk indicators, and flagged items

compliance_state: PolicyComplianceState

Compliance/policy checking state

quality_view: Option<QualityView>

Quality tab ViewState implementation (proof of concept).

When present, quality tab key events are dispatched through this ViewState instead of the direct handler. State is synced back to tabs.quality after each event for rendering compatibility.

Implementations

impl App

pub fn ensure_compliance_results(&mut self)

Lazily compute compliance results for all standards when first needed.

pub fn toggle_help(&mut self)

Toggle help overlay

pub fn toggle_export(&mut self)

Toggle export dialog

pub fn toggle_legend(&mut self)

Toggle legend overlay

pub fn close_overlays(&mut self)

Close all overlays

pub fn has_overlay(&self) -> bool

Check if any overlay is open

pub fn toggle_threshold_tuning(&mut self)

Toggle threshold tuning overlay

pub fn show_threshold_tuning(&mut self)

Show threshold tuning overlay and compute initial estimated matches

pub fn update_threshold_preview(&mut self)

Update the estimated matches preview based on current threshold

pub fn apply_threshold(&mut self)

Apply the tuned threshold and potentially re-diff

pub fn set_status_message(&mut self, msg: impl Into<String>)

Set a temporary status message

pub fn clear_status_message(&mut self)

Clear the status message

pub fn export(&mut self, format: ExportFormat)

Export the current diff to a file

pub fn export_compliance(&mut self, format: ExportFormat)

Export compliance results from the active compliance tab

pub fn run_compliance_check(&mut self)

Run compliance check against the current policy

pub fn toggle_compliance_details(&mut self)

Toggle compliance view details

pub fn next_policy(&mut self)

Cycle to next policy preset

pub fn view_mode(&self) -> ViewMode

Get the current view mode for ViewContext

pub fn handle_event_result(&mut self, result: EventResult)

Handle an EventResult from a view state

This method processes the result of a view’s event handling, performing navigation, showing overlays, or setting status messages.

pub fn current_tab_target(&self) -> TabTarget

Get the current tab as a TabTarget

pub fn current_shortcuts(&self) -> Vec<Shortcut>

Get keyboard shortcuts for the current view

impl App

pub fn new_diff( diff_result: DiffResult, old_sbom: NormalizedSbom, new_sbom: NormalizedSbom, old_raw: String, new_raw: String, ) -> Self

Create a new app for diff mode

pub fn with_enrichment_stats( self, old_stats: Option<EnrichmentStats>, new_stats: Option<EnrichmentStats>, ) -> Self

Set enrichment statistics for the diff mode

pub fn combined_enrichment_stats(&self) -> Option<EnrichmentStats>

Get combined enrichment stats for display

pub fn new_view(sbom: NormalizedSbom) -> Self

Create a new app for view mode

pub fn new_multi_diff(result: MultiDiffResult) -> Self

Create a new app for multi-diff mode

pub fn new_timeline(result: TimelineResult) -> Self

Create a new app for timeline mode

pub fn new_matrix(result: MatrixResult) -> Self

Create a new app for matrix mode

impl App

pub fn diff_component_items( &self, filter: ComponentFilter, ) -> Vec<&ComponentChange>

Build diff-mode components list in the same order as the table.

pub fn diff_component_count(&self, filter: ComponentFilter) -> usize

Count diff-mode components matching the filter (without building full list). More efficient than diff_component_items().len() for just getting a count.

pub fn view_component_count(&self) -> usize

Count view-mode components (without building full list).

pub fn view_component_items(&self) -> Vec<&Component>

Build view-mode components list in the same order as the table.

pub fn diff_vulnerability_items(&self) -> Vec<DiffVulnItem<'_>>

Build diff-mode vulnerabilities list in the same order as the table.

pub fn ensure_vulnerability_cache(&mut self)

Ensure the vulnerability cache is populated for the current filter+sort.

Call this before diff_vulnerability_items_from_cache() to guarantee the cache is warm.

pub fn diff_vulnerability_items_from_cache(&self) -> Vec<DiffVulnItem<'_>>

Reconstruct vulnerability items from the cache (cheap pointer lookups).

Panics if the cache has not been populated. Call ensure_vulnerability_cache() first.

pub fn diff_vulnerability_count(&self) -> usize

Count diff-mode vulnerabilities matching the current filter (without building full list). More efficient than diff_vulnerability_items().len() for just getting a count.

pub fn get_new_sbom_sort_key( &self, id: &CanonicalId, ) -> Option<&ComponentSortKey>

Get the sort key for a component in the new SBOM (diff mode).

Returns pre-computed lowercase strings to avoid repeated allocations during sorting.

pub fn get_old_sbom_sort_key( &self, id: &CanonicalId, ) -> Option<&ComponentSortKey>

Get the sort key for a component in the old SBOM (diff mode).

pub fn get_sbom_sort_key(&self, id: &CanonicalId) -> Option<&ComponentSortKey>

Get the sort key for a component in the single SBOM (view mode).

pub fn get_dependencies_indexed(&self, id: &CanonicalId) -> Vec<&DependencyEdge>

Get dependencies of a component using the cached index (O(k) instead of O(edges)).

pub fn get_dependents_indexed(&self, id: &CanonicalId) -> Vec<&DependencyEdge>

Get dependents of a component using the cached index (O(k) instead of O(edges)).

impl App

pub fn next_tab(&mut self)

Switch to next tab

pub fn prev_tab(&mut self)

Switch to previous tab

pub fn select_tab(&mut self, tab: TabKind)

Select a specific tab

pub fn select_up(&mut self)

Move selection up

pub fn select_down(&mut self)

Move selection down

pub fn select_first(&mut self)

Move selection to first item

pub fn select_last(&mut self)

Move selection to last item

pub fn page_up(&mut self)

Page up

pub fn page_down(&mut self)

Page down

pub fn navigate_vuln_to_component( &mut self, vuln_id: &str, component_name: &str, )

Navigate from vulnerability to the affected component

pub fn navigate_dep_to_component(&mut self, dep_name: &str)

Navigate from dependency to the component

pub fn navigate_back(&mut self) -> bool

Navigate back using breadcrumbs

pub fn has_navigation_history(&self) -> bool

Check if we have navigation history

pub fn breadcrumb_trail(&self) -> String

Get the breadcrumb trail for display

impl App

pub fn start_search(&mut self)

Start searching

pub fn stop_search(&mut self)

Stop searching

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

Add character to search query

pub fn search_pop(&mut self)

Remove character from search query

pub fn execute_search(&mut self)

Execute search with current query

pub fn jump_to_search_result(&mut self)

Jump to the currently selected search result