# Bacalhau

O Bacalhau é o mascote da RivoCode: um bacalhau chibi, cor de limão, de olhos
grandes e bochechas rosadas. São 36 poses do mesmo corpo na mesma caixa, quatro
chapéus de festa, os movimentos que dão vida a ele e a versão que espia por
cima de uma borda, o `BacalhauPeek`. Vive em `@rivocode/ui/mascot`, fora do
índice da raiz, para quem não mostra o mascote não pagar pelo desenho.

```tsx
import { Button, Result } from '@rivocode/ui'
import { Bacalhau } from '@rivocode/ui/mascot'

<Result
  layout="page"
  titleAs="h1"
  illustration={<Bacalhau pose="searching" size="xl" />}
  meta="Erro 404"
  title="Esta página foi pescada"
  description="O endereço pode ter mudado ou ter sido digitado errado."
  actions={<Button>Voltar ao início</Button>}
/>
```

**Ele é o rosto da marca, e não o logo.** O logo da RivoCode continua sendo as
ondas. O Bacalhau aparece onde a conversa é com uma pessoa: a página que não
existe, a busca que não achou, o envio que deu certo, o chat que pergunta.

**Em produto da RivoCode, todo estado desenhado é dele.** Onde a tela de um
cliente põe uma [Illustration](/componentes/illustration), a da RivoCode põe o
Bacalhau, no mesmo tamanho:

| Situação | `Illustration` | `Bacalhau` |
|---|---|---|
| Página que não existe | `NotFound` | `pose="searching"` |
| Sem permissão | `Forbidden` | `pose="locked"` |
| Falhou do nosso lado | `ServerError` | `pose="sad" motion="shake"` |
| Consulta que falhou, na página ou na seção | `ServerError` no `errorIllustration` | `pose="sad" motion="shake"` no `errorIllustration` |
| Sem conexão | `Offline` | `pose="offline"` |
| Em manutenção | `Maintenance` | `pose="builder"` |
| Vazio de primeira vez | `EmptyList` | `pose="emptyBox"` |
| Busca sem resultado | `NoResults` | `pose="shrug"` |
| Tudo lido | `EmptyInbox` | `pose="thumbsUp"` |
| Sem dado no período | `NoData` | `pose="calendar"` |

O vazio pequeno, numa coluna ou num cartão estreito, fica no `icon` do
`EmptyState`, sem mascote. No produto de um cliente ele não entra: as cores
dele são as da RivoCode, e não mudam com o tema.

## As poses

Toda pose é o mesmo bacalhau fazendo outra coisa: mudam os braços, o rosto e
um adereço, e o corpo, as cores e a caixa ficam. Trocar de pose não pula. A
cauda bifurcada sai de lado e a barbatana de vela fica no topo: é por elas que
ele se lê como peixe, até em 40px. A emoção mora no corpo inteiro: no triste a
pálpebra cai e o corpo achata, no surpreso o olho cresce e o corpo estica, no
preocupado a pupila encolhe e aparece a gota de suor.
`MASCOT_POSES` lista as 36, na ordem da galeria:

**Na interface** - as que respondem a um momento do produto: os quatro
momentos de uma ação, o vazio, o erro e a conversa.

