@intlayer/docs 9.3.3 → 9.4.0

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/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> যখন `optimize` `false` থাকে বা যখন `editor.enabled` `true` থাকে তখন মিনিফিকেশন বাদ দেওয়া হয় (ভিজ্যুয়াল এডিটরের এডিটিং সচল রাখার জন্য অরিজিনাল ফিল্ডের নামগুলো প্রয়োজন)।
+> `optimize` `false` থাকলে মিনিফিকেশন বাদ দেওয়া হয়। `editor.enabled` `true` থাকলেও এটি চলতে থাকে, তবে ফিল্ডের নাম পরিবর্তনের ধাপ ছাড়া — ভিজ্যুয়াল এডিটর `keyPath` এর মাধ্যমে এডিট রিজলভ করে, তাই মূল ফিল্ডের নামগুলো অক্ষত থাকতে হয়।
 
 > Next.js-এ, `@intlayer/swc` ইনস্টল না থাকলে বা লোড করা না গেলে (16.1.0-এর নিচের Next.js) minification-ও এড়িয়ে যাওয়া হয়। সোর্সের অ্যাক্সেসগুলি পুনর্লিখন করে এই প্লাগইনই, তাই এটি ছাড়া অভিধান পুনঃনামকরণ করলে আপনার কোড এমন ফিল্ড নাম পড়তে থাকবে যা আর নেই।
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> যখন `optimize` `false` থাকে বা `editor.enabled` `true` থাকে তখন Purge বাদ দেওয়া হয়। Next.js-এ `@intlayer/swc` অনুপলব্ধ হলে এবং কম্প্যাট-অ্যাডাপ্টার কলার কনফিগার করা থাকলে এটি অতিরিক্তভাবে এড়িয়ে যাওয়া হয়।
+> `optimize` `false` থাকলে Purge বাদ দেওয়া হয়। `editor.enabled` `true` থাকলেও এটি সক্রিয় থাকে — কারণ পার্জ করা ফিল্ড কোনো কম্পোনেন্ট পড়ে না, তাই এডিটর সেটিকে কখনো রেন্ডার করে না। Next.js-এ `@intlayer/swc` অনুপলব্ধ হলে এবং কম্প্যাট-অ্যাডাপ্টার কলার কনফিগার করা থাকলে এটি অতিরিক্তভাবে এড়িয়ে যাওয়া হয়।
 
 > যদি কোনো সোর্স ফাইল পার্স (parse) করা না যায়, অথবা `useIntlayer`-এর রেজাল্ট কোনো ভেরিয়েবলে অ্যাসাইন করে এমনভাবে পাস করা হয় যা স্ট্যাটিক অ্যানালাইজার ট্র্যাক করতে পারে না (যেমন, কোনো অবজেক্টের মধ্যে স্প্রেড করা, অথবা ডিস্ট্রাকচার না করেই প্রপ হিসেবে পাস করা), সেক্ষেত্রে সুরক্ষার খাতিরে Purge প্রক্রিয়াটি এড়িয়ে যাওয়া হয়। এই ধরনের ক্ষেত্রে সম্পূর্ণ ডিকশনারিটি অক্ষত রাখা হয়।
 

package/docs/bn/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: কনফিগারেশন (Configuration)
 description: আপনার অ্যাপ্লিকেশনের জন্য Intlayer কীভাবে কনফিগার করবেন তা শিখুন। আপনার প্রয়োজন অনুযায়ী Intlayer কাস্টমাইজ করতে উপলব্ধ বিভিন্ন সেটিংস এবং বিকল্পগুলি বুঝুন।
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "`@intlayer/analytics` ইনস্টল থাকলে অ্যানালিটিক্স ডিফল্টভাবে সক্রিয় করা হয়েছে"
   - version: 9.1.3
     date: 2026-08-06
     changes: "`routing.enableProxy` কে তিন-অবস্থার করা হয়েছে: আনসেট (auto), `true`, `false`"
@@ -380,8 +383,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * অ্যানালিটিক্স সংগ্রহ সক্রিয় কিনা (পেজ ভিউ, কনটেন্ট এক্সপোজার, A/B ইভেন্ট)।
-     * অ্যাট্রিবিউশনের জন্য `editor.clientId` সেট থাকা আবশ্যক।
-     * ডিফল্ট: false
+     * `@intlayer/analytics` ইনস্টল থাকা এবং অ্যাট্রিবিউশনের জন্য `editor.clientId` সেট থাকা আবশ্যক।
+     * ডিফল্ট: true
      */
     enabled: true,
 
