Enum Modal 

pub enum Modal {
    None,
    Alert {
        message: String,
    },
    Loading {
        message: String,
    },
    ConfirmInstall {
        items: Vec<PackageItem>,
    },
    ConfirmReinstall {
        items: Vec<PackageItem>,
        all_items: Vec<PackageItem>,
        header_chips: PreflightHeaderChips,
    },
    ConfirmBatchUpdate {
        items: Vec<PackageItem>,
        dry_run: bool,
    },
    ConfirmAurUpdate {
        message: String,
    },
    WarnAurRepoDuplicate {
        dup_names: Vec<String>,
        packages: Vec<PackageItem>,
        header_chips: PreflightHeaderChips,
    },
    ForeignRepoOverlap {
        repo_name: String,
        entries: Vec<(String, String)>,
        phase: ForeignRepoOverlapPhase,
    },
    ConfirmAurVote {
        pkgbase: String,
        action: VoteAction,
        message: String,
    },
    Preflight {

        items: Vec<PackageItem>,
        action: PreflightAction,
        tab: PreflightTab,
        summary: Option<Box<PreflightSummaryData>>,
        summary_scroll: u16,
        header_chips: PreflightHeaderChips,
        dependency_info: Vec<DependencyInfo>,
        dep_selected: usize,
        dep_tree_expanded: HashSet<String>,
        deps_error: Option<String>,
        file_info: Vec<PackageFileInfo>,
        file_selected: usize,
        file_tree_expanded: HashSet<String>,
        files_error: Option<String>,
        service_info: Vec<ServiceImpact>,
        service_selected: usize,
        services_loaded: bool,
        services_error: Option<String>,
        sandbox_info: Vec<SandboxInfo>,
        sandbox_selected: usize,
        sandbox_tree_expanded: HashSet<String>,
        sandbox_loaded: bool,
        sandbox_error: Option<String>,
        selected_optdepends: HashMap<String, HashSet<String>>,
        cascade_mode: CascadeMode,
        cached_reverse_deps_report: Option<ReverseDependencyReport>,
    
},
    PreflightExec {
        items: Vec<PackageItem>,
        action: PreflightAction,
        tab: PreflightTab,
        verbose: bool,
        log_lines: Vec<String>,
        abortable: bool,
        header_chips: PreflightHeaderChips,
        success: Option<bool>,
    },
    PostSummary {
        success: bool,
        changed_files: usize,
        pacnew_count: usize,
        pacsave_count: usize,
        services_pending: Vec<String>,
        snapshot_label: Option<String>,
    },
    Help,
    ConfirmRemove {
        items: Vec<PackageItem>,
    },
    SystemUpdate {
        do_mirrors: bool,
        do_pacman: bool,
        force_sync: bool,
        do_aur: bool,
        do_cache: bool,
        country_idx: usize,
        countries: Vec<String>,
        mirror_count: u16,
        cursor: usize,
    },
    News {
        items: Vec<NewsFeedItem>,
        selected: usize,
        scroll: u16,
    },
    Announcement {
        title: String,
        content: String,
        id: String,
        scroll: u16,
    },
    Updates {
        entries: Vec<(String, String, String)>,
        scroll: u16,
        selected: usize,
        filter_active: bool,
        filter_query: String,
        filter_caret: usize,
        last_selected_pkg_name: Option<String>,
        filtered_indices: Vec<usize>,
        selected_pkg_names: HashSet<String>,
    },
    OptionalDeps {
        rows: Vec<OptionalDepRow>,
        selected: usize,
        selected_pkg_names: HashSet<String>,
    },
    Repositories {
        rows: Vec<RepositoryModalRow>,
        selected: usize,
        scroll: u16,
        repos_conf_error: Option<String>,
        pacman_warnings: Vec<String>,
    },
    SshAurSetup {
        step: SshSetupStep,
        status_lines: Vec<String>,
        existing_host_block: Option<String>,
    },
    ScanConfig {
        do_clamav: bool,
        do_trivy: bool,
        do_semgrep: bool,
        do_shellcheck: bool,
        do_virustotal: bool,
        do_custom: bool,
        do_sleuth: bool,
        cursor: usize,
    },
    GnomeTerminalPrompt,
    VirusTotalSetup {
        input: String,
        cursor: usize,
    },
    SudoTimestampSetup {
        setup: SudoTimestampSetupModalState,
    },
    DoasPersistSetup {
        setup: DoasPersistSetupModalState,
    },
    ImportHelp,
    NewsSetup {
        show_arch_news: bool,
        show_advisories: bool,
        show_aur_updates: bool,
        show_aur_comments: bool,
        show_pkg_updates: bool,
        max_age_days: Option<u32>,
        cursor: usize,
    },
    StartupSetupSelector {
        cursor: usize,
        selected: HashSet<StartupSetupTask>,
        active_privilege_tool: Option<PrivilegeTool>,
    },
    PasswordPrompt {
        purpose: PasswordPurpose,
        items: Vec<PackageItem>,
        input: SecureString,
        cursor: usize,
        error: Option<String>,
    },
}

