Aplicador de Sementes de Movimento

Quando Usar

Use esta habilidade quando precisar aplicar um movimento de StyleSeed nomeado a um componente — seja uma das 5 sementes de personalidade (Primavera/Seda/Snap/Flutuar/Pulso × entrada/saída/hover/pressionar/layout) ou um movimento de palavra-chave distintivo da biblioteca de movimento (toggle-flip, toggle-curtain, reveal-blur, pop-in, shimmer, …). Traduz a vibe...

Quando NÃO Usar

• Para documentação geral do framer-motion ou aprendizado → use o site do framer-motion
• Para movimento não-React (transições apenas com CSS, GSAP) — esta habilidade tem como alvo apenas motion.X JSX
• Para linhas do tempo completas vinculadas à rolagem ou parallax — fora do escopo, conforme a Regra 59 do DESIGN-LANGUAGE.md
• Para ajustar os wrappers existentes FadeIn/FadeUp/Stagger — edite engine/components/ui/motion.tsx diretamente

Mapeamento Vibe → Semente

Traduza o prompt do usuário para uma das cinco sementes antes de aplicar. Use esta tabela de consulta de engine/motion/index.ts:

Se o usuário disser apenas um nome de marca, use a semente padrão dessa marca de BRAND_DEFAULT_SEED. Se o usuário for explícito sobre um nome de semente (spring, silk, etc.), respeite-o literalmente.

Modo de Recomendação — caso de uso → movimento (quando o usuário descreve o momento, não a vibe)

Se o usuário descrever o que é a coisa ("um botão de curtir", "um modal", "o estado de carregamento", "itens em um feed") em vez de um sentimento, recomende a partir do mapa de casos de uso (MOTION_BY_USECASE em engine/motion/library.ts, exportado de @engine/motion):

Duas anti-regras substituem a tabela (declare-as se você se desviar):

1. Uma semente por produto. Se o projeto já usa uma semente, combine-a — não introduza uma segunda personalidade.
2. Nunca atrase o payload. Não anime um saldo, preço ou resultado de pesquisa para visualização; o movimento é para usabilidade, não para conteúdo.

Palavras-chave de movimento nomeadas (movimentos distintivos)

As sementes definem uma personalidade (como um fade/escala se sente). A biblioteca de movimento em engine/motion/library.ts adiciona movimentos distintivos — um flip, um wipe de cortina, um morph — cada um por trás de uma palavra-chave única. Prefira uma palavra-chave quando o usuário quiser um movimento específico e reconhecível em vez de uma sensação genérica.

engine/motion/library.ts (exportado como MOTION_LIBRARY / MOTION_BY_KEY de @engine/motion) é a única fonte de verdade — cada palavra-chave carrega seu próprio snippet executável. Puxe o snippet de lá; nunca escreva os parâmetros manualmente.

…