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

<Meta of={ToggleGroupStories} />

<Title />
<Subtitle>A synchronized set of toggle buttons with single or multiple selection.</Subtitle>

<Description />

<Primary />

---

## Variations

<Stories />

---

## AI Best Practices

> [!IMPORTANT]
> - **Selection Mode** — Explicitly define the `type` prop as either `single` or `multiple` based on the semantic requirement of the group.
> - **Accessibility** — Ensure every `ToggleGroupItem` has an `aria-label` when only an icon is displayed.
> - **Default Values** — Use `defaultValue` or `value` to ensure the group has a pre-selected state if required.