@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/ar/per_locale_file.md

@@ -18,6 +18,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "بدء التاريخ"
+author: aymericzip
 ---
 
 # إعلان محتوى "لكل لغة" في Intlayer

package/docs/ar/plugins/sync-json.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-12-13
+updatedAt: 2026-06-21
 title: مكون مزامنة JSON
 description: مزامنة قواميس Intlayer مع ملفات JSON الخاصة بالتدويل من طرف ثالث (i18next، next-intl، react-intl، vue-i18n، والمزيد). احتفظ بنظام التدويل الحالي لديك أثناء استخدام Intlayer لإدارة وترجمة واختبار رسائلك.
 keywords:
@@ -24,12 +24,16 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 9.0.0
+    date: 2026-06-21
+    changes: "إضافة خيار splitKeys (قاموس واحد لكل مفتاح مساحة اسم من المستوى الأعلى) لتخطيطات الملف الواحد في next-intl / react-intl"
   - version: 7.5.0
     date: 2025-12-13
     changes: "إضافة دعم تنسيقات ICU و i18next"
   - version: 6.1.6
     date: 2025-10-05
     changes: "الوثائق الأولية لمكون مزامنة JSON"
+author: aymericzip
 ---
 
 # مزامنة JSON (جسور التدويل) - مزامنة JSON مع دعم ICU / i18next
@@ -61,7 +65,62 @@ pnpm add -D @intlayer/sync-json-plugin
 npm i -D @intlayer/sync-json-plugin
 ```
 
-## بداية سريعة
+## Plugins
+
+توفر هذه الحزمة مكونين إضافيين:
+
+- `loadJSON`: تحميل ملفات JSON إلى قواميس Intlayer.
+  - يستخدم هذا المكون الإضافي لتحميل ملفات JSON من مصدر وسيتم تحميلها في قواميس Intlayer. يمكنه مسح جميع قواعد التعليمات البرمجية والبحث عن ملفات JSON محددة.
+    يمكن استخدام هذا المكون الإضافي
+    - إذا كنت تستخدم مكتبة i18n تفرض موقعًا محددًا لملفات JSON الخاصة بك ليتم تحميلها (على سبيل المثال: `next-intl`، `i18next`، `react-intl`، `vue-i18n`، إلخ)، ولكنك تريد وضع إعلان المحتوى الخاص بك حيثما تريد في قاعدة التعليمات البرمجية الخاصة بك.
+    - يمكن استخدامه أيضًا إذا كنت ترغب في جلب رسائلك من مصدر بعيد (على سبيل المثال: نظام إدارة محتوى، واجهة برمجة تطبيقات، إلخ) وتخزين رسائلك في ملفات JSON.
+
+  > تحت الغطاء، سيقوم هذا المكون الإضافي بمسح جميع قواعد التعليمات البرمجية والبحث عن ملفات JSON محددة وتحميلها في قواميس Intlayer.
+  > لاحظ أن هذا المكون الإضافي لن يكتب المخرجات والترجمات مرة أخرى إلى ملفات JSON.
+
+- `syncJSON`: مزامنة ملفات JSON مع قواميس Intlayer.
+  - يستخدم هذا المكون الإضافي لمزامنة ملفات JSON مع قواميس Intlayer. يمكنه مسح الموقع المحدد وتحميل ملفات JSON التي تتطابق مع النمط لملفات JSON محددة. هذا المكون الإضافي مفيد إذا كنت ترغب في الحصول على فوائد Intlayer أثناء استخدام مكتبة i18n أخرى.
+
+## Using both plugins
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON, syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Keep your current JSON files in sync with Intlayer dictionaries
+  plugins: [
+    /**
+     * Will load all the JSON files in the src that match the pattern {key}.i18n json
+     */
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Ensures these JSON files take precedence over files at `./locales/en/${key}.json`
+      format: "intlayer", // Format of the JSON content
+    }),
+    /**
+     * Will load, and write the output and translations back to the JSON files in the locales directory
+     */
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      priority: 0,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
+```
+
+## `syncJSON` plugin
+
+### Quick start
 
 أضف المكون الإضافي إلى ملف `intlayer.config.ts` وأشر إلى هيكل JSON الحالي الخاص بك.
 
@@ -80,6 +139,7 @@ const config: IntlayerConfig = {
     syncJSON({
       // تخطيط لكل لغة ولكل مساحة أسماء (مثل next-intl، i18next مع مساحات الأسماء)
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      format: "icu",
     }),
   ],
 };
