@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.5

package/docs/ar/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## إجراءات GitHub المُنشأة تلقائياً
+
+عند تشغيل `intlayer init`، يكتشف Intlayer مدير الحزم الخاص بك (npm أو yarn أو pnpm أو bun) وينشئ سير عملين من إجراءات GitHub تحت `.github/workflows/`، مع أوامر تطابق مدير الحزم هذا:
+
+- **`intlayer-fill.yml`** — في كل طلب دمج، ينشئ القواميس ويشغل `intlayer fill --git-diff --mode complete` لإنشاء الترجمات المفقودة للقواميس المتغيرة، ثم يرسل النتيجة مرة أخرى إلى فرع طلب الدمج.
+- **`intlayer-test.yml`** — في كل طلب دمج، ينشئ القواموس ويشغل `intlayer test`، ويفشل الفحص عندما تكون الترجمات المطلوبة مفقودة للغات المطلوبة.
+
+لن يتم استبدال ملفات سير العمل الموجودة. لتخطي الإنشاء بالكامل، قم بتشغيل:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### توفير وصول الذكاء الاصطناعي لسير العمل fill
+
+ملف `intlayer-fill.yml` المُنشأ يتطلب وصول الذكاء الاصطناعي. يتوفر خياران (مُكوّنان في كتلة `env` في سير العمل):
+
+1. **مفتاح مزود الذكاء الاصطناعي الخاص بك** — أضف سراً `AI_API_KEY` في إعدادات المستودع (Settings → Secrets and variables → Actions). يقوم سير العمل بإعادة توجيهه عبر `--provider` و `--model` و `--api-key`.
+2. **مفاتيح وصول Intlayer CMS** — أضف أسراراً `INTLAYER_CLIENT_ID` و `INTLAYER_CLIENT_SECRET` وربطها في قسم `editor` الخاص بك في `intlayer.config`. مفاتيح وصول CMS تمنح وصول الذكاء الاصطناعي من خلال خادم Intlayer الخلفي.
+
+سير العمل `intlayer-test.yml` لا يتطلب أي وصول للذكاء الاصطناعي.
+
 ## معالجة الأخطاء
 
 - إذا لم يتم تعيين `INTLAYER_PROJECT_CREDENTIALS`، فسيخرج الأمر مع خطأ.

package/docs/ar/cli/fill.md

@@ -47,6 +47,14 @@ bun x intlayer fill
 - يحافظ على الترجمات الموجودة بعدم الكتابة فوقها.
 - يعالج الملفات والأجزاء واللغات بالتوازي باستخدام نظام قائمة انتظار لزيادة السرعة.
 
+## النقاط الرئيسية:
+
+- تقسيم ملفات JSON الكبيرة إلى أجزاء للبقاء ضمن حدود نافذة السياق لنموذج الذكاء الاصطناعي.
+- إعادة محاولة الترجمة إذا كان تنسيق الإخراج غير صحيح.
+- دمج السياق الخاص بالتطبيق والملف لتحسين دقة الترجمة.
+- الحفاظ على الترجمات الموجودة بعدم الكتابة فوقها.
+- معالجة الملفات والأجزاء والإعدادات المحلية بالتوازي باستخدام نظام طابور لزيادة السرعة.
+
 ## الأسماء المستعارة:
 
 - `npx intlayer dictionaries fill`

