@intlayer/docs 8.9.7 → 8.10.0-canary.0

package/docs/ar/benchmark/vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-20
-updatedAt: 2026-04-21
+updatedAt: 2026-05-18
 title: أفضل حل i18n لـ Vue في عام 2026 - تقرير قياسي
 description: قارن بين مكتبات تدويل Vue (i18n) مثل vue-i18n وfluent-vue وIntlayer. تقرير أداء مفصل حول حجم الحزمة والتسرب والتفاعل.
 keywords:
@@ -17,12 +17,15 @@ slugs:
 author: Aymeric PINEAU
 applicationTemplate: https://github.com/intlayer-org/benchmark-i18n-vue-template
 history:
+  - version: 8.9.8
+    date: 2026-05-18
+    changes: "إضافة مقارنة نجوم GitHub"
   - version: 8.7.12
     date: 2026-01-06
     changes: "بدء التقييم القياسي"
 ---
 
-# مكتبات i18n لـ Vue — تقرير التقييم القياسي 2026
+# مكتبات i18n لـ Vue - تقرير التقييم القياسي 2026
 
 هذه الصفحة هي تقرير تقييم قياسي لحلول i18n على Vue.
 
@@ -135,13 +138,19 @@ style="border:none;"
 
 - **وقت الهيدرة (Hydration)**: الوقت الذي يقضيه العميل في تحويل HTML الخادم إلى واجهة تفاعلية. تعني الشرطة في الجداول أن هذا التنفيذ لم يوفر رقم هيدرة موثوقًا به في هذا التقييم.
 