@@ -90,14 +150,27 @@ export default config;
 البديل: ملف واحد لكل لغة (شائع مع إعدادات i18next/react-intl):
 
 ```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "i18next",
+      source: ({ locale }) => `./locales/${locale}.json`,
+      format: "i18next",
+    }),
+  ],
+};
+
+export default config;
 ```
 
-### كيف يعمل
+#### كيف يعمل
 
 - القراءة: يكتشف المكون الإضافي ملفات JSON من منشئ `source` الخاص بك ويحمّلها كقواميس Intlayer.
 - الكتابة: بعد عمليات البناء والملء، يكتب ملفات JSON المحلية مرة أخرى إلى نفس المسارات (مع سطر جديد نهائي لتجنب مشاكل التنسيق).
@@ -111,6 +184,7 @@ syncJSON({
   location?: string, // تسمية اختيارية، الافتراضي: "plugin"
   priority?: number, // أولوية اختيارية لحل التعارضات، الافتراضي: 0
   format?: 'intlayer' | 'icu' | 'i18next', // مُنسق اختياري، يُستخدم للتوافق مع وقت تشغيل Intlayer
+  splitKeys?: boolean, // اختياري، يقسم ملفًا واحدًا إلى قاموس واحد لكل مفتاح مساحة اسم من المستوى الأعلى (يتم الكشف عنه تلقائيًا)
 });
 ```
 
@@ -135,17 +209,49 @@ syncJSON({
 }),
 ```
 
-## مصادر JSON متعددة والأولوية
+#### `splitKeys` (منطقية)
+
+يتحكم هذا الخيار فيما إذا كان ملف JSON واحد، الذي تكون **مفاتيحه من المستوى الأول هي مساحات أسماء**، يجب أن يصبح قاموسًا واحدًا لكل مفتاح من المستوى الأعلى، بدلاً من قاموس واحد يحمل الملف بأكمله.
+
+يتطابق هذا مع نموذج مساحة الأسماء للمكتبات مثل `next-intl` و `react-intl`، حيث يقوم ملف `messages/{locale}.json` واحد بتجميع عدة مساحات أسماء بواسطة مفاتيحه من المستوى الأول، ويتم التعامل مع كل منها بشكل مستقل (على سبيل المثال، `useTranslations('Hero')` يحل إلى قاموس `Hero`).
+
+- `undefined` (افتراضي): **يتم الكشف عنه تلقائيًا** — يتم تقسيم الملف عندما لا يحتوي نمط `source` على جزء `{key}` (ملف واحد يحمل كل مساحة اسم)، ويتم الاحتفاظ به كقاموس واحد بخلاف ذلك (ملف واحد لكل مفتاح).
+- `true`: دائمًا يقسم كل مفتاح من المستوى الأعلى إلى قاموس خاص به.
+- `false`: لا يقسم أبدًا؛ يصبح الملف بأكمله قاموسًا واحدًا.
+
+بالنظر إلى ملف `messages/{locale}.json` واحد:
+
+```json fileName="messages/en.json"
+{
+  "Hero": { "title": "Full-stack developer" },
+  "Nav": { "work": "Work", "about": "About" },
+  "About": { "lead": "I build apps end to end." }
+}
+```
+
+```ts fileName="intlayer.config.ts"
+syncJSON({
+  format: "icu",
+  source: ({ locale }) => `./messages/${locale}.json`,
+  // splitKeys: true, // ضمني لأن النمط لا يحتوي على جزء `{key}`
+}),
+```
+
+ينتج عن هذا ثلاثة قواميس — `Hero` و `Nav` و `About` — بحيث يتم حل `useTranslations('Hero')` (next-intl) بشكل صحيح. عند إعادة الكتابة، يتم إعادة تجميع جميع مساحات الأسماء في نفس الملف لكل لغة.
+
+> عندما تحتفظ بالجزء الصريح `{key}` في `source` الخاص بك (على سبيل المثال، `./locales/${locale}/${key}.json`)، يكون كل ملف بالفعل مساحة اسم واحدة، لذلك يتم تعطيل التقسيم افتراضيًا.
+
+### Multiple JSON sources and priority
 
 يمكنك إضافة عدة مكونات إضافية `syncJSON` لمزامنة مصادر JSON مختلفة. هذا مفيد عندما يكون لديك مكتبات i18n متعددة أو هياكل JSON مختلفة في مشروعك.
 