What: Captures all dialog state for the various modal overlays presented in the Pacsea TUI.

• Input: Mutated by event handlers in response to user actions or background updates.
• Output: Drives conditional rendering and behavior of each modal type.
• Details: Acts as a tagged union so only one modal can be active at a time while carrying the precise data needed for that modal’s UI.

Variants

None

No modal is currently displayed.

Alert

Informational alert with a non-interactive message.

Fields

message: String

Alert message text.

Loading

Loading indicator shown during background computation.

Fields

message: String

Loading message text.

ConfirmInstall

Confirmation dialog for installing the given items.

Fields

items: Vec<PackageItem>

Package items to install.

ConfirmReinstall

Confirmation dialog for reinstalling already installed packages.

Fields

items: Vec<PackageItem>

Packages that are already installed (shown in the confirmation dialog).

all_items: Vec<PackageItem>

All packages to install (including both installed and not installed).

header_chips: PreflightHeaderChips

Header chip metrics for the operation.

ConfirmBatchUpdate

Confirmation dialog for batch updates that may cause dependency conflicts.

Fields

items: Vec<PackageItem>

Package items to update.

dry_run: bool

Whether this is a dry-run operation.

ConfirmAurUpdate

Confirmation dialog for continuing AUR update after pacman failed.

Fields

message: String

Message explaining the situation.

WarnAurRepoDuplicate

Warning: AUR install targets also appear as official/sync rows in current results.

Fields

dup_names: Vec<String>

pkgname values that are both AUR-selected and present as official rows.

packages: Vec<PackageItem>

Full install set to resume after continue.

header_chips: PreflightHeaderChips

Preflight header chips to restore [handle_proceed_install] context.

ForeignRepoOverlap

Post full repo-apply: foreign packages that share a name with the new sync repository.

Fields

repo_name: String

Repository that was applied (for copy and pacman -Sl).

entries: Vec<(String, String)>

Overlapping (pkgname, installed version) rows sorted by name.

phase: ForeignRepoOverlapPhase

Current wizard phase.

ConfirmAurVote

Confirmation dialog for AUR vote/unvote actions.

Fields

pkgbase: String

AUR package base the action targets.

action: VoteAction

Vote action to execute on confirmation.

message: String

Confirmation message shown to the user.

Preflight

Preflight summary before executing any action.

Fields

items: Vec<PackageItem>

Packages selected for the operation.

action: PreflightAction

Action to perform (install/remove/downgrade).

tab: PreflightTab

Currently active preflight tab.

summary: Option<Box<PreflightSummaryData>>

Aggregated summary information for versions, sizes, and risk cues.

summary_scroll: u16

Scroll offset (lines) for the Summary tab content (mouse scrolling only).

header_chips: PreflightHeaderChips

Header chip data shared across summary, execution, and post-summary screens.

dependency_info: Vec<DependencyInfo>

Resolved dependency information (populated when Deps tab is accessed).

dep_selected: usize

Selected index in the dependency list (for navigation).

dep_tree_expanded: HashSet<String>

Set of dependency names with expanded tree nodes (for tree view).

deps_error: Option<String>

Error message from dependency resolution, if any.

file_info: Vec<PackageFileInfo>

