# Gauge

Medidor em arco com ponteiro que enche quando entra em vista e troca o nome da faixa na hora em que a contagem cruza o limite.

- Nome no registry: `gauge`
- Tipo: componente
- Dependências npm: motion
- Demo: https://ui.visantlabs.com/c/gauge
- Categorias: conteudo, dados, medidor, cota, grafico, meter

## Quando usar

- Use quando: Medidor de cota ou uso em dashboard, com o nome da faixa trocando ao cruzar o limite
- Evite quando: Métrica com régua e evidência: measure-bar; nível de áudio ao vivo, vintage-meter

## Instalar

```bash
npx shadcn@latest add @visant/gauge
```

## Usar

```tsx
<Gauge
  value={84}
  detail="de 500 GB"
  label="Espaço do plano"
  size={208}
/>
```

## API

### Gauge

- `label: string` — O que está sendo medido. Vira o nome acessível.
- `value: number` — Valor atual, entre `min` e `max`.
- `bands?: GaugeBand[]` — Faixas por valor inicial. A maior faixa alcançada dá o nome e a cor.
- `detail?: string` — Qualificador: a régua em palavras ("360 de 500 GB").
- `max?: number = 100`
- `min?: number = 0`
- `size?: number = 176` — Largura máxima do anel, em px.