package/docs/ar/compat/i18n-js.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من i18n-js إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيقك من مكتبة i18n-js إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - i18n-js
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - i18n-js
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من i18n-js إلى Intlayer
+
+الانتقال من مكتبة `i18n-js` إلى Intlayer هو ترحيل محسّن للغاية مصمّم لنقل تكوينات الترجمات الكبيرة إلى نظام حل الملفات المنظم في Intlayer.
+
+## ما يجب فعله
+
+قم بتنفيذ أمر الإعداد التالي في المستودع الخاص بك:
+
+```bash
+npx intlayer init
+```
+
+بعد تحضير `intlayer.config.ts`، يمكنك إضافة اسم مستعار لـ Intlayer إلى تكوين bundler الخاص بك بحيث يستهدف أي استيراد لـ `i18n-js` حزمة التوافق `@intlayer/i18n-js`.
+
+## كيف يعمل تحت الغطاء
+
+يصل `i18n-js` إلى Namespaces من خلال تعبيرات مثل `i18n.t('scope.key', {name})` جنباً إلى جنب مع fallback للغات و mappings جمع محددة.
+
+تحت الغطاء:
+
+- **الاستيفاء:** يقوم محول التوافق بتحليل `%{name}` mappings بسهولة إلى قيمة قاموس runtime المستهدفة.
+- **الجمع:** يستبدل مفاتيح `one/other` الفرعية ويعيّنها مقابل آليات الجمع القوية الأساسية في Intlayer (`Intl.PluralRules`)، مما يجرّد mappings يدوية.
+- **الإصدارات المحلية:** بدلاً من تحميل حمولات اللغات أحادية البلوك عند البدء، يتم تقديم القواميس بشكل أمثل بناءً على إعداد السياق الحالي عبر تكوين Intlayer الأصلي.

