- TypeScript : commandes tsc et guide CLI complet

npm install -g typescript

Installe TypeScript globalement

npm install --save-dev typescript

Installe TypeScript comme dépendance de développement

tsc

Compile les fichiers TypeScript en JavaScript

tsc --version

Affiche la version de TypeScript

tsc --init

Crée un fichier tsconfig.json avec les options par défaut

tsc --project tsconfig.json

Compile avec un fichier de configuration spécifique

tsc -p tsconfig.json

Alias court pour --project

tsc --watch

Compile en mode watch (recompile sur modification)

tsc -w

Alias court pour --watch

tsc --noEmit

Vérifie les types sans générer de fichiers JS

tsc --strict

Active toutes les options de vérification strictes

tsc --target ES2022

Compile vers ECMAScript 2022

tsc --module commonjs

Utilise le système de modules CommonJS

tsc --module esnext

Utilise les modules ESNext

tsc --moduleResolution node

Utilise la résolution de modules Node.js

tsc --moduleResolution bundler

Utilise la résolution de modules pour bundlers (Vite, Webpack)

tsc --outDir dist

Définit le dossier de sortie pour les fichiers JS

tsc --rootDir src

Définit le dossier racine des sources TypeScript

tsc --declaration

Génère les fichiers de déclaration .d.ts

tsc --declarationMap

Génère les source maps pour les fichiers .d.ts

tsc --emitDeclarationOnly

Génère uniquement les fichiers .d.ts (pas de JS)

tsc --sourceMap

Génère les source maps (.js.map)

tsc --inlineSourceMap

Inclut la source map dans les fichiers JS

tsc --inlineSources

Inclut le code source dans les source maps

tsc --removeComments

Supprime les commentaires des fichiers JS générés

tsc --noImplicitAny

Erreur sur les expressions avec type 'any' implicite

tsc --strictNullChecks

Vérification stricte des valeurs null/undefined

tsc --strictFunctionTypes

Vérification stricte des types de fonctions

tsc --strictBindCallApply

Vérification stricte de bind/call/apply

tsc --strictPropertyInitialization

Vérification de l'initialisation des propriétés de classe

tsc --noImplicitThis

Erreur sur 'this' de type 'any' implicite

tsc --noImplicitReturns

Erreur si toutes les branches ne retournent pas une valeur

tsc --noImplicitOverride

Force l'utilisation du mot-clé 'override'

tsc --noUnusedLocals

Erreur sur les variables locales non utilisées

tsc --noUnusedParameters

Erreur sur les paramètres de fonction non utilisés

tsc --noFallthroughCasesInSwitch

Erreur sur les fallthrough dans les switch

tsc --noUncheckedIndexedAccess

Ajoute 'undefined' aux accès par index

tsc --noPropertyAccessFromIndexSignature

Force la syntaxe d'index pour les propriétés dynamiques

tsc --exactOptionalPropertyTypes

Interprète les propriétés optionnelles comme écrites

tsc --useUnknownInCatchVariables

Type 'unknown' par défaut pour les variables catch

tsc --allowUnreachableCode

Autorise le code inaccessible

tsc --allowUnusedLabels

Autorise les labels inutilisés

tsc --alwaysStrict

Parse en mode strict et émet 'use strict'

tsc --esModuleInterop

Active l'interopérabilité des modules ES

tsc --allowSyntheticDefaultImports

Permet les imports par défaut depuis des modules sans export par défaut

tsc --resolveJsonModule

Permet l'import de fichiers JSON

tsc --forceConsistentCasingInFileNames

Force la casse cohérente des noms de fichiers

tsc --skipLibCheck

Ignore la vérification des fichiers de déclaration (.d.ts)

tsc --skipDefaultLibCheck

Ignore la vérification de la bibliothèque par défaut

tsc --lib es2022,dom

Spécifie les bibliothèques à inclure

tsc --types node,express

Spécifie les packages de types à inclure

tsc --typeRoots ./node_modules/@types,./typings

Spécifie les dossiers de types

tsc --baseUrl .

Définit l'URL de base pour la résolution des modules

tsc --paths "@app/*: ['./src/*']"

Définit des alias de chemins

tsc --rootDirs src,generated

Définit plusieurs dossiers racines

tsc --jsx react

Support JSX pour React

tsc --jsx react-jsx

Support JSX pour React 17+ (nouveau runtime)

tsc --jsx react-jsxdev

Support JSX pour React avec mode développement

tsc --jsx preserve

Préserve le JSX pour un autre outil

tsc --jsxFactory h

Spécifie la fonction factory JSX (ex: Preact)

tsc --jsxFragmentFactory Fragment

Spécifie la fonction fragment JSX

tsc --jsxImportSource react

Spécifie la source d'import JSX

tsc --experimentalDecorators

Active le support des décorateurs expérimentaux

tsc --emitDecoratorMetadata

Émet les métadonnées pour les décorateurs

tsc --useDefineForClassFields

Utilise la sémantique standard pour les champs de classe

tsc --incremental

Compilation incrémentale (plus rapide)

tsc --tsBuildInfoFile .tsbuildinfo

Spécifie le fichier d'info de build incrémental

tsc --build

Construit un projet composite (project references)

tsc -b --clean

Nettoie les sorties d'un projet composite

tsc -b --force

Force la reconstruction complète

tsc -b --dry

Simule le build sans écrire de fichiers

tsc -b --verbose

Mode verbeux pour le build composite

tsc --listFiles

Liste les fichiers inclus dans la compilation

tsc --listEmittedFiles

Liste les fichiers émis

tsc --explainFiles

Explique pourquoi les fichiers sont inclus

tsc --showConfig