+## نجوم GitHub
+
+تعد نجوم GitHub مؤشرًا قويًا على شعبية المشروع وثقة المجتمع وأهميته على المدى الطويل. على الرغم من أنها ليست مقياسًا مباشرًا للجودة التقنية، إلا أنها تعكس عدد المطورين الذين يجدون المشروع مفيدًا ويتابعون تقدمه ومن المحتمل أن يتبنوه. لتقدير قيمة المشروع، تساعد النجوم في مقارنة الجاذبية عبر البدائل وتوفر رؤى حول نمو النظام البيئي.
+
+[![Star History Chart](https://api.star-history.com/chart?repos=intlify%2Fvue-i18n%2Cfluent-vue%2Ffluent-vue%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#intlify/vue-i18n&fluent-vue/fluent-vue&aymericzip/intlayer)
+
 ## النتائج بالتفصيل
 
-### 1 — حلول يجب تجنبها
+### 1 - حلول يجب تجنبها
 
 > لا يوجد حل واضح يجب تجنبه في نظام Vue البيئي.
 
-### 2 — حلول مقبولة
+### 2 - حلول مقبولة
 
 **(vue-i18n)** (`vue-i18n@11.4.0`):
 
@@ -153,7 +162,7 @@ style="border:none;"
 
 - **fluent-vue** يقدم محاولة ابتكار من خلال تنسيق .ftl. تنظيم الرسائل رائع، وأسهل في البدء. ولكن في الممارسة العملية، يؤدي نقص سلامة النوع إلى زيادة خطر الخطأ ويمكن أن يصبح استهلاك الوقت في تصحيح الأخطاء سريعًا. علاوة على ذلك، يقوم هذا الحل بتحميل الرسائل باستخدام مكون vite الإضافي الذي يفرض تحميل كل المحتوى بجميع اللغات في كل صفحة. بالإضافة إلى ذلك، هذا حل ثقيل للغاية (~92.7kb، أي حوالي 34 ضعف `vue-intlayer`).
 
-### 3 — التوصيات
+### 3 - التوصيات
 
 **(Intlayer)** (`vue-intlayer@8.7.12`):
 

package/docs/ar/configuration.md

@@ -599,7 +599,7 @@ export default config;
 | ----------------- | -------------------------------------------------------------------------- | ---------- | ------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `locales`         | قائمة اللغات المدعومة في التطبيق.                                          | `string[]` | `[Locales.ENGLISH]` | `['en', 'fr', 'es']` |                                                                                                                                                                                                                                                                 |
 | `requiredLocales` | قائمة اللغات المطلوبة في التطبيق.                                          | `string[]` | `[]`                | `[]`                 | • إذا كانت فارغة، فستكون جميع اللغات مطلوبة في وضع `strict`. <br/> • تأكد من تعريف اللغات المطلوبة أيضاً في حقل `locales`.                                                                                                                                      |
-| `strictMode`      | يضمن تنفيذاً قوياً للمحتوى المترجم باستخدام TypeScript.                    | `string`   | `'inclusive'`       |                      | • إذا كان `"strict"`: تطلب الدالة `t` تعريف كل لغة معلنة — يلقي خطأ إذا كانت إحداها مفقودة أو غير معلنة. <br/> • إذا كان `"inclusive"`: يحذر من اللغات المفقودة ولكنه يسمح باستخدام اللغات الموجودة غير المعلنة. <br/> • إذا كان `"loose"`: يقبل أي لغة موجودة. |
+| `strictMode`      | يضمن تنفيذاً قوياً للمحتوى المترجم باستخدام TypeScript.                    | `string`   | `'inclusive'`       |                      | • إذا كان `"strict"`: تطلب الدالة `t` تعريف كل لغة معلنة - يلقي خطأ إذا كانت إحداها مفقودة أو غير معلنة. <br/> • إذا كان `"inclusive"`: يحذر من اللغات المفقودة ولكنه يسمح باستخدام اللغات الموجودة غير المعلنة. <br/> • إذا كان `"loose"`: يقبل أي لغة موجودة. |
 | `defaultLocale`   | اللغة الافتراضية المستخدمة كاحتياطي في حالة عدم العثور على اللغة المطلوبة. | `string`   | `Locales.ENGLISH`   | `'en'`               | تُستخدم لتحديد اللغة عندما لا يتم تحديدها في رابط URL أو الكوكيز أو الهيدر.                                                                                                                                                                                     |
 
 ---
@@ -663,10 +663,10 @@ routing: {
 
 | القيمة             | ملاحظة                                                                                                                                                                                                                    | الوصف                                                               |
 | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
-| `'cookie'`         | • للامتثال للقانون العام لحماية البيانات (GDPR)، تأكد من الحصول على موافقة المستخدم بشكل صحيح. <br/> • قابل للتخصيص عبر `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`). | يخزن اللغة في الكوكيز — يمكن الوصول إليها على كل من العميل والخادم. |
-| `'localStorage'`   | • لا تنتهي صلاحيته إلا إذا تم مسحه صراحة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`).                                | يخزن اللغة في المتصفح دون حد زمني — من جانب العميل فقط.             |
-| `'sessionStorage'` | • يتم مسحه عند إغلاق التبويب/النافذة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).                                  | يخزن اللغة طوال مدة جلسة الصفحة — من جانب العميل فقط.               |
-| `'header'`         | • مفيد لطلبات واجهة برمجة التطبيقات (API). <br/> • لا يمكن لجانب العميل الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                          | يخزن أو يمرر اللغة عبر ترويسات HTTP — من جانب الخادم فقط.           |
+| `'cookie'`         | • للامتثال للقانون العام لحماية البيانات (GDPR)، تأكد من الحصول على موافقة المستخدم بشكل صحيح. <br/> • قابل للتخصيص عبر `CookiesAttributes` (`{ type: 'cookie', name: 'custom-locale', secure: true, httpOnly: false }`). | يخزن اللغة في الكوكيز - يمكن الوصول إليها على كل من العميل والخادم. |
+| `'localStorage'`   | • لا تنتهي صلاحيته إلا إذا تم مسحه صراحة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'localStorage', name: 'custom-locale' }`).                                | يخزن اللغة في المتصفح دون حد زمني - من جانب العميل فقط.             |
+| `'sessionStorage'` | • يتم مسحه عند إغلاق التبويب/النافذة. <br/> • لا يمكن لـ Intlayer Proxy الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'sessionStorage', name: 'custom-locale' }`).                                  | يخزن اللغة طوال مدة جلسة الصفحة - من جانب العميل فقط.               |
+| `'header'`         | • مفيد لطلبات واجهة برمجة التطبيقات (API). <br/> • لا يمكن لجانب العميل الوصول إليه. <br/> • قابل للتخصيص عبر `StorageAttributes` (`{ type: 'header', name: 'custom-locale' }`).                                          | يخزن أو يمرر اللغة عبر ترويسات HTTP - من جانب الخادم فقط.           |
 
 #### سمات الكوكيز (Cookies Attributes)
 
@@ -854,7 +854,7 @@ export default config;
 | `location`                  | يشير إلى مكان تخزين ملفات القاموس وكيفية مزامنتها مع CMS.                                                          | `'local'` &#124; <br/> `'remote'` &#124; <br/> `'hybrid'` &#124; <br/> `'plugin'` &#124; <br/> `string`         | `'local'`    | `'hybrid'`                                                                                  | • `'local'`: إدارة محلية فقط. <br/> • `'remote'`: إدارة عن بعد فقط (CMS). <br/> • `'hybrid'`: إدارة محلية وعن بعد معاً. <br/> • `'plugin'` أو سلسلة مخصصة: إدارة بواسطة إضافة أو مصدر مخصص.                                                                                                                                                                             |
 | `importMode`                | يتحكم في طريقة استيراد القواميس.                                                                                   | `'static'` &#124; <br/> `'dynamic'` &#124; <br/> `'fetch'`                                                      | `'static'`   | `'dynamic'`                                                                                 | • `'static'`: استيراد ثابت. <br/> • `'dynamic'`: استيراد ديناميكي عبر Suspense. <br/> • `'fetch'`: جلب عبر Live Sync API؛ التراجع إلى `'dynamic'` عند الفشل. <br/> • يتطلب إضافات `@intlayer/babel` و `@intlayer/swc`. <br/> • يجب الإعلان عن المفاتيح بشكل ثابت. <br/> • يتم تجاهله إذا تم إيقاف `optimize`. <br/> • لا يؤثر على `getIntlayer` أو `getDictionary` إلخ. |
 | `priority`                  | أولوية القاموس. تفوز القيم الأعلى على القيم الأدنى عند حل التعارضات بين القواميس.                                  | `number`                                                                                                        | `undefined`  | `1`                                                                                         |                                                                                                                                                                                                                                                                                                                                                                         |
-| `live`                      | ملغي — استخدم `importMode: 'fetch'`. كان يشير إلى ما إذا كان ينبغي جلب محتوى القاموس ديناميكياً عبر Live Sync API. | `boolean`                                                                                                       | `undefined`  |                                                                                             | تم تغيير اسمه إلى `importMode: 'fetch'` في v8.0.0.                                                                                                                                                                                                                                                                                                                      |
+| `live`                      | ملغي - استخدم `importMode: 'fetch'`. كان يشير إلى ما إذا كان ينبغي جلب محتوى القاموس ديناميكياً عبر Live Sync API. | `boolean`                                                                                                       | `undefined`  |                                                                                             | تم تغيير اسمه إلى `importMode: 'fetch'` في v8.0.0.                                                                                                                                                                                                                                                                                                                      |
 | `schema`                    | يتم توليده تلقائياً بواسطة Intlayer للتحقق من صحة JSON schema.                                                     | `'https://intlayer.org/schema.json'`                                                                            | توليد تلقائي |                                                                                             | لا تقم بتحريره يدوياً.                                                                                                                                                                                                                                                                                                                                                  |
 | `title`                     | يساعد في التعرف على القاموس في المحرر و CMS.                                                                       | `string`                                                                                                        | `undefined`  | `'User Profile'`                                                                            |                                                                                                                                                                                                                                                                                                                                                                         |
 | `tags`                      | يصنف القواميس ويوفر سياقاً أو تعليمات للمحرر والذكاء الاصطناعي.                                                    | `string[]`                                                                                                      | `undefined`  | `['user', 'profile']`                                                                       |                                                                                                                                                                                                                                                                                                                                                                         |

package/docs/ar/custom_domains.md

@@ -34,8 +34,8 @@ history:
 
 الفرق الرئيسي هو **الحصرية**:
 
-- **نطاق حصري** — لغة واحدة فقط ترتبط باسم المضيف هذا (مثل `zh → intlayer.zh`). النطاق نفسه يحدد اللغة، لذا لا يتم إضافة بادئة لغة إلى المسار. يخدم `https://intlayer.zh/about` المحتوى الصيني.
-- **نطاق مشترك** — ترتبط لغات متعددة بنفس اسم المضيف (مثل `en` و `fr` كلاهما يرتبطان بـ `intlayer.org`). يتم تطبيق التوجيه التقليدي القائم على البادئة. يخدم `intlayer.org/fr/about` المحتوى الفرنسي.
+- **نطاق حصري** - لغة واحدة فقط ترتبط باسم المضيف هذا (مثل `zh → intlayer.zh`). النطاق نفسه يحدد اللغة، لذا لا يتم إضافة بادئة لغة إلى المسار. يخدم `https://intlayer.zh/about` المحتوى الصيني.
+- **نطاق مشترك** - ترتبط لغات متعددة بنفس اسم المضيف (مثل `en` و `fr` كلاهما يرتبطان بـ `intlayer.org`). يتم تطبيق التوجيه التقليدي القائم على البادئة. يخدم `intlayer.org/fr/about` المحتوى الفرنسي.
 
 ## التكوين
 
