@intlayer/docs 9.3.3 → 9.4.0

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

@@ -0,0 +1,141 @@
+---
+createdAt: 2026-08-23
+updatedAt: 2026-08-23
+title: توثيق دالة getIntlayerAsync | intlayer
+description: انظر كيفية استخدام دالة getIntlayerAsync لحزمة intlayer
+keywords:
+  - getIntlayerAsync
+  - dictionary
+  - dynamic import
+  - metadata
+  - bundle optimization
+  - Intlayer
+  - intlayer
+  - Internationalization
+  - Documentation
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - getIntlayerAsync
+history:
+  - version: 9.4.0
+    date: 2026-08-23
+    changes: "Initial documentation"
+author: aymericzip
+---
+
+# التوثيق: دالة `getIntlayerAsync` في `intlayer`
+
+## الوصف
+
+تقوم دالة `getIntlayerAsync` باختيار قاموس واحد حسب مفتاحه وحل محتواه للغة معينة، **محملة تلك اللغة وحدها**.
+
+إنها النظير غير المتزامن لـ [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getIntlayer.md)، مخصصة للأماكن التي يتم فيها قراءة القاموس خارج العرض — منشئات `head` / metadata للمسار، loaders، server functions.
+
+حيث يسحب `getIntlayer` القاموس المدمج الذي يحتوي على كل لغة، فإن [build plugins](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/bundle_optimization.md) (`@intlayer/babel`, `@intlayer/swc`) تعيد كتابة هذا الاستدعاء إلى `getDictionaryAsync(loaderMap, key, locale)`، مشيرة إلى أجزاء كل لغة في `.intlayer/dynamic_dictionaries/`. وبالتالي، يحمل bundle فقط اللغة المطلوبة فعلياً.
+
+بدون هذه البرامج المساعدة — بناء غير محسّن — يتم حل الاستدعاء من خلال سجل القاموس المتزامن بدلاً من ذلك: نفس المحتوى، بدون تقسيم اللغة.
+
+**الميزات الرئيسية:**
+
+- نفس المفاتيح المكتوبة والمحددات والمحتوى المُرجع مثل `getIntlayer`
+- يحمل فقط جزء اللغة المطلوب في الإنشاءات المحسّنة
+- الاستدعاءات المتزامنة لنفس الجزء تشارك تحميلاً واحداً
+- آمن للاستخدام في منشئات `async` metadata و loaders و server functions
+
+---
+
+## Function Signature
+
+```typescript
+getIntlayerAsync(
+  key: DictionaryKeys,                        // مطلوب
+  localeOrSelector?: LocalesValues | DictionarySelector, // اختياري
+  plugins?: Plugins[]                         // اختياري
+): Promise<DeepTransformContent<...>>
+```
+
+---
+
+## المعاملات
+
+- `key: DictionaryKeys`
+  - **الوصف**: مفتاح القاموس المراد قراءته، كما هو معرّف في ملفات المحتوى الخاصة بك.
+  - **النوع**: `DictionaryKeys` — اتحاد لكل مفتاح قاموس معلن.
+  - **مطلوب**: نعم
+
+- `localeOrSelector: LocalesValues | DictionarySelector`
+  - **الوصف**: الإعدادات المحلية لتفسير المحتوى بها، أو كائن محدد لـ [القواميس الديناميكية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md).
+    - `'fr'` — إعدادات محلية
+    - `{ item: 2 }` — عنصر [مجموعة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/collections.md) (تجاهل `item` للحصول على كل عنصر كمصفوفة)
+    - `{ variant: 'black-friday' }` — [متغير](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/variants.md) مسمى (تجاهل للحصول على الإعدادات `default`)
+    - `{ variant: { id: 'prod_abc', userId: '123' } }` — متغير منظم
+    - أي محدد يمكن أن يحمل إعدادات محلية: `{ item: 2, locale: 'fr' }`
+  - **النوع**: `LocalesValues | DictionarySelector`
+  - **مطلوب**: لا (اختياري) — الافتراضي هو `defaultLocale` المُكوّن.
+
+- `plugins: Plugins[]`
+  - **الوصف**: محولات عقدة مخصصة تحل محل مكونات المُفسّر الأساسية. للاستخدام المتقدم فقط.
+  - **النوع**: `Plugins[]`
+  - **مطلوب**: لا (اختياري)
+
+### المخرجات
+
+- **Type**: `Promise<Content>` — وعد يتم حله إلى المحتوى المفسر للقاموس، مكتوب من إعلانك.
+
+---
+
+## مثال الاستخدام
+
+### الاستخدام الأساسي
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getIntlayerAsync } from "intlayer";
+
+const { title } = await getIntlayerAsync("app", "fr"); // "Bonjour"
+```
+
+---
+
+## `getIntlayer` مقابل `getIntlayerAsync`
+
+|                  | [`getIntlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getIntlayer.md) | `getIntlayerAsync`                      |
+| ---------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
+| الإرجاع          | المحتوى                                                                                                         | وعد بالمحتوى                            |
+| القاموس المحمّل  | القاموس المدمج (جميع اللغات)                                                                                    | جزء اللغة المطلوبة فقط                  |
+| الأنسب للـ       | العرض، مسارات الكود المتزامنة                                                                                   | البيانات الوصفية، المحملات، دوال الخادم |
+| هل يتطلب plugin؟ | لا                                                                                                              | لا — تقسيم كل لغة يتطلب build plugins   |
+
+كلاهما يقبل نفس المعاملات ويعيد نفس المحتوى: التبديل من أحدهما إلى الآخر يغير فقط **متى** و**كم** يتم تحميله.
+
+---
+
+## الوظائف ذات الصلة
+
+- [`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): الدالة منخفضة المستوى التي تعيد كتابتها إضافات البناء إلى هذا الاستدعاء.
+- [`getLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocale.md): يكتشف لغة الطلب الوارد.
+
+---
+
+## TypeScript
+
+```typescript
+function getIntlayerAsync<
+  const T extends DictionaryKeys,
+  const A extends LocalesValues | DictionarySelector = DeclaredLocales,
+>(
+  key: T,
+  localeOrSelector?: A,
+  plugins?: Plugins[]
+): Promise<
+  DeepTransformContent<
+    DictionaryRegistryResult<T, A>,
+    IInterpreterPluginState,
+    ExtractSelectorLocale<A>
+  >
+>;
+```

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

