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.12 | 24.12.0 | astro 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.8 | 22.22.3 | Lo mismo que en Astro 7 |
| Next 16.4.6 (App Router, React 19.3.1, Turbopack) | 22.22.3 | next 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.3 | vite 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.
---
import '../../taisho/fonts.css';
import '../../taisho/theme.css';
import '../../taisho/taisho.css';
---
<html lang="es">
<body class="ts flex flex-col gap-base p-double">
<slot />
<script>import '../../taisho/taisho.core.js';</script>
</body>
</html>- Generar antes de arrancar. La carpeta
taisho/tiene que existir antes deastro devy deastro build: se corretaisho generateprimero, otaisho watchen 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/coreen 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 condevToolbar: { enabled: false }y, si el JS se importa del paquete, se evita el aviso declarándolo envite.optimizeDeps.include.
// astro.config.mjs
import { defineConfig } from 'astro/config';
import { taisho } from '@taishods/core/vite';
export default defineConfig({ vite: { plugins: [taisho()] } });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 (componente de servidor)
import '../taisho/fonts.css';
import '../taisho/theme.css';
import '../taisho/taisho.css';
import CargaTaisho from './carga-taisho';
export default function RootLayout({ children }) {
return (
<html lang="es" data-scroll-behavior="smooth">
<body className="ts flex flex-col gap-base p-double">
{children}
<CargaTaisho />
</body>
</html>
);
}// app/carga-taisho.jsx
'use client';
import { useEffect } from 'react';
export default function CargaTaisho() {
useEffect(() => {
import('../taisho/taisho.core.js');
}, []);
return null;
}- Otras formas de cargar el JS. Funcionaron con la misma batería el import
dinámico de
@taishods/core/coreen 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-behavioren<html>. El reset del Core ponescroll-behavior: smoothen<html>y, ennext dev, Next 16 avisa en la consola hasta que se agregadata-scroll-behavior="smooth"a esa etiqueta (como en el layout de arriba).- El marcado en JSX. Las clases van en
className.commandforse escribe en minúscula, porque React 19.3.1 no reconocecommandFory avisa en la consola;closedbytambién va en minúscula. En el Select se usódefaultValueen el<select>. - Clases en JSX.
taisho generateencuentra las clases escritas enclassNamede los archivos.jsx: el CSS resultante trae las del Modal y las del Select.taisho checkrevisó 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 -->
<script>
import '../../taisho/fonts.css';
import '../../taisho/theme.css';
import '../../taisho/taisho.css';
import { onMount } from 'svelte';
let { children } = $props();
onMount(() => {
import('../../taisho/taisho.core.js');
});
</script>
<div class="ts flex flex-col gap-base p-double">
{@render children()}
</div>- 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 leesvelte.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 connext/script. - Marcado que el framework controle con su propio estado (por ejemplo, un
hiddeno unaria-expandedque 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 positioning | Posición de overlays (Popover, Menu, Tooltip, …) | Fallback JS (floating.ts) |
| Popover API | Capa superior de Popover / Menu | Degradación a posicionamiento manual |
| <dialog> | Modal, Drawer, AlertDialog | Nativo en todo navegador moderno |
| Invoker commands | Abrir/cerrar Modal y Drawer sin JS | El JS de comportamiento ejecuta los comandos sobre el dialog cuando el navegador no los trae (Safari antes de 26.2, Firefox antes de 144) |
Navegadores
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.