Versionado y estabilidad
1.0.0 : la API pública queda fijada y a partir de aquí sigue el versionado semántico de siempre.
La promesa de semver
Mayor — 2.0.0
2.0.0El único sitio donde ocurren cambios que rompen: entradas, salidas o selectores renombrados o eliminados, comportamiento por defecto distinto, soporte de una versión mayor de Angular retirado.
Menor — 1.1.0
1.1.0Componentes nuevos, entradas y salidas opcionales nuevas, variantes de CVA nuevas. Siempre compatible hacia atrás con la versión menor anterior.
Parche — 1.0.1
1.0.1Corrección de fallos, correcciones de accesibilidad, refactorizaciones internas. Nunca cambia el contrato público.
La superficie congelada está inventariada en [specs/api-freeze-0.9.md](https://github.com/Andersseen/volt-ui/blob/main/specs/api-freeze-0.9.md): cada entrada, salida y selector presente en el congelado de 1.0.0. ¿Actualizas desde una versión 0.x? Mira las [notas de migración de 0.x](/docs/migration-notes).
Qué significan ahora las etiquetas de estado
stable ; consulta el catálogo de componentes para la etiqueta de cada uno. beta y experimental siguen definidas más abajo porque los componentes añadidos después de 1.0 pueden empezar ahí; hoy no las lleva ninguno. La etiqueta es una señal de confianza, no una barrera de disponibilidad: todos los componentes se publican por el paquete de npm y por la CLI, lleven la etiqueta que lleven.
Estable
Recomendado para producción. API documentada, tests con sentido y salvedades de accesibilidad conocidas (si las hay) puestas por escrito.
Beta
Utilizable hoy, pero todavía puede recibir refuerzos de formularios, teclado o accesibilidad en una versión menor o de parche; ese refuerzo nunca rompe la API pública existente, así que pasar de beta a estable es un cambio de documentación, no un salto de versión por sí mismo. Sin usar en 1.0.
Experimental
Reservado para futuras vistas previas cuya API todavía puede cambiar. Hoy sin uso: ningún componente publicado lleva esta etiqueta a fecha de 1.0.0.
Versiones de Angular admitidas
1.x apunta a Angular ^21.2 y Node 20 o posterior. Volt UI solo admite la última versión mayor de Angular declarada; ampliar ese rango exige verificación con proyectos de prueba reales, no solo que la compilación funcione, así que nunca se da por hecho.
Cuando sale una nueva versión mayor de Angular, mover a ella el soporte de Volt UI es una versión menor con notas de migración o de publicación que documentan lo que haya cambiado. Una versión mayor admitida nunca se retira en silencio.