| `pose` | O que ele faz | Onde cabe |
|---|---|---|
| `standing` | Em pé, à vontade | O padrão. Qualquer lugar onde ele só precisa estar |
| `waving` | Dando oi, a mão acena | Boas-vindas, abrir uma conversa, despedida |
| `celebrating` | Comemorando, os brilhos piscam | Deu certo: mensagem enviada, projeto no ar |
| `thinking` | Pensando, o balão aparece em bolinhas | Enquanto ele "digita", perguntas frequentes |
| `pointing` | Apontando para o lado esquerdo da tela | Chamar atenção para um campo ou uma seção à esquerda dele |
| `coding` | Programando, as mãos digitam | Enviando, carregando, "como trabalhamos" |
| `support` | Atendendo, de fone | Atendimento, contato, suporte |
| `sleeping` | Dormindo, os "z" sobem | Fora do horário, nada acontecendo |
| `surprised` | Surpreso, as linhas de susto pulsam | Novidade, resultado inesperado |
| `sad` | Tristinho, com uma lágrima, olhando para baixo | Erro no envio, página 404 |
| `searching` | Com a lupa, que procura | Busca, diagnóstico |
| `launching` | Lançando o foguete, que decola | Entrega, projeto no ar, app publicado |
| `winking` | Piscando | Dica escondida, "deixa com a gente" |
| `goodbye` | Tchau, de costas | Fim de conversa, "até a próxima" |
| `builder` | De capacete de obra | Em construção, manutenção |
| `walking` | Andando, os pés se alternam | A caminho, "estou indo aí" |
| `walkingAway` | Andando, de costas | Saindo: seguir para outro canal |
| `thumbsUp` | Beleza: a mão erguida, firme, e uma piscada | Aprovado, etapa concluída |
| `idea` | Tive uma ideia | Dica, insight |
| `shrug` | Não sei, ombros erguidos | Busca sem resultado, "ainda não sei bem" |
| `checklist` | Com a prancheta | Escopo, processo, entregas |
| `mail` | Chegou e-mail | Confirmação de envio |
| `calendar` | Com o calendário | Prazo, agendamento |
| `shield` | Com o escudo | Segurança, LGPD, backup |
| `bell` | Tocando o sino | Notificação, lembrete |
| `offline` | Olhando o sinal de rede cortado | Sem conexão; o par da `Offline` |
| `locked` | Segurando o cadeado | Sem permissão, área restrita; o par da `Forbidden` |
| `emptyBox` | Olhando dentro da caixa vazia | Vazio de primeira vez, nada criado ainda; o par da `EmptyList` |

**No site e na comunicação** - as que contam o que a RivoCode faz. Cabem na
página institucional, na proposta e na rede social, e não respondem a nenhum
estado de tela.

| `pose` | O que ele faz | Onde cabe |
|---|---|---|
| `reading` | Lendo, de óculos | Termos, contratos, "lendo com você" |
| `trophy` | Com o troféu | Meta batida, resultado alcançado |
| `love` | Com coração, que bate | Agradecimento, cliente novo |
| `presenting` | Segurando o quadro do gráfico | Relatório, painel, resultado |
| `wrenchGear` | Ajustando as engrenagens, que giram | Ajustes, melhoria contínua |
| `cloud` | Com a nuvem | Hospedagem |
| `aiChip` | Com o chip de IA | IA aplicada, automação |
| `gift` | Com um presente | Datas especiais, cliente novo |

Nome desconhecido cai em `standing`, e não quebra a tela.

## Espiando

`BacalhauPeek` é ele por cima de uma borda: só a cabeça e as mãos, agarradas
na beirada. A borda de baixo do desenho é a borda por onde ele espia, então
encoste-o no topo de um painel, de um cartão ou da tela. Ao montar ele sobe
com cautela, olha para um lado e para o outro e agarra a borda; depois flutua
e pisca. `happy` fecha os olhos em arco e ele sorri.

Passe o painel como `children` e ele passa entre as duas camadas: a cabeça
atrás da beirada, as mãos na frente. `visible` o põe e o tira de cena,
`followPointer` faz os olhos seguirem o ponteiro e `shy` o faz fugir dele; a
página do `BacalhauPeek` tem cada uma.

```tsx
import { BacalhauPeek } from '@rivocode/ui/mascot'

<BacalhauPeek size="sm" happy={hovering} visible={onStage} followPointer>
  <Card>...</Card>
</BacalhauPeek>
```

## Chapéus e o calendário

