@intlayer/docs 8.11.1 → 8.11.3

package/docs/ar/introduction.md

@@ -2,7 +2,7 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: مقدمة
-description: اكتشف كيف يعمل Intlayer. شاهد الخطوات التي يستخدمها Intlayer في تطبيقك. تعرف على ما تفعله الحزم المختلفة.
+description: اكتشف كيف يعمل Intlayer. تعرف على الخطوات التي يستخدمها Intlayer في تطبيقك. اكتشف ما تفعله الحزم المختلفة.
 keywords:
   - مقدمة
   - البدء
@@ -15,20 +15,20 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: "بداية التاريخ"
+    changes: "Init history"
 ---
 
 # توثيق Intlayer
 
-مرحبًا بك في التوثيق الرسمي لـ Intlayer! هنا، ستجد كل ما تحتاجه لدمج وتكوين وإتقان Intlayer لجميع احتياجات التدويل (i18n) الخاصة بك، سواء كنت تعمل مع Next.js أو React أو Vite أو Express أو بيئة جافاسكريبت أخرى.
+مرحبًا بك في التوثيق الرسمي لـ Intlayer! هنا، ستجد كل ما تحتاجه لدمج وتكوين وإتقان Intlayer لجميع احتياجات التدويل (i18n) الخاصة بك، سواء كنت تعمل مع Next.js، أو React، أو Vite، أو Express، أو أي بيئة JavaScript أخرى.
 
 ## مقدمة
 
 ### ما هو Intlayer؟
 
-**Intlayer** هي مكتبة تدويل مصممة خصيصًا لمطوري جافاسكريبت. تتيح لك الإعلان عن المحتوى الخاص بك في أي مكان داخل الكود الخاص بك. تقوم بتحويل إعلان المحتوى متعدد اللغات إلى قواميس منظمة لتسهيل دمجها في كودك. باستخدام TypeScript، تجعل **Intlayer** تطويرك أقوى وأكثر كفاءة.
+**Intlayer** هي مكتبة تدويل مصممة خصيصًا لمطوري JavaScript. تتيح لك الإعلان عن المحتوى الخاص بك في أي مكان في الكود الخاص بك. تقوم بتحويل إعلانات المحتوى متعدد اللغات إلى قواميس منظمة يسهل دمجها في الكود الخاص بك. باستخدام TypeScript، تجعل **Intlayer** تطويرك أكثر قوة وكفاءة.
 
-كما توفر Intlayer محررًا بصريًا اختياريًا يتيح لك تحرير وإدارة المحتوى الخاص بك بسهولة. هذا المحرر مفيد بشكل خاص للمطورين الذين يفضلون واجهة بصرية لإدارة المحتوى، أو للفرق التي تقوم بإنشاء المحتوى دون الحاجة للقلق بشأن الكود.
+توفر Intlayer أيضًا محررًا مرئيًا اختياريًا يتيح لك تعديل المحتوى الخاص بك وإدارته بسهولة. هذا المحرر مفيد بشكل خاص للمطورين الذين يفضلون واجهة مرئية لإدارة المحتوى، أو للفرق التي تقوم بإنشاء المحتوى دون الحاجة إلى القلق بشأن الكود.
 
 ### مثال على الاستخدام
 
@@ -50,6 +50,7 @@ const componentContent = {
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      ar: "مرحبا بالعالم",
     }),
   },
 } satisfies Dictionary;
@@ -67,7 +68,8 @@ export default componentContent;
       "translation": {
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "ar": "مرحبا بالعالم"
       }
     }
   }
