@intlayer/docs 9.4.3 → 9.5.0

package/docs/ar/releases/v7.md

@@ -45,8 +45,6 @@ author: aymericzip
 - المعالجة المتوازية لتسريع عملية الترجمة
 - تقسيم ذكي للتعامل مع الملفات الكبيرة ضمن حدود سياق الذكاء الاصطناعي
 
----
-
 ## الأداء: التخزين المؤقت لبناء أسرع
 
 بدلاً من إعادة بناء إعلانات المحتوى باستخدام esbuild في كل عملية بناء، تقوم النسخة 7 بتنفيذ استراتيجية تخزين مؤقت تُسرّع عملية البناء.
@@ -73,8 +71,6 @@ bun x intlayer build
 - يكتشف التغييرات ويعيد بناء الملفات المعدلة فقط
 - يقلل بشكل كبير من أوقات البناء للمشاريع الكبيرة
 
----
-
 ## تايب سكريبت: توليد أنواع مخصصة لكل لغة
 
 يتم الآن توليد أنواع TypeScript لكل لغة على حدة، مما يوفر كتابة أقوى ويقضي على أنواع الاتحاد عبر جميع اللغات.
@@ -99,8 +95,6 @@ const content = getIntlayer("my-title-content", "en");
 - أمان نوع أفضل بدون تلوث أنواع عبر اللغات المختلفة
 - أداء محسّن من خلال تقليل تعقيد الأنواع
 
----
-
 ## تحسين الحزمة: اللغات كسلاسل نصية
 
 لم يعد نوع `Locales` تعدادًا (enum)، مما يعني أنه أصبح قابلًا لإزالة الشجر بالكامل (tree-shakeable) ولن يثقل حزمة التطبيق الخاصة بك بآلاف سجلات اللغات غير المستخدمة.
