خادم LSP الخاص بـ Intlayer

خادم اللغة الخاص بـ Intlayer هو تنفيذ لـ Language Server Protocol (LSP) يجعل محرّرك — ووكيل الذكاء الاصطناعي لديك — على دراية بـ Intlayer. فهو يربط استدعاءً مثل useIntlayer("home") بملف .content.ts الذي يصرّح عنه، في الاتجاهين معًا.

المزايا

هناك سلوكان إضافيان يستحقان المعرفة:

• القواميس المدمجة — المفتاح الموزّع على عدة ملفات محتوى يُعيد نتيجة واحدة لكل ملف، بحيث يمكنك الانتقال إلى كل تصريح.
• متوافق مع المستودعات الأحادية — يحدّد الخادم ملف intlayer.config.* الأقرب إلى كل ملف، بحيث يحصل كل مشروع ضمن مساحة العمل نفسها على قواميسه الخاصة.

الاستدعاءات المدعومة

يُقرأ المفتاح إمّا من وسيط نصّي موضعي أو من كائن خيارات ({ namespace }، { id }).

يعمل هذا مع كل حزم *-intlayer (next-intlayer، react-intlayer، vue-intlayer، svelte-intlayer، solid-intlayer، preact-intlayer، angular-intlayer، lit-intlayer، express-intlayer، hono-intlayer، fastify-intlayer، intlayer)، ومع حزم المحوّلات التوافقية التي تتيح لك الإبقاء على صياغة i18n الحالية لديك.

تُقرأ القواميس من ناتج البناء، لذا شغّل npx intlayer build — أو أبقِ خادم التطوير قيد التشغيل — كي يجد الخادم ما يحلّه.

التثبيت

يُوزَّع الخادم بوصفه الملف التنفيذي intlayer-lsp ضمن @intlayer/lsp:

npm install --save-dev @intlayer/lsp

ثبّته عالميًا بدلًا من ذلك (npm install -g @intlayer/lsp) إذا كان محرّرك يحتاج إلى intlayer-lsp ضمن PATH — وهذا ينطبق على إضافة Claude Code وعلى أي إعداد أدناه يستدعي الملف التنفيذي مباشرة.

الإعداد

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 = {
      -- شغّل الخادم عبر npx لتفادي الحاجة إلى تثبيت عالمي
      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"]

ملاحظة حول وكلاء الذكاء الاصطناعي في الطرفية

Claude Code يعمل كعميل LSP حقيقي — انظر التبويب أعلاه.

OpenAI Codex ومعظم أدوات الطرفية الأخرى ليست عملاء LSP: فهي تقرأ الملفات وتكتبها مباشرة. تشغيل الخادم وحده لا يفيدها؛ إنما تأتي الفائدة من كونه نشطًا في محرّر مرافق يستطيع الوكيل الاستعلام عن فهرسه (Cursor Composer، Windsurf Cascade، Copilot Chat).

آلية العمل

لكل ملف، يحدّد الخادم أقرب ملف intlayer.config.* ويحمّل إعدادات ذلك المشروع للعثور على القواميس المُصرَّفة. وتُخزَّن الإعدادات والقواميس وقائمة الملفات المصدرية مؤقتًا بمُدد صلاحية قصيرة، ويُبطَل التخزين كلما تغيّر ملف محتوى مُراقَب.

عند كل طلب، يحلّل الخادم المستند (عبر oxc) ويفحص موضع المؤشر:

1. فوق نص المفتاح (useIntlayer("home")) ← يُعيد كل ملف محتوى يصرّح بذلك المفتاح، مع التموضع عند سطر key: الخاص به.
2. فوق موضع استخدام حقل (content.title، أو خاصية مُفكَّكة، أو t('path.to.field')، أو <Trans>، …) ← يتتبّع المتغيّر رجوعًا إلى قاموسه ويُعيد الحقل المطابق داخل ملفات المحتوى.
3. انطلاقًا من ملف محتوى ← ينفّذ البحث العكسي، فيمسح مصادر المشروع بحثًا عن مواضع استدعاء ذلك المفتاح أو الحقل.

استكشاف الأخطاء وإصلاحها

في VS Code، يسجّل الخادم مخرجاته في عرض ← الإخراج ← «Intlayer LSP» — وهو مفيد لتأكيد أي إعداد جرى تحليله وكم قاموسًا عُثر عليه.