@intlayer/docs 9.0.0-canary.10 → 9.0.0-canary.12

package/docs/ar/intlayer_with_vite+react_compiler.md

@@ -36,7 +36,7 @@ author: aymericzip
 
 <Tabs defaultTab="video">
   <Tab label="فيديو" value="video">
-  
+
 <iframe title="أفضل حل i18n لـ Vite و React؟ اكتشف Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?si=VaKmrYMmXjo3xpk2"/>
 
   </Tab>
@@ -100,19 +100,23 @@ author: aymericzip
 ثبّت الحزم اللازمة باستخدام npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.

package/docs/ar/intlayer_with_vite+solid.md

@@ -32,7 +32,7 @@ author: aymericzip
 
 <Tabs defaultTab="video">
   <Tab label="Video" value="video">
-  
+
 <iframe title="The best i18n solution for Vite and Solid? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/dS9L7uJeak4?si=VaKmrYMmXjo3xpk2"/>
 
   </Tab>
@@ -104,19 +104,23 @@ author: aymericzip
 قم بتثبيت الحزم اللازمة باستخدام npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.

package/docs/ar/intlayer_with_vite+svelte.md

@@ -116,19 +116,23 @@ author: aymericzip
 قم بتثبيت الحزم اللازمة باستخدام npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.

package/docs/ar/intlayer_with_vite+vanilla.md

@@ -102,19 +102,23 @@ author: aymericzip
 قم بتثبيت الحزم اللازمة باستخدام npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.

package/docs/ar/intlayer_with_vite+vue.md

@@ -76,7 +76,7 @@ author: aymericzip
 
 <Tabs defaultTab="video">
   <Tab label="فيديو" value="video">
-  
+
 <iframe title="The best i18n solution for Vite and Vue? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/IE3XWkZ6a5U?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
@@ -113,19 +113,23 @@ author: aymericzip
 قم بتثبيت الحزم اللازمة باستخدام npm:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > علامة `--interactive` اختيارية. استخدم `intlayer-cli init` إذا كنت وكيل ذكاء اصطناعي.

package/docs/ar/migration_from_i18next_to_intlayer.md

@@ -99,19 +99,23 @@ Intlayer أيضاً هو الحل ذو **التطوير الأكثر نشاطا
 قم بتثبيت حزم Intlayer الأساسية ومحول التوافق:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > العلم `--interactive` اختياري. استخدم `intlayer-cli init` إذا كنت وكيل ذكي.

package/docs/ar/migration_from_next-i18next_to_intlayer.md

@@ -102,19 +102,23 @@ Intlayer هو أيضًا الحل الذي يتمتع بـ **أنشط تطور**
 قم بتثبيت حزم Intlayer الأساسية ومحولات التوافق:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > العلم `--interactive` اختياري. استخدم `intlayer-cli init` إذا كنت وكيلاً من AI.

package/docs/ar/migration_from_next-intl_to_intlayer.md

@@ -98,19 +98,23 @@ Intlayer هو أيضًا الحل الذي يتمتع بـ **أنشط تطور**
 قم بتثبيت حزم Intlayer الأساسية ومحول التوافق `@intlayer/next-intl`:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > العلم `--interactive` اختياري. استخدم `intlayer-cli init` إذا كنت وكيلاً من AI.
@@ -184,9 +188,7 @@ import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
 
 const withIntlayer = createNextIntlPlugin();
 
