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

package/docs/ar/intlayer_with_react_native+expo.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-18
-updatedAt: 2026-05-31
+updatedAt: 2026-06-25
 title: "تدويل Expo + React Native - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Expo + React Native متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:
@@ -17,6 +17,9 @@ slugs:
 applicationTemplate: https://github.com/aymericzip/intlayer-react-native-template
 applicationShowcase: https://intlayer-react-native.vercel.app
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "استيراد موفّري السياق والخطافات مباشرةً من react-native-intlayer؛ لم يعد react-intlayer ضروريًا كاعتمادية مباشرة"
   - version: 8.9.0
     date: 2026-05-04
     changes: "تحديث استخدام واجهة برمجة تطبيقات useIntlayer في Solid للوصول المباشر إلى الخصائص"
@@ -37,7 +40,7 @@ author: aymericzip
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-react-native-template?file=intlayer.config.ts"
   className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
-  title="Demo CodeSandbox - Intlayer"
+  title="Demo CodeSandbox - How to Internationalize your application using Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -56,88 +59,64 @@ author: aymericzip
   </Tab>
 </Tabs>
 
-راجع [قالب التطبيق](https://github.com/aymericzip/intlayer-react-native-template) على GitHub.
+## جدول المحتويات
+
+<TOC/>
 
 ## لماذا Intlayer على البدائل؟
 
 بالمقارنة مع الحلول الرئيسية مثل `react-native-localize` أو `i18next`، يعد Intlayer حلاً يأتي مزودًا بتحسينات متكاملة مثل:
 
-** تغطية رد الفعل الأصلية الكاملة **
-
-تم تحسين Intlayer للعمل بشكل مثالي مع React Native وExpo من خلال تقديم **نطاق المحتوى على مستوى المكونات**، و**دعم TypeScript**، وجميع الميزات اللازمة لتوسيع نطاق التدويل (i18n) في تطبيقات الأجهزة المحمولة.
-
-** الصيانة **
+<AccordionGroup>
 
-يؤدي تحديد نطاق محتوى تطبيقك ** إلى تسهيل الصيانة ** للتطبيقات واسعة النطاق. يمكنك تكرار أو حذف مجلد ميزات واحد دون العبء العقلي لمراجعة قاعدة بيانات المحتوى بالكامل. بالإضافة إلى ذلك، تتم كتابة Intlayer **بالكامل** لضمان دقة المحتوى الخاص بك.
+<Accordion header="تغطية React Native الكاملة">
 
-** وكيل الذكاء الاصطناعي **
+تم تحسين Intlayer للعمل بشكل مثالي مع React Native وExpo من خلال تقديم **نطاق المحتوى على مستوى المكونات**، و**دعم TypeScript**، وجميع الميزات اللازمة لتوسيع نطاق التدويل (i18n) في تطبيقات الأجهزة المحمولة.
 
-يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (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)** و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
+</Accordion>
 
-**الأتمتة**
+<Accordion header="الصيانة">
 
-استخدم الأتمتة للترجمة في مسار CI/CD الخاص بك باستخدام LLM من اختيارك على حساب مزود الذكاء الاصطناعي الخاص بك. يقدم Intlayer أيضًا **مترجمًا** لأتمتة استخراج المحتوى، بالإضافة إلى [منصة ويب](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) للمساعدة في **الترجمة في الخلفية**.
+يؤدي تحديد نطاق محتوى تطبيقك إلى **تسهيل الصيانة** للتطبيقات واسعة النطاق. يمكنك تكرار أو حذف مجلد ميزات واحد دون العبء العقلي لمراجعة قاعدة بيانات المحتوى بالكامل. بالإضافة إلى ذلك، تتم كتابة Intlayer **بالكامل** لضمان دقة المحتوى الخاص بك.
 
-**أداء**
+</Accordion>
 
-يمكن أن يؤدي ربط ملفات JSON الضخمة بالمكونات إلى حدوث مشكلات في الأداء والتفاعل. يعمل Intlayer على تحسين تحميل المحتوى الخاص بك في وقت الإنشاء.
+<Accordion header="وكيل الذكاء الاصطناعي">
 
-**التحجيم مع عدم وجود مطور**
+يؤدي تحديد موقع المحتوى المشترك إلى **تقليل السياق المطلوب** بواسطة نماذج اللغات الكبيرة (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)** و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
-أكثر من مجرد حل 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>
 
-**حجم البندل**
+<Accordion header="الأتمتة">
 
-بدلاً من تحميل ملفات JSON ضخمة إلى صفحاتك، قم بتحميل المحتوى الضروري فقط. يساعد Intlayer **في تقليل حجم البندل وعرض الأحجام بنسبة تصل إلى 50%**.
-
-<Steps>
-
-<Step number={1} title="تثبيت التبعيات">
+استخدم الأتمتة للترجمة في مسار CI/CD الخاص بك باستخدام LLM من اختيارك على حساب مزود الذكاء الاصطناعي الخاص بك. يقدم Intlayer أيضًا **مترجمًا** لأتمتة استخراج المحتوى، بالإضافة إلى [منصة ويب](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) للمساعدة في **الترجمة في الخلفية**.
 
-راجع [قالب التطبيق](https://github.com/aymericzip/intlayer-react-native-template) على GitHub.
+</Accordion>
 
-من مشروع React Native الخاص بك، قم بتثبيت الحزم التالية:
+<Accordion header="الأداء">
 
-```bash packageManager='npm'
-npm تثبيت طبقة رد فعل طبقة داخلية
-تثبيت npm --save-dev رد الفعل الأصلي-inlayer
-npx الطبقة البينية init
-```
+يمكن أن يؤدي ربط ملفات JSON الضخمة بالمكونات إلى حدوث مشكلات في الأداء والتفاعل. يعمل Intlayer على تحسين تحميل المحتوى الخاص بك في وقت الإنشاء.
 
-```bash packageManager="pnpm"
-أضف pnpm طبقة تفاعلية داخلية
-إضافة pnpm --save-dev رد الفعل الأصلي-inlayer
-pnpm intlayer init
-```
+</Accordion>
 
-```bash packageManager = "غزل"
-الغزل إضافة طبقة داخلية رد فعل طبقة داخلية
-إضافة الغزل --save-dev رد الفعل الأصلي-inlayer
-الغزل الضمني الحرف الأول
-```
+<Accordion header="التحجيم مع غير المطورين">
 
-```باش باكدج ماناجر = "كعكة""
-كعكة إضافة طبقة داخلية رد فعل طبقة داخلية
-إضافة كعكة --dev رد الفعل الأصلي-inlayer
-كعكة x الطبقة البينية init
-```
+أكثر من مجرد حل i18n، يوفر Intlayer **[محررًا مرئيًا مستضافًا ذاتيًا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md)** و**[نظام إدارة محتوى كامل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md)** لمساعدتك في إدارة المحتوى متعدد اللغات في **الوقت الفعلي**، مما يجعل التعاون مع المترجمين ومؤلفي النصوص وأعضاء الفريق الآخرين سلسًا. يمكن تخزين المحتوى محليًا و/أو عن بعد.
 
-### الحزم
+</Accordion>
 
-- **الطبقة الداخلية**  
-  مجموعة أدوات i18n الأساسية للتكوين ومحتوى القاموس وإنشاء الأنواع وأوامر CLI.
+<Accordion header="حجم الحزمة">
 
-- **رد الفعل الضمني**  
-  تكامل React الذي يوفر موفري السياق وخطافات React التي ستستخدمها في React Native للحصول على اللغات وتبديلها.
+بدلاً من تحميل ملفات JSON ضخمة إلى صفحاتك، قم بتحميل المحتوى الضروري فقط. يساعد Intlayer **في تقليل حجم الحزمة وأحجام العرض بنسبة تصل إلى 50%**.
 
-- **رد الفعل الأصلي-الطبقة الداخلية**  
-  تكامل React Native الذي يوفر البرنامج الإضافي Metro لدمج Intlayer مع مجمّع React Native.
+</Accordion>
+</AccordionGroup>
 
----
+<Steps>
 
-</Step>
+<Step number={1} title="تثبيت التبعيات">
 
-<Step number={2} title="تثبيت التبعيات">
+راجع [قالب التطبيق](https://github.com/aymericzip/intlayer-react-native-template) على GitHub.
 
 من مشروع React Native الخاص بك، قم بتثبيت الحزم التالية:
 
@@ -162,23 +141,19 @@ bunx intlayer-cli init --interactive
 > سيقوم هذا الأمر باكتشاف بيئتك وتثبيت الحزم المطلوبة. على سبيل المثال:
 
 ```bash packageManager="npm"
-npm install intlayer react-intlayer
-npm install --save-dev react-native-intlayer
+npm install intlayer react-native-intlayer
 ```
 
 ```bash packageManager="pnpm"
-pnpm add intlayer react-intlayer
-pnpm add --save-dev react-native-intlayer
+pnpm add intlayer react-native-intlayer
 ```
 
 ```bash packageManager="yarn"
-yarn add intlayer react-intlayer
-yarn add --save-dev react-native-intlayer
+yarn add intlayer react-native-intlayer
 ```
 
 ```bash packageManager="bun"
-bun add intlayer react-intlayer
-bun add --dev react-native-intlayer
+bun add intlayer react-native-intlayer
 ```
 
 ### الحزم
@@ -186,17 +161,14 @@ bun add --dev react-native-intlayer
 - **intlayer**  
   مجموعة أدوات i18n الأساسية للتكوين، محتوى القاموس، توليد الأنواع، وأوامر CLI.
 
-- **react-intlayer**  
-  تكامل React الذي يوفر موفري السياق وReact hooks التي ستستخدمها في React Native للحصول على اللغات وتبديلها.
-
 - **react-native-intlayer**  
-  تكامل React Native الذي يوفر إضافة Metro لدمج Intlayer مع مجمع React Native.
+  تكامل React Native الذي يوفر موفّري السياق وReact hooks التي ستستخدمها للحصول على اللغات وتبديلها، وpolyfills لـ React Native، وإضافة Metro لدمج Intlayer مع مجمع React Native. يُعيد تصدير كل شيء من `react-intlayer`، لذلك تحتاج فقط إلى هذه الحزمة الواحدة في تطبيق React Native.
 
 ---
 
 </Step>
 
-<Step number={3} title="إنشاء تكوين Intlayer">
+<Step number={2} title="إنشاء تكوين Intlayer">
 
 في جذر مشروعك (أو في أي مكان مناسب)، أنشئ ملف **تكوين Intlayer**. قد يبدو كالتالي:
 
@@ -230,7 +202,7 @@ export default config;
 
 </Step>
 
-<Step number={4} title="إضافة ملحق Metro">
+<Step number={3} title="إضافة ملحق Metro">
 
 Metro هو أداة تجميع (bundler) لـ React Native. وهو أداة التجميع الافتراضية لمشاريع React Native التي تم إنشاؤها باستخدام الأمر `react-native init`. لاستخدام Intlayer مع Metro، تحتاج إلى إضافة الملحق إلى ملف `metro.config.js` الخاص بك:
 
@@ -245,13 +217,18 @@ module.exports = (async () => {
 })();
 ```
 
+> ملاحظة: `configMetroIntlayer` هي دالة غير متزامنة (promise). استخدم `configMetroIntlayerSync` بدلاً من ذلك إذا كنت تريد استخدامها بشكل متزامن، أو تجنب IFFE (التعبير الدالي المستدعى فورًا).
+> ملاحظة: `configMetroIntlayerSync` لا تسمح ببناء قواميس Intlayer عند بدء تشغيل الخادم
+
 </Step>
 
-<Step number={5} title="إضافة موفر Intlayer">
+<Step number={4} title="إضافة موفّر Intlayer">
+
+للحفاظ على مزامنة لغة المستخدم في جميع أنحاء تطبيقك، تحتاج إلى تغليف المكون الجذر الخاص بك بمكون `IntlayerProvider` من `react-native-intlayer`.
 
-للحفاظ على مزامنة لغة المستخدم في جميع أنحاء تطبيقك، تحتاج إلى تغليف المكون الجذر الخاص بك بمكون `IntlayerProvider` من `react-intlayer-native`.
+> قم دائمًا بالاستيراد من `react-native-intlayer`. يتضمن `IntlayerProvider` الخاص به polyfills لواجهة برمجة تطبيقات الويب المستخدمة بواسطة Intlayer، والحزمة تُعيد تصدير جميع الخطافات والأدوات من `react-intlayer`.
 
-> تأكد من استخدام الموفر من `react-native-intlayer` بدلاً من `react-intlayer`. يتضمن التصدير من `react-native-intlayer` بدائل (polyfills) لواجهة برمجة التطبيقات للويب.
+بالإضافة إلى ذلك، تحتاج إلى إضافة دالة `intlayerPolyfill` إلى ملف `index.js` الخاص بك لضمان عمل Intlayer بشكل صحيح.
 
 ```tsx fileName="app/_layout.tsx" codeFormat={["typescript", "esm"]}
 import { Stack } from "expo-router";
@@ -276,7 +253,7 @@ export default RootLayout;
 
 </Step>
 
-<Step number={6} title="إعلان المحتوى الخاص بك">
+<Step number={5} title="إعلان المحتوى الخاص بك">
 
 قم بإنشاء ملفات **إعلان المحتوى** في أي مكان داخل مشروعك (عادةً داخل مجلد `src/`)، باستخدام أي من صيغ الامتداد التي يدعمها Intlayer:
 
@@ -347,7 +324,7 @@ export default homeScreenContent;
 
 </Step>
 
-<Step number={7} title="استخدام Intlayer في مكوناتك">
+<Step number={6} title="استخدام Intlayer في مكوناتك">
 
 استخدم الخطاف `useIntlayer` في المكونات الفرعية للحصول على المحتوى المحلي.
 
@@ -355,7 +332,7 @@ export default homeScreenContent;
 
 ```tsx fileName="app/(tabs)/index.tsx" codeFormat={["typescript", "esm"]}
 import { Image, StyleSheet, Platform } from "react-native";
-import { useIntlayer } from "react-intlayer";
+import { useIntlayer } from "react-native-intlayer";
 import { HelloWave } from "@/components/HelloWave";
 import ParallaxScrollView from "@/components/ParallaxScrollView";
 import { ThemedText } from "@/components/ThemedText";
@@ -402,7 +379,7 @@ export default HomeScreen;
 
 </Step>
 
-<Step number={8} title="تغيير لغة التطبيق">
+<Step number={7} title="تغيير لغة التطبيق" isOptional={true}>
 
 لتغيير اللغة من داخل مكوناتك، يمكنك استخدام دالة `setLocale` من الخطاف `useLocale`:
 
@@ -410,7 +387,7 @@ export default HomeScreen;
 import { type FC } from "react";
 import { View, Text, TouchableOpacity, StyleSheet } from "react-native";
 import { getLocaleName } from "intlayer";
-import { useLocale } from "react-intlayer";
+import { useLocale } from "react-native-intlayer";
 
 export const LocaleSwitcher: FC = () => {
   const { setLocale, availableLocales } = useLocale();
@@ -487,7 +464,7 @@ const styles = StyleSheet.create({
 لتجنب الالتزام بالملفات التي تم إنشاؤها تلقائيًا بواسطة Intlayer، أضف ما يلي إلى ملف `.gitignore` الخاص بك:
 
 ```bash
-#  تجاهل الملفات التي تم إنشاؤها بواسطة Intlayer
+# تجاهل الملفات التي تم إنشاؤها بواسطة Intlayer
 .intlayer
 ```
 
@@ -528,7 +505,7 @@ React Native قد يكون أقل استقراراً من React Web، لذلك
 
 قائمة التحقق:
 
-- استخدم أحدث إصدارات `intlayer` و `react-intlayer` و `react-native-intlayer`.
+- استخدم أحدث إصدارات `intlayer` و `react-native-intlayer`.
 - قم بتفعيل polyfill الخاص بـ Intlayer.
 - إذا كنت تستخدم `getLocaleName` أو أدوات أخرى قائمة على Intl-API، قم باستيراد هذه polyfills مبكراً (على سبيل المثال في `index.js` أو `App.tsx`):
 

package/docs/ar/packages/react-native-intlayer/exports.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-01-21
-updatedAt: 2026-01-21
+updatedAt: 2026-06-25
 title: وثائق حزمة react-native-intlayer
-description: دعم React Native لـ Intlayer، يوفر موفّرين وpolyfills.
+description: دعم React Native لـ Intlayer، يوفر موفّرين وخطافات وpolyfills وتكوين Metro.
 keywords:
   - react-native-intlayer
   - react-native
@@ -14,6 +14,9 @@ slugs:
   - react-native-intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "إعادة تصدير واجهة برمجة تطبيقات react-intlayer الكاملة (الخطافات والأدوات ومسارات format/html/markdown الفرعية) حتى يعتمد تطبيق React Native على react-native-intlayer فقط"
   - version: 8.0.0
     date: 2026-01-21
     changes: "توثيق موحد لجميع الصادرات"
@@ -22,7 +25,9 @@ author: aymericzip
 
 # حزمة react-native-intlayer
 
-توفر حزمة `react-native-intlayer` الأدوات اللازمة لدمج Intlayer في تطبيقات React Native. تتضمن موفّرًا وpolyfills لدعم locales.
+توفر حزمة `react-native-intlayer` الأدوات اللازمة لدمج Intlayer في تطبيقات React Native. تُعيد تصدير واجهة برمجة تطبيقات `react-intlayer` الكاملة (الخطافات والأدوات) مع `IntlayerProvider` جاهز لـ React Native، بالإضافة إلى polyfills وتكوين Metro المطلوبين بواسطة React Native.
+
+> في تطبيق React Native، قم باستيراد **كل شيء** من `react-native-intlayer`. لا تحتاج إلى تثبيت `react-intlayer` أو استيراده مباشرة.
 
 ## التثبيت
 
@@ -32,16 +37,32 @@ npm install react-native-intlayer
 
 ## الصادرات
 
-### الموفر
+### الموفّر
+
+| المكوّن            | الوصف                                                                             |
+| ------------------ | --------------------------------------------------------------------------------- |
+| `IntlayerProvider` | مكوّن Provider يلف تطبيقك ويوفر سياق Intlayer. يطبّق تلقائيًا polyfills المطلوبة. |
+
+```tsx
+import { IntlayerProvider } from "react-native-intlayer";
+```
+
+### الخطافات والأدوات
 
-| المكوّن            | الوصف                                          |
-| ------------------ | ---------------------------------------------- |
-| `IntlayerProvider` | مكوّن Provider يلف تطبيقك ويوفر سياق Intlayer. |
+يتم إعادة تصدير هذه العناصر من `react-intlayer`، لذلك يمكنك استيرادها مباشرةً من `react-native-intlayer`:
 
-استيراد:
+| الصادر                                                                                                            | الوصف                                          |
+| ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
+| `useIntlayer`                                                                                                     | الوصول إلى المحتوى المحلّي لمفتاح قاموس معيّن. |
+| `useLocale`                                                                                                       | قراءة اللغة الحالية وتغييرها.                  |
+| `useDictionary`, `useDictionaryAsync`, `useDictionaryDynamic`, `useLoadDynamic`                                   | تحميل محتوى القاموس بطرق مختلفة.               |
+| `useI18n`                                                                                                         | خطاف متوافق مع i18next.                        |
+| `t`                                                                                                               | مساعد الترجمة المضمّن.                         |
+| `getIntlayer`, `getDictionary`                                                                                    | أدوات استرجاع المحتوى الأمرية.                 |
+| `localeCookie`, `localeInStorage`, `setLocaleCookie`, `setLocaleInStorage`, `useLocaleCookie`, `useLocaleStorage` | مساعدات استمرارية اللغة.                       |
 
 ```tsx
-import "react-native-intlayer";
+import { useIntlayer, useLocale, t } from "react-native-intlayer";
 ```
 
 ### ملحق التوافق (Polyfill)
@@ -50,10 +71,25 @@ import "react-native-intlayer";
 | ------------------ | ------------------------------------------------------------ |
 | `intlayerPolyfill` | دالة تطبّق polyfills الضرورية لـ React Native لدعم Intlayer. |
 
-استيراد:
+```tsx
+import { intlayerPolyfill } from "react-native-intlayer";
+```
+
+> يتم تطبيق polyfill تلقائيًا عند استيراد `IntlayerProvider`. استدعِ `intlayerPolyfill` يدويًا فقط إذا كنت بحاجة إلى polyfills قبل تحميل الموفّر.
+
+### المنسّقات
+
+خطافات التنسيق المعتمدة على Intl للأرقام والتواريخ وغيرها متاحة من المسار الفرعي `/format`:
+
+```tsx
+import { useNumber, useDate } from "react-native-intlayer/format";
+```
+
+### عرض Markdown و HTML
 
 ```tsx
-import "react-native-intlayer";
+import { MarkdownProvider } from "react-native-intlayer/markdown";
+import { HTMLProvider } from "react-native-intlayer/html";
 ```
 
 ### تكوين Metro
@@ -66,8 +102,6 @@ import "react-native-intlayer";
 | `configMetroIntlayerSync` | دالة متزامنة تدمج تكوين Metro دون تحضير موارد Intlayer.                             |
 | `exclusionList`           | تنشئ نمط RegExp لقائمة الحظر (blockList) في Metro لاستبعاد ملفات المحتوى من الحزمة. |
 
-الاستيراد:
-
 ```tsx
-import "react-native-intlayer/metro";
+import { configMetroIntlayer } from "react-native-intlayer/metro";
 ```