@intlayer/docs 8.4.8 → 8.4.10

package/docs/ar/configuration.md

@@ -16,79 +16,79 @@ slugs:
 history:
   - version: 8.4.0
     date: 2026-03-20
-    changes: إضافة تمثيل الكائن لكل لغة لـ 'compiler.output' و 'dictionary.fill'
+    changes: "إضافة تمثيل الكائن لكل لغة لـ 'compiler.output' و 'dictionary.fill'"
   - version: 8.3.0
     date: 2026-03-11
-    changes: نقل 'baseDir' من إعدادات 'content' إلى إعدادات 'system'
+    changes: "نقل 'baseDir' من إعدادات 'content' إلى إعدادات 'system'"
   - version: 8.2.0
     date: 2026-03-09
-    changes: تحديث خيارات المترجم، إضافة دعم لـ 'output' و 'noMetadata'
+    changes: "تحديث خيارات المترجم، إضافة دعم لـ 'output' و 'noMetadata'"
   - version: 8.1.7
     date: 2026-02-25
-    changes: تحديث خيارات المترجم
+    changes: "تحديث خيارات المترجم"
   - version: 8.1.5
     date: 2026-02-23
-    changes: إضافة خيار المترجم 'build-only' وبادئة القاموس
+    changes: "إضافة خيار المترجم 'build-only' وبادئة القاموس"
   - version: 8.0.6
     date: 2026-02-12
-    changes: إضافة دعم لمزودي Open Router و Alibaba و Amazon و Google Vertex Bedrock و Fireworks و Groq و Hugging Face و Together.ai
+    changes: "إضافة دعم لمزودي Open Router و Alibaba و Amazon و Google Vertex Bedrock و Fireworks و Groq و Hugging Face و Together.ai"
   - version: 8.0.5
     date: 2026-02-06
-    changes: إضافة `dataSerialization` إلى إعدادات الذكاء الاصطناعي
+    changes: "إضافة `dataSerialization` إلى إعدادات الذكاء الاصطناعي"
   - version: 8.0.0
     date: 2026-01-24
-    changes: تم تغيير اسم وضع الاستيراد `live` إلى `fetch` لوصف الآلية الأساسية بشكل أفضل.
+    changes: "تم تغيير اسم وضع الاستيراد `live` إلى `fetch` لوصف الآلية الأساسية بشكل أفضل."
   - version: 8.0.0
     date: 2026-01-22
-    changes: تم نقل إعدادات البناء `importMode` إلى إعدادات `dictionary`.
+    changes: "تم نقل إعدادات البناء `importMode` إلى إعدادات `dictionary`."
   - version: 8.0.0
     date: 2026-01-22
-    changes: إضافة خيار `rewrite` إلى إعدادات التوجيه
+    changes: "إضافة خيار `rewrite` إلى إعدادات التوجيه"
   - version: 8.0.0
     date: 2026-01-18
-    changes: فصل إعدادات النظام عن إعدادات المحتوى. نقل المسارات الداخلية إلى خاصية `system`. إضافة `codeDir` لفصل ملفات المحتوى عن تحويل الكود.
+    changes: "فصل إعدادات النظام عن إعدادات المحتوى. نقل المسارات الداخلية إلى خاصية `system`. إضافة `codeDir` لفصل ملفات المحتوى عن تحويل الكود."
   - version: 8.0.0
     date: 2026-01-18
-    changes: إضافة خيارات القاموس `location` و `schema`
+    changes: "إضافة خيارات القاموس `location` و `schema`"
   - version: 7.5.1
     date: 2026-01-10
-    changes: إضافة دعم لصيغ ملفات JSON5 و JSONC
+    changes: "إضافة دعم لصيغ ملفات JSON5 و JSONC"
   - version: 7.5.0
     date: 2025-12-17
-    changes: إضافة خيار `buildMode`
+    changes: "إضافة خيار `buildMode`"
   - version: 7.0.0
     date: 2025-10-25
-    changes: إضافة إعدادات `dictionary`
+    changes: "إضافة إعدادات `dictionary`"
   - version: 7.0.0
     date: 2025-10-21
-    changes: استبدال `middleware` بإعدادات `routing`
+    changes: "استبدال `middleware` بإعدادات `routing`"
   - version: 7.0.0
     date: 2025-10-12
-    changes: إضافة خيار `formatCommand`
+    changes: "إضافة خيار `formatCommand`"
   - version: 6.2.0
     date: 2025-10-12
-    changes: تحديث خيار `excludedPath`
+    changes: "تحديث خيار `excludedPath`"
   - version: 6.0.2
     date: 2025-09-23
-    changes: إضافة خيار `outputFormat`
+    changes: "إضافة خيار `outputFormat`"
   - version: 6.0.0
     date: 2025-09-21
-    changes: إزالة حقول `dictionaryOutput` و `i18nextResourcesDir`
+    changes: "إزالة حقول `dictionaryOutput` و `i18nextResourcesDir`"
   - version: 6.0.0
     date: 2025-09-16
-    changes: إضافة وضع الاستيراد `live`
+    changes: "إضافة وضع الاستيراد `live`"
   - version: 6.0.0
     date: 2025-09-04
-    changes: استبدال حقل `hotReload` بـ `liveSync` وإضافة حقول `liveSyncPort` و `liveSyncURL`
+    changes: "استبدال حقل `hotReload` بـ `liveSync` وإضافة حقول `liveSyncPort` و `liveSyncURL`"
   - version: 5.6.1
     date: 2025-07-25
-    changes: استبدال `activateDynamicImport` بخيار `importMode`
+    changes: "استبدال `activateDynamicImport` بخيار `importMode`"
   - version: 5.6.0
     date: 2025-07-13
-    changes: تغيير `contentDir` الافتراضي من `['src']` إلى `['.']`
+    changes: "تغيير `contentDir` الافتراضي من `['src']` إلى `['.']`"
   - version: 5.5.11
     date: 2025-06-29
-    changes: إضافة أوامر `docs`
+    changes: "إضافة أوامر `docs`"
 ---
 
 # توثيق إعدادات Intlayer
@@ -563,12 +563,12 @@ export default config;
 
 تحدد الإعدادات المتعلقة بتدويل التطبيق، بما في ذلك اللغات المتاحة واللغة الافتراضية.
 