Affiche la configuration résolue

tsc --extendedDiagnostics

Affiche des diagnostics détaillés

tsc --generateCpuProfile profile.cpuprofile

Génère un profil CPU

tsc --locale fr

Définit la langue des messages

tsc --diagnostics

Affiche des informations de diagnostic

tsc --traceResolution

Trace la résolution des modules

tsc --maxNodeModuleJsDepth 0

Limite la profondeur de recherche dans node_modules

tsc --noErrorTruncation

N'affiche pas les erreurs tronquées

tsc --pretty

Active les messages d'erreur colorés et formatés

tsc --noPretty

Désactive le formatage coloré

npm install --save-dev ts-node

Installe ts-node (exécution directe de TypeScript)

ts-node script.ts

Exécute un fichier TypeScript directement

ts-node --transpile-only script.ts

Exécute sans vérification de types (plus rapide)

ts-node --project tsconfig.json script.ts

Exécute avec une configuration spécifique

ts-node -P tsconfig.json script.ts

Alias court pour --project

ts-node --esm script.ts

Exécute en mode ES Modules

ts-node --swc script.ts

Utilise SWC pour la transpilation (ultra-rapide)

ts-node --files script.ts

Charge les fichiers spécifiés dans tsconfig

ts-node --ignore node_modules script.ts

Ignore certains dossiers

ts-node --skip-project script.ts

Ignore le tsconfig.json

ts-node --emit script.ts

Émet les fichiers JS en plus de l'exécution

npm install --save-dev tsx

Installe tsx (exécution TypeScript/ESM ultra-rapide avec esbuild)

tsx script.ts

Exécute un fichier TypeScript avec tsx

tsx --watch script.ts

Exécute en mode watch (rechargement automatique)

tsx --tsconfig tsconfig.json script.ts

Exécute avec un tsconfig spécifique

tsx --no-cache script.ts

Désactive le cache de compilation

npx tsx script.ts

Exécute tsx sans installation globale

npm install --save-dev ts-node-dev

Installe ts-node-dev (hot reload pour TypeScript)

ts-node-dev script.ts

Exécute avec rechargement automatique

ts-node-dev --respawn script.ts

Redémarre le processus à chaque changement

ts-node-dev --transpile-only script.ts

Rechargement rapide sans vérification de types

ts-node-dev --watch src script.ts

Surveille un dossier spécifique

ts-node-dev --ignore node_modules script.ts

Ignore certains dossiers

ts-node-dev --debug script.ts

Lance en mode debug

ts-node-dev --inspect script.ts

Active l'inspecteur Node.js

npm install --save-dev @types/node

Installe les types Node.js

npm install --save-dev @types/express

Installe les types Express

npm install --save-dev @types/react

Installe les types React

npm install --save-dev @types/jest

Installe les types Jest

npm install --save-dev @typescript-eslint/eslint-plugin @typescript-eslint/parser

Installe ESLint pour TypeScript

npx eslint --init

Initialise la configuration ESLint (supporte TypeScript)

npx eslint . --ext .ts,.tsx

Lance ESLint sur les fichiers TypeScript

npx prettier --write "**/*.ts"

Formate les fichiers TypeScript avec Prettier

npm install --save-dev typedoc

Installe TypeDoc (générateur de documentation pour TypeScript)

npx typedoc

Génère la documentation depuis les sources TypeScript

npx typedoc --out docs src/index.ts

Génère la documentation dans le dossier docs

npx typedoc --tsconfig tsconfig.json

Utilise un tsconfig spécifique

npx typedoc --name "Mon API" --readme README.md src

Documentation avec nom et README personnalisés

npx typedoc --exclude "**/*.test.ts" --excludePrivate

Exclut les tests et membres privés

npx typedoc --plugin typedoc-plugin-markdown

Génère la documentation au format Markdown

npx typedoc --theme default

Utilise le thème par défaut

npx tsc --noEmit && npx eslint . --ext .ts

Vérifie les types ET le linting (combinaison)

npm install --save-dev typesync

Installe typesync (synchronise @types avec package.json)

npx typesync

Ajoute les @types manquants au package.json

npm install --save-dev typescript-transform-paths

Installe le transformateur de chemins (pour ts-patch)

npx tsc-alias

Remplace les alias de chemins dans les fichiers JS générés

npx tsc-alias -p tsconfig.json

Remplace les alias en utilisant un tsconfig

npx tsc-alias --watch

Mode watch pour les alias

npm install --save-dev rimraf

Installe rimraf pour nettoyer les dossiers

rimraf dist && tsc

Nettoie le dossier dist avant compilation

npm run build

Script de build typique dans package.json

npm run type-check

Vérifie les types sans émettre de fichiers

npm run dev

Mode développement avec hot reload

npm install --save-dev ts-jest

Installe ts-jest pour les tests Jest avec TypeScript

npx ts-jest config:init

Initialise la configuration ts-jest

npx jest --coverage

Lance les tests avec couverture (avec ts-jest configuré)

npm install --save-dev vitest

Installe Vitest (test runner rapide avec support TypeScript natif)

npx vitest

Lance Vitest

npx vitest --typecheck

Lance les tests avec vérification des types

npx vitest --coverage

Lance les tests avec couverture

npm install --save-dev @swc/core @swc/cli

Installe SWC (compilateur ultra-rapide pour TypeScript)

npx swc src -d dist

Compile avec SWC

npx swc src -d dist --watch

Compile en mode watch avec SWC

npm install --save-dev esbuild

Installe esbuild (bundler ultra-rapide avec support TypeScript)

npx esbuild src/index.ts --bundle --outfile=dist/bundle.js

Bundle TypeScript avec esbuild