16 - Glossaire

Tous les termes de la serie, par ordre alphabetique. Chaque définition renvoie vers l'article qui couvre le concept en détail.

A

allowJs — Option du tsconfig qui permet d'inclure des fichiers .js dans un projet TypeScript. Première étape d'une migration progressive. → Article 13

B

Barrel file — Fichier index.ts qui re-exporte les exports d'un dossier. Simplifie les imports mais peut ralentir la compilation et le tree-shaking. → Article 12

C

Colocation — Stratégie d'organisation ou les types sont places a cote du code qui les utilise, plutot que dans un dossier centralise. → Article 04

Coercion (Zod) — Transformation automatique d'une valeur avant validation. z.coerce.number() convertit "42" en 42. → Article 02

D

Déclaration file (.d.ts) — Fichier qui contient uniquement des déclarations de types, sans code runtime. Utilise pour typer des libs JavaScript et publier des packages types. → Article 11

Déclaration map — Fichier .d.ts.map qui lie les déclarations aux sources originales. Permet "Go to Définition" vers le code source au lieu du .d.ts. → Article 11

Decorator (stage 3) — Syntaxe @decorator pour modifier des classes, méthodes, champs et accesseurs. Les decorateurs natifs (TS 5+) remplacent les anciens experimentalDecorators. → Article 09

Drizzle — ORM TypeScript schema-as-code. Les types sont derives du schema défini en TypeScript, pas générés depuis une base. → Article 08

E

expect-type — Lib de test qui vérifié les types a la compilation. expectTypeOf(fn).returns.toBeString() teste le type de retour, pas la valeur. → Article 15

F

Factory function (test) — Fonction qui créé un objet mock avec des valeurs par défaut et des overrides types. createMockUser({ role: "admin" }). Alternative type-safe au cast as. → Article 15

Fixture — Donnee de test predefined et réutilisable. En TypeScript, les fixtures sont typees : si le type change, le compilateur signale les fixtures a mettre à jour. → Article 15

G

--generateTrace — Flag de tsc qui généré un trace file pour analyser les performances de compilation. Identifie les types lents et les goulets d'etranglement. → Article 14

M

moduleResolution — Option du tsconfig qui definit comment TypeScript resout les imports. "bundler" pour les projets avec bundler, "nodenext" pour Node.js ESM. → Article 01

Monorepo — Repository contenant plusieurs packages/projets. Le partage de types entre packages nécessité des workspace configs et des project références. → Article 12

N

noEmit — Option du tsconfig qui désactivé la génération de fichiers JavaScript. Utile quand un bundler (Bun, Vite) gere la transpilation et que tsc ne sert qu'au type checking. → Article 01

noUncheckedIndexedAccess — Option du tsconfig qui ajoute | undefined au type de retour des acces par index. Plus strict mais détecté les acces hors limites. → Article 01

P

Paths (tsconfig) — Option qui definit des alias d'import. "@/*": ["src/*"] permet d'écrire import { User } from "@/types" au lieu de chemins relatifs. → Article 01

Prisma — ORM TypeScript qui généré les types depuis le schema Prisma. Les types sont créés par prisma generate et refletent exactement la structure de la base. → Article 08

Project références — Mecanisme du tsconfig pour découper un projet en sous-projets avec des dépendances explicites. Permet la compilation incrementale dans les monorepos. → Article 12

R

Result pattern — Pattern ou une fonction retourne { ok: true; value: T } | { ok: false; error: E } au lieu de lancer des exceptions. Force l'appelant a gerer les deux cas. → Article 06

S

safeParse (Zod) — Méthode de validation qui retourne un résultat discrimine { success: true; data: T } | { success: false; error: ZodError } au lieu de lancer. → Article 02

skipLibCheck — Option du tsconfig qui ignore les erreurs dans les fichiers .d.ts de node_modules. Accelere la compilation et évité les conflits entre libs. → Article 01

strict — Option du tsconfig qui active un ensemble de verifications de sécurité (strictNullChecks, noImplicitAny, etc.). Non-negociable dans tout projet nouveau. → Article 01

T

t3-env — Lib qui combine Zod et les variables d'environnement pour une validation type-safe au démarrage de l'application. → Article 03

@ts-expect-error — Directive qui fait échouer le test si la ligne suivante compile sans erreur. Teste que le compilateur refuse un code invalide. → Article 15

V

verbatimModuleSyntax — Option du tsconfig (TS 5.0) qui force import type pour les imports de types. Necessaire pour les bundlers qui ne font pas d'analyse de types. → Article 01

Z

Zod — Lib de validation de schemas TypeScript-first. Definit un schema qui est a la fois une validation runtime et un type TypeScript via z.infer. → Article 02

z.infer — Utility type de Zod qui derive un type TypeScript depuis un schema Zod. type User = z.infer<typeof UserSchema>. Un seul endroit a maintenir. → Article 02

Article précédent : 15 - Types et tests

Serie précédente : TypeScript — types avances

Première serie : TypeScript — le système de types