-| الحقل             | الوصف                                                                                              | النوع       | الافتراضي           | مثال                  | ملاحظة                                                                                                                                                                                                                                                                   |
-| ----------------- | -------------------------------------------------------------------------------------------------- | ---------- | ------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `locales`         | قائمة اللغات المدعومة في التطبيق.                                                                  | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                            |
-| `requiredLocales`  | قائمة اللغات المطلوبة في التطبيق.                                                                  | `string[]` | `[]`                | `[]`                 | • إذا كانت فارغة، فستكون جميع اللغات مطلوبة في وضع `strict`. <br/> • تأكد من تعريف اللغات المطلوبة أيضاً في حقل `locales`.                                                                                           |
-| `strictMode`      | يضمن تنفيذاً قوياً للمحتوى المترجم باستخدام TypeScript.                                             | `string`   | `'inclusive'`       |                      | • إذا كان `"strict"`: تطلب الدالة `t` تعريف كل لغة معلنة — يلقي خطأ إذا كانت إحداها مفقودة أو غير معلنة. <br/> • إذا كان `"inclusive"`: يحذر من اللغات المفقودة ولكنه يسمح باستخدام اللغات الموجودة غير المعلنة. <br/> • إذا كان `"loose"`: يقبل أي لغة موجودة. |
-| `defaultLocale`   | اللغة الافتراضية المستخدمة كاحتياطي في حالة عدم العثور على اللغة المطلوبة.                          | `string`   | `Locales.ENGLISH`   | `'en'`               | تُستخدم لتحديد اللغة عندما لا يتم تحديدها في رابط URL أو الكوكيز أو الهيدر.                                                                                                                                                                                              |
+| الحقل             | الوصف                                                                      | النوع      | الافتراضي           | مثال                 | ملاحظة                                                                                                                                                                                                                                                          |
+| ----------------- | -------------------------------------------------------------------------- | ---------- | ------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `locales`         | قائمة اللغات المدعومة في التطبيق.                                          | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                 |
+| `requiredLocales` | قائمة اللغات المطلوبة في التطبيق.                                          | `string[]` | `[]`                | `[]`                 | • إذا كانت فارغة، فستكون جميع اللغات مطلوبة في وضع `strict`. <br/> • تأكد من تعريف اللغات المطلوبة أيضاً في حقل `locales`.                                                                                                                                      |
+| `strictMode`      | يضمن تنفيذاً قوياً للمحتوى المترجم باستخدام TypeScript.                    | `string`   | `'inclusive'`       |                      | • إذا كان `"strict"`: تطلب الدالة `t` تعريف كل لغة معلنة — يلقي خطأ إذا كانت إحداها مفقودة أو غير معلنة. <br/> • إذا كان `"inclusive"`: يحذر من اللغات المفقودة ولكنه يسمح باستخدام اللغات الموجودة غير المعلنة. <br/> • إذا كان `"loose"`: يقبل أي لغة موجودة. |
+| `defaultLocale`   | اللغة الافتراضية المستخدمة كاحتياطي في حالة عدم العثور على اللغة المطلوبة. | `string`   | `Locales.ENGLISH`   | `'en'`               | تُستخدم لتحديد اللغة عندما لا يتم تحديدها في رابط URL أو الكوكيز أو الهيدر.                                                                                                                                                                                     |
 
 ---
 
@@ -576,20 +576,20 @@ export default config;
 
 تحدد إعدادات المحرر المرئي المدمج، بما في ذلك منفذ الخادم وحالة التفعيل.
 
