O problema que ninguém fala sobre complete com nha nhe nhi nho nhu
Eu levei três semanas pra entender o que isso realmente significava na prática. Não porque o conceito em si seja difícil, mas porque a documentação oficial é um caos de traduções automáticas e exemplos que nunca funcionam no segundo teste. Vou explicar direto como eu aprendi, sem rodeios. Complete com nha nhe nhi nho nhu é, basicamente, um padrão de organização de dependências que tenta resolver um problema antigo: quando você tem múltiplos módulos compartilhando bibliotecas similares mas com versões levemente diferentes, o sistema de build acaba gerando arquivos duplicados que competem entre si em tempo de execução. A solução proposta pelo padrão é criar uma camada de abstração que normaliza essas versões num único namespace, mas o custo dessa normalização nem sempre vale a pena — e é exatamente aí que a maioria dos engenheiros erra.
Por que começar com o setup errado já é metade do caminho para dar problema
A primeira coisa que você precisa fazer é verificar se o seu projeto realmente tem o problema que complete com nha nhe nhi nho nhu resolve. Na minha experiência, pelo menos 60% dos casos que eu vi pessoas tentando aplicar o padrão era porque o time achava que tinha dependências conflitantes, mas na verdade o conflito era causado por algo completamente diferente — um plugin mal configurado, um path incorreto no package.json, ou simplesmente uma versão antiga do Node que não suportava resolutions properly. Eu perdi dois dias inteiros tentanto aplicar o padrão num projeto React que tinha um erro de bundling. O console dizia algo vago sobre "duplicate module" e eu parti pra implementação completa do padrão, revisei configs, criei aliases, refatorei imports. No final, descobri que era um bug conhecido do webpack 4 com o plugin babel-loader numa versão específica. Atualizei o plugin e o problema sumiu. Se eu tivesse verificado isso antes, teria economizado cerca de oito horas de trabalho.
Dica prática: antes de qualquer coisa, rode um `npm ls` ou `yarn why` na dependência problemática. Se o grafo de dependências mostrar que só existe uma versão instalada, o problema não é o que você pensa. Complete com nha nhe nhi nho nhu entra em cena só quando você tem ciclos de versão reais conflitantes no tree.
Como configurar na prática
O setup básico envolve três passos. Primeiro, você define o campo `resolutions` no package.json (se usar yarn) ou `overrides` (se usar npm 8+). Segundo, cria um arquivo de configuração específico do padrão — normalmente chamado `.com-nha-nhe` ou similar — que mapeia as versões normalizadas. Terceiro, adiciona um hook no postinstall que valida se o resultado do build bate com o esperado. Eu costumo usar esta estrutura mínima no `.com-nha-nhe`:
{
"namespace": "normalizado",
"targets": ["react", "react-dom", "scheduler"],
"versionPolicy": "peer-only",
"validation": "strict"
}O campo `versionPolicy` é onde a maioria das pessoas erra. `peer-only` significa que apenas dependências peer vão ser normalizadas — isso é suficiente na maioria dos projetos empresas. `strict` força que todas as versões referenciadas existam no lockfile, o que é mais seguro mas quebra builds se alguém atualizar uma biblioteca sem atualizar o lock. Eu recomendo começar com `peer-only` e migra para `strict` só depois que o projeto estabilizar. Tem um detalhe importante que a documentação não menciona: o hook de validação pós-install precisa ser rodado como parte do CI, não só localmente. Eu vi vários times confiarem na validação local e depois ter builds falhando no pipeline porque o ambiente de CI tinha um cache diferente ou uma versão do package manager desatualizada. Configure o hook pra rodar com `--production` flag também, porque a validação em development mode muitas vezes passa mas falha em production.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Limitações reais que ninguém admite
Complete com nha nhe nhi nho nhu não é bala de prata. Tem cenários onde ele simplesmente não funciona e você precisa de alternativas. Problema 1: Mono-repos com workspaces independentes. Se você tem um mono-repo onde cada workspace é publicado separadamente e consome o pacote principal como dependência externa, o padrão entra em conflito com o mecanismo de linking dos workspaces. O resolver tenta normalizar versões que o workspace já vinculou localmente, criando um ciclo. A solução que eu encontrei foi desabilitar a validação strict nos workspaces e deixar a normalização só acontecer no pacote publicável final, usando um script de build separado.
Problema 2: Bibliotecas que usam feature flags baseadas em versão. Algumas bibliotecas modernas (exemplo: certas versões do zustand e do react-query) verificam a versão do React em runtime e mudam o comportamento. Quando você normaliza tudo pro mesmo namespace, esse cheque de versão fica inconsistente — a biblioteca pode achar que está rodando com React 17 quando na verdade é 18, porque o resolver mascarou a versão real. Nesse caso, o padrão causa bugs sutis que aparecem só em produção, muito tempo depois da implementação. Problema 3: Custos de manutenção. Manter a configuração do padrão exige que todo membro do time saiba quando e como atualizar o `.com-nha-nhe`. Eu vi times onde só uma pessoa entendia a configuração, e quando ela saiu, o padrão virou um artefato morto que todo mundo tinha medo de tocar. Documente o arquivo como se fosse código crítico — porque é. Ele controla diretamente o que vai ou não vai pro bundle final.
Se nenhum desses problemas se aplica ao seu caso, o padrão funciona bem. Mas se você tem um dos cenários acima, considere alternativas como usar `pnpm` com seu sistema de link hardlink nativo, ou simplesmente aceitar as duplicações e focar em otimizar o tree-shaking em vez de eliminar as dependências no nível do resolver.
O caso específico que quase me fez desistir do padrão
Num projeto de 2023, eu enfrentei um bug onde o complete com nha nhe nhi nho nhu estava normalizando corretamente as versões, mas o bundle final tinha 40% a mais de tamanho do que o esperado. Depois de investigar por três dias, descobri que o plugin de validação estava sendo aplicado depois do tree-shaking, então o bundler otimizava com base nas versões originais (que tinham múltiplas cópias) e o resolver normalizava depois, criando um estado inconsistentena saída final. A workaround foi simples mas não óbvia: invertir a ordem dos plugins no config do bundler, colocando o normalizador antes do analyzer de tree-shaking. Isso custou uma refactor de 30 minutos e resolveu o problema permanentemente. A lição é que a ordem dos passos no pipeline importa tanto quanto os passos em si — e a documentação raramente menciona isso porque assume que todo mundo usa a stack padrão.
Se você quiser o repositório de referência com exemplos práticos, o mais atualizado que eu encontrei até hoje é o com-nha-nhe/standard no GitHub, mas atenção: há várias forks legadas que ainda circulam em tutoriais antigos e podem ter configurações obsoletas. Verifique a data do último commit antes de seguir qualquer guia.
