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

<Meta of={ButtonStories} />

<Title />
<Subtitle>The primary interaction trigger for user actions.</Subtitle>

<Description />

<Primary />

## Controls
<Controls />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Never use native `<button>`** — always use `<Button>` from `xertica-ui`.
> - **Action Pair** — When placing two buttons side-by-side, ensure only one is `variant="default"`.
> - **Icon Only** — Always provide an `aria-label` for icon-only buttons.