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» — це допомагає з’ясувати, яку конфігурацію було розв’язано і скільки словників знайдено.