Parser de Especificador NPM

O que se escreve depois do nome do pacote não é só número de versão. O npm aceita faixa, dist-tag, repositório git, URL de tarball, caminho local, atalho de GitHub e alias — e cada forma resolve de maneira diferente na instalação. A página identifica qual delas você tem em mãos e explica o que ela implica.

A distinção mais útil é entre versão exata, faixa e dist-tag. Versão exata trava; faixa deixa o npm escolher no momento da instalação; dist-tag é um nome publicado que aponta para uma versão e pode mudar sem aviso. Há ainda uma ambiguidade real: o npm tenta interpretar o texto como faixa e, se não for faixa válida, tenta como dist-tag — então um erro de digitação em faixa pode virar busca por tag inexistente.

As formas que não passam pelo registro merecem atenção. Repositório git sem ref depois da cerquilha instala o branch padrão, o que significa que a mesma instalação em dois momentos pode trazer código diferente. Caminho com file: cria link simbólico em vez de copiar, então mudança na pasta de origem aparece na hora — ótimo em desenvolvimento, ruim em imagem de contêiner.