`hat` veste um dos quatro chapéus de `MASCOT_HATS`, cada um com a festa em
volta: `party` (Carnaval, com confete e serpentina), `straw` (São João, com o
varal de bandeirinhas), `santa` (Natal, com neve) e `newyear` (Réveillon, com
fogos). O chapéu vai de lado e deixa a barbatana da cabeça à vista. Na pose `builder` o capacete já
é o chapéu, e `hat` fica de fora.

`hat="season"` escolhe pela data de hoje no aparelho de quem vê, e ninguém
precisa publicar nada em cada festa:

| Chapéu | Quando |
|---|---|
| `party` | Do sábado à quarta-feira de cinzas, calculado pela Páscoa a cada ano |
| `straw` | O mês de junho inteiro |
| `santa` | De 1 a 25 de dezembro |
| `newyear` | De 26 de dezembro a 1º de janeiro |

Fora dessas datas, sem chapéu. No navegador a data só é lida depois de montar,
então a página pré-renderizada não guarda o dia do build. `seasonHat(date)` faz
a mesma conta para quem quer decidir por conta própria.

## Movimento

**As partes da pose se mexem sozinhas**: a mão acena, os brilhos piscam, os
"z" sobem, o foguete decola, a lupa procura, os pés andam e a barbatana vem um
instante depois. `animated={false}` desenha a pose parada.

**O corpo inteiro** se mexe com `motion`, um dos seis de `MASCOT_MOTIONS`:

| `motion` | O que faz | Para quê |
|---|---|---|
| `breathe` | Infla e desinfla devagar | Parecer vivo mesmo parado: a espera |
| `bounce` | Quica no lugar | O que deu certo, junto com `celebrating` |
| `shake` | Uma tremidinha, duas vezes | O erro, junto com `sad` |
| `swim` | Balança como na água | O carregando |
| `hop` | Um pulinho | A troca de pose num perfil de chat |
| `flip` | Um mortal | O momento raro, um easter egg |

`confetti` solta uma chuva de confete nas cores da marca de trás dele, uma vez,
em 1,6 s. Confete é só para o que deu certo de verdade.

**Nada fica em laço sem pedir.** O que repete toca o que cabe em 5 s e para no
repouso, dentro da WCAG 2.2.2, que pede pausa para movimento automático mais
longo que isso. `loop` mantém rodando, e serve só à tela de carregamento, em
que o movimento é o próprio aviso de espera.

**Reduzir movimento.** Com a preferência do sistema ligada, tudo nasce parado e
o confete não aparece, sem precisar desligar nada. Os quadros vêm junto com a
peça, e não na `styles.css`: quem não usa o mascote não baixa nenhum deles.

```tsx
import { Bacalhau } from '@rivocode/ui/mascot'

<div role="status" className="flex flex-col items-center gap-2">
  <Bacalhau pose="walking" motion="swim" loop />
  <span>Um instante, estou nadando até lá.</span>
</div>
```

## Medidas

`size` escolhe a altura, e a largura sai da caixa do desenho:

- **`xs`, 40 px**: o avatar de um chat.
- **`sm`, 64 px**: ao lado de um texto, numa lista.
- **`md`, 112 px** (o padrão): o vazio de uma seção.
- **`lg`, 160 px**: o centro de uma tela.
- **`xl`, 224 px**: a página inteira, como o 404.

O `BacalhauPeek` mede pela largura: `sm` 80, `md` 128 (o padrão) e `lg` 176.

## Cor

As cores são da marca e fixas, e não mudam com o tema: o limão do corpo, o
verde das barbatanas e das pintinhas, a tinta do contorno, o rosa das
bochechas, e os tons dos adereços. Elas moram em `src/tokens/mascot.ts`, o
único lugar de onde a biblioteca tira cor literal. No escuro a silhueta é o
limão contra o fundo; no claro, o contorno de tinta. Não recolora o Bacalhau.

## Acessibilidade

O desenho é decorativo e sai com `aria-hidden`: quem diz o que houve é o texto
ao lado. Quando o desenho é a mensagem, dê um `label`, e ele vira imagem com
esse nome.