File information (populated when Files tab is accessed).

file_selected: usize

Selected index in the file list (for navigation).

file_tree_expanded: HashSet<String>

Set of package names with expanded file lists (for Files tab tree view).

files_error: Option<String>

Error message from file resolution, if any.

service_info: Vec<ServiceImpact>

Service impact information (populated when Services tab is accessed).

service_selected: usize

Selected index in the service impact list (for navigation).

services_loaded: bool

Whether service impacts have been resolved for the current session.

services_error: Option<String>

Error message from service resolution, if any.

sandbox_info: Vec<SandboxInfo>

Sandbox information for AUR packages (populated when Sandbox tab is accessed).

sandbox_selected: usize

Selected index in the sandbox display list (for navigation - can be package or dependency).

sandbox_tree_expanded: HashSet<String>

Set of package names with expanded dependency lists (for Sandbox tab tree view).

sandbox_loaded: bool

Whether sandbox info has been resolved for the current session.

sandbox_error: Option<String>

Error message from sandbox resolution, if any.

selected_optdepends: HashMap<String, HashSet<String>>

Selected optional dependencies to install with their packages. Maps package name -> set of selected optional dependency names.

cascade_mode: CascadeMode

Current cascade removal strategy for this session.

cached_reverse_deps_report: Option<ReverseDependencyReport>

Cached reverse dependency report for Remove actions (populated during summary computation). This avoids redundant resolution when switching to the Deps tab.

PreflightExec

Preflight execution screen with log and sticky sidebar.

Fields

items: Vec<PackageItem>

Packages being processed.

action: PreflightAction

Action being executed (install/remove/downgrade).

tab: PreflightTab

Tab to display while executing.

verbose: bool

Whether verbose logging is enabled.

log_lines: Vec<String>

Execution log lines.

abortable: bool

Whether the operation can be aborted.

header_chips: PreflightHeaderChips

Header chip metrics displayed in the sidebar.

success: Option<bool>

Execution result: Some(true) for success, Some(false) for failure, None if not yet completed.

PostSummary

Post-transaction summary with results and follow-ups.

Fields

success: bool

Whether the operation succeeded.

changed_files: usize

Number of files changed.

pacnew_count: usize

Number of .pacnew files created.

pacsave_count: usize

Number of .pacsave files created.

services_pending: Vec<String>

Services pending restart.

snapshot_label: Option<String>

Snapshot label if created.

Help

Help overlay with keybindings. Non-interactive; dismissed with Esc/Enter.

ConfirmRemove

Confirmation dialog for removing the given items.

Fields

items: Vec<PackageItem>

Package items to remove.

SystemUpdate

System update dialog with multi-select options and optional country.

Fields

do_mirrors: bool

Whether to update Arch mirrors using reflector.

do_pacman: bool

Whether to update system packages via pacman.

force_sync: bool

Whether to force sync databases (pacman -Syyu instead of -Syu).

do_aur: bool

Whether to update AUR packages via paru/yay.

do_cache: bool

Whether to remove caches (pacman and AUR helper).

country_idx: usize

Index into countries for the reflector --country argument.

countries: Vec<String>

Available countries to choose from for reflector.

mirror_count: u16

Requested mirror count to fetch/rank.

cursor: usize

Cursor row in the dialog (0..=4)

News

Arch Linux News: list of recent items with selection.

Fields

items: Vec<NewsFeedItem>

Latest news feed items (Arch news, advisories, updates, comments).

selected: usize

Selected row index.

scroll: u16

Scroll offset (lines) for the news list.

Announcement

Application announcement: markdown content displayed at startup.

Fields

title: String

Title to display in the modal header.

content: String

Markdown content to display.

id: String

Unique identifier for this announcement (version string or remote ID).

scroll: u16

Scroll offset (lines) for long content.

Updates

Available package updates: list of update entries with scroll support.

Fields

entries: Vec<(String, String, String)>

Update entries with package name, old version, and new version.

scroll: u16

Scroll offset (lines) for the updates list.

selected: usize

Selected row index.

filter_active: bool

Whether slash-filter text mode is active.

filter_query: String

Current slash-filter query text.

filter_caret: usize

