@intlayer/docs 8.12.4 → 9.0.0-canary.10

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 يضمن الصحة حتى عندما لا يكون استخدام القالب قابلاً للتتبع ثابتاً.

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

@@ -0,0 +1,58 @@
+---
+createdAt: 2026-06-13
+updatedAt: 2026-06-13
+title: الترحيل من Vue I18n إلى Intlayer
+description: تعرّف على كيفية ترحيل تطبيق Vue الخاص بك من vue-i18n إلى Intlayer باستخدام محول التوافق.
+keywords:
+  - vue-i18n
+  - vue
+  - intlayer
+  - ترحيل
+  - توافق
+slugs:
+  - doc
+  - compatibility
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-13
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من Vue I18n إلى Intlayer
+
+إذا كان تطبيق Vue الخاص بك يستخدم حالياً `vue-i18n`، فيمكنك الترحيل إلى Intlayer دون إعادة كتابة المكونات أو خطافات الترجمة. توفر Intlayer محول توافق يعكس بشكل مثالي واجهة برمجية `vue-i18n` بينما يستفيد من الميزات القوية في Intlayer تحت الغطاء.
+
+## ما يجب فعله
+
+للبدء، ما عليك سوى تشغيل أمر التهيئة في مشروعك:
+
+```bash
+npx intlayer init
+```
+
+أثناء التهيئة، سيقوم Intlayer بإعداد ملف التكوين الخاص بك (`intlayer.config.ts`) وتحضير مشروعك للترحيل. ستحتاج فقط إلى إضافة مكوّن Intlayer إلى تكوين Vite لإنشاء اسم مستعار تلقائياً لواردات `vue-i18n`.
+
+```typescript fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+## كيف يعمل تحت الغطاء
+
+يحقن `vueI18nVitePlugin` اسم مستعار module في bundler الخاص بك. أي استيراد لـ `vue-i18n` في codebase الخاص بك سيتم إعادة توجيهه بشكل شفاف إلى `@intlayer/vue-i18n`.
+
+**تحت الغطاء، يتعامل المحول مع صيغة `vue-i18n` المعقدة بشكل أصلي:**
+
+- **الاستيفاء والجمع:** يحل استيفاءات `{name}` و list `{0}`. يتم تحويل جمع pipe (`"car | cars"`) إلى عقد enumeration/plural في Intlayer بناءً على semantics موضعي.
+- **الصيغ:** تقوم وظائف مثل `d()` و `n()` بتغليف `Intl` تحت الغطاء، احترام `datetimeFormats` و `numberFormats` المحددة في خياراتك.
+- **الحالة العامة والمحلية:** `global.locale` معيّن إلى `WritableComputedRef` مدعوم بـ client Intlayer، لذا تتصرف reactivity بالضبط كما هو متوقع (مثل `locale.value = 'fr'`).
+- **التوجيهات:** يتم تسجيل directive `v-t` وتعمل بشكل طبيعي.
+
+يستمر تطبيقك في الإخراج بالضبط كما هو سابقاً، لكن المحتوى مدعوم من قواامس Intlayer الخاصة بك، مما يمنحك سلامة الكود والتحسين الأفضل للـ bundle والتكامل السلس مع CMS.

package/docs/ar/compiler.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2026-03-12
+updatedAt: 2026-06-23
 title: مترجم Intlayer | استخراج المحتوى الآلي للتدويل
 description: قم بأتمتة عملية التدويل الخاصة بك باستخدام مترجم Intlayer. استخرج المحتوى مباشرة من مكوناتك لتحقيق تدويل أسرع وأكثر كفاءة في Vite و Next.js والمزيد.
 keywords:
@@ -29,6 +29,7 @@ history:
   - version: 7.3.1
     date: 2025-11-27
     changes: "إصدار المترجم"
+author: aymericzip
 ---
 
 # مترجم Intlayer | استخراج المحتوى الآلي للتدويل
@@ -59,6 +60,8 @@ history:
 
 ## الاستخدام
 
+> The quickest way to wire the compiler in is the interactive setup: run `npx intlayer init --interactive` and select **Compiler**. On Vite there is nothing to configure — the compiler is plugged in directly through the `intlayerCompiler()` plugin. On Next.js the command scaffolds the `babel.config.js` shown below. The non-interactive `intlayer init` leaves the compiler setup untouched.
+
 <Tabs>
  <Tab value='vite'>
 
@@ -78,12 +81,15 @@ npm install vite-intlayer
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // يضيف إضافة المترجم
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/ar/component_i18n.md

@@ -16,6 +16,7 @@ slugs:
   - i18n
 applicationTemplate: https://github.com/aymericzip/intlayer-vite-react-template
 youtubeVideo: https://www.youtube.com/watch?v=dS9L7uJeak4
+author: aymericzip
 ---
 
 # كيفية جعل المكون متعدد اللغات (i18n) باستخدام Intlayer