@@ -731,13 +734,13 @@ export default config;
 
 Intlayer অ্যানালিটিক্স সম্পর্কিত সেটিংস নির্ধারণ করে: ব্যবহারকারীদের প্রকৃতপক্ষে কোন কনটেন্ট দেখানো হচ্ছে তা সংগ্রহ করা (পেজ ভিউ, কনটেন্ট এক্সপোজার) এবং কনটেন্টে A/B টেস্টিং সক্রিয় করা।
 
-অ্যানালিটিক্স সম্পূর্ণভাবে অপ্ট-ইন (opt-in): `analytics.enabled` স্পষ্টভাবে `true` তে সেট না করা পর্যন্ত **এবং** অ্যাট্রিবিউশনের জন্য একটি প্রজেক্ট কী (`editor.clientId`) কনফিগার না করা পর্যন্ত কিছুই সংগ্রহ করা হয় না। নিষ্ক্রিয় থাকলে (ডিফল্ট), সম্পূর্ণ অ্যানালিটিক্স ইন্টিগ্রেশন আপনার অ্যাপ্লিকেশন বান্ডল থেকে সরিয়ে ফেলা হয় (ডেড-কোড এলিমিনেশন)।
+অ্যানালিটিক্স ডিফল্টভাবে সক্রিয় (অপ্ট-আউট): `@intlayer/analytics` প্যাকেজ ইনস্টল থাকলে **এবং** অ্যাট্রিবিউশনের জন্য একটি প্রজেক্ট কী (`editor.clientId`) কনফিগার করা থাকলেই সংগ্রহ শুরু হয়। `analytics.enabled` কে `false` করুন — অথবা প্যাকেজটি ইনস্টল না করুন — তাহলে সম্পূর্ণ অ্যানালিটিক্স ইন্টিগ্রেশন আপনার অ্যাপ্লিকেশন বান্ডল থেকে সরিয়ে ফেলা হয় (ডেড-কোড এলিমিনেশন)।
 
-| ফিল্ড           | বর্ণনা                                                                      | টাইপ      | ডিফল্ট  | উদাহরণ  | নোট                                                                                                                      |
-| --------------- | --------------------------------------------------------------------------- | --------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
-| `enabled`       | অ্যানালিটিক্স সংগ্রহ সক্রিয় করে (পেজ ভিউ, কনটেন্ট এক্সপোজার, A/B ইভেন্ট)।  | `boolean` | `false` | `true`  | অ্যাট্রিবিউশনের জন্য `editor.clientId` সেট থাকা আবশ্যক; নাহলে `enabled` `true` থাকলেও অ্যানালিটিক্স নিষ্ক্রিয় থাকে।     |
-| `flushInterval` | ব্যাকএন্ডে স্বয়ংক্রিয় ব্যাচ ফ্লাশের মধ্যবর্তী মিলিসেকেন্ড।                | `number`  | `20000` | `10000` |                                                                                                                          |
-| `sampleRate`    | রেকর্ড করার জন্য সেশনের অনুপাত, `0` (কোনোটিই না) থেকে `1` (সবগুলো) পর্যন্ত। | `number`  | `1`     | `0.5`   | স্যাম্পলিং প্রতি সেশনে নির্ধারক (deterministic), তাই একটি রেকর্ডকৃত সেশন তার সমস্ত ইভেন্ট রিপোর্ট করে (আংশিক ফানেল নয়)। |
+| ফিল্ড           | বর্ণনা                                                                      | টাইপ      | ডিফল্ট  | উদাহরণ  | নোট                                                                                                                                                        |
+| --------------- | --------------------------------------------------------------------------- | --------- | ------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | অ্যানালিটিক্স সংগ্রহ সক্রিয় করে (পেজ ভিউ, কনটেন্ট এক্সপোজার, A/B ইভেন্ট)।  | `boolean` | `true`  | `false` | `@intlayer/analytics` ইনস্টল থাকা এবং অ্যাট্রিবিউশনের জন্য `editor.clientId` সেট থাকা আবশ্যক; নাহলে `enabled` `true` থাকলেও অ্যানালিটিক্স নিষ্ক্রিয় থাকে। |
+| `flushInterval` | ব্যাকএন্ডে স্বয়ংক্রিয় ব্যাচ ফ্লাশের মধ্যবর্তী মিলিসেকেন্ড।                | `number`  | `20000` | `10000` |                                                                                                                                                            |
+| `sampleRate`    | রেকর্ড করার জন্য সেশনের অনুপাত, `0` (কোনোটিই না) থেকে `1` (সবগুলো) পর্যন্ত। | `number`  | `1`     | `0.5`   | স্যাম্পলিং প্রতি সেশনে নির্ধারক (deterministic), তাই একটি রেকর্ডকৃত সেশন তার সমস্ত ইভেন্ট রিপোর্ট করে (আংশিক ফানেল নয়)।                                   |
 
 ---
 

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/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> K minifikaci nedojde, pokud je `optimize` nastaveno na `false` nebo pokud `editor.enabled` odpovídá hodnotě `true` (vizuální editor totiž potřebuje znát původní názvy polí, aby umožnil jejich editaci).
+> K minifikaci nedojde, pokud je `optimize` nastaveno na `false`. Pokud je `editor.enabled` `true`, proces stále běží, ale bez kroku přejmenování polí — vizuální editor řeší úpravy pomocí `keyPath`, takže původní názvy polí musí zůstat zachovány.
 
 > V Next.js se minifikace přeskočí také tehdy, když `@intlayer/swc` není nainstalovaný nebo jej nelze načíst (Next.js nižší než 16.1.0). Plugin je ta polovina, která přepisuje přístupy ve zdrojovém kódu, takže přejmenování slovníků bez něj by ponechalo váš kód číst názvy polí, které již neexistují.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> K purge nedojde, jestliže je `optimize` nastaveno na `false` nebo jestliže je `editor.enabled` `true`. V Next.js se navíc přeskočí, když `@intlayer/swc` není dostupný a když jsou nakonfigurovaní volající kompatibilních adaptérů.
