Documentar convenções e payload de eventos de colisão

[ramonmello]

Problema
Não há documentação oficial descrevendo todos os eventos de colisão, formato de payload e exemplos de uso.

Impactos

• Desenvolvedores consomem eventos sem saber quais campos estão disponíveis.
• Riscos de uso incorreto e de handlers quebrando diante de payloads inesperados.

Possíveis soluções

• Criar docs/collision-events.md ou seção no README detalhando:
  • Lista de eventos (detect, normal.enter/exit, trigger.enter/stay/exit).
  • Formato e tipos de cada campo do payload.
  • Exemplos de código de escuta e boas práticas (registro, limpeza de listeners).