## Classe por parte

`classNames` alcança `art` (o `<svg>`) e `confetti` (a caixa onde o confete
cai, para alargá-la além do desenho com um `-inset-*`). O `className` vai na
caixa de fora.

## Regras do personagem

- **Um bacalhau por vez na tela.** Dois na mesma tela deixam de ser um
  personagem e viram decoração.
- **Ele reage ao que aconteceu de verdade.** Pensa enquanto carrega, comemora
  quando dá certo, fica triste no erro. Nunca comemora o que não aconteceu.
- **Fala curto, em português simples, com bom humor.** Um trocadilho de peixe
  de vez em quando, não em toda frase. Nunca inventa depoimento, número ou
  cliente.
- **Sempre o mesmo personagem**: cabeça grande, olhos do mesmo tamanho, dois
  brilhos em cada um, bochechas rosadas. Não distorça, não recolora e não
  deite.

## Quando não usar

- **Tela de erro e de vazio dentro do produto de um cliente** é a
  `Illustration`. Ela troca de cor com o tema do cliente; o Bacalhau é da
  RivoCode e não troca.
- **Carregando dentro de uma tela que já tem conteúdo** é `Skeleton` ou
  `Spinner`. O mascote nadando é para a tela inteira que ainda não tem nada.
- **A pessoa do outro lado** é `Avatar`. O mascote não representa usuário
  nenhum.
- **A assinatura da empresa** é o logo de ondas, e não o Bacalhau.

## No React Native

Traduz em `@rivocode/ui-native/mascot`, com o `Bacalhau` e o `BacalhauPeek` e as mesmas props do web: `pose` (as 36 de `MASCOT_POSES`), `hat` (os quatro de `MASCOT_HATS`, e o `season`), `motion` (os seis de `MASCOT_MOTIONS`), `animated`, `loop`, `confetti`, `size` e `label`. A geometria é a mesma do web, dividida em `shared/mascot.ts`: o Bacalhau do celular é o do navegador, traço a traço.

**Desenha com o `react-native-svg`, peer da raiz**, o mesmo do `/chart` e das ilustrações, e mora em caminho próprio pelo peso. As cores são da marca e não mudam com o tema: saem de `tokens.mascot`, geradas da mesma paleta do web.

```tsx
import { Bacalhau, BacalhauPeek } from "@rivocode/ui-native/mascot";

<Bacalhau pose="celebrating" motion="bounce" confetti />
<BacalhauPeek size="sm" hat="season" />
```

Os movimentos tocam no `react-native-reanimated` que o pacote já usa, com os quadros de `MASCOT_CHOREOGRAPHY`, a mesma tabela de onde o web gera o CSS. Cada parte que se mexe é uma camada própria, com o pivô no mesmo ponto do desenho. O que repete para em 5 s, como no web, a não ser com `loop`. Com "reduzir movimento" do sistema tudo nasce parado e o confete não sai. O desenho fica escondido do leitor de tela até ganhar `label`, e então vira `image` com esse nome. O `Bacalhau` não tem `classNames`: o `className` veste a caixa de fora.

O `BacalhauPeek` traz as duas camadas do web, a cabeça e as mãos, com `classNames` de `head`, `hands` e `edge`, e o painel entra por `children`, entre elas; `align` e `visible` também atravessam, e fora de cena ele desce para trás da borda e some do leitor de tela. **A reserva do lugar da cabeça fica no web por enquanto**: lá a moldura soma no topo a altura da cabeça, e `overlap` desliga; no nativo a cabeça ainda sobe por cima do que vem antes, e quem monta abre o vão com `mt-*` na moldura. **`followPointer` e `shy` ficam no web**: são reações ao ponteiro de mesa, e no toque não há ponteiro pairando para seguir nem de que fugir - o dedo só existe quando já tocou.

## Importação