+> K purge nedojde, pokud je `optimize` nastaveno na `false`. Zůstává aktivní, pokud je `editor.enabled` `true` — vyčištěné pole nečte žádná komponenta, takže editor jej nikdy nevykreslí. V Next.js se navíc přeskočí, když `@intlayer/swc` není dostupný a když jsou nakonfigurovaní volající kompatibilních adaptérů.
 
 > Z bezpečnostních důvodů k purge nedojde ani tehdy, pokud nelze správně rozebrat (parse) nějaký zdrojový soubor. Dále se vynechá v situaci, kdy je výsledek z volání `useIntlayer` uložen do proměnné a předán dál způsobem, který statický analyzátor neumí sledovat (např. spread operátorem do objektu, nebo předáním přes properties (props) bez použití destrukce). V těchto případech zůstává celý slovník zachován.
 

package/docs/cs/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: Konfigurace (Configuration)
 description: Naučte se, jak nakonfigurovat Intlayer pro vaši aplikaci. Porozumějte různým nastavením a možnostem dostupným pro přizpůsobení Intlayer vašim potřebám.
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Analytika je nyní ve výchozím stavu zapnutá, pokud je nainstalován `@intlayer/analytics`"
   - version: 9.1.3
     date: 2026-08-06
     changes: "Změna `routing.enableProxy` na tři stavy: nenastaveno (auto), `true`, `false`"
@@ -380,8 +383,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * Zda je povoleno shromažďování analytiky (zobrazení stránek, expozice obsahu, A/B události).
-     * Vyžaduje nastavení `editor.clientId` pro atribuci.
-     * Výchozí: false
+     * Vyžaduje nainstalovaný balíček `@intlayer/analytics` a nastavení `editor.clientId` pro atribuci.
+     * Výchozí: true
      */
     enabled: true,
 
@@ -737,13 +740,13 @@ Definuje nastavení pro vestavěný vizuální editor, včetně portu serveru a
 
 Definuje nastavení související s analytikou Intlayer: shromažďování informací o tom, jaký obsah je uživatelům skutečně zobrazován (zobrazení stránek, expozice obsahu), a podporu A/B testování obsahu.
 