package/docs/ar/compat/i18next.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من i18next إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Vanilla JS/TS الخاص بك من i18next إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - i18next
+  - vanilla
+  - javascript
+  - typescript
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من i18next إلى Intlayer
+
+للحصول على برنامج تعليمي مفصل خطوة بخطوة، يرجى مراجعة [دليل الترحيل الكامل من i18next](../migration_from_i18next_to_intlayer.md).
+
+يكرّر Intlayer بشكل مثالي خصائص runtime الأساسية لـ `i18next`. باستخدام حزمة التوافق، يمكن لتطبيقاتك Vanilla أو الوحدات الداخلية الاستمرار في الاستفادة من الصيغة المألوفة.
+
+## ما يجب فعله
+
+للبدء، قم بتهيئة Intlayer في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+إذا كنت تستخدم Vite، فضمّن مكوّن Intlayer لتوجيه الواردات إلى `@intlayer/i18next`:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { i18nextVitePlugin } from "@intlayer/i18next/plugin";
+
+export default defineConfig({
+  plugins: [i18nextVitePlugin()],
+});
+```
+
+## كيف يعمل تحت الغطاء
+
+يقوم `i18nextVitePlugin` بإنشاء اسم مستعار لواردات `i18next` إلى `@intlayer/i18next`، مما يتجنب انتفاخ bundle من استيراد الملفات JSON.
+
+تحت الغطاء:
+
+- **تكوين النموذج:** `createInstance` يحلل بشكل صحيح ويطبق namespace fallbacks أثناء الاستفادة من pipeline الترجمة في Intlayer لاسترجاع القاموس.
+- **الاستيفاء:** دعم أصلي لاستبدالات `{{name}}` و `$t(key)` متداخلة بشكل متكرر.
+- **Context والجمع:** يحدد ويحل صيغ اللاحقة مثل `key_male` و `key_one`/`key_other` تقييمًا ضد `Intl.PluralRules` المعياري.
+- **إرجاع الكائنات:** يستخرج وضع `returnObjects: true` الأشجار بأمان من قواميس Intlayer.

package/docs/ar/compat/index.md

@@ -0,0 +1,51 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: محولات التوافق في Intlayer
+description: ارحل حل i18n الحالي الخاص بك إلى Intlayer دون احتكاك باستخدام محولات التوافق.
+keywords:
+  - توافق
+  - ترحيل
+  - تدويل
+  - i18n
+  - Intlayer
+slugs:
+  - doc
+  - compatibility
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# محولات التوافق في Intlayer
+
+قد يكون ترحيل تطبيق كبير إلى مكتبة تدويل جديدة أمراً محبطاً. لتيسير هذا الانتقال، توفر Intlayer **محولات توافق** لأكثر مكتبات i18n شهرة في النظام البيئي.
+
+تعرّض حزم المحول **نفس واجهة برمجية عامة تماماً** مثل مكتبات i18n الحالية الخاصة بك، لكنها تفوّض جميع عمل الترجمة إلى Intlayer في وقت التشغيل.
+
+## كيف يعمل
+
+عند استخدام محول توافق، لا تحتاج إلى إعادة كتابة واردات التطبيق الخاص بك أو تغيير طريقة استخدام خطافات الترجمة والمكونات الخاصة بك. بدلاً من ذلك، تقوم مكوّنات bundler في Intlayer تلقائياً بإنشاء اسم مستعار للواردات الحالية الخاصة بك إلى حزم التوافق في Intlayer.
+
+على سبيل المثال، يستبدل المطور `import { useTranslation } from 'react-i18next'` بـ `import { useTranslation } from '@intlayer/react-i18next'` (يتم ذلك تلقائياً عبر مكوّن bundler)، والتطبيق يستمر في العمل مع الترجمات التي يتم تقديمها الآن من قواميس Intlayer. يتم أيضاً كتابة المفاتيح ضد قواميس Intlayer الخاصة بك!
+
+## محولات التوافق المتاحة
+
+اختر مكتبتك الحالية أدناه لترى كيفية الترحيل بسلاسة:
+
+- [Vue I18n](./vue-i18n.md)
+- [Transloco](./transloco.md)
+- [React Intl](./react-intl.md)
+- [Svelte I18n](./svelte-i18n.md)
+- [React i18next](./react-i18next.md)
+- [Polyglot.js](./polyglot.md)
+- [NuxtJS I18n](./nuxtjs-i18n.md)
+- [NGX Translate](./ngx-translate.md)
+- [Next Translate](./next-translate.md)
+- [Next Intl](./next-intl.md)
+- [Next i18next](./next-i18next.md)
+- [i18next](./i18next.md)
+- [Lingui](./lingui.md)
+- [I18n-js](./i18n-js.md)

package/docs/ar/compat/lingui.md

@@ -0,0 +1,44 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من Lingui إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيقك من Lingui إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - lingui
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - lingui
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من Lingui إلى Intlayer
+
+إذا كان مشروعك يعتمد حالياً على الترجمة المبنية على macros في Lingui، فإن الانتقال إلى Intlayer يسمح لك بالحفاظ على سير عمل macro الفعال الخاص بك بينما تدعمه بشكل أصلي بإستراتيجية الترجمة JSON في Intlayer.
+
+## ما يجب فعله
+
+للبدء، قم بتهيئة Intlayer في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+يُنشئ هذا الملف `intlayer.config.ts`. تأكد من الاحتفاظ بـ `@lingui/babel-plugin-lingui-macro` / `@lingui/swc-plugin` في خطوة البناء الخاصة بك للتشغيل _قبل_ مترجم Intlayer. بعد ذلك، استخدم اسم مستعار مكوّن bundler لتوجيه `@lingui/core` و `@lingui/react` إلى `@intlayer/lingui`.
+
+## كيف يعمل تحت الغطاء
+
+يستخدم Lingui macros (مثل `` t`Hello ${name}` `` و `<Trans>`) التي يتم ترجمتها إلى استدعاءات runtime مثل `i18n._(id, values)`.
+
+تحت الغطاء:
+
+- **Macros:** يتم ترجمتها بدقة كما حدث من قبل، مما يضمن عدم وجود انقطاع في صيغة المصدر الخاصة بك.
+- **الترجمة في وقت التشغيل:** يستخدم `i18n._()` المُسمى بـ اسم مستعار قواميس Intlayer. يتم تعيين المعرّفات المسماة بشكل صريح والمعرّفات المُجزأة بالكامل باستخدام مكوّنات مزامنة `.po` في Intlayer لتجميع وحذف المفاتيح بشكل آمن.
+- **قدرات ICU:** يبقى الدعم لـ pluralization والتحديد ومتغيرات ICU قوياً بفضل محلل ICU الموحد في Intlayer، مما يضمن نتائج الإخراج المطابقة.

package/docs/ar/compat/next-i18next.md

@@ -0,0 +1,57 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من next-i18next إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Next.js الخاص بك من next-i18next إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - next-i18next
+  - nextjs
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - next-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من next-i18next إلى Intlayer
+
+للحصول على برنامج تعليمي مفصل وكامل خطوة بخطوة، يرجى مراجعة [دليل الترحيل الكامل من next-i18next](../migration_from_next-i18next_to_intlayer.md).
+
+يتعامل Intlayer مع جميع تنفيذات Next.js Pages Router و App Router بشكل شفاف. يسمح استخدام المحول بترحيل تنفيذ `next-i18next` الخاص بك دون إعادة كتابة رمز.
+
+## ما يجب فعله
+
+للبدء، قم بتشغيل:
+
+```bash
+npx intlayer init
+```
+
+هذا ينشئ ملف الإعداد المطلوب في Intlayer. لللتبديل إلى Intlayer خلف الكواليس، قم بتحديث `next.config.ts`:
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+
+const withIntlayer = createNextI18nPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## كيف يعمل تحت الغطاء
+
+يقوم `createNextI18nPlugin` بتكوين السلوك الأصلي لـ Next.js جنباً إلى جنب مع مكوّن `next-intlayer` الأساسي، بحقن جميع أسماء مستعارة Webpack/Turbopack المطلوبة لـ `next-i18next` و `react-i18next` و `i18next`.
+
+تحت الغطاء:
+
+- **`serverSideTranslations` و `appWithTranslation`:** يعملان الآن كـ wrappers لمحملات Intlayer الداخلية، متجاوزين حقن JSON الثابتة الكبيرة.
+- **خطافات العميل:** تفوّض فوراً إلى `@intlayer/react-i18next` مع الحفاظ على جميع ميزات التنسيق والجمع والـ namespace المتداخلة.

package/docs/ar/compat/next-intl.md

@@ -0,0 +1,59 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من next-intl إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Next.js الخاص بك من next-intl إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - next-intl
+  - nextjs
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - next-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من next-intl إلى Intlayer
+
+للحصول على برنامج تعليمي مفصل وكامل خطوة بخطوة، يرجى مراجعة [دليل الترحيل الكامل من next-intl](../migration_from_next-intl_to_intlayer.md).
+
+يسمح الترحيل من `next-intl` إلى Intlayer بالحفاظ على التوجيه والصيغة الخاصة بتطبيقك دون تضرر.
+
+## ما يجب فعله
+
+قم بتنفيذ الأمر التالي في المستودع الخاص بك:
+
+```bash
+npx intlayer init
+```
+
+سيؤدي هذا إلى إنشاء ملف `intlayer.config.ts`. في `next.config.ts`، استخدم wrapper المكوّن للحقن السلس لأسماء مستعارة `next-intl` نحو `@intlayer/next-intl`.
+
+```typescript fileName="next.config.ts"
+import type { NextConfig } from "next";
+import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
+
+const withIntlayer = createNextIntlPlugin();
+
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+## كيف يعمل تحت الغطاء
+
+يستبدل wrapper bundler الترجمات، لكن **يترك ميزات `next-intl/navigation` سليمة** (مثل `Link` و `redirect` و `usePathname`).
+
+تحت الغطاء:
+
+- **ICU runtime:** تعمل علامات الجمع (`=0` و `one` و `other`) و select/selectordinal و `#` والوسائط المنسقة (`{ts, date, long}`) بشكل صحيح باستخدام محلل `resolveMessage(..., 'icu')` المشترك.
+- **`useTranslations()` و `getTranslations()`:** تستخرج استدعاءات النطاق الحافي أول جزء من المفتاح كمعرّف قاموس صحيح. يتم تقسيم الـ namespaces المتداخلة برشاقة إلى مسارات ومحدثات قاموس.
+- **Rich formatting:** يتم تنفيذ `t.rich()` و `t.markup()` بالكامل بشكل أصلي، مما يحول الكود الشبيه بـ HTML إلى أجزاء React المعروضة.
+- **`useFormatter`:** `relativeTime` و `list` و `dateTimeRange` والصيغ المسماة من إعدادات التكوين تنتقل إلى محولات `Intl` الأصلية الأساسية.

