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

package/docs/ar/formatters.md

@@ -400,6 +400,8 @@ date(new Date(), "short"); // على سبيل المثال، "08/02/25, 14:30"
 date("2025-08-02T14:30:00Z", { locale: "fr", month: "long", day: "numeric" }); // "2 août"
 ```
 
+### ميزات Intl إضافية
+
 ### `relativeTime(from, to = new Date(), options?)`
 
 يقوم بتنسيق الوقت النسبي بين لحظتين باستخدام `Intl.RelativeTimeFormat`.
@@ -457,6 +459,8 @@ compact(1200); // "1.2K"
 compact("1000000", { locale: "fr", compactDisplay: "long" }); // "1 million"
 ```
 
+## أدوات المناطق الإقليمية
+
 ### `list(values, options?)`
 
 يقوم بتنسيق مصفوفة من القيم إلى سلسلة قائمة محلية باستخدام `Intl.ListFormat`.
@@ -476,12 +480,45 @@ list(["red", "green", "blue"], { locale: "fr", type: "disjunction" }); // "rouge
 list([1, 2, 3], { type: "unit" }); // "1, 2, 3"
 ```
 
+### `getLocaleLang(locale?)`
+
+استخراج رمز اللغة من سلسلة نصية للإعدادات المحلية:
+
+```ts
+import { getLocaleLang } from "intlayer";
+
+getLocaleLang("en-US"); // "en"
+getLocaleLang("fr-CA"); // "fr"
+```
+
 ## ملاحظات
 
 - جميع الأدوات المساعدة تقبل مدخلات من نوع `string`؛ حيث يتم تحويلها داخليًا إلى أرقام أو تواريخ.
 - اللغة الافتراضية هي `internationalization.defaultLocale` التي قمت بتكوينها إذا لم يتم توفير لغة.
 - هذه الأدوات هي أغلفة رقيقة؛ للتنسيق المتقدم، استخدم خيارات `Intl` القياسية.
 
+### `getPathWithoutLocale(inputUrl, locales?)`
+
+يزيل جزء اللغة من عنوان URL:
+
+```ts
+import { getPathWithoutLocale } from "intlayer";
+
+getPathWithoutLocale("/en/dashboard"); // "/dashboard"
+getPathWithoutLocale("/fr/dashboard"); // "/dashboard"
+```
+
+### `getLocalizedUrl(url, currentLocale, locales?, defaultLocale?, prefixDefault?)`
+
+ينشئ عنوان URL موطن:
+
+```ts
+import { getLocalizedUrl } from "intlayer";
+
+getLocalizedUrl("/about", "fr", ["en", "fr"], "en", false); // "/fr/about"
+getLocalizedUrl("/about", "en", ["en", "fr"], "en", false); // "/about"
+```
+
 ## نقاط الدخول وإعادة التصدير (`@index.ts`)
 
 تعيش أدوات التنسيق في الحزمة الأساسية ويتم إعادة تصديرها من الحزم الأعلى للحفاظ على سهولة الاستيراد عبر بيئات التشغيل المختلفة:
@@ -512,6 +549,8 @@ import {
 } from "intlayer";
 ```
 
+## أدوات معالجة المحتوى
+
 ### React
 
 مكونات العميل:
