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

package/docs/ar/migration_from_vue-i18n_to_intlayer.md

@@ -0,0 +1,359 @@
+---
+createdAt: 2026-06-05
+updatedAt: 2026-06-05
+title: "الترحيل من vue-i18n إلى Intlayer | التدويل (i18n)"
+description: "تعرّف على كيفية ترحيل تطبيق Vue أو Nuxt الخاص بك من vue-i18n إلى Intlayer — خطوة بخطوة، دون كسر الكود الموجود. استخدم محول التوافق @intlayer/vue-i18n للانتقال بدون انقطاع."
+keywords:
+  - vue-i18n
+  - intlayer
+  - ترحيل
+  - تدويل
+  - i18n
+  - Nuxt
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - migration
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-05
+    changes: "بدء السجل"
+author: aymericzip
+---
+
+# الترحيل من vue-i18n إلى Intlayer
+
+## لماذا الترحيل من vue-i18n إلى Intlayer؟
+
+<AccordionGroup>
+
+<Accordion header="حجم الحزمة">
+
+بدلاً من تحميل ملفات JSON ضخمة في صفحاتك، قم بتحميل فقط المحتوى الضروري. يساعد Intlayer على **تقليل حجم الحزمة والصفحات بما يصل إلى 50%**.
+
+</Accordion>
+
+<Accordion header="سهولة الصيانة">
+
+يسهل تحديد نطاق محتوى التطبيق **الصيانة** للتطبيقات واسعة النطاق. يمكنك نسخ أو حذف مجلد ميزة واحد دون الحاجة لمراجعة كود المحتوى بالكامل. بالإضافة إلى ذلك، Intlayer **مكتوب بشكل كامل** لضمان دقة المحتوى الخاص بك.
+
+Intlayer أيضاً هو الحل ذو **التطوير الأكثر نشاطاً** في نظام i18n البيئي — تُصلح المشاكل بسرعة، وتُضاف محولات إطار عمل جديدة بانتظام، ويتم تحسين API الأساسي بناءً على ملاحظات الإنتاج الحقيقية.
+
+</Accordion>
+
+<Accordion header="وكيل ذكي">
+
+يقلل دمج المحتوى **السياق المطلوب** من نماذج اللغة الكبيرة (LLMs). يأتي Intlayer أيضاً مع مجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة، **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)**، و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة حتى للوكلاء الذكيين.
+
+</Accordion>
+
+<Accordion header="الأتمتة">
+
+استخدم الأتمتة للترجمة في خط أنابيب CI/CD الخاص بك باستخدام نموذج LLM من اختيارك بتكلفة موفر الذكاء الاصطناعي الخاص بك. يوفر Intlayer أيضاً **compiler** لأتمتة استخراج المحتوى، بالإضافة إلى [منصة ويب](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md) لمساعدتك على **الترجمة في الخلفية**.
+
+</Accordion>
+
+<Accordion header="الأداء">
+
+قد يؤدي ربط ملفات JSON الضخمة بالمكونات إلى مشاكل الأداء والاستجابة. يحسّن Intlayer تحميل المحتوى الخاص بك في وقت البناء.
+
+</Accordion>
+
+<Accordion header="التوسع مع غير المطورين">
+
+أكثر من مجرد حل i18n، يوفر Intlayer **[محرر مرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)** ذاتي الاستضافة و**[CMS كامل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)** لمساعدتك على إدارة محتواك متعدد اللغات في **الوقت الفعلي**، مما يجعل التعاون مع المترجمين والكتاب والأعضاء الآخرين في الفريق بسيطاً. يمكن تخزين المحتوى محلياً و/أو بعداً.
+
+</Accordion>
+
+</AccordionGroup>
+
+---
+
+## استراتيجيات الترحيل
+
+هناك استراتيجيتان متكاملتان للترحيل من `vue-i18n` إلى Intlayer:
+
+1. **محول التوافق (موصى به للتطبيقات الموجودة)** — قم بتثبيت `@intlayer/vue-i18n` (لمكونات Vue). تكشف هذه الحزمة عن **نفس API تماماً** من `vue-i18n` ولكن تفوض كل عمل الترجمة إلى Intlayer تحت الغطاء. تحافظ على استدعاءات `$t` و `useI18n()` و `<i18n-t>` الموجودة — التغيير الوحيد هو مسار الاستيراد والتهيئة.
+
+2. **الترحيل الكامل** — استبدل تدريجياً APIs من vue-i18n بـ hooks Intlayer الأصلية (`useIntlayer`) ودمج المحتوى في ملفات `.content.ts` بجانب المكونات الخاصة بك.
+
+يغطي هذا الدليل **الاستراتيجية 1** أولاً (محول التوافق drop-in)، ثم يرشدك عبر الترحيل الكامل الاختياري.
+
+---
+
+## جدول المحتويات
+
+<TOC/>
+
+---
+
+## الترحيل السريع
+
+الخطوات التالية هي الحد الأدنى المطلوب لتشغيل تطبيق `vue-i18n` الموجود على Intlayer بدون تغيير الكود في المكونات.
+
+<Steps>
+
+<Step number={1} title="تثبيت التبعيات">
+
+قم بتثبيت حزم Intlayer الأساسية ومحول التوافق:
+
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> العلم `--interactive` اختياري. استخدم `intlayer-cli init` إذا كنت وكيل ذكي.
+
+> سيكتشف هذا الأمر بيئتك وسيثبت الحزم المطلوبة. على سبيل المثال:
+
+```bash packageManager="npm"
+npm install intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="yarn"
+yarn add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="bun"
+bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+> يمكنك الاحتفاظ بـ `vue-i18n` مثبتة — يستخدم محول التوافق كـ `devDependency` / `peerDependency` لأنواع TypeScript.
+
+</Step>
+
+<Step number={2} title="تكوين Intlayer">
+
+ينشئ أمر `intlayer init` ملف `intlayer.config.ts` بدء. حدثّه ليطابق البيئات المحلية الموجودة لديك وأشر إلى مكوّن `syncJSON` في ملفات الرسائل الخاصة بك:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH,
+      // أضف جميع البيئات المحلية الموجودة لديك هنا
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      // يطابق صيغة ملاصقات vue-i18n: {name}
+      format: "icu",
+      source: ({ locale }) => `./src/locales/${locale}.json`,
+      location: "src/locales",
+    }),
+  ],
+};
+
+export default config;
+```
+
+> **`source`** يعيّن بيئة محلية إلى مسار ملف JSON الخاص بها. **`location`** يخبر مراقب Intlayer أي مجلد للبحث عن التغييرات. يضمن الخيار `format: 'icu'` أن الملاصقات يتم تحليلها بشكل صحيح لـ `vue-i18n`.
+
+</Step>
+
+<Step number={3} title="إضافة مكوّن Intlayer إلى Bundler الخاص بك">
+
+غلّف تكوين bundler الموجود مع مكوّن التوافق. يُنشئ هذا مكوّن Intlayer الأساسي، ويوصل مراقبة المحتوى، و— بشكل حاسم — **يحقن اسم مستعار module** حتى استدعاءات `import … from 'vue-i18n'` الموجودة لديك تُعاد توجيهها بشفافية إلى `@intlayer/vue-i18n` في وقت البناء. لا يلزم تغيير ملفات المصدر.
+
+**لـ Vite:**
+
+```typescript fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import { vueI18nVitePlugin } from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+> `vueI18nVitePlugin()` يغلف مكوّن `intlayer()` من `vite-intlayer` ويضيف اسم مستعار `vue-i18n`. يجمّع المكوّن العادي `intlayer()` من `vite-intlayer` القواامس ولكن **لا** يضيف الاسم المستعار — يمكنك حينها إعادة تسمية الاستيرادات إلى `@intlayer/vue-i18n` يدويياً (انظر الخطوة 4).
+
+**لـ Nuxt:**
+
+إذا كنت تستخدم `@nuxtjs/i18n` (تكامل Nuxt)، قم بتثبيت `nuxt-intlayer` وأضفها إلى `nuxt.config.ts` الخاص بك:
+
+```bash packageManager="npm"
+npm install nuxt-intlayer
+```
+
+```typescript fileName="nuxt.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+export default defineNuxtConfig({
+  modules: ["nuxt-intlayer"],
+  // يمكنك إزالة @nuxtjs/i18n من مكوّنات الخاصة بك بأمان
+});
+```
+
+> **لا تحتاج بعد الآن إلى `createI18n()` أو bootstrap provider يدويياً.** يجمّع Intlayer جميع القواامس في **وقت البناء**، حيث لا توجد خطوة تحميل runtime. يتولى provider المُحتفَظ به التهيئة لك.
+
+</Step>
+
+</Steps>
+
+هذا كل شيء للترحيل السريع. يعمل التطبيق الخاص بك الآن على Intlayer مع الاحتفاظ بكل استيراد ومكون API من `vue-i18n`.
+
+> **مفاتيح ترجمة مكتوبة — تلقائي.** بمجرد أن يجمّع Intlayer القواامس الخاصة بك، يُكتب `useI18n` مقابل المحتوى الفعلي الخاص بك عندما تمرر خيار `namespace`. يتم إكمال المفاتيح تلقائياً في IDE الخاص بك وتسبب المسارات غير الصحيحة أخطاء TypeScript في وقت البناء — لا يلزم أي إعداد إضافي.
+>
+> ```ts
+> // 'about' هو مفتاح قاموس مسجل
+> const { t } = useI18n({ namespace: "about" });
+> t("counter.label"); // ✓ مكمل تلقائياً
+> t("does.not.exist"); // ✗ خطأ TypeScript
+> ```
+
+---
+
+## الترحيل الكامل
+
+الخطوات أدناه اختيارية ويمكن إنجازها بشكل تدريجي. تفتح مجموعة ميزات Intlayer الكاملة: محرر مرئي، CMS، ملفات محتوى مكتوبة، ترجمة مدفوعة بالذكاء الاصطناعي، والمزيد.
+
+<Steps>
+
+<Step number={4} title="إعادة تسمية الاستيراد الصريحة (اختياري)" isOptional={true}>
+
+تتعامل مكوّنات Intlayer بالفعل مع الأسماء المستعارة على مستوى bundler. إذا كنت تفضل جعل التبعية صريحة في ملفات المصدر الخاصة بك، يمكنك إعادة تسمية الاستيرادات يدويياً:
+
+| قبل                                     | بعد                                               |
+| --------------------------------------- | ------------------------------------------------- |
+| `import { useI18n } from 'vue-i18n'`    | `import { useI18n } from '@intlayer/vue-i18n'`    |
+| `import { createI18n } from 'vue-i18n'` | `import { createI18n } from '@intlayer/vue-i18n'` |
+
+هذه **بدائل drop-in** — لا تغييرات في توقيعات الدالة أو الحجج أو أنواع الإرجاع مطلوبة.
+
+</Step>
+
+<Step number={5} title="تفعيل أتمتة الترجمة المدفوعة بالذكاء الاصطناعي" isOptional={true}>
+
+بمجرد توصيل Intlayer، استخدم CLI الخاص به لملء الترجمات المفقودة تلقائياً:
+
+```bash packageManager="npm"
+# اختبر الترجمات المفقودة (أضف إلى CI)
+npx intlayer test
+
+# ملء الترجمات المفقودة بـ AI
+npx intlayer fill
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer test
+pnpm intlayer fill
+```
+
+```bash packageManager="yarn"
+yarn intlayer test
+yarn intlayer fill
+```
+
+```bash packageManager="bun"
+bun x intlayer test
+bun x intlayer fill
+```
+
+أضف تكوين AI إلى `intlayer.config.ts`:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./src/locales/${locale}.json`,
+      location: "src/locales",
+    }),
+  ],
+  ai: {
+    apiKey: process.env.OPENAI_API_KEY,
+    // provider: "openai",     // افتراضي
+    // model: "gpt-4o-mini",   // افتراضي
+  },
+};
+
+export default config;
+```
+
+> انظر [وثائق Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/index.md) لجميع الخيارات المتاحة.
+
+</Step>
+
+</Steps>
+
+---
+
+## ما يمكنك حذفه بعد الترحيل
+
+بمجرد وضع محولات التوافق، يمكن إزالة نموذج `vue-i18n` التالي:
+
+| الملف / النمط                      | لماذا لم تعد هناك حاجة                                                                                              |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| استدعاءات `createI18n()`           | تهيّئ provider من Intlayer كل شيء تلقائياً؛ لا توجد خطوة تحميل runtime.                                             |
+| تسجيل Vue plugin (`app.use(i18n)`) | يتولى مكوّن Intlayer الحقن والـ bootstrapping تحت الغطاء.                                                           |
+| حزم اللغات JSON (`locales/*.json`) | تُحتاج حزم JSON فقط إذا كنت تستخدم مكوّن `syncJSON` بعد. بمجرد الترحيل إلى ملفات `.content.ts` يمكنك حذف مجلد JSON. |
+
+عندما تكون جاهزاً للمضي أبعد، يكتشف Intlayer **تلقائياً جميع ملفات `.content.ts` و `.content.json` في أي مكان في قاعدة الكود الخاصة بك** (افتراضياً، في أي مكان داخل `./src`). يمكنك وضع ملف `my-component.content.ts` بجانب `MyComponent.vue` مباشرة وسيلتقطه Intlayer في وقت البناء بدون تكوين إضافي — لا استيرادات، لا تسجيل، لا حاجة لملف فهرس مركزي. هذا يجعل دمج الترجمات مع الصفحات والمكونات بدون احتكاك تماماً.
+
+---
+
+## تكوين TypeScript
+
+يستخدم Intlayer module augmentation لتوفير intellisense TypeScript الكامل لمفاتيح الترجمة الخاصة بك. تأكد من أن `tsconfig.json` الخاص بك يتضمن الأنواع المُنتجة تلقائياً:
+
+```json5 fileName="tsconfig.json"
+{
+  // ... تكوينات TypeScript الموجودة لديك
+  "include": [
+    // ... تكوينات TypeScript الموجودة لديك
+    ".intlayer/**/*.ts", // تضمين الأنواع المُنتجة تلقائياً
+  ],
+}
+```
+
+---
+
+## تكوين Git
+
+أضف مجلد Intlayer المُنتج إلى `.gitignore` الخاص بك:
+
+```plaintext fileName=".gitignore"
+# تجاهل الملفات المُنتجة بواسطة Intlayer
+.intlayer
+```
+
+---
+
+## اذهب أبعد
+
+- **محرر مرئي** — إدارة الترجمات بصرياً في متصفحك: [محرر Intlayer المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)
+- **CMS** — خارج الخدمة وإدارة المحتوى بعداً: [CMS Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)
+- **VS Code Extension** — الحصول على الإكمال التلقائي واكتشاف أخطاء الترجمة في الوقت الفعلي: [ملحق Intlayer VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/vs_code_extension.md)
+- **مرجع CLI** — قائمة كاملة بأوامر CLI: [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/index.md)
+- **Intlayer مع Vue** — دليل الإعداد الكامل لـ Vue: [intlayer_with_vite+vue.md](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_vite+vue.md)
+- **Intlayer مع Nuxt** — دليل الإعداد الكامل لـ Nuxt: [intlayer_with_nuxt.md](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_nuxt.md)

package/docs/ar/packages/intlayer/getLocalizedUrl.md

@@ -33,6 +33,36 @@ author: aymericzip
 
 ---
 
+## توقيع الدالة
+
+```typescript
+getLocalizedUrl(
+  url: string,                   // مطلوب
+  currentLocale: Locales,        // مطلوب
+  options?: {                    // اختياري
+    locales?: Locales[];
+    defaultLocale?: Locales;
+    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';
+  }
+): string
+```
+
+---
+
+## المعاملات
+
+### المعاملات المطلوبة
+
+- `url: string`
+  - **Description**: سلسلة URL الأصلية التي سيتم بادئتها بلغة.
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `currentLocale: Locales`
+  - **Description**: اللغة الحالية التي يتم تحديث URL لها.
+  - **Type**: `Locales`
+  - **Required**: Yes
+
 ## المعاملات
 
 - `url: string`
@@ -67,6 +97,25 @@ author: aymericzip
 
 ## مثال على الاستخدام
 
+### الاستخدام الأساسي (المعاملات المطلوبة فقط)
+
+عندما تكون قد قمت بتكوين مشروعك بإعدادات التدويل، يمكنك استخدام الدالة بالمعاملات المطلوبة فقط:
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// يستخدم إعدادات مشروعك للمحليات و defaultLocale و mode
+getLocalizedUrl("/about", Locales.FRENCH);
+// Output: "/fr/about" (افترض أن الفرنسية مدعومة و mode هو 'prefix-no-default')
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// Output: "/about" أو "/en/about" (حسب إعداد mode لديك)
+```
+
+### الاستخدام المتقدم (مع معاملات اختيارية)
+
+يمكنك تجاوز التكوين الافتراضي بتوفير معامل `options` الاختياري:
+
 ### عناوين URL النسبية
 
 ```typescript codeFormat={["typescript", "esm"]}
@@ -114,6 +163,30 @@ getLocalizedUrl(
 // الناتج: "/about" للغة الافتراضية (الإنجليزية)
 ```
 