```tsx
import { Bacalhau } from '@rivocode/ui/mascot'
```

## Exemplos

### Dando oi

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function Waving() {
  return <Bacalhau pose="waving" size="lg" />
}
```

### Página não encontrada

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function PageNotFound() {
  return (
    <Result
      layout="page"
      focusOnMount={false}
      illustration={<Bacalhau pose="sad" motion="shake" size="xl" />}
      meta="Erro 404"
      title="Esta página foi pescada"
      description="O endereço pode ter mudado ou ter sido digitado errado. O Bacalhau procurou e não achou nada aqui."
      actions={<Button>Voltar ao início</Button>}
    />
  )
}
```

### Busca sem resultado

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function NothingFound() {
  return (
    <Card>
      <EmptyState
        illustration={<Bacalhau pose="shrug" size="md" />}
        title="Nada com esse nome"
        description="Tente outra palavra, ou procure pelo nome da peça."
      />
    </Card>
  )
}
```

### Deu certo, com confete

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function Celebrating() {
  return <Bacalhau pose="celebrating" motion="bounce" confetti size="lg" label="O Bacalhau comemorando" />
}
```

### Carregando

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

const REACTIONS: { label: string; pose: MascotPose }[] = [
  { label: 'Abrir a conversa', pose: 'waving' },
  { label: 'Pensando', pose: 'thinking' },
  { label: 'Enviando', pose: 'coding' },
  { label: 'Deu certo', pose: 'celebrating' },
  { label: 'Falhou', pose: 'sad' },
]

export function Loading() {
  return (
    <div role="status" className="flex flex-col items-center gap-2">
      <Bacalhau pose="walking" motion="swim" loop size="md" />
      <span className="text-sm text-fg-muted">Um instante, estou nadando até lá.</span>
    </div>
  )
}

const REACTIONS: { label: string; pose: MascotPose }[] = [
  { label: 'Abrir a conversa', pose: 'waving' },
  { label: 'Pensando', pose: 'thinking' },
  { label: 'Enviando', pose: 'coding' },
  { label: 'Deu certo', pose: 'celebrating' },
  { label: 'Falhou', pose: 'sad' },
]
```

### Perfil do chat que troca de pose

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

const REACTIONS: { label: string; pose: MascotPose }[] = [
  { label: 'Abrir a conversa', pose: 'waving' },
  { label: 'Pensando', pose: 'thinking' },
  { label: 'Enviando', pose: 'coding' },
  { label: 'Deu certo', pose: 'celebrating' },
  { label: 'Falhou', pose: 'sad' },
]

export function ChatProfile() {
  const [pose, setPose] = useState<MascotPose>('waving')
  return (
    <div className="flex flex-col gap-4">
      <div className="flex items-center gap-3">
        <span className="grid size-12 shrink-0 place-items-center rounded-full border border-border bg-surface">
          <Bacalhau pose={pose} motion="hop" size="xs" />
        </span>
        <span className="flex flex-col">
          <span className="text-sm text-fg">Bacalhau</span>
          <span className="font-mono text-xs text-fg-subtle">mascote da RivoCode</span>
        </span>
      </div>
      <div className="flex flex-wrap gap-2">
        {REACTIONS.map((reaction) => (
          <Button key={reaction.pose} size="sm" variant="secondary" onClick={() => setPose(reaction.pose)}>
            {reaction.label}
          </Button>
        ))}
      </div>
    </div>
  )
}
```

