# Avansat

TailwindPHP este o portare 1:1 a TailwindCSS 4.x în PHP pur. Principiul director este fidelitatea: baza de cod oglindește proiectul original TypeScript fișier cu fișier — aceleași nume de fișiere, aceeași organizare — astfel încât orice comportament din TailwindCSS să aibă un loc evident în PHP, iar modificările din amonte să poată fi urmărite fără presupuneri.

Tot ce nu face parte din portarea TailwindCSS se află într-un singur loc, marcat clar: `src/_tailwindphp/`. Directorul conține ajutoarele specifice PHP — o reimplementare a transformărilor Rust `lightningcss` (`LightningCss.php`), minificatorul CSS (`CssMinifier.php`) și portările bibliotecilor auxiliare (`lib/`: clsx, tailwind-merge, CVA) în spațiul de nume `TailwindPHP\Lib\*`. Orice altceva din `src/` corespunde unui fișier din TailwindCSS.

Corectitudinea este verificată cu suita de teste proprie a lui Tailwind. Cazurile de test sunt extrase direct din fișierele `.test.ts` ale lui TailwindCSS și rulate împotriva rezultatului PHP, astfel încât orice abatere de la comportamentul original eșuează imediat. Rezultatul este de 4,427 teste trecute (versiunea 1.7.0, față de TailwindCSS v4.3.3), care acoperă utilitarele, variantele, directivele, pluginurile, CLI și bibliotecile auxiliare.

## Pagini

- **[Arhitectură](https://tailwindphp.inline0.dev/ro/docs/advanced/architecture)** — pipeline-ul de compilare (parse → scan → compile → optimize → minify), structura sursei, echivalentul `lightningcss` și convenția marcajelor `@port-deviation`.
- **[Stocarea în cache și minificarea](https://tailwindphp.inline0.dev/ro/docs/advanced/caching)** — cache-ul de rezultate bazat pe fișiere (`cache`, `cacheTtl`, `clearCache()`), cache-ul stării compilatorului (`stateCacheFile`) și ce face minificatorul CSS.
- **[Performanță și testare](https://tailwindphp.inline0.dev/ro/docs/advanced/performance)** — optimizările specifice PHP, verificarea parității cu TailwindCSS și etapa de control al calității codului.
- **[Compatibilitate și actualizare](https://tailwindphp.inline0.dev/ro/docs/advanced/compatibility)** — cerințe, versiunea TailwindCSS urmărită, diferențe cunoscute față de TailwindCSS și notele de actualizare pentru fiecare versiune.