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

<Meta of={ToggleStories} />

<Title />
<Subtitle>A two-state button that can be toggled on or off.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **ARIA Labelling** — Always provide an `aria-label` for icon-only toggles to ensure accessibility.
> - **Semantic Choice** — Use `Toggle` for toolbar-style interactions. For user preferences or configuration settings, use `Switch` or `Checkbox`.
> - **State Management** — Use `pressed` and `onPressedChange` for controlled components.