import { Meta, Title, Subtitle, Description, Primary, Controls, Stories, Canvas } from '@storybook/addon-docs/blocks';
import * as StepperStories from './stepper.stories';

<Meta of={StepperStories} />

<Title />
<Subtitle>A multi-step progress indicator for sequential user flows.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **1-Indexed Steps** — Both `currentStep` and the individual `step` props must be 1-indexed (e.g., start from 1, not 0).
> - **Consistent Ordering** — Ensure the `step` prop on each child matches its visual and logical position in the sequence.
> - **Navigation Logic** — Place "Previous" and "Next" buttons below the stepper, and disable the "Previous" button when on the first step.