@intlayer/docs 9.4.0-canary.0 → 9.4.0

package/docs/ar/packages/intlayer/getMultilingualUrls.md

@@ -138,8 +138,6 @@ getMultilingualUrls(
 // }
 ```
 
----
-
 ### أنماط التوجيه المختلفة
 
 ```typescript
@@ -205,6 +203,12 @@ getMultilingualUrls("/dashboard", {
 - **اللغات غير المدعومة:**
   - يتم اعتبار اللغات الموجودة فقط في مصفوفة `locales` عند إنشاء عناوين URL.
 
+- **أنماط التوجيه:**
+  - `'prefix-no-default'`: اللغة الافتراضية بدون بادئة، والبقية لها بادئات (مثال: `/dashboard`, `/fr/dashboard`)
+  - `'prefix-all'`: جميع اللغات لها بادئات (مثال: `/en/dashboard`, `/fr/dashboard`)
+  - `'no-prefix'`: بدون بادئات لغة في عناوين URL (جميع اللغات تُرجع نفس عنوان URL)
+  - `'search-params'`: تحديد اللغة عبر معامل الاستعلام (مثال: `/dashboard?locale=fr`)
+
 ---
 
 ## الاستخدام في التطبيقات

package/docs/ar/packages/intlayer/getTranslation.md

@@ -31,6 +31,8 @@ author: aymericzip
 
 تقوم دالة `getTranslationContent` باسترجاع المحتوى المقابل للغة معينة من مجموعة محتويات لغوية قابلة للتخصيص. إذا لم يتم العثور على اللغة المحددة، فإنها تعيد بشكل افتراضي المحتوى الخاص باللغة الافتراضية المكونة في المشروع.
 
+للمزيد من التفاصيل حول كيفية إعلان الترجمات، راجع [وثائق الترجمة](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/translation.md).
+
 ## المعاملات
 
 - `languageContent: CustomizableLanguageContent<Content>`

package/docs/ar/packages/next-intlayer/t.md

@@ -158,6 +158,23 @@ const greeting = t(translations);
 
 #### مثال:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx codeFormat={["typescript", "esm", "commonjs"]}
+import type { FC, ReactNode } from "react";
+import type { Locales } from "intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const Page: FC<{ locale: Locales; children: ReactNode }> = ({
+  locale,
+  children,
+}) => <IntlayerProvider locale={locale}>{children}</IntlayerProvider>;
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx codeFormat={["typescript", "esm", "commonjs"]}
 import type { FC } from "react";
 import type { Locales } from "intlayer";
@@ -173,6 +190,9 @@ const Page: FC<{ locale: Locales }> = ({ locale }) => (
 );
 ```
 
+ </Tab>
+</Tabs>
+
 ---
 
 ## الأخطاء الشائعة واستكشاف المشكلات

package/docs/ar/packages/next-intlayer/useIntlayer.md

@@ -79,6 +79,34 @@ author: aymericzip
 
 إليك كيفية تنفيذ هوك `useIntlayer` داخل صفحة Next.js لتحميل المحتوى المحلي ديناميكيًا بناءً على اللغة الحالية للتطبيق:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
 import { ClientComponentExample } from "@components/ClientComponentExample";
 import { ServerComponentExample } from "@components/ServerComponentExample";
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/ar/packages/next-intlayer/useLocale.md

@@ -104,6 +104,8 @@ const LocaleSwitcher: FC = () => {
 
 ## قيم الإرجاع
 
+عند استدعاء hook `useLocale`، فإنه يُرجع كائنًا يحتوي على الخصائص التالية:
+
 - **`locale`**: اللغة الحالية كما تم تعيينها في سياق React.
 - **`defaultLocale`**: اللغة الأساسية المعرفة في الإعدادات.
 - **`availableLocales`**: قائمة بجميع اللغات المتاحة كما هو معرف في الإعدادات.

package/docs/ar/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ author: aymericzip
 
 ## مثال على الاستخدام في React
 
-فيما يلي مثال على كيفية استخدام الخطاف `useDictionary` في مكون React:
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

package/docs/ar/packages/react-intlayer/useI18n.md

@@ -73,6 +73,34 @@ author: aymericzip
 
 أمثلة على استخدام الخطاف `useI18n` داخل مكونات React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -97,6 +125,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+</Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/ar/packages/react-intlayer/useIntlayer.md

@@ -27,48 +27,6 @@ author: aymericzip
 
 ## مثال على الاستخدام في React
 
-عرض استخدام الـ `useIntlayer` hook داخل مكون React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
-```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { useIntlayer } from "react-intlayer";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import { useIntlayer } from "react-intlayer/server";
 

package/docs/ar/packages/vite-intlayer/intlayerPrune.md

@@ -28,6 +28,8 @@ author: aymericzip
 
 يُستخدم المكوّن الإضافي `intlayerPrune` الخاص بـ Vite لإجراء tree-shaking وإزالة (prune) القواميس غير المستخدمة من حزمة التطبيق الخاصة بك. يساعد ذلك في تقليل حجم الحزمة النهائي باشتراط تضمين المحتوى متعدد اللغات الضروري فقط.
 
+> البرنامج المساعد مضمن بالفعل ومكوّن تلقائياً عند استخدام [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/packages/vite-intlayer/intlayer.md). تحتاج فقط إلى تسجيله يدوياً إذا كنت تقوم بتكوين مكدس المكونات الإضافية بنفسك.
+
 ## الاستخدام
 
 ### كجزء من `intlayer()` (موصى به)

package/docs/ar/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.ar.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "ar", // مهم
+  "content": {
+    "multilingualContent": "عنوان مكونتي",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > موصى به: هذا التنسيق هو الأفضل عند استخدام محرر Intlayer المرئي أو إدارة الترجمات مباشرة في الكود.
 
+> ملاحظة: في كلا الحالتين، يجب أن يتبع ملف إعلان المحتوى نمط التسمية `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` ليتم التعرف عليه بواسطة Intlayer. اللاحقة `.[locale]` اختيارية وتُستخدم فقط كاتفاقية تسمية.
+
 ### التكوين العام لملفات كل لغة
 
 يمكنك ضبط التكوين العام لملفات كل لغة عن طريق إضافة ما يلي إلى ملف `intlayer.config.ts` الخاص بك:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // مهم
-  "content": {
-    "multilingualContent": "عنوان المكون الخاص بي",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > مهم: تأكد من تعريف حقل locale. فهو يخبر Intlayer باللغة التي يمثلها الملف.
 
-> ملاحظة: في كلتا الحالتين، يجب أن يتبع ملف إعلان المحتوى نمط التسمية `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` ليتم التعرف عليه من قبل Intlayer. اللاحقة `.[locale]` اختيارية وتستخدم فقط كاتفاقية تسمية.
-
 ## مزج الصيغ
 
 يمكنك دمج كلا النهجين للإعلان عن نفس مفتاح المحتوى. على سبيل المثال:

package/docs/ar/readme.md

@@ -234,6 +234,7 @@ const HomePage = () => {
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/ar/releases/v6.md

@@ -116,6 +116,8 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
+قم بملء ترجماتك المفقودة باستخدام أمر `npx intlayer fill`.
+
 يمكنك أيضًا ضبط كل قاموس بدقة باستخدام حقل `autoFill` في ملفات المحتوى. راجع المرجع الكامل في `doc/autoFill` و `doc/dictionary/content_file`.
 
 ---
@@ -175,6 +177,20 @@ bun x intlayer fill
 
 ---
 
+تم تحديث خادم MCP لدعم الميزات الجديدة.
+
+- ملء تلقائي
+- اختبار الترجمات المفقودة
+- تحديثات مباشرة
+- التسجيل
+- التحقق من الصحة
+- ملاحظات الترحيل
+- التوثيق
+
+> خادم MCP يساعد في أتمتة المشاريع التي تستخدم Intlayer. اختبار الترجمات المفقودة للكود المُنشأ تلقائياً. يساعدك في فهم إعدادك، وتضمين توثيق Intlayer في محرر الأكواد الخاص بك.
+
+---
+
 ## الأداء: أسرع 10 مرات
 
 - حل متوازي للقواميس المحلية والبعيدة
@@ -296,8 +312,6 @@ bun x intlayer live --with 'vite preview'
 
 راجع [نظام إدارة المحتوى والمزامنة الحية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_CMS.md) و [التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md) للحصول على إرشادات كاملة.
 
----
-
 ## عملية متوازية لمراقبة الملفات على turbopack
 
 عند استخدام Turbopack على Next.js 14 وما فوق كخادم التطوير الخاص بك مع أمر `next dev --turbopack`، لن يتم اكتشاف تغييرات القاموس تلقائياً بشكل افتراضي.

package/docs/ar/releases/v9.md

@@ -373,6 +373,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 يقوم المثبّت بتنزيل ملف `docker-compose.yml` وملف `.env`، ويولّد الأسرار المطلوبة تلقائياً، ويشغّل `docker compose up -d`. كل شيء — لوحة التحكم، وواجهة برمجة التطبيقات، وقاعدة البيانات، وتخزين الكائنات، والبريد الإلكتروني التفاعلي — يعمل محلياً داخل حاويات.
 
+---
+
 ## ملاحظات الترحيل من الإصدار 8
 
 إذا كنت تقوم بالترقية من الإصدار 8، لاحظ أن الإصدار 9 لا يتضمن تغييرات جذرية (breaking changes). ولكن إليك التغييرات الرئيسية:

package/docs/ar/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 يمكن تشغيل Intlayer بالكامل على بنيتك التحتية الخاصة — دون الحاجة إلى حساب Intlayer Cloud. يُشغّل أمر واحد مكدساً جاهزاً للإنتاج:
 
+أمر واحد يثبت كل شيء:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 يقوم المثبّت بتنزيل ملف `docker-compose.yml` وملف `.env`، ويولّد الأسرار المطلوبة تلقائياً، ويبدأ تشغيل جميع الحاويات بـ `docker compose up -d`.
 
+الاعتماد الخارجي الوحيد هو **MongoDB**: يتصل الـ backend بـ cluster **Atlas** من MongoDB الذي توفره. كل شيء آخر يعمل داخل الحاوية.
+
 ## جدول المحتويات
 
 <TOC/>
@@ -60,23 +64,77 @@ curl -fsSL https://intlayer.org/install.sh | sh
 - المنافذ `3000`، `3100`، `8025`، `9000`، و`9001` متاحة على المضيف.
 - مضيف Linux أو macOS (أو WSL2 على Windows).
 
+كل شيء آخر — Bun و Redis و MinIO و Chromium — يتم شحنه داخل الصورة.
+
 ---
 
 ## البدء السريع
 
+### 1. تشغيل المثبِّت
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-ما يقوم به المثبّت:
+يتحقق من تثبيت Docker وتشغيله، ويكتب `./intlayer.env` مع `BETTER_AUTH_SECRET` و `S3_SECRET_ACCESS_KEY` التي تم إنشاؤها بالفعل، ويسحب الصورة. لا يبدأ الحاوية — لا يمكن للخادم الخلفي أن يبدأ بدون بيانات اعتماد قاعدة البيانات الخاصة بك.
+
+تشغيل المثبِّت مرة أخرى آمن: لن يتم استبدال `intlayer.env` الموجود أبدًا، لذا فهو يعمل أيضًا كمسار الترقية.
+
+### 2. ملء بيانات اعتمادك
+
+افتح `intlayer.env` وأكمل القيم المشار إليها بـ `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+يحتوي الملف أيضًا على كتل معلقة للميزات الاختيارية — [SMTP mailer](#global-mailer)، `OPENAI_API_KEY`، وموفري OAuth. قم بإلغاء التعليق عما تحتاجه.
+
+> يتم قراءة الملف بواسطة `docker run --env-file`، والذي لا يزيل الاقتباسات ويعامل كل شيء بعد `=` كقيمة. اكتب القيم بدون اقتباسات، وأبقِ التعليقات على أسطرها الخاصة.
+
+### 3. بدء الحاوية
+
+هذا هو الأمر الذي يطبعه المثبِّت عند انتهائه:
+
+```sh
+docker run -d --name intlayer \
+  --restart unless-stopped \
+  -p 3000:3000 \
+  -p 3100:3100 \
+  -p 9000:9000 \
+  -p 9001:9001 \
+  -v intlayer-data:/data \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+ثم افتح **http://localhost:3000**. يقوم الإقلاع الأول بتهيئة مخازن البيانات، لذا امنحه دقيقة واحدة.
+
+> لوحة التحكم موجودة على `localhost`. انظر [القيود](#limitations) — النطاقات المخصصة غير مدعومة في الصورة المنشورة.
 
-1. يتحقق من وجود `docker` و`docker compose`.
-2. يُنزّل `docker-compose.yml` و`.env.example` إلى `./intlayer/`.
-3. إذا لم يكن هناك `.env`، ينسخ المثال ويولّد أسراراً عشوائية لـ `BETTER_AUTH_SECRET` و`S3_ACCESS_KEY_ID` و`S3_SECRET_ACCESS_KEY` عبر `openssl rand`.
-4. يُشغّل `docker compose pull` + `docker compose up -d`.
-5. يطبع عناوين URL: لوحة التحكم `:3000`، API `:3100`، واجهة البريد الإلكتروني `:8025`، وحدة تحكم MinIO `:9001`.
+### إعدادات المثبت
 
-بعد تشغيل المكدس، افتح **http://localhost:3000** وأنشئ حسابك الأول.
+يقرأ المثبت بعض متغيرات البيئة. لأنه موجه إلى `sh`، مرر هذه المتغيرات إلى shell بدلاً من تمريرها إلى `curl`:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| المتغير                   | القيمة الافتراضية                             | الوصف                             |
+| ------------------------- | --------------------------------------------- | --------------------------------- |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | الصورة المراد سحبها               |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | حيث يتم كتابة ملف البيئة          |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | اسم الحاوية                       |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | وحدة تخزين مسماة مثبتة في `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | منفذ المضيف لوحة التحكم           |
+| `INTLAYER_API_PORT`       | `3100`                                        | منفذ المضيف للـ API               |
+| `INTLAYER_S3_PORT`        | `9000`                                        | منفذ المضيف لـ MinIO S3 API       |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | منفذ المضيف لوحة MinIO            |
+
+> متغيرات المنافذ الأربعة تغير فقط الجانب **المضيف** من التعيين المطبوع في أمر `docker run`. الصورة المنشورة لديها `http://localhost:3000` و `http://localhost:3100` و `http://localhost:9000` مدرجة في حزمة لوحة التحكم في وقت البناء، لذا فإن إعادة تعيينها تترك المتصفح يشير إلى المنافذ القديمة. احتفظ بالقيم الافتراضية إلا إذا كنت تقوم بإنشاء صورتك الخاصة — انظر [القيود](#limitations).
 
 ---
 
@@ -103,8 +161,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **minio**   | `minio/minio`                        | `9000` (S3)، `9001` (وحدة التحكم)   | تخزين كائنات متوافق مع S3 للصور الرمزية ولقطات الشاشة  |
 | **mailpit** | `axllent/mailpit`                    | `1025` (SMTP)، `8025` (واجهة الويب) | مجمّع بريد إلكتروني تفاعلي محلي                        |
 
-المنافذ الداخلية (mongo، redis) غير معرّضة للمضيف افتراضياً.
-
 > يجب أن يكون منفذ MinIO `9000` قابلاً للوصول من المتصفح لأن الأصول المرفوعة (الصور الرمزية، لقطات الشاشة) تُحمَّل مباشرة من `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -160,8 +216,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`، `LINKEDIN_CLIENT_SECRET`           | تسجيل الدخول عبر OAuth لـ LinkedIn                               |
 | `ATLASSIAN_CLIENT_ID`، `ATLASSIAN_CLIENT_SECRET`         | تسجيل الدخول عبر OAuth لـ Atlassian                              |
 
----
-
 ### بريد عام
 
 بشكل افتراضي، يتم إرسال جميع رسائل البريد الإلكترونية للمعاملات عبر Resend باستخدام `RESEND_API_KEY`. يمكن للنشرات ذاتية الاستضافة بدلاً من ذلك توجيه **كل** بريد إلكتروني — بما في ذلك رسائل البريد الإلكترونية غير المتعلقة بالمنظمة مثل إعادة تعيين كلمات المرور والروابط السحرية — عبر بريد عام مُعد باستخدام متغيرات البيئة.
@@ -247,16 +301,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## الترقية
 
-إعادة تشغيل المثبّت على نشر قائم تنفّذ ترقية متدحرجة:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 يجلب هذا الأمر أحدث الصور ويعيد تشغيل الحاويات باستخدام `docker compose pull && docker compose up -d`. يتم الاحتفاظ بالأحجام الموجودة (`mongo-data`، `redis-data`، `minio-data`) — دون فقدان للبيانات.
 
-للترقية يدوياً من داخل مجلد `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -320,15 +366,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+ابحث عن `MongoDB connection error` بالقرب من أعلى السجل.
+
 ### لوحة التحكم لا تستطيع الوصول إلى API
 
 تحقق من أن `VITE_BACKEND_URL` يطابق عنوان URL حيث يمكن الوصول إلى الخادم الخلفي من **المتصفح** (ليس شبكة Docker). إذا غيّرت منفذ الخادم الخلفي أو أضفت وكيلاً عكسياً، أعد بناء صورة لوحة التحكم:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### دلو MinIO مفقود
 
 إذا لم تُشغَّل خدمة `minio-init` المؤقتة (أو شُغّلت قبل أن يكون MinIO جاهزاً)، أنشئ الدلو يدوياً:

package/docs/bn/intlayer_with_fastify.md

@@ -222,9 +222,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... অন্যান্য কনফিগারেশন অপশন
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/bn/intlayer_with_hono.md

@@ -235,9 +235,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... অন্যান্য কনফিগারেশন অপশন
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/cs/intlayer_with_fastify.md

@@ -222,9 +222,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... Další možnosti konfigurace
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/cs/intlayer_with_hono.md

@@ -235,9 +235,11 @@ import { Locales, type IntlayerConfig } from "intlayer";
 
 const config: IntlayerConfig = {
   // ... Další možnosti konfigurace
-  middleware: {
-    headerName: "my-locale-header",
-    cookieName: "my-locale-cookie",
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
   },
 };
 

package/docs/de/analytics.md

@@ -123,17 +123,6 @@ export default config;
 
 Das Deinstallieren von `@intlayer/analytics` hat dieselbe Wirkung wie `enabled: false`. Die vollständige Feldliste finden Sie in der [Konfigurationsreferenz](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md).
 
-## Framework-Unterstützung
-
-Analytics ist mit dem freigegebenen `IntlayerProvider` von `react-intlayer` verdrahtet und steht daher heute überall dort zur Verfügung, wo dieser Provider verwendet wird:
-
-| Framework                                                | Status                                                                                            |
-| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| React                                                    | ✅ Verfügbar                                                                                      |
-| Next.js (`next-intlayer`)                                | ✅ Verfügbar (über `react-intlayer`)                                                              |
-| React Native / Expo (`react-native-intlayer`)            | ✅ Verfügbar (über `react-intlayer`)                                                              |
-| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 Geplant — gleicher Client, Provider-Level-Bindungen nach dem `@intlayer/editor` Rollout-Muster |
-
 ## Verwendung
 
 ### Automatische Nachverfolgung auf Provider-Ebene
@@ -177,6 +166,34 @@ const CTAButton = () => {
 
 ### Auflösung einer Variante auf der Clientseite
 
+  </Tab>
+</Tabs>
+
+Gewichtungen sind optional — geben Sie eine pro Variante an, um die Aufteilung zu beeinflussen, z. B. `useExperiment("homepage-hero", ["default", "black_friday"], [9, 1])`.
+
+Das untergeordnete Element liest dann die [Variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/variants.md) des Wörterbuchs, die übereinstimmt:
+
+```tsx fileName="HeroBanner.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const HeroBanner = ({ variant }: { variant: string }) => {
+  const { headline, cta } = useIntlayer("hero-banner", { variant });
+
+  return (
+    <section>
+      <h1>{headline}</h1>
+      <a>{cta}</a>
+    </section>
+  );
+};
+```
+
+> Das Lesen der Variante in einer **untergeordneten Komponente** ist das, was dies außerhalb von React funktioniert: In Vue, Svelte, Solid und Angular wird der Selektor, der an `useIntlayer` übergeben wird, erfasst, wenn die Komponente initialisiert wird, daher muss das Lesen in einer Komponente stattfinden, die nur einmal bereitgestellt wird, wenn die Variante bekannt ist.
+
+Wenn das Experiment eine ganze Seite abdeckt und nicht nur ein einzelnes Dictionary, verschieben Sie die Variante stattdessen auf den Provider — siehe [Ambient variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/variants.md#ambient-variant). Jedes `useIntlayer` darunter wird dann dagegen aufgelöst, ohne dass Änderungen an der Aufrufstelle erforderlich sind.
+
+Wenn du die Raw Assignment außerhalb einer Komponente benötigst, greife direkt auf den Client zu:
+
 ```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
 import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
 
@@ -187,6 +204,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant` weist nur zu — es zeichnet die Exposition nicht auf. Verwenden Sie lieber `useExperiment()`, andernfalls hat die Konversionsrate keinen Nenner.
+
 ## Datenschutz & Leistung
 
 - **Anonym durch Design**: Sitzungen werden durch eine rotierende ID identifiziert; das Backend speichert nur einen **SHA-256-Hash** dieser ID — niemals die rohe ID, niemals eine IP-Adresse.
@@ -236,6 +255,8 @@ const cms = createIntlayerCMS();
 const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
 ```
 
+> **Nur Server-seitig.** `createIntlayerCMS()` authentifiziert sich mit `clientId` + `clientSecret`, und das Secret ist niemals im Browser verfügbar — dieser Code-Schnipsel würde unauthentifizierte Anfragen ausstellen, wenn er dort ausgeführt würde. Halten Sie ihn in einem Route Handler, Server Action oder Script.
+
 ## Nützliche Links
 
 - [Dynamische Wörterbücher - Kollektionen & Varianten](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/dynamic_dictionaries/index.md)