+### تجاوز الإعدادات الجزئية
+
+يمكنك أيضًا توفير بعض المعاملات الاختيارية فقط. ستستخدم الدالة إعدادات مشروعك لأي معاملات لم تحددها:
+
+```typescript codeFormat="typescript"
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// تجاوز اللغات فقط، استخدم إعدادات المشروع لـ defaultLocale و mode
+getLocalizedUrl("/about", Locales.SPANISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+});
+
+// تجاوز mode فقط، استخدم إعدادات المشروع لـ locales و defaultLocale
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  mode: "prefix-all", // فرض البادئة لجميع اللغات بما في ذلك اللغة الافتراضية
+});
+
+// تجاوز خيارات متعددة
+getLocalizedUrl("/about", Locales.FRENCH, {
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params", // استخدم معاملات الاستعلام: /about?locale=fr
+});
+```
+
 ### عناوين URL المطلقة
 
 ```typescript

package/docs/ar/packages/intlayer/getMultilingualUrls.md

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## الوصف
 
+تقوم دالة `getMultilingualUrls` بإنشاء خريطة من عناوين URL متعددة اللغات عن طريق إضافة بادئة للعنوان المحدد بكل لغة مدعومة. يمكنها التعامل مع عناوين URL المطلقة والنسبية، وتطبيق بادئة اللغة المناسبة بناءً على الإعدادات المقدمة أو الإعدادات الافتراضية.
+
+**الميزات الرئيسية:**
+
+- مطلوب معامل واحد فقط: `url`
+- كائن `options` اختياري يحتوي على `locales` و`defaultLocale` و`mode`
+- يستخدم إعدادات الدولية في مشروعك كإعدادات افتراضية
+- يدعم أوضاع التوجيه المتعددة: `prefix-no-default` و`prefix-all` و`no-prefix` و`search-params`
+- يعيد كائن خريطة مع جميع اللغات كمفاتيح وعناوين URL المقابلة لها كقيم
+
+---
+
+## الوصف
+
 تقوم دالة `getMultilingualUrls` بإنشاء خريطة لعناوين URL متعددة اللغات عن طريق إضافة بادئة لكل عنوان URL المعطى باستخدام كل لغة مدعومة. يمكنها التعامل مع عناوين URL المطلقة والنسبية، وتطبيق بادئة اللغة المناسبة بناءً على التكوين المقدم أو الإعدادات الافتراضية.
 
 ---
 
 ## المعاملات
 
+## المعاملات
+
 - `url: string`
   - **الوصف**: سلسلة عنوان URL الأصلية التي سيتم إضافة بادئات اللغات إليها.
   - **النوع**: `string`
@@ -54,6 +70,33 @@ author: aymericzip
   - **النوع**: `boolean`
   - **الافتراضي**: `prefixDefaultDefault`
 
+### المعاملات الاختيارية
+
+- `options?: object`
+  - **الوصف**: كائن الإعدادات لسلوك تحديد موقع عنوان URL.
+  - **النوع**: `object`
+  - **مطلوب**: لا (اختياري)
+
+  - `options.locales?: Locales[]`
+    - **الوصف**: مصفوفة اللغات المدعومة. إذا لم يتم توفيرها، يتم استخدام اللغات المكونة من إعدادات المشروع الخاص بك.
+    - **النوع**: `Locales[]`
+    - **القيمة الافتراضية**: [`إعدادات المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **الوصف**: اللغة الافتراضية للتطبيق. إذا لم يتم توفيرها، يتم استخدام اللغة الافتراضية المكونة من إعدادات المشروع الخاص بك.
+    - **النوع**: `Locales`
+    - **القيمة الافتراضية**: [`إعدادات المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **الوصف**: وضع توجيه عنوان URL لمعالجة اللغة. إذا لم يتم توفيره، يتم استخدام الوضع المكون من إعدادات المشروع الخاص بك.
+    - **النوع**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **القيمة الافتراضية**: [`إعدادات المشروع`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md#middleware)
+    - **الأوضاع**:
+      - `prefix-no-default`: لا توجد بادئة للغة الافتراضية، بادئة لجميع الأخرى
+      - `prefix-all`: بادئة لجميع اللغات بما فيها الافتراضية
+      - `no-prefix`: لا توجد بادئة لغة في عنوان URL
+      - `search-params`: استخدام معاملات الاستعلام للغة (على سبيل المثال، `?locale=fr`)
+
 ### القيم المرجعة
 
 - **النوع**: `IConfigLocales<string>`
@@ -63,6 +106,20 @@ author: aymericzip
 
 ## مثال على الاستخدام
 
+### الاستخدام الأساسي (استخدام إعدادات المشروع)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// يستخدم إعدادات مشروعك للغات وdefaultLocale والوضع mode
+getMultilingualUrls("/dashboard");
+// الإخراج (بافتراض أن إعدادات المشروع تحتوي على en و fr مع وضع 'prefix-no-default'):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### عناوين URL النسبية
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### أنماط التوجيه المختلفة
+
+```typescript
+// prefix-no-default: بدون بادئة للغة الافتراضية
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// الإخراج: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: بادئة لجميع اللغات
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// الإخراج: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: بدون بادئة اللغة في العناوين
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// الإخراج: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: اللغة كمعامل استعلام
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// الإخراج: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## الحالات الخاصة
 
 - **عدم وجود جزء اللغة:**

package/docs/ar/packages/intlayer/getPathWithoutLocale.md

@@ -52,7 +52,3 @@ console.log(getPathWithoutLocale("/en/dashboard")); // الناتج: "/dashboard
 console.log(getPathWithoutLocale("/fr/dashboard")); // الناتج: "/dashboard"
 console.log(getPathWithoutLocale("https://example.com/en/dashboard")); // الناتج: "https://example.com/dashboard"
 ```
-
-## تاريخ التوثيق
-
-- 5.5.10 - 2025-06-29: بداية السجل

package/docs/ar/packages/react-intlayer/t.md

@@ -188,19 +188,6 @@ const text = t(translations);
 
 ## الخاتمة
 
-تُعد دالة `t` في مكتبة `react-intlayer` أداة قوية ومريحة لإدارة الترجمات المضمنة داخل تطبيقات React الخاصة بك. من خلال دمجها بشكل فعال، تقوم بتحسين قدرات التدويل في تطبيقك، مما يوفر تجربة أفضل للمستخدمين حول العالم.
-
-لمزيد من الاستخدامات التفصيلية والميزات المتقدمة، راجع [توثيق react-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).
-
----
-
-3. **توفير اللغة بشكل متسق**: تأكد من توفير اللغة الخاصة بك بشكل متسق عبر تطبيقك من خلال `IntlayerProvider`.
-4. **الاستفادة من TypeScript**: استخدم أنواع TypeScript لاكتشاف الترجمات المفقودة وضمان سلامة الأنواع.
-
----
-
-## الخاتمة
-
 تُعد دالة `t` في `react-intlayer` أداة قوية ومريحة لإدارة الترجمات المضمنة في تطبيقات React الخاصة بك. من خلال دمجها بشكل فعال، تقوم بتحسين قدرات التدويل في تطبيقك، مما يوفر تجربة أفضل للمستخدمين حول العالم.
 
 للحصول على استخدام أكثر تفصيلاً وميزات متقدمة، راجع [توثيق react-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md).