Server LSP di Intlayer

Il language server di Intlayer è un'implementazione del Language Server Protocol (LSP) che rende il tuo IDE, e il tuo agente IA, consapevole di Intlayer. Collega una chiamata come useIntlayer("home") al file .content.ts che la dichiara, in entrambe le direzioni.

Funzionalità

Vale la pena conoscere due comportamenti aggiuntivi:

• Dizionari uniti: una chiave suddivisa su più file di contenuto restituisce un risultato per file, così puoi navigare a ogni dichiarazione.
• Compatibile con i monorepo: il server risolve l'intlayer.config.* più vicino a ciascun file, così più progetti in uno stesso workspace hanno ciascuno i propri dizionari.

Chiamate supportate

La chiave viene letta da un argomento posizionale di tipo stringa oppure da un oggetto di opzioni ({ namespace }, { id }).

Funziona per ogni pacchetto *-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 per i pacchetti adattatori compat che ti permettono di mantenere la sintassi i18n esistente.

I dizionari vengono letti dall'output di build: esegui npx intlayer build, o tieni attivo il server di sviluppo, per dare al server qualcosa da risolvere.

Installazione

Il server è distribuito come binario intlayer-lsp in @intlayer/lsp:

npm install --save-dev @intlayer/lsp

Installalo invece globalmente (npm install -g @intlayer/lsp) se il tuo editor richiede intlayer-lsp nel PATH, è il caso del plugin per Claude Code e di qualsiasi configurazione qui sotto che invochi direttamente il binario.

Configurazione

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 = {
      -- Avvia il server con npx per non richiedere un'installazione globale
      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 sugli agenti IA da terminale

Claude Code agisce come un vero client LSP, vedi la scheda sopra.

OpenAI Codex e la maggior parte degli altri strumenti da terminale non sono client LSP: leggono e scrivono i file direttamente. Eseguire il server da solo non li aiuta; il valore deriva dall'averlo attivo in un editor complementare il cui indice l'agente può interrogare (Cursor Composer, Windsurf Cascade, Copilot Chat).

Come funziona

Per ogni file, il server individua l'intlayer.config.* più vicino e carica la configurazione di quel progetto per trovare i dizionari compilati. Configurazione, dizionari ed elenco dei file sorgente sono memorizzati in cache con TTL brevi e invalidati ogni volta che cambia un file di contenuto monitorato.

A ogni richiesta, il server analizza il documento (tramite oxc) ed esamina la posizione del cursore:

1. Su una stringa chiave (useIntlayer("home")) → restituisce ogni file di contenuto che dichiara quella chiave, posizionato sulla sua riga key:.
2. Sull'uso di un campo (content.title, una proprietà destrutturata, t('path.to.field'), <Trans>, …) → risale dalla variabile al suo dizionario e restituisce il campo corrispondente all'interno dei file di contenuto.
3. Da un file di contenuto → esegue la ricerca inversa, scandendo i sorgenti del progetto alla ricerca dei punti di chiamata di quella chiave o di quel campo.

Risoluzione dei problemi

In VS Code il server scrive i log in Visualizza → Output → «Intlayer LSP», utile per confermare quale configurazione è stata risolta e quanti dizionari sono stati trovati.