Saltar al contenido

Calculadora de versión semver

Calcula la próxima versión semántica automáticamente a partir de la versión actual y el tipo de incremento que elijas, siguiendo las reglas SemVer 2.0.0.

Entrada

Calculadora de versión semver

Pega una versión como 1.4.2 y elige un tipo de incremento —major, minor, patch, premajor o prerelease— y esta herramienta calcula la próxima versión semántica exacta, siguiendo las reglas de SemVer 2.0.0 para versiones previas y metadatos de compilación. Está diseñada para mantenedores que lanzan versiones, scripts de CI que necesitan la próxima etiqueta, y cualquiera que quiera verificar un incremento de versión antes de que llegue a package.json o a una etiqueta git.

Los incrementos premajor y prerelease utilizan la opción de identificador de versión preliminar —alpha, beta o rc— para iniciar o continuar un ciclo de prerelease, de modo que 2.0.0 se convierte en 2.0.0-beta.0, y un segundo incremento de prerelease en el mismo identificador lo mueve a beta.1. Añade metadatos de compilación como un hash de commit y se adjunta después de un signo más. Activa "Recomendar incremento desde lista de commits" y pon tu versión actual en la primera línea, seguida de un mensaje de Conventional Commits por línea: feat: recomienda un incremento minor, fix: o perf: recomienda un patch, y una "!" después del tipo, o un pie de página BREAKING CHANGE:, recomienda un incremento major. Introduce un rango caret (^1.2.0) o tilde (~1.2.0) para ver si la versión calculada sigue dentro de él.

La calculadora acepta una "v" inicial opcional (v1.4.2), lee correctamente los identificadores de prerelease y compilación existentes, y trata los saltos de línea de Windows y Unix de la misma manera. Una versión que no sea un SemVer válido, o un rango que no sea una expresión caret o tilde válida, se informa en lenguaje natural en lugar de como una respuesta silenciosamente incorrecta.

Todo se ejecuta en tu navegador. Ningún número de versión o mensaje de commit se sube nunca, así que es seguro usar con un proyecto sin publicar. Copia el resultado, descárgalo como archivo .txt, o devuélvelo a la entrada para encadenar otro incremento encima.

Preguntas frecuentes

¿Cómo decide el tipo de incremento la recomendación de lista de commits?
Lee cada línea después de la versión como un mensaje de Conventional Commits. Cualquier "!" después del tipo, o un pie de página BREAKING CHANGE:, recomienda un incremento major; de lo contrario, una línea feat: recomienda minor y una línea fix: o perf: recomienda patch. Sin commits reconocibles, recurre al tipo de incremento elegido manualmente.
¿Qué sucede con una prerelease existente cuando incremento major, minor o patch?
Incrementar un campo que ya está en su próximo valor en una prerelease (por ejemplo 2.0.0-rc.1 con un incremento major) simplemente elimina la prerelease en lugar de incrementar dos veces, coincidiendo con cómo herramientas como npm version lo manejan.
¿Qué significan las comprobaciones de rango caret y tilde?
Un rango caret como ^1.2.0 permite cualquier cambio que no toque el dígito más a la izquierda y diferente de cero; un rango tilde como ~1.2.0 permite solo cambios a nivel de patch. La herramienta informa si tu versión calculada cae dentro del rango que ingresaste.
¿Acepta versiones con una "v" inicial, como v1.4.2?
Sí. La "v" inicial se reconoce y se elimina antes del análisis, coincidiendo con los nombres de etiquetas git comunes, y no se lleva al resultado calculado.
¿Se carga mi número de versión o lista de commits en algún lugar?
No. El cálculo de bump se ejecuta completamente en tu navegador —nada de lo que pegues jamás sale de tu dispositivo.