@@ -592,6 +631,20 @@ import {
 
 > ستأخذ هذه الخطافات في الاعتبار اللغة من `IntlayerProvider` أو `IntlayerServerProvider`
 
+### `getTranslation(languageContent, locale?, fallback?)`
+
+استخراج المحتوى لمحلية معينة:
+
+```ts
+import { getTranslation } from "intlayer";
+
+const content = getTranslation(
+  { ar: "مرحبا", en: "Hello", fr: "Bonjour", de: "Hallo" },
+  "fr",
+  true
+); // "Bonjour"
+```
+
 ### Vue
 
 مكونات العميل:
@@ -610,3 +663,9 @@ import {
 ```
 
 > ستأخذ هذه التركيبات في الاعتبار اللغة من `IntlayerProvider` المحقون
+
+## ملاحظات
+
+- جميع المساعدات تقبل مدخلات `string`؛ يتم تحويلها داخليًا إلى أرقام أو تواريخ.
+- يتم تعيين اللغة الافتراضية إلى `internationalization.defaultLocale` المُكوّن لديك في حالة عدم توفيره.
+- هذه الأدوات عبارة عن أغلفة رقيقة؛ للتنسيق المتقدم، قم بتمرير خيارات `Intl` القياسية.

package/docs/ar/how_works_intlayer.md

@@ -22,6 +22,10 @@ author: aymericzip
 
 # كيف يعمل Intlayer
 
+## جدول المحتويات
+
+<TOC/>
+
 ## نظرة عامة
 
 الفكرة الرئيسية وراء Intlayer هي تبني إدارة المحتوى لكل مكون على حدة. لذا الفكرة وراء Intlayer هي السماح لك بإعلان المحتوى الخاص بك في أي مكان في قاعدة الكود الخاصة بك، كما في نفس الدليل مثل المكون الخاص بك.

package/docs/ar/interest_of_intlayer.md

@@ -30,6 +30,10 @@ author: aymericzip
 
 # لماذا يجب عليك التفكير في Intlayer؟
 
+## ما هو Intlayer؟
+
+**Intlayer** هي مكتبة internationalization مصممة خصيصًا لمطوري JavaScript. تسمح بإعلان محتواك في أي مكان في الكود الخاص بك. تحول إعلانات المحتوى متعدد اللغات إلى قواميس منظمة يمكن دمجها بسهولة في الكود الخاص بك. باستخدام TypeScript، تجعل **Intlayer** تطويرك أقوى وأكثر كفاءة.
+
 ## لماذا Intlayer على البدائل؟
 
 بالمقارنة مع الحلول الرئيسية مثل `next-intl` أو `i18next`، يعد Intlayer حلاً يأتي مزودًا بتحسينات متكاملة مثل:
@@ -68,6 +72,195 @@ author: aymericzip
 
 ---
 
+## لماذا تم إنشاء Intlayer؟
+
+تم إنشاء Intlayer لحل مشكلة شائعة تؤثر على جميع مكتبات i18n الشائعة مثل `next-intl`، `react-i18next`، `react-intl`، `next-i18next`، `react-intl`، و `vue-i18n`.
+
+جميع هذه الحلول تعتمد على نهج مركزي لعرض وإدارة محتواك. على سبيل المثال:
+
+```bash
+.
+├── locales
+│   ├── en.json
+│   ├── es.json
+│   └── fr.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+أو هنا باستخدام namespaces:
+
+```bash
+.
+├── locales
+│   ├── en
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   ├── fr
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   └── es
+│      ├── footer.json
+│      └── navbar.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+يؤدي هذا النوع من المعمارية إلى إبطاء عملية التطوير وجعل codebase أكثر تعقيداً للحفاظ عليه لعدة أسباب:
+
+1. **لأي مكون جديد تقوم بإنشاؤه، يجب عليك:**
+   - إنشاء مورد/namespace جديد في مجلد `locales`
+   - تذكر استيراد namespace الجديد في صفحتك
+   - ترجمة محتواك (غالباً ما يتم يدويًا عبر النسخ واللصق من موفري الذكاء الاصطناعي)
+
+2. **لأي تغيير تجريه على مكوناتك، يجب عليك:**
+   - البحث عن المورد/namespace المرتبط (بعيد عن المكون)
+   - ترجمة محتواك
+   - التأكد من أن محتواك محدّث لأي لغة
+   - التحقق من عدم تضمن namespace الخاص بك مفاتيح/قيم غير مستخدمة
+   - التأكد من أن بنية ملفات JSON الخاصة بك متطابقة لجميع اللغات
+
+في المشاريع الاحترافية التي تستخدم هذه الحلول، غالباً ما تُستخدم منصات التوطين (localization) للمساعدة في إدارة ترجمة محتواك. ومع ذلك، يمكن أن يصبح هذا مكلفاً بسرعة للمشاريع الكبيرة.
+
+لحل هذه المشكلة، يعتمد Intlayer على نهج يحدد نطاق محتواك لكل مكون ويحافظ على محتواك قريباً من مكونك، كما نفعل غالباً مع CSS (`styled-components`)، الأنواع (types)، التوثيق (`storybook`)، أو اختبارات الوحدة (`jest`).
+
+```bash codeFormat="typescript"
+.
+└── components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.test.tsx
+        ├── index.stories.tsx
+        └── index.tsx
+```
+
+```bash codeFormat="commonjs"
+.
+└── components
+    └── MyComponent
+        ├── index.content.cjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
+```
+
+```bash codeFormat="esm"
+.
+└── components
+    └── MyComponent
+        ├── index.content.mjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
+```
+
+```tsx fileName="./components/MyComponent/index.content.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      ar: "مرحبا بالعالم",
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentExampleContent;
+```
+
+```tsx fileName="./components/MyComponent/index.tsx" codeFormat={["typescript", "esm"]}
+import { useIntlayer } from "react-intlayer";
+
+export const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+يتيح لك هذا النهج:
+
+1. **زيادة سرعة التطوير**
+   - يمكن إنشاء ملفات `.content.{{ts|mjs|cjs|json}}` باستخدام امتداد VSCode
+   - أدوات إكمال الذكاء الاصطناعي في محررك (مثل GitHub Copilot) يمكنها مساعدتك في التصريح عن محتواك، مما يقلل النسخ واللصق
+
+2. **تنظيف codebase الخاص بك**
+   - تقليل التعقيد
+   - زيادة قابلية الصيانة
+
+3. **نسخ مكوناتك والمحتوى المرتبط بها بسهولة أكبر (مثال: مكونات تسجيل الدخول/التسجيل، إلخ)**
+   - عن طريق تحديد خطر التأثير على محتوى المكونات الأخرى
+   - عن طريق نسخ ولصق محتواك من تطبيق إلى آخر بدون تبعيات خارجية
+
+4. **تجنب تلويث codebase الخاص بك بمفاتيح/قيم غير مستخدمة للمكونات غير المستخدمة**
+   - إذا لم تستخدم مكوناً، فلن يستورد Intlayer المحتوى المرتبط به
+   - إذا حذفت مكوناً، ستتذكر بسهولة أكبر إزالة المحتوى المرتبط به حيث سيكون موجوداً في نفس المجلد
+
+5. **تقليل تكلفة الاستدلال لوكلاء الذكاء الاصطناعي للتصريح عن محتواك متعدد اللغات**
+   - لن يضطر وكيل الذكاء الاصطناعي إلى مسح codebase الخاص بك بالكامل لمعرفة مكان تطبيق محتواك
+   - يمكن إجراء الترجمات بسهولة من خلال أدوات إكمال الذكاء الاصطناعي في محررك (مثل GitHub Copilot)
+
+6. **تحسين أداء التحميل**
+   - إذا تم تحميل مكون بشكل كسول (lazy-loaded)، فسيتم تحميل المحتوى المرتبط به في نفس الوقت
+
+## الميزات الإضافية لـ Intlayer
+
+| Feature                                                                                                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                            |
+| ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **دعم الأطر المتقاطعة**<br><br>Intlayer متوافق مع جميع الأطر والمكتبات الرئيسية، بما في ذلك Next.js و React و Vite و Vue.js و Nuxt و Preact و Express والمزيد.                                                                                                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **إدارة المحتوى المدعومة بـ JavaScript**<br><br>استفد من مرونة JavaScript لتحديد وإدارة المحتوى الخاص بك بكفاءة. <br><br> - [إعلان المحتوى](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                  |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **المترجم**<br><br>يستخرج مترجم Intlayer المحتوى تلقائياً من المكونات وينشئ ملفات القاموس.<br><br> - [المترجم](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **ملف إعلان المحتوى لكل لغة**<br><br>سرّع التطوير الخاص بك بإعلان المحتوى مرة واحدة، قبل الإنشاء التلقائي.<br><br> - [ملف إعلان المحتوى لكل لغة](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **بيئة آمنة من حيث النوع**<br><br>استفد من TypeScript لضمان خلو تعريفات المحتوى والكود من الأخطاء، مع الاستفادة أيضاً من إكمال تلقائي IDE.<br><br> - [تكوين TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                      |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **إعداد مبسط**<br><br>ابدأ بسرعة مع الحد الأدنى من الإعدادات. اضبط الإعدادات للدولية والتوجيه والذكاء الاصطناعي والبناء والمحتوى بسهولة. <br><br> - [استكشف تكامل Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **استرجاع المحتوى المبسط**<br><br>لا حاجة لاستدعاء دالة `t` الخاصة بك لكل جزء من المحتوى. استرجع كل المحتوى الخاص بك مباشرة باستخدام hook واحد.<br><br> - [تكامل React](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **تطبيق مكون الخادم المتسق**<br><br>مناسب تماماً لمكونات خادم Next.js، استخدم نفس التطبيق لكل من مكونات العميل والخادم، لا حاجة لتمرير دالة `t` عبر كل مكون خادم. <br><br> - [مكونات الخادم](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                                          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **قاعدة أكواد منظمة**<br><br>حافظ على قاعدة الأكواد الخاصة بك منظمة أكثر: 1 مكون = 1 قاموس في نفس المجلد. الترجمات القريبة من مكوناتها الخاصة تحسن الصيانة والوضوح. <br><br> - [كيف يعمل Intlayer](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **التوجيه المحسّن**<br><br>دعم كامل لتوجيه التطبيق، والتكيف بسلاسة مع الهياكل المعقدة للتطبيق، لـ Next.js و React و Vite و Vue.js وغيرها.<br><br> - [استكشف تكامل Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **دعم Markdown**<br><br>استيراد وتفسير ملفات اللغة والمحتوى البعيد Markdown للمحتوى متعدد اللغات مثل سياسات الخصوصية والتوثيق وغيرها. فسّر واجعل بيانات وصف Markdown متاحة في الكود الخاص بك.<br><br> - [ملفات المحتوى](https://intlayer.org/doc/concept/content/file)                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **محرر مرئي مجاني وCMS**<br><br>محرر مرئي مجاني وCMS متاحان لكتاب المحتوى، مما يزيل الحاجة إلى منصة توطين. حافظ على تزامن المحتوى باستخدام Git، أو قم بإضفاء الطابع الخارجي عليه بشكل كامل أو جزئي مع CMS.<br><br> - [محرر Intlayer](https://intlayer.org/doc/concept/editor) <br> - [CMS Intlayer](https://intlayer.org/doc/concept/cms)                                                                              |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **محتوى قابل للاستبدال**<br><br>محتوى قابل للاستبدال، مما يقلل من حجم الحزمة النهائية. تحميل المحتوى لكل مكون، مع استبعاد أي محتوى غير مستخدم من الحزمة الخاصة بك. يدعم التحميل البطيء لتحسين كفاءة تحميل التطبيق. <br><br> - [تحسين بناء التطبيق](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                         |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **العرض الثابت**<br><br>لا يمنع العرض الثابت. <br><br> - [تكامل Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **الترجمة المدعومة بالذكاء الاصطناعي**<br><br>حوّل موقعك الإلكتروني إلى 231 لغة بنقرة واحدة باستخدام أدوات الترجمة المتقدمة المدعومة بالذكاء الاصطناعي من Intlayer باستخدام مفتاح API/موفر الذكاء الاصطناعي الخاص بك. <br><br> - [تكامل CI/CD](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [الملء التلقائي](https://intlayer.org/doc/concept/auto-fill) |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **تكامل خادم MCP**<br><br>يوفر خادم MCP (Model Context Protocol) لأتمتة IDE، مما يتيح إدارة محتوى وسير عمل i18n بسلاسة مباشرة في بيئة التطوير الخاصة بك. <br><br> - [خادم MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/mcp_server.md)                                                                                                                                                            |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **امتداد VSCode**<br><br>يوفر Intlayer امتداد VSCode لمساعدتك في إدارة المحتوى والترجمات وبناء القواميس وترجمة المحتوى والمزيد. <br><br> - [امتداد VSCode](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **التشغيل المتبادل**<br><br>يسمح بالتشغيل المتبادل مع react-i18next و next-i18next و next-intl و react-intl. <br><br> - [Intlayer و react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer و next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer و next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)                                            |
+| اختبار الترجمات المفقودة (CLI/CI)                                                                                         | ✅ CLI: npx intlayer content test (CI-friendly audit)                                                                                                                                                                                                                                                                                                                                                                  |
+
+## مقارنة Intlayer مع الحلول الأخرى
+
+| الميزة                                        | `intlayer`                                                                                                                          | `react-i18next`                                                                              | `react-intl` (FormatJS)                                                                                         | `lingui`                                                  | `next-intl`                                                                                  | `next-i18next`                                                                               | `vue-i18n`                                                         |
+| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| **الترجمات بالقرب من المكونات**               | ✅ نعم، المحتوى متجاور مع كل مكون                                                                                                   | ❌ لا                                                                                        | ❌ لا                                                                                                           | ❌ لا                                                     | ❌ لا                                                                                        | ❌ لا                                                                                        | ✅ نعم - باستخدام `Single File Components` (SFCs)                  |
+| **تكامل TypeScript**                          | ✅ متقدم، أنواع صارمة تم إنشاؤها تلقائياً                                                                                           | ⚠️ أساسي؛ إعدادات إضافية للأمان                                                              | ✅ جيد، لكن أقل صرامة                                                                                           | ⚠️ الأنواع، يحتاج إعدادات                                 | ✅ جيد                                                                                       | ⚠️ أساسي                                                                                     | ✅ جيد (الأنواع متاحة؛ سلامة المفاتيح تحتاج إعدادات)               |
+| **كشف الترجمات المفقودة**                     | ✅ خطأ TypeScript وتحذير/خطأ وقت البناء                                                                                             | ⚠️ في الغالب سلاسل احتياطية في وقت التشغيل                                                   | ⚠️ سلاسل احتياطية                                                                                               | ⚠️ يحتاج إعدادات إضافية                                   | ⚠️ احتياطي في وقت التشغيل                                                                    | ⚠️ احتياطي في وقت التشغيل                                                                    | ⚠️ احتياطي/تحذيرات في وقت التشغيل (قابلة للتكوين)                  |
+| **المحتوى الغني (JSX/Markdown/المكونات)**     | ✅ دعم مباشر                                                                                                                        | ⚠️ محدود / الاستيفاء فقط                                                                     | ⚠️ بناء جملة ICU، ليس JSX حقيقي                                                                                 | ⚠️ محدود                                                  | ❌ غير مصمم للعقد الغنية                                                                     | ⚠️ محدود                                                                                     | ⚠️ محدود (المكونات عبر `<i18n-t>`، Markdown عبر المكونات الإضافية) |
+| **الترجمة المدعومة بالذكاء الاصطناعي**        | ✅ نعم، يدعم موفرين ذكاء اصطناعي متعددين. قابل للاستخدام باستخدام مفاتيح API الخاصة بك. يأخذ في الاعتبار سياق التطبيق ونطاق المحتوى | ❌ لا                                                                                        | ❌ لا                                                                                                           | ❌ لا                                                     | ❌ لا                                                                                        | ❌ لا                                                                                        | ❌ لا                                                              |
+| **محرر مرئي**                                 | ✅ نعم، محرر مرئي محلي + CMS اختياري؛ يمكن تخارج محتوى codebase؛ قابل للتضمين                                                       | ❌ لا / متاح عبر منصات التوطين الخارجية                                                      | ❌ لا / متاح عبر منصات التوطين الخارجية                                                                         | ❌ لا / متاح عبر منصات التوطين الخارجية                   | ❌ لا / متاح عبر منصات التوطين الخارجية                                                      | ❌ لا / متاح عبر منصات التوطين الخارجية                                                      | ❌ لا / متاح عبر منصات التوطين الخارجية                            |
+| **التوجيه المترجم**                           | ✅ نعم، يدعم المسارات المترجمة في الوقت الفعلي (يعمل مع Next.js و Vite)                                                             | ⚠️ لا يوجد دعم مدمج، يتطلب مكونات إضافية (مثل `next-i18next`) أو إعدادات موجه مخصصة          | ❌ لا، فقط تنسيق الرسالة، يجب أن يكون التوجيه يدوياً                                                            | ⚠️ لا يوجد دعم مدمج، يتطلب مكونات إضافية أو إعدادات يدوية | ✅ مدمج، App Router يدعم قطاع `[locale]`                                                     | ✅ مدمج                                                                                      | ✅ مدمج                                                            |
+| **توليد المسار الديناميكي**                   | ✅ نعم                                                                                                                              | ⚠️ مكون إضافي/نظام بيئي أو إعدادات يدوية                                                     | ❌ غير مقدم                                                                                                     | ⚠️ مكون إضافي/يدوي                                        | ✅ نعم                                                                                       | ✅ نعم                                                                                       | ❌ غير مقدم (Nuxt i18n يوفره)                                      |
+| **الجمع بين الكلمات**                         | ✅ أنماط قائمة على التعداد                                                                                                          | ✅ قابلة للتكوين (مكونات إضافية مثل i18next-icu)                                             | ✅ (ICU)                                                                                                        | ✅ (ICU/messageformat)                                    | ✅ جيد                                                                                       | ✅ جيد                                                                                       | ✅ قواعد جمع مدمجة                                                 |
+| **التنسيق (التواريخ والأرقام والعملات)**      | ✅ منسقات محسّنة (Intl تحت الغطاء)                                                                                                  | ⚠️ عبر مكونات إضافية أو استخدام Intl مخصص                                                    | ✅ منسقات ICU                                                                                                   | ✅ مساعدات ICU/CLI                                        | ✅ جيد (مساعدات Intl)                                                                        | ✅ جيد (مساعدات Intl)                                                                        | ✅ منسقات التاريخ/الرقم المدمجة (Intl)                             |
+| **صيغة المحتوى**                              | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml WIP)                                                                                    | ⚠️ .json                                                                                     | ✅ .json, .js                                                                                                   | ⚠️ .po, .json                                             | ✅ .json, .js, .ts                                                                           | ⚠️ .json                                                                                     | ✅ .json, .js                                                      |
+| **دعم ICU**                                   | ⚠️ قيد الإنجاز                                                                                                                      | ⚠️ عبر مكون إضافي (i18next-icu)                                                              | ✅ نعم                                                                                                          | ✅ نعم                                                    | ✅ نعم                                                                                       | ⚠️ عبر مكون إضافي (`i18next-icu`)                                                            | ⚠️ عبر منسق/محول مخصص                                              |
+| **مساعدات SEO (hreflang وخريطة الموقع)**      | ✅ أدوات مدمجة: مساعدات لخريطة الموقع وrobots.txt والبيانات الوصفية                                                                 | ⚠️ مكونات إضافية/يدوية المجتمع                                                               | ❌ ليس أساسياً                                                                                                  | ❌ ليس أساسياً                                            | ✅ جيد                                                                                       | ✅ جيد                                                                                       | ❌ ليس أساسياً (Nuxt i18n يوفر مساعدات)                            |
+| **النظام البيئي / المجتمع**                   | ⚠️ أصغر ولكن ينمو بسرعة واستجابة                                                                                                    | ✅ الأكبر والأكثر نضجاً                                                                      | ✅ كبير                                                                                                         | ⚠️ أصغر                                                   | ✅ متوسط، يركز على Next.js                                                                   | ✅ متوسط، يركز على Next.js                                                                   | ✅ كبير في نظام Vue البيئي                                         |
+| **العرض من جانب الخادم ومكونات الخادم**       | ✅ نعم، مبسط لـ SSR / React Server Components                                                                                       | ⚠️ مدعوم على مستوى الصفحة ولكن يحتاج إلى تمرير دوال t على شجرة المكونات لمكونات خادم الأطفال | ⚠️ مدعوم على مستوى الصفحة مع إعدادات إضافية، ولكن يحتاج إلى تمرير دوال t على شجرة المكونات لمكونات خادم الأطفال | ✅ مدعوم، إعدادات مطلوبة                                  | ⚠️ مدعوم على مستوى الصفحة ولكن يحتاج إلى تمرير دوال t على شجرة المكونات لمكونات خادم الأطفال | ⚠️ مدعوم على مستوى الصفحة ولكن يحتاج إلى تمرير دوال t على شجرة المكونات لمكونات خادم الأطفال | ✅ SSR عبر Nuxt/Vue SSR (لا يوجد RSC)                              |
+| **Tree-shaking (تحميل المحتوى المستخدم فقط)** | ✅ نعم، لكل مكون في وقت البناء عبر مكونات Babel/SWC إضافية                                                                          | ⚠️ عادة ما يحمل الكل (يمكن تحسينه باستخدام namespaces/code-splitting)                        | ⚠️ عادة ما يحمل الكل                                                                                            | ❌ ليس الافتراضي                                          | ⚠️ جزئي                                                                                      | ⚠️ جزئي                                                                                      | ⚠️ جزئي (مع code-splitting/إعدادات يدوية)                          |
+| **التحميل الكسول**                            | ✅ نعم، لكل locale / لكل قاموس                                                                                                      | ✅ نعم (مثل backends/namespaces عند الطلب)                                                   | ✅ نعم (تقسيم حزم locale)                                                                                       | ✅ نعم (استيراد فهرس ديناميكي)                            | ✅ نعم (لكل مسار/لكل locale)، يحتاج إدارة mamespace                                          | ✅ نعم (لكل مسار/لكل locale)، يحتاج إدارة mamespace                                          | ✅ نعم (رسائل locale غير متزامنة)                                  |
+| **تنظيف المحتوى المستخدم**                    | ✅ نعم، لكل قاموس في وقت البناء                                                                                                     | ❌ لا، فقط عبر تجزئة namespace يدوية                                                         | ❌ لا، يتم تجميع جميع الرسائل المعلنة                                                                           | ✅ نعم، تم كشف المفاتيح غير المستخدمة وإسقاطها في البناء  | ❌ لا، يمكن إدارتها يدوياً باستخدام إدارة namespace                                          | ❌ لا، يمكن إدارتها يدوياً باستخدام إدارة namespace                                          | ❌ لا، ممكن فقط عبر التحميل الكسول اليدوي                          |
+| **إدارة المشاريع الكبيرة**                    | ✅ تشجع المعيارية، مناسب لـ design-system                                                                                           | ⚠️ يحتاج انضباط ملفات جيد                                                                    | ⚠️ يمكن أن تصبح الفهارس المركزية كبيرة                                                                          | ⚠️ قد تصبح معقدة                                          | ✅ معيارية مع الإعدادات                                                                      | ✅ معيارية مع الإعدادات                                                                      | ✅ معيارية مع إعدادات Vue Router/Nuxt i18n                         |
+
 ## نجوم GitHub
 
 تعد نجوم GitHub مؤشرًا قويًا على شعبية المشروع وثقة المجتمع وأهميته على المدى الطويل. على الرغم من أنها ليست مقياسًا مباشرًا للجودة التقنية، إلا أنها تعكس عدد المطورين الذين يجدون المشروع مفيدًا ويتابعون تقدمه ومن المحتمل أن يتبنوه. لتقدير قيمة المشروع، تساعد النجوم في مقارنة الجاذبية عبر البدائل وتوفر رؤى حول نمو النظام البيئي.

package/docs/ar/intlayer_CMS.md

@@ -40,6 +40,12 @@ author: aymericzip
 
 ![واجهة نظام إدارة المحتوى Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png)
 
+## جدول المحتويات
+
+<TOC/>
+
+---
+
 ## فهم القواميس البعيدة
 
 يفرق Intlayer بين القواميس "المحلية" و"البعيدة".

package/docs/ar/intlayer_with_astro.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:
@@ -299,7 +299,134 @@ const { title } = getIntlayer('app');
 
 </Step>
 
-<Step number={7} title="استمر في استخدام إطارات العمل المفضلة لديك">
+<Step number={7} title="إضافة مبدل اللغة">
+
+للسماح للمستخدمين بالتبديل بين اللغات، يمكنك إنشاء مكون `LocaleSwitcher`. يجب أن يعرض هذا المكون قائمة بجميع اللغات المدعومة ورابطًا لنفس الصفحة بكل لغة.
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import {
+  locales,
+  getLocaleName,
+  getLocalizedUrl,
+  getLocaleFromPath,
+  getPathWithoutLocale,
+  type LocalesValues,
+} from "intlayer";
+
+const locale = getLocaleFromPath(Astro.url.pathname) as LocalesValues;
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<nav>
+  {
+    locales.map((localeItem) => (
+      <a
+        href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+        data-locale={localeItem}
+        aria-current={localeItem === locale ? "page" : undefined}
+      >
+        {getLocaleName(localeItem)}
+      </a>
+    ))
+  }
+</nav>
+
+<script>
+  import { setLocaleInStorageClient, getLocalizedUrl, type LocalesValues } from "intlayer";
+
+  const localeLinks = document.querySelectorAll("[data-locale]");
+
+  localeLinks.forEach((link) => {
+    link.addEventListener("click", (e) => {
+      const locale = link.getAttribute("data-locale") as LocalesValues;
+
+      // Update the locale cookie
+      setLocaleInStorageClient(locale);
+    });
+  });
+</script>
+
+<style>
+  nav {
+    display: flex;
+    gap: 1rem;
+  }
+  a[aria-current="page"] {
+    font-weight: bold;
+    text-decoration: underline;
+  }
+</style>
+```
+
+> **ملاحظة حول الاستمرارية:**
+> يضمن استخدام `setLocaleInStorageClient` في السكريبت الخاص بالعميل حفظ تفضيل اللغة للمستخدم في ملف تعريف الارتباط (cookie). يتيح ذلك لبرمجية Intlayer الوسيطة تذكر الاختيار وتوجيه المستخدم تلقائيًا إلى لغته المفضلة في الزيارات المستقبلية.
+
+</Step>
+
+<Step number={8} title="خريطة الموقع وRobots.txt">
+
+توفر Intlayer أدوات لإنشاء خريطة موقع مترجمة وملفات robots.txt ديناميكيًا.
+
+#### خريطة الموقع (Sitemap)
+
+Intlayer comes with a built-in sitemap generator to help you create a sitemap for your application easily. It handles localized routes and adds the necessary metadata for search engines.
+
+> The Intlayer generated sitemap supports the `xhtml:link` namespace (Hreflang XML Extensions). Unlike the default sitemap generators that only list raw URLs, Intlayer automatically creates the required bidirectional links between all language versions of a page (e.g., `/about`, `/about?lang=fr`, and `/about?lang=es`). This ensures search engines correctly index and serve the right language version to the right audience.
+
+أنشئ `src/pages/sitemap.xml.ts` لإنشاء خريطة موقع تتضمن جميع مساراتك المترجمة.
+
+```typescript fileName="src/pages/sitemap.xml.ts"
+import type { APIRoute } from "astro";
+import { generateSitemap, type SitemapUrlEntry } from "intlayer";
+
+const pathList: SitemapUrlEntry[] = [
+  { path: "/", changefreq: "daily", priority: 1.0 },
+  { path: "/about", changefreq: "monthly", priority: 0.7 },
+];
+
+const SITE_URL = import.meta.env.SITE ?? "http://localhost:4321";
+
+export const GET: APIRoute = async ({ site }) => {
+  const xmlOutput = generateSitemap(pathList, { siteUrl: SITE_URL });
+
+  return new Response(xmlOutput, {
+    headers: { "Content-Type": "application/xml" },
+  });
+};
+```
+
+#### Robots.txt
+
+أنشئ `src/pages/robots.txt.ts` للتحكم في زحف محركات البحث.
+
+```typescript fileName="src/pages/robots.txt.ts"
+import type { APIRoute } from "astro";
+import { getMultilingualUrls } from "intlayer";
+
+const getAllMultilingualUrls = (urls: string[]) =>
+  urls.flatMap((url) => Object.values(getMultilingualUrls(url)) as string[]);
+
+const disallowedPaths = getAllMultilingualUrls(["/admin", "/private"]);
+
+export const GET: APIRoute = ({ site }) => {
+  const robotsTxt = [
+    "User-agent: *",
+    "Allow: /",
+    ...disallowedPaths.map((path) => `Disallow: ${path}`),
+    "",
+    `Sitemap: ${new URL("/sitemap.xml", site).href}`,
+  ].join("\n");
+
+  return new Response(robotsTxt, {
+    headers: { "Content-Type": "text/plain" },
+  });
+};
+```
+
+</Step>
+
+<Step number={9} title="استمر في استخدام إطارات العمل المفضلة لديك">
 
 استمر في بناء تطبيقك باستخدام إطار العمل الذي تختاره.
 

package/docs/ar/intlayer_with_astro_lit.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro + Lit - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro + Lit متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:

package/docs/ar/intlayer_with_astro_preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro + Preact - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro + Preact متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:

package/docs/ar/intlayer_with_astro_react.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro + React - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro + React متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:

package/docs/ar/intlayer_with_astro_solid.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro + Solid - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro + Solid متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:

package/docs/ar/intlayer_with_astro_svelte.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro + Svelte - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro + Svelte متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:

package/docs/ar/intlayer_with_astro_vanilla.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro + Vanilla JS - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro + Vanilla JS متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:

package/docs/ar/intlayer_with_astro_vue.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "تدويل Astro + Vue - الدليل الكامل لترجمة تطبيقك"
 description: "لا مزيد من i18next. دليل 2026 لبناء تطبيق Astro + Vue متعدد اللغات (i18n). ترجم باستخدام وكلاء الذكاء الاصطناعي وحسّن حجم الحزمة وتحسين محركات البحث والأداء."
 keywords:

package/docs/ar/intlayer_with_create_react_app.md

@@ -737,20 +737,6 @@ export default App;
 
 لمزيد من التفاصيل حول كيفية استخدام الامتداد، راجع [توثيق امتداد Intlayer لـ VS Code](https://intlayer.org/doc/vs-code-extension).
 
-### التعمق أكثر
-
-للتعمق أكثر، يمكنك تنفيذ [المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md) أو نقل المحتوى الخاص بك باستخدام [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md).
-[التثبيت من سوق VS Code](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
-
-تقدم هذه الإضافة:
-
-- **الإكمال التلقائي** لمفاتيح الترجمة.
-- **الكشف الفوري عن الأخطاء** للترجمات المفقودة.
-- **معاينات داخلية** للمحتوى المترجم.
-- **إجراءات سريعة** لإنشاء الترجمات وتحديثها بسهولة.
-
-لمزيد من التفاصيل حول كيفية استخدام الإضافة، راجع [توثيق إضافة Intlayer لـ VS Code](https://intlayer.org/doc/vs-code-extension).
-
 ### التوسع أكثر
 
 للتوسع أكثر، يمكنك تنفيذ [المحرر المرئي](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md) أو إخراج المحتوى الخاص بك باستخدام [نظام إدارة المحتوى (CMS)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md).