Intlayer LSP-Server

Der Intlayer Language Server ist eine Implementierung des Language Server Protocol (LSP), die Ihre IDE — und Ihren KI-Agenten — Intlayer-fähig macht. Er verbindet einen Aufruf wie useIntlayer("home") mit der .content.ts-Datei, die ihn deklariert, und zwar in beide Richtungen.

Funktionen

Zwei weitere Verhaltensweisen sind erwähnenswert:

• Zusammengeführte Wörterbücher — ein über mehrere Inhaltsdateien verteilter Schlüssel liefert ein Ergebnis pro Datei, sodass Sie zu jeder Deklaration navigieren können.
• Monorepo-fähig — der Server ermittelt die zu jeder Datei nächstgelegene intlayer.config.*, sodass mehrere Projekte in einem Arbeitsbereich jeweils eigene Wörterbücher erhalten.

Unterstützte Aufrufe

Der Schlüssel wird entweder aus einem positionellen String-Argument oder aus einem Optionsobjekt ({ namespace }, { id }) gelesen.

Das funktioniert für jedes *-intlayer-Paket (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer) sowie für die Compat-Adapter-Pakete, mit denen Sie Ihre bestehende i18n-Syntax beibehalten können.

Wörterbücher werden aus der Build-Ausgabe gelesen — führen Sie also npx intlayer build aus oder lassen Sie Ihren Dev-Server laufen, damit der Server etwas auflösen kann.

Installation

Der Server wird als intlayer-lsp-Binary in @intlayer/lsp ausgeliefert:

npm install --save-dev @intlayer/lsp

Installieren Sie ihn stattdessen global (npm install -g @intlayer/lsp), wenn Ihr Editor intlayer-lsp im PATH benötigt — das gilt für das Claude-Code-Plugin und für jede der folgenden Konfigurationen, die das Binary direkt aufruft.

Einrichtung

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 = {
      -- Server mit npx starten, damit keine globale Installation nötig ist
      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"]

Hinweis zu KI-Agenten im Terminal

Claude Code agiert als echter LSP-Client — siehe den Tab oben.

OpenAI Codex und die meisten anderen Terminal-Tools sind keine LSP-Clients: Sie lesen und schreiben Dateien direkt. Den Server allein laufen zu lassen hilft ihnen nicht; der Nutzen entsteht, wenn er in einem begleitenden Editor aktiv ist, dessen Index der Agent abfragen kann (Cursor Composer, Windsurf Cascade, Copilot Chat).

Funktionsweise

Für jede Datei sucht der Server die nächstgelegene intlayer.config.* und lädt die Konfiguration dieses Projekts, um die kompilierten Wörterbücher zu finden. Konfiguration, Wörterbücher und die Liste der Quelldateien werden mit kurzen TTLs zwischengespeichert und invalidiert, sobald sich eine überwachte Inhaltsdatei ändert.

Bei einer Anfrage parst der Server das Dokument (via oxc) und untersucht die Cursorposition:

1. Auf einem Schlüssel-String (useIntlayer("home")) → liefert jede Inhaltsdatei, die diesen Schlüssel deklariert, positioniert auf deren key:-Zeile.
2. Auf einer Feldverwendung (content.title, eine destrukturierte Eigenschaft, t('path.to.field'), <Trans>, …) → löst die Variable zurück zu ihrem Wörterbuch auf und liefert das passende Feld innerhalb der Inhaltsdateien.
3. Aus einer Inhaltsdatei heraus → führt die umgekehrte Suche aus und durchsucht die Projektquellen nach Aufrufstellen dieses Schlüssels oder Feldes.

Fehlerbehebung

In VS Code protokolliert der Server unter Ansicht → Ausgabe → „Intlayer LSP“ — nützlich, um zu prüfen, welche Konfiguration aufgelöst und wie viele Wörterbücher gefunden wurden.