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

<Meta of={RatingStories} />

<Title />
<Subtitle>A star-based input for collecting feedback or displaying quality scores.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Input Pattern** — Always use the `value` and `onChange` pattern instead of spreading field props in forms.
> - **Display Mode** — Use the `readOnly` prop for non-interactive score displays to preserve proper styling and accessibility.
> - **Size Consistency** — Use `sm` for table rows and `md` or `lg` for feedback forms.