Saltar al contenido

Compatibilidad

Qué necesita tu proyecto y qué navegadores soporta. La regla de fondo: TaishoDS apuesta a la plataforma web moderna, pero cada feature nueva tiene un fallback — nada se rompe si el navegador todavía no la trae.

Entorno del proyecto

Con el CDN del Core no hay requisitos: son dos <link> y un <script>, sin framework y sin bundler (ver Instalación). Si se instala @taishods/core para usar el CLI, hace falta Node 22.18 o más nuevo: el generador usa fs.globSync. Si algo no se ve o no anda, conviene revisar No se ve / no anda.

El plugin de Vite (taisho(), de @taishods/core/vite) asume un proyecto con Vite.


Frameworks

El Core es HTML, CSS y JavaScript, sin framework. Esta tabla dice dónde se probó con uno de por medio, con las versiones exactas; lo que no figura acá no se probó y no se afirma. Cada prueba instala el paquete real (npm pack del Core) en un proyecto nuevo, sigue los pasos de Instalación (taisho init, taisho generate, importar el CSS y el JS) y, en Chromium 156, Firefox 157 y WebKit 27.2 (Playwright 1.64.1), comprueba que la consola queda sin errores ni avisos, que el Modal abre y cierra (con el botón y con Escape), que el Select abre, elige una opción y refleja el valor, y que todo vuelve a funcionar al navegar a otra página y al volver. Los scripts de la prueba están en el repositorio del Core (smoke-astro.sh, smoke-next.sh y smoke-sveltekit.sh).

Framework Node Qué se probó
Astro 7.4.1224.12.0astro dev, astro build + astro preview (estático), CSS y JS generados por taisho generate, CSS y JS del paquete, el plugin taisho() y la navegación de cliente con <ClientRouter />
Astro 6.4.822.22.3Lo mismo que en Astro 7
Next 16.4.6 (App Router, React 19.3.1, Turbopack)22.22.3next dev, next build + next start (páginas estáticas), CSS de taisho generate en el layout de servidor, tres formas de cargar el JS desde componentes de cliente y navegación de cliente con <Link>
SvelteKit 3.2.0 (Svelte 5.57.3, Vite 8.3.8, adapter-node)22.22.3vite dev, vite build + vite preview (con renderizado en servidor), CSS y JS generados por taisho generate, CSS y JS del paquete, el plugin taisho() y la navegación de cliente entre páginas

Astro

Se instala el paquete y se corre npx taisho init y npx taisho generate. Astro empaqueta lo que se importa, así que el CSS y el JS de la carpeta taisho/ entran por import en el layout (la ruta relativa depende de dónde esté el archivo). El content que escribe init ya incluye los archivos .astro.

src/layouts/Base.astro
  • Generar antes de arrancar. La carpeta taisho/ tiene que existir antes de astro dev y de astro build: se corre taisho generate primero, o taisho watch en otra terminal durante el desarrollo. La alternativa que también se probó es el plugin de Vite en la config de Astro, que escribe la carpeta al arrancar el servidor y el build.
  • Navegación de cliente. Con <ClientRouter /> (transiciones de vista) no hace falta nada más: los componentes de la página nueva funcionan, también al volver atrás.
  • El JS desde el paquete. Importar @taishods/core/core en lugar del archivo generado también funciona (con ese camino, el CSS es el del paquete y no el de la marca).
  • Node. Astro 7 pide Node 22.23.4 o más nuevo, más que los 22.18 del Core.
  • Astro 6 en desarrollo. Con la caché de Vite vacía, la consola puede mostrar errores 504 «Outdated Optimize Dep», de la barra de desarrollo de Astro y de <ClientRouter />; se reproducen en un proyecto de Astro 6 sin el Core. La barra se apaga con devToolbar: { enabled: false } y, si el JS se importa del paquete, se evita el aviso declarándolo en vite.optimizeDeps.include.
astro.config.mjs

Next (App Router)

Los pasos iniciales son los mismos (init y generate; el content de init ya incluye .jsx y .tsx). El CSS se importa en el layout raíz, que es un componente de servidor. El JS toca document al cargarse, así que se carga desde un componente de cliente, dentro de un efecto, que corre sólo en el navegador y después de hidratar. El Core se inicializa solo y usa delegación de eventos.

