@intlayer/docs 9.0.0-canary.2 → 9.0.0-canary.20

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:
@@ -60,6 +60,8 @@ author: aymericzip
 
 ## الاستخدام
 
+> 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'>
 
@@ -79,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/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-06-17
+updatedAt: 2026-07-11
 title: الإعدادات (Configuration)
 description: تعرف على كيفية إعداد Intlayer لتطبيقك. افهم الإعدادات والخيارات المختلفة المتاحة لتخصيص Intlayer وفقًا لاحتياجاتك.
 keywords:
@@ -14,6 +14,12 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.0.0
+    date: 2026-07-11
+    changes: "إضافة إعدادات `analytics`"
+  - version: 9.0.0
+    date: 2026-06-24
+    changes: "Add `enableProxy` option to the routing configuration"
   - version: 8.10.0
     date: 2026-06-17
     changes: "إضافة خيار `format` إلى تكوين القاموس"
@@ -352,6 +358,30 @@ const config: IntlayerConfig = {
     liveSync: true,
   },
 
+  /**
+   * إعدادات التحليلات (analytics).
+   */
+  analytics: {
+    /**
+     * ما إذا كان جمع بيانات التحليلات مفعّلاً (مشاهدات الصفحات، حالات ظهور المحتوى، أحداث A/B).
+     * يتطلب ضبط `editor.clientId` من أجل الإسناد (attribution).
+     * الافتراضي: false
+     */
+    enabled: true,
+
+    /**
+     * المللي ثانية بين عمليات الإرسال المجمّعة التلقائية إلى الخادم الخلفي.
+     * الافتراضي: 20000
+     */
+    flushInterval: 20000,
+
+    /**
+     * نسبة الجلسات المراد تسجيلها، من 0 (لا شيء) إلى 1 (الكل).
+     * الافتراضي: 1
+     */
+    sampleRate: 1,
+  },
+
   /**
    * إعدادات الترجمة والتوليد باستخدام الذكاء الاصطناعي.
    */
@@ -658,6 +688,20 @@ export default config;
 
 ---
 
+### إعدادات التحليلات (Analytics)
+
+يحدد الإعدادات المتعلقة بتحليلات Intlayer: جمع بيانات حول المحتوى الذي يُعرض فعليًا للمستخدمين (مشاهدات الصفحات، حالات ظهور المحتوى) وتمكين اختبارات A/B على المحتوى.
+
+التحليلات اختيارية بشكل صارم (opt-in): لا يتم جمع أي شيء ما لم يتم ضبط `analytics.enabled` صراحةً على `true` **و** تكوين مفتاح مشروع (`editor.clientId`) من أجل الإسناد. عند التعطيل (الوضع الافتراضي)، تتم إزالة تكامل التحليلات بالكامل من حزمة تطبيقك (dead-code elimination).
+
+| الحقل           | الوصف                                                                         | النوع     | الافتراضي | المثال  | ملاحظة                                                                                                     |
+| --------------- | ----------------------------------------------------------------------------- | --------- | --------- | ------- | ---------------------------------------------------------------------------------------------------------- |
+| `enabled`       | يُفعّل جمع بيانات التحليلات (مشاهدات الصفحات، حالات ظهور المحتوى، أحداث A/B). | `boolean` | `false`   | `true`  | يتطلب ضبط `editor.clientId` من أجل الإسناد؛ وإلا تبقى التحليلات معطّلة حتى لو كانت `enabled` تساوي `true`. |
+| `flushInterval` | المللي ثانية بين عمليات الإرسال المجمّعة التلقائية إلى الخادم الخلفي.         | `number`  | `20000`   | `10000` |                                                                                                            |
+| `sampleRate`    | نسبة الجلسات المراد تسجيلها، من `0` (لا شيء) إلى `1` (الكل).                  | `number`  | `1`       | `0.5`   | أخذ العينات حتمي لكل جلسة، لذا فإن الجلسة المسجَّلة تُبلّغ عن جميع أحداثها (دون قوائم تحويل جزئية).        |
+
+---
+
 ### إعدادات التوجيه (Routing)
 
 الإعدادات التي تتحكم في سلوك التوجيه، بما في ذلك بنية رابط URL، وتخزين اللغة، وإدارة البرمجيات الوسيطة.
@@ -875,6 +919,21 @@ export default config;
 
 ---
 
