@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

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`.

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

@@ -0,0 +1,47 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من Svelte I18n إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Svelte الخاص بك من svelte-i18n إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - svelte-i18n
+  - svelte
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - svelte-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من Svelte I18n إلى Intlayer
+
+نقل تطبيق Svelte الخاص بك من `svelte-i18n` إلى Intlayer يستغرق لحظة فقط باستخدام محول التوافق.
+
+## ما يجب فعله
+
+ما عليك سوى تشغيل أمر التهيئة في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+هذا ينشئ `intlayer.config.ts`. تأكد من أن مكوّنات SvelteKit / Vite الخاصة بك ملفوفة بمكوّن اسم Intlayer للعثور على الاسم المستعار لخريطة `svelte-i18n` إلى `@intlayer/svelte-i18n` بسلاسة.
+
+## كيف يعمل تحت الغطاء
+
+يعتمد Svelte-i18n على المتاجر المستخدمة بكثافة (`$_` و `$t` و `$format` وما إلى ذلك) و ICU MessageFormat.
+
+تحت الغطاء:
+
+- **المتاجر:** يقوم Intlayer بعمل وكيل المتاجر `svelte-i18n`. يصبح `$_` متجراً مشتقاً من محلية الحالية يعود حلاً من Intlayer.
+- **المفاتيح:** يتم تقييم مفاتيحك المسطحة (مثل `$_('home.title')`) بحيث يمثل جزء المسار الأول قاموس Intlayer.
+- **صيغة ICU:** يتم التعامل بالكامل من خلال محلل ICU المشترك (تحليل مكافئ `intl-messageformat`).
+- **المحولات:** تنتقل استدعاءات `$date` و `$time` و `$number` بأمان إلى محولات Intlayer الأساسية الأصلية.
+- **تحليل Babel/SWC:** يقرأ محلل Intlayer مستدعيات متجر Svelte (`$_`) داخل ملفات `.svelte` المصدرية قبل الترجمة لبناء أجزاء القاموس ذات الصلة تلقائياً.

package/docs/ar/compat/transloco.md

@@ -0,0 +1,45 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من Transloco إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Angular الخاص بك من Transloco إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - transloco
+  - angular
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - transloco
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من Transloco إلى Intlayer
+
+إذا كان تطبيق Angular الخاص بك يستخدم حالياً `@jsverse/transloco`، فيمكنك الترحيل إلى Intlayer باستخدام محول التوافق الخاص بنا. يسمح هذا الانتقال بالحفاظ على صيغة القالب الموجودة الخاصة بك أثناء استخدام بنية القاموس القوية في Intlayer.
+
+## ما يجب فعله
+
+ما عليك سوى تشغيل أمر التهيئة في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+سيؤدي هذا إلى إنشاء التكوين الضروري `intlayer.config.ts`. ستحتاج بعد ذلك إلى استبدال واردات Transloco الخاصة بك بوحدات `@intlayer/transloco` أو الاعتماد على أسماء المستعار للبناء.
+
+## كيف يعمل تحت الغطاء
+
+يستخدم Transloco scopes و `TranslocoService` (`translate` و `selectTranslate`)، جنباً إلى جنب مع التوجيهات الهيكلية (`*transloco="let t"`) و pipes (`| transloco`).
+
+تحت الغطاء:
+
+- **الـ Scopes:** تعيين طبيعي إلى مفاتيح قاموس Intlayer، مما يوفر قصة قص رائعة لتحسين bundle.
+- **الخدمة والتوجيهات:** يستبدل محول Intlayer الزاوي موفري الخدمات بسلاسة، مما يسمح لأنابيب التوجيهات والقوالب الموجودة الخاصة بك بحل السلاسل مقابل قواامس Intlayer.
+- **التحليل في وقت البناء:** يعترف محلل TypeScript باستدعاءات `instant/get`، وتقليم fallback يضمن الصحة حتى عندما لا يكون استخدام القالب قابلاً للتتبع ثابتاً.