## Overview

The Step Manager widget is an overview widget of all existing Forms Wizard steps. It serves as the central management interface for Forms Wizard administrators to view, organize, and manage the complete list of steps that make up a wizard. It provides a sortable, actionable table view that shows key information about each step, helping administrators understand the wizard's structure at a glance and perform step lifecycle operations.

The widget displays a table with six columns: Name (clickable link to step configuration), Identifier, Type (Form, Script, Info, Summary, Table), Configuration Complete (visual indicator), Created At (timestamp), and Order in Wizard (position in execution flow). It also provides buttons for creating new steps and deleting selected steps.

This widget can only be embedded on pages of type `cf.cplace.formsWizard.wizard` (Forms Wizard configuration pages).

## Use Cases

- **Step Inventory and Organization**: View all steps in a wizard with their names, types, and execution order to understand the wizard's structure
- **Configuration Monitoring**: Identify steps with incomplete configurations using the visual indicator before activating a wizard
- **Creating New Steps**: Add new steps to a wizard using the "Create Step" button, which pre-fills wizard context automatically
- **Removing Obsolete Steps**: Delete steps that are no longer needed using the "Delete step" action with confirmation
- **Understanding Flow Sequence**: Review the "Order in Wizard" column to visualize the navigation flow and identify unreachable steps
- **Quick Navigation**: Click step names to navigate directly to step configuration pages
- **Step Type Overview**: Assess the mix of step types (Form, Script, Info, Summary) in the wizard
- **Tracking Step Creation**: Use creation timestamps for auditing or troubleshooting

## Design Considerations

The Step Manager widget is designed to work in conjunction with other Forms Wizard widgets on a wizard configuration page:

- **Wizard Analysis Widget**: The "Configuration Complete" indicator references the Analysis widget for detailed validation messages. Use both widgets together to ensure proper step configuration.
- **Real-Time Updates**: The widget automatically refreshes when step relationships change or wizard activation state changes, ensuring the table always shows current data.
- **Permission-Aware**: Buttons and actions only appear for users with edit permissions on the wizard.

## Alternatives

- **Wizard Analysis Widget** (`cf.cplace.formsWizard.wizardAnalysis`): For detailed validation feedback on step configurations rather than table overview
- **Step Editor for Wizard Widget** (`cf.cplace.formsWizard.stepEditorForWizardWidget`): For inline step editing embedded on wizard pages
- **Step Editor Widget** (`cf.cplace.formsWizard.stepEditorWidget`): For configuring individual step properties on dedicated step pages