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

<Meta of={AvatarStories} />

<Title />
<Subtitle>Displays a user&apos;s identity visually as a photo or initials.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Fallback is mandatory** — Always include `<AvatarFallback>`.
> - **Accessibility** — Provide descriptive `alt` text for `<AvatarImage>`.
> - **Sizing** — Use standard sizes: `h-8 w-8` for small and `h-10 w-10` for default.