Serwer LSP Intlayer

Serwer języka Intlayer to implementacja Language Server Protocol (LSP), która sprawia, że Twoje IDE — i Twój agent AI — rozumieją Intlayer. Łączy wywołanie takie jak useIntlayer("home") z plikiem .content.ts, który je deklaruje, w obie strony.

Funkcje

Warto znać dwa dodatkowe zachowania:

• Scalone słowniki — klucz podzielony na kilka plików treści zwraca jeden wynik na plik, dzięki czemu możesz przejść do każdej deklaracji.
• Obsługa monorepo — serwer rozwiązuje najbliższy każdemu plikowi intlayer.config.*, dzięki czemu wiele projektów w jednym obszarze roboczym ma własne słowniki.

Obsługiwane wywołania

Klucz jest odczytywany albo z pozycyjnego argumentu tekstowego, albo z obiektu opcji ({ namespace }, { id }).

Działa to dla każdego pakietu *-intlayer (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer) oraz dla pakietów adapterów compat, które pozwalają zachować dotychczasową składnię i18n.

Słowniki są odczytywane z wyniku budowania, więc uruchom npx intlayer build — albo pozostaw działający serwer deweloperski — aby serwer miał co rozwiązywać.

Instalacja

Serwer jest dostarczany jako binarium intlayer-lsp w pakiecie @intlayer/lsp:

npm install --save-dev @intlayer/lsp

Zainstaluj go globalnie (npm install -g @intlayer/lsp), jeśli Twój edytor wymaga intlayer-lsp w PATH — dotyczy to wtyczki Claude Code oraz każdej poniższej konfiguracji wywołującej binarium bezpośrednio.

Konfiguracja

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 = {
      -- Uruchom serwer przez npx, aby nie wymagać instalacji globalnej
      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"]

Uwaga o agentach AI w terminalu

Claude Code działa jako prawdziwy klient LSP — zobacz zakładkę powyżej.

OpenAI Codex i większość innych narzędzi terminalowych nie są klientami LSP: czytają i zapisują pliki bezpośrednio. Samo uruchomienie serwera im nie pomoże; wartość pojawia się, gdy jest aktywny w towarzyszącym edytorze, którego indeks agent może odpytać (Cursor Composer, Windsurf Cascade, Copilot Chat).

Jak to działa

Dla każdego pliku serwer lokalizuje najbliższy intlayer.config.* i wczytuje konfigurację tego projektu, aby znaleźć skompilowane słowniki. Konfiguracja, słowniki i lista plików źródłowych są buforowane z krótkim TTL i unieważniane, gdy zmieni się obserwowany plik treści.

Przy żądaniu serwer parsuje dokument (przez oxc) i bada pozycję kursora:

1. Na ciągu klucza (useIntlayer("home")) → zwraca każdy plik treści deklarujący ten klucz, ustawiony na jego linii key:.
2. Na użyciu pola (content.title, zdestrukturyzowana właściwość, t('path.to.field'), <Trans>, …) → sprowadza zmienną z powrotem do jej słownika i zwraca pasujące pole w plikach treści.
3. Z pliku treści → wykonuje wyszukiwanie odwrotne, przeszukując źródła projektu w poszukiwaniu miejsc wywołania tego klucza lub pola.

Rozwiązywanie problemów

W VS Code serwer zapisuje logi w Widok → Dane wyjściowe → „Intlayer LSP” — przydatne, by potwierdzić, która konfiguracja została rozwiązana i ile słowników znaleziono.