package/docs/ar/compat/next-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من Next Translate إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Next.js الخاص بك من next-translate إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - next-translate
+  - nextjs
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - next-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من Next Translate إلى Intlayer
+
+الترحيل من `next-translate` إلى Intlayer هو بديل قريب جداً يحتفظ بالصيغة والعلامات الحالية.
+
+## ما يجب فعله
+
+قم بتهيئة Intlayer في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+سيقوم CLI بتنسيق التكوين الخاص بك. يمكنك بعد ذلك تطبيق مكوّن Intlayer في `next.config.ts`، الذي يحقن أسماء مستعارة subpath في وقت البناء يعيّن `next-translate/useTranslation` إلى `@intlayer/next-translate`.
+
+## كيف يعمل تحت الغطاء
+
+يوفر `next-translate` خطافات مثل `useTranslation('ns')` و `t('ns:key.path')` و مكوّن `<Trans>`.
+
+تحت الغطاء:
+
+- **الاستيفاء والجمع:** يعتمد بشكل وثيق على سلوك محول `react-i18next`. يتم التعامل ديناميكياً مع عناصنات `{{var}}` والجمع المعيّن من اللواحق مثل `key_0` و `key_one` و `key_other`.
+- **مكوّن `<Trans>`:** مدعوم مباشرة لتحليل العلامات الشبيهة بـ HTML جنباً إلى جنب مع prop `components` المبني على array.
+- **Namespaces:** يضمن aliasing subpath أن مراجع `useTranslation` تستهدف namespaces القاموس الداخلية الصحيحة دون تعديل يدوي.

