Servidor LSP de Intlayer

El servidor de lenguaje de Intlayer es una implementación del Language Server Protocol (LSP) que hace que su IDE — y su agente de IA — reconozcan Intlayer. Conecta una llamada como useIntlayer("home") con el archivo .content.ts que la declara, en ambas direcciones.

Funcionalidades

Merece la pena conocer dos comportamientos adicionales:

• Diccionarios fusionados — una clave repartida entre varios archivos de contenido devuelve un resultado por archivo, de modo que puede navegar a cada declaración.
• Compatible con monorepos — el servidor resuelve el intlayer.config.* más cercano a cada archivo, de modo que varios proyectos en un mismo espacio de trabajo tienen cada uno sus propios diccionarios.

Llamadas compatibles

La clave se lee bien desde un argumento posicional de tipo cadena, bien desde un objeto de opciones ({ namespace }, { id }).

Esto funciona con todos los paquetes *-intlayer (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer), y con los paquetes adaptadores de compatibilidad que le permiten conservar su sintaxis i18n actual.

Los diccionarios se leen de la salida de compilación, así que ejecute npx intlayer build — o mantenga su servidor de desarrollo en marcha — para darle al servidor algo que resolver.

Instalación

El servidor se distribuye como el binario intlayer-lsp dentro de @intlayer/lsp:

npm install --save-dev @intlayer/lsp

Instálelo globalmente (npm install -g @intlayer/lsp) si su editor necesita intlayer-lsp en el PATH — es el caso del plugin de Claude Code y de cualquier configuración de abajo que invoque el binario directamente.

Configuración

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 el servidor con npx para no necesitar una instalación 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 los agentes de IA en terminal

Claude Code actúa como un cliente LSP real — vea la pestaña anterior.

OpenAI Codex y la mayoría de las demás herramientas de terminal no son clientes LSP: leen y escriben archivos directamente. Ejecutar el servidor por sí solo no les ayuda; el valor viene de tenerlo activo en un editor acompañante cuyo índice el agente pueda consultar (Cursor Composer, Windsurf Cascade, Copilot Chat).

Cómo funciona

Para cada archivo, el servidor localiza el intlayer.config.* más cercano y carga la configuración de ese proyecto para encontrar los diccionarios compilados. La configuración, los diccionarios y la lista de archivos fuente se cachean con TTL cortos, y se invalidan cuando cambia un archivo de contenido vigilado.

En cada petición, el servidor analiza el documento (mediante oxc) e inspecciona la posición del cursor:

1. Sobre una cadena de clave (useIntlayer("home")) → devuelve todos los archivos de contenido que declaran esa clave, situados en su línea key:.
2. Sobre el uso de un campo (content.title, una propiedad desestructurada, t('path.to.field'), <Trans>, …) → resuelve la variable hasta su diccionario y devuelve el campo correspondiente dentro de los archivos de contenido.
3. Desde un archivo de contenido → ejecuta la búsqueda inversa, recorriendo las fuentes del proyecto en busca de los puntos de llamada de esa clave o campo.

Solución de problemas

En VS Code, el servidor registra en Ver → Salida → «Intlayer LSP» — útil para confirmar qué configuración se resolvió y cuántos diccionarios se encontraron.