LSP-сервер Intlayer

Языковой сервер Intlayer — это реализация Language Server Protocol (LSP), которая делает вашу IDE — и вашего ИИ-агента — осведомлёнными об Intlayer. Он связывает вызов вида useIntlayer("home") с файлом .content.ts, который его объявляет, в обоих направлениях.

Возможности

Стоит знать ещё о двух особенностях:

• Объединённые словари — ключ, разделённый между несколькими файлами контента, возвращает по одному результату на файл, поэтому вы можете перейти к каждому объявлению.
• Поддержка монорепозиториев — сервер находит ближайший к каждому файлу intlayer.config.*, поэтому несколько проектов в одном рабочем пространстве получают собственные словари.

Поддерживаемые вызовы

Ключ считывается либо из позиционного строкового аргумента, либо из объекта опций ({ namespace }, { id }).

Это работает для каждого пакета *-intlayer (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer), а также для пакетов-адаптеров совместимости, позволяющих сохранить существующий синтаксис i18n.

Словари читаются из результата сборки, поэтому выполните npx intlayer build — или держите dev-сервер запущенным — чтобы серверу было что разрешать.

Установка

Сервер поставляется как бинарный файл intlayer-lsp в составе @intlayer/lsp:

npm install --save-dev @intlayer/lsp

Установите его глобально (npm install -g @intlayer/lsp), если вашему редактору нужен intlayer-lsp в PATH — это относится к плагину Claude Code и к любой конфигурации ниже, которая вызывает бинарный файл напрямую.

Настройка

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 = {
      -- Запускать сервер через npx, чтобы не требовалась глобальная установка
      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"]

Примечание об ИИ-агентах в терминале

Claude Code работает как полноценный LSP-клиент — см. вкладку выше.

OpenAI Codex и большинство других терминальных инструментов не являются LSP-клиентами: они читают и пишут файлы напрямую. Запуск сервера сам по себе им не поможет; польза появляется, когда он активен в сопутствующем редакторе, чей индекс агент может запрашивать (Cursor Composer, Windsurf Cascade, Copilot Chat).

Как это работает

Для каждого файла сервер находит ближайший intlayer.config.* и загружает конфигурацию этого проекта, чтобы найти скомпилированные словари. Конфигурация, словари и список исходных файлов кешируются с коротким TTL и сбрасываются при изменении отслеживаемого файла контента.

При запросе сервер разбирает документ (через oxc) и анализирует позицию курсора:

1. На строке ключа (useIntlayer("home")) → возвращает каждый файл контента, объявляющий этот ключ, с позицией на строке key:.
2. На использовании поля (content.title, деструктурированное свойство, t('path.to.field'), <Trans>, …) → возводит переменную обратно к её словарю и возвращает соответствующее поле внутри файлов контента.
3. Из файла контента → выполняет обратный поиск, просматривая исходники проекта в поисках мест вызова этого ключа или поля.

Устранение неполадок

В VS Code сервер пишет логи в Вид → Вывод → «Intlayer LSP» — это помогает убедиться, какая конфигурация была разрешена и сколько словарей найдено.