-### نظام الأولوية
+#### Priority system
 
 عندما تستهدف عدة مكونات إضافية نفس مفتاح القاموس، يحدد معامل `priority` أي مكون إضافي له الأسبقية:
 
 - الأرقام الأعلى في الأولوية تفوز على الأقل منها
 - الأولوية الافتراضية لملفات `.content` هي `0`
-- الأولوية الافتراضية لملفات محتوى المكونات الإضافية هي `-1`
+- الأولوية الافتراضية لملفات محتوى المكونات الإضافية هي `0`
 - تتم معالجة المكونات الإضافية التي لها نفس الأولوية بالترتيب الذي تظهر به في التكوين
 
 ```ts fileName="intlayer.config.ts"
@@ -188,73 +294,140 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-### حل النزاعات
+## Load JSON plugin
 
-عندما يوجد نفس مفتاح الترجمة في مصادر JSON متعددة:
+### Quick start
 
-1. يحدد المكون الإضافي ذو الأولوية الأعلى القيمة النهائية
-2. تُستخدم المصادر ذات الأولوية الأقل كاحتياطيات للمفاتيح المفقودة
-3. يتيح لك هذا الحفاظ على الترجمات القديمة أثناء الترحيل التدريجي إلى الهياكل الجديدة
+أضف المكون الإضافي إلى ملف `intlayer.config.ts` لاستيعاب ملفات JSON الموجودة كقواميس Intlayer. هذا المكون الإضافي للقراءة فقط (لا يكتب على القرص):
 
-## التكاملات
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-فيما يلي الخرائط الشائعة. احتفظ ببيئة التشغيل الخاصة بك دون تغيير؛ فقط أضف المكون الإضافي.
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Ingest JSON messages located anywhere in your source tree
+    loadJSON({
+      source: ({ key }) => `./src/**/${key}.i18n.json`,
+      // Load a single locale per plugin instance (defaults to the config defaultLocale)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
 
-### i18next
+export default config;
+```
 
-تخطيط الملف النموذجي: `./public/locales/{locale}/{namespace}.json` أو `./locales/{locale}/{namespace}.json`.
+البديل: تخطيط لكل لغة، لا يزال للقراءة فقط (يتم تحميل اللغة المحددة فقط):
 
 ```ts fileName="intlayer.config.ts"
-import { syncJSON } from "@intlayer/sync-json-plugin";
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadJSON } from "@intlayer/sync-json-plugin";
 
-export default {
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
   plugins: [
-    syncJSON({
-      format: "i18next",
+    loadJSON({
+      // Only files for Locales.FRENCH will be loaded from this pattern
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      locale: Locales.FRENCH,
     }),
   ],
 };
+
+export default config;
 ```
 
-### next-intl
+### How it works
 
-رسائل JSON لكل لغة (غالبًا `./messages/{locale}.json`) أو لكل مساحة أسماء.
+- اكتشاف: يبني glob من منشئ `source` الخاص بك ويجمع ملفات JSON المطابقة.
+- استيعاب: يحمل كل ملف JSON كقاموس Intlayer باللغة المقدمة `locale`.
+- للقراءة فقط: لا يكتب أو ينسق ملفات الإخراج؛ استخدم `syncJSON` إذا كنت بحاجة إلى مزامنة ذهابًا وإيابًا.
+- جاهز للملء التلقائي: يحدد نمط `fill` بحيث يمكن لـ `intlayer content fill` ملء المفاتيح المفقودة عبر CLI عندما تختار ذلك.
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
-  }),
-];
+### API
+
+```ts
+loadJSON({
+  // Build paths to your JSON. `locale` is optional if your structure has no locale segment
+  source: ({ key, locale }) => string,
+
+  // Target locale for the dictionaries loaded by this plugin instance
+  // Defaults to configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // Optional label to identify the source
+  location?: string, // default: "plugin"
+
+  // Priority used for conflict resolution against other sources
+  priority?: number, // default: 0
+
+  // Optional formatter for the JSON content
+  format?: 'intlayer' | 'icu' | 'i18next', // default: 'intlayer'
+
+  // Split a single file into one dictionary per top-level key (auto-detected)
+  splitKeys?: boolean,
+});
 ```
 
-انظر أيضًا: `docs/ar/intlayer_with_next-intl.md`.
+#### `format` ('intlayer' | 'icu' | 'i18next')
 
