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

<Meta of={DialogStories} />

<Title />
<Subtitle>A modal overlay for critical confirmations and data entry.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Accessibility** — `DialogTitle` is required. `DialogTrigger` should always use `asChild` with a `Button`.
> - **Modal Flow** — Use dialogs for supplementary tasks. For irreversible destructive actions, use `AlertDialog`.
> - **Mobile** — For mobile-first interfaces, consider using `Drawer` instead of `Dialog`.