Créer des graphes d’appels de code en TypeScript avec les API de langage de VS Code

Alors que les assistants de codage basés sur l'IA génèrent des centaines de lignes de code réparties sur de nombreux fichiers, les pratiques traditionnelles de revue de code deviennent de plus en plus difficiles à maintenir. Rédiger du code guidé par des modèles de langage dépasse souvent la capacité d'un développeur à préserver le contexte architectural global. Pour surmonter ce défi, il convient de ne plus traiter une base de code comme une simple collection de fichiers isolés, mais comme un graphe d'appels structuré où les fonctions servent de nœuds et les appels constituent des arêtes. Un article technique publié par freeCodeCamp détaille comment les développeurs peuvent s'appuyer sur TypeScript et les API de langage internes de VS Code pour générer automatiquement des graphes de code multi-niveaux.

Exploiter l'intelligence des serveurs de langage

Plutôt que d'écrire des analyseurs syntaxiques personnalisés pour chaque langage de programmation, les développeurs peuvent extraire des informations sémantiques riches directement depuis l'infrastructure d'extensions de VS Code. En utilisant des fournisseurs de commandes tels que executeDocumentSymbolProvider et prepareCallHierarchy, des extensions sur mesure peuvent interroger des serveurs de langage comme le service natif de TypeScript, gopls pour Go ou Pyright pour Python. Cette approche décharge la résolution de symboles multi-fichiers et le suivi des importations sur la couche d'intelligence déjà présente dans l'éditeur.

Identification stable et déduplication

Afin de construire un graphe d'appels précis à travers des bases de code complexes, le nom des fonctions ne suffit pas en raison des risques de collision entre différents fichiers. L'architecture présentée associe les URI de fichiers et les positions de départ — plus précisément les propriétés selectionRange — pour dériver des identifiants de symboles stables. Un registre unifié de symboles suit les appels entrants et sortants pour dédupliquer les références, garantissant que les fonctions importées dans plusieurs fichiers soient regroupées en nœuds logiques uniques au sein du rendu visuel.

Parcours BFS et contrôle de la concurrence

Explorer des relations d'appels multi-niveaux nécessite de parcourir méthodiquement les appels entrants et sortants à partir d'un fichier ou d'un symbole actif. L'utilisation d'un algorithme de parcours en largeur (BFS) permet au moteur de graphe de découvrir les dépendances niveau par niveau jusqu'à une limite de profondeur définie. Dans la mesure où l'interrogation des serveurs de langage implique des appels d'extension asynchrones, le contrôle des limites d'exécution via des files d'attente d'opérations concurrentes évite les goulots d'étranglement de performance lors de l'exploration de graphes profonds.

Illustration éditoriale générée par IA ; ce n’est pas une photographie documentaire.

Source: How to Build a Code Graph in TypeScript Using VS Code's Language APIs