-### react-intl
+يحدد المُنسق الذي سيتم استخدامه لمحتوى القاموس عند تحميل ملفات JSON. يسمح هذا باستخدام صيغ تنسيق رسائل مختلفة متوافقة مع مكتبات i18n المتنوعة.
 
-عادةً ما يكون ملف JSON واحد لكل لغة:
+- `'intlayer'`: مُنسق Intlayer الافتراضي (الافتراضي).
+- `'icu'`: يستخدم تنسيق رسائل ICU (متوافق مع مكتبات مثل react-intl، vue-i18n).
+- `'i18next'`: يستخدم تنسيق رسائل i18next (متوافق مع i18next، next-i18next، Solid-i18next).
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ locale }) => `./locales/${locale}.json`,
-  }),
-];
+**مثال:**
+
+```ts
+loadJSON({
+  source: ({ key }) => `./src/**/${key}.i18n.json`,
+  locale: Locales.ENGLISH,
+  format: "icu", // استخدام تنسيق ICU للتوافق
+}),
 ```
 
-### vue-i18n
+#### `splitKeys` (منطقية)
 
-إما ملف واحد لكل لغة أو لكل مساحة أسماء:
+نفس السلوك كما في [`syncJSON`](#splitkeys-boolean): عندما يجمع ملف JSON واحد عدة مساحات أسماء بواسطة مفاتيحه من المستوى الأول، يصبح كل مفتاح من المستوى الأعلى قاموسًا خاصًا به.
 
-```ts fileName="intlayer.config.ts"
-plugins: [
-  syncJSON({
-    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,
-  }),
-];
+- `undefined` (افتراضي): **يتم الكشف عنه تلقائيًا** — يتم التقسيم عندما لا يحتوي نمط `source` على جزء `{key}`، أو قاموس واحد بخلاف ذلك.
+- `true` / `false`: فرض أو تعطيل التقسيم.
+
+```ts
+loadJSON({
+  source: ({ locale }) => `./messages/${locale}.json`,
+  format: "icu",
+  // splitKeys auto-enabled: `Hero`, `Nav`, `About`, … each become a dictionary
+}),
 ```
 
+### Behavior and conventions
+
+- إذا كان قناع `source` الخاص بك يتضمن عنصر نائب للغة، فسيتم استيعاب الملفات الخاصة باللغة `locale` المحددة فقط.
+- إذا لم يكن هناك جزء `{key}` في القناع الخاص بك، يصبح كل مفتاح من المستوى الأعلى للملف قاموسًا خاصًا به افتراضيًا (انظر [`splitKeys`](#splitkeys-boolean)). قم بتعيين `splitKeys: false` لتحميل الملف بأكمله كقاموس `index` واحد بدلاً من ذلك.
+- يتم اشتقاق المفاتيح من مسارات الملفات عن طريق استبدال العنصر النائب `{key}` في منشئ `source` الخاص بك.
+- يستخدم المكون الإضافي الملفات المكتشفة فقط ولا يقوم بإنشاء لغات أو مفاتيح مفقودة.
+- يتم استنتاج مسار `fill` من `source` الخاص بك ويستخدم لتحديث القيم المفقودة عبر CLI عندما تختار ذلك.
+
+## Conflict resolution
+
+عندما يوجد نفس مفتاح الترجمة في مصادر JSON متعددة:
+
+1. يحدد المكون الإضافي ذو الأولوية الأعلى القيمة النهائية
+2. تُستخدم المصادر ذات الأولوية الأقل كاحتياطيات للمفاتيح المفقودة
+3. يتيح لك هذا الحفاظ على الترجمات القديمة أثناء الترحيل التدريجي إلى الهياكل الجديدة
+
 ## CLI
 
 سيتم اعتبار ملفات JSON المتزامنة كملفات `.content` أخرى. هذا يعني أن جميع أوامر intlayer ستكون متاحة لملفات JSON المتزامنة. بما في ذلك:

package/docs/ar/plugins/sync-po.md

@@ -18,6 +18,7 @@ history:
   - version: 8.9.4
     date: 2026-05-10
     changes: "التوثيق الأولي لإضافة Sync PO"
+author: aymericzip
 ---
 
 # Sync PO (جسور i18n) - مزامنة PO مع دعم ICU / i18next

package/docs/ar/releases/v6.md

@@ -18,12 +18,17 @@ slugs:
   - doc
   - releases
   - v6
+author: aymericzip
 ---
 
 # الإصدار الجديد Intlayer v6 - ما الجديد؟
 
 مرحبًا بك في Intlayer v6! يركز هذا الإصدار على الأداء، تجربة المطور، والموثوقية. فيما يلي أبرز النقاط، مع ملاحظات الترحيل وأمثلة قابلة للنسخ واللصق.
 
+## جدول المحتويات
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## أبرز النقاط
 
 - أمر جديد: `npx intlayer content test` لاكتشاف الترجمات المفقودة
@@ -293,6 +298,24 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## عملية متوازية لمراقبة الملفات على turbopack
+
+عند استخدام Turbopack على Next.js 14 وما فوق كخادم التطوير الخاص بك مع أمر `next dev --turbopack`، لن يتم اكتشاف تغييرات القاموس تلقائياً بشكل افتراضي.
+
+يحدث هذا التحديد لأن Turbopack لا يمكنه تشغيل مكونات webpack بالتوازي لمراقبة التغييرات في ملفات المحتوى الخاصة بك.
+
+للعمل حول هذا، أسقطنا أمر `intlayer watch`، باستخدام خيار `--with` لتشغيل كل من خادم التطوير ومراقب بناء Intlayer في نفس الوقت.
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    "dev": "npx intlayer watch --with 'next dev --turbopack'",
+  },
+}
+```
+
+---
+
 ## ملاحظات الترحيل
 
 - تمت الإزالة: `dictionaryOutput` (كان يُستخدم سابقًا مع `i18next` أو `next-intl`). سيعود هذا كموصلات قابلة للإضافة في الإصدارات المستقبلية. قم بإزالة هذا الحقل من تكوينك.
@@ -311,6 +334,12 @@ bun x intlayer live --with 'vite preview'
 
 ---
 
+## ملاحظات الترحيل من v6 إلى v7
+
+تحقق من [ملاحظات الترحيل من v6 إلى v7](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/releases/v7.md) للمزيد من المعلومات.
+
+---
+
 ## روابط مفيدة
 
 - [مرجع CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/cli/index.md)

package/docs/ar/releases/v7.md

@@ -18,12 +18,17 @@ slugs:
   - doc
   - releases
   - v7
+author: aymericzip
 ---
 
 # الإصدار الجديد Intlayer v7 - ما الجديد؟
 
 مرحبًا بك في Intlayer v7! يقدم هذا الإصدار الكبير تحسينات ملحوظة في الأداء، أمان الأنواع، وتجربة المطور. فيما يلي أبرز النقاط، مع ملاحظات الترحيل وأمثلة عملية.
 
+## جدول المحتويات
+
+<TOC levels={[2]} maxDepth={1} />
+
 ## أبرز النقاط
 
 - استراتيجية التخزين المؤقت لبناء أسرع
@@ -259,6 +264,126 @@ setLocale("en");
 
 ---
 
+## تنسيق الكود التلقائي: تكوين formatCommand
+
+يقدم الإصدار v7 خيار `formatCommand` في تكوين المحرر، مما يسمح لك بتنسيق ملفات المحتوى تلقائياً عند كتابتها بواسطة Intlayer. وهذا يضمن أسلوب كود متسق وتنسيق موحد عبر ملفات إعلان المحتوى الخاصة بك.
+
+إذا لم يتم تعيينه، سيحاول Intlayer الكشف عن أمر التنسيق تلقائياً. من خلال محاولة حل الأوامر التالية: prettier, biome, eslint.
+
+### الإعدادات
+
+تقبل خيار `formatCommand` قالب نص حيث سيتم استبدال `{{file}}` بمسار الملف الفعلي:
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    formatCommand: 'bun x biome format "{{file}}" --write --log-level none',
+  },
+};
+```
+
+### منسقات مدعومة
+
+يمكنك استخدام أي منسق أكواد يقبل مسارات الملفات كمعاملات:
+
+**باستخدام Biome:**
+
+```typescript
+formatCommand: 'bun x biome format "{{file}}" --write --log-level none';
+```
+
+**باستخدام Prettier:**
+
+```typescript
+formatCommand: 'npx prettier --write "{{file}}" --log-level silent';
+```
+
+**باستخدام ESLint:**
+
+```typescript
+formatCommand: 'npx eslint --fix "{{file}}" --quiet';
+```
+
+**باستخدام منسق Bun المدمج:**
+
+```typescript
+formatCommand: 'bun format "{{file}}"';
+```
+
+### الفوائد
+
+- **تنسيق متسق**: يتم تنسيق جميع ملفات المحتوى تلقائياً وفقاً لإرشادات نمط مشروعك
+- **تجربة المطور**: لا حاجة لتنسيق الملفات يدوياً بعد كتابة Intlayer لها
+- **اتساق الفريق**: يضمن أن جميع أعضاء الفريق لديهم نفس التنسيق المطبق على ملفات المحتوى
+- **تكامل CI/CD**: تحافظ ملفات المحتوى على تنسيق متسق في سير العمل الآلي
+
+### كيف يعمل
+
+عندما يكتب Intlayer أو يحدث ملف إعلان محتوى (`.content.ts`، `.content.js`، إلخ)، فإنه يقوم تلقائياً بتشغيل أمر التنسيق المحدد على الملف. يتم استبدال العنصر النائب `{{file}}` بمسار الملف الفعلي، ويتم تنفيذ الأمر في دليل قاعدة المشروع.
+
+---
+
+## تكوين القاموس: تنظيم وهيكلة أفضل
+
+يقدم الإصدار v7 قسم تكوين `dictionary` مخصصًا جديدًا يوفر تنظيمًا أفضل لإعدادات القاموس وإدارة محسنة للمحتوى.
+
+### هيكل تكوين القاموس الجديد
+
+تم نقل خاصية `fill` من قسم `content` إلى قسم `dictionary` جديد، مما يوفر فصلاً أوضح للمسؤوليات:
+
+**تكوين v6:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    autoFill: "./{{fileName}}.content.json",
+    contentDir: ["src"],
+  },
+};
+```
+
+**تكوين v7:**
+
+```typescript fileName="intlayer.config.ts"
+export default {
+  content: {
+    contentDir: ["src"],
+  },
+  dictionary: {
+    fill: "./{{fileName}}.content.json",
+  },
+};
+```
+
+### فوائد الهيكل الجديد
+
+- **تنظيم أوضح**: يتم الآن تجميع الإعدادات الخاصة بالقاموس معًا
+- **فصل أفضل للاهتمامات**: يتم فصل اكتشاف المحتوى عن عمليات القاموس بوضوح
+- **قابلية صيانة محسّنة**: يسهل فهم وتعديل التكوينات المتعلقة بالقاموس
+- **قابلية التوسع في المستقبل**: يمكن لقسم القاموس أن يستوعب إعدادات إضافية خاصة بالقاموس
+- **إدارة قاموس شاملة**: تتضمن خصائص مثل `title` و `live` و `priority` و `tags` و `version` و `description` لإنشاء وإدارة قواميس جديدة
+
+### استخدام التكوين
+
+يخدم تكوين القاموس غرضين رئيسيين:
+
+1. **القيم الافتراضية**: تحديد القيم الافتراضية عند إنشاء ملفات إعلان المحتوى
+2. **سلوك الرجوع**: توفير قيم بديلة عندما لا يتم تحديد حقول معينة، مما يسمح لك بتحديد سلوك تشغيل القاموس بشكل عام
+
+يتضمن قسم القاموس خصائص شاملة لإدارة القاموس:
+
+- **`fill`**: سلوك الملء التلقائي لإنشاء المحتوى
+- **`title`**: العنوان الافتراضي للقواميیس الجديدة
+- **`live`**: تكوين المزامنة الحية للتحديثات في الوقت الفعلي
+- **`priority`**: إعدادات الأولویة لحل القاموس
+- **`tags`**: الوسوم الافتراضية لتنظيم المحتوى
+- **`version`**: إدارة الإصدار لتحديثات القاموس
+- **`description`**: الوصف الافتراضي للمحتوى الجديد
+
+للمزید من المعلومات حول ملفات إعلان المحتوى وكيف يتم تطبيق قيم التكوين، راجع [توثيق ملف المحتوى](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/dictionary/content_file.md).
+
+---
+
 ## أمر fill: سلوك محدث لإدارة محتوى أفضل
 
 يقدم الإصدار 7 سلوكًا محسّنًا لأمر `fill`، مما يوفر إدارة محتوى أكثر توقعًا ومرونة:
@@ -406,6 +531,10 @@ const content = {
 - **`middleware.prefixDefault`**: تم استبداله بـ `routing.mode`
 - **`middleware.noPrefix`**: تم استبداله بـ `routing.mode`
 
+### تكوينات جديدة
+
+- **`editor.formatCommand`**: خيار جديد لتنسيق الكود تلقائياً لملفات المحتوى
+
 ### خريطة الترحيل
 
 #### خريطة التهيئة