Caret position (character index) within filter_query.

last_selected_pkg_name: Option<String>

Last selected package identity used for restoration across filter changes.

filtered_indices: Vec<usize>

Visible updates rows as original-entry indices after applying filter.

selected_pkg_names: HashSet<String>

Selected package names for batch preflight actions.

OptionalDeps

TUI Optional Dependencies chooser: selectable rows with install status.

Fields

rows: Vec<OptionalDepRow>

Rows to display (pre-filtered by environment/distro).

selected: usize

Selected row index.

selected_pkg_names: HashSet<String>

Selected package names for batch install actions.

Repositories

Read-only Repositories viewer: repos.conf vs live pacman.conf / includes.

Fields

rows: Vec<RepositoryModalRow>

Merged rows for each configured [[repo]].

selected: usize

Selected row index.

scroll: u16

Scroll offset: index of first visible data row.

repos_conf_error: Option<String>

Error loading or parsing repos.conf, if any.

pacman_warnings: Vec<String>

Warnings from reading pacman.conf or includes.

SshAurSetup

Guided SSH setup workflow for AUR voting.

Fields

step: SshSetupStep

Active setup step in the wizard-like flow.

status_lines: Vec<String>

Status and instruction lines shown in the modal body.

existing_host_block: Option<String>

Existing Host aur.archlinux.org block shown when overwrite confirmation is required.

ScanConfig

Select which scans to run before executing the AUR scan.

Fields

do_clamav: bool

Whether to run ClamAV (clamscan).

do_trivy: bool

Whether to run Trivy filesystem scan.

do_semgrep: bool

Whether to run Semgrep static analysis.

do_shellcheck: bool

Whether to run ShellCheck on PKGBUILD/.install.

do_virustotal: bool

Whether to run VirusTotal hash lookups.

do_custom: bool

Whether to run custom suspicious-pattern scan (PKGBUILD/.install).

do_sleuth: bool

Whether to run aur-sleuth (LLM audit).

cursor: usize

Cursor row in the dialog.

GnomeTerminalPrompt

Prompt to install GNOME Terminal at startup on GNOME when not present.

VirusTotalSetup

Setup dialog for VirusTotal API key.

Fields

input: String

User-entered API key buffer.

cursor: usize

Cursor position within the input buffer.

SudoTimestampSetup

Optional wizard: configure sudo timestamp_timeout via sudoers drop-in (instructions / terminal).

Fields

setup: SudoTimestampSetupModalState

Wizard phase and cursor state.

DoasPersistSetup

Optional wizard: guide doas persist policy setup via doas.conf snippets and checks.

Fields

setup: DoasPersistSetupModalState

Wizard phase and cursor state.

ImportHelp

Information dialog explaining the Import file format.

NewsSetup

Setup dialog for startup news popup configuration.

Fields

show_arch_news: bool

Whether to show Arch news.

show_advisories: bool

Whether to show security advisories.

show_aur_updates: bool

Whether to show AUR updates.

show_aur_comments: bool

Whether to show AUR comments.

show_pkg_updates: bool

Whether to show official package updates.

max_age_days: Option<u32>

Maximum age of news items in days (7, 30, or 90).

cursor: usize

Current cursor position (0-5 for toggles, 6-8 for date buttons).

StartupSetupSelector

First-startup selector for choosing which setup flows to run.

Fields

cursor: usize

Currently highlighted row index.

selected: HashSet<StartupSetupTask>

Selected startup setup tasks to execute.

active_privilege_tool: Option<PrivilegeTool>

Cached active privilege tool resolved when opening the selector.

Avoids repeated PATH lookups during render passes.

PasswordPrompt

Password prompt for sudo authentication.

Fields

purpose: PasswordPurpose

Purpose of the password prompt.

items: Vec<PackageItem>

Packages involved in the operation.

input: SecureString

User input buffer for password.

cursor: usize

Cursor position within the input buffer.

error: Option<String>

Error message if password was incorrect.

Trait Implementations

impl Clone for Modal

fn clone(&self) -> Modal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Modal

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

Formats the value using the given formatter.

impl Default for Modal

fn default() -> Modal

Returns the “default value” for a type.