+### إعدادات النظام
+
+الإعدادات المتعلقة بالمسارات الداخلية ونتائج المخرجات في Intlayer. عادةً ما تكون هذه الإعدادات داخلية ولا يجب أن يحتاج المستخدم إلى تعديلها.
+
+| الحقل                     | الوصف                                                                          | النوع    | القيمة الافتراضية                 | مثال                 | ملاحظة                                          |
+| ------------------------- | ------------------------------------------------------------------------------ | -------- | --------------------------------- | -------------------- | ----------------------------------------------- |
+| `baseDir`                 | المجلد الأساسي للمشروع.                                                        | `string` | `process.cwd()`                   | `'/path/to/project'` | يُستخدم لحل جميع المجلدات المتعلقة بـ Intlayer. |
+| `dictionariesDir`         | مسار المجلد لتخزين قواميس التوطين.                                             | `string` | `'.intlayer/dictionary'`          |                      |                                                 |
+| `moduleAugmentationDir`   | المجلد المخصص لتعزيز الوحدات، مما يسمح بتحسين اقتراحات IDE والتحقق من الأنواع. | `string` | `'.intlayer/types'`               | `'intlayer-types'`   | تأكد من تضمينها في `tsconfig.json`.             |
+| `unmergedDictionariesDir` | المجلد لتخزين القواامس غير المدمجة.                                            | `string` | `'.intlayer/unmerged_dictionary'` |                      |                                                 |
+| `typesDir`                | المجلد لتخزين أنواع القاموس.                                                   | `string` | `'.intlayer/types'`               |                      |                                                 |
+| `mainDir`                 | المجلد حيث يتم تخزين ملفات التطبيق الرئيسية.                                   | `string` | `'.intlayer/main'`                |                      |                                                 |
+| `configDir`               | المجلد حيث يتم تخزين ملفات الإعدادات.                                          | `string` | `'.intlayer/config'`              |                      |                                                 |
+| `cacheDir`                | المجلد حيث يتم تخزين ملفات الذاكرة المؤقتة.                                    | `string` | `'.intlayer/cache'`               |                      |                                                 |
+
 ### إعدادات القاموس (Dictionary)
 
 المعالم التي تتحكم في عمليات القاموس، بما في ذلك سلوك الملء التلقائي وتوليد المحتوى.
@@ -983,22 +1042,6 @@ dictionary: {
 
 ---
 
-### إعدادات النظام (System)
-
-هذه الإعدادات مخصصة لحالات الاستخدام المتقدمة والإعدادات الداخلية لـ Intlayer.
-
-| الحقل                     | الوصف                                    | النوع    | الافتراضي                         | مثال | ملاحظة |
-| ------------------------- | ---------------------------------------- | -------- | --------------------------------- | ---- | ------ |
-| `dictionariesDir`         | المجلد للقواميس المحولة برمجياً.         | `string` | `'.intlayer/dictionary'`          |      |        |
-| `moduleAugmentationDir`   | المجلد لتوسيع وحدات TypeScript.          | `string` | `'.intlayer/types'`               |      |        |
-| `unmergedDictionariesDir` | المجلد لتخزين القواميس غير المدمجة.      | `string` | `'.intlayer/unmerged_dictionary'` |      |        |
-| `typesDir`                | المجلد للأنواع المولدة.                  | `string` | `'.intlayer/types'`               |      |        |
-| `mainDir`                 | المجلد لملف Intlayer الرئيسي.            | `string` | `'.intlayer/main'`                |      |        |
-| `configDir`               | المجلد لملفات الإعدادات المحولة برمجياً. | `string` | `'.intlayer/config'`              |      |        |
-| `cacheDir`                | المجلد لملفات التخزين المؤقت.            | `string` | `'.intlayer/cache'`               |      |        |
-
----
-
 ### إعدادات المترجم (Compiler)
 
 الإعدادات التي تتحكم في مترجم Intlayer، الذي يستخرج القواميس مباشرة من مكوناتك.

package/docs/ar/custom_domains.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-02
-updatedAt: 2026-04-02
+updatedAt: 2026-06-23
 title: نطاقات مخصصة (Custom Domains)
 description: تعرف على كيفية تكوين توجيه اللغات القائم على النطاق في Intlayer لخدمة لغات مختلفة من أسماء مضيفين مخصصة.
 keywords:
@@ -172,10 +172,16 @@ GET intlayer.zh/about
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/ar/custom_url_rewrites.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-01-26
+updatedAt: 2026-06-23
 title: إعادة كتابة روابط URL مخصصة
 description: تعرّف على كيفية تكوين واستخدام إعادة كتابة روابط URL المخصصة في Intlayer لتحديد مسارات خاصة بكل لغة.
 keywords:
@@ -340,10 +340,16 @@ export function middleware(request: NextRequest) {
 
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
-  plugins: [intlayerProxy()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```