Verificador de intervalos SemVer para pacotes

Este verificador responde usando precedência SemVer determinística. Ele entende operadores de comparação, interseções separadas por espaços, intervalos com hífen, versões parciais e curingas, além de alternativas com barras duplas. Identificadores de pré-lançamento e metadados de compilação recebem o significado semântico correto, portanto o resultado serve para ferramentas de dependências, não apenas como aproximação numérica.

Informe uma versão e o intervalo que deseja testar

Forneça uma versão semântica completa, como <code>2.4.1</code>, e uma expressão de intervalo. Em um conjunto de comparadores separados por espaços, todos precisam ser atendidos; assim, <code>&gt;=2.0.0 &lt;3.0.0</code> aceita lançamentos estáveis da versão principal dois. Separe conjuntos com <code>||</code> quando qualquer ramo puder ser aceito. Uma versão exata também é um intervalo válido. O verificador retorna a versão normalizada, o intervalo sem espaços externos, um resultado booleano e a alternativa correspondente numerada a partir de um; zero indica que nenhuma correspondeu. Essa saída explícita facilita o uso em bloqueios de implantação, relatórios de dependências, editores de manifesto ou testes sem interpretar prosa. As entradas são strings porque transformar versões inteiras em números de ponto flutuante faria 1.10 parecer menor que 1.9 e descartaria pré-lançamentos. Uma letra <code>v</code> inicial em versão completa é aceita e removida na normalização; componentes malformados, alternativas vazias e identificadores inválidos geram erro de entrada tipado, em vez de um resultado falso pouco confiável.

Use comparadores, intervalos com hífen e curingas corretamente

Os comparadores disponíveis são <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code> e <code>=</code>. Vários comparadores em uma alternativa formam uma interseção. Um intervalo como <code>1.2.3 - 2.4.0</code> inclui os dois limites completos, enquanto um limite superior parcial se expande até o fim daquela família: <code>1.2 - 2.4</code> começa em 1.2.0 e termina antes de 2.5.0. Curingas podem ser escritos como <code>x</code>, <code>X</code> ou <code>*</code>. Portanto, <code>3.x</code> cobre lançamentos estáveis de 3.0.0 até antes de 4.0.0, e o intervalo parcial <code>3.2</code> equivale a <code>3.2.x</code>. Os curingas devem vir depois dos componentes conhecidos; <code>1.x.4</code> é rejeitado porque não descreve um intervalo coerente. Esta capacidade rejeita intencionalmente os atalhos de circunflexo e til. Expresse esses limites com comparadores explícitos para que a regra avaliada permaneça clara e inequívoca em logs, políticas geradas, verificações automatizadas e análises humanas.

Entenda precedência, pré-lançamentos e metadados

Versões semânticas são comparadas componente por componente, não alfabeticamente. Primeiro decidem os números principal, secundário e de correção. Um pré-lançamento tem precedência menor que o lançamento estável correspondente, e seus identificadores separados por pontos são comparados da esquerda para a direita: identificadores numéricos são comparados numericamente, vêm antes dos não numéricos e um prefixo igual mais curto vem primeiro. Metadados após <code>+</code> são preservados na saída normalizada, mas nunca alteram a precedência, conforme exige o SemVer. Gerenciadores de dependências também evitam selecionar pré-lançamentos por acidente. Este verificador segue esse comportamento: um pré-lançamento só atende a um conjunto se o próprio conjunto contiver um comparador de pré-lançamento com os mesmos números principal, secundário e de correção. Por exemplo, <code>2.0.0-beta.2</code> pode atender a <code>&gt;=2.0.0-beta.1 &lt;2.0.0</code>, mas não entra em um curinga amplo apenas porque seu núcleo numérico se encaixa. Toda avaliação é local e determinística. Nenhum registro é consultado, nenhum pacote é baixado e nenhum lançamento atual é presumido; as mesmas strings sempre retornam a mesma decisão.