-const nextConfig: NextConfig = {
-  /* خيارات التكوين الموجودة */
-};
+const nextConfig: NextConfig = {/* خيارات التكوين الموجودة */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/ar/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -101,19 +101,23 @@ Intlayer أيضاً هو الحل ذو **التطوير الأكثر نشاطا
 قم بتثبيت حزم Intlayer الأساسية ومحول التوافق:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > العلم `--interactive` اختياري. استخدم `intlayer-cli init` إذا كنت وكيل ذكي.

package/docs/ar/migration_from_react-i18next_to_intlayer.md

@@ -101,19 +101,23 @@ Intlayer هو أيضًا الحل الذي يتمتع بـ **أنشط تطور**
 قم بتثبيت حزم Intlayer الأساسية ومحولات التوافق:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > العلم `--interactive` اختياري. استخدم `intlayer-cli init` إذا كنت وكيلاً من AI.
@@ -209,9 +213,7 @@ import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
 
 const withIntlayer = createNextI18nPlugin();
 
-const nextConfig: NextConfig = {
-  /* الخيارات الخاصة بك */
-};
+const nextConfig: NextConfig = {/* الخيارات الخاصة بك */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/ar/migration_from_vue-i18n_to_intlayer.md

@@ -100,19 +100,23 @@ Intlayer أيضاً هو الحل ذو **التطوير الأكثر نشاطا
 قم بتثبيت حزم Intlayer الأساسية ومحول التوافق:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer@canary init --interactive    # v9
+# npx intlayer init                       # v8
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive   # v9
+# pnpm dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive   # v9
+# yarn dlx intlayer init                      # v8
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive   # v9
+# bunx intlayer init                      # v8
 ```
 
 > العلم `--interactive` اختياري. استخدم `intlayer-cli init` إذا كنت وكيل ذكي.

package/docs/ar/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-06-30
 title: Intlayer v9 الجديد - ما الجديد؟
 description: اكتشف ما هو جديد في Intlayer v9. نقدم حزم توافق جاهزة للاستخدام لمكتبات i18n الشهيرة ودعمًا للمجموعات (Collections) والمتغيرات (Variants).
 keywords:
@@ -9,6 +9,8 @@ keywords:
   - الترحيل
   - المجموعات
   - المتغيرات
+  - Self-Hosting
+  - Docker
   - i18next
   - next-intl
   - vue-i18n
@@ -202,24 +204,6 @@ const product = useIntlayer("product-copy", {
 
 ---
 
-## التحميل الديناميكي وتحسينات حجم الحزمة (Bundle Size Optimizations)
-
-للحفاظ على أحجام الحزم (bundles) صغيرة للغاية، يدعم Intlayer v9 التحميل الكسول الديناميكي (dynamic lazy loading).
-
-في إعداداتك، اضبط `importMode` على `'dynamic'` أو `'fetch'`:
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
-};
-```
-
-في وقت البناء (build time)، يقوم `@intlayer/swc` و`@intlayer/babel` بمسح ملفاتك واستبدال استدعاءات `useIntlayer` / `getIntlayer` بـ wrappers قابلة للإزالة (tree-shakeable wrappers) (`useDictionary` / `useDictionaryDynamic`). يتم تحميل المحتوى المطلوب فقط للعنصر المحدد في المجموعة (collection item)، أو المتغير (variant)، أو اللغة (locale)، مما يمنع حزمة الإنتاج (production bundle) الخاصة بك من احتواء ترجمات غير مستخدمة.
-
----
-
 ## Vite Plugin: Bundled Compiler & Proxy
 
 يجمع plugin `intlayer()` Vite الآن **المترجم** و**بروكسي التوجيه حسب اللغة** مباشرة، لذا تحتاج معظم المشاريع إلى plugin واحد فقط في `vite.config.ts`:
@@ -321,6 +305,59 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: استخدم Intlayer كقاعدة بيانات محتوى headless
+
+يأتي Intlayer v9 مع SDK نظيف وذاتي المصادقة في `@intlayer/api` للتفاعل مع نظام إدارة المحتوى (CMS) برمجيًا — جلب المشاريع، وجلب القواميس، ودفعها أو تحديثها من خادمك أو سكربتاتك أو CI الخاص بك. تتم المصادقة (OAuth2 `client_credentials`) وتجديدها نيابةً عنك.
+
+تم تقسيم SDK إلى **عمليتي استيراد منفصلتين** بحيث تتضمن حزمتك فقط النطاقات التي تستخدمها فعليًا:
+
+1. `createIntlayerCMS` — **مُصادِق** خفيف يحتفظ ببيانات الاعتماد والرمز المُدار (دون تضمين أي عميل نطاق).
+2. `dictionaryEndpoint`، `projectEndpoint`، … — **روابط نقاط نهاية** لكل نطاق، يُستورد كل منها من مساره الفرعي الخاص.
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// الإعداد اختياري: تعود بيانات الاعتماد إلى INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET المُحلَّلة بواسطة `@intlayer/config/built`.
+const cms = createIntlayerCMS();
+
+// قراءة
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// كتابة — استخدم نظام إدارة المحتوى مثل قاعدة بيانات
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> الأمان: تمنح بيانات اعتماد نظام إدارة المحتوى صلاحية الكتابة على محتواك. أنشئ المُصادِق دائمًا **على الخادم** فقط — لا ترسل أبدًا `clientId` / `clientSecret` إلى المتصفح.
+
+---
+
+## الاستضافة الذاتية (Self-Hosting)
+
+يدعم Intlayer v9 دعمًا أصليًا لتشغيل نسختك الخاصة من Intlayer بأمر واحد — دون الحاجة إلى حساب Intlayer Cloud.
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+يقوم المثبّت بتنزيل ملف `docker-compose.yml` وملف `.env`، ويولّد الأسرار المطلوبة تلقائياً، ويشغّل `docker compose up -d`. كل شيء — لوحة التحكم، وواجهة برمجة التطبيقات، وقاعدة البيانات، وتخزين الكائنات، والبريد الإلكتروني التفاعلي — يعمل محلياً داخل حاويات.
+
+### الخدمات المتضمنة
+
+| الخدمة                                           | الغرض                                                                   |
+| ------------------------------------------------ | ----------------------------------------------------------------------- |
+| **app** (TanStack Start)                         | واجهة لوحة التحكم على المنفذ `3000`                                     |
+| **backend** (Fastify/Bun)                        | واجهة برمجة تطبيقات REST على المنفذ `3100`                              |
+| **MongoDB 7** (مجموعة نسخ متماثلة أحادية العقدة) | قاعدة البيانات الرئيسية                                                 |
+| **Redis 7**                                      | قوائم انتظار المهام والتخزين المؤقت                                     |
+| **MinIO**                                        | تخزين كائنات متوافق مع S3 (الصور الرمزية، لقطات الشاشة)                 |
+| **Mailpit**                                      | خادم SMTP محلي + واجهة ويب للبريد الإلكتروني التفاعلي على المنفذ `8025` |
+
+يتم تضمين Chromium (المستخدم لتوليد لقطات الشاشة عبر Puppeteer) داخل صورة الخادم الخلفي — دون الحاجة إلى حاوية إضافية.
+
+---
+
 ## ملاحظات الترحيل من الإصدار 8
 
 إذا كنت تقوم بالترقية من الإصدار 8، لاحظ أن الإصدار 9 لا يتضمن تغييرات جذرية (breaking changes). ولكن إليك التغييرات الرئيسية:
@@ -336,3 +373,5 @@ npm install intlayer react-native-intlayer
 - [دليل حزم محولات التوافق (Compat Adapter Packages Guide)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/compat/index.md)
 - [القواميس الديناميكية - المجموعات (Collections) والمتغيرات (Variants)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/index.md)
 - [مرجع الإعدادات (Configuration Reference)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)
+- [CMS SDK - الوصول البرمجي عبر @intlayer/api](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md)
+- [دليل الاستضافة الذاتية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/self_hosting.md)