@intlayer/docs 9.3.2 → 9.4.0-canary.0

package/blog/uk/nextjs-multilingual-seo-comparison.md

@@ -63,12 +63,12 @@ author: aymericzip
 
 Розробники часто забувають правильно посилатися на свої сторінки для різних локалей, тож давайте подивимось, як це працює на практиці з різними бібліотеками.
 
-### **next-intl**
-
 <Tabs>
-  <Tab label="next-intl">
+  <Tab label="next-intl" value="next-intl">
+
+### **next-intl**
 
-```tsx fileName="src/app/[locale]/about/layout.tsx
+```tsx fileName="src/app/[locale]/about/layout.tsx"
 import type { Metadata } from "next";
 import { locales, defaultLocale } from "@/i18n";
 import { getTranslations, unstable_setRequestLocale } from "next-intl/server";
@@ -153,10 +153,10 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### **next-i18next**
-
   </Tab>
-  <Tab label="next-i18next">
+  <Tab label="next-i18next" value="next-i18next">
+
+### **next-i18next**
 
 ```ts fileName="i18n.config.ts"
 export const locales = ["en", "fr"] as const;
@@ -256,10 +256,10 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### **Intlayer**
-
   </Tab>
-  <Tab label="intlayer">
+  <Tab label="intlayer" value="intlayer">
+
+### **Intlayer**
 
 ````typescript fileName="src/app/[locale]/about/layout.tsx"
 import { getIntlayer, getMultilingualUrls } from "intlayer";

package/blog/vi/nextjs-multilingual-seo-comparison.md

@@ -63,12 +63,12 @@ Dưới đây là danh sách kiểm tra mà mọi ứng dụng đa ngôn ngữ n
 
 Các nhà phát triển thường quên tham chiếu đúng các trang của họ qua các ngôn ngữ, vì vậy hãy cùng xem cách điều này hoạt động trong thực tế với các thư viện khác nhau.
 
-### **next-intl**
-
 <Tabs>
-  <Tab label="next-intl">
+  <Tab label="next-intl" value="next-intl">
+
+### **next-intl**
 
-```tsx fileName="src/app/[locale]/about/layout.tsx
+```tsx fileName="src/app/[locale]/about/layout.tsx"
 import type { Metadata } from "next";
 import { locales, defaultLocale } from "@/i18n";
 import { getTranslations, unstable_setRequestLocale } from "next-intl/server";
@@ -154,10 +154,10 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### **next-i18next**
-
   </Tab>
-  <Tab label="next-i18next">
+  <Tab label="next-i18next" value="next-i18next">
+
+### **next-i18next**
 
 ```ts fileName="i18n.config.ts"
 export const locales = ["en", "fr"] as const;
@@ -258,10 +258,10 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### **Intlayer**
-
   </Tab>
-  <Tab label="intlayer">
+  <Tab label="intlayer" value="intlayer">
+
+### **Intlayer**
 
 ````typescript fileName="src/app/[locale]/about/layout.tsx"
 import { getIntlayer, getMultilingualUrls } from "intlayer";

package/blog/zh/nextjs-multilingual-seo-comparison.md

@@ -63,12 +63,12 @@ author: aymericzip
 
 开发者经常忘记在不同语言环境中正确引用他们的页面，因此让我们看看使用不同库时这是如何实际操作的。
 
-### **next-intl**
-
 <Tabs>
-  <Tab label="next-intl">
+  <Tab label="next-intl" value="next-intl">
+
+### **next-intl**
 
-```tsx fileName="src/app/[locale]/about/layout.tsx
+```tsx fileName="src/app/[locale]/about/layout.tsx"
 import type { Metadata } from "next";
 import { locales, defaultLocale } from "@/i18n";
 import { getTranslations, unstable_setRequestLocale } from "next-intl/server";
@@ -155,10 +155,10 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### **next-i18next**
-
   </Tab>
-  <Tab label="next-i18next">
+  <Tab label="next-i18next" value="next-i18next">
+
+### **next-i18next**
 
 ```ts fileName="i18n.config.ts"
 export const locales = ["en", "fr"] as const;
@@ -258,10 +258,10 @@ export default function robots(): MetadataRoute.Robots {
 }
 ```
 
-### **Intlayer**
-
   </Tab>
