@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/ar/intlayer_with_vite+vue.md

@@ -42,32 +42,49 @@ author: aymericzip
 
 ** تغطية فيو كاملة **
 
+<Accordion header="تغطية Vue كاملة">
+
 تم تحسين Intlayer للعمل بشكل مثالي مع Vue من خلال تقديم **نطاق المحتوى على مستوى المكونات** و**الترجمات التفاعلية** وجميع الميزات اللازمة لتوسيع نطاق التدويل (i18n).
 
 **حجم البندل**
 
+<Accordion header="حجم الحزمة">
+
 بدلاً من تحميل ملفات JSON ضخمة إلى صفحاتك، قم بتحميل المحتوى الضروري فقط. يساعد Intlayer **في تقليل أحجام البندل وصفحاتك بنسبة تصل إلى 50%**.
 
 ** الصيانة **
 
+<Accordion header="قابلية الصيانة">
+
 يؤدي تحديد نطاق محتوى تطبيقك ** إلى تسهيل الصيانة ** للتطبيقات واسعة النطاق. يمكنك تكرار أو حذف مجلد ميزات واحد دون العبء العقلي لمراجعة قاعدة بيانات المحتوى بالكامل. بالإضافة إلى ذلك، تتم كتابة Intlayer **بالكامل** لضمان دقة المحتوى الخاص بك.
 
+</Accordion>
+
 ** وكيل الذكاء الاصطناعي **
 
 يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
 **الأتمتة**
 
+<Accordion header="التشغيل الآلي">
+
 استخدم الأتمتة للترجمة في مسار CI/CD الخاص بك باستخدام LLM من اختيارك على حساب مزود الذكاء الاصطناعي الخاص بك. يقدم Intlayer أيضًا **مترجمًا** لأتمتة استخراج المحتوى، بالإضافة إلى [منصة ويب](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) للمساعدة في **الترجمة في الخلفية**.
 
+</Accordion>
+
 **أداء**
 
 يمكن أن يؤدي ربط ملفات JSON الضخمة بالمكونات إلى حدوث مشكلات في الأداء والتفاعل. يعمل Intlayer على تحسين تحميل المحتوى الخاص بك في وقت الإنشاء.
 