### Espiando por cima da borda

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function Peeking() {
  return (
    <div className="flex flex-wrap items-end gap-6">
      <div className="border-b-2 border-border-strong">
        <BacalhauPeek />
      </div>
      <div className="border-b-2 border-border-strong">
        <BacalhauPeek happy />
      </div>
    </div>
  )
}
```

### Por cima de um painel, entrando e saindo de cena

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function OverAPanel() {
  const [onStage, setOnStage] = useState(true)
  return (
    <div className="flex w-full max-w-md flex-col gap-4 pt-24">
      <BacalhauPeek size="sm" visible={onStage} followPointer shy>
        <Card className="p-6">
          <p className="text-sm text-fg-muted">
            A cabeça fica atrás da borda do cartão, e as mãos, na frente dela.
          </p>
        </Card>
      </BacalhauPeek>
      <Button variant="secondary" onClick={() => setOnStage((now) => !now)}>
        {onStage ? 'Tirar de cena' : 'Pôr em cena'}
      </Button>
    </div>
  )
}
```

### Os chapéus de festa

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function Hats() {
  return (
    <div className="flex flex-wrap items-end gap-6">
      {MASCOT_HATS.map((hat) => (
        <div key={hat} className="border-b-2 border-border-strong">
          <BacalhauPeek hat={hat} size="sm" animated={false} />
        </div>
      ))}
      <Bacalhau pose="waving" hat="season" size="md" />
    </div>
  )
}
```

### As 36 poses

```tsx
import { Button, Card, EmptyState, Result } from '@rivocode/ui'
import { Bacalhau, BacalhauPeek, MASCOT_HATS, MASCOT_POSES, type MascotPose } from '@rivocode/ui/mascot'
import { useState } from 'react'

export function AllPoses() {
  return (
    <div className="grid grid-cols-4 gap-4 sm:grid-cols-8">
      {MASCOT_POSES.map((pose) => (
        <div key={pose} className="flex flex-col items-center gap-1">
          <Bacalhau pose={pose} size="sm" animated={false} />
          <span className="font-mono text-xs text-fg-subtle">{pose}</span>
        </div>
      ))}
    </div>
  )
}
```

## Props

| Prop | Tipo | Obrigatória | Padrão | Desde | O que faz |
| --- | --- | --- | --- | --- | --- |
| `animated` | `boolean` |  | `true` | - | As partes da pose se mexem sozinhas: a mao acena, os brilhos piscam, o foguete decola, os pes andam. |
| `classNames` | `Partial<Record<"art" \| "confetti", string>>` |  |  | - | Classe por parte: `art` e o `<svg>`, `confetti` e a caixa do confete. |
| `confetti` | `boolean` |  | `false` | - | Uma chuva de confete nas cores da marca sai de tras dele ao montar, uma vez, em 1,6 s. |
| `hat` | `"newyear" \| "party" \| "santa" \| "season" \| "straw"` |  |  | - | O chapeu de festa: `party` (Carnaval), `straw` (Sao Joao), `santa` (Natal) ou `newyear` (Reveillon). |
| `label` | `string` |  |  | - | O nome do desenho para o leitor de tela. |
| `loop` | `boolean` |  | `false` | - | Sem `loop`, o movimento que repete toca o que cabe em 5 s e para no quadro de repouso, dentro da WCAG 2.2.2. |
| `motion` | `"bounce" \| "breathe" \| "flip" \| "hop" \| "shake" \| "swim"` |  |  | - | O movimento do corpo inteiro: `breathe` (respira, para a espera), `bounce` (quica, para o que deu certo), `shake` (treme duas vezes, para o erro), `swim` (nada, para o carregando), `hop` (pulinho, para a troca de pose) ou `flip` (o mortal). |
| `pose` | `"aiChip" \| "bell" \| "builder" \| "calendar" \| "celebrating" \| "checklist" \| "cloud" \| "coding" \| "emptyBox" \| "gift" \| "goodbye" \| "idea" \| "launching" \| "locked" \| "love" \| "mail" \| ... 20 more ...` |  | `"standing"` | - | O que ele esta fazendo, entre as 36 poses de `MASCOT_POSES`. |
| `size` | `MascotSize` |  | `"md"` | - | A altura: `xs` 40px (o avatar de um chat), `sm` 64px, `md` 112px, o padrao, `lg` 160px e `xl` 224px (a pagina inteira, como o 404). |

Além dessas: repassa `className`, `style`, `id` e os demais atributos do elemento raiz.

## Partes

O componente se monta com as peças abaixo. Todas vêm de `@rivocode/ui/mascot`.

### BacalhauPeek

O Bacalhau espiando por cima de uma borda: só a cabeça e as mãos, agarradas na
beirada. É o jeito de sempre dele no site da RivoCode, em cima do painel da
página inicial e no canto da tela.

```tsx
import { BacalhauPeek } from '@rivocode/ui/mascot'

