Hoja de ruta
1.0.0 , y 1.0 es una línea de salida, no de meta. Esta es la dirección que sigue el proyecto y el orden en que llegará.
Cómo leer esta página
Nada de esto rompe tu código actual. La API pública de 1.0 está congelada y todo lo de abajo sigue el versionado semántico de siempre; mira [Versionado y estabilidad](/docs/versioning).
Documentación en más idiomas
Estado: Siguiente Se aplica a: DocumentaciónHoy la documentación está solo en inglés. El ucraniano (UA) y el español (ES) son lo siguiente, para que la librería sea accesible sin tener que leer inglés primero.
Se aplica a este sitio de documentación: guías, páginas de componentes y ejemplos. Los nombres de componentes, los selectores, las entradas y las salidas se quedan en inglés. Traducir una API rompería todos los componentes copiados y todos los ejemplos de código que hay en internet. El idioma es una preferencia del lector, no una compilación aparte: los mismos componentes y el mismo paquete están detrás de cada idioma.
Una capa headless propia — @volt-ui/core
Estado: Planificado Se aplica a: LibreríaSustituir la dependencia de ng-primitives por las primitivas headless propias de Volt UI, de modo que comportamiento y estilo sean dos capas de un mismo proyecto en vez de un proyecto encima del de otra persona.
Headless y estilado se publican por separado. ¿Solo quieres el comportamiento —gestión del foco, manejo del teclado, cableado ARIA— con tu propio marcado y CSS? Coge @volt-ui/core a secas. ¿Quieres el aspecto que tiene Volt UI hoy? Sigue usando los componentes estilados; están construidos sobre esa misma capa headless. Esto ocurre antes de que crezca el catálogo de componentes; el razonamiento está más abajo. El nombre @volt-ui/core ya está reservado exactamente para esto en la especificación del proyecto; no es una idea nueva, es la siguiente.
Dos distribuciones: con Tailwind y sin él
Estado: Planificado Se aplica a: LibreríaHoy Volt UI se estiliza con Tailwind CSS v4, lo que lo descarta para proyectos que no usan o no pueden usar Tailwind. Una distribución sin Tailwind elimina esa restricción.
La compilación con Tailwind sigue siendo la predeterminada y funciona exactamente igual que ahora. La compilación sin Tailwind publica los mismos componentes y los mismos tokens de diseño en CSS plano. Depende de que aterrice antes la capa headless: una vez separado el comportamiento del estilo, un segundo destino de estilo deja de ser un fork y pasa a ser una salida de compilación.
Más layouts construidos con componentes de Volt UI
Estado: En exploración Se aplica a: LibreríaMás allá de los layouts de barra lateral y navegación superior que ya existen: shells de aplicación más completos ensamblados con componentes que ya existen, para que una pantalla real sea un punto de partida y no un trabajo de montaje.
El punto menos crítico de esta página, y así lo decimos: es una comodidad, no una carencia. Compuesto con componentes de Volt UI ya publicados en vez de primitivas nuevas de un solo uso. Va el último a propósito: los layouts construidos antes del cambio a headless también habría que portarlos.
Por qué la capa headless va primero
Lo más tentador después de un 1.0 es añadir componentes. Deliberadamente, eso no es lo que viene ahora. Hoy cada componente de Volt UI delega su accesibilidad y su comportamiento de interacción en [ng-primitives](https://ng-primitives.dev), así que cada componente añadido antes de sustituir esa capa es un componente más que portar después. Hacer crecer el catálogo primero volvería la migración más grande, más lenta y más propensa a romper tu código cuando llegue.
Hacerlo en este orden significa que la migración ocurre una sola vez, sobre los componentes que existen hoy, y que el catálogo crece después sobre una base enteramente propia.
Lo que no va a cambiar
El modelo de copiar el código
Los componentes siguen siendo copiables a tu proyecto con la CLI. El código que copias es tuyo; nada de esta página cambia eso.
La API de 1.0
Los selectores, entradas y salidas congelados en 1.0 siguen funcionando. Un cambio que rompa exige una versión mayor y notas de migración.
Temas
Los 5 colores × 5 estilos y el sistema de tokens se quedan como están. Una compilación sin Tailwind añade una opción; no quita nada.