Server LSP Intlayer

Language server Intlayer adalah implementasi Language Server Protocol (LSP) yang membuat IDE — dan agen AI — Anda memahami Intlayer. Ia menghubungkan pemanggilan seperti useIntlayer("home") dengan berkas .content.ts yang mendeklarasikannya, dua arah.

Fitur

Ada dua perilaku tambahan yang perlu diketahui:

• Kamus tergabung — kunci yang terbagi di beberapa berkas konten mengembalikan satu hasil per berkas, sehingga Anda dapat menuju setiap deklarasi.
• Ramah monorepo — server menyelesaikan intlayer.config.* yang terdekat dengan setiap berkas, sehingga beberapa proyek dalam satu workspace masing-masing memiliki kamusnya sendiri.

Pemanggilan yang didukung

Kunci dibaca dari argumen string posisional atau dari objek opsi ({ namespace }, { id }).

Ini berlaku untuk semua paket *-intlayer (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer), serta untuk paket adapter compat yang memungkinkan Anda mempertahankan sintaks i18n yang sudah ada.

Kamus dibaca dari hasil build, jadi jalankan npx intlayer build — atau biarkan dev server tetap berjalan — agar server punya sesuatu untuk diselesaikan.

Instalasi

Server didistribusikan sebagai biner intlayer-lsp di dalam @intlayer/lsp:

npm install --save-dev @intlayer/lsp

Pasang secara global (npm install -g @intlayer/lsp) bila editor Anda membutuhkan intlayer-lsp di PATH — ini berlaku untuk plugin Claude Code dan untuk setiap konfigurasi di bawah yang memanggil biner secara langsung.

Penyiapan

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 = {
      -- Jalankan server dengan npx agar tidak perlu instalasi 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"]

Catatan tentang agen AI di terminal

Claude Code bertindak sebagai klien LSP sungguhan — lihat tab di atas.

OpenAI Codex dan sebagian besar alat terminal lain bukan klien LSP: mereka membaca dan menulis berkas secara langsung. Menjalankan server sendirian tidak membantu mereka; manfaatnya muncul saat server aktif di editor pendamping yang indeksnya bisa dikueri oleh agen (Cursor Composer, Windsurf Cascade, Copilot Chat).

Cara kerjanya

Untuk setiap berkas, server mencari intlayer.config.* terdekat dan memuat konfigurasi proyek tersebut guna menemukan kamus hasil kompilasi. Konfigurasi, kamus, dan daftar berkas sumber di-cache dengan TTL singkat, dan dibatalkan setiap kali berkas konten yang dipantau berubah.

Pada setiap permintaan, server mem-parsing dokumen (via oxc) dan memeriksa posisi kursor:

1. Pada string kunci (useIntlayer("home")) → mengembalikan setiap berkas konten yang mendeklarasikan kunci itu, diposisikan pada baris key:-nya.
2. Pada penggunaan field (content.title, properti hasil destrukturisasi, t('path.to.field'), <Trans>, …) → menelusuri variabel kembali ke kamusnya dan mengembalikan field yang cocok di dalam berkas konten.
3. Dari berkas konten → menjalankan pencarian balik, memindai sumber proyek untuk menemukan lokasi pemanggilan kunci atau field tersebut.

Pemecahan masalah

Di VS Code, server menulis log ke View → Output → "Intlayer LSP" — berguna untuk memastikan konfigurasi mana yang terselesaikan dan berapa kamus yang ditemukan.