# Photo Flip

A foto atravessa da grade para a tela cheia — mesmo nó do DOM, reparentado e animado por GSAP Flip com ease-in-out. A vaga segura a proporção pra grade não desabar, e o foco volta pra foto que abriu.

- Nome no registry: `photo-flip`
- Tipo: componente
- Dependências npm: gsap
- Demo: https://ui.visantlabs.com/c/photo-flip
- Categorias: transicoes, foto, galeria, lightbox, flip, morph, grade, gsap

## Quando usar

- Use quando: Abrir foto da grade em tela cheia com transição contínua, como lightbox de portfólio
- Evite quando: Só exibir a grade: masonry-gallery; comparar duas versões, photo-compare

## Instalar

```bash
npx shadcn@latest add @visant/photo-flip
```

## Usar

```tsx
<PhotoFlip
  ratio="4/5"
/>
```

## API

### PhotoFlip

- `items: PhotoFlipEntry[]`
- `dialogLabel?: string = "Foto ampliada"` — Rótulo do overlay para leitor de tela.
- `ratio?: string = 1` — Proporção do tile na grade. A tela cheia usa a proporção real da foto.
