# Slot Text

Número ou palavra que gira como rolo de caça-níquel e assenta da esquerda pra direita, sem passar do alvo.

- Nome no registry: `slot-text`
- Tipo: componente
- Dependências npm: motion
- Demo: https://ui.visantlabs.com/c/slot-text
- Categorias: texto, numero, preco, contador, slot

## Quando usar

- Use quando: Preço, placar ou contador que muda ao vivo girando como rolo de caça-níquel
- Evite quando: Número que só apura ao entrar na tela: count-up; palavra de botão trocando, text-morph

## Instalar

```bash
npx shadcn@latest add @visant/slot-text
```

## Usar

```tsx
<SlotText />
```

## API

### SlotText

- `value: string | number` — O valor. Número passa por `format`; texto entra como está.
- `align?: "start" | "end"` — De que ponta os rolos casam quando o tamanho muda. Número: fim; texto: começo.
- `announce?: boolean = false` — Anuncia o valor novo ao leitor de tela, com educação.
- `duration?: number = 0.9` — Segundos que o primeiro rolo gira.
- `format?: (value: number) => string = "(n: number) => n.toLocaleString("pt-BR")"` — Formata número. Default: agrupamento pt-BR (12.480).
- `spins?: number = 1` — Voltas inteiras antes de pousar. 0 rola direto pro dígito novo.
- `stagger?: number = 0.07` — Segundos entre um rolo parar e o próximo.