@@ -87,65 +89,102 @@ export const MyComponent: FC = () => {
 
 ## الميزات الرئيسية
 
-يقدم Intlayer مجموعة متنوعة من الميزات المصممة لتلبية احتياجات تطوير الويب الحديث. فيما يلي الميزات الرئيسية، مع روابط إلى الوثائق التفصيلية لكل منها:
+تقدم Intlayer مجموعة متنوعة من الميزات المصممة لتلبية احتياجات تطوير الويب الحديث. فيما يلي الميزات الرئيسية، مع روابط لتوثيق مفصل لكل منها:
 
-- **دعم التدويل**: عزز الوصول العالمي لتطبيقك من خلال دعم مدمج للتدويل.
-- **المحرر المرئي**: حسّن سير عمل التطوير الخاص بك باستخدام إضافات المحرر المصممة لـ Intlayer. اطلع على [دليل المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).
-- **مرونة التكوين**: قم بتخصيص إعداداتك باستخدام خيارات تكوين واسعة مفصلة في [دليل التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
-- **أدوات CLI المتقدمة**: قم بإدارة مشاريعك بكفاءة باستخدام واجهة سطر الأوامر الخاصة بـ Intlayer. استكشف الإمكانيات في [توثيق أدوات CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/index.md).
+- **دعم التدويل**: عزز الوصول العالمي لتطبيقك مع دعم مدمج للتدويل.
+- **المحرر المرئي**: قم بتحسين سير عمل التطوير الخاص بك باستخدام إضافات المحرر المصممة لـ Intlayer. تحقق من [دليل المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).
+- **مرونة التكوين**: قم بتخصيص إعداداتك بخيارات تكوين شاملة ومفصلة في [دليل التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
+- **أدوات CLI المتقدمة**: أدر مشاريعك بكفاءة باستخدام واجهة سطر الأوامر الخاصة بـ Intlayer. استكشف الإمكانيات في [توثيق أدوات CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/index.md).
 
 ## المفاهيم الأساسية
 
-### القاموس
+### القاموس (Dictionary)
 
-نظم محتواك متعدد اللغات بالقرب من الكود الخاص بك للحفاظ على كل شيء متسقًا وقابلًا للصيانة.
+قم بتنظيم المحتوى متعدد اللغات الخاص بك بالقرب من الكود للحفاظ على تناسق كل شيء وسهولة صيانته.
 
 - **[البدء](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md)**  
-  تعلّم أساسيات إعلان المحتوى الخاص بك في Intlayer.
+  تعلم أساسيات إعلان المحتوى الخاص بك في Intlayer.
 
-- **[الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md)**  
+- **[الترجمة (Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md)**  
   افهم كيف يتم إنشاء الترجمات وتخزينها واستخدامها في تطبيقك.
 
-- **[التعداد](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/enumeration.md)**  
-  قم بإدارة مجموعات البيانات المتكررة أو الثابتة بسهولة عبر لغات متعددة.
+- **[التعداد (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/enumeration.md)**  
+  قم بإدارة مجموعات البيانات المتكررة أو الثابتة بسهولة عبر لغات مختلفة.
 
-- **[الشرط](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/condition.md)**  
-  تعلّم كيفية استخدام المنطق الشرطي في Intlayer لإنشاء محتوى ديناميكي.
+- **[الشرط (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/condition.md)**  
+  تعلم كيفية استخدام المنطق الشرطي في Intlayer لإنشاء محتوى ديناميكي.
 
-- **[الإدراج](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/insertion.md)**  
-  اكتشف كيفية إدراج القيم في سلسلة نصية باستخدام عناصر نائبة للإدراج.
+- **[الإدراج (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/insertion.md)**  
+  اكتشف كيفية إدراج القيم في سلسلة نصية باستخدام العناصر النائبة (placeholders).
 
-- **[جلب الدوال](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/function_fetching.md)**  
+- **[جلب الدوال (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/function_fetching.md)**  
   تعرف على كيفية جلب المحتوى ديناميكيًا باستخدام منطق مخصص ليتناسب مع سير عمل مشروعك.
 
-- **[ماركداون](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/markdown.md)**  
-  تعلّم كيفية استخدام ماركداون في Intlayer لإنشاء محتوى غني.
+- **[ماركداون (Markdown)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/markdown.md)**  
+  تعلم كيفية استخدام Markdown في Intlayer لإنشاء محتوى غني.
 
-- **[تضمين الملفات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/file.md)**  
-  اكتشف كيفية تضمين ملفات خارجية في Intlayer لاستخدامها في محرر المحتوى.
+- **[تضمين الملفات (File Embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/file.md)**  
+  اكتشف كيفية تضمين الملفات الخارجية في Intlayer لاستخدامها في محرر المحتوى.
 
-- **[التداخل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/nesting.md)**  
-  فهم كيفية تداخل المحتوى في Intlayer لإنشاء هياكل معقدة.
+- **[التداخل (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/nesting.md)**  
+  افهم كيفية تداخل المحتوى في Intlayer لإنشاء هياكل معقدة.
 
-### البيئات والتكاملات
+### البيئات والتكاملات (Environments & Integrations)
 
-لقد قمنا ببناء Intlayer مع وضع المرونة في الاعتبار، مقدمين تكاملًا سلسًا عبر الأُطُر وأدوات البناء الشائعة:
+لقد قمنا ببناء Intlayer مع وضع المرونة في الاعتبار، لنوفر دمجًا سلسًا عبر إطارات العمل وأدوات البناء الشائعة:
 
+- **[Intlayer مع Next.js 16](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_16.md)**
 - **[Intlayer مع Next.js 15](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_15.md)**
-- **[Intlayer مع Next.js 14 (موجه التطبيق)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_14.md)**
-- **[Intlayer مع Next.js موجه الصفحات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_page_router.md)**
+- **[Intlayer مع Next.js 14 (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_14.md)**
+- **[Intlayer مع Next.js Page Router](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nextjs_page_router.md)**
 - **[Intlayer مع React CRA](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_create_react_app.md)**
 - **[Intlayer مع Vite + React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+react.md)**
+- **[Intlayer مع React Router v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_react_router_v7.md)**
+- **[Intlayer مع Tanstack Start](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_tanstack.md)**
 - **[Intlayer مع React Native و Expo](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_react_native+expo.md)**
 - **[Intlayer مع Lynx و React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_lynx+react.md)**
+- **[Intlayer مع Vite + Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+preact.md)**
+- **[Intlayer مع Vite + Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+vue.md)**
+- **[Intlayer مع Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nuxt.md)**
+- **[Intlayer مع Vite + Svelte](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+svelte.md)**
+- **[Intlayer مع SvelteKit](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_svelte_kit.md)**
 - **[Intlayer مع Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_express.md)**
+- **[Intlayer مع NestJS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nestjs.md)**
+- **[Intlayer مع Hono](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_hono.md)**
+- **[Intlayer مع Angular](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_angular_21.md)**
 
-تتضمن كل دليل تكامل أفضل الممارسات لاستخدام ميزات Intlayer، مثل **التصيير على جانب الخادم**، **التوجيه الديناميكي**، أو **التصيير على جانب العميل**، حتى تتمكن من الحفاظ على تطبيق سريع، صديق لمحركات البحث، وقابل للتوسع بشكل كبير.
+يتضمن كل دليل للتكامل أفضل الممارسات لاستخدام ميزات Intlayer، مثل **الرندرة من جانب الخادم (SSR)**، أو **التوجيه الديناميكي (Dynamic Routing)**، أو **الرندرة من جانب العميل (Client-Side Rendering)**، لتتمكن من الحفاظ على تطبيق سريع وصديق لمحركات البحث (SEO) وقابل للتوسع بدرجة كبيرة.
 
-## المساهمة والتعليقات
+## المساهمة والملاحظات
 
-نحن نقدر قوة البرمجيات مفتوحة المصدر والتطوير المدفوع من قبل المجتمع. إذا كنت ترغب في اقتراح تحسينات، إضافة دليل جديد، أو تصحيح أي مشاكل في وثائقنا، فلا تتردد في تقديم طلب سحب (Pull Request) أو فتح مشكلة في [مستودع GitHub الخاص بنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
+نحن نُقدر قوة المصادر المفتوحة والتطوير المدفوع بالمجتمع. إذا كنت ترغب في اقتراح تحسينات، أو إضافة دليل جديد، أو تصحيح أي مشاكل في وثائقنا، فلا تتردد في تقديم طلب سحب (Pull Request) أو فتح مشكلة (Issue) في [مستودع GitHub الخاص بنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs).
 
-**هل أنت مستعد لترجمة تطبيقك بشكل أسرع وأكثر كفاءة؟** اغمر نفسك في وثائقنا لبدء استخدام Intlayer اليوم. اختبر نهجًا قويًا ومنظمًا للتدويل يحافظ على تنظيم محتواك ويجعل فريقك أكثر إنتاجية.
+**هل أنت مستعد لترجمة تطبيقك بشكل أسرع وأكثر كفاءة؟** الغوص في وثائقنا للبدء في استخدام Intlayer اليوم. جرب نهجًا قويًا ومبسطًا للتدويل يحافظ على تنظيم المحتوى الخاص بك ويزيد من إنتاجية فريقك.
 
----
+### لماذا Intlayer على البدائل؟
+
+مقارنةً بالحلول الرئيسية مثل `next-intl` أو `i18next`، يُعد Intlayer حلاً يأتي مع تحسينات مدمجة مثل:
+
+**حجم البندل (Bundle size)**
+
+بدلاً من تحميل ملفات JSON ضخمة في صفحاتك، قم بتحميل المحتوى الضروري فقط. تساعد Intlayer في **تقليل حجم الحزمة وصفحاتك بنسبة تصل إلى 50%**.
+
+**قابلية الصيانة (Maintainability)**
+
+تحديد نطاق محتوى تطبيقك بالقرب من المكونات **يسهل الصيانة** للتطبيقات واسعة النطاق. يمكنك تكرار أو حذف مجلد ميزة واحدة دون العبء العقلي المتمثل في مراجعة قاعدة بيانات المحتوى بالكامل. بالإضافة إلى ذلك، تم كتابة Intlayer **بالكامل باستخدام الأنواع (fully typed)** لضمان دقة المحتوى الخاص بك.
+
+**وكيل الذكاء الاصطناعي (AI Agent)**
+
+يؤدي تحديد الموقع المشترك للمحتوى إلى **تقليل السياق المطلوب** بواسطة نماذج اللغة الكبيرة (LLMs). تأتي Intlayer أيضًا مع مجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة، و **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/lsp.md)**، و **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)**، و **[مهارات الوكيل (agent skills)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة لوكلاء الذكاء الاصطناعي.
+
+**الأتمتة (Automation)**
+
+استخدم الأتمتة للترجمة في مسار CI/CD الخاص بك باستخدام LLM من اختيارك على حساب مزود الذكاء الاصطناعي الخاص بك. تقدم Intlayer أيضًا **مترجمًا (compiler)** لأتمتة استخراج المحتوى، بالإضافة إلى [منصة ويب](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md) للمساعدة في **الترجمة في الخلفية**.
+
+**الأداء (Performance)**
+
+يمكن أن يؤدي ربط ملفات JSON الضخمة بالمكونات إلى مشاكل في الأداء والتفاعلية. تقوم Intlayer بتحسين تحميل المحتوى الخاص بك في وقت البناء (build time).
+
+**التوسع مع غير المطورين (Scaling with non-dev)**
+
+أكثر من مجرد حل i18n، توفر Intlayer **[محررًا مرئيًا ذاتي الاستضافة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)** و **[CMS كاملًا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)** لمساعدتك في إدارة المحتوى متعدد اللغات في **الوقت الفعلي (real-time)**، مما يجعل التعاون مع المترجمين وكتاب النصوص وأعضاء الفريق الآخرين سلسًا. يمكن تخزين المحتوى محليًا و/أو عن بُعد.

package/docs/ar/lsp.md

@@ -0,0 +1,351 @@
+---
+createdAt: 2025-06-07
+updatedAt: 2026-05-31
+title: خادم Intlayer LSP
+description: تعرف على كيفية توفير خادم لغة Intlayer لميزة الانتقال إلى التعريف وميزات IDE الأخرى لاستدعاءات useIntlayer وgetIntlayer والاستدعاءات ذات الصلة عبر جميع المحررات المدعومة.
+keywords:
+  - LSP
+  - خادم اللغة
+  - الانتقال إلى التعريف
+  - IDE
+  - Intlayer
+  - VS Code
+  - Neovim
+  - TypeScript
+slugs:
+  - doc
+  - lsp
+history:
+  - version: 8.12.0
+    date: 2026-06-01
+    changes: "Release LSP"
+---
+
+# خادم Intlayer LSP
+
+**خادم لغة Intlayer (LSP)** هو تطبيق لـ [بروتوكول خادم اللغة (LSP)](https://microsoft.github.io/language-server-protocol/) يعمل على تحسين بيئة التطوير المتكاملة (IDE) الخاصة بك بذكاء يدعم Intlayer. يوفر حاليًا ميزة **الانتقال إلى التعريف (Go to Definition)** لاستدعاءات مفاتيح القاموس، مما يتيح لك الانتقال مباشرة من `useIntlayer("my-key")` في مكونك إلى ملف `.content.ts` الذي يعلن عنه.
+
+---
+
+## لماذا تستخدم الـ LSP؟
+
+عند استخدام Intlayer، يكون الاتصال بين استدعاء مثل `useIntlayer("homepage")` والإعلان عنه في `src/homepage.content.ts` ضمنيًا. بدون أدوات، يجب عليك البحث عن الملف يدويًا. يجعل الـ LSP هذا الرابط صريحًا:
+
+**وعي وكيل الذكاء الاصطناعي**
+
+تعتمد وكلاء البرمجة القائمون على الذكاء الاصطناعي (Cursor, Windsurf, GitHub Copilot, Claude Code, Codex) على خادم اللغة لحل الرموز وفهم العلاقات عبر الملفات. مع تشغيل خادم لغة Intlayer، يمكن للوكلاء تتبع `useIntlayer("key")` للعودة إلى إعلانه، مما يمنحهم سياقًا دقيقًا حول مفاتيح المحتوى المتاحة، وهيكل كل قاموس، والملفات التي يجب قراءتها أو تحريرها.
+
+**الانتقال إلى التعريف**
+
+ضع المؤشر على أي سلسلة مفاتيح قاموس داخل استدعاء جلب مدعوم واضغط على `F12` (أو `Cmd/Ctrl+Click`). يفتح المحرر ملف إعلان المحتوى ويضع المؤشر على سطر `:key`.
+
+**دعم القواميس المدمجة**
+
+يمكن تقسيم المفتاح عبر ملفات محتوى متعددة (يقوم Intlayer بدمجها). يعيد الخادم موقعًا واحدًا (`Location`) لكل ملف مصدر بحيث يمكنك التنقل إلى كل إعلان.
+
+**يعمل في كل مكان**
+
+يدعم جميع حزم `*-intlayer` (`next-intlayer`, `react-intlayer`, `vue-intlayer`, `svelte-intlayer`, `solid-intlayer`, `preact-intlayer`, `angular-intlayer`, `lit-intlayer`, `express-intlayer`, `hono-intlayer`, `fastify-intlayer`, `adonis-intlayer`, `intlayer`).
+
+### استدعاءات الجلب المدعومة
+
+يكتشف الخادم استدعاءات الوظائف التالية ويستخرج الوسيط الأول لسلسلة الأحرف كمفتاح للقاموس:
+
+| الوظيفة       | مثال                          |
+| ------------- | ----------------------------- |
+| `useIntlayer` | `useIntlayer("hero")`         |
+| `getIntlayer` | `getIntlayer("hero", locale)` |
+
+يتم تجاهل جينيريك TypeScript والوسائط الإضافية — فقط سلسلة المفاتيح هي ما يهم.
+
+> تأخذ `useDictionary` و`getDictionary` كائن `Dictionary` مستورد بالفعل كوسيط أول لها بدلاً من مفتاح سلسلة أحرف، لذا فهي لا تستفيد من ميزة الانتقال إلى التعريف ولا يتم تتبعها بواسطة الخادم.
+
+---
+
+## التثبيت
+
+يتم توزيع خادم LSP كجزء من حزمة `@intlayer/lsp`:
+
+```bash packageManager="npm"
+npm install --save-dev @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn add --dev @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add --save-dev @intlayer/lsp
+```
+
+```bash packageManager="bun"
+bun add --dev @intlayer/lsp
+```
+
+تكشف الحزمة عن الملف الثنائي `intlayer-lsp` الذي تستخدمه المحررات كملف تشغيلي للخادم.
+
+---
+
+## الإعداد كملحق لـ Claude Code
+
+يتوفر خادم لغة Intlayer كـ **ملحق لـ Claude Code** يتم استضافته مباشرة في مستودع Intlayer على GitHub. يمنح تثبيته وعيًا أصيلاً لـ Claude Code بميزة الانتقال إلى التعريف لجميع استدعاءات `useIntlayer` / `getIntlayer` الخاصة بك.
+
+### 1. تثبيت الملف الثنائي لخادم اللغة
+
+```bash packageManager="npm"
+npm install -g @intlayer/lsp
+```
+
+```bash packageManager="yarn"
+yarn global add @intlayer/lsp
+```
+
+```bash packageManager="pnpm"
+pnpm add -g @intlayer/lsp
+```
+
+يضع هذا الملف الثنائي `intlayer-lsp` في مسار PATH الخاص بك، وهو ما يستدعيه إدخال `lspServers` الخاص بالملحق.
+
+### 2. تسجيل سوق Intlayer وتثبيت الملحق
+
+```bash
+claude plugin marketplace add intlayer@github:aymericzip/intlayer
+claude plugin install intlayer-lsp@intlayer
+claude plugin enable intlayer-lsp@intlayer
+```
+
+سيضيف Claude Code القيمة `"intlayer-lsp@intlayer": true` إلى قائمة الـ `enabledPlugins` الخاصة بك ويبدأ خادم اللغة تلقائيًا في أنواع الملفات المدعومة (`.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`).
+
+### 3. تمكين أداة LSP (إذا لم تكن نشطة بالفعل)
+
+تتطلب بعض إصدارات Claude Code تعيين علامة ميزة LSP. أضف ما يلي إلى ملف `~/.claude/settings.json` إذا كانت ميزة الانتقال إلى التعريف لا تعمل بعد التثبيت:
+
+```json fileName="~/.claude/settings.json"
+{
+  "env": {
+    "ENABLE_LSP_TOOL": "1"
+  }
+}
+```
+
+أعد تشغيل Claude Code — سيعتمد الآن على `goToDefinition` و`findReferences` وعمليات LSP الأخرى عند التنقل في قاعدة كود Intlayer بدلاً من الرجوع إلى `grep`.
+
+---
+
+## الإعداد في VS Code (عبر الملحق — موصى به)
+
+إذا كان لديك [ملحق Intlayer لـ VS Code](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) مثبتًا، فسيبدأ خادم اللغة تلقائيًا. لا يلزم إعداد إضافي.
+
+> راجع [وثائق ملحق VS Code](https://intlayer.org/doc/vs-code-extension) لمعرفة كيفية التثبيت والميزات الأخرى.
+
+---
+
+## الإعداد اليدوي في VS Code
+
+إذا كنت لا تستخدم ملحق Intlayer، فيمكنك توصيل خادم اللغة يدويًا باستخدام ملحق عميل LSP عام مثل [**vscode-glspc**](https://marketplace.visualstudio.com/items?itemName=sibiraj-s.vscode-scss-formatter) أو عن طريق كتابة ملحق صغير خاص بك. الطريقة الموصى بها هي استخدام ملحق Intlayer.
+
+كمرجع، يتم تشغيل الخادم عبر الملف الثنائي `intlayer-lsp` عبر stdio:
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+يقرأ ملحق Intlayer هذه الإعدادات لتشغيل الخادم. إذا كنت تعتمد فقط على الملحق، فلن تحتاج إلى أي إعدادات يدوية.
+
+---
+
+## الإعداد في Cursor
+
+[Cursor](https://www.cursor.com/) هو نسخة مخصصة من VS Code تأتي بميزات ذكاء اصطناعي مدمجة. ويستخدم نفس نظام الملحقات البيئي، لذا فإن **ملحق Intlayer لـ VS Code** يعمل بدون أي إعداد إضافي — قم بتثبيته مرة واحدة وسيكتشفه Cursor تلقائيًا.
+
+إذا كنت تفضل الإعداد اليدوي، يقرأ Cursor أيضًا ملف `.vscode/settings.json` من جذر مساحة العمل، لذا ينطبق رمز VS Code أعلاه مباشرة.
+
+---
+
+## الإعداد في Windsurf
+
+[Windsurf](https://windsurf.com/) (من تطوير Codeium) هو محرر آخر يعتمد على VS Code. قم بتثبيت ملحق Intlayer من سوق VS Code وسينشط خادم اللغة تلقائيًا، تمامًا كما هو الحال في VS Code وCursor.
+
+للإعداد اليدوي، أنشئ ملف `.vscode/settings.json` في جذر المشروع:
+
+```json fileName=".vscode/settings.json"
+{
+  "intlayer.languageServer.command": "npx",
+  "intlayer.languageServer.args": ["@intlayer/lsp"]
+}
+```
+
+---
+
+## الإعداد في Zed
+
+يتميز [Zed](https://zed.dev/) بدعم LSP أصيل من خلال إعدادات اللغة. أضف إدخالاً في إعدادات مستخدم Zed الخاصة بك (`~/.config/zed/settings.json`):
+
+```json fileName="~/.config/zed/settings.json"
+{
+  "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", "..."]
+    }
+  }
+}
+```
+
+يخبر العنصر النائب `"..."` محرر Zed بالاحتفاظ بخوادم اللغة الافتراضية جنبًا إلى جنب مع خادم Intlayer.
+
+---
+
+## الإعداد لواجهات خط أوامر وكلاء الذكاء الاصطناعي (Claude Code، Codex، إلخ)
+
+يتمتع **Claude Code** بدعم من الدرجة الأولى لملحقات LSP — اتبع [إعداد ملحق Claude Code](#الإعداد-كملحق-لـ-claude-code) أعلاه للحصول على تجربة الانتقال إلى التعريف الكاملة مباشرة في جلسات الطرفية الخاصة بك.
+
+لا تعمل **OpenAI Codex** وأدوات الطرفية الأخرى كعملاء LSP حتى الآن — فهي تقرأ وتكتب الملفات مباشرة بدلاً من الحفاظ على جلسة خادم لغة مستمرة. بالنسبة لهذه الأدوات، تأتي قيمة تشغيل خادم لغة LSP بشكل غير مباشر: عندما يكون الخادم نشطًا في محرر مصاحب (VS Code, Cursor, Windsurf, ...)، يتوفر فهرس المحرر المباشر لأي وكيل ذكاء اصطناعي يمكنه الاستعلام عنه من خلال السياق الذي يوفره المحرر (على سبيل المثال، Cursor Composer, Windsurf Cascade, GitHub Copilot Chat).
+
+إذا كنت تعمل فقط في الطرفية دون فتح محرر، يمكنك بدء خادم اللغة في الخلفية حتى يكون جاهزًا لأي محرر يتصل لاحقًا بمساحة العمل نفسها:
+
+```bash
+# حافظ على تشغيل الخادم في الخلفية
+npx @intlayer/lsp &
+```
+
+---
+
+## الإعداد اليدوي في Neovim
+
+باستخدام [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig)، قم بتسجيل إعداد خادم مخصص:
+
+```lua fileName="~/.config/nvim/init.lua"
+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({})
+```
+
+بعد إعادة تشغيل Neovim، سيؤدي الضغط على `gd` فوق مفتاح Intlayer إلى استدعاء ميزة الانتقال إلى التعريف.
+
+---
+
+## الإعداد اليدوي في المحررات الأخرى
+
+يمكن لأي محرر يدعم بروتوكول خادم اللغة استخدام `@intlayer/lsp`. مواصفات الخادم:
+
+- **النقل** – Node.js IPC / stdio (قياسي)
+- **الملف التشغيلي** – `npx @intlayer/lsp` (أو الملف الثنائي `intlayer-lsp` المثبت محليًا)
+- **القدرات** – `definitionProvider: true`, `textDocumentSync: Incremental`
+
+استشر وثائق LSP الخاصة بمحررك لمعرفة تنسيق الإعداد الدقيق (على سبيل المثال، `languageserver.json` لـ [coc.nvim](https://github.com/neoclide/coc.nvim)، أو إعدادات عميل LSP في [Helix](https://helix-editor.com)).
+
+### مثال: coc.nvim
+
+```json fileName="~/.config/nvim/coc-settings.json"
+{
+  "languageserver": {
+    "intlayer": {
+      "command": "npx",
+      "args": ["@intlayer/lsp"],
+      "filetypes": [
+        "typescript",
+        "typescriptreact",
+        "javascript",
+        "javascriptreact",
+        "vue",
+        "svelte"
+      ],
+      "rootPatterns": [
+        "intlayer.config.ts",
+        "intlayer.config.js",
+        "package.json"
+      ]
+    }
+  }
+}
+```
+
+### مثال: Helix
+
+```toml fileName="~/.config/helix/languages.toml"
+[[language]]
+name = "typescript"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[[language]]
+name = "tsx"
+language-servers = ["intlayer-lsp", "typescript-language-server"]
+
+[language-server.intlayer-lsp]
+command = "npx"
+args = ["@intlayer/lsp"]
+```
+
+---
+
+## كيف يعمل؟
+
+عندما يبدأ الخادم، فإنه يقوم بحل إعداد Intlayer من جذر مساحة العمل باستخدام `getConfiguration()`. يمنحه هذا مسارات `build` و`system` اللازمة للعثور على القواميس المترجمة.
+
+عند كل طلب **انتقال إلى التعريف**:
+
+1. يقرأ الخادم النص الكامل للمستند المفتوح.
+2. يقوم بمسح استدعاءات الجلب (`useIntlayer`، `getIntlayer`، إلخ) باستخدام تعبير نمطي.
+3. يتحقق مما إذا كان موضع المؤشر يقع داخل أحد تلك الاستدعاءات.
+4. إذا كان الأمر كذلك، فإنه يستخرج مفتاح القاموس (مجموعة الالتقاط 3 من التعبير النمطي) ويستدعي `getUnmergedDictionaries()` لتحديد موقع كل ملف محتوى يعلن عن هذا المفتاح.
+5. يقرأ كل ملف مطابق ويبحث عن السطر الدقيق الذي يحتوي على `"key: "<key"` لوضع المؤشر بدقة.
+6. يعيد مصفوفة من كائنات `Location` — واحد لكل ملف مصدر.
+
+يتم حل الإعداد بشكل كسول وتخزينه مؤقتًا لكل جلسة؛ ويتم إعادة تعيينه عند كل طلب `initialize` (على سبيل المثال، عند فتح مجلد مساحة عمل جديد).
+
+---
+
+## استكشاف الأخطاء وإصلاحها
+
+| العرض                              | السبب المحتمل           | الحل                                                                               |
+| ---------------------------------- | ----------------------- | ---------------------------------------------------------------------------------- |
+| الانتقال إلى التعريف لا يفعل شيئًا | الخادم لا يعمل          | تحقق من تثبيت `@intlayer/lsp` وأن المحرر يقوم بتشغيله                              |
+| تم اكتشاف جذر مساحة عمل خاطئ       | مجلدات مساحة عمل متعددة | تأكد من أن المجلد الذي يحتوي على `intlayer.config.ts` هو المجلد الأول لمساحة العمل |
+| لم يتم العثور على تعريفات للمفتاح  | لم يتم حل الإعداد       | تحقق من وجود `intlayer.config.ts` (أو `.js`) في جذر مساحة العمل                    |
+| الخادم يتعطل عند البدء             | إصدار Node.js قديم جدًا | يتطلب Node.js ≥ 14.18                                                              |

package/docs/bn/intlayer_with_angular_21.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-05-06
-title: Angular i18n - 2026 সালে একটি Angular 21 অ্যাপ (Vite) কীভাবে অনুবাদ করবেন
-description: কীভাবে আপনার Angular ওয়েবসাইটটি বহুভাষিক করবেন তা আবিষ্কার করুন। আন্তর্জাতিকীকরণ (i18n) এবং অনুবাদ করতে ডকুমেন্টেশন অনুসরণ করুন।
+updatedAt: 2026-05-31
+title: "Angular i18n - অনুবাদের সম্পূর্ণ গাইড: Angular 21"
+description: বান্ডেল সাইজ, SEO, পারফরম্যান্স ও মেইনটেইনেবিলিটির জন্য সেরা সমাধান। ২০২৬ সালে আপনার Angular 21 অ্যাপ কে বহুভাষিক করুন, LLM অনুবাদ, Agent Skills & MCP।
 keywords:
   - আন্তর্জাতিকীকরণ
   - ডকুমেন্টেশন

package/docs/bn/intlayer_with_fastify.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2026-05-06
-title: Fastify i18n - 2026 সালে একটি Fastify অ্যাপ কীভাবে অনুবাদ করবেন
-description: কীভাবে আপনার Fastify ব্যাকএন্ডকে বহুভাষিক করবেন তা আবিষ্কার করুন। আন্তর্জাতিকীকরণ (i18n) এবং অনুবাদের জন্য ডকুমেন্টেশন অনুসরণ করুন।
+updatedAt: 2026-05-31
+title: "Fastify i18n - অনুবাদের সম্পূর্ণ গাইড: Fastify"
+description: বান্ডেল সাইজ, SEO, পারফরম্যান্স ও মেইনটেইনেবিলিটির জন্য সেরা সমাধান। ২০২৬ সালে আপনার Fastify ব্যাকএন্ড কে বহুভাষিক করুন, LLM অনুবাদ, Agent Skills & MCP।
 keywords:
   - আন্তর্জাতিকীকরণ
   - ডকুমেন্টেশন

package/docs/bn/intlayer_with_hono.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-05-06
-title: Hono i18n - ২০২৬ সালে কীভাবে একটি Hono অ্যাপ অনুবাদ করবেন
-description: কীভাবে আপনার Hono ব্যাকএন্ডকে বহুভাষিক করবেন তা আবিষ্কার করুন। এটিকে আন্তর্জাতিকীকরণ (i18n) এবং অনুবাদ করতে ডকুমেন্টেশন অনুসরণ করুন।
+updatedAt: 2026-05-31
+title: "Hono i18n - অনুবাদের সম্পূর্ণ গাইড: Hono"
+description: বান্ডেল সাইজ, SEO, পারফরম্যান্স ও মেইনটেইনেবিলিটির জন্য সেরা সমাধান। ২০২৬ সালে আপনার Hono ব্যাকএন্ড কে বহুভাষিক করুন, LLM অনুবাদ, Agent Skills & MCP।
 keywords:
   - Internationalization
   - Documentation

package/docs/bn/intlayer_with_vanilla.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-03-31
-updatedAt: 2026-05-06
-title: Vanilla JS i18n - ২০২৬ সালে কীভাবে একটি Vanilla JS অ্যাপ অনুবাদ করবেন
-description: কীভাবে আপনার Vanilla JS ওয়েবসাইটকে বহুভাষিক করবেন তা আবিষ্কার করুন। এটিকে আন্তর্জাতিকীকরণ (i18n) এবং অনুবাদ করতে ডকুমেন্টেশন অনুসরণ করুন।
+updatedAt: 2026-05-31
+title: "Vanilla JS i18n - অনুবাদের সম্পূর্ণ গাইড: Vanilla JS"
+description: বান্ডেল সাইজ, SEO, পারফরম্যান্স ও মেইনটেইনেবিলিটির জন্য সেরা সমাধান। ২০২৬ সালে আপনার Vanilla JS ওয়েবসাইট কে বহুভাষিক করুন, LLM অনুবাদ, Agent Skills & MCP।
 keywords:
   - আন্তর্জাতিকীকরণ
   - ডকুমেন্টেশন

package/docs/bn/intlayer_with_vite+lit.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-05-06
-title: Vite + Lit i18n - ২০২৬ সালে কীভাবে একটি Lit অ্যাপ অনুবাদ করবেন
-description: শিখুন কীভাবে আপনার Vite এবং Lit ওয়েবসাইটকে বহুভাষী করবেন। আন্তর্জাতিকীকরণ (i18n) এবং অনুবাদের জন্য ডকুমেন্টেশন অনুসরণ করুন।
+updatedAt: 2026-05-31
+title: "Vite + Lit i18n - অনুবাদের সম্পূর্ণ গাইড: Lit"
+description: বান্ডেল সাইজ, SEO, পারফরম্যান্স ও মেইনটেইনেবিলিটির জন্য সেরা সমাধান। ২০২৬ সালে আপনার Vite and Lit অ্যাপ কে বহুভাষিক করুন, LLM অনুবাদ, Agent Skills & MCP।
 keywords:
   - আন্তর্জাতিকীকরণ
   - ডকুমেন্টেশন

package/docs/bn/intlayer_with_vite+vanilla.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-03-23
-updatedAt: 2026-05-06
-title: i18n Vite + Vanilla JS - ২০২৬ সালে কীভাবে একটি Vanilla JS অ্যাপ অনুবাদ করবেন
-description: আপনার Vite এবং Vanilla JS ওয়েবসাইটকে কীভাবে বহুভাষিক করবেন তা আবিষ্কার করুন। আন্তর্জাতিকীকরণ (i18n) এবং অনুবাদের জন্য ডকুমেন্টেশন অনুসরণ করুন।
+updatedAt: 2026-05-31
+title: "i18n Vite + Vanilla JS - অনুবাদের সম্পূর্ণ গাইড: Vanilla JS"
+description: বান্ডেল সাইজ, SEO, পারফরম্যান্স ও মেইনটেইনেবিলিটির জন্য সেরা সমাধান। ২০২৬ সালে আপনার Vite and Vanilla JS অ্যাপ কে বহুভাষিক করুন, LLM অনুবাদ, Agent Skills & MCP।
 keywords:
   - আন্তর্জাতিকীকরণ
   - ডকুমেন্টেশন