-| الحقل                         | الوصف                                                                                                                                                               | النوع                               | الافتراضي                             | مثال                                                                                       | ملاحظة                                                                                                                                                                                                                                             |
-| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `applicationURL`             | رابط التطبيق.                                                                                                                                                       | `string`                          | `undefined`                         | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • يُستخدم لتقييد مصدر (origin) المحرر لأسباب أمنية. <br/> • إذا تم تعيينه على `'*'`، يمكن الوصول إلى المحرر من أي مصدر.                                                                                           |
-| `port`                       | المنفذ المستخدم بواسطة خادم المحرر المرئي.                                                                                                                          | `number`                          | `8000`                              |                                                                                                 |                                                                                                                                                                                                                                                      |
-| `editorURL`                  | رابط خادم المحرر.                                                                                                                                                   | `string`                          | `'http://localhost:8000'`           | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • يُستخدم لتقييد المصادر التي يمكنها التواصل مع التطبيق. <br/> • إذا تم تعيينه على `'*'`، يمكن الوصول إليه من أي مصدر. <br/> • يجب تعيينه إذا تم تغيير المنفذ أو استضافة المحرر على نطاق مختلف. |
-| `cmsURL`                     | رابط Intlayer CMS.                                                                                                                                                  | `string`                          | `'https://app.intlayer.org'`        | `'https://app.intlayer.org'`                                                                    |                                                                                                                                                                                                                                                      |
-| `backendURL`                 | رابط الخادم الخلفي.                                                                                                                                                 | `string`                          | `https://back.intlayer.org`         | `http://localhost:4000`                                                                         |                                                                                                                                                                                                                                                      |
-| `enabled`                    | ما إذا كان ينبغي للتطبيق التواصل مع المحرر المرئي.                                                                                                                  | `boolean`                         | `false`                             | `process.env.NODE_ENV !== 'production'`                                                         | • إذا كان `false` ، فلا يمكن للمحرر التواصل مع التطبيق. <br/> • يؤدي تعطيله لبيئات معينة إلى زيادة الأمان.                                                                                                                                       |
-| `clientId`                   | يسمح لحزم intlayer بالتحقق من الهوية على الخادم الخلفي عبر oAuth2. انتقل إلى [intlayer.org/project](https://app.intlayer.org/project) للحصول على رمز الوصول الخاص بك. | `string` &#124; <br/> `undefined` | `undefined`                         |                                                                                                 | يجب الحفاظ على سريته؛ استخدم متغيرات البيئة.                                                                                                                                                                                                        |
-| `clientSecret`               | يسمح لحزم intlayer بالتحقق من الهوية على الخادم الخلفي عبر oAuth2. انتقل إلى [intlayer.org/project](https://app.intlayer.org/project) للحصول على رمز الوصول الخاص بك. | `string` &#124; <br/> `undefined` | `undefined`                         |                                                                                                 | يجب الحفاظ على سريته؛ استخدم متغيرات البيئة.                                                                                                                                                                                                        |
-| `dictionaryPriorityStrategy` | إستراتيجية أولوية القواميس عند وجود قواميس محلية وعن بعد معاً.                                                                                                      | `string`                          | `'local_first'`                     | `'distant_first'`                                                                               | • `'distant_first'`: يعطي الأولوية للقواميس البعيدة على المحلية. <br/> • `'local_first'`: يعطي الأولوية للقواميس المحلية على البعيدة.                                                                                                            |
-| `liveSync`                   | ما إذا كان ينبغي لخادم التطبيق إعادة تحميل المحتوى فوراً عند اكتشاف تغييرات في CMS <br/> المحرر المرئي <br/> الخادم الخلفي.                                           | `boolean`                         | `true`                              | `true`                                                                                          | • عند إضافة/تحديث قاموس، سيقوم التطبيق بتحديث محتوى الصفحة. <br/> • تستهلك المزامنة الحية المحتوى في خادم آخر، مما قد يؤثر قليلاً على الأداء. <br/> • يوصى باستضافة كليهما على نفس الجهاز.                                                     |
-| `liveSyncPort`               | منفذ خادم المزامنة الحية.                                                                                                                                           | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                                                                      |
-| `liveSyncURL`                | رابط خادم المزامنة الحية.                                                                                                                                           | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | يشير افتراضياً إلى localhost؛ يمكن تغييره ليشير إلى خادم مزامنة حية بعيد.                                                                                                                                                                             |
+| الحقل                        | الوصف                                                                                                                                                                 | النوع                             | الافتراضي                           | مثال                                                                                            | ملاحظة                                                                                                                                                                                          |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `applicationURL`             | رابط التطبيق.                                                                                                                                                         | `string`                          | `undefined`                         | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • يُستخدم لتقييد مصدر (origin) المحرر لأسباب أمنية. <br/> • إذا تم تعيينه على `'*'`، يمكن الوصول إلى المحرر من أي مصدر.                                                                         |
+| `port`                       | المنفذ المستخدم بواسطة خادم المحرر المرئي.                                                                                                                            | `number`                          | `8000`                              |                                                                                                 |                                                                                                                                                                                                 |
+| `editorURL`                  | رابط خادم المحرر.                                                                                                                                                     | `string`                          | `'http://localhost:8000'`           | `'http://localhost:3000'` <br/> `'https://example.com'` <br/> `process.env.INTLAYER_EDITOR_URL` | • يُستخدم لتقييد المصادر التي يمكنها التواصل مع التطبيق. <br/> • إذا تم تعيينه على `'*'`، يمكن الوصول إليه من أي مصدر. <br/> • يجب تعيينه إذا تم تغيير المنفذ أو استضافة المحرر على نطاق مختلف. |
+| `cmsURL`                     | رابط Intlayer CMS.                                                                                                                                                    | `string`                          | `'https://app.intlayer.org'`        | `'https://app.intlayer.org'`                                                                    |                                                                                                                                                                                                 |
+| `backendURL`                 | رابط الخادم الخلفي.                                                                                                                                                   | `string`                          | `https://back.intlayer.org`         | `http://localhost:4000`                                                                         |                                                                                                                                                                                                 |
+| `enabled`                    | ما إذا كان ينبغي للتطبيق التواصل مع المحرر المرئي.                                                                                                                    | `boolean`                         | `false`                             | `process.env.NODE_ENV !== 'production'`                                                         | • إذا كان `false` ، فلا يمكن للمحرر التواصل مع التطبيق. <br/> • يؤدي تعطيله لبيئات معينة إلى زيادة الأمان.                                                                                      |
+| `clientId`                   | يسمح لحزم intlayer بالتحقق من الهوية على الخادم الخلفي عبر oAuth2. انتقل إلى [intlayer.org/project](https://app.intlayer.org/project) للحصول على رمز الوصول الخاص بك. | `string` &#124; <br/> `undefined` | `undefined`                         |                                                                                                 | يجب الحفاظ على سريته؛ استخدم متغيرات البيئة.                                                                                                                                                    |
+| `clientSecret`               | يسمح لحزم intlayer بالتحقق من الهوية على الخادم الخلفي عبر oAuth2. انتقل إلى [intlayer.org/project](https://app.intlayer.org/project) للحصول على رمز الوصول الخاص بك. | `string` &#124; <br/> `undefined` | `undefined`                         |                                                                                                 | يجب الحفاظ على سريته؛ استخدم متغيرات البيئة.                                                                                                                                                    |
+| `dictionaryPriorityStrategy` | إستراتيجية أولوية القواميس عند وجود قواميس محلية وعن بعد معاً.                                                                                                        | `string`                          | `'local_first'`                     | `'distant_first'`                                                                               | • `'distant_first'`: يعطي الأولوية للقواميس البعيدة على المحلية. <br/> • `'local_first'`: يعطي الأولوية للقواميس المحلية على البعيدة.                                                           |
+| `liveSync`                   | ما إذا كان ينبغي لخادم التطبيق إعادة تحميل المحتوى فوراً عند اكتشاف تغييرات في CMS <br/> المحرر المرئي <br/> الخادم الخلفي.                                           | `boolean`                         | `true`                              | `true`                                                                                          | • عند إضافة/تحديث قاموس، سيقوم التطبيق بتحديث محتوى الصفحة. <br/> • تستهلك المزامنة الحية المحتوى في خادم آخر، مما قد يؤثر قليلاً على الأداء. <br/> • يوصى باستضافة كليهما على نفس الجهاز.      |
+| `liveSyncPort`               | منفذ خادم المزامنة الحية.                                                                                                                                             | `number`                          | `4000`                              | `4000`                                                                                          |                                                                                                                                                                                                 |
+| `liveSyncURL`                | رابط خادم المزامنة الحية.                                                                                                                                             | `string`                          | `'http://localhost:{liveSyncPort}'` | `'https://example.com'`                                                                         | يشير افتراضياً إلى localhost؛ يمكن تغييره ليشير إلى خادم مزامنة حية بعيد.                                                                                                                       |
 
 ---
 
@@ -597,12 +597,12 @@ export default config;
 
 الإعدادات التي تتحكم في سلوك التوجيه، بما في ذلك بنية رابط URL، وتخزين اللغة، وإدارة البرمجيات الوسيطة.
 
-| الحقل      | الوصف                                                                                                                                   | النوع                                                                                                                                                                                                           | الافتراضي               | مثال                                                                                                                                                                                   | ملاحظة                                                                                                                                                                                                                                                               |
-| ---------- | -------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`     | وضع توجيه رابط URL لإدارة اللغات.                                                                                                      | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                   | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (الإنجليزية) أو `/fr/dashboard` (الفرنسية). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: تتم إدارة اللغة بوسائل أخرى. `'search-params'`: `/dashboard?locale=fr` | لا يؤثر على إدارة الكوكيز أو تخزين اللغات.                                                                                                                                                                                                              |
-| `storage`  | إعدادات تخزين اللغة على العميل.                                                                                                        | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                        | انظر جدول معالم التخزين أدناه.                                                                                                                                                                                                                                        |
-| `basePath` | المسار الأساسي لروابط التطبيق.                                                                                                         | `string`                                                                                                                                                                                                      | `''`                   | `'/my-app'`                                                                                                                                                                               | إذا كان التطبيق يعمل على العنوان `https://example.com/my-app` ، فإن الـ basePath هو `'/my-app'` وتصبح الروابط `https://example.com/my-app/en`.                                                                                                                      |
-| `rewrite`  | قواعد إعادة كتابة رابط URL مخصصة تتجاوز وضع التوجيه الافتراضي لمسارات معينة. تدعم المعاملات الديناميكية `[param]`.                       | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                 | `undefined`            | انظر المثال أدناه                                                                                                                                                                         | • لقواعد إعادة الكتابة أولوية على `mode`. <br/> • يعمل مع Next.js و Vite. <br/> • تقوم `getLocalizedUrl()` بتطبيق القواعد المناسبة تلقائياً. <br/> • انظر [إعادة كتابة روابط URL المخصصة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
+| الحقل      | الوصف                                                                                                              | النوع                                                                                                                                                                                                        | الافتراضي              | مثال                                                                                                                                                                                                   | ملاحظة                                                                                                                                                                                                                                                                           |
+| ---------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`     | وضع توجيه رابط URL لإدارة اللغات.                                                                                  | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'`                                                                                                  | `'prefix-no-default'`  | `'prefix-no-default'`: `/dashboard` (الإنجليزية) أو `/fr/dashboard` (الفرنسية). `'prefix-all'`: `/en/dashboard`. `'no-prefix'`: تتم إدارة اللغة بوسائل أخرى. `'search-params'`: `/dashboard?locale=fr` | لا يؤثر على إدارة الكوكيز أو تخزين اللغات.                                                                                                                                                                                                                                       |
+| `storage`  | إعدادات تخزين اللغة على العميل.                                                                                    | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]`                                                                                                                     | انظر جدول معالم التخزين أدناه.                                                                                                                                                                                                                                                   |
+| `basePath` | المسار الأساسي لروابط التطبيق.                                                                                     | `string`                                                                                                                                                                                                     | `''`                   | `'/my-app'`                                                                                                                                                                                            | إذا كان التطبيق يعمل على العنوان `https://example.com/my-app` ، فإن الـ basePath هو `'/my-app'` وتصبح الروابط `https://example.com/my-app/en`.                                                                                                                                   |
+| `rewrite`  | قواعد إعادة كتابة رابط URL مخصصة تتجاوز وضع التوجيه الافتراضي لمسارات معينة. تدعم المعاملات الديناميكية `[param]`. | `Record<string, StrictModeLocaleMap<string>>`                                                                                                                                                                | `undefined`            | انظر المثال أدناه                                                                                                                                                                                      | • لقواعد إعادة الكتابة أولوية على `mode`. <br/> • يعمل مع Next.js و Vite. <br/> • تقوم `getLocalizedUrl()` بتطبيق القواعد المناسبة تلقائياً. <br/> • انظر [إعادة كتابة روابط URL المخصصة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md). |
 
 **مثال لـ `rewrite`**:
 
@@ -628,35 +628,35 @@ routing: {
 
 #### معالم التخزين (Storage)
 
-| القيمة             | ملاحظة                                                                                                                                                                                          | الوصف                                                                              |
-| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
-| `'cookie'`         | • للامتثال للقانون العام لحماية البيانات (GDPR)، تأكد من الحصول على موافقة المستخدم بشكل صحيح. <br/> • قابل للتخصيص عبر `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`). | يخزن اللغة في الكوكيز — يمكن الوصول إليها على كل من العميل والخادم.               |
-| `'localStorage'`   | • لا تنتهي صلاحيته إلا إذا تم مسحه صراحة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`).                | يخزن اللغة في المتصفح دون حد زمني — من جانب العميل فقط.                             |
-| `'sessionStorage'` | • يتم مسحه عند إغلاق التبويب/النافذة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).                     | يخزن اللغة طوال مدة جلسة الصفحة — من جانب العميل فقط.                              |
-| `'header'`         | • مفيد لطلبات واجهة برمجة التطبيقات (API). <br/> • لا يمكن لجانب العميل الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                     | يخزن أو يمرر اللغة عبر ترويسات HTTP — من جانب الخادم فقط.                          |
+| القيمة             | ملاحظة                                                                                                                                                                                                                    | الوصف                                                               |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| `'cookie'`         | • للامتثال للقانون العام لحماية البيانات (GDPR)، تأكد من الحصول على موافقة المستخدم بشكل صحيح. <br/> • قابل للتخصيص عبر `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`). | يخزن اللغة في الكوكيز — يمكن الوصول إليها على كل من العميل والخادم. |
+| `'localStorage'`   | • لا تنتهي صلاحيته إلا إذا تم مسحه صراحة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`).                                | يخزن اللغة في المتصفح دون حد زمني — من جانب العميل فقط.             |
+| `'sessionStorage'` | • يتم مسحه عند إغلاق التبويب/النافذة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).                                  | يخزن اللغة طوال مدة جلسة الصفحة — من جانب العميل فقط.               |
+| `'header'`         | • مفيد لطلبات واجهة برمجة التطبيقات (API). <br/> • لا يمكن لجانب العميل الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                          | يخزن أو يمرر اللغة عبر ترويسات HTTP — من جانب الخادم فقط.           |
 
 #### سمات الكوكيز (Cookies Attributes)
 
 عند استخدام التخزين في الكوكيز، يمكن تعيين سمات إضافية:
 
-| الحقل      | الوصف                                       | النوع                                                 |
-| ---------- | ------------------------------------------- | ---------------------------------------------------- |
-| `name`     | اسم الكوكيز. الافتراضي: `'INTLAYER_LOCALE'` | `string`                                             |
-| `domain`   | نطاق الكوكيز. الافتراضي: `undefined`         | `string`                                             |
-| `path`     | مسار الكوكيز. الافتراضي: `undefined`         | `string`                                             |
-| `secure`   | يتطلب HTTPS. الافتراضي: `undefined`         | `boolean`                                            |
-| `httpOnly` | علامة HTTP-only. الافتراضي: `undefined`      | `boolean`                                            |
-| `sameSite` | سياسة SameSite.                             | `'strict'` &#124; <br/> `'lax'` &#124; <br/> `'none'` |
-| `expires`  | تاريخ الانتهاء أو عدد الأيام. الافتراضي: `undefined` | `Date` &#124; <br/> `number`         |
+| الحقل      | الوصف                                                | النوع                                                 |
+| ---------- | ---------------------------------------------------- | ----------------------------------------------------- |
+| `name`     | اسم الكوكيز. الافتراضي: `'INTLAYER_LOCALE'`          | `string`                                              |
+| `domain`   | نطاق الكوكيز. الافتراضي: `undefined`                 | `string`                                              |
+| `path`     | مسار الكوكيز. الافتراضي: `undefined`                 | `string`                                              |
+| `secure`   | يتطلب HTTPS. الافتراضي: `undefined`                  | `boolean`                                             |
+| `httpOnly` | علامة HTTP-only. الافتراضي: `undefined`              | `boolean`                                             |
+| `sameSite` | سياسة SameSite.                                      | `'strict'` &#124; <br/> `'lax'` &#124; <br/> `'none'` |
+| `expires`  | تاريخ الانتهاء أو عدد الأيام. الافتراضي: `undefined` | `Date` &#124; <br/> `number`                          |
 
 #### سمات التخزين (Storage Attributes)
 
 عند استخدام localStorage أو sessionStorage:
 
-| الحقل   | الوصف                                           | النوع                                              |
-| ------ | ----------------------------------------------- | ------------------------------------------------ |
-| `type` | نوع التخزين.                                    | `'localStorage'` &#124; <br/> `'sessionStorage'` |
-| `name` | اسم المفتاح في التخزين. الافتراضي: `'INTLAYER_LOCALE'` | `string`                                |
+| الحقل  | الوصف                                                  | النوع                                            |
+| ------ | ------------------------------------------------------ | ------------------------------------------------ |
+| `type` | نوع التخزين.                                           | `'localStorage'` &#124; <br/> `'sessionStorage'` |
+| `name` | اسم المفتاح في التخزين. الافتراضي: `'INTLAYER_LOCALE'` | `string`                                         |
 
 #### أمثلة للإعدادات
 
@@ -797,14 +797,14 @@ export default config;
 
 الإعدادات المتعلقة بكيفية إدارة المحتوى في التطبيق، بما في ذلك أسماء المجلدات، وامتدادات الملفات، والإعدادات المشتقة.
 
-| الحقل             | الوصف                                                                                                   | النوع        | الافتراضي                                                                                                                                                                                                    | مثال                                                                                                                                                                               | ملاحظة                                                                                                                               |
-| ----------------- | ------------------------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `watch`          | يشير إلى ما إذا كان ينبغي لـ Intlayer مراقبة التغييرات في ملفات الإعلان عن المحتوى لإعادة توليد القواميس. | `boolean`  | `true`                                                                                                                                                                                                     |                                                                                                                                                                                       |                                                                                                                                        |
-| `fileExtensions` | امتدادات الملفات للفحص أثناء تجميع القواميس.                                                            | `string[]` | `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.json5', '.content.jsonc', '.content.tsx', '.content.jsx']`                                                      | `['.data.ts', '.data.js', '.data.json']`                                                                                                                                              | يساعد التخصيص في تجنب التعارضات.                                                                                                       |
-| `contentDir`     | المسار إلى المجلد حيث يتم الاحتفاظ بملفات تعريف المحتوى (`.content.*`).                                 | `string[]` | `['.']`                                                                                                                                                                                                    | `['src', '../../ui-library', require.resolve("@my-package/content")]`                                                                                                                 | يُستخدم لمراقبة ملفات المحتوى وإعادة توليد القواميس.                                                                                  |
-| `codeDir`        | المسار إلى المجلد حيث يتم الاحتفاظ بالكود، بالنسبة لمجلد المشروع الأساسي.                               | `string[]` | `['.']`                                                                                                                                                                                                    | `['src', '../../ui-library']`                                                                                                                                                         | • يُستخدم لمراقبة ملفات الكود للتحويل (إزالة الأجزاء غير الضرورية، التحسين). <br/> • يمكن أن يؤدي فصله عن `contentDir` إلى تحسين الأداء. |
-| `excludedPath`   | المجلدات المستبعدة من فحص المحتوى.                                                                      | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']`                                  |                                                                                                                                                                                       | غير مستخدم حالياً؛ مخطط له في المستقبل.                                                                                             |
-| `formatCommand`  | أمر لتنسيق ملفات المحتوى عند كتابتها محلياً بواسطة Intlayer.                                           | `string`   | `undefined`                                                                                                                                                                                                | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • سيتم استبدال `{{file}}` بمسار الملف. <br/> • إذا لم يتم تعريفه، فسيقوم Intlayer بالتحديد تلقائياً (يختبر prettier و biome و eslint). |
+| الحقل            | الوصف                                                                                                     | النوع      | الافتراضي                                                                                                                                                                 | مثال                                                                                                                                                                                  | ملاحظة                                                                                                                                   |
+| ---------------- | --------------------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `watch`          | يشير إلى ما إذا كان ينبغي لـ Intlayer مراقبة التغييرات في ملفات الإعلان عن المحتوى لإعادة توليد القواميس. | `boolean`  | `true`                                                                                                                                                                    |                                                                                                                                                                                       |                                                                                                                                          |
+| `fileExtensions` | امتدادات الملفات للفحص أثناء تجميع القواميس.                                                              | `string[]` | `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.json5', '.content.jsonc', '.content.tsx', '.content.jsx']`                     | `['.data.ts', '.data.js', '.data.json']`                                                                                                                                              | يساعد التخصيص في تجنب التعارضات.                                                                                                         |
+| `contentDir`     | المسار إلى المجلد حيث يتم الاحتفاظ بملفات تعريف المحتوى (`.content.*`).                                   | `string[]` | `['.']`                                                                                                                                                                   | `['src', '../../ui-library', require.resolve("@my-package/content"), '@my-package/content']`                                                                                          | يُستخدم لمراقبة ملفات المحتوى وإعادة توليد القواميس.                                                                                     |
+| `codeDir`        | المسار إلى المجلد حيث يتم الاحتفاظ بالكود، بالنسبة لمجلد المشروع الأساسي.                                 | `string[]` | `['.']`                                                                                                                                                                   | `['src', '../../ui-library']`                                                                                                                                                         | • يُستخدم لمراقبة ملفات الكود للتحويل (إزالة الأجزاء غير الضرورية، التحسين). <br/> • يمكن أن يؤدي فصله عن `contentDir` إلى تحسين الأداء. |
+| `excludedPath`   | المجلدات المستبعدة من فحص المحتوى.                                                                        | `string[]` | `['**/node_modules/**', '**/dist/**', '**/build/**', '**/.intlayer/**', '**/.next/**', '**/.nuxt/**', '**/.expo/**', '**/.vercel/**', '**/.turbo/**', '**/.tanstack/**']` |                                                                                                                                                                                       | غير مستخدم حالياً؛ مخطط له في المستقبل.                                                                                                  |
+| `formatCommand`  | أمر لتنسيق ملفات المحتوى عند كتابتها محلياً بواسطة Intlayer.                                              | `string`   | `undefined`                                                                                                                                                               | `'npx prettier --write "{{file}}" --log-level silent'` (Prettier), `'npx biome format "{{file}}" --write --log-level none'` (Biome), `'npx eslint --fix "{{file}}" --quiet'` (ESLint) | • سيتم استبدال `{{file}}` بمسار الملف. <br/> • إذا لم يتم تعريفه، فسيقوم Intlayer بالتحديد تلقائياً (يختبر prettier و biome و eslint).   |
 
 ---
 
@@ -812,20 +812,20 @@ export default config;
 
 المعالم التي تتحكم في عمليات القاموس، بما في ذلك سلوك الملء التلقائي وتوليد المحتوى.
 
-| الحقل                        | الوصف                                                                                                                                                                         | النوع                                                                                                             | الافتراضي      | مثال                                                                                       | ملاحظة                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `fill`                      | يتحكم في كيفية توليد ملفات مخرجات الملء التلقائي (ترجمة الذكاء الاصطناعي).                                                                                                      | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: المسار الافتراضي (نفس ملف المصدر). <br/> • `false`: تعطيل. <br/> • تولد سلسلة القالب/الدالة ملفات حسب اللغة. <br/> • كائن حسب اللغة: كل لغة تقابل قالبها؛ `false` يتجاهل هذه اللغة. <br/> • إدراج `{{locale}}` يفعل التوليد حسب اللغة. <br/> • الـ `fill` على مستوى القاموس دائماً له الأولوية على هذا الإعداد العام. |
-| `description`               | يساعد المحرر و CMS على فهم الغرض من القاموس. يُستخدم أيضاً كسياق لتوليد الترجمات باستخدام الذكاء الاصطناعي.                                                                | `string`                                                                                                        | `undefined`  | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `locale`                    | يحول القاموس إلى صيغة خاصة بلغة محددة. تصبح كل حقل معلن عقدة ترجمة. إذا غاب، يُعتبر القاموس متعدد اللغات.                                                               | `LocalesValues`                                                                                                 | `undefined`  | `'en'`                                                                                      | استخدم هذا إذا كان القاموس مخصصاً للغة واحدة معينة، بدلاً من ترجمات متعددة.                                                                                                                                                                                                                                                                                                                                                                                         |
-| `contentAutoTransformation` | يحول سلاسل المحتوى تلقائياً إلى عقد ذات أنواع (markdown أو HTML أو إدراج).                                                                                                    | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`. <br/> • HTML : `<div>Title</div>` → `html('<div>Title</div>')`. <br/> • إدراج : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                                                                                                                                                      |
-| `location`                  | يشير إلى مكان تخزين ملفات القاموس وكيفية مزامنتها مع CMS.                                                                                                                        | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: إدارة محلية فقط. <br/> • `'remote'`: إدارة عن بعد فقط (CMS). <br/> • `'hybrid'`: إدارة محلية وعن بعد معاً. <br/> • `'plugin'` أو سلسلة مخصصة: إدارة بواسطة إضافة أو مصدر مخصص.                                                                                                                                                                                                                                                                                 |
-| `importMode`                | يتحكم في طريقة استيراد القواميس.                                                                                                                                               | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: استيراد ثابت. <br/> • `'dynamic'`: استيراد ديناميكي عبر Suspense. <br/> • `'fetch'`: جلب عبر Live Sync API؛ التراجع إلى `'dynamic'` عند الفشل. <br/> • يتطلب إضافات `@intlayer/babel` و `@intlayer/swc`. <br/> • يجب الإعلان عن المفاتيح بشكل ثابت. <br/> • يتم تجاهله إذا تم إيقاف `optimize`. <br/> • لا يؤثر على `getIntlayer` أو `getDictionary` إلخ. |
-| `priority`                  | أولوية القاموس. تفوز القيم الأعلى على القيم الأدنى عند حل التعارضات بين القواميس.                                                                                                 | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `live`                      | ملغي — استخدم `importMode: 'fetch'`. كان يشير إلى ما إذا كان ينبغي جلب محتوى القاموس ديناميكياً عبر Live Sync API.                                                              | `boolean`                                                                                                       | `undefined`  |                                                                                             | تم تغيير اسمه إلى `importMode: 'fetch'` في v8.0.0.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| `schema`                    | يتم توليده تلقائياً بواسطة Intlayer للتحقق من صحة JSON schema.                                                                                                                  | `'https://intlayer.org/schema.json'`                                                                            | توليد تلقائي |                                                                                             | لا تقم بتحريره يدوياً.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
-| `title`                     | يساعد في التعرف على القاموس في المحرر و CMS.                                                                                                                                    | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `tags`                      | يصنف القواميس ويوفر سياقاً أو تعليمات للمحرر والذكاء الاصطناعي.                                                                                                                | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
-| `version`                   | إصدار القاموس البعيد؛ يساعد في تتبع النسخة المستخدمة حالياً.                                                                                                                   | `string`                                                                                                        | `undefined`  | `'1.0.0'`                                                                                   | • تتم إدارته في CMS. <br/> • لا تقم بتحريره محلياً.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| الحقل                       | الوصف                                                                                                              | النوع                                                                                                           | الافتراضي    | مثال                                                                                        | ملاحظة                                                                                                                                                                                                                                                                                                                                                                  |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `fill`                      | يتحكم في كيفية توليد ملفات مخرجات الملء التلقائي (ترجمة الذكاء الاصطناعي).                                         | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `true`       | `{ en: '/locales/en/{{key}}.json', fr: ({ key }) => '/locales/fr/${key}.json', es: false }` | • `true`: المسار الافتراضي (نفس ملف المصدر). <br/> • `false`: تعطيل. <br/> • تولد سلسلة القالب/الدالة ملفات حسب اللغة. <br/> • كائن حسب اللغة: كل لغة تقابل قالبها؛ `false` يتجاهل هذه اللغة. <br/> • إدراج `{{locale}}` يفعل التوليد حسب اللغة. <br/> • الـ `fill` على مستوى القاموس دائماً له الأولوية على هذا الإعداد العام.                                         |
+| `description`               | يساعد المحرر و CMS على فهم الغرض من القاموس. يُستخدم أيضاً كسياق لتوليد الترجمات باستخدام الذكاء الاصطناعي.        | `string`                                                                                                        | `undefined`  | `'User profile section'`                                                                    |                                                                                                                                                                                                                                                                                                                                                                         |
+| `locale`                    | يحول القاموس إلى صيغة خاصة بلغة محددة. تصبح كل حقل معلن عقدة ترجمة. إذا غاب، يُعتبر القاموس متعدد اللغات.          | `LocalesValues`                                                                                                 | `undefined`  | `'en'`                                                                                      | استخدم هذا إذا كان القاموس مخصصاً للغة واحدة معينة، بدلاً من ترجمات متعددة.                                                                                                                                                                                                                                                                                             |
+| `contentAutoTransformation` | يحول سلاسل المحتوى تلقائياً إلى عقد ذات أنواع (markdown أو HTML أو إدراج).                                         | `boolean` &#124; <br/> `{ markdown?: boolean; html?: boolean; insertion?: boolean }`                            | `false`      | `true`                                                                                      | • Markdown : `### Title` → `md('### Title')`. <br/> • HTML : `<div>Title</div>` → `html('<div>Title</div>')`. <br/> • إدراج : `Hello {{name}}` → `insert('Hello {{name}}')`.                                                                                                                                                                                            |
+| `location`                  | يشير إلى مكان تخزين ملفات القاموس وكيفية مزامنتها مع CMS.                                                          | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: إدارة محلية فقط. <br/> • `'remote'`: إدارة عن بعد فقط (CMS). <br/> • `'hybrid'`: إدارة محلية وعن بعد معاً. <br/> • `'plugin'` أو سلسلة مخصصة: إدارة بواسطة إضافة أو مصدر مخصص.                                                                                                                                                                             |
+| `importMode`                | يتحكم في طريقة استيراد القواميس.                                                                                   | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: استيراد ثابت. <br/> • `'dynamic'`: استيراد ديناميكي عبر Suspense. <br/> • `'fetch'`: جلب عبر Live Sync API؛ التراجع إلى `'dynamic'` عند الفشل. <br/> • يتطلب إضافات `@intlayer/babel` و `@intlayer/swc`. <br/> • يجب الإعلان عن المفاتيح بشكل ثابت. <br/> • يتم تجاهله إذا تم إيقاف `optimize`. <br/> • لا يؤثر على `getIntlayer` أو `getDictionary` إلخ. |
+| `priority`                  | أولوية القاموس. تفوز القيم الأعلى على القيم الأدنى عند حل التعارضات بين القواميس.                                  | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                         |
+| `live`                      | ملغي — استخدم `importMode: 'fetch'`. كان يشير إلى ما إذا كان ينبغي جلب محتوى القاموس ديناميكياً عبر Live Sync API. | `boolean`                                                                                                       | `undefined`  |                                                                                             | تم تغيير اسمه إلى `importMode: 'fetch'` في v8.0.0.                                                                                                                                                                                                                                                                                                                      |
+| `schema`                    | يتم توليده تلقائياً بواسطة Intlayer للتحقق من صحة JSON schema.                                                     | `'https://intlayer.org/schema.json'`                                                                            | توليد تلقائي |                                                                                             | لا تقم بتحريره يدوياً.                                                                                                                                                                                                                                                                                                                                                  |
+| `title`                     | يساعد في التعرف على القاموس في المحرر و CMS.                                                                       | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                         |
+| `tags`                      | يصنف القواميس ويوفر سياقاً أو تعليمات للمحرر والذكاء الاصطناعي.                                                    | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                         |
+| `version`                   | إصدار القاموس البعيد؛ يساعد في تتبع النسخة المستخدمة حالياً.                                                       | `string`                                                                                                        | `undefined`  | `'1.0.0'`                                                                                   | • تتم إدارته في CMS. <br/> • لا تقم بتحريره محلياً.                                                                                                                                                                                                                                                                                                                     |
 
 **مثال لـ `fill`**:
 
@@ -845,10 +845,10 @@ dictionary: {
 
 المعالم لتخصيص مخرجات سجل Intlayer.
 
-| الحقل     | الوصف                               | النوع                                                          | الافتراضي           | مثال                | ملاحظة                                                                                                                |
-| -------- | ----------------------------------- | -------------------------------------------------------------- | ----------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `mode`   | يشير إلى وضع السجل.                 | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`       | `'verbose'`         | • `'verbose'`: يسجل المزيد من المعلومات لتصحيح الأخطاء. <br/> • `'disabled'`: يوقف السجل تماماً. |
-| `prefix` | بادئة لجميع الرسائل في السجل.       | `string`                                                       | `'[intlayer] '` | `'[my prefix] '`    |                                                                                                                         |
+| الحقل    | الوصف                         | النوع                                                          | الافتراضي       | مثال             | ملاحظة                                                                                           |
+| -------- | ----------------------------- | -------------------------------------------------------------- | --------------- | ---------------- | ------------------------------------------------------------------------------------------------ |
+| `mode`   | يشير إلى وضع السجل.           | `'default'` &#124; <br/> `'verbose'` &#124; <br/> `'disabled'` | `'default'`     | `'verbose'`      | • `'verbose'`: يسجل المزيد من المعلومات لتصحيح الأخطاء. <br/> • `'disabled'`: يوقف السجل تماماً. |
+| `prefix` | بادئة لجميع الرسائل في السجل. | `string`                                                       | `'[intlayer] '` | `'[my prefix] '` |                                                                                                  |
 
 ---
 
@@ -880,15 +880,15 @@ dictionary: {
 - **Amazon Bedrock**
 - **Together.ai**
 
-| الحقل                 | الوصف                                                                                                                                                       | النوع                                                                                                                                                                                                                                                                                                                                                                                           | الافتراضي  | مثال                                                       | ملاحظة                                                                                                                                                                                                                |
-| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `provider`           | المزود المستخدم لميزات الذكاء الاصطناعي في Intlayer.                                                                                                       | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` | `undefined`| `'anthropic'`                                                | يحتاج المزودون المختلفون إلى مفاتيح واجهة برمجة تطبيقات مختلفة ولهم أسعار مختلفة. |
-| `model`              | النموذج المستخدم لميزات الذكاء الاصطناعي.                                                                                                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد    | `'gpt-4o-2024-11-20'`                                        | يعتمد النموذج المحدد على المزود. |
-| `temperature`        | يتحكم في عشوائية ردود الذكاء الاصطناعي.                                                                                                                   | `number`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد    | `0.1`                                                        | درجة حرارة أعلى = أكثر إبداعاً وأقل قابلية للتنبؤ. |
-| `apiKey`             | مفتاح واجهة برمجة التطبيقات الخاص بك للمزود المختار.                                                                                                         | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد    | `process.env.OPENAI_API_KEY`                                 | يجب الحفاظ على سريته؛ استخدم متغيرات البيئة. |
-| `applicationContext` | سياق إضافي حول تطبيقك لمساعدة الذكاء الاصطناعي في توليد ترجمات أكثر دقة (المجال، الجمهور المستهدف، النبرة، المصطلحات).                                    | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد    | `'سياق تطبيقي الخاص'`                                        | يمكن استخدامه لإضافة قواعد (مثلاً: `"لا يجب عليك تحويل روابط URL"`). |
-| `baseURL`            | الرابط الأساسي لواجهة برمجة تطبيقات الذكاء الاصطناعي.                                                                                                        | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد    | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | يمكن أن يشير إلى نقطة نهاية محلية أو مخصصة لواجهة برمجة تطبيقات الذكاء الاصطناعي. |
-| `dataSerialization`  | صيغة تسلسل البيانات لميزات الذكاء الاصطناعي.                                                                                                               | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined`| `'toon'`                                                     | • `'json'`: افتراضي، موثوق؛ يستهلك المزيد من الوحدات. <br/> • `'toon'`: وحدات أقل، أقل استقراراً. <br/> • يتم تمرير المعاملات الإضافية إلى النموذج كسياق (جهد التفكير إلخ). |
+| الحقل                | الوصف                                                                                                                  | النوع                                                                                                                                                                                                                                                                                                                                                                                          | الافتراضي   | مثال                                                          | ملاحظة                                                                                                                                                                      |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `provider`           | المزود المستخدم لميزات الذكاء الاصطناعي في Intlayer.                                                                   | `'openai'` &#124; <br/> `'anthropic'` &#124; <br/> `'mistral'` &#124; <br/> `'deepseek'` &#124; <br/> `'gemini'` &#124; <br/> `'ollama'` &#124; <br/> `'openrouter'` &#124; <br/> `'alibaba'` &#124; <br/> `'fireworks'` &#124; <br/> `'groq'` &#124; <br/> `'huggingface'` &#124; <br/> `'bedrock'` &#124; <br/> `'googleaistudio'` &#124; <br/> `'googlevertex'` &#124; <br/> `'togetherai'` | `undefined` | `'anthropic'`                                                 | يحتاج المزودون المختلفون إلى مفاتيح واجهة برمجة تطبيقات مختلفة ولهم أسعار مختلفة.                                                                                           |
+| `model`              | النموذج المستخدم لميزات الذكاء الاصطناعي.                                                                              | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد     | `'gpt-4o-2024-11-20'`                                         | يعتمد النموذج المحدد على المزود.                                                                                                                                            |
+| `temperature`        | يتحكم في عشوائية ردود الذكاء الاصطناعي.                                                                                | `number`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد     | `0.1`                                                         | درجة حرارة أعلى = أكثر إبداعاً وأقل قابلية للتنبؤ.                                                                                                                          |
+| `apiKey`             | مفتاح واجهة برمجة التطبيقات الخاص بك للمزود المختار.                                                                   | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد     | `process.env.OPENAI_API_KEY`                                  | يجب الحفاظ على سريته؛ استخدم متغيرات البيئة.                                                                                                                                |
+| `applicationContext` | سياق إضافي حول تطبيقك لمساعدة الذكاء الاصطناعي في توليد ترجمات أكثر دقة (المجال، الجمهور المستهدف، النبرة، المصطلحات). | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد     | `'سياق تطبيقي الخاص'`                                         | يمكن استخدامه لإضافة قواعد (مثلاً: `"لا يجب عليك تحويل روابط URL"`).                                                                                                        |
+| `baseURL`            | الرابط الأساسي لواجهة برمجة تطبيقات الذكاء الاصطناعي.                                                                  | `string`                                                                                                                                                                                                                                                                                                                                                                                       | لا يوجد     | `'https://api.openai.com/v1'` <br/> `'http://localhost:5000'` | يمكن أن يشير إلى نقطة نهاية محلية أو مخصصة لواجهة برمجة تطبيقات الذكاء الاصطناعي.                                                                                           |
+| `dataSerialization`  | صيغة تسلسل البيانات لميزات الذكاء الاصطناعي.                                                                           | `'json'` &#124; <br/> `'toon'`                                                                                                                                                                                                                                                                                                                                                                 | `undefined` | `'toon'`                                                      | • `'json'`: افتراضي، موثوق؛ يستهلك المزيد من الوحدات. <br/> • `'toon'`: وحدات أقل، أقل استقراراً. <br/> • يتم تمرير المعاملات الإضافية إلى النموذج كسياق (جهد التفكير إلخ). |
 
 ---
 
@@ -902,13 +902,13 @@ dictionary: {
 
 > أثناء التحسين، سيقوم Intlayer باستبدال استدعاءات القواميس لتحسين تقسيم الكود (chunking) بحيث تستورد الحزمة الناتجة القواميس المستخدمة فعلياً فقط.
 
-| الحقل             | الوصف                                                                                                   | النوع                             | الافتراضي                                                   | مثال                                                                     | ملاحظة                                                                                                                                                                                                                                                                                                                                           |
-| ----------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | يتحكم في وضع البناء.                                                                                    | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                  | `'manual'`                                                                  | • `'auto'`: يتم تشغيل البناء تلقائياً أثناء بناء التطبيق. <br/> • `'manual'`: يتم تنفيذه فقط عند استدعاء أمر بناء صريح. <br/> • يمكن استخدامه لإيقاف بناء القواميس (مثلاً لتجنب الجري في بيئات Node.js). |
-| `optimize`        | يتحكم في ما إذا كان ينبغي إجراء تحسينات البناء.                                                         | `boolean`                        | `undefined`                                               | `process.env.NODE_ENV === 'production'`                                     | • إذا لم يتم تعريفه، فسيتم تشغيل التحسين عند بناء إطار العمل (Vite/Next.js). <br/> • `true` يفرض التحسين حتى في وضع التطوير. <br/> • `false` يعطله. <br/> • عند تشغيله، يستبدل استدعاءات القواميس لتحسين الـ chunking. <br/> • يتطلب إضافات `@intlayer/babel` و `@intlayer/swc`. |
-| `checkTypes`      | يشير إلى ما إذا كان ينبغي للبناء التحقق من أنواع TypeScript وتسجيل الأخطاء.                             | `boolean`                        | `false`                                                   |                                                                             | قد يبطئ عملية البناء. |
-| `outputFormat`    | يتحكم في صيغة إخراج القواميس.                                                                           | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                          | `['cjs']`                                                                   | |
-| `traversePattern` | الأنماط التي تحدد الملفات التي يتم فحصها أثناء التحسين.                                                  | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • قيد التحسين على الملفات ذات الصلة لزيادة أداء البناء. <br/> • سيتم تجاهله إذا توقف `optimize`. <br/> • يستخدم أنماط glob. |
+| الحقل             | الوصف                                                                       | النوع                            | الافتراضي                                                                                                                                                                         | مثال                                                                          | ملاحظة                                                                                                                                                                                                                                                                           |
+| ----------------- | --------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`            | يتحكم في وضع البناء.                                                        | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: يتم تشغيل البناء تلقائياً أثناء بناء التطبيق. <br/> • `'manual'`: يتم تنفيذه فقط عند استدعاء أمر بناء صريح. <br/> • يمكن استخدامه لإيقاف بناء القواميس (مثلاً لتجنب الجري في بيئات Node.js).                                                                         |
+| `optimize`        | يتحكم في ما إذا كان ينبغي إجراء تحسينات البناء.                             | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • إذا لم يتم تعريفه، فسيتم تشغيل التحسين عند بناء إطار العمل (Vite/Next.js). <br/> • `true` يفرض التحسين حتى في وضع التطوير. <br/> • `false` يعطله. <br/> • عند تشغيله، يستبدل استدعاءات القواميس لتحسين الـ chunking. <br/> • يتطلب إضافات `@intlayer/babel` و `@intlayer/swc`. |
+| `checkTypes`      | يشير إلى ما إذا كان ينبغي للبناء التحقق من أنواع TypeScript وتسجيل الأخطاء. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | قد يبطئ عملية البناء.                                                                                                                                                                                                                                                            |
+| `outputFormat`    | يتحكم في صيغة إخراج القواميس.                                               | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                  |
+| `traversePattern` | الأنماط التي تحدد الملفات التي يتم فحصها أثناء التحسين.                     | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • قيد التحسين على الملفات ذات الصلة لزيادة أداء البناء. <br/> • سيتم تجاهله إذا توقف `optimize`. <br/> • يستخدم أنماط glob.                                                                                                                                                      |
 
 ---
 
@@ -916,15 +916,15 @@ dictionary: {
 
 هذه الإعدادات مخصصة لحالات الاستخدام المتقدمة والإعدادات الداخلية لـ 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'`               |        |            |
+| الحقل                     | الوصف                                    | النوع    | الافتراضي                         | مثال | ملاحظة |
+| ------------------------- | ---------------------------------------- | -------- | --------------------------------- | ---- | ------ |
+| `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'`               |      |        |
 
 ---
 
@@ -932,27 +932,27 @@ dictionary: {
 
 الإعدادات التي تتحكم في مترجم Intlayer، الذي يستخرج القواميس مباشرة من مكوناتك.
 
-| الحقل                 | الوصف                                                                                                                                                                                                                                                                                                  | النوع                                                                                                            | الافتراضي      | مثال                                                                                                                                                  | ملاحظة                                                                                                                                                                                                          |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`             | يشير إلى ما إذا كان ينبغي تفعيل المترجم لاستخراج القواميس.                                                                                                                                                                                                                                             | `boolean` &#124; <br/> `'build-only'`                                                                          | `true`       | `'build-only'`                                                                                                                                           | `'build-only'` يتخطى المترجم أثناء التطوير لبناء أسرع؛ يتم تنفيذه فقط عند أوامر البناء.                                                                                           |
-| `dictionaryKeyPrefix` | بادئة لمفاتيح القواميس المستخرجة.                                                                                                                                                                                                                                                                      | `string`                                                                                                       | `''`         | `'my-prefix-'`                                                                                                                                           | تتم إضافتها إلى المفتاح المولد (بناءً على اسم الملف) لتجنب التعارضات.                                                                                                                               |
-| `saveComponents`      | ما إذا كان ينبغي حفظ المكونات بعد تحويلها.                                                                                                                                                                                                                                                             | `boolean`                                                                                                      | `false`      |                                                                                                                                                          | • إذا كان `true` ، فسيتم استبدال الملفات الأصلية بنسخها المحولة. <br/> • يمكن إزالة المترجم بعد تشغيله مرة واحدة.                                                                                           |
-| `output`              | يحدد المسار لملفات الإخراج. يستبدل `outputDir`. يدعم قوالب المتغيرات: `{{fileName}}`, <br/> `{{key}}`, <br/> `{{locale}}`, <br/> `{{extension}}`, <br/> `{{componentFileName}}`, <br/> `{{componentExtension}}`, <br/> `{{format}}`, <br/> `{{componentFormat}}`, <br/> `{{componentDirPath}}`. | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `undefined`  | `'./{{fileName}}{{extension}}'` <br/> `'/locales/{{locale}}/{{key}}.json'` <br/> `{ en: ({ key }) => './locales/en/${key}.json', fr: '...', es: false }` | • يتم حل مسارات `./` بالنسبة لمجلد المكون. <br/> • مسارات `/` بالنسبة للمشروع الأساسي. <br/> • `{{locale}}` يتضمن التوليد حسب اللغة. <br/> • يدعم تمثيل الكائن لكل لغة. |
-| `noMetadata`          | إذا كان `true` ، فسيقوم المترجم بحذف بيانات ميتا القاموس (المفتاح، غلاف المحتوى) من المخرجات.                                                                                                                                                                                                          | `boolean`                                                                                                      | `false`      | `false` → `{"key":"my-key","content":{"key":"value"}}` <br/> `true` → `{"key":"value"}`                                                                  | • مفيد لمخرجات بصيغة i18next أو ICU MessageFormat JSON. <br/> • يعمل جيداً مع إضافة `loadJSON`.                                                                                                                   |
-| `dictionaryKeyPrefix` | بادئة لمفتاح القاموس                                                                                                                                                                                                                                                                                  | `string`                                                                                                       | `''`         |                                                                                                                                                          | إضافة بادئة اختيارية لمفاتيح القواميس المستخرجة                                                                                                                                      |
+| الحقل                 | الوصف                                                                                                                                                                                                                                                                                           | النوع                                                                                                           | الافتراضي   | مثال                                                                                                                                                     | ملاحظة                                                                                                                                                                  |
+| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`             | يشير إلى ما إذا كان ينبغي تفعيل المترجم لاستخراج القواميس.                                                                                                                                                                                                                                      | `boolean` &#124; <br/> `'build-only'`                                                                           | `true`      | `'build-only'`                                                                                                                                           | `'build-only'` يتخطى المترجم أثناء التطوير لبناء أسرع؛ يتم تنفيذه فقط عند أوامر البناء.                                                                                 |
+| `dictionaryKeyPrefix` | بادئة لمفاتيح القواميس المستخرجة.                                                                                                                                                                                                                                                               | `string`                                                                                                        | `''`        | `'my-prefix-'`                                                                                                                                           | تتم إضافتها إلى المفتاح المولد (بناءً على اسم الملف) لتجنب التعارضات.                                                                                                   |
+| `saveComponents`      | ما إذا كان ينبغي حفظ المكونات بعد تحويلها.                                                                                                                                                                                                                                                      | `boolean`                                                                                                       | `false`     |                                                                                                                                                          | • إذا كان `true` ، فسيتم استبدال الملفات الأصلية بنسخها المحولة. <br/> • يمكن إزالة المترجم بعد تشغيله مرة واحدة.                                                       |
+| `output`              | يحدد المسار لملفات الإخراج. يستبدل `outputDir`. يدعم قوالب المتغيرات: `{{fileName}}`, <br/> `{{key}}`, <br/> `{{locale}}`, <br/> `{{extension}}`, <br/> `{{componentFileName}}`, <br/> `{{componentExtension}}`, <br/> `{{format}}`, <br/> `{{componentFormat}}`, <br/> `{{componentDirPath}}`. | `boolean` &#124; <br/> `FilePathPattern` &#124; <br/> `Partial<Record<Locale, boolean &#124; FilePathPattern>>` | `undefined` | `'./{{fileName}}{{extension}}'` <br/> `'/locales/{{locale}}/{{key}}.json'` <br/> `{ en: ({ key }) => './locales/en/${key}.json', fr: '...', es: false }` | • يتم حل مسارات `./` بالنسبة لمجلد المكون. <br/> • مسارات `/` بالنسبة للمشروع الأساسي. <br/> • `{{locale}}` يتضمن التوليد حسب اللغة. <br/> • يدعم تمثيل الكائن لكل لغة. |
+| `noMetadata`          | إذا كان `true` ، فسيقوم المترجم بحذف بيانات ميتا القاموس (المفتاح، غلاف المحتوى) من المخرجات.                                                                                                                                                                                                   | `boolean`                                                                                                       | `false`     | `false` → `{"key":"my-key","content":{"key":"value"}}` <br/> `true` → `{"key":"value"}`                                                                  | • مفيد لمخرجات بصيغة i18next أو ICU MessageFormat JSON. <br/> • يعمل جيداً مع إضافة `loadJSON`.                                                                         |
+| `dictionaryKeyPrefix` | بادئة لمفتاح القاموس                                                                                                                                                                                                                                                                            | `string`                                                                                                        | `''`        |                                                                                                                                                          | إضافة بادئة اختيارية لمفاتيح القواميس المستخرجة                                                                                                                         |
 
 ---
 
 ### مخططات مخصصة (Custom Schemas)
 
-| الحقل      | الوصف                                                                          | النوع                        |
-| --------- | ------------------------------------------------------------------------------ | --------------------------- |
-| `schemas` | يسمح لك بتعريف مخططات Zod للتحقق من صحة هيكل قواميسك.                           | `Record<string, ZodSchema>` |
+| الحقل     | الوصف                                                 | النوع                       |
+| --------- | ----------------------------------------------------- | --------------------------- |
+| `schemas` | يسمح لك بتعريف مخططات Zod للتحقق من صحة هيكل قواميسك. | `Record<string, ZodSchema>` |
 
 ---
 
 ### الإضافات (Plugins)
 
-| الحقل      | الوصف                                     | النوع               |
-| --------- | ----------------------------------------- | ------------------ |
-| `plugins` | قائمة إضافات Intlayer لإدراجها.           | `IntlayerPlugin[]` |
+| الحقل     | الوصف                           | النوع              |
+| --------- | ------------------------------- | ------------------ |
+| `plugins` | قائمة إضافات Intlayer لإدراجها. | `IntlayerPlugin[]` |