-Analytika je striktně opt-in: nic se neshromažďuje, pokud není `analytics.enabled` explicitně nastaveno na `true` **a** není nakonfigurován projektový klíč (`editor.clientId`) pro atribuci. Je-li vypnuta (výchozí stav), celá integrace analytiky je odstraněna z balíčku vaší aplikace (dead-code elimination).
+Analytika je ve výchozím stavu zapnutá (opt-out): sbírat začne, jakmile je nainstalován balíček `@intlayer/analytics` **a** je nakonfigurován projektový klíč (`editor.clientId`) pro atribuci. Nastavte `analytics.enabled` na `false` — nebo balíček neinstalujte — a celá integrace analytiky je odstraněna z balíčku vaší aplikace (dead-code elimination).
 
-| Pole            | Popis                                                                              | Typ       | Výchozí | Příklad | Poznámka                                                                                                                         |
-| --------------- | ---------------------------------------------------------------------------------- | --------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`       | Povolí shromažďování analytiky (zobrazení stránek, expozice obsahu, A/B události). | `boolean` | `false` | `true`  | Vyžaduje nastavení `editor.clientId` pro atribuci; jinak analytika zůstává vypnutá, i když je `enabled` nastaveno na `true`.     |
-| `flushInterval` | Milisekundy mezi automatickým dávkovým odesíláním na backend.                      | `number`  | `20000` | `10000` |                                                                                                                                  |
-| `sampleRate`    | Podíl relací k zaznamenání, od `0` (žádná) do `1` (všechny).                       | `number`  | `1`     | `0.5`   | Vzorkování je deterministické pro každou relaci, takže zaznamenaná relace hlásí všechny své události (žádné částečné trychtýře). |
+| Pole            | Popis                                                                              | Typ       | Výchozí | Příklad | Poznámka                                                                                                                                                                   |
+| --------------- | ---------------------------------------------------------------------------------- | --------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | Povolí shromažďování analytiky (zobrazení stránek, expozice obsahu, A/B události). | `boolean` | `true`  | `false` | Vyžaduje nainstalovaný balíček `@intlayer/analytics` a nastavení `editor.clientId` pro atribuci; jinak analytika zůstává vypnutá, i když je `enabled` nastaveno na `true`. |
+| `flushInterval` | Milisekundy mezi automatickým dávkovým odesíláním na backend.                      | `number`  | `20000` | `10000` |                                                                                                                                                                            |
+| `sampleRate`    | Podíl relací k zaznamenání, od `0` (žádná) do `1` (všechny).                       | `number`  | `1`     | `0.5`   | Vzorkování je deterministické pro každou relaci, takže zaznamenaná relace hlásí všechny své události (žádné částečné trychtýře).                                           |
 
 ---
 

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Inhalte nachverfolgen und A/B-Tests durchführen
 description: Erfahren Sie, wie @intlayer/analytics Seiten-/Gebietsschema-Aufrufe und die Anzeige von Inhalten nachverfolgt und wie Sie damit A/B-Tests für Ihre Intlayer-Inhalte durchführen können.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Analytics standardmäßig aktivieren, sobald `@intlayer/analytics` installiert ist"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — @intlayer/analytics Paket, Nachverfolgung auf Provider-/Node-Ebene, A/B-Tests, Dashboard"
@@ -57,7 +60,7 @@ Mit Intlayer können Sie bereits inhaltliche [Varianten](https://github.com/ayme
 
 ## Installation
 
-`@intlayer/analytics` ist eine **optionale Peer-Abhängigkeit** — sie wird niemals automatisch durch ein Framework-Paket installiert. Fügen Sie es neben `intlayer` hinzu:
+`@intlayer/analytics` ist eine **optionale Abhängigkeit** jedes Framework-Pakets (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …) und ist daher in den meisten Projekten bereits vorhanden. Installieren Sie es explizit, wenn Ihr Setup optionale Abhängigkeiten überspringt (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Wenn Sie es nicht installieren, wird jeder Integrationspunkt in ein No-Op aufgelöst — siehe [Keine Kosten, wenn nicht installiert](#keine-kosten-wenn-nicht-installiert) unten.
+Die Installation des Pakets genügt, um Analytics einzuschalten: `analytics.enabled` ist standardmäßig `true`, und `@intlayer/config` setzt es auf `false`, sobald das Paket in Ihrem Projekt nicht gefunden wird. Wenn Sie es nicht installieren, wird jeder Integrationspunkt in ein No-Op aufgelöst — siehe [Keine Kosten, wenn nicht installiert](#keine-kosten-wenn-nicht-installiert) unten.
 
 ## Konfiguration
 
-Analytics **verwendet den vorhandenen `editor` Konfigurationsblock wieder** — es gibt kein separates `analytics` Konfigurationsschema auszufüllen:
+Analytics benötigt keine Konfiguration, um zu starten: Es ist **standardmäßig aktiviert** und **verwendet den bestehenden `editor`-Konfigurationsblock** für Endpunkt und Projektschlüssel.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,16 +103,25 @@ export default config;
 
 Wenn Sie Intlayer selbst hosten, verweist die Analytik automatisch auf Ihre eigene Instanz, da sie `editor.backendURL` teilt.
 
-## Framework-Unterstützung
+### Deaktivieren (Opt-out)
 
-Analytics ist mit dem freigegebenen `IntlayerProvider` von `react-intlayer` verdrahtet und steht daher heute überall dort zur Verfügung, wo dieser Provider verwendet wird:
+Der optionale `analytics`-Block steuert die Erfassung — oder schaltet sie ab:
 
-| 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 |
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Standard: true — nimmt die gesamte Integration aus dem Bundle
+    flushInterval: 20_000, // Millisekunden zwischen zwei gebündelten Übertragungen
+    sampleRate: 1, // Anteil der aufgezeichneten Sitzungen, von 0 (keine) bis 1 (alle)
+  },
+};
+
+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).
 
 ## Verwendung
 
@@ -154,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";
 
@@ -164,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.
@@ -177,7 +219,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` folgt genau dem gleichen optionalen Abhängigkeitsmuster wie `@intlayer/editor`:
 
 - Jeder Integrationspunkt lädt das Paket über einen **dynamischen `import()` umhüllt in `try/catch`** — eine App, die `@intlayer/analytics` nie installiert, zahlt weder für Bundle-Größe noch Laufzeitkosten und sieht nie einen Fehler;