package/docs/ar/compat/ngx-translate.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من NGX-Translate إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Angular الخاص بك من ngx-translate إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - ngx-translate
+  - angular
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - ngx-translate
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من NGX-Translate إلى Intlayer
+
+ترحيل تطبيق Angular الخاص بك من `ngx-translate` إلى Intlayer سهل مع محول التوافق، مما يسمح لك بتجاوز الحاجة إلى إعادة كتابة جميع قوالبك.
+
+## ما يجب فعله
+
+ابدأ بتشغيل:
+
+```bash
+npx intlayer init
+```
+
+هذا ينشئ `intlayer.config.ts`. استبدل إعدادات `TranslateModule.forRoot()` وأسماء الاستيراد بشكل مناسب للإشارة إلى `@intlayer/ngx-translate`.
+
+## كيف يعمل تحت الغطاء
+
+يستخدم `ngx-translate` `TranslateService` (`instant` و `get` و `stream`) جنباً إلى جنب مع pipe `{{ 'KEY' | translate:params }}` و directive `[translate]`.
+
+تحت الغطاء:
+
+- **الخدمات:** `TranslateService` يغلّف `getIntlayer` و observable محلية، مما يوفر بالضبط نفس الأساليب.
+- **Pipes والتوجيهات:** معاد تنفيذها لحل مقابل قواميس Intlayer مباشرة.
+- **Loaders:** إعدادات `TranslateHttpLoader` يتم تحويلها إلى stubs تحذيرات لأن Intlayer بشكل متأصل يحل ويجمّع قواميسك في وقت البناء (أو من خلال الواردات الديناميكية القياسية)، مما يلغي تماماً الحاجة إلى محملات HTTP.

package/docs/ar/compat/nuxtjs-i18n.md

