Comprobar rangos SemVer y versiones de paquetes

Este comprobador responde con la precedencia determinista de SemVer. Entiende comparadores, intersecciones separadas por espacios, rangos con guion, versiones parciales y comodines, además de alternativas con doble barra vertical. Los identificadores de prepublicación y compilación reciben su significado semántico correcto, por lo que el resultado sirve para herramientas de dependencias y no como aproximación numérica.

Escriba una versión y el rango que desea comprobar

Indique una versión semántica completa, como <code>2.4.1</code>, y una expresión de rango. En un conjunto de comparadores separados por espacios deben cumplirse todos: <code>&gt;=2.0.0 &lt;3.0.0</code> acepta las publicaciones estables de la versión mayor dos. Separe conjuntos con <code>||</code> si basta con que se cumpla una rama. Una versión exacta también constituye un rango válido. El comprobador devuelve la versión normalizada, el rango sin espacios exteriores, un resultado booleano y la alternativa coincidente numerada desde uno; cero significa que ninguna coincidió. Esta salida explícita permite integrarlo en controles de despliegue, informes de dependencias, editores de manifiestos o pruebas sin interpretar texto. Las entradas son cadenas porque convertir versiones completas a números de coma flotante haría que 1.10 pareciera menor que 1.9 y eliminaría las prepublicaciones. Se admite una <code>v</code> inicial en versiones completas y se elimina al normalizar; los componentes incorrectos, las alternativas vacías y los identificadores inválidos producen un error de entrada tipado en lugar de un falso poco fiable.

Use comparadores, rangos con guion y comodines con precisión

Los comparadores disponibles son <code>&gt;</code>, <code>&gt;=</code>, <code>&lt;</code>, <code>&lt;=</code> y <code>=</code>. Varios comparadores dentro de una alternativa forman una intersección. Un rango como <code>1.2.3 - 2.4.0</code> incluye ambos extremos completos, mientras que un extremo superior parcial se amplía hasta el final de su familia: <code>1.2 - 2.4</code> empieza en 1.2.0 y termina antes de 2.5.0. Los comodines pueden escribirse como <code>x</code>, <code>X</code> o <code>*</code>. Por tanto, <code>3.x</code> abarca publicaciones estables desde 3.0.0 hasta antes de 4.0.0, y el rango parcial <code>3.2</code> equivale a <code>3.2.x</code>. Los comodines deben aparecer después de los componentes conocidos; <code>1.x.4</code> se rechaza porque no describe un intervalo coherente. Esta capacidad rechaza deliberadamente las abreviaturas con circunflejo y virgulilla. Exprese esos límites mediante comparadores explícitos para que la regla evaluada sea visible e inequívoca en registros, políticas generadas, comprobaciones automatizadas y revisiones humanas.

Comprenda la precedencia, las prepublicaciones y los metadatos

Las versiones semánticas se comparan componente por componente, no alfabéticamente. Primero deciden los números mayor, menor y de parche. Una prepublicación precede a la publicación estable correspondiente, y sus identificadores separados por puntos se comparan de izquierda a derecha: los numéricos se comparan como números, se ordenan antes que los no numéricos y un prefijo igual más corto aparece primero. Los metadatos situados tras <code>+</code> se conservan en la salida normalizada, pero nunca cambian la precedencia, tal como exige SemVer. Los gestores de dependencias también evitan seleccionar prepublicaciones accidentalmente. Este comprobador sigue ese criterio: una prepublicación solo puede satisfacer un conjunto si este incluye un comparador de prepublicación con idénticos valores mayor, menor y de parche. Por ejemplo, <code>2.0.0-beta.2</code> puede satisfacer <code>&gt;=2.0.0-beta.1 &lt;2.0.0</code>, pero no entra en un comodín amplio solo porque encaje su núcleo numérico. Cada evaluación es local y determinista. No se consulta ningún registro, no se descarga ningún paquete ni se adivina la publicación actual; las mismas cadenas siempre producen la misma decisión.