0.1.1-alpha.3
This commit is contained in:
@@ -1,5 +1,5 @@
|
||||
<!-- file: docs/rules/530-TYPESCRIPT.md -->
|
||||
<!-- version: 1 -->
|
||||
<!-- version: 2 -->
|
||||
|
||||
# Profil TypeScript
|
||||
|
||||
@@ -31,9 +31,40 @@ Cette recommandation ne transforme pas TS-RS en dépendance générale de TypeSc
|
||||
|
||||
`tsconfig.json`, les options de compilation/type-check, les fichiers inclus/exclus et la commande TypeScript canonique appartiennent à ce profil.
|
||||
|
||||
`0.1.1-alpha.2` fixe uniquement cette frontière d'ownership. Les defaults réutilisables, templates éventuels et gates TypeScript détaillés sont traités par `alpha.3` après validation du présent découpage.
|
||||
Pour un nouveau package TypeScript contrôlé, la baseline PGR `SHOULD` activer au minimum :
|
||||
|
||||
Un build Vite, Tauri ou autre ne remplace pas automatiquement une preuve TypeScript ciblée lorsqu'une propriété de typage doit être validée indépendamment.
|
||||
```text
|
||||
strict = true
|
||||
noEmit = true
|
||||
```
|
||||
|
||||
`strict` exprime la volonté d'utiliser le contrôle de types renforcé de TypeScript. `noEmit` sépare le type-check de la production des artefacts JavaScript lorsque cette production appartient à un bundler ou à un autre outil.
|
||||
|
||||
Pour une baseline stricte, PGR `SHOULD` également activer les contrôles simples suivants sauf incompatibilité documentée :
|
||||
|
||||
```text
|
||||
noUnusedLocals = true
|
||||
noUnusedParameters = true
|
||||
noFallthroughCasesInSwitch = true
|
||||
```
|
||||
|
||||
Les choix `target`, `module`, `moduleResolution`, `lib`, `types`, `jsx`, chemins/aliases, `include` et `exclude` dépendent du runtime, du bundler, du framework et du layout réel. PGR MUST NOT les figer dans le profil TypeScript générique uniquement parce qu'ils apparaissent dans Games.
|
||||
|
||||
Le package `SHOULD` exposer une validation TypeScript indépendante sous un script canonique :
|
||||
|
||||
```text
|
||||
typecheck
|
||||
```
|
||||
|
||||
Lorsque le compilateur local est installé dans le package, le pattern recommandé est :
|
||||
|
||||
```text
|
||||
tsc --noEmit
|
||||
```
|
||||
|
||||
Un build Vite, Tauri ou autre ne remplace pas automatiquement cette preuve ciblée lorsqu'une propriété de typage doit être validée indépendamment.
|
||||
|
||||
Le modèle minimal [`../../templates/web-typescript/tsconfig.json`](../../templates/web-typescript/tsconfig.json) active uniquement les options génériques ci-dessus. Le guide [`../templates/008-WEB_TYPESCRIPT_PACKAGE.md`](../templates/008-WEB_TYPESCRIPT_PACKAGE.md) liste les décisions à compléter avant adoption réelle.
|
||||
|
||||
## Ce que le profil n'impose pas
|
||||
|
||||
|
||||
Reference in New Issue
Block a user