React Component Engineering

Foque em APIs de componentes claras e estáveis. Para arquitetura de SPA completa, use a skill reactjs-application-development.

Princípios

• Composição > configuração excessiva.
• Um componente, um trabalho. Extraia variantes via composição ou slots.
• Props tipadas e previsíveis; evite props booleanas explosivas.
• Estado local o mais perto possível do uso; eleve só quando compartilhado.
• Acessibilidade não é opcional.

API de props

• Prefira children / slots a render-prop labirínticas, salvo quando necessário.
• Use discriminated unions para variantes mutuamente exclusivas.
• Forward refs quando o consumidor precisar do DOM.
• Exponha className / style de forma controlada, alinhada ao sistema do projeto.
• Documente comportamento de estados: loading, empty, error, disabled.