-  <Tab label="intlayer">
+  <Tab label="intlayer" value="intlayer">
+
+### **Intlayer**
 
 ````typescript fileName="src/app/[locale]/about/layout.tsx"
 import { getIntlayer, getMultilingualUrls } from "intlayer";

package/docs/ar/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: مهارات الوكيل
-description: تعرّف على كيفية استخدام مهارات الوكلاء في Intlayer لتحسين فهم وكيل الذكاء الاصطناعي لمشروعك، بما في ذلك أدلة الإعداد الشاملة لبيانات التعريف (Metadata)، وخرائط المواقع (Sitemaps)، وإجراءات الخادم (Server Actions).
+title: Agent Skills
+description: تعرّف على كيفية استخدام Intlayer Agent Skills لتحسين فهم وكيل الذكاء الاصطناعي لمشروعك، بما في ذلك أدلة الإعداد الشاملة لبيانات التعريف (Metadata)، وخرائط المواقع (Sitemaps)، وإجراءات الخادم (Server Actions).
 keywords:
   - Intlayer
-  - مهارات الوكلاء
+  - Agent Skills
   - وكيل الذكاء الاصطناعي
   - التدويل
   - الوثائق
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# مهارات الوكيل
+# Agent Skills
 
 ## الإعداد
 
 ### استخدام CLI
 
-أمر `intlayer init skills` هو أسهل طريقة لإعداد مهارات الوكلاء في مشروعك. يقوم باكتشاف بيئتك وتثبيت ملفات التهيئة اللازمة للمنصات التي تفضّلها.
+أمر `intlayer init skills` هو أسهل طريقة لإعداد Agent Skills في مشروعك. يقوم باكتشاف بيئتك وتثبيت ملفات التهيئة اللازمة للمنصات التي تفضّلها.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. افتح لوحة الأوامر (Ctrl+Shift+P أو Cmd+Shift+P).
 2. اكتب `Intlayer: Setup AI Agent Skills`
 3. اختر المنصة التي تستخدمها (مثل `VS Code` و `Cursor` و `Windsurf` و `OpenCode` و `Claude Code` و `GitHub Copilot Workspace` إلخ).
-4. اختر المهارات التي تريد تثبيتها (مثل `Next.js` و `React` و `Vite` و `Compiler` و `Configuration`).
+4. اختر Agent Skills التي تريد تثبيتها (مثل `Next.js` و `React` و `Vite` و `Compiler` و `Configuration`).
 5. اضغط على Enter.
 
-## قائمة المهارات
+## قائمة Agent Skills
 
 **intlayer-config**
 

package/docs/ar/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | تتبع عرض المحتوى وإجراء اختبارات A/B
 description: اكتشف كيف يقوم @intlayer/analytics بتتبع مشاهدات الصفحات/اللغات وعرض المحتوى، وكيفية استخدامه لإجراء اختبارات A/B على محتوى Intlayer الخاص بك.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "تفعيل التحليلات افتراضيًا عند تثبيت `@intlayer/analytics`"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — @intlayer/analytics package, provider/node-level tracking, A/B testing, dashboard"
@@ -57,7 +60,7 @@ author: aymericzip
 
 ## التثبيت
 
