Struct Installer 

pub struct Installer { /* private fields */ }

Drives the FOMOD installation process.

Tracks user selections and condition flags, then resolves the final set of file operations.

Implementations

impl Installer

pub fn new(config: ModuleConfig) -> Self

pub fn with_context(config: ModuleConfig, ctx: EvalContext) -> Self

Create an installer with pre-populated game environment context.

pub fn context(&self) -> &EvalContext

pub fn context_mut(&mut self) -> &mut EvalContext

pub fn config(&self) -> &ModuleConfig

pub fn check_dependencies(&self) -> bool

Check module-level dependencies. Returns true if satisfied.

pub fn visible_steps(&self) -> Vec<(usize, &InstallStep)>

Get visible install steps (steps whose visibility conditions are met).

pub fn select( &mut self, step_index: usize, group_index: usize, plugin_indices: Vec<usize>, )

Record user selections for a group within a step.

plugin_indices are indices into the group’s plugin list.

pub fn default_selections_in_context( group: &Group, ctx: &EvalContext, ) -> Vec<usize>

Get the default selections for a group based on context-aware plugin types.

Evaluates dependencyType patterns against the provided context to determine actual plugin types at runtime.

pub fn default_selections(group: &Group) -> Vec<usize>

Get the default selections for a group based on static plugin types.

For dependencyType descriptors, uses the default type without evaluating conditions. Suitable for template generation.

pub fn validate_selection( group: &Group, selected: &[usize], ) -> Result<(), SelectionError>

Validate selections against group type constraints.

pub fn resolve(&self) -> InstallPlan

Resolve the final installation plan from all selections.

pub fn step_name(&self, step: usize) -> Option<&str>

Get the name of a step by index.

pub fn group_name(&self, step: usize, group: usize) -> Option<&str>

Get the name of a group within a step.

pub fn plugin_description( &self, step: usize, group: usize, plugin: usize, ) -> Option<&str>

Get a plugin’s description text.

pub fn plugin_image_path( &self, step: usize, group: usize, plugin: usize, ) -> Option<&str>

Get a plugin’s image path (relative to the mod archive root).

pub fn module_image_path(&self) -> Option<&str>

Get the module header image path.

pub fn plugin_type_at( &self, step: usize, group: usize, plugin: usize, ) -> Option<PluginType>

Get the resolved plugin type in the current context.

pub fn group_type_at(&self, step: usize, group: usize) -> Option<GroupType>

Get the group type for a specific group.

pub fn resolve_image( &self, base_path: &Path, image_path: &str, ) -> Option<PathBuf>

Resolve an image path from the FOMOD XML against the mod archive root.

Performs case-insensitive file lookup since FOMOD is Windows-centric and paths may not match the actual filesystem case on Linux.

pub fn preview_plugin( &self, step: usize, group: usize, plugin: usize, ) -> Vec<FileOperation>

Preview the file operations a specific plugin would contribute.

pub fn preview_current(&self) -> InstallPlan

Preview the install plan based on current selections (without conditional file installs).

This gives a “what you’ve chosen so far” view, useful for showing running totals during the wizard.

pub fn completion_status(&self) -> CompletionStatus

Get overall completion status of the wizard.

pub fn is_ready_to_install(&self) -> bool

Check if all required groups have valid selections and installation can proceed.

pub fn missing_selections(&self) -> Vec<(usize, usize)>

Return (step_idx, group_idx) pairs for groups that still need user input.

pub fn validate_step(&self, step_index: usize) -> Vec<ValidationHint>

Validate all groups in a step and return detailed hints for the UI.

pub fn detect_conflicts(&self) -> Vec<FileConflict>

Detect file conflicts: plugins that install to the same destination path.

pub fn flag_impact_map(&self) -> Vec<FlagImpact>

Build a map of which plugins set flags that affect other steps’ visibility.

Returns a list of impacts: “selecting plugin X may show/hide step Y”.

pub fn checkpoint(&mut self)

Save a snapshot of current selections and context for later rollback.

pub fn rollback(&mut self) -> bool

Rollback to the most recent checkpoint. Returns false if no history.

pub fn history_len(&self) -> usize

Number of available undo checkpoints.

pub fn selections(&self) -> &HashMap<(usize, usize), Vec<usize>>

Get current selections (read-only).