@@ -59,7 +59,5 @@ getLocaleLang(Locales.FRENCH); // الناتج: "fr"
 
 - **عدم توفير الموقع:**
 
-- تُعيد الدالة سلسلة فارغة عندما يكون `locale` غير معرف (`undefined`).
-
 - **سلاسل الموقع المشوهة:**
   - إذا لم يتبع `locale` تنسيق `language-country` (مثلًا، `Locales.ENGLISH-US`)، فإن الدالة تُعيد بأمان الجزء الذي يسبق `'-'` أو السلسلة كاملة إذا لم يكن هناك `'-'`.

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 تقوم دالة `getLocalizedPath` بتحويل المسار القانوني (المسار الداخلي للتطبيق) إلى نظيره المحلي بناءً على الـ locale وقواعد إعادة الكتابة (rewrite rules) المقدمة. تكون هذه الدالة مفيدة بشكل خاص عند إنشاء عناوين URL صديقة لمحركات البحث تختلف بحسب اللغة.
 
+إنه نظير نسبي لـ [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedUrl.md) — بالنسبة للمدخل النسبي يعيد كلاهما نفس القيمة. على عكس `getLocalizedUrl`، لا يعيد أبداً عنوان URL مطلق: يتم تجاهل إعداد `domains`، لذا فإن اللغة المقدمة من نطاقها الخاص لا تزال تسفر عن مسار. يتم قبول المدخل المطلق، لكن يتم حذف أصله — يتم الاحتفاظ فقط بمساره وسلسلة الاستعلام والـ hash.
+
 **الميزات الرئيسية:**
 
 - يدعم معلمات المسارات الديناميكية باستخدام صيغة `[param]`.
