--isolatedDeclarations

Définition

Option introduite en TypeScript 5.5 (20 juin 2024) qui exige une annotation de type explicite sur chaque export dont le type ne se déduit pas trivialement. En échange, les fichiers .d.ts peuvent être générés fichier par fichier, sans vérification de type globale, donc en parallèle et par des outils non-TS (Oxc, esbuild, SWC). Pensée pour les monorepos.

Analogie

Chaque colis porte son étiquette complète : n'importe quel trieur peut le router sans ouvrir les autres colis.

Exemple de code

// tsconfig.json : { "compilerOptions": { "isolatedDeclarations": true, "declaration": true } }

// ❌ Erreur TS9007 : le type de retour doit être annoté
export function creer(n: number) { return { id: n, tags: [] }; }

// ✅ Le .d.ts se déduit sans typechecker
export function creer(n: number): { id: number; tags: string[] } {
  return { id: n, tags: [] };
}

Cas d'usage

Monorepos où la génération des .d.ts est le goulot du build ; bibliothèques publiées avec un bundler Rust.

Anti-pattern

Termes liés

Sources

• devblogs.microsoft.com/typescript/announcing-typescript-5-5/