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

<Meta of={MenubarStories} />

<Title />
<Subtitle>A desktop-style horizontal menu bar with multiple persistent dropdowns.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Power User Focus** — Menubar is intended for technical tools and editors. For standard dashboards, prefer a `Sidebar` or `NavigationMenu`.
> - **Shortcuts** — Use `MenubarShortcut` to display keyboard shortcuts, ensuring they are right-aligned within the item.
> - **Visual Alignment** — Use the `inset` prop for items that do not have leading icons to keep text aligned with neighbors that do.