-حزمة `@intlayer/analytics` هي **تبعية نظيرة واختيارية (peer, optional)** — لا يتم تثبيتها تلقائيًا أبدًا بواسطة حزم إطارات العمل. أضفها جنبًا إلى جنب مع `intlayer`:
+`@intlayer/analytics` هي **تبعية اختيارية (optional dependency)** لكل حزمة إطار عمل (`react-intlayer`، `next-intlayer`، `vue-intlayer`، …)، لذا فهي موجودة بالفعل في معظم المشاريع. ثبّتها صراحةً إذا كان إعدادك يتخطى التبعيات الاختيارية (`npm install --no-optional`، …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-إذا لم تقم بتثبيتها، فإن كل نقطة تكامل تتحول إلى عملية لا تفعل شيئًا (no-op) — انظر [تكلفة صفرية عند عدم التثبيت](#تكلفة-صفرية-عند-عدم-التثبيت) أدناه.
+تثبيت الحزمة هو كل ما يلزم لتفعيل التحليلات: قيمة `analytics.enabled` الافتراضية هي `true`، ويحوّلها `@intlayer/config` إلى `false` عندما لا يعثر على الحزمة في مشروعك. إذا لم تقم بتثبيتها، فإن كل نقطة تكامل تتحول إلى عملية لا تفعل شيئًا (no-op) — انظر [تكلفة صفرية عند عدم التثبيت](#تكلفة-صفرية-عند-عدم-التثبيت) أدناه.
 
 ## التكوين (Configuration)
 
-التحليلات **تعيد استخدام كتلة التكوين `editor` الحالية** — لا يوجد مخطط تكوين `analytics` منفصل لملئه:
+لا تحتاج التحليلات إلى أي إعداد للبدء: فهي **مفعّلة افتراضيًا** و**تعيد استخدام كتلة إعدادات `editor` الموجودة** لنقطة الإرسال ومفتاح المشروع.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 إذا قمت بالاستضافة الذاتية لـ Intlayer (self-host)، فإن التحليلات تشير تلقائيًا إلى النسخة الخاصة بك لأنها تتشارك `editor.backendURL`.
 
+### إلغاء الاشتراك (Opt-out)
+
+تتيح كتلة `analytics` الاختيارية ضبط عملية الجمع — أو إيقافها تمامًا:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // الافتراضي: true — يستبعد التكامل بالكامل من الحزمة
+    flushInterval: 20_000, // المللي ثانية بين عمليتَي إرسال مجمّعتين
+    sampleRate: 1, // نسبة الجلسات المسجَّلة، من 0 (لا شيء) إلى 1 (الكل)
+  },
+};
+
+export default config;
+```
+
+إلغاء تثبيت `@intlayer/analytics` له نفس أثر `enabled: false`. راجع [مرجع الإعدادات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md) للاطلاع على قائمة الحقول الكاملة.
+
 ## دعم إطارات العمل
 
 التحليلات مدمجة في `IntlayerProvider` المشترك من `react-intlayer`، لذا فهي متاحة اليوم في أي مكان يُستخدم فيه هذا المزود:
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 تتبع `@intlayer/analytics` نفس نمط التبعية الاختيارية المتبع في `@intlayer/editor`:
 
 - تقوم كل نقطة تكامل بتحميل الحزمة عبر **استيراد ديناميكي `import()` مغلف بـ `try/catch`** — التطبيق الذي لم يقم أبدًا بتثبيت `@intlayer/analytics` لا يدفع أي تكلفة لحجم الحزمة أو وقت التشغيل، ولا يرى خطأ أبدًا؛
-- متغير البيئة في وقت التجميع (`INTLAYER_ANALYTICS_ENABLED`)، والذي يتم تعيينه تلقائيًا إلى `'false'` بواسطة `@intlayer/config` كلما لم يتم تكوين `editor.clientId`، يسمح للمجمعين (bundlers) بـ **إزالة التعليمات البرمجية الميتة (dead-code-eliminate)** للتكامل بأكمله؛
+- متغيّر بيئة يُحدَّد وقت الترجمة (`INTLAYER_ANALYTICS_ENABLED`)، يضبطه `@intlayer/config` تلقائيًا على `'false'` عندما لا تكون الحزمة مثبّتة، أو تكون `analytics.enabled` تساوي `false`، أو لا يكون `editor.clientId` مُعدًّا، ما يسمح للـ bundlers بـ**إزالة التكامل بالكامل كشيفرة ميتة (dead-code-eliminate)**؛
 - يتم تعطيل التحليلات داخل نافذة إطار المعاينة (iframe) الخاصة بمحرر Intlayer / CMS، لذا لا يتم حساب جلسات المحرر كحركة مرور حقيقية أبدًا.
 
 ## لوحة التحكم (Dashboard): صفحة التحليلات

package/docs/ar/bundle_optimization.md

@@ -159,7 +159,7 @@ pnpm add -D webpack-bundle-analyzer
 bun add -d webpack-bundle-analyzer
 ```
 
-```typescript fileName="webpack.config.ts
+```typescript fileName="webpack.config.ts"
 import { BundleAnalyzerPlugin } from "webpack-bundle-analyzer";
 
 export default {
@@ -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` مثبّتة أو يتعذر تحميلها (إصدار Next.js أقل من 16.1.0). فالإضافة هي النصف الذي يعيد كتابة عمليات الوصول في المصدر، ومن ثم فإن إعادة تسمية القواميس من دونها ستترك شيفرتك تقرأ أسماء حقول لم تعد موجودة.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> يتم تخطي التطهير (Purge) عندما يكون `optimize` في وضع `false` أو عندما يكون `editor.enabled` في وضع `true`. وفي Next.js تُتخطى كذلك عندما تكون `@intlayer/swc` غير متاحة، وعند تهيئة مستدعِيات محوّلات التوافق.
+> يتم تخطي التطهير (Purge) عندما يكون `optimize` في وضع `false`. ويظل نشطًا عندما يكون `editor.enabled` في وضع `true` — إذ إن الحقل الذي تمت إزالته لا يقرأه أي مكوّن، لذا لا يعرضه المحرر مطلقًا. وفي Next.js تُتخطى العملية كذلك عندما تكون `@intlayer/swc` غير متاحة، وعند تهيئة مستدعِيات محوّلات التوافق.
 
 > يتم أيضًا تخطي التطهير كإجراء احترازي عندما يتعذر تحليل ملف المصدر، أو عندما يتم تعيين نتيجة `useIntlayer` لمتغير ويتم تمريرها بطرق لا يستطيع المحلل الثابت تتبعها (مثل وضعها في كائن بطريقة النشر، تمريرها كخاصية بدون تفكيك الهيكل). في تلك الحالات، يتم الاحتفاظ بالقاموس بالكامل.
 

package/docs/ar/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` من أجل الإسناد (attribution).
-     * الافتراضي: false
+     * يتطلب تثبيت `@intlayer/analytics` وضبط `editor.clientId` من أجل الإسناد (attribution).
+     * الافتراضي: true
      */
     enabled: true,
 
@@ -471,6 +474,27 @@ const config: IntlayerConfig = {
      */
     prune: true,
 
+    /**
+     * تجميع أجزاء القاموس لكل لغة حسب حدود تقسيم الشيفرة التي تستخدمها، بحيث تجلب
+     * الصفحة المحمّلة بتكاسل محتواها في طلب واحد.
+     * الافتراضي: true
+     *
+     * ملاحظة:
+     * - ينطبق فقط على القواميس التي تستخدم `importMode: 'dynamic'`.
+     */
+    chunkGrouping: true,
+
+    /**
+     * تحميل القاموس مع الجزء الذي يستخدمه، بدلاً من جلبه بعد عرض ذلك الجزء. تُعرض
+     * القراءات بشكل متزامن بدلاً من التعليق، لذا لم تعد حالة التحميل تومض أثناء
+     * التنقل.
+     * الافتراضي: true
+     *
+     * ملاحظة:
+     * - يتم انتظار اللغة المحددة فقط، لذا تنزّل الصفحة اللغة التي تعرضها فحسب.
+     */
+    dictionariesPreload: true,
+
     /**
      * صيغة الإخراج لملفات القاموس المولدة.
      * الافتراضي: ['cjs', 'esm']
@@ -708,13 +732,13 @@ export default config;
 
 يحدد الإعدادات المتعلقة بتحليلات Intlayer: جمع بيانات حول المحتوى الذي يُعرض فعليًا للمستخدمين (مشاهدات الصفحات، حالات ظهور المحتوى) وتمكين اختبارات A/B على المحتوى.
 
-التحليلات اختيارية بشكل صارم (opt-in): لا يتم جمع أي شيء ما لم يتم ضبط `analytics.enabled` صراحةً على `true` **و** تكوين مفتاح مشروع (`editor.clientId`) من أجل الإسناد. عند التعطيل (الوضع الافتراضي)، تتم إزالة تكامل التحليلات بالكامل من حزمة تطبيقك (dead-code elimination).
+التحليلات مفعّلة افتراضيًا (opt-out): يبدأ الجمع بمجرد تثبيت حزمة `@intlayer/analytics` **و** تكوين مفتاح مشروع (`editor.clientId`) من أجل الإسناد. اضبط `analytics.enabled` على `false` — أو لا تثبّت الحزمة — وتتم إزالة تكامل التحليلات بالكامل من حزمة تطبيقك (dead-code elimination).
 
-| الحقل           | الوصف                                                                         | النوع     | الافتراضي | المثال  | ملاحظة                                                                                                     |
-| --------------- | ----------------------------------------------------------------------------- | --------- | --------- | ------- | ---------------------------------------------------------------------------------------------------------- |
-| `enabled`       | يُفعّل جمع بيانات التحليلات (مشاهدات الصفحات، حالات ظهور المحتوى، أحداث A/B). | `boolean` | `false`   | `true`  | يتطلب ضبط `editor.clientId` من أجل الإسناد؛ وإلا تبقى التحليلات معطّلة حتى لو كانت `enabled` تساوي `true`. |
-| `flushInterval` | المللي ثانية بين عمليات الإرسال المجمّعة التلقائية إلى الخادم الخلفي.         | `number`  | `20000`   | `10000` |                                                                                                            |
-| `sampleRate`    | نسبة الجلسات المراد تسجيلها، من `0` (لا شيء) إلى `1` (الكل).                  | `number`  | `1`       | `0.5`   | أخذ العينات حتمي لكل جلسة، لذا فإن الجلسة المسجَّلة تُبلّغ عن جميع أحداثها (دون قوائم تحويل جزئية).        |
+| الحقل           | الوصف                                                                         | النوع     | الافتراضي | المثال  | ملاحظة                                                                                                                                  |
+| --------------- | ----------------------------------------------------------------------------- | --------- | --------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | يُفعّل جمع بيانات التحليلات (مشاهدات الصفحات، حالات ظهور المحتوى، أحداث A/B). | `boolean` | `true`    | `false` | يتطلب تثبيت `@intlayer/analytics` وضبط `editor.clientId` من أجل الإسناد؛ وإلا تبقى التحليلات معطّلة حتى لو كانت `enabled` تساوي `true`. |
+| `flushInterval` | المللي ثانية بين عمليات الإرسال المجمّعة التلقائية إلى الخادم الخلفي.         | `number`  | `20000`   | `10000` |                                                                                                                                         |
+| `sampleRate`    | نسبة الجلسات المراد تسجيلها، من `0` (لا شيء) إلى `1` (الكل).                  | `number`  | `1`       | `0.5`   | أخذ العينات حتمي لكل جلسة، لذا فإن الجلسة المسجَّلة تُبلّغ عن جميع أحداثها (دون قوائم تحويل جزئية).                                     |
 
 ---
 
@@ -1047,15 +1071,17 @@ dictionary: {
 
 > أثناء التحسين، سيقوم Intlayer باستبدال استدعاءات القواميس لتحسين تقسيم الكود (chunking) بحيث تستورد الحزمة الناتجة القواميس المستخدمة فعلياً فقط.
 
-| الحقل             | الوصف                                                                       | النوع                            | الافتراضي                                                                                                                                                                         | مثال                                                                          | ملاحظة                                                                                                                                                                                                                                                                           |
-| ----------------- | --------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `mode`            | يتحكم في وضع البناء.                                                        | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: يتم تشغيل البناء تلقائياً أثناء بناء التطبيق. <br/> • `'manual'`: يتم تنفيذه فقط عند استدعاء أمر بناء صريح. <br/> • يمكن استخدامه لإيقاف بناء القواميس (مثلاً لتجنب الجري في بيئات Node.js).                                                                         |
-| `optimize`        | يتحكم في ما إذا كان ينبغي إجراء تحسينات البناء.                             | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • إذا لم يتم تعريفه، فسيتم تشغيل التحسين عند بناء إطار العمل (Vite/Next.js). <br/> • `true` يفرض التحسين حتى في وضع التطوير. <br/> • `false` يعطله. <br/> • عند تشغيله، يستبدل استدعاءات القواميس لتحسين الـ chunking. <br/> • يتطلب إضافات `@intlayer/babel` و `@intlayer/swc`. |
-| `minify`          | يحدد ما إذا كان ينبغي ضغط القواميس لتقليل حجم الحزمة.                       | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • يحدد ما إذا كانت الحزمة يجب أن تكون مضغوطة.<br/>• الافتراضي: `true` في الإنتاج.<br/>• سيتم تجاهل هذا الخيار إذا تم تعطيل `optimize`.<br/>• سيتم تجاهل هذا الخيار إذا كان `editor.enabled` صحيحاً.                                                                              |
-| `prune`           | يحدد ما إذا كان ينبغي حذف المفاتيح غير المستخدمة في القواميس.               | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • يحدد ما إذا كانت الحزمة يجب أن يتم تنظيفها.<br/>• الافتراضي: `true` في الإنتاج.<br/>• سيتم تجاهل هذا الخيار إذا تم تعطيل `optimize`.                                                                                                                                           |
-| `checkTypes`      | يشير إلى ما إذا كان ينبغي للبناء التحقق من أنواع TypeScript وتسجيل الأخطاء. | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | قد يبطئ عملية البناء.                                                                                                                                                                                                                                                            |
-| `outputFormat`    | يتحكم في صيغة إخراج القواميس.                                               | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                  |
-| `traversePattern` | الأنماط التي تحدد الملفات التي يتم فحصها أثناء التحسين.                     | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • قيد التحسين على الملفات ذات الصلة لزيادة أداء البناء. <br/> • سيتم تجاهله إذا توقف `optimize`. <br/> • يستخدم أنماط glob.                                                                                                                                                      |
+| الحقل                 | الوصف                                                                                     | النوع                            | الافتراضي                                                                                                                                                                         | مثال                                                                          | ملاحظة                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| --------------------- | ----------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `mode`                | يتحكم في وضع البناء.                                                                      | `'auto'` &#124; <br/> `'manual'` | `'auto'`                                                                                                                                                                          | `'manual'`                                                                    | • `'auto'`: يتم تشغيل البناء تلقائياً أثناء بناء التطبيق. <br/> • `'manual'`: يتم تنفيذه فقط عند استدعاء أمر بناء صريح. <br/> • يمكن استخدامه لإيقاف بناء القواميس (مثلاً لتجنب الجري في بيئات Node.js).                                                                                                                                                                                                                                           |
+| `optimize`            | يتحكم في ما إذا كان ينبغي إجراء تحسينات البناء.                                           | `boolean`                        | `undefined`                                                                                                                                                                       | `process.env.NODE_ENV === 'production'`                                       | • إذا لم يتم تعريفه، فسيتم تشغيل التحسين عند بناء إطار العمل (Vite/Next.js). <br/> • `true` يفرض التحسين حتى في وضع التطوير. <br/> • `false` يعطله. <br/> • عند تشغيله، يستبدل استدعاءات القواميس لتحسين الـ chunking. <br/> • يتطلب إضافات `@intlayer/babel` و `@intlayer/swc`.                                                                                                                                                                   |
+| `minify`              | يحدد ما إذا كان ينبغي ضغط القواميس لتقليل حجم الحزمة.                                     | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | • يحدد ما إذا كانت الحزمة يجب أن تكون مضغوطة.<br/>• الافتراضي: `true` في الإنتاج.<br/>• سيتم تجاهل هذا الخيار إذا تم تعطيل `optimize`.<br/>• سيتم تجاهل هذا الخيار إذا كان `editor.enabled` صحيحاً.                                                                                                                                                                                                                                                |
+| `prune`               | يحدد ما إذا كان ينبغي حذف المفاتيح غير المستخدمة في القواميس.                             | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • يحدد ما إذا كانت الحزمة يجب أن يتم تنظيفها.<br/>• الافتراضي: `true` في الإنتاج.<br/>• سيتم تجاهل هذا الخيار إذا تم تعطيل `optimize`.                                                                                                                                                                                                                                                                                                             |
+| `checkTypes`          | يشير إلى ما إذا كان ينبغي للبناء التحقق من أنواع TypeScript وتسجيل الأخطاء.               | `boolean`                        | `false`                                                                                                                                                                           |                                                                               | قد يبطئ عملية البناء.                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `chunkGrouping`       | يحدد ما إذا كان يجب تجميع أجزاء القاموس لكل لغة حسب حدود تقسيم الشيفرة التي تستخدمها.     | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • بدون التجميع، ترسل الصفحة المكوّنة من مكوّنات عديدة طلباً لكل قاموس.<br/>• القواميس التي يُوصل إليها من عدة حدود تنتقل إلى جزء مشترك، لذا لا تحمل أي صفحة محتوى صفحة أخرى.<br/>• ينطبق فقط على القواميس التي تستخدم `importMode: 'dynamic'`.<br/>• ينطبق فقط على بناء العميل، وفقط عند التحزيم (ليس في وضع التطوير).                                                                                                                             |
+| `dictionariesPreload` | يحدد ما إذا كان يجب تحميل القاموس مع الجزء الذي يستخدمه، بدلاً من جلبه بعد عرض ذلك الجزء. | `boolean`                        | `true`                                                                                                                                                                            |                                                                               | • تنتظر نقطة الدخول المولَّدة لغة التصفح في المستوى الأعلى، لذا لا يُعتبر المسار المحمّل بتكاسل محمّلاً حتى يتوفر محتواه.<br/>• تُعرض القراءات بشكل متزامن بدلاً من التعليق، لذا لم تعد حالة التحميل تومض أثناء التنقل.<br/>• يتم انتظار اللغة المحددة فقط، لذا تنزّل الصفحة اللغة التي تعرضها فحسب.<br/>• ينطبق فقط على القواميس التي تستخدم `importMode: 'dynamic'` في بناء العميل.<br/>• يتطلب أداة تحزيم تدعم top-level await (Vite، esbuild). |
+| `outputFormat`        | يتحكم في صيغة إخراج القواميس.                                                             | `('esm' &#124; 'cjs')[]`         | `['esm', 'cjs']`                                                                                                                                                                  | `['cjs']`                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `traversePattern`     | الأنماط التي تحدد الملفات التي يتم فحصها أثناء التحسين.                                   | `string[]`                       | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • قيد التحسين على الملفات ذات الصلة لزيادة أداء البناء. <br/> • سيتم تجاهله إذا توقف `optimize`. <br/> • يستخدم أنماط glob.                                                                                                                                                                                                                                                                                                                        |
 
 ---
 

package/docs/ar/dictionary/content_file.md

@@ -536,28 +536,6 @@ export default aboutPageMetaContent;
 
 > انظر [المتغيرات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/variants.md) لمزيد من المعلومات.
 
-#### `meta` (`Record<string, string | number | boolean>`)
-
-يُستخدم بالاقتران مع السجلات الديناميكية (Dynamic Records)، ويسمح هذا الحقل بالإعلان عن السجلات التي يديرها نظام إدارة المحتوى (CMS) أو البيانات التعسفية التي يتم جلبها في وقت التشغيل بواسطة معرف غير شفاف. يتم تحديد هوية القاموس من خلال مجموعة عشوائية من أزواج المفتاح والقيمة المعلنة في حقل `meta` هذا.
-
-**مثال:**
-
-```typescript
-{
-  key: "product-copy",
-  meta: {
-    id: "prod_abc",
-    userId: "user_123"
-  },
-  content: {
-    name: "Widget Pro",
-    description: "The best widget."
-  }
-}
-```
-
-> انظر [السجلات الديناميكية](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dynamic_dictionaries/dynamic_content.md) لمزيد من المعلومات.
-
 ### خصائص نظام إدارة المحتوى
 
 ##### `version` (سلسلة نصية)

package/docs/ar/dictionary/function_fetching.md

@@ -89,6 +89,29 @@ export default asyncFunctionContent;
 
 في هذه الحالة، تقوم دالة `fakeFetch` بمحاكاة تأخير لتقليد وقت استجابة الخادم. يقوم Intlayer بتنفيذ الدالة غير المتزامنة ويستخدم النتيجة كمحتوى للمفتاح `text`.
 
+## جلب المحتوى عن بُعد
+
+يمكنك أيضًا إسناد وعد (Promise) مباشرةً إلى حقل محتوى. ينتظر Intlayer نتيجته أثناء بناء القواميس ويُدرج القيمة الناتجة:
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat={["typescript", "esm", "commonjs"]}
+import type { Dictionary } from "intlayer";
+
+const remoteContent = {
+  key: "remote_content",
+  content: {
+    externalContent: fetch("https://example.com").then((res) => res.json()),
+  },
+} satisfies Dictionary;
+
+export default remoteContent;
+```
+
+```plaintext fileName="**/*.content.json" contentDeclarationFormat="json"
+لا توجد طريقة لجلب المحتوى من ملف JSON، استخدم ملف .ts أو .js بدلاً من ذلك
+```
+
+> يتم تنفيذ الطلب في وقت البناء، لذا فإن البيانات المجلوبة هي لقطة مضمّنة في القاموس. أعد بناء القواميس لتحديثها.
+
 ## استخدام المحتوى المعتمد على الدوال في مكونات React
 
 لاستخدام المحتوى المعتمد على الدوال في مكون React، تحتاج إلى استيراد `useIntlayer` من `react-intlayer` واستدعاؤه مع معرف المحتوى لاسترجاع المحتوى. إليك مثالاً:

package/docs/ar/eslint.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-08-12
-updatedAt: 2026-08-12
+updatedAt: 2026-08-13
 title: إضافة ESLint | قواعد الفحص (Lint) لـ Intlayer
 description: اكتشف النصوص المكتوبة يدويًا (hardcoded)، والاستدعاءات الديناميكية التي لا يمكن لمترجم Intlayer تحسينها، ومحتوى القواميس غير المستخدم، باستخدام eslint-plugin-intlayer. متوافقة مع ESLint و oxlint عبر React و Vue و Svelte و Angular و Astro.
 keywords:
@@ -52,7 +52,7 @@ pnpm add --save-dev eslint-plugin-intlayer
 yarn add --dev eslint-plugin-intlayer
 ```
 
-تتطلب الإصدار 9 من ESLint أو أحدث (flat config).
+تتطلب الإصدار 9 من ESLint أو أحدث (flat config). ESLint 10 مدعوم.
 
 ## الاستخدام
 
@@ -61,20 +61,20 @@ yarn add --dev eslint-plugin-intlayer
 <Tabs defaultTab="eslint">
   <Tab label="ESLint" value="eslint">
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [...intlayer.configs.recommended];
 ```
 
-أو قم بتمكين القواعد واحدة تلو الأخرى:
+أو انشر أحد الإعدادات وحدّد مستويات الخطورة بنفسك:
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 
 export default [
+  ...intlayer.configs.recommended,
   {
-    plugins: { intlayer },
     rules: {
       "intlayer/no-raw-text": "warn",
       "intlayer/static-dictionary-key": "error",
@@ -144,7 +144,7 @@ const { title } = useIntlayer("home");
 
 **الخيارات**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-raw-text": [
     "warn",
@@ -247,7 +247,7 @@ export default {
 
 **الخيارات**
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 {
   "intlayer/no-unused-content": [
     "warn",
@@ -296,7 +296,7 @@ export default {
 | قوالب Angular             | `.component.html` | `@angular-eslint/template-parser` |
 | Astro                     | `.astro`          | `astro-eslint-parser`             |
 
-```javascript fileName="eslint.config.mjs" codeFormat="esm"
+```javascript fileName="eslint.config.mjs"
 import intlayer from "eslint-plugin-intlayer";
 import tseslint from "typescript-eslint";
 import vueParser from "vue-eslint-parser";

package/docs/ar/interest_of_intlayer.md

@@ -48,7 +48,7 @@ author: aymericzip
 
 ** وكيل الذكاء الاصطناعي **
 
-يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
+يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
 **ميزة**
 

package/docs/ar/intlayer_with_analog.md

@@ -75,7 +75,7 @@ author: aymericzip
 
 ** وكيل الذكاء الاصطناعي **
 
-يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
+يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
 **الأتمتة**
 

package/docs/ar/intlayer_with_angular_19.md

@@ -56,7 +56,7 @@ author: aymericzip
 
 ** وكيل الذكاء الاصطناعي **
 
-يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
+يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
 **الأتمتة**
 

package/docs/ar/intlayer_with_angular_21.md

@@ -55,7 +55,7 @@ author: aymericzip
 
 ** وكيل الذكاء الاصطناعي **
 
-يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
+يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
 **الأتمتة**
 

package/docs/ar/intlayer_with_astro.md

@@ -79,7 +79,7 @@ author: aymericzip
 
 ** وكيل الذكاء الاصطناعي **
 
-يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[مهارات الوكيل](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
+يؤدي تحديد موقع المحتوى المشترك ** إلى تقليل السياق المطلوب ** بواسطة نماذج اللغات الكبيرة (LLMs). يأتي Intlayer أيضًا مزودًا بمجموعة من الأدوات، مثل **CLI** لاختبار الترجمات المفقودة،**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**، **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** و**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/agent_skills.md)**، لجعل تجربة المطور (DX) أكثر سلاسة للذكاء الاصطناعي وكلاء.
 
 **الأتمتة**