-- eine Umgebungsvariable zur Kompilierzeit (`INTLAYER_ANALYTICS_ENABLED`), die von `@intlayer/config` automatisch auf `'false'` gesetzt wird, wenn `editor.clientId` nicht konfiguriert ist, ermöglicht es Bundlern, die gesamte Integration **als Dead-Code zu eliminieren**;
+- eine Compile-Zeit-Umgebungsvariable (`INTLAYER_ANALYTICS_ENABLED`), die von `@intlayer/config` automatisch auf `'false'` gesetzt wird, wenn das Paket nicht installiert ist, `analytics.enabled` `false` ist oder `editor.clientId` nicht konfiguriert ist, ermöglicht Bundlern die **Dead-Code-Elimination** der gesamten Integration;
 - Analytics ist im Intlayer Editor/CMS-Vorschau-Iframe deaktiviert, sodass Editor-Sitzungen niemals als echter Traffic gewertet werden.
 
 ## Dashboard: Analytics-Seite
@@ -213,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)

package/docs/de/benchmark/tanstack.md

@@ -194,6 +194,8 @@ Die Idee hinter `Wuchale` ist interessant, aber noch keine tragfähige Lösung.
 
 `Tolgee` adressiert viele der oben genannten Probleme. Ich fand den Einstieg schwieriger als bei anderen Tools mit ähnlichen Ansätzen. Es bietet keine Typsicherheit, was es zudem sehr schwer macht, fehlende Schlüssel zur Kompilierzeit zu finden. Ich musste die Tolgee-APIs mit eigenen Funktionen umhüllen, um eine Erkennung fehlender Schlüssel hinzuzufügen.
 
