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

<Meta of={ContextMenuStories} />

<Title />
<Subtitle>A right-click or long-press menu for contextual actions.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Supplement, Don't Replace** — Context menus are hidden by default; always provide a visible UI control (like a button or meatball menu) for primary actions.
> - **Visual Alignment** — Use the `inset` prop on items without icons to maintain consistent text alignment with neighbors that have icons or complex triggers.
> - **Semantic Color** — Use `className="text-destructive"` for menu items that perform irreversible actions like "Delete".