@@ -0,0 +1,46 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من NuxtJS I18n إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Nuxt.js الخاص بك من @nuxtjs/i18n إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - nuxtjs-i18n
+  - nuxt
+  - vue
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - nuxtjs-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من NuxtJS I18n إلى Intlayer
+
+ترحيل تطبيق Nuxt الخاص بك من `@nuxtjs/i18n` إلى Intlayer هو عملية سلسة باستخدام وحدة محول Nuxt.
+
+## ما يجب فعله
+
+لتهيئة المشروع، قم بتشغيل:
+
+```bash
+npx intlayer init
+```
+
+سيؤدي هذا إلى إعداد `intlayer.config.ts`. بعد ذلك، أضف وحدة Intlayer Nuxt (مثل `@intlayer/nuxt-i18n`) في مصفوفة modules في `nuxt.config.ts`. هذا يطبق تلقائياً تكوين التوافق لتطبيقك.
+
+## كيف يعمل تحت الغطاء
+
+يغلّف `@nuxtjs/i18n` `vue-i18n` مع توفير composables محددة لـ Nuxt (`useLocalePath` و `useSwitchLocalePath` و `<NuxtLinkLocale>`).
+
+تحت الغطاء:
+
+- **الترجمات:** تعتمد بشكل أصلي على طبقة التوافق `@intlayer/vue-i18n` لجميع مهام ترجمة السلسلة (دعم كامل لصيغ `vue-i18n` و pipe جمع و reactivity).
+- **التوجيه:** يعكس composables التوجيه باستخدام مساعدات URL المحلاة في Intlayer.
+- **التكوين:** يقرأ `availableLocales` والإعدادات الافتراضية مباشرة من `intlayer.config.ts` الخاص بك لتنسيق صفحات Nuxt تلقائياً.

package/docs/ar/compat/polyglot.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من Polyglot.js إلى Intlayer
+description: تعرّف على كيفية الترحيل من Polyglot.js إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - polyglot
+  - airbnb
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - polyglot
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من Polyglot.js إلى Intlayer
+
+إذا كنت تستخدم Polyglot.js من Airbnb، فإن الترحيل إلى Intlayer سهل جداً باستخدام طبقة التوافق.
+
+## ما يجب فعله
+
+ما عليك سوى تشغيل أمر التهيئة في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+هذا ينشئ `intlayer.config.ts`. يمكنك بعد ذلك استخدام اسم مستعار مكوّن bundler لإعادة توجيه واردات Polyglot بشكل شفاف إلى `@intlayer/polyglot`.
+
+## كيف يعمل تحت الغطاء
+
+يعتمد syntax Polyglot.js عادة على `polyglot.t('key', {name})` مع استيفاءات `%{name}` و جمع `smart_count` مفصولة بـ `"singular |||| plural"`.
+
+تحت الغطاء:
+
+- **الاستيفاء:** تتعامل طبقة التوافق مع عناصن `%{var}` بشكل أصلي.
+- **الجمع:** يتم تقسيم السلسلة عند `||||` وتقييمها مقابل `Intl.PluralRules` الأصلي وفقاً للمحلية النشطة، مما يعكس ترتيب الحزم الخاص بـ Polyglot لكل محلية.
+- **القواميس:** تتجاوز الحاجة إلى توفير تكوينات JSON ضخمة لـ `new Polyglot()` – Intlayer يتعامل مع القواامس ديناميكياً ويزيل التكرار منها تلقائياً.

