# Tarefa: subir o personagem cartoon (corpo e MÃOS) ao nível de uma ilustração de referência Você vai trabalhar num **workspace isolado** (pasta `workspace/` deste pacote), sem acesso ao projeto original. Responda e comente em **português do Brasil**; nomes de código (variáveis, funções, tipos, arquivos) em **inglês**. ## Contexto Temos um gerador de vídeos curtos verticais (9:16) em estilo "cartoon explicativo". Cada personagem é um **componente React que desenha SVG puro** (`workspace/src/CharacterFigure.tsx`). Ele não é uma imagem pronta: é montado por peças a partir de uma ficha de aparência (`CharacterLook`, em `src/character.ts`) e animado por um **rig** de parâmetros contínuos (`src/rig.ts`: rosto `FaceParams` e corpo `BodyParams`, braços e pernas em dois segmentos). As poses e ações (`src/motion.ts`) mexem nesses parâmetros quadro a quadro, e a boca segue a fala (`src/lipsync.ts`). O vídeo final é renderizado quadro a quadro pela Remotion (Chrome headless), então **tudo precisa ser função pura dos parâmetros** (nada de aleatório sem semente, nada de relógio). O mesmo personagem aparece em close (só rosto e tronco), meio corpo e corpo inteiro, de frente para a câmera. ## Referência (o NÍVEL de acabamento que queremos) Pasta `referencia/`: quadros de um vídeo de outra série (1080×1920) e recortes ampliados em `referencia/recortes/` (mãos segurando, joinha, mão com prancheta, apontando, close de mãos, braços cruzados, rosto). `00-video-inteiro-…png` mostra o vídeo todo. **Copie a qualidade, não o conteúdo.** Não reproduza aqueles personagens, nomes, roupas, logotipos ou cenas. O que importa nelas: - **Proporção:** cabeça grande (≈ 1/3 da altura no corpo inteiro), pescoço visível e proporcional, ombros largos e arredondados, tronco em "pera". - **Sombreado cel em 2 tons**, luz de um lado só, sombra levemente fria, **sem contorno preto** (a borda é o tom mais escuro da própria cor). - **Rosto:** orelha com dobra interna; nariz como curva simples; rugas da testa como arcos suaves no tom da pele; sobrancelha como forma cheia; pálpebra pesada; olhos com esclera branca; óculos de aro grosso com reflexo. - **Roupa com construção:** gola, zíper ou botões, costuras, 2–3 dobras (manga, cotovelo, barriga), barra; pano pendurado (toalha) com dobras e sombra própria. - **MÃOS (o problema principal):** formas macias e orgânicas, dedos de comprimentos diferentes que afinam na ponta, nós em arco, polegar nascendo da base da palma, unhas visíveis quando a vista mostra, mão grande (≈ do nariz ao queixo). Segurando objeto: o polegar por cima e os dedos por trás (objeto entre as camadas da mão). Objeto largo (livro, camisa dobrada) com as duas mãos pelas bordas. Joinha com o punho de lado e os dedos dobrados em fileira. A **mão sai de dentro da manga**: a manga termina numa borda com espessura e abertura escura, o pulso afina e entra nela, e a manga faz sombra no pulso. ## Onde estamos (pasta `nosso/`) - `01-folha-antes.png` → `02-folha-atual.png`: em cima a referência, embaixo o nosso, nos mesmos 6 enquadramentos. Melhoramos muito, mas um olhar rápido ainda separa os dois. - `03-maos-ref-antes-depois.png`, `04-formas-de-mao-3-rotacoes.png`: estado atual das mãos (biblioteca `src/hands.tsx` com formas `relaxed`, `open`, `point`, `thumbs_up`, `grip`, `pinch_edge`, `pinch_low`, `fist`, `on_face`, giradas pelo pulso). - `05-poses-camadas.png`: a ordem das camadas do braço (`src/limbs.ts`, `armLayer`) para a mão nunca sumir atrás do corpo. - `08-folha-de-poses-do-workspace.png`: saída do script deste workspace (12 poses). O que o dono do projeto ainda reprova: 1. **Mãos** ainda parecem recortadas/coladas: formas duras, sombra em cunha, dedos "salsicha". Exemplos na folha 08: - braços cruzados viram um losango de dedos; - no apontar, a mão some; - o martelo e o ramo atravessam a túnica, e o cabo não fica claramente dentro do punho; - no pensar e no tapar a boca, a mão parece um bloco. 2. A **emenda pulso → manga** às vezes mostra corte ou degrau quando o braço gira. 3. O **corpo inteiro** ainda parece "boneco de recorte" perto da referência: - pouco volume na roupa; - pernas e braços muito retos; - sapato simples; - sobrancelhas claras viram mancha (veja o idoso de barba branca). 4. Falta **textura de ilustração**: a referência tem degradê suave dentro das áreas e um leve granulado. A sombra cel deve continuar, mas com transição menos "vetor de ícone". ## O que fazer 1. Estude a referência (abra as imagens) e liste, por item acima, o que muda no desenho. 2. Reescreva o que precisar em `src/CharacterFigure.tsx`, `src/hands.tsx` e `src/limbs.ts` (e, se necessário, presets de pose em `src/rig.ts`) para chegar ao nível da referência. Pode criar arquivos novos em `src/`. 3. Use `npx tsx render-sheet.tsx` (corpo inteiro) e `npx tsx render-sheet.tsx close` (close) para gerar `out/sheet-*.svg`/`.png` e **olhe as imagens a cada rodada**. Acrescente poses ao `CELLS` do script se precisar (ex.: apontar para o outro lado, acenar com a outra mão, mãos na cintura, segurando celular). 4. Pare quando, lado a lado com os recortes da referência, a mão e o corpo não se separarem pela qualidade do desenho. ### Regras que NÃO podem quebrar (o projeto real depende delas) - **Mesma interface pública:** - `CharacterFigure({ look, expression?, pose?, item?, t?, state?, shadeSide?, gesture? })`; - viewBox `0 0 200 440` com os pés em (100, 440); - `HandsInsert({ look, item?, t?, shadeSide? })` desenha o close de mãos num viewBox 1080×1080. - **Tipos e campos:** `CharacterLook`, `FaceParams`, `BodyParams` e os nomes de poses e expressões continuam existindo. Campo novo só **opcional**, porque personagens já salvos precisam continuar abrindo. - **Rig:** o desenho continua dirigido pelo rig. Expressões, poses, fala (boca) e movimento (andar, acenar, martelar, pular, sentar) precisam funcionar; a sombra acompanha a cabeça virando (`headTurn`) e as dobras acompanham o braço. - **Sem dependências novas no desenho:** só React e SVG, sem imagens rasterizadas e sem bibliotecas novas. - **Sem custo alto de render:** nada de `feGaussianBlur` ou filtros SVG pesados repetidos por quadro (o vídeo renderiza 30 quadros por segundo; hoje um trecho de 4 s leva ~4 s). Degradê linear ou radial e textura barata são aceitos. - **Função pura e camadas:** - nada de `Math.random()` nem relógio; mesmos parâmetros = mesmo desenho; - braço, mão e objeto na mão nunca somem atrás do tronco, da barba ou de acessório quando o personagem está de frente; mantenha a lógica de `armLayer` (ou melhore-a). ## Entrega - A pasta `workspace/src/` com os arquivos alterados ou novos (vou copiá-los de volta para o projeto). - `out/sheet-full.png` e `out/sheet-close.png` finais, e uma folha **referência × seu resultado** (os recortes da referência ao lado das mesmas situações no seu desenho). - Um resumo curto: o que mudou em cada arquivo, campos novos (se houver) e o que ainda não ficou igual.