antigravity-skills-reference/skills/avalonia-viewmodels-zafiro/wizards.md

Wizards & Flows

Complex multi-step processes are handled using the SlimWizard pattern. This provides a declarative way to define steps, navigation logic, and final results.

Defining a Wizard

Use WizardBuilder to define the steps. Each step corresponds to a ViewModel.

SlimWizard<string> wizard = WizardBuilder
    .StartWith(() => new Step1ViewModel(data))
        .NextUnit()
        .WhenValid()
    .Then(prevResult => new Step2ViewModel(prevResult))
        .NextCommand(vm => vm.CustomNextCommand)
    .Then(result => new SuccessViewModel("Done!"))
        .Next((_, s) => s, "Finish")
    .WithCompletionFinalStep();

Navigation Rules

• NextUnit(): Advances when a simple signal is emitted.
• NextCommand(): Advances when a specific command in the ViewModel execution successfully.
• WhenValid(): Wait until the current ViewModel's validation passes before allowing navigation.
• Always(): Navigation is always allowed.

Navigation Integration

The wizard is navigated using an INavigator:

public async Task CreateSomething()
{
    var wizard = BuildWizard();
    var result = await wizard.Navigate(navigator);
    // Handle result
}

Step Configuration

• WithCompletionFinalStep(): Marks the wizard as finished when the last step completes.
• WithCommitFinalStep(): Typically used for wizards that perform a final "Save" or "Deploy" action.

Note

The SlimWizard handles the "Back" command automatically, providing a consistent user experience across different flows.