@intlayer/docs 5.7.8 → 5.8.0

package/blog/ar/intlayer_with_next-i18next.md

@@ -1,6 +1,6 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
 title: Intlayer وnext-i18next
 description: قم بدمج Intlayer مع next-i18next لتطبيق Next.js
 keywords:
@@ -24,7 +24,6 @@ slugs:
 تتضمن كلا الحلقتين ثلاث مفاهيم رئيسية:
 
 1. **إعلان المحتوى**: الطريقة لتعريف المحتوى القابل للترجمة في تطبيقك.
-
    - يسمى `resource` في حالة `i18next`، إعلان المحتوى هو كائن JSON منظم يحتوي على أزواج مفتاح-قيمة للترجمات في لغة واحدة أو أكثر. راجع [وثائق i18next](https://www.i18next.com/translation-function/essentials) لمزيد من المعلومات.
    - يسمى `content declaration file` في حالة `Intlayer`، يمكن أن يكون إعلان المحتوى ملف JSON أو JS أو TS يقوم بتصدير البيانات المنسقة. راجع [وثائق Intlayer](https://intlayer.org/fr/doc/concept/content) لمزيد من المعلومات.
 
@@ -213,8 +212,8 @@ const content = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 } satisfies Dictionary;
@@ -231,8 +230,8 @@ const content = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -246,8 +245,8 @@ module.exports = {
   content: {
     myTranslatedContent: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };

package/blog/ar/intlayer_with_next-intl.md

@@ -23,7 +23,6 @@ slugs:
 يتشاركان ثلاث مفاهيم رئيسية:
 
 1. **إعلان المحتوى**: الطريقة لتحديد المحتوى القابل للترجمة في تطبيقك.
-
    - يُسمى `ملف إعلان المحتوى` في Intlayer، والذي يمكن أن يكون ملف JSON أو JS أو TS يقوم بتصدير البيانات المنظمة. راجع [وثائق Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/concept/content.md) لمزيد من المعلومات.
    - يُسمى `الرسائل` أو `رسائل اللغة` في next-intl، عادةً في ملفات JSON. راجع [وثائق next-intl](https://github.com/amannn/next-intl) لمزيد من المعلومات.
 
@@ -170,8 +169,8 @@ const content = {
   content: {
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 } satisfies Dictionary;
@@ -188,8 +187,8 @@ const content = {
   content: {
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };
@@ -205,8 +204,8 @@ module.exports = {
   content: {
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
   },
 };

package/blog/ar/intlayer_with_react-i18next.md

@@ -247,8 +247,8 @@ const content = {
     // كل مكالمة "t" هي عقدة ترجمة منفصلة
     heading: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     description: t({
       en: "My i18n description text...",

package/blog/ar/intlayer_with_react-intl.md

@@ -118,8 +118,8 @@ const content = {
     // كل استدعاء لـ t() يعلن عن حقل قابل للترجمة
     helloWorld: t({
       en: "Hello World",
-      fr: "Bonjour le monde",
       es: "Hola Mundo",
+      fr: "Bonjour le monde",
     }),
     description: t({
       en: "This is a description",

package/blog/ar/next-i18next_vs_next-intl_vs_intlayer.md

@@ -1,285 +1,162 @@
 ---
-createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: next-i18next vs next-intl vs Intlayer
-description: قارن بين next-i18next باستخدام next-intl و Intlayer للتدويل الدولي (i18n) لتطبيق Next.js
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: next-i18next مقابل next-intl مقابل Intlayer
+description: مقارنة بين next-i18next و next-intl و Intlayer لتدويل (i18n) تطبيق Next.js
 keywords:
   - next-intl
   - next-i18next
   - Intlayer
   - التدويل
-  - التوثيق
+  - مدونة
   - Next.js
-  - JavaScript
+  - جافاسكريبت
   - React
 slugs:
   - blog
   - next-i18next-vs-next-intl-vs-intlayer
 ---
 
-# next-i18next VS next-intl VS Intlayer | Next.js Internationalization (i18n)
+# next-i18next مقابل next-intl مقابل intlayer | التدويل في Next.js (i18n)
 
-فيما يلي مقارنة موجزة بين **ثلاث مكتبات شائعة** لتدويل (i18n) تطبيق Next.js: **next-intl**، **next-i18next**، و **Intlayer**.
+تُقارن هذه الدليل بين ثلاث خيارات شائعة للتدويل (i18n) لـ **Next.js**: **next-intl**، **next-i18next**، و **Intlayer**.
+نركز على **موجه التطبيقات في Next.js 13+** (مع **مكونات خادم React**) ونقيّم:
 
-يسلط هذا المستند الضوء على المعايير الرئيسية:
+1. **البنية والتنظيم المحتوى**
+2. **TypeScript والأمان**
+3. **معالجة الترجمات المفقودة**
+4. **التوجيه والوسيط**
+5. **الأداء وسلوك التحميل**
+6. **تجربة المطور (DX)، الأدوات والصيانة**
+7. **تحسين محركات البحث (SEO) وقابلية التوسع في المشاريع الكبيرة**
 
-1. **البنية المعمارية** (الحفاظ على الترجمات بالقرب من مكوناتها)
-2. **دعم TypeScript**
-3. **إدارة الترجمات المفقودة**
-4. **دعم مكونات الخادم**
-5. **توجيه مُحسّن & middleware** لـ Next.js
-6. **بساطة الإعداد**
-
-يوفر الدليل أيضًا **نظرة عميقة على Intlayer**، مما يوضح لماذا يمكن أن يكون خيارًا قويًا - خاصة لـ Next.js 13+، بما في ذلك **موجه التطبيقات** و **مكونات الخادم**.
+> **ملخص**: يمكن لجميع الثلاثة تعريب تطبيق Next.js. إذا كنت تريد **محتوى مخصص للمكونات**، **أنواع TypeScript صارمة**، **فحوصات مفاتيح مفقودة أثناء البناء**، **قواميس معزولة بالشجرة (tree-shaken)**، و**موجه تطبيقات من الدرجة الأولى + مساعدي SEO**، فإن **Intlayer** هو الخيار الأكثر اكتمالاً وحداثة.
 
 ---
 
-## نظرة عامة على كل مكتبة
-
-### 1. next-intl
+## التموقع على مستوى عالٍ
 
-**التركيز الرئيسي**: إعداد سريع وسهل مع نهج خفيف لتوطين.
+- **next-intl** - تنسيق رسائل خفيف الوزن وبسيط مع دعم قوي لـ Next.js. الكتالوجات المركزية شائعة؛ تجربة المطور بسيطة، لكن الأمان والصيانة على نطاق واسع تبقى في الغالب مسؤوليتك.
+- **next-i18next** - i18next في قالب Next.js. نظام بيئي ناضج وميزات عبر الإضافات (مثل ICU)، لكن التكوين قد يكون مطولًا وتميل الكتالوجات إلى المركزية مع نمو المشاريع.
+- **Intlayer** - نموذج محتوى يركز على المكونات لـ Next.js، **أنواع TypeScript صارمة**، **فحوصات أثناء وقت البناء**، **عزل القواميس بالشجرة (tree-shaking)**، **وسائط مدمجة ومساعدي SEO**، محرر/نظام إدارة محتوى بصري اختياري، وترجمات بمساعدة الذكاء الاصطناعي.
 
-- **البنية المعمارية**: تشجع على تجميع الترجمات في مجلد واحد (مثل `locales/`) لكنها تسمح أيضًا باستراتيجيات متعددة. لا تفرض بدقة بنية "ترجمة لكل مكون".
-- **دعم TypeScript**: تكامل أساسي مع TypeScript. توجد بعض تعريفات النوع، لكنها ليست مركزة بكثافة على التوليد التلقائي لتعريفات TypeScript من ملفات الترجمة الخاصة بك.
-- **الترجمات المفقودة**: آلية تراجع أساسية. بشكل افتراضي، تتراجع إلى مفتاح أو سلسلة محلية افتراضية. لا توجد أدوات قوية خارج الصندوق لعمليات فحص الترجمات المفقودة المتقدمة.
-- **دعم مكونات الخادم**: تعمل مع Next.js 13+ بشكل عام، لكن النمط أقل تخصصًا للاستخدام العميق على جانب الخادم (مثل مكونات الخادم مع توجيه ديناميكي معقد).
-- **التوجيه و middleware**: الدعم المتاح محدود. يعتمد عادة على `Middleware` في Next.js لاكتشاف المحلية، أو التكوين اليدوي لإعادة كتابة مسارات المحلية.
-- **بساطة الإعداد**: بسيطة جدًا. الحد الأدنى من الكود المبدئي مطلوب.
+---
 
-**استخدمها عندما**: تريد نهجًا أبسط أو تشعر بالراحة في إدارة الترجمات الخاصة بك بطرق أكثر تقليدية (مثل مجلد واحد مع ملفات JSON محلية).
+## مقارنة الميزات جنبًا إلى جنب (مركز على Next.js)
+
+| الميزة                                                 | `next-intlayer` (Intlayer)                                                                                                   | `next-intl`                                                                                    | `next-i18next`                                                                                 |
+| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| **الترجمات بالقرب من المكونات**                        | ✅ نعم، المحتوى موضوع بجانب كل مكون                                                                                          | ❌ لا                                                                                          | ❌ لا                                                                                          |
+| **تكامل TypeScript**                                   | ✅ متقدم، أنواع صارمة مولدة تلقائيًا                                                                                         | ✅ جيد                                                                                         | ⚠️ أساسي                                                                                       |
+| **كشف الترجمات المفقودة**                              | ✅ تمييز أخطاء TypeScript وتحذير/خطأ أثناء وقت البناء                                                                        | ⚠️ استرجاع وقت التشغيل                                                                         | ⚠️ استرجاع وقت التشغيل                                                                         |
+| **المحتوى الغني (JSX/Markdown/المكونات)**              | ✅ دعم مباشر                                                                                                                 | ❌ غير مصمم للعقد الغنية                                                                       | ⚠️ محدود                                                                                       |
+| **الترجمة المدعومة بالذكاء الاصطناعي**                 | ✅ نعم، يدعم عدة مزودي ذكاء اصطناعي. يمكن استخدامه باستخدام مفاتيح API الخاصة بك. يأخذ في الاعتبار سياق تطبيقك ونطاق المحتوى | ❌ لا                                                                                          | ❌ لا                                                                                          |
+| **المحرر المرئي**                                      | ✅ نعم، محرر مرئي محلي + نظام إدارة محتوى اختياري؛ يمكنه إخراج محتوى قاعدة الشيفرة؛ قابل للتضمين                             | ❌ لا / متوفر عبر منصات التوطين الخارجية                                                       | ❌ لا / متوفر عبر منصات التوطين الخارجية                                                       |
+| **التوجيه المحلي**                                     | ✅ نعم، يدعم المسارات المحلية مباشرة (يعمل مع Next.js و Vite)                                                                | ✅ مدمج، يدعم App Router جزء `[locale]`                                                        | ✅ مدمج                                                                                        |
+| **توليد المسارات الديناميكية**                         | ✅ نعم                                                                                                                       | ✅ نعم                                                                                         | ✅ نعم                                                                                         |
+| **التصريف الجمعي**                                     | ✅ أنماط قائمة على التعداد                                                                                                   | ✅ جيد                                                                                         | ✅ جيد                                                                                         |
+| **التنسيق (التواريخ، الأرقام، العملات)**               | ✅ منسقات محسّنة (Intl في الخلفية)                                                                                           | ✅ جيد (مساعدات Intl)                                                                          | ✅ جيد (مساعدات Intl)                                                                          |
+| **تنسيق المحتوى**                                      | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml قيد العمل)                                                                       | ✅ .json, .js, .ts                                                                             | ⚠️ .json                                                                                       |
+| **دعم ICU**                                            | ⚠️ قيد العمل                                                                                                                 | ✅ نعم                                                                                         | ⚠️ عبر الإضافة (`i18next-icu`)                                                                 |
+| **مساعدو تحسين محركات البحث (hreflang، خريطة الموقع)** | ✅ أدوات مدمجة: مساعدات لخريطة الموقع، robots.txt، البيانات الوصفية                                                          | ✅ جيد                                                                                         | ✅ جيد                                                                                         |
+| **النظام البيئي / المجتمع**                            | ⚠️ أصغر حجماً لكنه ينمو بسرعة ويتسم بالتفاعل                                                                                 | ✅ متوسط الحجم، يركز على Next.js                                                               | ✅ متوسط الحجم، يركز على Next.js                                                               |
+| **التصيير على جانب الخادم ومكونات الخادم**             | ✅ نعم، مُبسّط للتصيير على جانب الخادم / مكونات React Server                                                                 | ⚠️ مدعوم على مستوى الصفحة ولكن يحتاج إلى تمرير دوال t على شجرة المكونات لمكونات الخادم الفرعية | ⚠️ مدعوم على مستوى الصفحة ولكن يحتاج إلى تمرير دوال t على شجرة المكونات لمكونات الخادم الفرعية |
+| **Tree-shaking (تحميل المحتوى المستخدم فقط)**          | ✅ نعم، لكل مكون أثناء وقت البناء عبر إضافات Babel/SWC                                                                       | ⚠️ جزئي                                                                                        | ⚠️ جزئي                                                                                        |
+| **التحميل الكسول**                                     | ✅ نعم، لكل لغة / لكل قاموس                                                                                                  | ✅ نعم (لكل مسار/لكل لغة)، يحتاج إلى إدارة مساحة الأسماء                                       | ✅ نعم (لكل مسار/لكل لغة)، يحتاج إلى إدارة مساحة الأسماء                                       |
+| **تنظيف المحتوى غير المستخدم**                         | ✅ نعم، لكل قاموس أثناء وقت البناء                                                                                           | ❌ لا، يمكن إدارته يدويًا باستخدام إدارة مساحة الأسماء                                         | ❌ لا، يمكن إدارته يدويًا باستخدام إدارة مساحة الأسماء                                         |
+| **إدارة المشاريع الكبيرة**                             | ✅ يشجع على التكوين المعياري، مناسب لأنظمة التصميم                                                                           | ✅ معياري مع الإعداد                                                                           | ✅ معياري مع الإعداد                                                                           |
 
 ---
 
-### 2. next-i18next
+## مقارنة متعمقة
 
-**التركيز الرئيسي**: حل مثبت عبر الزمن يستخدم `i18next` تحت الغطاء، ومتبع على نطاق واسع لمشاريع Next.js.
+### 1) البنية القابلة للتوسع
 
-- **البنية المعمارية**: غالبًا ما تنظم الترجمات في مجلد `public/locales`. لم يتم تصميمه خصيصًا للحفاظ على الترجمات "بالقرب" من كل مكون، على الرغم من أنه يمكنك اعتماد بنية مختلفة يدويًا.
-- **دعم TypeScript**: تغطية معقولة لـ TypeScript لكنها تتطلب تكوينًا مخصصًا للترجمات المــــعــنونة و الـhooks المعنونة.
-- **الترجمات المفقودة**: يقدم i18next التداخل/التراجعات. ومع ذلك، فإن اكتشاف الترجمة المفقودة عادةً ما يحتاج إلى إعداد إضافي أو مكونات إضافية.
-- **دعم مكونات الخادم**: تم توثيق الاستخدام الأساسي مع Next.js 13، ولكن قد يكون الاستخدام المتقدم (مثل التكامل العميق بمكونات الخادم، وإنشاء المسارات الديناميكية) مرهقًا.
-- **التوجيه و middleware**: يعتمد بقوة على `Middleware` في Next.js وإعادة الكتابة لمسارات المحلية. قد تحتاج إلى الغوص في تكوين i18next المتقدم للإعدادات الأكثر تعقيدًا.
-- **بساطة الإعداد**: نهج مألوف لأولئك المألوفين مع i18next. ومع ذلك، يمكن أن تصبح أكثر تعقيدًا عندما تكون الميزات المتقدمة مطلوبة (مثل الفضاءات، وموارد محلية افتراضية متعددة، إلخ).
+- **next-intl / next-i18next**: الافتراضي هو **كتالوجات مركزية** لكل لغة (بالإضافة إلى **مساحات الأسماء** في i18next). يعمل بشكل جيد في البداية، لكنه غالبًا ما يصبح مساحة مشتركة كبيرة مع زيادة الترابط وتغير المفاتيح بشكل متكرر.
+- **Intlayer**: يشجع على وجود **قواميس لكل مكون** (أو لكل ميزة) **متمركزة** مع الكود الذي تخدمه. هذا يقلل العبء الذهني، ويسهل تكرار/ترحيل أجزاء واجهة المستخدم، ويقلل من النزاعات بين الفرق المختلفة. المحتوى غير المستخدم يكون من السهل اكتشافه وحذفه بشكل طبيعي.
 
-**استخدمها عندما**: تكون قد التزمت بالفعل بنظام `i18next` أو لديك ترجمات موجودة تعتمد على i18next.
+**لماذا هذا مهم:** في قواعد الشيفرة الكبيرة أو إعدادات أنظمة التصميم، **المحتوى المعياري** يتوسع بشكل أفضل من الكتالوجات الأحادية.
 
 ---
 
-### 3. Intlayer
-
-**التركيز الرئيسي**: مكتبة توطين حديثة ومفتوحة المصدر مصممة خصيصًا لـ Next.js **موجه التطبيقات** (12، 13، 14، و 15) مع دعم مدمج لـ **مكونات الخادم** و **Turbopack**.
+### 2) TypeScript والأمان
 
-#### المزايا الرئيسية
+- **next-intl**: دعم قوي لـ TypeScript، لكن **المفاتيح ليست مُعرفة بصرامة بشكل افتراضي**؛ ستحتاج للحفاظ على أنماط الأمان يدويًا.
+- **next-i18next**: تعريفات أساسية للخطافات؛ **التعريف الصارم للمفاتيح يتطلب أدوات/إعدادات إضافية**.
+- **Intlayer**: **ينشئ أنواعًا صارمة** من محتواك. **الإكمال التلقائي في بيئة التطوير** و**أخطاء وقت الترجمة** تكتشف الأخطاء المطبعية والمفاتيح المفقودة قبل النشر.
 
-1. **البنية المعمارية**
+**لماذا هذا مهم:** التعريف الصارم يحول الفشل إلى الجانب **الأيسر** (CI/البناء) بدلاً من الجانب **الأيمن** (وقت التشغيل).
 
-   - تشجع على وضع **الترجمات بجانب مكوناتها**. يمكن أن تحتوي كل صفحة أو مكون على ملف `.content.ts` (أو JSON) خاص بها - لا مزيد من البحث في مجلد ترجمة عملاق.
-   - يجعل ذلك الشيفرة الخاصة بك أكثر **وحدوية وقابلة للصيانة**، خاصة في قواعد الشيفرة الكبيرة.
-
-2. **دعم TypeScript**
-
-   - **تعريفات نوع تم إنشاؤها تلقائيًا**: في اللحظة التي تعرف فيها محتواك، يقوم Intlayer بإنشاء أنواع تدعم الإكمال التلقائي والتقاط أخطاء الترجمة.
-   - يقلل من الأخطاء أثناء التشغيل مثل المفاتيح المفقودة ويقدم **الإكمال التلقائي المتقدم** مباشرة في IDE الخاص بك.
-
-3. **إدارة الترجمات المفقودة**
+---
 
-   - خلال البناء، يمكن لـ Intlayer **اكتشاف مفاتيح الترجمة المفقودة** وإلقاء التحذيرات أو الأخطاء.
-   - يضمن ذلك أنك لن تشحن أبدًا نصًا مفقودًا عبر لغاتك.
+### 3) التعامل مع الترجمات المفقودة
 
-4. **محسن لمكونات الخادم**
+- **next-intl / next-i18next**: تعتمد على **الاستعادات في وقت التشغيل** (مثل عرض المفتاح أو اللغة الافتراضية). البناء لا يفشل.
+- **Intlayer**: **الكشف أثناء البناء** مع **تحذيرات/أخطاء** للمواقع أو المفاتيح المفقودة.
 
-   - متوافق تمامًا مع **موجه التطبيقات** لـ Next.js ونموذج **مكونات الخادم** الجديد.
-   - يقدم موفري خدمات متخصصين (`IntlayerServerProvider`، `IntlayerClientProvider`) لـ **عزل سياق الخادم** (مهم عند التعامل مع Next.js 13+).
+**لماذا هذا مهم:** اكتشاف الفجوات أثناء البناء يمنع ظهور "سلاسل غامضة" في الإنتاج ويتماشى مع بوابات الإصدار الصارمة.
 
-5. **توجيه مُحسّن & middleware**
+---
 
-   - يتضمن [**`intlayerMiddleware`**](#) لاكتشاف المحلية تلقائيًا (عبر ملفات تعريف الارتباط أو رؤوس المتصفح) وتوليد المسارات المتقدمة.
-   - يتعامل ديناميكيًا مع المسارات المحلية (مثل `/en-US/about` مقابل `/fr/about`) مع تكوين بسيط.
-   - يقدم طرق مساعدة مثل `getMultilingualUrls` لتوليد روابط لغات بديلة (رائع لـ **SEO**).
+### 4) التوجيه، الوسيط واستراتيجية عناوين URL
 
-6. **إعداد مبسط**
-   - ملف إعداد واحد (`intlayer.config.ts`) لتعريف محلياتك، المحلية الافتراضية، وتفضيلات التكامل.
-   - مكون إضافي Wrapper `withIntlayer(nextConfig)` الذي **يحقن** جميع متغيرات البيئة والمراقبين لمحتواك.
-   - **لا تكوينات تراجع كبيرة** - يتم تصميم النظام ليعمل "فقط" مع الحد الأدنى من الاحتكاك.
+- الثلاثة يعملون مع **التوجيه المحلي في Next.js** على App Router.
+- **Intlayer** يذهب أبعد من ذلك مع **الوسيط الدولي (i18n middleware)** (كشف اللغة عبر الرؤوس/الكوكيز) و**المساعدين** لتوليد عناوين URL محلية ووسوم `<link rel="alternate" hreflang="…">`.
 
-> **النتيجة النهائية**: Intlayer هو حل حديث يريد **دفع أفضل الممارسات**: من **الحفاظ على الترجمات قريبة** من كل مكون React، إلى تقديم **دعم TS قوي** و **سهولة الاستخدام على الجانب الخادم**، بينما **يقلل بشكل كبير من الأكواد المبدئية**.
+**لماذا هذا مهم:** تقليل طبقات الربط المخصصة؛ **تجربة مستخدم متسقة** و**تحسين محركات البحث نظيف** عبر اللغات.
 
 ---
 
-## مقارنة الميزات جنبًا إلى جنب
-
-| **الميزة**                                 | **next-intl**                     | **next-i18next**                                | **Intlayer**                            |
-| ------------------------------------------ | --------------------------------- | ----------------------------------------------- | --------------------------------------- |
-| **الحفاظ على الترجمات بالقرب من المكونات** | جزئي - عادةً مجلد محلي واحد       | ليس افتراضيًا - غالبًا ما يكون `public/locales` | **نعم - موصى به وسهل**                  |
-| **توليد TypeScript تلقائي**                | تعريفات TypeScript أساسية         | دعم TypeScript أساسي                            | **نعم - متقدم خارج الصندوق**            |
-| **اكتشاف الترجمات المفقودة**               | في الغالب سلاسل تراجع             | في الغالب سلاسل تراجع                           | **نعم - فحوصات في وقت البناء**          |
-| **دعم مكونات الخادم**                      | تعمل لكن ليست متخصصة              | مدعومة لكنها قد تكون مرهقة                      | **دعم كامل مع موفري خدمات متخصصين**     |
-| **التوجيه & middleware**                   | مدمج يدويًا مع middleware في Next | موفر عبر إعادة كتابة التكوين                    | **middleware i18n مخصص + روابط متقدمة** |
-| **تعقيد الإعداد**                          | بسيطة، تكوينات الحد الأدنى        | تقليدية، يمكن أن تكون مرهقة للاستخدام المتقدم   | **ملف إعداد واحد وملحق**                |
-
----
+### 5) توافق مكونات الخادم (RSC)
 
-## لماذا Intlayer؟
+- **الجميع** يدعم Next.js 13+.
+- **Intlayer** يسهل **الحد الفاصل بين الخادم والعميل** بواجهة برمجة تطبيقات موحدة ومزودين مصممين لـ RSC، بحيث لا تحتاج إلى تمرير منسقات أو دوال الترجمة عبر شجرة المكونات.
 
-للفرق التي تنتقل إلى أو تبني على **موجه التطبيقات لـ Next.js** (الإصدارات 13، 14، أو 15) مع **مكونات الخادم**، يوفر Intlayer:
+**لماذا هذا مهم:** نموذج ذهني أنظف وحالات حافة أقل في الأشجار المختلطة.
 
-1. **بنية معمارية مبسطة**
+---
 
-   - تحتوي كل مسار أو مكون على ترجماته الخاصة. هذا يعزز الوضوح وقابلية الصيانة.
+### 6) الأداء وسلوك التحميل
 
-2. **تكامل قوي مع TypeScript**
+- **next-intl / next-i18next**: تحكم جزئي عبر **مساحات الأسماء** و**تقسيمات على مستوى المسار**؛ خطر تجميع سلاسل غير مستخدمة إذا تم التراخي في الانضباط.
+- **Intlayer**: يقوم بـ **تحليل الشجرة** أثناء البناء و**تحميل كسول لكل قاموس/لغة**. المحتوى غير المستخدم لا يتم شحنه.
 
-   - تحصل على أمان على مستوى المترجم، مما يتجنب المفاتيح المفقودة أو المليئة بالأخطاء.
+**لماذا هذا مهم:** حزم أصغر وتشغيل أسرع، خاصة على المواقع متعددة اللغات.
 
-3. **تنبيهات حقيقية لترجمات مفقودة**
+---
 
-   - إذا نسيت مفتاحًا أو ترجمة لغة، سيتم تحذيرك عند وقت البناء (بدلاً من شحن واجهة مستخدم غير مكتملة).
+### 7) تجربة المطور، الأدوات والصيانة
 
-4. **توجيه متقدم مدمج**
+- **next-intl / next-i18next**: عادةً ما تقوم بربط منصات خارجية للترجمات وسير العمل التحريري.
+- **Intlayer**: يأتي مع **محرر بصري مجاني** و**نظام إدارة محتوى اختياري** (متوافق مع Git أو خارجي). بالإضافة إلى **امتداد VSCode** لتأليف المحتوى و**ترجمات بمساعدة الذكاء الاصطناعي** باستخدام مفاتيح المزود الخاصة بك.
 
-   - يتضمن اكتشاف محلي تلقائي، وتوليد ديناميكي للمسارات، وإدارة سهله لروابط الـURL المحلية.
-   - لا يتطلب `intlayerMiddleware` القياسية إعادة كتابة مخصصة عميقة.
+**لماذا هذا مهم:** يقلل من تكلفة العمليات ويقصر دورة التواصل بين المطورين ومؤلفي المحتوى.
 
-5. **إعداد موحد**
+---
 
-   - كود بسيط: فقط عرّف `intlayer.config.ts`،Wrap `next.config` مع `withIntlayer`، وأضف middleware الرسمي.
-   - استخدام واضح ومباشر لكل من **مكونات الخادم** و **العميل** عبر `IntlayerServerProvider` و `IntlayerClientProvider`.
+## متى تختار أي منها؟
 
-6. **صديق SEO**
-   - المساعدة المدمجة (`getMultilingualUrls`، سمات `hrefLang`، إلخ) تسهل إنتاج صفحات وخ خرائط مواقع متوافقة مع SEO.
+- **اختر next-intl** إذا كنت تريد حلاً **بسيطًا**، وتشعر بالراحة مع الكتالوجات المركزية، وكان تطبيقك **صغير إلى متوسط الحجم**.
+- **اختر next-i18next** إذا كنت تحتاج إلى **نظام الإضافات الخاص بـ i18next** (مثل قواعد ICU المتقدمة عبر الإضافات) وكان فريقك يعرف i18next بالفعل، مع قبول **المزيد من التهيئة** من أجل المرونة.
+- **اختر Intlayer** إذا كنت تقدر **المحتوى المخصص للمكونات**، و**TypeScript الصارم**، و**ضمانات وقت البناء**، و**إزالة الشفرات غير المستخدمة (tree-shaking)**، وأدوات التوجيه/SEO/التحرير المدمجة - خاصةً لـ **Next.js App Router** وقواعد الشفرات الكبيرة والمودولية.
 
 ---
 
-## مثال: Intlayer في العمل
-
-فيما يلي مقتطف مختصر جداً يوضح كيفية استخدام Intlayer في مشروع Next.js 15. لمزيد من التفاصيل وأمثلة الكود، [تحقق من دليل Intlayer الكامل](#).
-
-<details>
-<summary>مثال خطوة بخطوة</summary>
-
-1. **التثبيت والتكوين**
-
-   ```bash
-   npm install intlayer next-intlayer
-   ```
-
-   ```ts
-   // intlayer.config.ts
-   import { Locales, type IntlayerConfig } from "intlayer";
-
-   const config: IntlayerConfig = {
-     internationalization: {
-       locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
-       defaultLocale: Locales.ENGLISH,
-     },
-   };
-   export default config;
-   ```
-
-2. **استخدم المكون الإضافي**
-
-   ```ts
-   // next.config.mjs
-   import { withIntlayer } from "next-intlayer/server";
-
-   /** @type {import('next').NextConfig} */
-   const nextConfig = {};
-
-   export default withIntlayer(nextConfig);
-   ```
-
-3. **أضف Middleware**
-
-   ```ts
-   // src/middleware.ts
-   export { intlayerMiddleware as middleware } from "next-intlayer/middleware";
-
-   export const config = {
-     matcher:
-       "/((?!api|static|assets|robots|sitemap|sw|service-worker|manifest|.*\\..*|_next).*)",
-   };
-   ```
-
-4. **إنشاء تخطيط محلي**
-
-   ```tsx
-   // src/app/[locale]/layout.tsx
-   import { getHTMLTextDir } from "intlayer";
-   import { NextLayoutIntlayer } from "next-intlayer";
-
-   const LocaleLayout: NextLayoutIntlayer = async ({ children, params }) => {
-     const { locale } = params;
-     return (
-       <html lang={locale} dir={getHTMLTextDir(locale)}>
-         <body>{children}</body>
-       </html>
-     );
-   };
-
-   export { generateStaticParams } from "next-intlayer";
-   export default LocaleLayout;
-   ```
-
-5. **إعلان واستخدام المحتوى**
-
-   ```tsx
-   // src/app/[locale]/page.content.ts
-   import { t } from "intlayer";
-
-   export default {
-     key: "page",
-     content: {
-       getStarted: {
-         main: t({
-           en: "Get started by editing",
-           fr: "Commencez par éditer",
-           es: "Comience por editar",
-         }),
-         pageLink: "src/app/page.tsx",
-       },
-     },
-   };
-   ```
-
-   ```tsx
-   // src/app/[locale]/page.tsx
-   import { IntlayerServerProvider } from "next-intlayer/server";
-   import { IntlayerClientProvider, useIntlayer } from "next-intlayer";
-
-   const PageContent = () => {
-     const { content } = useIntlayer("page");
-     return (
-       <>
-         <p>{content.getStarted.main}</p>
-         <code>{content.getStarted.pageLink}</code>
-       </>
-     );
-   };
-
-   export default function Page({ params }) {
-     return (
-       <IntlayerServerProvider locale={params.locale}>
-         <IntlayerClientProvider locale={params.locale}>
-           <PageContent />
-         </IntlayerClientProvider>
-       </IntlayerServerProvider>
-     );
-   }
-   ```
-
-   </details>
+## ملاحظات عملية للترحيل (من next-intl / next-i18next إلى Intlayer)
+
+- **ابدأ بالميزات بشكل منفصل**: انقل مسارًا أو مكونًا واحدًا في كل مرة إلى **القواميس المحلية**.
+- **احتفظ بالكتالوجات القديمة بالتوازي**: استخدم جسرًا أثناء الترحيل؛ تجنب التغيير الجذري المفاجئ.
+- **فعّل الفحوصات الصارمة**: دع اكتشاف وقت البناء يكشف الفجوات مبكرًا.
+- **اعتمد الوسائط الوسيطة والمساعدين**: قم بتوحيد اكتشاف اللغة وعلامات SEO على مستوى الموقع.
+- **قِس حجم الحزم**: توقع **تقليل حجم الحزمة** مع حذف المحتوى غير المستخدم.
 
 ---
 
-## الخاتمة
+## الخلاصة
 
-كل حل, **next-intl**، **next-i18next**، و **Intlayer**, أثبت فعاليته لمشاريع Next.js متعددة اللغات. ومع ذلك، فإن **Intlayer** تذهب أبعد من ذلك من خلال:
+جميع المكتبات الثلاث تنجح في التوطين الأساسي. الفرق هو **كمية العمل التي يجب عليك القيام بها** لتحقيق إعداد قوي وقابل للتوسع في **Next.js الحديث**:
 
-- **تشجيع بناء بنية ترجمة على مستوى المكونات**
-- التكامل بسلاسة مع **Next.js 13+ و مكونات الخادم**
-- تقديم **توليد TypeScript** قوي للشفرة الأكثر أماناً
-- التعامل مع **الترجمات المفقودة** عند بناء الشيفرة
-- توفير **نهج إعداد مبسط**، مع توجيه و middleware متقدمان
+- مع **Intlayer**، فإن **المحتوى المعياري**، و**TypeScript الصارم**، و**السلامة أثناء وقت البناء**، و**حزم الشجرة المهشمة**، و**موجه التطبيقات من الدرجة الأولى + أدوات SEO** هي **الإعدادات الافتراضية**، وليست مهامًا شاقة.
+- إذا كانت فرقك تقدر **قابلية الصيانة والسرعة** في تطبيق متعدد اللغات يعتمد على المكونات، فإن Intlayer تقدم **التجربة الأكثر اكتمالًا** اليوم.
 
-إذا كنت ترغب في ميزات i18n **حديثة** مصممة لموجه تطبيقات Next.js وتبحث عن تجربة **مكتوبة بالكامل** دون ربط يدوي للترجمات المفقودة، أو إعدادات المسار، أو خطوات بناء معقدة، فإن **Intlayer** هي خيار جذاب. فهي لا تقصر من وقت الإعداد الخاص بك فحسب، بل تضمن أيضًا نهجًا أكثر صيانة وقابلية للتوسع للترجمات لفريقك.
+راجع مستند ['لماذا Intlayer؟'](https://intlayer.org/doc/why) لمزيد من التفاصيل.