55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
<!-- file: docs/rules/550-VITE.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Profil Vite
|
|
|
|
## Rôle et applicabilité
|
|
|
|
Ce profil possède les règles réutilisables propres à Vite lorsqu'il est sélectionné comme build tool et dev server d'un frontend.
|
|
|
|
Vite est traité comme une spécialisation de build de l'écosystème frontend au sein de la famille [`500-LANGUAGES.md`](500-LANGUAGES.md), pas comme le propriétaire de TypeScript, Sass/CSS, du package manager, du framework UI ou du host Tauri.
|
|
|
|
Le profil s'applique uniquement lorsqu'un projet utilise réellement Vite.
|
|
|
|
## Recommandation pour les projets contrôlés
|
|
|
|
Pour un frontend moderne que l'organisation contrôle et dont les besoins sont compatibles, Vite **SHOULD** être le build tool/dev server privilégié.
|
|
|
|
Cette recommandation n'est pas une obligation. Un autre bundler, dev server ou build tool MAY être choisi lorsque ses capacités, les contraintes d'un framework, l'environnement cible ou le coût de migration le justifient mieux.
|
|
|
|
Le simple fait qu'un projet Web existe ne rend donc pas ce profil applicable automatiquement.
|
|
|
|
## Ownership
|
|
|
|
Lorsque Vite est sélectionné, cet owner possède notamment :
|
|
|
|
- `vite.config.ts` ou une configuration Vite équivalente ;
|
|
- la racine frontend présentée à Vite ;
|
|
- le dev server et son contrat de lancement ;
|
|
- le cache Vite ;
|
|
- les outputs du build Vite ;
|
|
- la copie/transformation d'assets configurée par Vite ou ses plugins ;
|
|
- les paramètres Vite nécessaires à l'intégration avec un host, sans posséder le host lui-même.
|
|
|
|
Les ports, hosts réseau, aliases, plugins et conventions de nommage d'assets restent des décisions locales tant qu'aucune règle plus générale n'est démontrée.
|
|
|
|
## Sources, cache et outputs
|
|
|
|
Les sources frontend versionnées, le cache de développement et les outputs de production sont des catégories différentes.
|
|
|
|
Le cache et les sorties de build reproductibles SHOULD rester hors Git. Pour les projets contrôlés, ils SHOULD être placés hors de l'arborescence source lorsque cela reste simple, reproductible et compatible avec la toolchain ; sinon ils doivent au minimum être ignorés explicitement.
|
|
|
|
Le détail du contrat `root`, `cacheDir`, `outDir`, assets et dev server est réservé à `0.1.1-alpha.4`.
|
|
|
|
## Validation
|
|
|
|
Une validation Vite ciblée prouve le contrat de build/dev tool de Vite ; elle ne remplace pas automatiquement :
|
|
|
|
- le type-check TypeScript ;
|
|
- une compilation Sass spécifique lorsqu'elle est indépendante ;
|
|
- le smoke navigateur requis par un comportement observable ;
|
|
- la validation du host Tauri ;
|
|
- une génération WASM possédée par un autre owner.
|
|
|
|
`alpha.4` précisera les commandes et artefacts génériques applicables.
|