# Orbit Menu

Botão que abre as ações em arco ao redor dele, com mola, pra escolher arrastando o dedo ou clicando.

- Nome no registry: `orbit-menu`
- Tipo: componente
- Dependências npm: lucide-react, motion
- Demo: https://ui.visantlabs.com/c/orbit-menu
- Categorias: controles, menu, acoes, gesto, arco, mola

## Quando usar

- Use quando: Botão flutuante que abre poucas ações em arco, escolhidas arrastando o dedo, em app mobile
- Evite quando: Navegação principal: side-nav ou nav-drawer; barra de atalhos no desktop, magnify-dock

## Instalar

```bash
npx shadcn@latest add @visant/orbit-menu
```

## Usar

```tsx
<OrbitMenu
  label="Ações da nota"
/>
```

## API

### OrbitMenu

- `actions: OrbitAction[]`
- `className?: string`
- `icon?: any` — Ícone do botão fechado.
- `label?: string = "Ações"` — Nome do menu: rótulo do botão e texto central com o arco aberto.
- `onAction?: (id: string) => void` — Chamado com o `id` da ação escolhida.
- `onOpenChange?: (open: boolean) => void` — Avisa quando o arco abre ou fecha (pra esmaecer o objeto, por exemplo).
- `radius?: number = 100` — Distância do centro do botão até o centro de cada ação, em px.
- `spread?: number = 160` — Abertura do arco em graus, centrado em cima do botão.