app/layout.jsx
app/carga-taisho.jsx
  • Otras formas de cargar el JS. Funcionaron con la misma batería el import dinámico de @taishods/core/core en el efecto y el import estático del archivo generado en la cabecera de un componente de cliente: al prerenderizar en el servidor, el Core no falla al evaluarse.
  • Hidratación. No apareció ningún aviso de hidratación en la consola, con las tres formas, en desarrollo y en producción.
  • Navegación de cliente. Con <Link> de Next, el Core inicializa los componentes de la página nueva sin hacer nada más, también al volver atrás.
  • data-scroll-behavior en <html>. El reset del Core pone scroll-behavior: smooth en <html> y, en next dev, Next 16 avisa en la consola hasta que se agrega data-scroll-behavior="smooth" a esa etiqueta (como en el layout de arriba).
  • El marcado en JSX. Las clases van en className. commandfor se escribe en minúscula, porque React 19.3.1 no reconoce commandFor y avisa en la consola; closedby también va en minúscula. En el Select se usó defaultValue en el <select>.
  • Clases en JSX. taisho generate encuentra las clases escritas en className de los archivos .jsx: el CSS resultante trae las del Modal y las del Select. taisho check revisó los archivos del proyecto de prueba sin avisos.

SvelteKit

Los pasos iniciales son los mismos (init y generate; el content de init ya incluye .svelte). El CSS se importa en el layout raíz. El JS toca document al cargarse, así que se importa dentro de onMount, que corre sólo en el navegador. El Core se inicializa solo y usa delegación de eventos, de modo que sirve a las páginas a las que se navega después.

src/routes/+layout.svelte
  • Otras formas de cargar el JS. Funcionaron con la misma batería el import dinámico de @taishods/core/core (con el CSS del paquete) y el import estático del archivo generado en la cabecera del layout: al renderizar en el servidor, el Core no falla al evaluarse.
  • Marcado. El Modal y el Select se escribieron con {@html}, tal como los muestra la documentación de cada componente.
  • Configuración. SvelteKit 3 pide que la configuración vaya dentro del plugin (sveltekit({ adapter })) y ya no lee svelte.config.js.

Lo que no se probó

Estos casos no se probaron y no se afirma que funcionen:

  • Cualquier otro framework o meta-framework (Vue, Nuxt, Remix, React sin Next, Qwik, SolidStart…).
  • SvelteKit con un adaptador distinto de adapter-node, con páginas prerenderizadas o con versiones anteriores a la 3.
  • Astro con islas de React, Vue o Svelte (client:*), con renderizado en servidor o con un adaptador; sólo se probó la salida estática.
  • Next con el Pages Router, con webpack en lugar de Turbopack, con output: 'export', con renderizado dinámico en servidor o con next/script.
  • Marcado que el framework controle con su propio estado (por ejemplo, un hidden o un aria-expanded que el componente actualice): el Core escribe esos atributos en el DOM, y que no choquen con el framework no se probó. Sólo se probó con atributos fijos.
  • Los demás componentes: la prueba abre el Modal y el Select, nada más.
  • Safari real en iOS y los lectores de pantalla (ver Accesibilidad). El inicio rápido por CDN sí se prueba en WebKit con un iPhone emulado por Playwright, que no es un iPhone real.

Features de la plataforma web

TaishoDS usa APIs modernas de CSS y HTML donde aportan (menos JS, mejor accesibilidad), y cada una degrada con gracia. En un navegador evergreen actual todo corre por el camino nativo; en uno más viejo, por el fallback.

Plataforma web Dónde se usa Si el navegador no la tiene
CSS anchor positioningPosición de overlays (Popover, Menu, Tooltip, …)Fallback JS (floating.ts)
Popover APICapa superior de Popover / MenuDegradación a posicionamiento manual
<dialog>Modal, Drawer, AlertDialogNativo en todo navegador moderno
Invoker commandsAbrir/cerrar Modal y Drawer sin JSEl JS de comportamiento ejecuta los comandos sobre el dialog cuando el navegador no los trae (Safari antes de 26.2, Firefox antes de 144)

El Core se compromete con Baseline ampliamente disponible: lo que funciona en Chrome, Edge, Firefox y Safari desde hace unos 30 meses. Hoy eso es Chrome y Edge 124, Firefox 125 y Safari 17.4 (también en iOS), según los datos del 10 de noviembre de 2026; el piso se actualiza en cada versión. No se apunta a Internet Explorer ni a navegadores más viejos. Lo que supera ese piso está en la tabla con su fallback o con lo que pierde si falta: un navegador del piso pierde el detalle nativo (una transición, un modo de posicionamiento), no la funcionalidad, según el chequeo de compatibilidad del CSS; no se probó en navegadores de esa versión.


Accesibilidad y motion

Los componentes respetan prefers-reduced-motion (las animaciones se desactivan o se vuelven instantáneas) y cada uno se prueba con axe. Detalles en Motion y Accesibilidad.