@@ -127,8 +121,6 @@ const locale: Locale = Locales.ENGLISH;
 
 راجع [تفاصيل التنفيذ](https://github.com/aymericzip/intlayer/blob/main/packages/%40intlayer/types/src/index.ts) لمزيد من المعلومات.
 
----
-
 ## أوضاع التوجيه الجديدة لمزيد من المرونة
 
 تقدم النسخة 7 تكوينًا موحدًا `routing.mode` يحل محل الخيارات السابقة `prefixDefault` و `noPrefix`، مما يوفر تحكمًا أكثر دقة في هيكل عنوان URL.
@@ -159,8 +151,6 @@ export default {
 };
 ```
 
----
-
 ## الامتثال للائحة حماية البيانات العامة (GDPR): تخزين localStorage / الكوكيز
 
 تُعطي النسخة 7 أولوية لخصوصية المستخدم باستخدام `localStorage` كآلية التخزين الافتراضية بدلاً من الكوكيز. يساعد هذا التغيير في الامتثال للائحة GDPR من خلال تجنب متطلبات موافقة الكوكيز لتفضيلات اللغة.
@@ -250,8 +240,6 @@ setLocale("en");
 **ملاحظة:** الكوكيز مفعلة بشكل افتراضي.
 **ملاحظة:** تحقق من [متطلبات الكوكيز وفقًا للائحة GDPR](https://gdpr.eu/cookies/) لحالتك الخاصة.
 
----
-
 ## المحرر المرئي: حزمة أصغر بنسبة 30%
 
 تم تحسين حزمة المحرر المرئي لتكون أصغر بنسبة 30% مقارنة بالإصدار السابق، وذلك بفضل:
@@ -262,8 +250,6 @@ setLocale("en");
 
 ينتج عن ذلك أوقات تحميل أسرع وأداء أفضل أثناء تشغيل التطبيق الخاص بك.
 
----
-
 ## تنسيق الكود التلقائي: تكوين formatCommand
 
 يقدم الإصدار v7 خيار `formatCommand` في تكوين المحرر، مما يسمح لك بتنسيق ملفات المحتوى تلقائياً عند كتابتها بواسطة Intlayer. وهذا يضمن أسلوب كود متسق وتنسيق موحد عبر ملفات إعلان المحتوى الخاصة بك.
@@ -321,8 +307,6 @@ formatCommand: 'bun format "{{file}}"';
 
 عندما يكتب Intlayer أو يحدث ملف إعلان محتوى (`.content.ts`، `.content.js`، إلخ)، فإنه يقوم تلقائياً بتشغيل أمر التنسيق المحدد على الملف. يتم استبدال العنصر النائب `{{file}}` بمسار الملف الفعلي، ويتم تنفيذ الأمر في دليل قاعدة المشروع.
 
----
-
 ## تكوين القاموس: تنظيم وهيكلة أفضل
 
 يقدم الإصدار v7 قسم تكوين `dictionary` مخصصًا جديدًا يوفر تنظيمًا أفضل لإعدادات القاموس وإدارة محسنة للمحتوى.
@@ -382,8 +366,6 @@ export default {
 
 للمزید من المعلومات حول ملفات إعلان المحتوى وكيف يتم تطبيق قيم التكوين، راجع [توثيق ملف المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md).
 
----
-
 ## أمر fill: سلوك محدث لإدارة محتوى أفضل
 
 يقدم الإصدار 7 سلوكًا محسّنًا لأمر `fill`، مما يوفر إدارة محتوى أكثر توقعًا ومرونة:
@@ -469,8 +451,6 @@ const content = {
 };
 ```
 
----
-
 ## تحسين الاستقرار وإدارة الترجمة
 
 يقدم الإصدار 7 عدة تحسينات لجعل ترجمة المحتوى أكثر موثوقية وكفاءة:
@@ -520,8 +500,6 @@ const content = {
 4. التحقق من الصحة وإعادة المحاولة إذا لزم الأمر
 5. إعادة بناء الملف الكامل
 
----
-
 ## ملاحظات الترحيل من الإصدار v6
 
 ### الإعدادات التي تمت إزالتها
@@ -610,14 +588,10 @@ const content = {
 };
 ```
 
----
-
 ## ملاحظات الترحيل من الإصدار v5 إلى v6
 
 راجع [ملاحظات الترحيل من v5 إلى v6](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/releases/v6.md) لمزيد من المعلومات.
 
----
-
 ## روابط مفيدة
 
 - [مرجع التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)

package/docs/ar/releases/v8.md

@@ -36,8 +36,6 @@ author: aymericzip
 
 <TOC levels={[2]} maxDepth={1} />
 
----
-
 ## تطور المحتوى الغني: Markdown و HTML
 
 يجلب Intlayer v8 تحسينات كبيرة على كيفية التعامل مع المحتوى الغني، حيث يقدم **عقد HTML** (التي لم تكن موجودة في v7) ويوحد واجهة برمجة التطبيقات مع **عقد Markdown** (التي كانت موجودة في v7 ولكن تم تحسينها).
@@ -407,8 +405,6 @@ author: aymericzip
 
 لمزيد من التفاصيل، راجع [توثيق محتوى HTML](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/html.md) و [توثيق Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/markdown.md).
 
----
-
 ## ملفات محتوى YAML و Markdown (v8.10.0)
 
 يمكنك الآن تعريف المحتوى مباشرة باستخدام امتدادات الملفات `.content.md` و `.content.yaml`. هذا مثالي للمحتوى الطويل، المدونات، التوثيقات، وسياسات الخصوصية.
@@ -417,8 +413,6 @@ author: aymericzip
 
 لمزيد من التفاصيل، راجع [توثيق ملفات محتوى YAML](https://intlayer.org/doc/concept/content#yaml-content-file) و [توثيق ملفات محتوى Markdown](https://intlayer.org/doc/concept/content/markdown).
 
----
-
 ## إعادة كتابة عناوين URL المخصصة
 
 تقدّم Intlayer v8 دعمًا لـ **إعادة كتابة عناوين URL المخصصة**، مما يتيح لك تعريف مسارات خاصة بكل لغة تختلف عن البنية القياسية `/locale/path`. هذه ميزة قوية لتحسين الـ SEO المحلي وتوفير تجربة مستخدم أكثر طبيعية للمتحدثين بغير الإنجليزية.
@@ -462,7 +456,7 @@ author: aymericzip
     ```
 
   </Tab>
-    <Tab label="راوتر React" value="reactrouter">
+  <Tab label="راوتر React" value="reactrouter">
 
     ```typescript fileName="intlayer.config.ts"
     import { Locales, type IntlayerConfig } from "intlayer";
@@ -588,8 +582,6 @@ author: aymericzip
 
 لمزيد من المعلومات ودلائل التكامل، راجع توثيق [إعادة كتابة عناوين URL المخصصة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/custom_url_rewrites.md).
 
----
-
 ### قيم الإدراج المحسّنة
 
 في الإصدار v8، يمكن لقيم الإدراج الآن **قبول عناصر React (أو عقد Vue)** بالإضافة إلى السلاسل النصية والأرقام. يتيح لك هذا حقن مكونات غنية وتفاعلية مباشرة في قوالب الإدراج الخاصة بك.
@@ -813,8 +805,6 @@ const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
 
 لمزيد من المعلومات، راجع [توثيق الجمع](https://intlayer.org/doc/concept/content/plural).
 
----
-
 ## التحقق من صحة مخطط المحتوى
 
 تقدم Intlayer v8 التحقق من صحة المخططات للقواميس. يمكنك الآن تعريف مخططات تحقق قابلة لإعادة الاستخدام في إعداداتك باستخدام Zod وتطبيقها على ملفات المحتوى الخاصة بك. يضمن ذلك التزام محتواك دائمًا بالهيكل المتوقع واكتشاف الأخطاء أثناء وقت البناء.
@@ -857,8 +847,6 @@ export default aboutPageMetaContent;
 
 إذا لم يتطابق المحتوى مع المخطط (مثلاً، كان العنوان قصيراً جداً)، فستؤدي عملية البناء إلى رفع خطأ.
 
----
-
 ## TypeScript: IntlayerNode Primitive Accessors
 
 تم تحديث نوع `IntlayerNode` للسماح باستدعاء دوال JavaScript البدائية مباشرة على عقد المحتوى. هذا يجعل من الممكن التفاعل مع المحتوى المترجم الخاص بك مباشرة كما لو كان سلسلة نصية قياسية، رقم، قيمة منطقية، أو مصفوفة بدائية.
@@ -885,8 +873,6 @@ content.myArrayOfString.find(...)   // Returns element
 content.myArrayOfString.join(', ')  // Returns joined string
 ```
 
----
-
 ### الكشف التلقائي المحسَّن للمحتوى
 
 في الإصدار v8، يقوم Intlayer باكتشاف صيغة Markdown وعلامات HTML وإدراج المتغيرات داخل سلاسل المحتوى بذكاء. هذا يعني أنه يمكنك غالبًا الاستغناء عن دوال المساعدة مثل `md()`، `html()`، أو `insert()`.
@@ -960,8 +946,6 @@ export default {
 }
 ```
 
----
-
 ## التوطين: الخطاف الجديد `useIntl`
 
 يتوفر الآن خطاف `useIntl()` في React وNext.js وVue. يوفر هذا الخطاف كائن `Intl` مرتبطًا بالـ locale ويستخدم اللغة الحالية تلقائيًا لتنسيق الأرقام والتواريخ والمزيد، دون الحاجة إلى تمرير الـ locale يدويًا.
@@ -1080,8 +1064,6 @@ export default {
   </Tab>
 </Tabs>
 
----
-
 ## الأدوات: تحسينات امتداد VSCode
 
 تلقى امتداد Intlayer لـ VSCode تحديثات رئيسية في v8 لتبسيط سير عمل الترجمة الخاصة بك:
@@ -1090,8 +1072,6 @@ export default {
 - **التخزين المؤقت**: طبقة تخزين مؤقت محسّنة لتمكين التحقق من الصحة والإكمال التلقائي شبه الفوري.
 - **اكتشاف المفاتيح غير المستخدمة والمفاتيح المكررة**: ميزات جديدة لاكتشاف **المفاتيح غير المستخدمة** و**المفاتيح المكررة** عبر قواميسك تلقائيًا، مما يساعدك على الحفاظ على محتوى نظيف وفعّال.
 
----
-
 ## الأدوات: مراقب C++ و LSP المعتمد على OXC (v8.12.0)
 
 يجلب Intlayer v8.12.0 تحسينات كبيرة لتجربة المطور:
@@ -1101,15 +1081,13 @@ export default {
 
 لمزيد من التفاصيل، راجع [توثيق LSP](https://intlayer.org/doc/lsp).
 
----
-
 ## تحسينات المجمّع
 
 يتضمن Intlayer الإصدار 8 طبقة تخزين مؤقت جديدة لمجمّع Markdown وHTML. هذا يضمن أن سلاسل المحتوى المتطابقة بنفس التهيئة يتم تحليلها مرة واحدة فقط، مما يقلل بشكل كبير من العبء أثناء إعادة العرض أو عند استخدام نفس المحتوى في أماكن متعددة.
 
 <Tabs group='bundler'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```typescript fileName="babel.config.js"
       const {
       intlayerExtractBabelPlugin,
@@ -1131,7 +1109,7 @@ export default {
 
   </Tab>
   <Tab label="Vite" value="vite">
-   
+
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
     import { intlayer, intlayerCompiler } from "vite-intlayer";
@@ -1156,8 +1134,6 @@ export default {
   </Tab>
 </Tabs>
 
----
-
 ## تحسينات البناء التجريبية: التصغير والتطهير (Minify & Purge) (v8.7.0)
 
 يقدم Intlayer v8.7.0 ميزات بناء تجريبية جديدة في ملف `intlayer.config.ts` الخاص بك، مصممة لتحسين حزمة الإنتاج الخاصة بك:
@@ -1198,8 +1174,6 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
----
-
 ## المرونة: وضع استيراد موحّد
 
 تم إهمال الخاصية البوليانية `live` لصالح خاصية أكثر شمولاً تسمى `importMode`. تتيح هذه الخاصية تحديد صريح لكيفية تحميل القواميس: بشكل ثابت، أو ديناميكيًا، أو عبر مزامنة حية.
@@ -1240,8 +1214,6 @@ export default {
 }
 ```
 
----
-
 ## التحكم في موقع القواميس
 
 تقدم النسخة v8 الخاصية `location` لإدارة مكان تواجد القواميس وكيفية تزامنها بشكل صريح. هذا مفيد بشكل خاص في سير عمل هجين يتضمن كلًا من الملفات المحلية ومحتوى أنظمة إدارة المحتوى (CMS) البعيدة.
@@ -1262,8 +1234,6 @@ export default {
 }
 ```
 
----
-
 ## فصل تكوين النظام
 
 يفصل Intlayer v8 تكوين مصادر المحتوى عن المسارات الداخلية للنظام والإخراج. هذا ينظف خاصية content ويوضح أي الإعدادات مخصصة لإدارة المستخدم مقابل تلك التي يديرها نظام Intlayer.
@@ -1303,8 +1273,6 @@ export default {
 };
 ```
 
----
-
 ## فصل دلائل المحتوى وملفات الشيفرة
 
 Intlayer v8 يفصل إعدادات تعريف ملفات المحتوى عن إعدادات تحويل الشيفرة. هذا يتيح مراقبة ومسح أدق، مما يحسّن أداء عملية البناء.
@@ -1339,22 +1307,16 @@ export default {
 };
 ```
 
----
-
 ## إطار العمل: تحسينات Svelte
 
 يتم الآن تحليل محتوى Markdown و HTML في Svelte تلقائيًا إلى HTML عند تحويله إلى سلسلة (stringified). هذا يجعل استخدامه مع تركيب Svelte `{@html}` أسهل بكثير، إذ يمكنك الآن ببساطة تمرير عقدة المحتوى مباشرة.
 
----
-
 ## دعم Angular: مجمّع Vite (v8.11.0)
 
 لمستخدمي Angular، يدعم Intlayer الآن مجمّع Vite بشكل أصلي من خلال مكون إضافي جديد مخصص لـ esbuild، مما يسرع أوقات التطوير والبناء.
 
 للحصول على تفاصيل حول التكوين، راجع [توثيق بيئة Angular](https://intlayer.org/doc/environment/angular).
 
----
-
 ## إنشاء خريطة الموقع (Sitemap) (v8.6.0)
 
 يقوم Intlayer الآن بإنشاء خرائط المواقع تلقائيًا بناءً على اللغات ووضع التوجيه الخاص بك. هذا مفيد بشكل خاص لتحسين محركات البحث (SEO) في معماريات الموجهات مثل TanStack Router:
@@ -1388,8 +1350,6 @@ export const Route = createFileRoute("/sitemap.xml")({
 });
 ```
 
----
-
 ## ملاحظات الترحيل من الإصدار v7
 
 ### تغييرات التكوين
@@ -1399,8 +1359,6 @@ export const Route = createFileRoute("/sitemap.xml")({
 - **`contentDir` و `codeDir`**: أصبح `contentDir` مخصّصًا الآن لملفات المحتوى. تمت إضافة خاصية جديدة `codeDir` لتحويل الكود. إذا لم يتم تعيين `codeDir`، فسيقوم Intlayer بالرجوع إلى `contentDir` وتسجيل تحذير.
 - **التحقق من المخطط (Schema Validation)**: لاستخدام ميزة `schema` الجديدة، تأكد من تثبيت `zod` في مشروعك.
 
----
-
 ## روابط مفيدة
 
 - [مرجع التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)

package/docs/ar/releases/v9.md

@@ -38,8 +38,6 @@ author: aymericzip
 
 <TOC levels={[2]} maxDepth={1} />
 
----
-
 ## حزم محولات التوافق (Compat Adapter Packages)
 
 أصبح الترحيل إلى Intlayer من مكتبات i18n الشهيرة أسهل من أي وقت مضى. لقد أنشأنا خمس حزم توافق تعرض **نفس واجهات برمجة التطبيقات العامة (public APIs) تمامًا** مثل مكتبات i18n القياسية ولكنها تفوض جميع أعمال الترجمة إلى Intlayer في وقت التشغيل (runtime).
@@ -100,8 +98,6 @@ export default defineConfig({
 });
 ```
 
----
-
 ## محلل وقت التشغيل المشترك (Mutualized Runtime Resolver)
 
 توجه جميع محولات التوافق (compat adapters) الآن حل الترجمة من خلال محلل وقت تشغيل واحد ومحسن للغاية: `@intlayer/core/messageFormat`.
@@ -110,8 +106,6 @@ export default defineConfig({
 - **محلل عقدة الرسالة (Message Node Resolver)**: يحل العقد المتداخلة: `insert()`، `plural()` (قواعد الجمع CLDR)، `enu()` (التعداد)، `gender()`، علامات HTML، المصفوفات، وعقد الوظائف القابلة للاستدعاء.
 - **محلل العلامات المرمزة (Tokenized Tag Parser)**: يدعم علامات XML/HTML المضمنة والعلامات المرقمة (مثل `<1>children</1>`) لتشغيل عرض النص الغني (rich-text rendering) بشكل جاهز.
 
----
-
 ## مواصفات الميزة: المجموعات (Collections) والمتغيرات (Variants)
 
 يتوسع Intlayer v9 إلى ما هو أبعد من كائنات المفتاح-القيمة الثابتة، مما يسمح للقواميس بالإعلان عن هياكل تخطيط ديناميكية مكتوبة بالكامل من البداية إلى النهاية.
@@ -211,8 +205,6 @@ const product = useIntlayer("product-copy", {
 });
 ```
 
----
-
 ## `@intlayer/analytics`: تتبع عرض المحتوى واختبار A/B
 
 حزمة اختيارية جديدة، [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)، تخبرك بالمحتوى الذي يشاهده زوارك فعلياً — وتُكمل حلقة **Collections & Variants** من خلال تمكينك من اختبار المحتوى بطريقة A/B وقياس التحويلات لكل نسخة.
@@ -254,8 +246,6 @@ npm install @intlayer/analytics
 
 متوفرة اليوم لـ React وNext.js وReact Native (عبر `react-intlayer`)؛ ويُخطَّط لدعم أطر عمل أخرى (Vue، Svelte، Angular، …) باتباع نفس نمط الطرح المُستخدم في `@intlayer/editor`. راجع [توثيق Analytics](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) للحصول على الدليل الكامل.
 
----
-
 ## Vite Plugin: Bundled Compiler & Proxy
 
 يجمع plugin `intlayer()` Vite الآن **المترجم** و**بروكسي التوجيه حسب اللغة** مباشرة، لذا تحتاج معظم المشاريع إلى plugin واحد فقط في `vite.config.ts`:
@@ -290,8 +280,6 @@ export default config;
 
 تبقى plugins `intlayerCompiler()` و `intlayerProxy()` المستقلة مُصدَّرة للإعدادات المتقدمة. تسجيلها جنباً إلى جنب مع `intlayer()` آمن — كل plugin يزيل التكرار عن نفسه ويعمل مرة واحدة فقط.
 
----
-
 ## تعطيل المُجمِّع افتراضياً
 
 اعتباراً من Intlayer v9، **المُجمِّع مُعطَّل افتراضياً** (أصبحت القيمة الافتراضية لـ `compiler.enabled` الآن `false`). لتفعيل استخراج ملفات `.content.ts` في وقت البناء، اضبط `compiler.enabled: true` في إعداداتك:
@@ -311,8 +299,6 @@ export default config;
 
 عندما يكون المُجمِّع مُعطَّلاً، يتخطى Intlayer خطوة الاستخراج في وقت البناء ويعتمد على القواميس التي أعلنت عنها بالفعل. فعِّله فقط عندما تريد أن يقوم plugin المُجمِّع للحزم (`@intlayer/swc` أو `@intlayer/babel` أو plugin الـ Vite `intlayer()`) باستخراج المحتوى تلقائياً.
 
----
-
 ## React Native: استيرادات من حزمة واحدة
 
 في تطبيق React Native أو Expo، لم تعد بحاجة إلى التعامل مع كل من `react-intlayer` و`react-native-intlayer` معًا. تقوم حزمة `react-native-intlayer` الآن **بإعادة تصدير واجهة برمجة التطبيقات الكاملة لـ `react-intlayer`** (الخطافات، والأدوات المساعدة، والمسارات الفرعية `/format` و`/html` و`/markdown`)، كما يطبق `IntlayerProvider` الخاص بها حزم polyfill الخاصة بـ React Native تلقائيًا.
@@ -333,8 +319,6 @@ npm install intlayer react-native-intlayer
 
 > الاستيراد من `react-intlayer` لا يزال يعمل، لكن `react-native-intlayer` أصبح الآن نقطة الدخول الواحدة الموصى بها لـ React Native — يشحن موفره حزم polyfill التي لا يتضمنها موفر `react-intlayer` الموجه للويب.
 
----
-
 ## CMS SDK: استخدم Intlayer كقاعدة بيانات محتوى headless
 
 يأتي Intlayer v9 مع SDK نظيف وذاتي المصادقة في `@intlayer/api` للتفاعل مع نظام إدارة المحتوى (CMS) برمجيًا — جلب المشاريع، وجلب القواميس، ودفعها أو تحديثها من خادمك أو سكربتاتك أو CI الخاص بك. تتم المصادقة (OAuth2 `client_credentials`) وتجديدها نيابةً عنك.
@@ -361,8 +345,6 @@ await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
 
 > الأمان: تمنح بيانات اعتماد نظام إدارة المحتوى صلاحية الكتابة على محتواك. أنشئ المُصادِق دائمًا **على الخادم** فقط — لا ترسل أبدًا `clientId` / `clientSecret` إلى المتصفح.
 
----
-
 ## الاستضافة الذاتية (Self-Hosting)
 
 يدعم Intlayer v9 دعمًا أصليًا لتشغيل نسختك الخاصة من Intlayer بأمر واحد — دون الحاجة إلى حساب Intlayer Cloud.
@@ -373,8 +355,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 يقوم المثبّت بتنزيل ملف `docker-compose.yml` وملف `.env`، ويولّد الأسرار المطلوبة تلقائياً، ويشغّل `docker compose up -d`. كل شيء — لوحة التحكم، وواجهة برمجة التطبيقات، وقاعدة البيانات، وتخزين الكائنات، والبريد الإلكتروني التفاعلي — يعمل محلياً داخل حاويات.
 
----
-
 ## ملاحظات الترحيل من الإصدار 8
 
 إذا كنت تقوم بالترقية من الإصدار 8، لاحظ أن الإصدار 9 لا يتضمن تغييرات جذرية (breaking changes). ولكن إليك التغييرات الرئيسية:
@@ -383,8 +363,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 - **اللغات واللهجات (Locales & Dialects)**: إذا كنت تستخدم تبعيات i18n خارجية، أضف إضافات محول التوافق (compat adapter plugins) الخاصة بها في إعداداتك أو إعداد المجمّع (bundler setup) لإعادة كتابة عمليات الاستيراد (imports) تلقائيًا.
 - **المحددات المخصصة (Custom Selectors)**: عند استدعاء `useIntlayer`، تم حجز المعامل الثاني الآن لكائن خيارات يحتوي على `{ locale, item, variant }`. إذا كنت قد مررت سابقًا سلسلة لغة (locale string) مباشرة، فلا يزال بإمكانك القيام بذلك، ولكن يوصى باستخدام كائن الخيارات للاختيارات المتقدمة.
 
----
-
 ## روابط مفيدة
 
 - [دليل حزم محولات التوافق (Compat Adapter Packages Guide)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compat/index.md)

package/docs/ar/roadmap.md

@@ -26,14 +26,10 @@ author: aymericzip
 
 Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتبسيط كيفية إعلان المحتوى وإدارته وتحديثه عبر تطبيقاتك. يقدم ميزات قوية مثل إعلان المحتوى المركزي أو الموزع، خيارات تدويل واسعة، دعم Markdown، العرض الشرطي، التكامل مع TypeScript/JavaScript/JSON، والمزيد. فيما يلي نظرة شاملة على ما يقدمه Intlayer حالياً، تليها الميزات القادمة في خارطة الطريق.
 
----
-
 ## جدول المحتويات
 
 <TOC/>
 
----
-
 ## الميزات الحالية
 
 ### 1. إعلان المحتوى
@@ -145,8 +141,6 @@ Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتب
 >
 > - [تكوين البناء](https://intlayer.org/doc/concept/configuration#build-configuration)
 
----
-
 ## التكامل مع الأُطُر والبيئات
 
 ### 1. Next.js
@@ -233,8 +227,6 @@ Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتب
 >
 > - [Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_with_preact.md)
 
----
-
 ## المحررات المرئية ونظم إدارة المحتوى
 
 ### 1. المحرر المرئي المحلي
@@ -260,21 +252,15 @@ Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتب
 >
 > - [نظام إدارة المحتوى (CMS)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)
 
----
-
 ## امتدادات بيئة التطوير المتكاملة (IDE Extensions)
 
 - امتدادات لبيئات التطوير المتكاملة الرئيسية لتوفير **واجهة رسومية** لإدارة الترجمات المحلية والبعيدة.
 - قد تشمل الميزات التوليد التلقائي لملفات إعلان المحتوى للمكونات، التكامل المباشر مع نظام إدارة المحتوى Intlayer CMS، والتحقق في الوقت الحقيقي.
 
----
-
 ## خادم MCP
 
 - **خادم MCP** يسمح لك بإدارة محتواك وترجماته باستخدام أداة مدمجة في بيئة التطوير المتكاملة الخاصة بك.
 
----
-
 ## واجهة سطر الأوامر Intlayer CLI
 
 - **الترجمة وتوليد الملفات**: إجراء تدقيقات على ملفات المحتوى الخاصة بك لتوليد الترجمات المفقودة ومراجعة التناقضات.
@@ -285,15 +271,11 @@ Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتب
 >
 > - [واجهة الأوامر CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/index.md)
 
----
-
 ## البيئات
 
 - استخدم **متغيرات البيئة** لتكوين Intlayer بشكل مختلف عبر بيئات الإنتاج والاختبار والمحلية.
 - حدد أي محرر بصري أو مشروع CMS عن بُعد تستهدفه بناءً على بيئتك.
 
----
-
 ## تحديثات المحتوى الحية
 
 - عند استخدام القواميس البعيدة وIntlayer CMS، يمكنك **تحديث محتوى تطبيقك مباشرةً**، دون الحاجة لإعادة النشر.
@@ -302,8 +284,6 @@ Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتب
 >
 > - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)
 
----
-
 ## الميزات القادمة
 
 ### 1. اختبار A/B والتخصيص
@@ -332,8 +312,6 @@ Intlayer هو حل لإدارة المحتوى والتدويل مصمم لتب
 - هناك جهود جارية لدعم **Solid، Svelte، Angular**، والمزيد.
 - الهدف هو جعل Intlayer متوافقًا مع **أي تطبيق يعمل بجافاسكريبت**.
 
----
-
 ## الخاتمة
 
 يهدف Intlayer إلى أن يكون حلاً شاملاً لإدارة المحتوى والتدويل. يركز على المرونة (الملفات المركزية أو الموزعة)، ودعم واسع للغات، والتكامل السهل مع الأُطُر الحديثة وأدوات التجميع، وميزات قوية مدعومة بالذكاء الاصطناعي. مع توفر قدرات جديدة مثل اختبار A/B، وإصدار النسخ، والترجمات الآلية، سيستمر Intlayer في تبسيط سير عمل المحتوى ورفع تجربة المستخدم عبر مختلف المنصات.

package/docs/ar/self_hosting.md

@@ -35,8 +35,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 <TOC/>
 
----
-
 ## البنية المعمارية
 
 ```
@@ -56,8 +54,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 يتم تضمين Chromium (المستخدم لتوليد لقطات الشاشة عبر Puppeteer) داخل صورة الخادم الخلفي — لا حاجة لحاوية منفصلة.
 
----
-
 ## المتطلبات الأساسية
 
 - **Docker** ≥ 24 و**Docker Compose** ≥ v2. إذا كان أحدهما مفقوداً، يطبع المثبّت رابط التثبيت ويخرج.
@@ -66,8 +62,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 كل شيء آخر — Bun و Redis و MinIO و Chromium — يتم شحنه داخل الصورة.
 
----
-
 ## البدء السريع
 
 ### 1. تشغيل المثبِّت
@@ -136,8 +130,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > متغيرات المنافذ الأربعة تغير فقط الجانب **المضيف** من التعيين المطبوع في أمر `docker run`. الصورة المنشورة لديها `http://localhost:3000` و `http://localhost:3100` و `http://localhost:9000` مدرجة في حزمة لوحة التحكم في وقت البناء، لذا فإن إعادة تعيينها تترك المتصفح يشير إلى المنافذ القديمة. احتفظ بالقيم الافتراضية إلا إذا كنت تقوم بإنشاء صورتك الخاصة — انظر [القيود](#limitations).
 
----
-
 ## إعداد التشغيل الأول
 
 على نسخة جديدة (قاعدة بيانات فارغة)، يعيد فتح لوحة التحكم توجيهك إلى صفحة **`/init`**:
@@ -148,8 +140,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 بمجرد وجود admin، يعيد `/init` التوجيه إلى صفحة تسجيل الدخول القياسية.
 
----
-
 ## الخدمات
 
 | الخدمة      | الصورة                               | المنفذ (المضيف)                     | الغرض                                                  |
@@ -163,8 +153,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > يجب أن يكون منفذ MinIO `9000` قابلاً للوصول من المتصفح لأن الأصول المرفوعة (الصور الرمزية، لقطات الشاشة) تُحمَّل مباشرة من `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
----
-
 ## متغيرات البيئة
 
 ### مطلوب
@@ -234,8 +222,6 @@ curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer
 
 > الأولوية: بريد المنظمة الخاص بها (المُعد من لوحة المعلومات **Organization**) له الأولوية على البريد العام، والذي له بدوره الأولوية على مفتاح Resend الافتراضي.
 
----
-
 ## ربط مشروعك بـ Intlayer
 
 بمجرد تشغيل المكدس، وجّه مشروعك نحو الخادم الخلفي ولوحة التحكم المستضافَين ذاتياً بدلاً من `intlayer.org`.
@@ -297,8 +283,6 @@ const cms = createIntlayerCMS({
 const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 ```
 
----
-
 ## الترقية
 
 يجلب هذا الأمر أحدث الصور ويعيد تشغيل الحاويات باستخدام `docker compose pull && docker compose up -d`. يتم الاحتفاظ بالأحجام الموجودة (`mongo-data`، `redis-data`، `minio-data`) — دون فقدان للبيانات.
@@ -308,8 +292,6 @@ docker compose pull
 docker compose up -d
 ```
 
----
-
 ## النسخ الاحتياطي والاستعادة
 
 تعيش جميع البيانات الدائمة في ثلاثة أحجام Docker مسماة.
@@ -344,16 +326,12 @@ docker run --rm \
 # كرر لـ redis-data و minio-data
 ```
 
----
-
 ## القيود
 
 - **MongoDB يجب أن يكون خارجياً (Atlas).** يتصل الخادم الخلفي فقط عبر `mongodb+srv://` (مبني من `DB_ID` / `DB_MDP` / `DB_CLUSTER`)، لذا لا يمكن استخدام `mongodb://host:27017` العادي — بما في ذلك `mongod` المدمج في الحاوية الخاصة — لا يمكن استخدامه. قدم مجموعة MongoDB Atlas.
 - **لا توجد نطاقات مخصصة.** جميع عناوين URL الموجهة للمتصفح `VITE_*` مدرجة مباشرة في التطبيق وقت البناء، والصورة المنشورة تأتي مع قيم `localhost`. يجب الوصول إلى لوحة التحكم على `http://localhost:3000`؛ تقديمها على نطاق عام سيتطلب إعادة بناء الصورة مع عناوين URL المستهدفة المدمجة فيها وليس مدعوماً بشكل افتراضي.
 - **البريد الإلكتروني يتطلب خادم بريد يعمل.** إعداد التشغيل الأول يفرض التحقق من البريد الإلكتروني، لذا يجب تكوين إما `RESEND_API_KEY` أو [خادم SMTP عام](#global-mailer) (`MAIL_PROVIDER=smtp` + `MAIL_SMTP_*`). بعد دخول المسؤول الأول، يمكن لكل منظمة أيضاً تكوين خادم SMTP أو Resend الخاص بها من لوحة التحكم.
 
----
-
 ## استكشاف الأخطاء وإصلاحها
 
 ### الخادم الخلفي يتعطل عند الإقلاع
@@ -380,8 +358,6 @@ docker compose logs redis
 docker compose run --rm minio-init
 ```
 
----
-
 ## روابط مفيدة
 
 - [توثيق Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)

package/docs/ar/testing.md

@@ -23,16 +23,12 @@ author: aymericzip
 
 يوضح هذا الدليل كيفية التحقق تلقائيًا من اكتمال قواميسك، واكتشاف الترجمات المفقودة قبل النشر، واختبار واجهة المستخدم المحلية في تطبيقك.
 
----
-
 ## ما يمكنك اختباره
 
 - **الترجمات المفقودة**: فشل في CI إذا كانت هناك أي لغات مطلوبة مفقودة لأي قاموس.
 - **عرض واجهة المستخدم المحلية**: عرض المكونات باستخدام مزود لغة محدد والتحقق من النصوص/السمات المرئية.
 - **تدقيق وقت البناء**: إجراء تدقيق سريع محليًا عبر CLI.
 
----
-
 ## بداية سريعة: التدقيق عبر CLI
 
 شغّل التدقيق من جذر مشروعك:
@@ -63,8 +59,6 @@ bun x intlayer content test
 
 ملاحظة: يقوم CLI بطباعة تقرير مفصل لكنه لا يخرج برمز خطأ عند الفشل. لاستخدامه في CI، أضف اختبار وحدة (أسفله) يؤكد عدم وجود لغات مطلوبة مفقودة.
 
----
-
 ## اختبار برمجي (Vitest/Jest)
 
 استخدم واجهة برمجة تطبيقات Intlayer CLI للتأكد من عدم وجود ترجمات مفقودة للغات المطلوبة.
@@ -111,8 +105,6 @@ test("لا توجد لغات مطلوبة مفقودة", () => {
   - `missingLocales`: اتحاد جميع اللغات المفقودة.
   - `missingRequiredLocales`: مجموعة فرعية محدودة بـ `requiredLocales` (أو جميع اللغات إذا لم يتم تعيين `requiredLocales`).
 
----
-
 ## اختبار واجهة المستخدم المحلية (React / Next.js)
 
 قم بعرض المكونات تحت مزود Intlayer وتحقق من المحتوى المرئي.
@@ -159,8 +151,6 @@ test("يعرض العنوان المحلي بالفرنسية", () => {
 - عندما تحتاج إلى قيم نصية خام للسمات (مثل `aria-label`)، قم بالوصول إلى الحقل `.value` الذي يتم إرجاعه بواسطة `useIntlayer` في React.
 - احتفظ بالقواميس بجانب المكونات لتسهيل اختبار الوحدة والتنظيف.
 
----
-
 ## التكامل المستمر
 
 أضف اختبارًا يفشل البناء عندما تكون الترجمات المطلوبة مفقودة.
@@ -210,8 +200,6 @@ pnpm intlayer content test --verbose
 bun x intlayer content test --verbose
 ```
 
----
-
 ## استكشاف الأخطاء وإصلاحها
 
 - تأكد من أن تكوين Intlayer الخاص بك يحدد `locales` و (اختياريًا) `requiredLocales`.