+Das Paket ist relativ groß (~11,1 KB, was mehr als 2× `react-intlayer` ist).
+
 Auf TanStack Start hatte ich ebenfalls Reaktivitätsprobleme: Beim Sprachwechsel musste ich den Provider zum Re-render zwingen und Locale-Wechsel-Events abonnieren, damit das Laden in einer anderen Sprache korrekt funktionierte.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ Bei TanStack Start vermeiden Sie Next.js-spezifische Fallen (`setRequestLocale`,
 
 Dennoch teilt es dieselben großen Nachteile wie Stacks, die auf `t('a.b.c')` basieren: Optimierungen sind möglich, aber sehr zeitaufwendig, und große Projekte riskieren schlechte Praktiken (Namespaces + dynamisches Laden + Typen).
 
+Das Package ist besonders schwer (~17.3kb, etwa 3,5× `react-intlayer`).
+
 Die Nachrichtenformate weichen ebenfalls voneinander ab: `use-intl` verwendet ICU MessageFormat, während `i18next` sein eigenes Format nutzt – was Tooling oder Migrationen kompliziert macht, wenn man sie mischt.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ Die Nachrichtenformate weichen ebenfalls voneinander ab: `use-intl` verwendet IC
 
 `react-intl` ist eine performante Implementierung des Format.js-Teams. Die DX bleibt wortreich: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` erhöht die Komplexität, den zusätzlichen JavaScript-Aufwand und bindet die globale i18n-Instanz an viele Knoten im React-Tree.
 
+Das Package ist auch schwer (~14.4kb, was etwa 3× `react-intlayer` ist).
+
 ### 4 - Empfehlungen
 
 Dieser TanStack Start-Benchmark hat kein direktes Äquivalent zu `next-translate` (Next.js-Plugin + `getStaticProps`). Für Teams, die unbedingt eine `t()`-API mit einem ausgereiften Ökosystem wollen, bleiben `react-i18next` und `use-intl` "vernünftige" Entscheidungen, aber stellen Sie sich darauf ein, viel Zeit in die Optimierung zu investieren, um Leakage zu vermeiden.

package/docs/de/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> Die Minifizierung wird übersprungen, wenn `optimize` auf `false` gesetzt ist oder wenn `editor.enabled` auf `true` steht (der visuelle Editor benötigt die ursprünglichen Feldnamen, um die Bearbeitung zu ermöglichen).
+> Die Minifizierung wird übersprungen, wenn `optimize` auf `false` gesetzt ist. Wenn `editor.enabled` auf `true` steht, läuft sie weiterhin, jedoch ohne den Schritt zur Feldumbenennung — der visuelle Editor löst Bearbeitungen über `keyPath` auf, daher müssen die ursprünglichen Feldnamen erhalten bleiben.
 
 > Unter Next.js wird die Minifizierung außerdem übersprungen, wenn `@intlayer/swc` nicht installiert ist oder nicht geladen werden kann (Next.js unterhalb von 16.1.0). Das Plugin ist die Hälfte, die die Quellcode-Zugriffe umschreibt; die Wörterbücher ohne es umzubenennen, würde Ihren Code Feldnamen lesen lassen, die es nicht mehr gibt.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Der Purge wird übersprungen, wenn `optimize` auf `false` oder `editor.enabled` auf `true` gesetzt ist. Unter Next.js wird sie zusätzlich übersprungen, wenn `@intlayer/swc` nicht verfügbar ist und wenn Kompatibilitäts-Adapter-Aufrufer konfiguriert sind.
+> Der Purge wird übersprungen, wenn `optimize` auf `false` gesetzt ist. Er bleibt aktiv, wenn `editor.enabled` auf `true` steht — ein bereinigtes Feld wird von keiner Komponente gelesen, daher rendert der Editor es nie. Unter Next.js wird er zusätzlich übersprungen, wenn `@intlayer/swc` nicht verfügbar ist und wenn Kompatibilitäts-Adapter-Aufrufer konfiguriert sind.
 
 > Der Purge wird auch konservativ übersprungen, wenn eine Quelldatei nicht analysiert werden kann, oder wenn das Ergebnis von `useIntlayer` einer Variablen zugewiesen und auf eine Weise weitergegeben wird, die der statische Analysator nicht verfolgen kann (z.B. in ein Objekt eingefügt oder als Prop ohne Destrukturierung übergeben). In diesen Fällen wird das gesamte Wörterbuch beibehalten.
 

package/docs/de/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Verwendung in CI/CD-Pipelines
 
+Das Ausführen von `intlayer init` erstellt zwei einsatzbereite GitHub Actions-Workflows für Sie (siehe [Scaffolded GitHub Actions](#scaffolded-github-actions) unten). Das Beispiel hier zeigt das äquivalente Setup mit dem `ci`-Befehl für ein Monorepo, bei dem Anmeldedaten pro Projekt aus `INTLAYER_PROJECT_CREDENTIALS` injiziert werden.
+
 In Ihrer CI/CD-Konfiguration (z. B. GitHub Actions, GitLab CI) setzen Sie `INTLAYER_PROJECT_CREDENTIALS` als Geheimnis:
 
 ```yaml