@@ -55,9 +55,9 @@ const config: IntlayerConfig = {
   routing: {
     mode: "prefix-no-default",
     domains: {
-      // نطاق مشترك — en و fr يستخدمان توجيه البادئة على intlayer.org
+      // نطاق مشترك - en و fr يستخدمان توجيه البادئة على intlayer.org
       en: "intlayer.org",
-      // نطاق حصري — zh لها اسم مضيف خاص بها، لا حاجة لبادئة /zh/
+      // نطاق حصري - zh لها اسم مضيف خاص بها، لا حاجة لبادئة /zh/
       zh: "intlayer.zh",
     },
   },
@@ -96,7 +96,7 @@ getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.org" });
 ```ts
 // الصفحة الحالية: intlayer.zh/about
 getLocalizedUrl("/about", "zh", { currentDomain: "intlayer.zh" });
-// ← "/about"  (بالفعل على النطاق الصحيح — رابط نسبي)
+// ← "/about"  (بالفعل على النطاق الصحيح - رابط نسبي)
 
 getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 // ← "https://intlayer.org/fr/about"  (رابط عبر النطاقات يعود إلى intlayer.org)
@@ -108,14 +108,14 @@ getLocalizedUrl("/about", "fr", { currentDomain: "intlayer.zh" });
 
 1. اسم المضيف لرابط إدخال مطلق (مثلاً `https://intlayer.org/about` ← `intlayer.org`).
 2. `window.location.hostname` في بيئات المتصفح.
-3. إذا لم يتوفر أي منهما (SSR بدون خيار صريح)، يتم إرجاع رابط نسبي للغات الموجودة على نفس النطاق ولا يتم إنتاج رابط مطلق — وهذا هو التراجع الآمن.
+3. إذا لم يتوفر أي منهما (SSR بدون خيار صريح)، يتم إرجاع رابط نسبي للغات الموجودة على نفس النطاق ولا يتم إنتاج رابط مطلق - وهذا هو التراجع الآمن.
 
 ```ts
-// المتصفح — window.location.hostname === 'intlayer.org'
+// المتصفح - window.location.hostname === 'intlayer.org'
 getLocalizedUrl("/about", "zh");
 // ← "https://intlayer.zh/about"  (تم اكتشافه تلقائيًا من النافذة)
 
-// من رابط مطلق — تم اكتشاف النطاق تلقائيًا
+// من رابط مطلق - تم اكتشاف النطاق تلقائيًا
 getLocalizedUrl("https://intlayer.org/about", "zh");
 // ← "https://intlayer.zh/about"
 ```
@@ -151,14 +151,14 @@ export const config = {
 };
 ```
 
-**إعادة التوجيه (Redirect)** — يصل الطلب إلى النطاق الخطأ لبادئة لغة معينة:
+**إعادة التوجيه (Redirect)** - يصل الطلب إلى النطاق الخطأ لبادئة لغة معينة:
 
 ```
 GET intlayer.org/zh/about
 ← 301 https://intlayer.zh/about
 ```
 
-**إعادة الكتابة (Rewrite)** — يصل الطلب إلى النطاق الحصري للغة بدون بادئة:
+**إعادة الكتابة (Rewrite)** - يصل الطلب إلى النطاق الحصري للغة بدون بادئة:
 
 ```
 GET intlayer.zh/about
@@ -209,7 +209,7 @@ export const LocaleSwitcher = () => {
 };
 ```
 
-لا يلزم تكوين إضافي — يكتشف `useLocale` داخليًا `window.location.hostname` ويقرر بين `router.replace` (نفس النطاق) و `window.location.href` (عبر النطاقات).
+لا يلزم تكوين إضافي - يكتشف `useLocale` داخليًا `window.location.hostname` ويقرر بين `router.replace` (نفس النطاق) و `window.location.href` (عبر النطاقات).
 
 ## SEO: روابط `hreflang` البديلة
 

package/docs/ar/dictionary/content_file.md

@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.10.0
+    date: 2026-05-19
+    changes: "إضافة دعم لتنسيقات ملفات YAML و Markdown"
   - version: 8.9.0
     date: 2026-05-12
     changes: "إضافة نوع عقدة المحتوى `plural`"
@@ -788,6 +791,40 @@ export default {
 }
 ```
 
+### ملف محتوى Markdown
+
+```markdown
+---
+key: welcome-page
+locale: en
+title: Welcome Page Content
+description: Content for the main welcome page
+tags:
+  - page
+  - welcome
+---
+
+# Welcome to Our Platform
+
+## Build amazing applications with ease
+```
+
+### ملف محتوى YAML
+
+```yaml
+key: welcome-page
+title: Welcome Page Content
+description: Content for the main welcome page
+locale: "en"
+tags:
+  - page
+  - welcome
+content:
+  hero:
+    title: Welcome to Our Platform
+    subtitle: Build amazing applications with ease
+```
+
 ### ملفات المحتوى حسب اللغة
 
 للقواميس حسب اللغة، حدد خاصية `locale`:
@@ -839,6 +876,10 @@ export default {
 - `.content.mjx`
 - `.content.cjs`
 - `.content.cjx`
+- `.content.md`
+- `.content.mdx`
+- `.content.yaml`
+- `.content.yml`
 
 هذه الامتدادات الافتراضية مناسبة لمعظم التطبيقات. ومع ذلك، عندما تكون لديك احتياجات محددة، يمكنك تعريف امتدادات مخصصة لتبسيط عملية البناء وتقليل خطر التعارض مع المكونات الأخرى.
 

package/docs/ar/interest_of_intlayer.md

@@ -233,5 +233,3 @@ export const ComponentExample = () => {
 يمكن لـ `intlayer` أيضًا المساعدة في إدارة مساحات الأسماء الخاصة بـ `react-intl` و `react-i18next` و `next-intl` و `next-i18next` و `vue-i18n`.
 
 باستخدام `intlayer`، يمكنك التصريح عن المحتوى الخاص بك بتنسيق مكتبة i18n المفضلة لديك، وسيقوم intlayer بإنشاء مساحات الأسماء الخاصة بك في الموقع الذي تختاره (مثال: `/messages/{{locale}}/{{namespace}}.json`).
-
-ارجع إلى [خيارات dictionaryOutput و i18nextResourcesDir](https://intlayer.org/doc/concept/configuration#content-configuration) لمزيد من التفاصيل.

package/docs/ar/intlayer_with_analog.md

@@ -44,7 +44,7 @@ history:
 <iframe
   src="https://intlayer-analog-template.vercel.app"
   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="تجربة — intlayer-analog-template"
+  title="تجربة - intlayer-analog-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_angular.md

@@ -68,7 +68,7 @@ history:
 <iframe
   src="https://intlayer-angular-template.vercel.app"
   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="تجربة — intlayer-angular-template"
+  title="تجربة - intlayer-angular-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_astro.md

@@ -48,7 +48,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_astro_lit.md

@@ -47,7 +47,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -262,7 +262,7 @@ const { greeting } = getIntlayer("lit-demo", locale);
     />
   </head>
   <body>
-    <!-- عنصر Lit مخصص — يستلم اللغة المكتشفة من الخادم كخاصية (property) -->
+    <!-- عنصر Lit مخصص - يستلم اللغة المكتشفة من الخادم كخاصية (property) -->
     <lit-demo locale={locale}></lit-demo>
   </body>
 </html>

package/docs/ar/intlayer_with_astro_preact.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -110,7 +110,7 @@ bun x intlayer init
   تتضمن إضافة تكامل Astro لربط Intlayer بـ [Vite bundler](https://vite.dev/guide/why.html#why-bundle-for-production)، بالإضافة إلى وسيط (middleware) لاكتشاف لغة المستخدم المفضلة، وإدارة ملفات تعريف الارتباط (cookies)، والتعامل مع إعادة توجيه الروابط.
 
 - **preact**
-  حزمة Preact الأساسية — بديل سريع وخفيف لـ React.
+  حزمة Preact الأساسية - بديل سريع وخفيف لـ React.
 
 - **preact-intlayer**
   حزمة لدمج Intlayer في تطبيقات Preact. توفر `IntlayerProvider` بالإضافة إلى الخطافات (hooks) `useIntlayer` و `useLocale` للتدويل في Preact.
@@ -365,7 +365,7 @@ export const LocaleSwitcher: FunctionalComponent = () => {
 > **ملاحظة حول الاستمرارية:**
 > يضمن استخدام `onLocaleChange` لإعادة التوجيه عبر `window.location.href` زيارة الرابط الجديد للغة، مما يسمح لوسيط Intlayer بتعيين كوكيز اللغة وتذكر تفضيلات المستخدم في الزيارات المستقبلية.
 
-> يجب رندر `LocaleSwitcher` داخل `IntlayerProvider` — استخدمه داخل مكون الجزيرة الخاص بك (كما هو موضح في الخطوة 6).
+> يجب رندر `LocaleSwitcher` داخل `IntlayerProvider` - استخدمه داخل مكون الجزيرة الخاص بك (كما هو موضح في الخطوة 6).
 
 ### الخطوة 8: خريطة الموقع وRobots.txt
 

package/docs/ar/intlayer_with_astro_react.md

@@ -49,7 +49,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -361,7 +361,7 @@ export function LocaleSwitcher() {
 > **ملاحظة حول الاستمرارية:**
 > يضمن استخدام `onLocaleChange` لإعادة التوجيه عبر `window.location.href` زيارة الرابط الجديد للغة، مما يسمح لوسيط Intlayer بتعيين كوكيز اللغة وتذكر تفضيلات المستخدم في الزيارات المستقبلية.
 
-> يجب رندر `LocaleSwitcher` داخل `IntlayerProvider` — استخدمه داخل مكون الجزيرة الخاص بك (كما هو موضح في الخطوة 6).
+> يجب رندر `LocaleSwitcher` داخل `IntlayerProvider` - استخدمه داخل مكون الجزيرة الخاص بك (كما هو موضح في الخطوة 6).
 
 ### الخطوة 8: خريطة الموقع وRobots.txt
 

package/docs/ar/intlayer_with_astro_solid.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -356,12 +356,12 @@ export function LocaleSwitcher() {
 ```
 
 > **ملاحظة حول التفاعلية في Solid:**
-> في Solid، تعتبر `locale` بمثابة مخرج إشارة تفاعلية (reactive signal accessor) — استدعِها دائمًا كـ `locale()` للحصول على القيمة الحالية.
+> في Solid، تعتبر `locale` بمثابة مخرج إشارة تفاعلية (reactive signal accessor) - استدعِها دائمًا كـ `locale()` للحصول على القيمة الحالية.
 
 > **ملاحظة حول الاستمرارية:**
 > يضمن استخدام `onLocaleChange` لإعادة التوجيه عبر `window.location.href` زيارة الرابط الجديد للغة، مما يسمح لوسيط Intlayer بتعيين كوكيز اللغة وتذكر تفضيلات المستخدم في الزيارات المستقبلية.
 
-> يجب رندر `LocaleSwitcher` داخل `IntlayerProvider` — استخدمه داخل مكون الجزيرة الخاص بك (كما هو موضح في الخطوة 6).
+> يجب رندر `LocaleSwitcher` داخل `IntlayerProvider` - استخدمه داخل مكون الجزيرة الخاص بك (كما هو موضح في الخطوة 6).
 
 ### الخطوة 8: خريطة الموقع وRobots.txt
 

package/docs/ar/intlayer_with_astro_svelte.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_astro_vanilla.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_astro_vue.md

@@ -46,7 +46,7 @@ history:
 <iframe
   src="https://intlayer-astro-template.vercel.app"
   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="تجربة — intlayer-astro-template"
+  title="تجربة - intlayer-astro-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_nextjs_14.md

@@ -31,7 +31,7 @@ history:
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-next-14-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 - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -42,7 +42,7 @@ history:
 <iframe
   src="https://intlayer-next-14-template.vercel.app"
   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="تجربة — intlayer-next-14-template"
+  title="تجربة - intlayer-next-14-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_nextjs_15.md

@@ -43,7 +43,7 @@ history:
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-next-15-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 - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -54,7 +54,7 @@ history:
 <iframe
   src="https://next-15-intlayer-template-xt83.vercel.app"
   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="تجربة — intlayer-next-15-template"
+  title="تجربة - intlayer-next-15-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_nextjs_16.md

@@ -56,7 +56,7 @@ history:
 <iframe
   src="https://intlayer-next-16-template.vercel.app"
   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="تجربة — intlayer-next-16-template"
+  title="تجربة - intlayer-next-16-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_nextjs_page_router.md

@@ -38,7 +38,7 @@ history:
 <iframe
   src="https://ide.intlayer.org/aymericzip/intlayer-next-14-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 - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -49,7 +49,7 @@ history:
 <iframe
   src="https://intlayer-next-14-template.vercel.app"
   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="تجربة — intlayer-next-14-template"
+  title="تجربة - intlayer-next-14-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_nuxt.md

@@ -72,7 +72,7 @@ history:
 <iframe
   src="https://intlayer-nuxt-4-template.vercel.app"
   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="تجربة — intlayer-nuxt-4-template"
+  title="تجربة - intlayer-nuxt-4-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_react_native+expo.md

@@ -36,7 +36,7 @@ history:
 <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 - Intlayer"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />
@@ -47,7 +47,7 @@ history:
 <iframe
   src="https://intlayer-react-native.vercel.app"
   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="تجربة — intlayer-react-native-template"
+  title="تجربة - intlayer-react-native-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_react_router_v7.md

@@ -126,7 +126,7 @@ bun x intlayer init
 <iframe
   src="https://intlayer-react-router-v7.vercel.app"
   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="تجربة — intlayer-react-router-v7-template"
+  title="تجربة - intlayer-react-router-v7-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_react_router_v7_fs_routes.md

@@ -125,7 +125,7 @@ bun x intlayer init
 <iframe
   src="https://intlayer-react-router-v7.vercel.app"
   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="تجربة — intlayer-react-router-v7-template"
+  title="تجربة - intlayer-react-router-v7-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_storybook.md

@@ -2,7 +2,7 @@
 createdAt: 2026-03-20
 updatedAt: 2026-05-06
 title: كيفية إعداد Intlayer مع Storybook
-description: تعرف على كيفية جعل نظام التصميم الخاص بك متعدد اللغات باستخدام Intlayer مع Storybook — قم بتجميع إعلانات المحتوى، وإضافة مبدل اللغة، ومعاينة مكوناتك بأي لغة.
+description: تعرف على كيفية جعل نظام التصميم الخاص بك متعدد اللغات باستخدام Intlayer مع Storybook - قم بتجميع إعلانات المحتوى، وإضافة مبدل اللغة، ومعاينة مكوناتك بأي لغة.
 keywords:
   - تدويل
   - توثيق
@@ -33,7 +33,7 @@ history:
 
 ## ما هو Intlayer؟
 
-**Intlayer** هو مكتبة تدويل (i18n) مبتكرة ومفتوحة المصدر مصممة لتبسيط الدعم متعدد اللغات في تطبيقات الويب الحديثة. تعمل على **مستوى المكون** — حيث يمتلك كل مكون إعلانات المحتوى الخاصة به — مما يحافظ على الترجمات في نفس مكان الكود الذي يستخدمها.
+**Intlayer** هو مكتبة تدويل (i18n) مبتكرة ومفتوحة المصدر مصممة لتبسيط الدعم متعدد اللغات في تطبيقات الويب الحديثة. تعمل على **مستوى المكون** - حيث يمتلك كل مكون إعلانات المحتوى الخاصة به - مما يحافظ على الترجمات في نفس مكان الكود الذي يستخدمها.
 
 باستخدام Intlayer يمكنك:
 
@@ -83,9 +83,9 @@ bun add vite-intlayer --dev
 
 | الحزمة           | الدور                                                    |
 | ---------------- | -------------------------------------------------------- |
-| `intlayer`       | الأساس — التكوين، تجميع المحتوى، واجهة سطر الأوامر (CLI) |
-| `react-intlayer` | روابط React — `IntlayerProvider` و `useIntlayer` hook    |
-| `vite-intlayer`  | إضافة Vite — تراقب وتجمع ملفات إعلان المحتوى             |
+| `intlayer`       | الأساس - التكوين، تجميع المحتوى، واجهة سطر الأوامر (CLI) |
+| `react-intlayer` | روابط React - `IntlayerProvider` و `useIntlayer` hook    |
+| `vite-intlayer`  | إضافة Vite - تراقب وتجمع ملفات إعلان المحتوى             |
 
 ---
 
@@ -291,7 +291,7 @@ export default config;
 
 ### الخطوة 4: إضافة `IntlayerProvider` ومبدل اللغة في شريط الأدوات
 
-كما هو الحال في إعداد Vite — أضف الـ decorator ونوع اللغة العالمي في `.storybook/preview.tsx`:
+كما هو الحال في إعداد Vite - أضف الـ decorator ونوع اللغة العالمي في `.storybook/preview.tsx`:
 
 ```tsx fileName=".storybook/preview.tsx" codeFormat="typescript"
 import type { Preview, StoryContext } from "@storybook/react";
@@ -411,7 +411,7 @@ const meta: Meta<typeof CopyButton> = {
 export default meta;
 type Story = StoryObj<typeof CopyButton>;
 
-/** القصة الافتراضية — قم بتبديل اللغة في شريط الأدوات لمعاينة الترجمات. */
+/** القصة الافتراضية - قم بتبديل اللغة في شريط الأدوات لمعاينة الترجمات. */
 export const Default: Story = {
   args: {
     content: "npm install intlayer react-intlayer",

package/docs/ar/intlayer_with_svelte_kit.md

@@ -47,7 +47,7 @@ history:
 <iframe
   src="https://intlayer-sveltekit-template.vercel.app"
   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="تجربة — intlayer-sveltekit-template"
+  title="تجربة - intlayer-sveltekit-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_tanstack+solid.md

@@ -75,7 +75,7 @@ history:
 <iframe
   src="https://intlayer-tanstack-start-solid.vercel.app"
   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="تجربة — intlayer-tanstack-start-solid-template"
+  title="تجربة - intlayer-tanstack-start-solid-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />

package/docs/ar/intlayer_with_tanstack.md

@@ -92,7 +92,7 @@ history:
 <iframe
   src="https://intlayer-tanstack-start-template.vercel.app"
   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="تجربة — intlayer-tanstack-start-template"
+  title="تجربة - intlayer-tanstack-start-template"
   sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
   loading="lazy"
 />