package/docs/ar/compat/react-i18next.md

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من react-i18next إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق React الخاص بك من react-i18next إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - react-i18next
+  - i18next
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - react-i18next
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من react-i18next إلى Intlayer
+
+للحصول على برنامج تعليمي مفصل وكامل خطوة بخطوة، يرجى مراجعة [دليل الترحيل الكامل من react-i18next](../migration_from_react-i18next_to_intlayer.md).
+
+يسمح استخدام محول التوافق في Intlayer بترحيل من `react-i18next` دون أي تغييرات على واردات الكود المصدري الخاص بك.
+
+## ما يجب فعله
+
+لتهيئة المشروع، قم بتشغيل:
+
+```bash
+npx intlayer init
+```
+
+أثناء التهيئة، سيقوم Intlayer بتثبيت `@intlayer/react-i18next` وإنشاء `intlayer.config.ts`. في bundler الخاص بك (مثل Vite)، طبّق مكوّن Intlayer:
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { reactI18nextVitePlugin } from "@intlayer/react-i18next/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactI18nextVitePlugin()],
+});
+```
+
+## كيف يعمل تحت الغطاء
+
+يغلّف `reactI18nextVitePlugin` مكوّن `vite-intlayer` الأساسي ويحقن اسم مستعار resolve لـ `react-i18next` و `i18next`، مما يعيد توجيهها إلى `@intlayer/react-i18next` و `@intlayer/i18next`.
+
+تحت الغطاء:
+
+- **`useTranslation` و `withTranslation`:** معاد كتابتها لاستخدام خطافات Intlayer الأصلية، مما يمنحك إكمال تلقائي لـ TypeScript لمفاتيح القاموس الخاصة بك. يدعم بسلاسة namespaces (مثل `t('namespace:key')`).
+- **الجمع والسياق:** يتعامل مع جمع i18next المبني على اللاحقات (`key_one` و `key_other`) باستخدام `Intl.PluralRules` الأصلي ولواحق السياق (`key_male`).
+- **مكوّن `<Trans>`:** معاد تنفيذه لدعم prop `components`، صيغ الكائن والمصفوفة، والعلامات المرقمة `<1>...</1>` المعيّنة مباشرة إلى عقد React الخاصة بك.
+- **نموذج `i18n`:** يحل المفاتيح مباشرة من Intlayer دون جلب ملفات JSON كبيرة، مما يؤدي إلى أحجام bundle أصغر بشكل كبير.

package/docs/ar/compat/react-intl.md

@@ -0,0 +1,55 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من React Intl إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق React الخاص بك من react-intl إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - react-intl
+  - formatjs
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - react-intl
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من React Intl إلى Intlayer
+
+إذا كان تطبيق React الخاص بك يستخدم `react-intl` (FormatJS)، فإن الانتقال إلى Intlayer سهل جداً. تتعامل طبقة التوافق الخاصة بنا بسلاسة مع ICU MessageFormat وجميع مكونات `Formatted*` الموجودة.
+
+## ما يجب فعله
+
+ابدأ بتشغيل أمر التهيئة في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+بعد ذلك، قم بإعداد مكوّن Intlayer Vite أو Next.js في التكوين الخاص بك. يقوم هذا المكوّن بحقن أسماء مستعارة في وقت البناء لإعادة توجيه واردات `react-intl` إلى `@intlayer/react-intl`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import reactIntlVitePlugin from "@intlayer/react-intl/plugin";
+
+export default defineConfig({
+  plugins: [react(), reactIntlVitePlugin()],
+});
+```
+
+## كيف يعمل تحت الغطاء
+
+يقوم مكوّن bundler بإنشاء اسم مستعار لـ `react-intl` إلى `@intlayer/react-intl`. بدلاً من تحليل ملفات JSON كبيرة يدويًا وتغليف تطبيقك في `IntlProvider`، يستخرج مكوّن Intlayer بشكل ثابت المفاتيح ويستخدم قواامس Intlayer في وقت التشغيل.
+
+تحت الغطاء:
+
+- **ICU MessageFormat:** يستخدم Intlayer محلل `resolveMessage(..., 'icu')` الذي يدعم بشكل كامل جمع ICU والتحديد وتنسيق التاريخ/الرقم والعلامات النصية الغنية بشكل أصلي.
+- **استدعاءات الطرق و JSX:** يتم تحديد `intl.formatMessage({ id: 'a.b' })` و `<FormattedMessage id="a.b">` بواسطة مكوّنات مترجم Intlayer (`@intlayer/babel` / `@intlayer/swc`)، وتحويل المفاتيح المنقوطة المسطحة بحيث يحل القسم الأول بشكل صحيح إلى مفتاح قاموس Intlayer.
+- **المحولات:** `<FormattedNumber>` و `<FormattedDate>` وما إلى ذلك، تنتقل إلى مصدر `core/formatters` الأصلي باستخدام `Intl`.