<div className="flex justify-end border-b border-border">
  <BacalhauPeek size="sm" hat="season" />
</div>
```

A borda de baixo do desenho é a borda por onde ele espia: o que passa dela fica
cortado, e é assim que ele sobe "de trás" da beirada. Encoste-o no topo de um
painel, de um cartão ou da tela.

Ao montar, ele sobe com cautela até os olhos passarem da borda, olha para um
lado e para o outro, e só então aparece inteiro e agarra a beirada. Depois
flutua devagar e pisca. Com "reduzir movimento" ele já nasce no lugar, parado,
e `animated={false}` faz o mesmo numa instância. Como no `Bacalhau`, o que
repete para depois de 5 s, a não ser com `loop`.

`happy` fecha os olhos em arco e ele sorri: para o ponteiro que chega perto, ou
para a conversa que ele abre estar aberta. `hat` aceita os mesmos quatro
chapéus e o `season`. `size` mede pela largura: `sm` 90 px, `md` 144 px (o
padrão) e `lg` 198 px.

## Por cima de um painel

O desenho vem em duas camadas: a cabeça (`head`), um `<svg>` cortado na borda
de baixo, e as mãos (`hands`), que passam um pouco dela para a ponta cair por
cima da beirada. Passe o painel como `children` e a peça
vira a moldura dele: a cabeça vem antes do painel, as mãos depois, e o painel
passa entre as duas, sem `z-index` nenhum. Ele espia pela borda de cima do
painel, a 12% da ponta; `align` escolhe `start`, `center` ou `end` (o padrão).

```tsx
import { BacalhauPeek } from '@rivocode/ui/mascot'
import { Card } from '@rivocode/ui'

<BacalhauPeek size="sm" hat="season" align="end">
  <Card>...</Card>
</BacalhauPeek>
```

**A moldura reserva o lugar da cabeça.** Com `children`, a peça soma no topo a
altura da cabeça no `size` escolhido (71, 114 e 156 px), e a cabeça mora nesse
espaço: não cobre o título nem nada que venha antes. Não precisa mais de
`className="mt-12"` para abrir o vão. Quando a cabeça deve subir por cima do
que está ali de propósito, sobre um vão que já existe, passe `overlap`.

```tsx
<Heading>Seu painel</Heading>
<BacalhauPeek size="sm" align="start">
  <Card>...</Card>
</BacalhauPeek>
```

A cabeça corta na própria borda de baixo, e as mãos só passam dela a altura da
ponta que agarra: ao descer, elas soltam e somem sem atravessar o painel. Quer a cabeça inteira atrás de um
painel opaco, sem o corte? `classNames={{ head: 'overflow-visible' }}`: o
painel, que vem depois dela, a cobre. Sem `children`, as duas camadas ficam
empilhadas numa caixa só, e a borda de baixo da caixa é a borda por onde ele
espia, como sempre.

## Entrar e sair de cena

`visible` é controlado por quem usa. `true` sobe com a mesma entrada da
montagem; `false` desce para trás da borda em 0,3 s, as mãos soltam por último,
e ele some do leitor de tela. Sem a prop ele fica em cena. Quando houver mais de
um lugar onde ele pode espiar, quem decide qual aparece é o app: um mascote só
na tela.

```tsx
const [onStage, setOnStage] = useState(false)

<BacalhauPeek visible={onStage} followPointer shy>
  <Card>...</Card>
