Serveur LSP Intlayer

Le serveur de langage Intlayer est une implémentation du Language Server Protocol (LSP) qui rend votre EDI — et votre agent IA — conscient d'Intlayer. Il relie un appel comme useIntlayer("home") au fichier .content.ts qui le déclare, dans les deux sens.

Fonctionnalités

Deux comportements supplémentaires méritent d'être connus :

• Dictionnaires fusionnés — une clé répartie sur plusieurs fichiers de contenu renvoie un résultat par fichier, ce qui vous permet de naviguer vers chaque déclaration.
• Compatible monorepo — le serveur résout le fichier intlayer.config.* le plus proche de chaque fichier, afin que plusieurs projets dans un même espace de travail disposent chacun de leurs propres dictionnaires.

Appels pris en charge

La clé est lue soit depuis un argument positionnel de type chaîne, soit depuis un objet d'options ({ namespace }, { id }).

Cela fonctionne pour tous les packages *-intlayer (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer), ainsi que pour les packages d'adaptation compat qui vous permettent de conserver votre syntaxe i18n existante.

Les dictionnaires sont lus depuis la sortie de build : exécutez npx intlayer build — ou laissez votre serveur de développement tourner — pour donner au serveur quelque chose à résoudre.

Installation

Le serveur est distribué sous forme du binaire intlayer-lsp dans @intlayer/lsp :

npm install --save-dev @intlayer/lsp

Installez-le plutôt globalement (npm install -g @intlayer/lsp) si votre éditeur a besoin de intlayer-lsp dans le PATH — c'est le cas pour le plugin Claude Code et pour toute configuration ci-dessous qui appelle directement le binaire.

Configuration

npm install -g @intlayer/lsp

claude plugin marketplace add intlayer@github:aymericzip/intlayer
claude plugin install intlayer-lsp@intlayer

{
  "env": {
    "ENABLE_LSP_TOOL": "1"
  }
}

{
  "lsp": {
    "intlayer-lsp": {
      "binary": {
        "path": "npx",
        "arguments": ["--yes", "@intlayer/lsp"]
      }
    }
  },
  "languages": {
    "TypeScript": { "language_servers": ["intlayer-lsp", "..."] },
    "TSX": { "language_servers": ["intlayer-lsp", "..."] },
    "JavaScript": { "language_servers": ["intlayer-lsp", "..."] },
    "Vue.js": { "language_servers": ["intlayer-lsp", "..."] },
    "Svelte": { "language_servers": ["intlayer-lsp", "..."] }
  }
}

local lspconfig = require('lspconfig')
local configs = require('lspconfig.configs')

if not configs.intlayer_lsp then
  configs.intlayer_lsp = {
    default_config = {
      -- Lancer le serveur avec npx pour éviter une installation globale
      cmd = { 'npx', '--yes', '@intlayer/lsp' },
      filetypes = {
        'typescript',
        'typescriptreact',
        'javascript',
        'javascriptreact',
        'vue',
        'svelte',
      },
      root_dir = lspconfig.util.root_pattern(
        'intlayer.config.ts',
        'intlayer.config.js',
        'package.json'
      ),
    },
  }
end

lspconfig.intlayer_lsp.setup({})

{
  "languageserver": {
    "intlayer": {
      "command": "npx",
      "args": ["@intlayer/lsp"],
      "filetypes": [
        "typescript",
        "typescriptreact",
        "javascript",
        "javascriptreact",
        "vue",
        "svelte"
      ],
      "rootPatterns": [
        "intlayer.config.ts",
        "intlayer.config.js",
        "package.json"
      ]
    }
  }
}

[language-server.intlayer-lsp]
command = "npx"
args = ["@intlayer/lsp"]

[[language]]
name = "typescript"
language-servers = ["intlayer-lsp", "typescript-language-server"]

[[language]]
name = "tsx"
language-servers = ["intlayer-lsp", "typescript-language-server"]

Remarque sur les agents IA en terminal

Claude Code agit comme un véritable client LSP — voir l'onglet ci-dessus.

OpenAI Codex et la plupart des autres outils en terminal ne sont pas des clients LSP : ils lisent et écrivent les fichiers directement. Lancer le serveur seul ne les aide pas ; l'intérêt vient de son activation dans un éditeur compagnon dont l'agent peut interroger l'index (Cursor Composer, Windsurf Cascade, Copilot Chat).

Fonctionnement

Pour chaque fichier, le serveur localise le fichier intlayer.config.* le plus proche et charge la configuration de ce projet afin de trouver les dictionnaires compilés. La configuration, les dictionnaires et la liste des fichiers sources sont mis en cache avec de courtes durées de vie, et invalidés dès qu'un fichier de contenu surveillé change.

Lors d'une requête, le serveur analyse le document (via oxc) et examine la position du curseur :

1. Sur une chaîne de clé (useIntlayer("home")) → renvoie tous les fichiers de contenu déclarant cette clé, positionnés sur leur ligne key:.
2. Sur l'utilisation d'un champ (content.title, une propriété déstructurée, t('path.to.field'), <Trans>, …) → remonte la variable jusqu'à son dictionnaire et renvoie le champ correspondant dans les fichiers de contenu.
3. Depuis un fichier de contenu → effectue la recherche inverse, en parcourant les sources du projet à la recherche des sites d'appel de cette clé ou de ce champ.

Dépannage

Dans VS Code, le serveur écrit ses journaux dans Affichage → Sortie → « Intlayer LSP » — utile pour confirmer quelle configuration a été résolue et combien de dictionnaires ont été trouvés.