
Não crie componente reutilizável cedo demais, diz análise da Stack Overflow
A tese: não generalizar cedo demais
O texto parte de um conselho comum no frontend: transformar telas parecidas em um componente abstrato e reutilizável. A autora defende que, em certos casos, a recomendação deve ser o oposto, pelo menos por um período. Criar uma abstração eleva o custo de codificação e, principalmente, o custo de coordenação. Como resume a frase central, duplicar código é fácil de remover, mas uma abstração errada pode ser cara de desfazer.
O caso: um componente para três fluxos
A autora trabalhou com três fluxos que executavam uma "ação sobre item": aprovação ("Você realmente precisa deste item?"), alteração de configurações e movimentação entre áreas gerenciadas. Visualmente, os três eram quase idênticos: lista de itens, seleção, confirmação e exibição de resultado, com as mesmas tabelas, diálogos e notificações. Por isso, ela decidiu criar um único componente.
A semelhança, porém, era superficial. Cada processo lida de forma diferente com falhas parciais, tem requisitos próprios e exige informações distintas para auditoria. Aprovar é uma afirmação sobre o futuro; a alteração ocorre imediatamente; a movimentação depende de outro sistema aceitar o pedido, e esse sistema pode recusá-lo.
Como o problema surgiu
O componente começou com um único objeto relevante e, em algumas semanas, passou a acumular modos (approve, change, move), variantes, flags booleanas e um gancho para casos especiais. Segundo a autora, cada adição tinha justificativa isolada, mas a soma tornou o componente difícil de alterar. Qualquer mudança no procedimento de confirmação passou a exigir acordo entre os três responsáveis, um revisor que conhecesse todos os modos e testes para todas as combinações de modo e variante. Uma mudança em uma área gerava discussão sobre todas as outras.
Por que a abstração parece boa
A autora reconhece as vantagens: código mais limpo, a satisfação de apagar duzentas linhas e a consistência visual. O problema é que a abstração se baseia apenas no estado atual. As diferenças entre casos de uso costumam aparecer depois, com nova política, nova observação de auditoria ou nova integração que se comporta de outra forma. Quando isso acontece, as diferenças só podem ser tratadas como flags.
A regra: esperar três ocorrências e checar o motivo
A recomendação é esperar que o padrão se repita três vezes, sempre pelo mesmo motivo de mudança, antes de abstrair. Até lá, o código pode ser copiado e cada tela pode evoluir por conta própria. Segundo o texto, duas partes de código compartilham o motivo de mudança quando uma única decisão de uma única pessoa as altera ao mesmo tempo.
O teste proposto é perguntar: se este requisito mudar, quem seria consultado, e todas as cópias mudariam simultaneamente? Se as respostas variam conforme a cópia, trata-se de coincidência, não de duplicação. Um formatador de datas pode ser extraído, porque a decisão sobre formato afeta todas as telas. Botões de envio parecidos, mas ligados a regras de aprovação ou validação diferentes, não devem ser unificados.
A autora associa essa ideia à "regra de três", atribuída a Don Roberts no livro Refactoring, de Martin Fowler, e cita também Sandi Metz (The Wrong Abstraction), para quem duplicação custa menos que a abstração errada, e Kent C. Dodds, que defende evitar abstrações apressadas.
Onde o reuso compensa
O texto não defende nunca abstrair. Alguns elementos valem a partilha desde o início: primitivos estáveis (botões, campos de texto, contêineres de layout), tokens de design (cores, espaçamento, escala tipográfica), comportamentos de acessibilidade (foco em diálogos, navegação por teclado, rotulagem) e itens definidos por padrão externo (datas, moedas, clientes de protocolo). A autora usa três critérios: a forma é definida fora das suposições sobre o futuro? Há um único motivo para mudar? É um componente ou um fluxo? Como teste prático, ela sugere ler a lista de props: se descrevem o que deve ser renderizado, a abstração provavelmente é adequada; se descrevem em que situação o componente está (mode, variant, isSpecial), provavelmente há várias coisas diferentes combinadas.
Como desfazer uma abstração prematura
O caminho sugerido é reverter a abstração: copiar o código de volta para cada chamada, removendo os ramos que cada fluxo nunca usa. Embora pareça um retrocesso, o resultado são cópias curtas e fáceis de entender, e cada fluxo pode mudar sem pedir permissão a outros. Depois, o código deve ser separado por fluxo, não por layout. Quando os três estiverem estáveis, extraem-se apenas os pequenos trechos que são comuns pelo mesmo motivo, como formatadores de data ou tabelas.
Em síntese, a regra é copiar até que o padrão apareça três vezes pelo mesmo motivo, exceto para primitivos, tokens, acessibilidade e padrões, que podem ser compartilhados desde o início. A autora encerra perguntando quais trechos de código as pessoas evitam mexer e quais flags usam para casos específicos.