</BacalhauPeek>
```

`followPointer` faz as pupilas seguirem o ponteiro na janela, cada olho no seu
passo, com alcance curto: não passam da borda do olho. `shy` o deixa tímido:
quando o ponteiro chega a menos de 90 px dos olhos ele desce, e volta 1,6 s
depois com a entrada cautelosa, no máximo uma fuga a cada 2,6 s. As duas são do
ponteiro de mesa e ficam paradas com "reduzir movimento" ou com
`animated={false}`, que também faz `visible` trocar sem animar.

## Quando não usar

Para o mascote inteiro, numa tela de vazio, de erro ou de sucesso, é o
`Bacalhau`. O `BacalhauPeek` é só o espiar por cima de uma borda.

## Acessibilidade

É decorativo e sai com `aria-hidden`; com `label`, a cabeça vira a imagem com
esse nome, e as mãos continuam escondidas. Quando ele é o botão que abre a
conversa, o nome vai no botão em volta, e não no desenho. Fora de cena ele some
do leitor de tela junto com a tela.

| Prop | Tipo | Obrigatória | Padrão | Desde | O que faz |
| --- | --- | --- | --- | --- | --- |
| `align` | `"center" \| "end" \| "start"` |  | `"end"` | - | Onde ele espia, ao longo da borda de cima de `children`: `start` e `end` a 12% da ponta, `center` no meio. |
| `animated` | `boolean` |  | `true` | - | Ao montar ele sobe de tras da borda com cautela, olha para um lado e para o outro, e agarra a borda; depois flutua e pisca. |
| `classNames` | `Partial<Record<"edge" \| "hands" \| "head", string>>` |  |  | - | Classe por parte: `head` e a camada da cabeca, que corta na borda de baixo com `overflow-hidden`; `hands` a das maos, que passa um pouco da borda para a ponta cair por cima dela; `edge` a caixa em volta de `children`. |
| `followPointer` | `boolean` |  | `false` | - | As pupilas seguem o ponteiro na janela, cada olho no seu passo, ate 5 e 6,5 unidades do desenho. |
| `happy` | `boolean` |  | `false` | - | Os olhos fecham em arco e ele sorri: para quando o ponteiro chega, ou quando a conversa que ele abre esta aberta. |
| `hat` | `"newyear" \| "party" \| "santa" \| "season" \| "straw"` |  |  | - | O chapeu de festa, com os mesmos valores do `Bacalhau`, `season` incluido. |
| `label` | `string` |  |  | - | O nome do desenho para o leitor de tela. |
| `loop` | `boolean` |  | `false` | - | O flutuar e o piscar continuam depois dos 5 s. |
| `overlap` | `boolean` |  | `false` | - | Com `children`, a peca reserva acima do painel a altura da cabeca no `size` escolhido (71, 114 e 156px, a altura da caixa do desenho), e ela nao cobre o que vem antes. |
| `shy` | `boolean` |  | `false` | - | Timido: quando o ponteiro chega a menos de 90px dos olhos ele desce, e volta 1,6 s depois com a entrada cautelosa. |
| `size` | `MascotPeekSize` |  | `"md"` | - | A largura: `sm` 90px, `md` 144px, o padrao, e `lg` 198px. |
| `visible` | `boolean` |  |  | - | Se ele esta em cena, controlado por quem usa: `true` sobe com a mesma entrada da montagem, `false` desce para tras da borda em 0,3 s e some do leitor de tela. |

## Ver também

- [Alert](/componentes/alert.md)
- [Badge](/componentes/badge.md)
- [Banner](/componentes/banner.md)
- [CookieConsent](/componentes/cookie-consent.md)
- [EmptyState](/componentes/empty-state.md)
- [Illustration](/componentes/illustration.md)
- [Convenções da biblioteca](/convencoes.md): Provider, tokens e as regras que valem para toda peça
- [Índice completo](/llms.txt)
