Saltar al contenido principal

Compatibilidad

Qué navegadores, qué versiones de Node, de React y de TypeScript, y qué bundlers admite la suite.

NavegadorVersión mínima
Chrome y Edge116
Firefox125
Safari (macOS)17
Safari (iOS)18.3

El mínimo lo marca la Popover API: todas las capas flotantes de la suite son elementos popover. Esas son las versiones desde las que la plataforma la da por disponible en todos los motores, según los datos de Baseline (desde enero de 2025). El resto de lo que uso llegó antes: <dialog>, inert, :has(), color-mix(), consultas de contenedor y propiedades lógicas.

No hay polyfills ni una ruta alternativa para navegadores anteriores. En uno sin Popover API los menús, los selectores y los avisos no se abren.

Lo que pruebo en cada cambio es más estrecho que esa línea: el Chrome instalado en el sistema y los motores Firefox y WebKit que trae Playwright, siempre en su versión actual. No ejecuto las suites en las versiones mínimas.

Node​

UsoVersión
Mínimo de los paquetes publicados (engines)22.12
Desarrollo, integración continua y publicación26
Matriz de compatibilidad en CI22 y 24, además de 26

Los paquetes son código de navegador; Node importa para el render en servidor, para las herramientas y para quien los empaqueta. Subí el mínimo a 22.12 porque Node 20 terminó su soporte el 2026-04-30 (calendario de versiones de Node) y no quiero declarar compatible una versión que ya no recibe correcciones de seguridad ni puedo seguir probando.

Los paquetes solo publican ESM. require("@zuccadev-labs/zuix-zui") funciona en un Node que carga ESM con require, que es el caso desde 22.12.

React​

VersiónReact 19 y React DOM 19, como peers opcionales
React 18No se admite
Sin ReactTodo lo que no es el binding: contrato, zui/dom, zout/dom, <z-icon>

Probé React 18 y no funciona: inert no se aplica como atributo booleano, y los componentes reciben ref como prop, sin forwardRef, que es la forma de React 19. No voy a mantener dos caminos.

Con Server Components (Next.js App Router) funciona; los detalles están en Frameworks.

TypeScript​

Las declaraciones se emiten con TypeScript 7 y se comprueban en cada cambio con TypeScript 5.9, 6 y 7, con skipLibCheck: false y con moduleResolution Bundler y NodeNext. IconName es una unión de 346 literales: un nombre de icono que no existe no compila.

Bundlers y gestores de paquetes​

HerramientaEstado
Vite 8Probado en cada cambio, con los paquetes sueltos y con el paraguas
Next.js (última estable, App Router, Turbopack)Probado en cada cambio
RspackEs el que usa el sitio de documentación, contra el fuente del workspace
webpack, ParcelNo los he probado contra el paquete publicado
pnpm, npm, bunInstalan el peer zuix-zicon solos si falta
yarn 1No instala peers: hay que añadir @zuccadev-labs/zuix-zicon a mano

Sin bundler, cada paquete trae en dist/ un CSS y un módulo listos para enlazar (Frameworks).

Lo que no he comprobado​

  • Safari real, en macOS y en iOS. WebKit de Playwright en Linux comparte motor, no la integración con el sistema (foco de los botones al hacer clic, teclado en pantalla, VoiceOver).
  • Las versiones mínimas de cada navegador: la línea sale de los datos de compatibilidad, no de ejecutar las pruebas en Chrome 116 o Firefox 125.
  • Dispositivos táctiles reales.
  • WebGL con GPU física para el modo gl del Carousel: los tres motores lo prueban por software.
  • Yarn Berry (PnP).
  • Servir los archivos de dist/ desde un CDN público.