Soporte, versiones y navegadores
Qué navegadores y versiones se soportan, qué pasa cuando falta una función del navegador, cuánto dura el soporte de cada versión y cómo se evita que una actualización te rompa la aplicación.
#Navegadores
El mínimo sale de las funciones nativas que usa la librería. Cada función se prueba en Chromium, Firefox y WebKit (el motor de Safari) en cada cambio; no se prueban versiones viejas por separado: los mínimos vienen de la documentación de cada función, no de haberlas ejecutado.
| Función | Chrome / Edge | Firefox | Safari | Si falta |
|---|---|---|---|---|
<dialog> modal (showModal()) | 37 | 98 | 15.4 | Se muestra como <dialog open> sin capa superior ni fondo inerte |
color-mix() | 111 | 113 | 16.2 | Los colores derivados del acento no se calculan |
| Hojas de estilo construibles | 73 | 101 | 16.4 | Se usa un <style> de respaldo (con CSP estricta necesita configure({ nonce })) |
Consultas de contenedor (@container) | 105 | 110 | 16 | Las pestañas y la línea de tiempo no se adaptan al ancho de su contenedor |
100dvh | 108 | 101 | 15.4 | Sin esta unidad, un diálogo muy alto no se limita a la altura visible de la pantalla |
:has() | 105 | 121 | 15.4 | Solo cosmético: el calendario de rangos no resalta el intervalo y las etiquetas con avatar pierden un relleno |
Mínimos de la librería: Chrome y Edge 111, Firefox 113, Safari 16.4. En Firefox 113 a 120 todo funciona y solo se pierde el resaltado del rango en el calendario (:has()).
No hay soporte para Internet Explorer ni para versiones de Safari anteriores a la 16.4. Subir uno de estos mínimos cuenta como cambio que rompe y se avisa en el CHANGELOG.
#Frameworks y entornos
Qué se ejecuta en CI (matriz de compatibilidad). Las filas salen de compat/matriz.json: CI instala cada versión indicada y corre las pruebas de su envoltura, así que lo que dice «ejecuta» es lo que de verdad se ejecuta. npm run compat:check falla si esta tabla, package.json o el README no coinciden con ese archivo.
#Navegadores
| Navegador | Mínimo | Motor que CI ejecuta (e2e) |
|---|---|---|
| Chrome y Edge | 111 | Chromium |
| Firefox | 113 | Firefox |
| Safari | 16.4 | WebKit |
CI ejecuta las pruebas e2e con la versión de cada motor que trae Playwright; no se prueban versiones viejas por separado.
#Frameworks
| Framework | Mínimo declarado | Versiones que CI ejecuta |
|---|---|---|
Vue (nexus-dialogs/vue) | 3.3 o más | 3.3 (mínimo), última |
React (nexus-dialogs/react) | 18 o más | 18.0 (mínimo), 18 (última), última |
Angular (nexus-dialogs/angular) | 16 o más. Solo ESM. | 16.0 (mínimo), 19, última |
#Node
| Mínimo | Versiones que CI ejecuta | Qué se comprueba |
|---|---|---|
| 18 | 18, 20, 22, 24 | Importar (ESM y CJS) y fallar con un error claro sin DOM. La librería se compila con Node 22. |
Los tipos se incluyen y se revisan con @arethetypeswrong en cada cambio. Importar la librería no toca el DOM y abrir un diálogo en el servidor falla con un error explícito.
#Versiones
- Desde la 1.0 (hoy). Solo una versión mayor rompe. Lo que se vaya a quitar se marca como obsoleto una versión menor antes. Puedes usar
^1.0.0. - Antes (0.x). Una versión menor podía traer cambios que rompen; aparecen en el CHANGELOG bajo «Cambios que rompen».
- Qué cuenta como romper: quitar o renombrar una exportación pública, cambiar lo que devuelve una función (contratos), cambiar un valor por omisión que altera el resultado y subir el mínimo de un navegador o de un framework.
- Qué no cuenta: el aspecto exacto dentro de lo que pide el estándar de botones y la accesibilidad, correcciones de errores y de seguridad, y lo que no está en la API pública.
- Cómo se vigila:
npm run api:checkfalla si la API pública cambia sin actualizar su reporte, ytest/tipos/contratos.tsfija lo que devuelve cada función.
#Soporte
Una sola persona mantiene la librería, así que esto es de buena fe, no un contrato.
| Qué esperar | |
|---|---|
| Vulnerabilidades | Acuse en 7 días y primera valoración en 14 (SECURITY.md). Se corrige la última 1.x; las 0.x ya no reciben correcciones |
| Errores | Se atienden en la última versión. Con un caso mínimo que lo reproduzca, la corrección es mucho más rápida |
| Accesibilidad | Tiene prioridad sobre las funciones nuevas |
| Versiones anteriores | No reciben correcciones; la actualización de una menor a la siguiente se acompaña con la guía de migración del CHANGELOG |
| Publicación | Cada versión se sube a npm en espera y no es pública hasta que su responsable la aprueba con 2FA |
Lo que no se promete: un calendario fijo de versiones, soporte para navegadores fuera de la tabla ni compatibilidad con parches de terceros sobre la librería.
#Uso en producción
Esta librería nació para sistemas internos de empresa y se ha probado en uso real: su adaptador de SweetAlert2 corre en una aplicación web de producción de seguimiento de reclutadores, donde sustituyó a SweetAlert2 sin cambiar el código de las pantallas. Es un caso interno y sin nombre: todavía no hay un caso externo público que lo respalde, y por eso las limitaciones lo dicen así.
Si la usas en un proyecto, aunque todo haya salido bien, cuéntalo con «Lo probé en mi proyecto»: qué diálogos usas, en qué tipo de aplicación (sin datos sensibles) y cómo te fue. Cada caso real se suma aquí, con tu permiso.
Mientras tanto, lo que respalda la estabilidad se puede comprobar: pruebas unitarias con umbrales de cobertura, pruebas en tres navegadores, axe en cada tema, fugas de memoria, CSP y Trusted Types, y los ejemplos completos ejecutándose en cada cambio. Los números de tamaño y rendimiento se repiten con npm run bench (Rendimiento).