# Avanzado

TailwindPHP es un port 1:1 de TailwindCSS 4.x a PHP puro. Su principio rector es la fidelidad: el código reproduce el proyecto original de TypeScript archivo por archivo, con los mismos nombres y organización, para que cada comportamiento de TailwindCSS tenga un lugar claro en PHP y se puedan seguir los cambios originales sin conjeturas.

Todo lo que *no* forma parte del port de TailwindCSS vive en un único lugar claramente identificado: `src/_tailwindphp/`. Ese directorio contiene los auxiliares específicos de PHP: una reimplementación de las transformaciones Rust `lightningcss` (`LightningCss.php`), el minificador de CSS (`CssMinifier.php`) y los ports de bibliotecas complementarias (`lib/`: clsx, tailwind-merge, CVA) bajo el espacio de nombres `TailwindPHP\Lib\*`. Todo lo demás dentro de `src/` corresponde a un archivo de TailwindCSS.

La corrección se verifica con la propia suite de pruebas de Tailwind. Los casos de prueba se extraen directamente de los archivos `.test.ts` de TailwindCSS y se ejecutan frente a la salida de PHP, de modo que cualquier desviación del comportamiento original falla de inmediato. El resultado es de 4,427 pruebas superadas (versión 1.7.0, frente a TailwindCSS v4.3.3), que cubren utilidades, variantes, directivas, plugins, CLI y las bibliotecas complementarias.

## Páginas

- **[Arquitectura](https://tailwindphp.inline0.dev/es/docs/advanced/architecture)** — el flujo de compilación (analizar → explorar → compilar → optimizar → minificar), la estructura del código fuente, el equivalente de `lightningcss` y la convención de marcadores `@port-deviation`.
- **[Caché y minificación](https://tailwindphp.inline0.dev/es/docs/advanced/caching)** — la caché de salida basada en archivos (`cache`, `cacheTtl`, `clearCache()`), la caché del estado del compilador (`stateCacheFile`) y lo que hace el minificador de CSS.
- **[Rendimiento y pruebas](https://tailwindphp.inline0.dev/es/docs/advanced/performance)** — optimizaciones específicas de PHP, cómo se verifica la paridad con TailwindCSS y el control de calidad del código.
- **[Compatibilidad y actualización](https://tailwindphp.inline0.dev/es/docs/advanced/compatibility)** — requisitos, la versión de TailwindCSS seguida, diferencias conocidas respecto a TailwindCSS y notas de actualización por versión.