Intlayer LSP Sunucusu

Intlayer dil sunucusu, IDE’nizi — ve yapay zekâ ajanınızı — Intlayer’dan haberdar kılan bir Language Server Protocol (LSP) uygulamasıdır. useIntlayer("home") gibi bir çağrıyı, onu bildiren .content.ts dosyasına iki yönlü olarak bağlar.

Özellikler

Bilinmeye değer iki ek davranış vardır:

• Birleştirilmiş sözlükler — birkaç içerik dosyasına bölünmüş bir anahtar, dosya başına bir sonuç döndürür; böylece her bildirime gidebilirsiniz.
• Monorepo uyumlu — sunucu her dosyaya en yakın intlayer.config.* dosyasını çözer; böylece tek bir çalışma alanındaki birden çok proje kendi sözlüklerine sahip olur.

Desteklenen çağrılar

Anahtar, konumsal bir dize argümanından ya da bir seçenekler nesnesinden ({ namespace }, { id }) okunur.

Bu, tüm *-intlayer paketleri (next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer, solid-intlayer, preact-intlayer, angular-intlayer, lit-intlayer, express-intlayer, hono-intlayer, fastify-intlayer, intlayer) ve mevcut i18n sözdiziminizi korumanızı sağlayan compat adaptör paketleri için çalışır.

Sözlükler derleme çıktısından okunur; bu nedenle sunucunun çözecek bir şeyi olması için npx intlayer build çalıştırın veya geliştirme sunucunuzu açık tutun.

Kurulum

Sunucu, @intlayer/lsp içinde intlayer-lsp ikili dosyası olarak dağıtılır:

npm install --save-dev @intlayer/lsp

Editörünüz intlayer-lsp komutunu PATH üzerinde arıyorsa bunun yerine küresel olarak kurun (npm install -g @intlayer/lsp) — Claude Code eklentisi ve aşağıdaki ikili dosyayı doğrudan çağıran her yapılandırma için durum budur.

Kurulum ve yapılandırma

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 = {
      -- Küresel kuruluma gerek kalmaması için sunucuyu npx ile başlatın
      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"]

Terminal yapay zekâ ajanları hakkında not

Claude Code gerçek bir LSP istemcisi gibi davranır — yukarıdaki sekmeye bakın.

OpenAI Codex ve diğer terminal araçlarının çoğu LSP istemcisi değildir: dosyaları doğrudan okur ve yazarlar. Sunucuyu tek başına çalıştırmak onlara yardımcı olmaz; asıl fayda, ajanın dizinini sorgulayabildiği bir yardımcı editörde (Cursor Composer, Windsurf Cascade, Copilot Chat) etkin olmasından gelir.

Nasıl çalışır

Sunucu her dosya için en yakın intlayer.config.* dosyasını bulur ve derlenmiş sözlükleri bulmak üzere o projenin yapılandırmasını yükler. Yapılandırma, sözlükler ve kaynak dosya listesi kısa TTL’lerle önbelleğe alınır ve izlenen bir içerik dosyası değiştiğinde geçersiz kılınır.

Bir istek geldiğinde sunucu belgeyi (oxc ile) ayrıştırır ve imleç konumunu inceler:

1. Bir anahtar dizesi üzerinde (useIntlayer("home")) → o anahtarı bildiren her içerik dosyasını, key: satırına konumlanmış olarak döndürür.
2. Bir alan kullanımı üzerinde (content.title, yapı bozumuyla alınmış bir özellik, t('path.to.field'), <Trans>, …) → değişkeni sözlüğüne kadar çözer ve içerik dosyalarındaki eşleşen alanı döndürür.
3. Bir içerik dosyasından → ters aramayı çalıştırır ve proje kaynaklarını o anahtarın veya alanın çağrı noktaları için tarar.

Sorun giderme

VS Code’da sunucu Görünüm → Çıktı → “Intlayer LSP” altına log yazar — hangi yapılandırmanın çözüldüğünü ve kaç sözlük bulunduğunu doğrulamak için kullanışlıdır.