@@ -60,13 +62,17 @@ getLocalizedPath(
   - **النوع**: `string`
   - **مطلوب**: نعم
 
-- `locale: Locales`
-  - **الوصف**: المحلي/اللغة المستهدفة التي يجب أن يتم تعريب المسار بناءً عليها.
-  - **النوع**: `Locales`
-  - **مطلوب**: نعم
-
 ### المعلمات الاختيارية
 
+- `locale?: Locales`
+  - **Description**: اللغة المستهدفة التي يجب تحويل المسار إليها.
+  - **Type**: `Locales`
+  - **Default**: اللغة الافتراضية لإعدادات مشروعك.
+
+- `options?: object`
+  - **Description**: تجاوزات التوجيه. كل إدخال يستخدم افتراضيات من إعدادات مشروعك.
+  - **Type**: `object`
+
 - `rewriteRules?: RoutingConfig['rewrite']`
   - **الوصف**: كائن يعرّف قواعد إعادة الكتابة المخصصة. إذا لم يتم توفيره، فسيكون الافتراضي هو الخاصية `routing.rewrite` من تكوين مشروعك.
   - **النوع**: `RoutingConfig['rewrite']`
@@ -79,6 +85,28 @@ getLocalizedPath(
 - **النوع**: `string`
 - **الوصف**: المسار المعرب للمحلي المحدد.
 
+النوع مضيق من قواعد إعادة الكتابة المعلنة في التكوين الخاص بك، لذلك يعرض المحرر المسار المحلول بدلاً من `string` مجرد:
+
+```typescript codeFormat="typescript"
+// التكوين: الوضع 'prefix-no-default'، defaultLocale 'en'،
+//                { '/about': { fr: '/a-propos' }, '/product/[id]': { fr: '/produit/[id]' } }
+const about = getLocalizedPath("/about", Locales.FRENCH);
+//    ^? '/fr/a-propos'
+const product = getLocalizedPath("/product/123", Locales.FRENCH);
+//    ^? '/fr/produit/123'
+const contact = getLocalizedPath("/contact", Locales.FRENCH);
+//    ^? '/fr/contact'  (لا توجد قاعدة إعادة كتابة مطابقة، يتم تطبيق البادئة فقط)
+const home = getLocalizedPath("/", Locales.FRENCH);
+//    ^? '/fr'
+```
+
+يتدفق التضييق نفسه إلى [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/intlayer/getLocalizedUrl.md)، الذي يطبق قواعد إعادة الكتابة قبل إضافة بادئة اللغة.
+
+حالتان تبقى موسعة إلى `string`، لأنه لا يمكن حلهما في وقت الترجمة:
+
+- مسار ليس حرفيًا (مثلاً، مسار تم إنشاؤه من متغير);
+- مسار يطابق قاعدة تستخدم معامل متعدد القطاعات أو اختياري (`[...slug]`, `[[...slug]]`, `:param?`).
+
 ---
 
 ## مثال على الاستخدام
@@ -126,6 +154,18 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 // Output: "/contactez-nous"
 ```
 
+### حذف الإعدادات الإقليمية
+
+عندما لا يتم تحديد أي إعدادات إقليمية، يتم تحديد المسار للإعدادات الإقليمية الافتراضية المكونة:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// التكوين: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// النتيجة: "/about"
+```
+
 ---
 
 ## الدوال ذات الصلة

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

@@ -31,6 +31,14 @@ author: aymericzip
 
 تقوم دالة `getLocalizedUrl` بإنشاء عنوان URL محلي عن طريق إضافة بادئة اللغة المحددة إلى عنوان URL المعطى. تتعامل مع عناوين URL المطلقة والنسبية على حد سواء، مما يضمن تطبيق بادئة اللغة الصحيحة بناءً على التكوين.
 
+**المميزات الرئيسية:**
+
+- معاملان فقط مطلوبان: `url` و `currentLocale`
+- كائن `options` اختياري يحتوي على `locales` و `defaultLocale` و `mode`
+- يستخدم تكوين التدويل في مشروعك كقيم افتراضية
+- يمكن استخدامه بمعاملات بسيطة للحالات البسيطة أو تخصيصه بالكامل للسيناريوهات المعقدة
+- يدعم أوضاع توجيه متعددة: `prefix-no-default` و `prefix-all` و `no-prefix` و `search-params`
+
 ---
 
 ## توقيع الدالة
@@ -135,36 +143,6 @@ getLocalizedUrl(
 // الناتج: "/about" للغة الافتراضية (الإنجليزية)
 ```
 
-```javascript codeFormat="esm"
-import { getLocalizedUrl, Locales } from "intlayer";
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// الناتج: "/fr/about" للغة الفرنسية
-// الناتج: "/about" للغة الافتراضية (الإنجليزية)
-```
-
-```javascript codeFormat="commonjs"
-const { getLocalizedUrl, Locales } = require("intlayer");
-
-getLocalizedUrl(
-  "/about",
-  Locales.FRENCH,
-  [Locales.ENGLISH, Locales.FRENCH],
-  Locales.ENGLISH,
-  false
-);
-
-// الناتج: "/fr/about" للغة الفرنسية
-// الناتج: "/about" للغة الافتراضية (الإنجليزية)
-```
-
 ### تجاوز الإعدادات الجزئية
 
 يمكنك أيضًا توفير بعض المعاملات الاختيارية فقط. ستستخدم الدالة إعدادات مشروعك لأي معاملات لم تحددها:
@@ -241,6 +219,12 @@ getLocalizedUrl(
 - **اللغات غير المدعومة:**
   - بالنسبة للغات غير المدرجة في `locales`، لا تطبق الدالة أي بادئة.
 
+- **أنماط التوجيه:**
+  - `'prefix-no-default'`: اللغة الافتراضية بدون بادئة، والبقية لها بادئات (على سبيل المثال، `/about`, `/fr/about`)
+  - `'prefix-all'`: جميع اللغات لها بادئات (على سبيل المثال، `/en/about`, `/fr/about`)
+  - `'no-prefix'`: لا توجد بادئات لغة في عناوين URL (يتم التعامل مع اللغة في مكان آخر)
+  - `'search-params'`: يتم تحديد اللغة عبر معامل الاستعلام (على سبيل المثال، `/about?locale=fr`)
+
 ---
 
 ## الاستخدام في التطبيقات

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

@@ -138,8 +138,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### أنماط التوجيه المختلفة
 
 ```typescript
@@ -205,6 +203,12 @@ getMultilingualUrls("/dashboard", {
 - **اللغات غير المدعومة:**
   - يتم اعتبار اللغات الموجودة فقط في مصفوفة `locales` عند إنشاء عناوين URL.
 
+- **أنماط التوجيه:**
+  - `'prefix-no-default'`: اللغة الافتراضية بدون بادئة، والبقية لها بادئات (مثال: `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: جميع اللغات لها بادئات (مثال: `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: بدون بادئات لغة في عناوين URL (جميع اللغات تُرجع نفس عنوان URL)
+  - `'search-params'`: تحديد اللغة عبر معامل الاستعلام (مثال: `/dashboard?locale=fr`)
+
 ---
 
 ## الاستخدام في التطبيقات

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

@@ -31,6 +31,8 @@ author: aymericzip
 
 تقوم دالة `getTranslationContent` باسترجاع المحتوى المقابل للغة معينة من مجموعة محتويات لغوية قابلة للتخصيص. إذا لم يتم العثور على اللغة المحددة، فإنها تعيد بشكل افتراضي المحتوى الخاص باللغة الافتراضية المكونة في المشروع.
 
+للمزيد من التفاصيل حول كيفية إعلان الترجمات، راجع [وثائق الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md).
+
 ## المعاملات
 
 - `languageContent: CustomizableLanguageContent<Content>`

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

@@ -158,6 +158,23 @@ const greeting = t(translations);
 
 #### مثال:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## الأخطاء الشائعة واستكشاف المشكلات

package/docs/ar/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ author: aymericzip
 
 إليك كيفية تنفيذ هوك `useIntlayer` داخل صفحة Next.js لتحميل المحتوى المحلي ديناميكيًا بناءً على اللغة الحالية للتطبيق:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/ar/packages/next-intlayer/useLocale.md

@@ -104,6 +104,8 @@ const LocaleSwitcher: FC = () => {
 
 ## قيم الإرجاع
 
+عند استدعاء hook `useLocale`، فإنه يُرجع كائنًا يحتوي على الخصائص التالية:
+
 - **`locale`**: اللغة الحالية كما تم تعيينها في سياق React.
 - **`defaultLocale`**: اللغة الأساسية المعرفة في الإعدادات.
 - **`availableLocales`**: قائمة بجميع اللغات المتاحة كما هو معرف في الإعدادات.

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

@@ -30,8 +30,6 @@ author: aymericzip
 
 ## مثال على الاستخدام في React
 
-فيما يلي مثال على كيفية استخدام الخطاف `useDictionary` في مكون React:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

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

@@ -73,6 +73,34 @@ author: aymericzip
 
 أمثلة على استخدام الخطاف `useI18n` داخل مكونات React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -97,6 +125,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

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

@@ -27,48 +27,6 @@ author: aymericzip
 
 ## مثال على الاستخدام في React
 
-عرض استخدام الـ `useIntlayer` hook داخل مكون React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/ar/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ export default defineConfig({
 2. إعداد `build.optimize` هو `true` (أو `undefined` ، والذي يتم تعيينه افتراضيًا إلى `true` لعمليات البناء).
 3. إعداد `build.minify` هو `true` في إعدادات Intlayer الخاصة بك.
 
-يتم **إيقاف تفعيله** تلقائيًا عندما يكون `editor.enabled` هو `true` لأن المحرر يحتاج إلى محتوى القاموس الكامل والمقروء بشريًا.
+عندما يكون `editor.enabled` في وضع `true`، يستمر المكوّن الإضافي في العمل لكنه **يتخطى إعادة تسمية الحقول**: إذ تعيد إعادة التسمية كتابة مفاتيح المحتوى التي يتنقل بينها المفسِّر، مما يجعل `keyPath` الذي يتلقاه المحرر المرئي غير مطابق بعد الآن للقواميس غير المدمجة التي يعدّلها. يبقى ضغط المسافات البيضاء وإزالة البيانات الوصفية من المستوى الأعلى نشطين.
 
 ## ما الذي يتم تصغيره
 

package/docs/ar/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 يُستخدم المكوّن الإضافي `intlayerPrune` الخاص بـ Vite لإجراء tree-shaking وإزالة (prune) القواميس غير المستخدمة من حزمة التطبيق الخاصة بك. يساعد ذلك في تقليل حجم الحزمة النهائي باشتراط تضمين المحتوى متعدد اللغات الضروري فقط.
 
+> البرنامج المساعد مضمن بالفعل ومكوّن تلقائياً عند استخدام [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/vite-intlayer/intlayer.md). تحتاج فقط إلى تسجيله يدوياً إذا كنت تقوم بتكوين مكدس المكونات الإضافية بنفسك.
+
 ## الاستخدام
 
 ### كجزء من `intlayer()` (موصى به)
@@ -107,6 +109,12 @@ const { title, description } = useIntlayer("myDict");
 
 عند نجاح التقليص، يكتب `intlayerPrune` أيضًا `pruneContext.dictionaryKeyToFieldRenameMap` — وهي خريطة من أسماء الحقول الأصلية إلى اسم مستعار قصير. يقرأ `intlayerMinify` هذه الخريطة لإعادة تسمية الحقول في JSON الناتج، وتحديث Babel الخاص بـ `intlayerOptimize` يحدّث عمليات الوصول إلى الخصائص في ملفات المصدر وفقًا لذلك.
 
-## الوصف
+## شروط التفعيل
+
+يكون `intlayerPrune` نشطًا **فقط** عندما تكون جميع الشروط التالية محققة:
+
+1. أمر Vite هو `build`.
+2. تكون `build.optimize` بقيمة `true` (أو `undefined`، والتي تُستخدم افتراضيًا كـ `true` لعمليات البناء).
+3. تكون `build.purge` بقيمة `true` في إعدادات Intlayer الخاصة بك.
 
-يقوم المكوّن الإضافي بتحليل شفرة المصدر الخاصة بك لتحديد مفاتيح القواميس المستخدمة فعليًا. ثم يزيل أي محتوى غير مستخدم من ملفات القواميس المدرجة في الحزمة (bundle). يكون هذا مفيدًا بشكل خاص للمشاريع الكبيرة التي تحتوي على العديد من القواميس حيث يُستخدم جزء فقط منها في صفحات أو مكونات محددة.
+يظل نشطًا عندما يكون `editor.enabled` في وضع `true`: يقوم المحرر المرئي بحل كل تعديل عبر `dictionaryKey` و`keyPath` مقابل القواميس غير المدمجة، التي لا يلمسها هذا المكوّن الإضافي مطلقًا، والحقل الذي تمت إزالته هو حقل لا يقرأه أي مكوّن — لذا لا يُعرض أبدًا ولا يمكن اختياره في الصفحة.

package/docs/ar/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.ar.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "ar", // مهم
+  "content": {
+    "multilingualContent": "عنوان مكونتي",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > موصى به: هذا التنسيق هو الأفضل عند استخدام محرر Intlayer المرئي أو إدارة الترجمات مباشرة في الكود.
 
+> ملاحظة: في كلا الحالتين، يجب أن يتبع ملف إعلان المحتوى نمط التسمية `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` ليتم التعرف عليه بواسطة Intlayer. اللاحقة `.[locale]` اختيارية وتُستخدم فقط كاتفاقية تسمية.
+
 ### التكوين العام لملفات كل لغة
 
 يمكنك ضبط التكوين العام لملفات كل لغة عن طريق إضافة ما يلي إلى ملف `intlayer.config.ts` الخاص بك:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // مهم
-  "content": {
-    "multilingualContent": "عنوان المكون الخاص بي",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > مهم: تأكد من تعريف حقل locale. فهو يخبر Intlayer باللغة التي يمثلها الملف.
 
-> ملاحظة: في كلتا الحالتين، يجب أن يتبع ملف إعلان المحتوى نمط التسمية `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` ليتم التعرف عليه من قبل Intlayer. اللاحقة `.[locale]` اختيارية وتستخدم فقط كاتفاقية تسمية.
-
 ## مزج الصيغ
 
 يمكنك دمج كلا النهجين للإعلان عن نفس مفتاح المحتوى. على سبيل المثال:

package/docs/ar/readme.md

@@ -234,6 +234,7 @@ const HomePage = () => {
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>