# Marquee

Faixa infinita em GSAP com três modos de scroll: empurrar o ritmo, virar esteira do scroll ou amarrar a posição à rolagem.

- Nome no registry: `marquee`
- Tipo: componente
- Dependências npm: gsap
- Demo: https://ui.visantlabs.com/c/marquee
- Categorias: conteudo, faixa, loop, scroll, gsap, vitrine

## Quando usar

- Use quando: Faixa infinita de texto ou itens numa landing, com ritmo empurrado ou amarrado ao scroll
- Evite quando: Faixa de logos de clientes: use logo-wall, que já normaliza tamanho e cor

## Instalar

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

## Usar

```tsx
<Marquee />
```

## API

### Marquee

- `items: any[]`
- `band?: boolean = false` — Faixa de cor sólida com a cor da marca.
- `bleed?: number | false = false` — Quantos px a faixa sangra pra fora do container, de cada lado.
- `boost?: number = 4` — Teto do empurrão em `"boost"`. 4 = até 4× o ritmo base no scroll bruto.
- `fade?: boolean = false` — Some nas bordas em vez de ser cortado a faca.
- `gap?: number = 56`
- `laps?: number = 1` — Voltas percorridas na travessia da dobra em `"drive"` e `"scrub"`.
- `pauseOnHover?: boolean = true` — Pausa no hover/foco. Desligue em faixa puramente decorativa.
- `reverse?: boolean = false` — Anda para a direita. Duas faixas em sentidos opostos leem como sistema.
- `scroll?: false | "boost" | "drive" | "scrub" = "boost"` — Como o scroll entra na faixa.
- `speed?: number = 46` — Segundos para uma volta completa no ritmo base. Mais itens pedem mais tempo.
- `tilt?: number = 0` — Inclina a faixa. Exige um pai com `overflow: hidden`.