Le codeQualité et livraison5 min de lecture
TypeScript et ESLint
Les options du compilateur et ce qu’elles empêchent, les règles de lint qui transforment une faute d’architecture en erreur, les autres contrôles statiques, et le moment où chacun tourne.
Les contrôles statiques vérifient le code sans l’exécuter. Chaque application a son check : next typegen, ESLint à zéro avertissement, tsc --noEmit, Prettier et knip (check de apps/erp/package.json et de apps/site/package.json). Les paquets ont pnpm packages:check. Il lance leurs types, leur lint et leurs tests un par un, puis knip sur le reste du dépôt. L’ERP et le site en sont exclus, puisqu’ils ont déjà le leur (knip.config.ts). La doc en est exclue aussi, et son check n’a pas de knip : elle n’est vérifiée par knip nulle part.
TypeScript
Toutes les configurations partent de la même base :
{
"compilerOptions": {
"target": "ES2022",
"skipLibCheck": true,
"strict": true,
"noEmit": true,
"esModuleInterop": true,
"module": "esnext",
"moduleResolution": "bundler",
"resolveJsonModule": true,
"isolatedModules": true,
"forceConsistentCasingInFileNames": true,
"noUncheckedIndexedAccess": true,
"exactOptionalPropertyTypes": true,
"noImplicitOverride": true,
"noFallthroughCasesInSwitch": true,
"useUnknownInCatchVariables": true,
"verbatimModuleSyntax": true,
"erasableSyntaxOnly": true
}
}En plus de strict, chaque option élimine un type d’erreur précis :
noUncheckedIndexedAccess:tableau[i]etobjet[clé]valentT | undefined. Il faut donc traiter le cas où la valeur manque, on ne peut pas supposer qu’elle est là. C’est utile dans un code qui lit des lignes de base, des paramètres d’URL et des réponses de services.exactOptionalPropertyTypes: une propriété absente et une propriété égale àundefined, ce sont deux choses différentes.useUnknownInCatchVariables: une erreur attrapée estunknown. C’est pour ça qu’on trouve deserr instanceof Error ? err.message : String(err)dans les scripts d’exploitation.verbatimModuleSyntaxeterasableSyntaxOnly: un import de type s’écrit comme tel, et aucune syntaxe TypeScript ne génère de code (pas d’enum, pas denamespace). Les scripts.mtsse lancent avectsx, qui ne fait que retirer les types.noImplicitOverrideetnoFallthroughCasesInSwitch: une méthode redéfinie doit le dire, et uncasene peut pas glisser dans le suivant.
Le typecheck d’une application lance next typegen avant tsc, qui est TypeScript 7. next build, lui, charge TypeScript 6 : typecheck:build lance ce compilateur-là (tsc6), et c’est lui que le hook pre-push passe. Les deux applications activent typedRoutes (next.config.ts). Du coup, un lien vers une route qui n’existe pas, ou qui a été renommée, ne compile pas.
ESLint
La configuration commune, packages/config/eslint.mjs, fournit createAppEslintConfig et createPackageEslintConfig. ESLint tourne partout avec --max-warnings=0. Au commit, au push et dans check, un avertissement bloque autant qu’une erreur. Les règles se rangent par familles :
- Les types (
TYPESCRIPT_RULES), avec les informations de type (projectService).no-floating-promisesrefuse une promesse oubliée, qui échouerait sans que personne ne le voie.no-explicit-anyetconsistent-type-importssont des erreurs.no-unsafe-assignment,no-unsafe-return,no-unnecessary-conditionetprefer-nullish-coalescingsont des avertissements, donc ils bloquent aussi. - L’architecture.
shared/n’importe nimodules/niapp/(SHARED_BOUNDARY_PATTERNS). Une route n’importe ni Prisma ni le client généré. Un module de l’ERP n’importe aucun autre module. Les modules du site n’importent que les couches qui viennent avant la leur (MODULE_LAYERS,apps/site/eslint.config.mjs). Et une entrée de paquet passe par le relais de l’application quand il existe (moriniere/prefer-relay, qui corrige l’import tout seul). J’explique pourquoi dans Rangement du code. - La sécurité (
SECURITY_RULES) : les règles recommandées d’eslint-plugin-security, saufdetect-object-injection. Une exception s’écrit sur la ligne concernée, avec sa raison :eslint-disable-next-line security/detect-non-literal-fs-filename -- le dépôt commun de git, constaté à l’instant. - L’accessibilité (
BASE_RULES) :jsx-a11y, qui refuse entre autres les éléments non interactifs qui réagissent au clic, les libellés sans contrôle et l’autofocus. - Le rendu React (
RESTRICTED_SYNTAX).useMemo,useCallbacketmemosont refusés, parce que le React Compiler s’occupe de la mémoïsation. Undynamic()sansloadingnissr: falseest refusé, parce qu’il suspendrait jusqu’auSuspenseparent et remplacerait l’écran par son squelette. Une action attendue dans une transition sanscatchest refusée aussi. Sinon, une coupure réseau ferait basculer tout l’écran surerror.tsx. - Le texte : l’espace avant « ? » et « ! » dans les textes d’interface, et l’échelle typographique du site.
Les autres contrôles statiques
- Prettier (
format:check). Il passe aussi au commit, sur les fichiers indexés. - knip (
knip:ci), qui repère les fichiers, exports, types et dépendances inutilisés, les dépendances non déclarées et les doublons. - Les licences (
scripts/check-licenses.mjs). Toutes les licences de production du workspace sont comparées à une liste de licences refusées (REFUSEES), avec des exceptions nommées (ADMIS). - La doctrine d’interface (
scripts/check-ui-doctrine.mjs), pour ce qu’ESLint ne voit pas dans les classes, comme le survol réservé aux appareils qui ont un pointeur ou les durées nommées. - Les jumeaux (
scripts/check-twins.mjs,scripts/twins.manifest.json). Ce qui est identique dans l’ERP et le site doit sortir dans un paquet, et une règle corrigée d’un seul côté est refusée. Je raconte pourquoi dans l’étude de cas Deux applications nées d’un fork. - Les références de la doc (
scripts/check-doc-references.mjs). Chaque chemin,fichier.ts#SYMBOLEou identifiant cité dans le texte doit encore exister dans le dépôt. Le build de la doc le vérifie aussi. - Les messages de commit (
commitlint.config.ts), qui suivent la convention des commits conventionnels, avec les modules comme portées (MODULE_SCOPES).
Où chaque contrôle tourne
| Contrôle | Au commit | Au push sur main | pnpm validate |
|---|---|---|---|
| TypeScript | non | ERP, site, paquets | oui |
| ESLint | fichiers indexés, corrigés | ERP, site, paquets | oui |
| Prettier | fichiers indexés, réécrits | non | oui |
| knip | non | hors ERP, site et doc | oui |
| Jumeaux | non | oui | oui |
| Références de la doc | non | oui | oui |
| Licences, doctrine d’interface | non | non | oui |
Documentation (docs:check) | lint et format des fichiers indexés | non | oui |
Le commit corrige ce qui peut se corriger tout seul (lint-staged de package.json). Le push vérifie le commit poussé en entier (La porte du push). Et pnpm validate est le seul à tout lancer, uniquement à la main.