Hoja de ruta
Esta página declara un orden, no unas fechas. Nada de lo que hay aquí es un compromiso de entregar en un plazo, y los puntos se mueven cuando la evidencia lo pide. Lo que está marcado como hecho está hecho y se puede comprobar hoy; todo lo demás, no.
Qué trae la 1.0
| Área | Estado | Contenido |
|---|---|---|
| Componentes | hecho | 33 familias: 14 solo CSS y 19 con JavaScript opcional, cada una con sus estados, su comportamiento de teclado y una alternativa que funciona sin script |
| Tokens y temas | hecho | Tokens de diseño como contrato visual, temas claro, oscuro y del sistema, ámbitos anidados, derecha a izquierda, colores forzados, impresión y movimiento reducido |
| Distribución | hecho | CSS en capas y plano, una hoja por componente, módulos ES con exports reales, un IIFE con un solo global, tipos de TypeScript y los tokens en JSON |
| Documentación | hecho | Esta web en inglés y español, una referencia generada desde las fuentes, un playground y un constructor de temas |
| Ejemplos | hecho | Cuatro páginas completas y una plantilla de HTML plano, cada una descargable en zip |
| Verificación | hecho | Pruebas unitarias y de contrato, pruebas de navegador en Chromium, Firefox y WebKit, comprobaciones de accesibilidad con movimiento reducido y presupuestos de tamaño |
Qué es público, y cómo puede cambiar a partir de aquí, está escrito en estabilidad; qué cambió en cada versión está en cambios.
Fuera del alcance, a propósito
Se excluyen adrede, no por olvido. Cada uno es un dominio en sí mismo, y entregar la mitad de cualquiera de ellos costaría más que omitirlo:
- Una rejilla de datos virtualizada, un editor de texto enriquecido, arrastrar y soltar, gráficas.
- Un compilador de utilidades con valores arbitrarios, un escáner de clases o paso de purga, una CLI que genere plantillas, un editor visual.
- Envoltorios para React y Vue. El HTML plano ya funciona dentro de los tres.
- Un catálogo grande de plantillas. El alcance son cuatro páginas trabajadas; una galería, no.
El principio detrás de la lista: contar variantes no ensancha el alcance. Una familia solo cuenta como terminada cuando tiene estados, comportamiento de teclado, alternativa sin JavaScript, documentación y pruebas.
En consideración después de la 1.0
La prioridad habla del orden de trabajo, no de la importancia que tenga para ti. Nada de esta lista está prometido, y nada de aquí cambia un nombre público sin una versión mayor.
| Prioridad | Punto | Por qué está aquí |
|---|---|---|
| P1 | Una pasada con lector de pantalla (NVDA, VoiceOver) y las correcciones que salgan | Valida lo que las comprobaciones automáticas no pueden ver; qué está y qué no está verificado se lista en accesibilidad |
| P2 | Más páginas trabajadas y más fixtures de los patrones que la gente pide | Ahora mismo un patrón documentado vale más que otra familia |
| P2 | Componentes nuevos solo donde un patrón se repita en proyectos reales | La gramática se mantiene pequeña a propósito: cada añadido tiene que ganarse el nombre |
| P3 | Envoltorios de framework, compilador de utilidades, CLI de plantillas | Solo con demanda real: son comodidad, no capacidad |
Cómo cambia esta lista
Un punto sube cuando hay evidencia: un problema reproducible en un proyecto real, un contrato que resultó estar mal o un hallazgo de accesibilidad. Todo lo que altere una superficie pública — nombres de clase, tokens, opciones, eventos, orden de capas — se registra como decisión en el repositorio antes de entrar, para que el razonamiento sobreviva al cambio. Los informes de error y los casos de uso son la aportación más útil; mira contribuir.