Servidor LSP do Intlayer

O servidor de linguagem do Intlayer é uma implementação do Language Server Protocol (LSP) que torna o seu IDE — e o seu agente de IA — cientes do Intlayer. Ele conecta uma chamada como useIntlayer("home") ao arquivo .content.ts que a declara, nos dois sentidos.

Funcionalidades

Vale conhecer dois comportamentos adicionais:

• Dicionários mesclados — uma chave dividida entre vários arquivos de conteúdo retorna um resultado por arquivo, para que você possa navegar até cada declaração.
• Compatível com monorepo — o servidor resolve o intlayer.config.* mais próximo de cada arquivo, de modo que vários projetos em um mesmo workspace tenham seus próprios dicionários.

Chamadas suportadas

A chave é lida de um argumento posicional do tipo string ou de um objeto de opções ({ namespace }, { id }).

Isso funciona para todos os pacotes *-intlayer (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer) e para os pacotes adaptadores de compatibilidade que permitem manter a sua sintaxe de i18n atual.

Os dicionários são lidos da saída de build, então execute npx intlayer build — ou mantenha o seu servidor de desenvolvimento rodando — para dar ao servidor algo para resolver.

Instalação

O servidor é distribuído como o binário intlayer-lsp em @intlayer/lsp:

npm install --save-dev @intlayer/lsp

Instale-o globalmente (npm install -g @intlayer/lsp) se o seu editor precisar do intlayer-lsp no PATH — é o caso do plugin do Claude Code e de qualquer configuração abaixo que chame o binário diretamente.

Configuração

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 = {
      -- Iniciar o servidor com npx para dispensar uma instalação global
      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"]

Nota sobre agentes de IA em terminal

O Claude Code atua como um cliente LSP de verdade — veja a aba acima.

O OpenAI Codex e a maioria das outras ferramentas de terminal não são clientes LSP: elas leem e escrevem arquivos diretamente. Rodar o servidor sozinho não as ajuda; o valor vem de tê-lo ativo em um editor complementar cujo índice o agente possa consultar (Cursor Composer, Windsurf Cascade, Copilot Chat).

Como funciona

Para cada arquivo, o servidor localiza o intlayer.config.* mais próximo e carrega a configuração desse projeto para encontrar os dicionários compilados. Configuração, dicionários e a lista de arquivos-fonte são armazenados em cache com TTLs curtos e invalidados sempre que um arquivo de conteúdo monitorado muda.

A cada requisição, o servidor analisa o documento (via oxc) e inspeciona a posição do cursor:

1. Sobre uma string de chave (useIntlayer("home")) → retorna todos os arquivos de conteúdo que declaram essa chave, posicionados na sua linha key:.
2. Sobre o uso de um campo (content.title, uma propriedade desestruturada, t('path.to.field'), <Trans>, …) → resolve a variável de volta até o seu dicionário e retorna o campo correspondente dentro dos arquivos de conteúdo.
3. A partir de um arquivo de conteúdo → executa a busca inversa, varrendo os fontes do projeto em busca dos pontos de chamada dessa chave ou campo.

Solução de problemas

No VS Code, o servidor registra em Exibir → Saída → "Intlayer LSP" — útil para confirmar qual configuração foi resolvida e quantos dicionários foram encontrados.