@intlayer/docs 5.5.8

package/ar/configuration.md

@@ -0,0 +1,492 @@
+# Intlayer وثائق التكوين
+
+## نظرة عامة
+
+تسمح ملفات تكوين Intlayer بتخصيص جوانب مختلفة من الإضافة، مثل التدويل، والوسيط، ومعالجة المحتوى. يوفر هذا المستند وصفًا تفصيليًا لكل خاصية في التكوين.
+
+---
+
+## دعم ملفات التكوين
+
+يدعم Intlayer تنسيقات ملفات التكوين JSON، JS، MJS، و TS:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+---
+
+## مثال على ملف التكوين
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+// تكوين Intlayer
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH], // اللغات المدعومة
+  },
+  content: {
+    typesDir: "content/types", // دليل أنواع المحتوى
+  },
+  middleware: {
+    noPrefix: false, // عدم استخدام بادئة
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+// تكوين Intlayer
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH], // اللغات المدعومة
+  },
+  content: {
+    typesDir: "content/types", // دليل أنواع المحتوى
+  },
+  middleware: {
+    noPrefix: false, // عدم استخدام بادئة
+  },
+};
+
+module.exports = config;
+```
+
+```json5 fileName=".intlayerrc" codeFormat="json"
+// تكوين Intlayer
+{
+  "internationalization": {
+    "locales": ["en"], // اللغات المدعومة
+  },
+  "content": {
+    "typesDir": "content/types", // دليل أنواع المحتوى
+  },
+  "middleware": {
+    "noPrefix": false, // عدم استخدام بادئة
+  },
+}
+```
+
+---
+
+## مرجع التكوين
+
+تصف الأقسام التالية إعدادات التكوين المختلفة المتاحة لـ Intlayer.
+
+---
+
+### تكوين التدويل
+
+يحدد الإعدادات المتعلقة بالتدويل، بما في ذلك اللغات المتاحة واللغة الافتراضية للتطبيق.
+
+#### الخصائص
+
+- **locales**:
+
+  - _النوع_: `string[]`
+  - _الافتراضي_: `['en']`
+  - _الوصف_: قائمة اللغات المدعومة في التطبيق.
+  - _مثال_: `['en', 'fr', 'es']`
+
+- **requiredLocales**:
+
+  - _النوع_: `string[]`
+  - _الافتراضي_: `[]`
+  - _الوصف_: قائمة اللغات المطلوبة في التطبيق.
+  - _مثال_: `[]`
+  - _ملاحظة_: إذا كانت فارغة، فإن جميع اللغات مطلوبة في وضع `strict`.
+  - _ملاحظة_: تأكد من أن اللغات المطلوبة محددة أيضًا في حقل `locales`.
+
+- **strictMode**:
+
+  - _النوع_: `string`
+  - _الافتراضي_: `inclusive`
+  - _الوصف_: ضمان تنفيذ قوي للمحتوى المترجم باستخدام TypeScript.
+  - _ملاحظة_: إذا تم تعيينها إلى "strict"، فإن وظيفة الترجمة `t` ستتطلب تعريف كل اللغات المعلنة. إذا كانت لغة واحدة مفقودة، أو إذا لم يتم الإعلان عن لغة في التكوين الخاص بك، فسيتم إلقاء خطأ.
+  - _ملاحظة_: إذا تم تعيينها إلى "inclusive"، فإن وظيفة الترجمة `t` ستتطلب تعريف كل اللغات المعلنة. إذا كانت لغة واحدة مفقودة، فسيتم إلقاء تحذير. ولكن سيتم قبول إذا لم يتم الإعلان عن لغة في التكوين الخاص بك، ولكنها موجودة.
+  - _ملاحظة_: إذا تم تعيينها إلى "loose"، فإن وظيفة الترجمة `t` ستقبل أي لغة موجودة.
+
+- **defaultLocale**:
+
+  - _النوع_: `string`
+  - _الافتراضي_: `'en'`
+  - _الوصف_: اللغة الافتراضية المستخدمة كبديل إذا لم يتم العثور على اللغة المطلوبة.
+  - _مثال_: `'en'`
+  - _ملاحظة_: يتم استخدام هذا لتحديد اللغة عندما لا يتم تحديد أي لغة في عنوان URL أو الكوكيز أو الرأس.
+
+---
+
+### تكوين المحرر
+
+يحدد الإعدادات المتعلقة بالمحرر المدمج، بما في ذلك منفذ الخادم وحالة التفعيل.
+
+#### الخصائص
+
+- **applicationURL**:
+
+  - _النوع_: `string`
+  - _الافتراضي_: `http://localhost:3000`
+  - _الوصف_: عنوان URL للتطبيق. يُستخدم لتقييد أصل المحرر لأسباب أمنية.
+  - _مثال_:
+    - `'http://localhost:3000'`
+    - `'https://example.com'`
+    - `process.env.INTLAYER_EDITOR_URL`
+  - _ملاحظة_: عنوان URL للتطبيق. يُستخدم لتقييد أصل المحرر لأسباب أمنية. إذا تم تعيينه إلى `'*'`، فإن المحرر يكون متاحًا من أي أصل.
+
+- **port**:
+
+  - _النوع_: `number`
+  - _الافتراضي_: `8000`
+  - _الوصف_: المنفذ المستخدم بواسطة خادم المحرر المرئي.
+
+- **editorURL**:
+
+  - _النوع_: `string`
+  - _الافتراضي_: `'http://localhost:8000'`
+  - _الوصف_: عنوان URL لخادم المحرر. يُستخدم لتقييد أصل المحرر لأسباب أمنية.
+    - `'http://localhost:3000'`
+    - `'https://example.com'`
+    - `process.env.INTLAYER_EDITOR_URL`
+  - _ملاحظة_: عنوان URL لخادم المحرر للوصول إليه من التطبيق. يُستخدم لتقييد الأصول التي يمكنها التفاعل مع التطبيق لأسباب أمنية. إذا تم تعيينه إلى `'*'`، فإن المحرر يكون متاحًا من أي أصل. يجب تعيينه إذا تم تغيير المنفذ، أو إذا كان المحرر مستضافًا على نطاق مختلف.
+
+- **cmsURL**:
+
+  - _النوع_: `string`
+  - _الافتراضي_: `'https://intlayer.org'`
+  - _الوصف_: عنوان URL لنظام إدارة المحتوى Intlayer.
+  - _مثال_: `'https://intlayer.org'`
+  - _ملاحظة_: عنوان URL لنظام إدارة المحتوى Intlayer.
+
+- **backendURL**:
+
+  - _النوع_: `string`
+  - _الافتراضي_: `https://back.intlayer.org`
+  - _الوصف_: عنوان URL لخادم الخلفية.
+  - _مثال_: `http://localhost:4000`
+
+- **enabled**:
+
+  - _النوع_: `boolean`
+  - _الافتراضي_: `true`
+  - _الوصف_: يشير إلى ما إذا كان التطبيق يتفاعل مع المحرر المرئي.
+  - _مثال_: `process.env.NODE_ENV !== 'production'`
+  - _ملاحظة_: إذا كانت القيمة true، سيتمكن المحرر من التفاعل مع التطبيق. إذا كانت القيمة false، لن يتمكن المحرر من التفاعل مع التطبيق. في أي حال، يمكن تمكين المحرر فقط بواسطة المحرر المرئي. تعطيل المحرر لبيئات معينة هو وسيلة لتعزيز الأمان.
+
+- **clientId**:
+
+  - _النوع_: `string` | `undefined`
+  - _الافتراضي_: `undefined`
+  - _الوصف_: clientId و clientSecret يسمحان لحزم Intlayer بالمصادقة مع الخلفية باستخدام مصادقة oAuth2. يتم استخدام رمز وصول للمصادقة مع المستخدم المرتبط بالمشروع. للحصول على رمز وصول، قم بزيارة https://intlayer.org/dashboard/project وقم بإنشاء حساب.
+  - _مثال_: `true`
+  - _ملاحظة_: مهم: يجب الحفاظ على سرية clientId و clientSecret وعدم مشاركتهما علنًا. يرجى التأكد من الاحتفاظ بهما في مكان آمن، مثل متغيرات البيئة.
+
+- **clientSecret**:
+
+  - _النوع_: `string` | `undefined`
+  - _الافتراضي_: `undefined`
+  - _الوصف_: clientId و clientSecret يسمحان لحزم Intlayer بالمصادقة مع الخلفية باستخدام مصادقة oAuth2. يتم استخدام رمز وصول للمصادقة مع المستخدم المرتبط بالمشروع. للحصول على رمز وصول، قم بزيارة https://intlayer.org/dashboard/project وقم بإنشاء حساب.
+  - _مثال_: `true`
+  - _ملاحظة_: مهم: يجب الحفاظ على سرية clientId و clientSecret وعدم مشاركتهما علنًا. يرجى التأكد من الاحتفاظ بهما في مكان آمن، مثل متغيرات البيئة.
+
+- **hotReload**:
+
+  - _النوع_: `boolean`
+  - _الافتراضي_: `false`
+  - _الوصف_: يشير إلى ما إذا كان التطبيق يجب أن يعيد تحميل تكوينات اللغة تلقائيًا عند اكتشاف تغيير.
+  - _مثال_: `true`
+  - _ملاحظة_: على سبيل المثال، عند إضافة أو تحديث قاموس جديد، سيقوم التطبيق بتحديث المحتوى لعرضه في الصفحة.
+  - _ملاحظة_: نظرًا لأن إعادة التحميل التلقائي تحتاج إلى اتصال مستمر بالخادم، فهي متاحة فقط لعملاء خطة `enterprise`.
+
+- **dictionaryPriorityStrategy**:
+  - _النوع_: `string`
+  - _الافتراضي_: `'local_first'`
+  - _الوصف_: الاستراتيجية لتحديد أولوية القواميس في حالة وجود قواميس محلية وبعيدة. إذا تم تعيينها إلى `'distant_first'`، سيعطي التطبيق الأولوية للقواميس البعيدة على القواميس المحلية. إذا تم تعيينها إلى `'local_first'`، سيعطي التطبيق الأولوية للقواميس المحلية على القواميس البعيدة.
+  - _مثال_: `'distant_first'`
+
+### تكوين الوسيط
+
+الإعدادات التي تتحكم في سلوك الوسيط، بما في ذلك كيفية تعامل التطبيق مع الكوكيز، والرؤوس، وبادئات عناوين URL لإدارة اللغة.
+
+#### الخصائص
+
+- **headerName**:
+
+  - _النوع_: `string`
+  - _الافتراضي_: `'x-intlayer-locale'`
+  - _الوصف_: اسم رأس HTTP المستخدم لتحديد اللغة.
+  - _مثال_: `'x-custom-locale'`
+  - _ملاحظة_: هذا مفيد لتحديد اللغة بناءً على API.
+
+---
+
+- **cookieName**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'intlayer-locale'`
+  - _الوصف_: اسم الكوكي المستخدم لتخزين اللغة.
+  - _مثال_: `'custom-locale'`
+  - _ملاحظة_: يُستخدم للحفاظ على اللغة عبر الجلسات.
+
+- **prefixDefault**:
+
+  - _النوع_: `boolean`
+  - _القيمة الافتراضية_: `true`
+  - _الوصف_: ما إذا كان يجب تضمين اللغة الافتراضية في عنوان URL.
+  - _مثال_: `false`
+  - _ملاحظة_: إذا كانت القيمة `false`، فلن تحتوي عناوين URL الخاصة باللغة الافتراضية على بادئة اللغة.
+
+- **basePath**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `''`
+  - _الوصف_: المسار الأساسي لعناوين URL الخاصة بالتطبيق.
+  - _مثال_: `'/my-app'`
+  - _ملاحظة_: يؤثر هذا على كيفية بناء عناوين URL للتطبيق.
+
+- **serverSetCookie**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'always'`
+  - _الوصف_: قاعدة تعيين الكوكي الخاص باللغة على الخادم.
+  - _الخيارات_: `'always'`, `'never'`
+  - _مثال_: `'never'`
+  - _ملاحظة_: يتحكم في ما إذا كان يتم تعيين الكوكي الخاص باللغة مع كل طلب أو لا.
+
+- **noPrefix**:
+  - _النوع_: `boolean`
+  - _القيمة الافتراضية_: `false`
+  - _الوصف_: ما إذا كان يجب حذف بادئة اللغة من عناوين URL.
+  - _مثال_: `true`
+  - _ملاحظة_: إذا كانت القيمة `true`، فلن تحتوي عناوين URL على معلومات اللغة.
+
+---
+
+### إعدادات المحتوى
+
+الإعدادات المتعلقة بمعالجة المحتوى داخل التطبيق، بما في ذلك أسماء الدلائل، امتدادات الملفات، والتكوينات المشتقة.
+
+#### الخصائص
+
+- **watch**:
+
+  - _النوع_: `boolean`
+  - _القيمة الافتراضية_: `process.env.NODE_ENV === 'development'`
+  - _الوصف_: يشير إلى ما إذا كان Intlayer يجب أن يراقب التغييرات في ملفات إعلان المحتوى في التطبيق لإعادة بناء القواميس ذات الصلة.
+
+- **fileExtensions**:
+
+  - _النوع_: `string[]`
+  - _القيمة الافتراضية_: `['.content.ts', '.content.js', '.content.cjs', '.content.mjs', '.content.json', '.content.tsx', '.content.jsx']`
+  - _الوصف_: امتدادات الملفات التي يجب البحث عنها عند بناء القواميس.
+  - _مثال_: `['.data.ts', '.data.js', '.data.json']`
+  - _ملاحظة_: تخصيص امتدادات الملفات يمكن أن يساعد في تجنب التعارضات.
+
+- **baseDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `process.cwd()`
+  - _الوصف_: الدليل الأساسي للمشروع.
+  - _مثال_: `'/path/to/project'`
+  - _ملاحظة_: يُستخدم هذا لحل جميع الأدلة المتعلقة بـ Intlayer.
+
+- **dictionaryOutput**:
+
+  - _النوع_: `string[]`
+  - _القيمة الافتراضية_: `['intlayer']`
+  - _الوصف_: نوع إخراج القاموس المستخدم، مثل `'intlayer'` أو `'i18next'`.
+
+- **contentDir**:
+
+  - _النوع_: `string[]`
+  - _القيمة الافتراضية_: `['src']`
+  - _الوصف_: مسار الدليل حيث يتم تخزين المحتوى.
+
+- **dictionariesDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'.intlayer/dictionaries'`
+  - _الوصف_: مسار الدليل لتخزين النتائج الوسيطة أو النهائية.
+
+- **moduleAugmentationDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'.intlayer/types'`
+  - _الوصف_: دليل لتوسيع الوحدات، مما يسمح بتحسين اقتراحات IDE وفحص الأنواع.
+  - _مثال_: `'intlayer-types'`
+  - _ملاحظة_: تأكد من تضمين هذا في `tsconfig.json`.
+
+- **unmergedDictionariesDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'.intlayer/unmerged_dictionary'`
+  - _الوصف_: الدليل لتخزين القواميس غير المدمجة.
+  - _مثال_: `'translations'`
+
+- **dictionariesDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'.intlayer/dictionary'`
+  - _الوصف_: الدليل لتخزين قواميس التوطين.
+  - _مثال_: `'translations'`
+
+- **i18nextResourcesDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'i18next_dictionary'`
+  - _الوصف_: الدليل لتخزين قواميس i18n.
+  - _مثال_: `'translations'`
+  - _ملاحظة_: تأكد من تكوين هذا الدليل لنوع إخراج i18next.
+
+- **typesDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'types'`
+  - _الوصف_: الدليل لتخزين أنواع القواميس.
+  - _مثال_: `'intlayer-types'`
+
+- **mainDir**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'main'`
+  - _الوصف_: الدليل حيث يتم تخزين ملفات التطبيق الرئيسية.
+  - _مثال_: `'intlayer-main'`
+
+- **excludedPath**:
+  - _النوع_: `string[]`
+  - _القيمة الافتراضية_: `['node_modules']`
+  - _الوصف_: الأدلة المستثناة من البحث عن المحتوى.
+  - _ملاحظة_: هذا الإعداد لم يُستخدم بعد، ولكنه مخطط للتنفيذ في المستقبل.
+
+### إعدادات السجل
+
+الإعدادات التي تتحكم في السجل، بما في ذلك البادئة المستخدمة.
+
+#### الخصائص
+
+- **mode**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `default`
+  - _الوصف_: يشير إلى وضع السجل.
+  - _الخيارات_: `default`, `verbose`, `disabled`
+  - _مثال_: `default`
+  - _ملاحظة_: وضع السجل. وضع verbose سيسجل المزيد من المعلومات، ولكنه يمكن استخدامه لأغراض التصحيح. وضع disabled سيعطل السجل.
+
+- **prefix**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'[intlayer] '`
+  - _الوصف_: البادئة الخاصة بالسجل.
+  - _مثال_: `'[my custom prefix] '`
+  - _ملاحظة_: البادئة الخاصة بالسجل.
+
+### إعدادات الذكاء الاصطناعي
+
+الإعدادات التي تتحكم في ميزات الذكاء الاصطناعي لـ Intlayer، بما في ذلك المزود، النموذج، ومفتاح API.
+
+هذا التكوين اختياري إذا كنت مسجلاً في [لوحة تحكم Intlayer](https://intlayer.org/dashboard/project) باستخدام مفتاح وصول. سيقوم Intlayer تلقائيًا بإدارة الحلول الأكثر كفاءة وفعالية من حيث التكلفة لاحتياجاتك. استخدام الخيارات الافتراضية يضمن صيانة أفضل على المدى الطويل حيث يقوم Intlayer بتحديث نفسه باستمرار لاستخدام النماذج الأكثر صلة.
+
+إذا كنت تفضل استخدام مفتاح API الخاص بك أو نموذج معين، يمكنك تعريف إعدادات الذكاء الاصطناعي المخصصة الخاصة بك. سيتم استخدام هذا التكوين عالميًا عبر بيئة Intlayer الخاصة بك. ستستخدم أوامر CLI هذه الإعدادات كإعدادات افتراضية للأوامر (مثل `fill`) بالإضافة إلى SDK، المحرر المرئي، وCMS. يمكنك تجاوز هذه القيم الافتراضية لحالات استخدام محددة باستخدام معلمات الأوامر.
+
+يدعم Intlayer العديد من مزودي الذكاء الاصطناعي لتعزيز المرونة والاختيار. المزودون المدعومون حاليًا هم:
+
+- **OpenAI** (الافتراضي)
+- **Anthropic Claude**
+- **Mistral AI**
+- **DeepSeek**
+- **Google Gemini**
+- **Meta Llama**
+
+#### الخصائص
+
+- **provider**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: `'openai'`
+  - _الوصف_: المزود المستخدم لميزات الذكاء الاصطناعي لـ Intlayer.
+  - _الخيارات_: `'openai'`, `'anthropic'`, `'mistral'`, `'deepseek'`, `'gemini'`
+  - _مثال_: `'anthropic'`
+  - _ملاحظة_: قد تتطلب المزودات المختلفة مفاتيح API مختلفة ولديها نماذج تسعير مختلفة.
+
+- **model**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: لا شيء
+  - _الوصف_: النموذج المستخدم لميزات الذكاء الاصطناعي لـ Intlayer.
+  - _مثال_: `'gpt-4o-2024-11-20'`
+  - _ملاحظة_: النموذج المحدد للاستخدام يختلف حسب المزود.
+
+- **temperature**:
+
+  - _النوع_: `number`
+  - _القيمة الافتراضية_: لا شيء
+  - _الوصف_: تتحكم درجة الحرارة في عشوائية استجابات الذكاء الاصطناعي.
+  - _مثال_: `0.1`
+  - _ملاحظة_: درجة حرارة أعلى ستجعل الذكاء الاصطناعي أكثر إبداعًا وأقل توقعًا.
+
+- **apiKey**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: لا شيء
+  - _الوصف_: مفتاح API الخاص بك للمزود المحدد.
+  - _مثال_: `process.env.OPENAI_API_KEY`
+  - _ملاحظة_: مهم: يجب الحفاظ على سرية مفاتيح API وعدم مشاركتها علنًا. يرجى التأكد من الاحتفاظ بها في مكان آمن، مثل متغيرات البيئة.
+
+- **applicationContext**:
+
+  - _النوع_: `string`
+  - _القيمة الافتراضية_: لا شيء
+  - _الوصف_: يوفر سياقًا إضافيًا حول تطبيقك لنموذج الذكاء الاصطناعي، مما يساعده على توليد ترجمات أكثر دقة وملاءمة للسياق. يمكن أن يشمل ذلك معلومات حول مجال تطبيقك، الجمهور المستهدف، النبرة، أو المصطلحات الخاصة.
+
+### تكوين البناء
+
+الإعدادات التي تتحكم في كيفية تحسين وبناء التدويل في تطبيقك.
+
+تنطبق خيارات البناء على إضافات `@intlayer/babel` و `@intlayer/swc`.
+
+> في وضع التطوير، يستخدم Intlayer استيرادًا ثابتًا مركزيًا للقواميس لتبسيط تجربة التطوير.
+
+> من خلال تحسين البناء، سيقوم Intlayer باستبدال جميع استدعاءات القواميس لتحسين التجزئة. بهذه الطريقة سيقوم البناء النهائي باستيراد القواميس المستخدمة فقط.
+
+- **ملاحظة**: `@intlayer/babel` متاح افتراضيًا في حزمة `vite-intlayer`، لكن `@intlayer/swc` غير مثبت افتراضيًا في حزمة `next-intlayer` حيث أن إضافات SWC لا تزال تجريبية في Next.js.
+
+#### الخصائص
+
+- **optimize**:
+
+  - _النوع_: `boolean`
+  - _القيمة الافتراضية_: `process.env.NODE_ENV === 'production'`
+  - _الوصف_: يتحكم في ما إذا كان يجب تحسين البناء.
+  - _مثال_: `true`
+  - _ملاحظة_: سيسمح باستيراد القواميس المستخدمة فقط في الحزمة. لكن ستظل جميع عمليات الاستيراد كاستيراد ثابت لتجنب المعالجة غير المتزامنة عند تحميل القواميس.
+  - _ملاحظة_: عند التمكين، سيقوم Intlayer بتحسين تجزئة القاموس عن طريق استبدال جميع استدعاءات `useIntlayer` بـ `useDictionary` و `getIntlayer` بـ `getDictionary`.
+  - _ملاحظة_: تأكد من أن جميع المفاتيح معلنة بشكل ثابت في استدعاءات `useIntlayer`. مثال: `useIntlayer('navbar')`.
+
+- **activateDynamicImport**:
+
+  - _النوع_: `boolean`
+  - _القيمة الافتراضية_: `false`
+  - _الوصف_: يتحكم في ما إذا كان يجب استيراد محتوى القاموس ديناميكيًا لكل لغة.
+  - _مثال_: `true`
+  - _ملاحظة_: سيسمح باستيراد محتوى القاموس ديناميكيًا للغة الحالية فقط.
+  - _ملاحظة_: تعتمد الاستيرادات الديناميكية على React Suspense وقد تؤثر قليلاً على أداء العرض. ولكن إذا تم تعطيلها، سيتم تحميل جميع اللغات مرة واحدة، حتى لو لم يتم استخدامها.
+  - _ملاحظة_: عند التمكين، سيقوم Intlayer بتحسين تجزئة القاموس عن طريق استبدال جميع استدعاءات `useIntlayer` بـ `useDynamicDictionary`.
+  - _ملاحظة_: سيتم تجاهل هذا الخيار إذا تم تعطيل `optimize`.
+  - _ملاحظة_: تأكد من أن جميع المفاتيح معلنة بشكل ثابت في استدعاءات `useIntlayer`. مثال: `useIntlayer('navbar')`.
+
+- **traversePattern**:
+  - _النوع_: `string[]`
+  - _القيمة الافتراضية_: `['**/*.{js,ts,mjs,cjs,jsx,tsx,mjx,cjx,vue,svelte,svte}', '!**/node_modules/**']`
+  - _الوصف_: الأنماط التي تحدد الملفات التي يجب اجتيازها أثناء التحسين.
+  - _مثال_: `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']`
+  - _ملاحظة_: استخدم هذا لتقييد التحسين على ملفات الكود ذات الصلة وتحسين أداء البناء.
+  - _ملاحظة_: سيتم تجاهل هذا الخيار إذا تم تعطيل `optimize`.
+  - _ملاحظة_: استخدم نمط glob.