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

<Meta of={RadioGroupStories} />

<Title />
<Subtitle>A set of mutually exclusive options where only one can be selected.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Exclusivity** — Only one radio button in a group can be selected at a time.
> - **Matching Labels** — Always link `RadioGroupItem` to a `Label` using matching `id` and `htmlFor`.
> - **Option Limit** — Use `RadioGroup` for 2–6 options. For larger lists, use `Select`.