+</Accordion>
+
 **التحجيم مع عدم وجود مطور**
 
 أكثر من مجرد حل i18n، يوفر Intlayer **[محررًا مرئيًا] مستضافًا ذاتيًا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** و**[كامل CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** لمساعدتك في إدارة المحتوى متعدد اللغات في **الوقت الفعلي**، مما يجعل التعاون مع المترجمين ومؤلفي النصوص وأعضاء الفريق الآخرين سلسًا. يمكن تخزين المحتوى محليًا و/أو عن بعد.
 
+</Accordion>
+</AccordionGroup>
+
 ---
 
 ## دليل خطوة بخطوة لإعداد Intlayer في تطبيق Vite و Vue
@@ -343,6 +360,13 @@ app.use(intlayer);
 app.mount("#app");
 ```
 
+> يمكنك أيضاً استدعاء `installIntlayer(app)` مباشرة كدالة إذا فضلت:
+>
+> ```javascript
+> import { intlayer } from "vue-intlayer";
+> app.use(intlayer);
+> ```
+
 يمكنك الوصول إلى قواميس المحتوى الخاصة بك في جميع أنحاء تطبيقك من خلال إنشاء مكون Vue رئيسي واستخدام التركيبات `useIntlayer`:
 
 ```vue fileName="src/HelloWord.vue"
@@ -396,6 +420,8 @@ const countRef = ref(0);
 </template>
 ```
 
+> إذا كان لديك تطبيق موجود بالفعل، يمكنك استخدام [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compiler.md)، بالإضافة إلى [أمر extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/extract.md)، لتحويل آلاف المكونات في ثانية واحدة.
+
 #### الوصول إلى المحتوى في Intlayer
 
 يقدم Intlayer واجهات برمجة تطبيقات مختلفة للوصول إلى المحتوى الخاص بك:
@@ -414,8 +440,6 @@ const countRef = ref(0);
   - استخدم `const content = useIntlayer("myContent");` و `{{ content.myContent }}` / `<content.myContent />`.
   - أو استخدم `const { myContent } = useIntlayer("myContent");` و `{{ myContent}}` / `<myContent/>` لتفكيك المحتوى.
 
-> إذا كان تطبيقك موجودًا بالفعل، يمكنك استخدام [مترجم Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compiler.md)، بالإضافة إلى [أمر الاستخراج](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/extract.md)، لتحويل آلاف المكونات في ثانية واحدة.
-
 </Step>
 
 <Step number={6} title="تغيير لغة المحتوى الخاص بك" isOptional={true}>
@@ -603,6 +627,10 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 
 بالتوازي، يمكنك أيضًا استخدام `intlayerProxy` لإضافة التوجيه من جانب الخادم إلى تطبيقك. سيقوم هذا المكون الإضافي بالكشف تلقائيًا عن اللغة الحالية بناءً على عنوان URL وتعيين ملف تعريف الارتباط المناسب للغة. إذا لم يتم تحديد لغة، سيحدد المكون الإضافي اللغة الأنسب بناءً على تفضيلات لغة متصفح المستخدم. إذا لم يتم الكشف عن أي لغة، فسيتم إعادة التوجيه إلى اللغة الافتراضية.
 
+> لاحظ أنه لاستخدام `intlayerProxy` في الإنتاج، تحتاج إلى نقل حزمة `vite-intlayer` من `devDependencies` إلى `dependencies`.
+
+> منذ Intlayer v9، يتم دمج `intlayerProxy()` مباشرة في مكون `intlayer()` وتفعيله بشكل افتراضي من خلال خيار `routing.enableProxy` (`true` بشكل افتراضي). تسجيله بشكل منفصل كما هو موضح أدناه أصبح اختياريًا الآن — يتم الاحتفاظ به للتوافق مع الإصدارات السابقة وللإعدادات التي تحتاج إلى التحكم في ترتيب المكونات الإضافية. عيّن `routing.enableProxy: false` لعدم الاستخدام. اطّلع على [ملاحظات إصدار v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
@@ -943,18 +971,6 @@ bun x intlayer extract
 
 > Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
 
-```bash packageManager="npm"
-npm install @intlayer/babel --save-dev
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/babel --save-dev
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/babel --save-dev
-```
-
 ```bash packageManager="bun"
 bun add @intlayer/babel --dev
 ```
@@ -1121,3 +1137,5 @@ console.log("SEO files generated successfully.");
 ### التقدم أكثر
 
 للتقدم أكثر، يمكنك تنفيذ [المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md) أو إخراج محتواك باستخدام [نظام إدارة المحتوى (CMS)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md).
+
+Once you share these, I'll perform the complete audit and return the fully updated Arabic content with proper formatting.---

package/docs/ar/live-sync.md

@@ -42,8 +42,6 @@ author: aymericzip
 
 ## تفعيل التزامن الحي
 
-> يتطلب التزامن الحي اتصالًا مستمرًا بالخادم وهو متاح في خطة المؤسسات.
-
 قم بتمكين التزامن الحي عن طريق تحديث تكوين Intlayer الخاص بك:
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
@@ -83,8 +81,21 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
+شغّل خادم Live Sync لتغليف تطبيقك:
+
 ابدأ خادم المزامنة الحية لتغليف تطبيقك:
 
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... البرامج النصية الأخرى
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+يمكنك أيضًا استخدام خادم التطبيق الخاص بك بالتوازي باستخدام وسيط `--process`.
+
 مثال باستخدام Next.js:
 
 ```json5 fileName="package.json"

package/docs/ar/packages/elysia-intlayer/exports.md

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: وثائق حزمة elysia-intlayer
+description: مُكون إضافي لـ Elysia لـ Intlayer يوفر دوال ترجمة واكتشاف اللغة.
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "توثيق موحّد لجميع الصادرات"
+author: aymericzip
+---
+
+# حزمة elysia-intlayer
+
+توفر حزمة `elysia-intlayer` ملحقًا لتطبيقات Elysia للتعامل مع التدويل (internationalization). تقوم باكتشاف الـ locale الخاص بالمستخدم وتحقن كائن `intlayer` في سياق المسار.
+
+## التثبيت
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia` هي peer dependency (`>=1.0.0`). ويستهدف Elysia بيئة تشغيل **Bun**.
+
+## الصادرات
+
+### الملحق
+
+استيراد:
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| الدالة     | الوصف                                                                                                                                                                                                                                                                 | الوثيقة ذات الصلة                                                                                              |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | ملحق Elysia يدمج Intlayer في تطبيق Elysia الخاص بك. يتولى اكتشاف الـ locale من التخزين (الكوكيز، الرؤوس) ثم من `Accept-Language`، ويحقن كائن `intlayer` يعرض `locale` و`t` و`getIntlayer` و`getDictionary` في سياق المسار، ويهيّئ سياق الطلب عبر `AsyncLocalStorage`. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/elysia-intlayer/intlayer.md) |
+
+### الوظائف
+
+استيراد:
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| الدالة          | الوصف                                                                                                                                                                                                                    | الوثيقة ذات الصلة                                                                                      |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
+| `t`             | دالة ترجمة عامة تسترجع المحتوى للـ locale الحالي في Elysia. تستخدم `AsyncLocalStorage` للوصول إلى سياق الطلب الذي يهيّئه المكوّن `intlayer`، وتعود إلى اللغة الافتراضية خارجه. يمكن الوصول إليها أيضًا عبر `intlayer.t`. | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md) |
+| `getIntlayer`   | يسترجع قاموسًا عبر مفتاحه من التصريح المُولَّد ويعيد محتواه للـ locale الحالي. نسخة محسّنة من `getDictionary`. يستخدم `AsyncLocalStorage` للوصول إلى سياق الطلب. يمكن الوصول إليه أيضًا عبر `intlayer.getIntlayer`.      | -                                                                                                      |
+| `getDictionary` | يعالج كائنات القواميس ويعيد المحتوى للـ locale الحالي. يعالج ترجمات `t()` والتعدادات وmarkdown وHTML وغيرها. يستخدم `AsyncLocalStorage` للوصول إلى سياق الطلب. يمكن الوصول إليه أيضًا عبر `intlayer.getDictionary`.      | -                                                                                                      |
+
+### الأنواع
+
+استيراد:
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| النوع               | الوصف                                                                                                                                             |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `IntlayerContext`   | شكل كائن `intlayer` المحقون في كل سياق مسار: `locale`، `locale_storage`، `locale_detected`، `defaultLocale`، `t`، `getIntlayer`، `getDictionary`. |
+| `TranslateFunction` | توقيع دالة الترجمة التي تحوّل locale map إلى المحتوى المطابق للـ locale الخاص بالطلب الحالي.                                                      |
+
+## الاستخدام
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // تحميل إضافة التدويل
+  .use(intlayer())
+  // قراءة اللغة والدوال المساعدة من سياق المسار
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      ar: "مرحبًا",
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // أو استخدام الدوال المساعدة المستقلة، المرتبطة بالطلب الحالي
+  .get("/t_example", () =>
+    t({
+      ar: "مثال على المحتوى المرجع باللغة العربية",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> تسجّل الإضافة سياقها عبر `derive` **عام**، والذي يعطيه Elysia النوع `Partial<{ intlayer: IntlayerContext }>`. تكون القيمة موجودة دائماً وقت التشغيل للمسارات المسجَّلة بعد `.use(intlayer())`، لذا استخدم تأكيد عدم الفراغ (`intlayer!.locale`) — أو التسلسل الاختياري — لإرضاء TypeScript في الوضع `strict`.
+
+## وثائق ذات صلة
+
+- [Elysia i18n - دليل شامل لترجمة تطبيقك](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_elysia.md)
+- [الإعدادات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)

package/docs/ar/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: توثيق مكوّن intlayer لـ Elysia | elysia-intlayer
+description: تعرّف على كيفية استخدام المكوّن intlayer من حزمة elysia-intlayer
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - التدويل
+  - التوثيق
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "تهيئة التوثيق"
+author: aymericzip
+---
+
+# توثيق مكوّن intlayer لـ Elysia
+
+يقوم المكوّن `intlayer` لـ Elysia باكتشاف الـ locale الخاص بالمستخدم ويحقن كائن `intlayer` في سياق المسار (route context). كما يتيح استخدام دوال الترجمة العامة ضمن سياق الطلب.
+
+## الاستخدام
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    ar: "مرحبًا",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> تسجّل الإضافة سياقها عبر `derive` **عام**، والذي يعطيه Elysia النوع `Partial<{ intlayer: IntlayerContext }>`. تكون القيمة موجودة دائماً وقت التشغيل للمسارات المسجَّلة بعد `.use(intlayer())`، لذا استخدم تأكيد عدم الفراغ (`intlayer!.t`) — أو التسلسل الاختياري — لإرضاء TypeScript في الوضع `strict`.
+
+نفس الدوال المساعدة متاحة كصادرات مستقلة، بحيث يمكنك استدعاؤها دون تفكيك سياق المسار:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    ar: "مرحبًا",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## الوصف
+
+يقوم المكوّن الإضافي بالمهام التالية:
+
+1. **كشف الـ locale**: يقرأ الـ locale الذي حدده العميل صراحةً من التخزين (كوكي، هيدر)، ثم يعود إلى الـ locale المتفاوض عليه من هيدر `Accept-Language`.
+2. **الحقن في السياق**: تضيف خاصية `intlayer` إلى سياق المسار في Elysia (انظر جدول سياق المسار أدناه).
+3. **إدارة السياق**: يستخدم `AsyncLocalStorage` لإدارة سياق غير متزامن، مما يسمح لدوال Intlayer العامة (`t`، `getIntlayer`، `getDictionary`) بالوصول إلى الـ locale الخاص بكل طلب دون تمرير كائن السياق.
+4. **تجهيز القواميس**: تستدعي `prepareIntlayer` عند إنشاء الإضافة، بحيث تُبنى القواميس عند إقلاع التطبيق.
+
+### سياق المسار
+
+| الخاصية           | النوع                  | الوصف                                                                             |
+| ----------------- | ---------------------- | --------------------------------------------------------------------------------- |
+| `locale`          | `Locale`               | الـ locale المستخدم لهذا الطلب، مع أولوية `locale_storage` على `locale_detected`. |
+| `locale_storage`  | `Locale` (اختياري)     | الـ locale الذي طلبه العميل صراحةً عبر كوكي أو هيدر.                              |
+| `locale_detected` | `Locale`               | الـ locale المتفاوض عليه من رؤوس الطلب.                                           |
+| `defaultLocale`   | `Locale`               | الـ locale المُعد كخيار احتياطي في `intlayer.config.ts`.                          |
+| `t`               | `TranslateFunction`    | دالة ترجمة.                                                                       |
+| `getIntlayer`     | `typeof getIntlayer`   | دالة لاسترجاع القواميس عبر المفتاح.                                               |
+| `getDictionary`   | `typeof getDictionary` | دالة لمعالجة كائنات القواميس.                                                     |
+
+> على عكس مكوّنات Intlayer المبنية على Node، يعتمد `elysia-intlayer` على `AsyncLocalStorage` بدلًا من `cls-hooked`، لأن `cls-hooked` يعتمد على `async_hooks.createHook` الذي لا يطبّقه Bun.
+
+يتم تحرير سياق الطلب بمجرد تعيين الاستجابة، بحيث لا تُحلّ الدوال المساعدة المستقلة أبدًا مقابل طلب انتهى بالفعل. وعند استدعائها خارج طلب يعالجه المكوّن، تعود إلى الـ locale الافتراضي المُعد.
+
+## ترتيب تحديد اللغة
+
+بشكل افتراضي، تحلّ الإضافة اللغة بالترتيب التالي:
+
+1. كوكي `INTLAYER_LOCALE`.
+2. ترويسة `x-intlayer-locale`.
+3. التفاوض عبر ترويسة `Accept-Language`.
+4. قيمة `defaultLocale` المُعدّة.
+
+```bash
+# تم التفاوض عليها من `Accept-Language`
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# للكوكي أولوية على `Accept-Language`
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# للترويسة أولوية على `Accept-Language`
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## الإعداد
+
+يقرأ المكوّن ملف `intlayer.config.ts` الخاص بك. يمكنك تخصيص الكوكي والهيدر المستخدمين لكشف الـ locale:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> لمزيد من المعلومات حول الإعداد، تفضّل بزيارة [توثيق الإعداد](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
+
+## وثائق ذات صلة
+
+- [وثائق حزمة elysia-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - دليل شامل لترجمة تطبيقك](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_elysia.md)

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

@@ -0,0 +1,155 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: وثائق دالة getDictionary | intlayer
+description: اطلع على كيفية استخدام دالة getDictionary لحزمة intlayer
+keywords:
+  - getDictionary
+  - dictionary
+  - interpreter
+  - content
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getDictionary
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# التوثيق: دالة `getDictionary` في `intlayer`
+
+## الوصف
+
+تقوم دالة `getDictionary` بتفسير كائن القاموس **الذي تمرره بنفسك** وتُرجع محتواه المحلّل لمنطقة معينة. تمشي عبر المحتوى في تمريرة واحدة وتطبق كل مكون إضافي للمفسّر حسب الحاجة، محلّلة ترجمات `t()`، والتعديلات، والشروط، والإدراجات، والتداخل، والـ markdown، و HTML وعُقد الملفات.
+
+على عكس [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getIntlayer.md)، التي تبحث عن قاموس حسب المفتاح في السجل المُنتج، تأخذ `getDictionary` القاموس نفسه. هذا يجعلها الأداة المناسبة للمحتوى المُنشأ في وقت التشغيل، أو الذي تم جلبه من API أو CMS، أو المُعلن عنه بشكل مباشر في اختبار.
+
+**المميزات الرئيسية:**
+
+- تعمل مع أي كائن يتبع بنية القاموس (`{ key, content }`)
+- تقبل أيضًا مجموعة قاموس مؤهلة (المجموعات، المتغيرات) بالتزامن مع محدِّد
+- مكتوبة بالكامل: الكائن المُرجع يعكس `content` الذي مررته
+- تقبل مكونات إضافية مفسّرة مخصصة
+
+---
+
+## توقيع الدالة
+
+```typescript
+getDictionary(
+  dictionary: Dictionary | QualifiedDictionaryGroup, // مطلوب
+  localeOrSelector?: LocalesValues | DictionarySelector, // اختياري
+  plugins?: Plugins[]                                // اختياري
+): DeepTransformContent<...>
+```
+
+---
+
+## المعاملات
+
+- `dictionary: Dictionary | QualifiedDictionaryGroup`
+  - **الوصف**: القاموس (أو مجموعة القاموس المؤهلة) الذي سيتم تفسيره.
+  - **النوع**: `Dictionary | QualifiedDictionaryGroup`
+  - **مطلوب**: نعم
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **الوصف**: اللغة لتفسير المحتوى بها، أو كائن محدد (`{ item }`, `{ variant }`, اختياري مع `locale`). انظر [القواميس الديناميكية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md).
+  - **النوع**: `LocalesValues | DictionarySelector`
+  - **مطلوب**: لا (اختياري) — يُفترض القيمة الافتراضية `defaultLocale`.
+
+- `plugins: Plugins[]`
+  - **الوصف**: مصفوفة من محولات العقد التي تحدد كيفية تفسير العقد المعروفة. إذا تم حذفها، يتم استخدام مجموعة مفسر البرامج الإضافية الافتراضية.
+  - **النوع**: `Plugins[]`
+  - **مطلوب**: لا (اختياري)
+
+### العودة
+
+- **Type**: المحتوى المترجم للقاموس.
+- **Description**: `content` التي مررتها، مع حل كل عقدة Intlayer للغة المطلوبة. بالنسبة لمجموعة collection بدون محدد `item`، يتم إرجاع مصفوفة مرتبة من الإدخالات المترجمة؛ يتم إرجاع `null` عندما يستهدف المحدد شيئًا لا يوجد.
+
+---
+
+## مثال على الاستخدام
+
+### الاستخدام الأساسي
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getDictionary, t } from "intlayer";
+
+const content = getDictionary(
+  {
+    key: "my_key",
+    content: {
+      greeting: t({
+        ar: "مرحبا",
+        en: "Hello",
+        fr: "Bonjour",
+      }),
+    },
+  },
+  "ar"
+);
+
+console.log(content.greeting); // "مرحبا"
+```
+
+### تفسير المحتوى المجلوب في وقت التشغيل
+
+```typescript
+import { getDictionary, type Dictionary } from "intlayer";
+
+const remoteDictionary: Dictionary = await fetch("/api/cms/banner").then(
+  (res) => res.json()
+);
+
+const banner = getDictionary(remoteDictionary, "fr");
+```
+
+### مع محدد
+
+```typescript
+import { getDictionary } from "intlayer";
+
+// يتم حل مجموعة قاموس مؤهلة إلى إدخال واحد…
+const secondItem = getDictionary(blogPostGroup, { item: 2, locale: "fr" });
+
+// …أو إلى مصفوفة مرتبة عندما لا يتم إعطاء `item`
+const allItems = getDictionary(blogPostGroup, { locale: "fr" });
+```
+
+---
+
+## الدوال ذات الصلة
+
+- [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getIntlayer.md): نفس التفسير، لكن يتم البحث عن القاموس حسب المفتاح في السجل المُنشأ.
+- [`getDictionaryAsync`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getDictionaryAsync.md): نظير خرائط المحمّل لكل لغة.
+- [`useDictionary`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/react-intlayer/useDictionary.md): معادل React hook، يقرأ اللغة من الموفر.
+
+---
+
+## TypeScript
+
+```typescript
+function getDictionary<
+  const T extends Dictionary | QualifiedDictionaryGroup,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  dictionary: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): DeepTransformContent<
+  ResolveQualifiedDictionaryContent<T, A>,
+  IInterpreterPluginState,
+  ExtractSelectorLocale<A>
+>;
+```