@intlayer/docs 7.0.4-canary.0 → 7.0.4

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

@@ -0,0 +1,244 @@
+---
+createdAt: 2025-03-13
+updatedAt: 2025-10-05
+title: مكون مزامنة JSON
+description: مزامنة قواميس Intlayer مع ملفات JSON الخاصة بالتدويل من طرف ثالث (i18next، next-intl، react-intl، vue-i18n، والمزيد). احتفظ بنظام التدويل الحالي لديك أثناء استخدام Intlayer لإدارة وترجمة واختبار رسائلك.
+keywords:
+  - Intlayer
+  - مزامنة JSON
+  - i18next
+  - next-intl
+  - react-intl
+  - vue-i18n
+  - next-translate
+  - nuxt-i18n
+  - LinguiJS
+  - Polyglot.js
+  - Solid-i18next
+  - svelte-i18n
+  - i18n
+  - الترجمات
+slugs:
+  - doc
+  - plugin
+  - sync-json
+history:
+  - version: 6.1.6
+    date: 2025-10-05
+    changes: الوثائق الأولية لمكون مزامنة JSON
+---
+
+## مزامنة JSON (جسور التدويل)
+
+استخدم Intlayer كمكون إضافي إلى نظام التدويل (i18n) الحالي لديك. يحافظ هذا المكون على مزامنة رسائل JSON الخاصة بك مع قواميس Intlayer بحيث يمكنك:
+
+- الاحتفاظ بـ i18next، next-intl، react-intl، vue-i18n، next-translate، nuxt-i18n، Solid-i18next، svelte-i18n، وغيرها.
+- إدارة وترجمة رسائلك باستخدام Intlayer (CLI، CI، المزودين، نظام إدارة المحتوى)، دون الحاجة لإعادة هيكلة تطبيقك.
+- نشر الدروس ومحتوى تحسين محركات البحث (SEO) المستهدف لكل نظام بيئي، مع اقتراح Intlayer كطبقة لإدارة JSON.
+
+ملاحظات ونطاق العمل الحالي:
+
+- التصدير إلى نظام إدارة المحتوى يعمل للترجمات والنصوص التقليدية.
+- لا يوجد دعم حتى الآن للإدخالات، الجمع/ICU، أو الميزات المتقدمة في وقت التشغيل لمكتبات أخرى.
+- محرر الواجهة البصرية غير مدعوم حتى الآن لمخرجات التدويل من طرف ثالث.
+
+### متى تستخدم هذا المكون
+
+- أنت تستخدم بالفعل مكتبة i18n وتخزن الرسائل في ملفات JSON.
+- تريد ملء بمساعدة الذكاء الاصطناعي، واختبار في CI، وعمليات المحتوى دون تغيير وقت تشغيل العرض الخاص بك.
+
+## التثبيت
+
+```bash
+pnpm add -D @intlayer/sync-json-plugin
+# أو
+npm i -D @intlayer/sync-json-plugin
+```
+
+## بداية سريعة
+
+أضف المكون الإضافي إلى ملف `intlayer.config.ts` وأشر إلى هيكل JSON الحالي الخاص بك.
+
+```ts fileName="intlayer.config.ts"
+import { defineConfig, Locales } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+export default defineConfig({
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // حافظ على مزامنة ملفات JSON الحالية مع قواميس Intlayer
+  plugins: [
+    syncJSON({
+      // تخطيط لكل لغة ولكل مساحة أسماء (مثل next-intl، i18next مع مساحات الأسماء)
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+    }),
+  ],
+});
+```
+
+البديل: ملف واحد لكل لغة (شائع مع إعدادات i18next/react-intl):
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ locale }) => `./locales/${locale}.json`,
+  }),
+];
+```
+
+### كيف يعمل
+
+- القراءة: يكتشف المكون الإضافي ملفات JSON من منشئ `source` الخاص بك ويحمّلها كقواميس Intlayer.
+- الكتابة: بعد عمليات البناء والملء، يكتب ملفات JSON المحلية مرة أخرى إلى نفس المسارات (مع سطر جديد نهائي لتجنب مشاكل التنسيق).
+- الملء التلقائي: يعلن المكون الإضافي عن مسار `autoFill` لكل قاموس. تشغيل الأمر `intlayer fill` يقوم بتحديث الترجمات المفقودة فقط في ملفات JSON الخاصة بك بشكل افتراضي.
+
+واجهة برمجة التطبيقات (API):
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => string, // مطلوب
+  location?: string, // تسمية اختيارية، الافتراضي: "plugin"
+  priority?: number, // أولوية اختيارية لحل التعارضات، الافتراضي: 0
+});
+```
+
+## مصادر JSON متعددة والأولوية
+
+يمكنك إضافة عدة مكونات إضافية `syncJSON` لمزامنة مصادر JSON مختلفة. هذا مفيد عندما يكون لديك مكتبات i18n متعددة أو هياكل JSON مختلفة في مشروعك.
+
+### نظام الأولوية
+
+عندما تستهدف عدة مكونات إضافية نفس مفتاح القاموس، يحدد معامل `priority` أي مكون إضافي له الأسبقية:
+
+- الأرقام الأعلى في الأولوية تفوز على الأقل منها
+- الأولوية الافتراضية لملفات `.content` هي `0`
+- الأولوية الافتراضية لملفات محتوى المكونات الإضافية هي `-1`
+- تتم معالجة المكونات الإضافية التي لها نفس الأولوية بالترتيب الذي تظهر به في التكوين
+
+```ts fileName="intlayer.config.ts"
+import { defineConfig, Locales } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+export default defineConfig({
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // المصدر الأساسي لملفات JSON (الأولوية الأعلى)
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // المصدر الاحتياطي لملفات JSON (أولوية أقل)
+    syncJSON({
+      source: ({ locale }) => `./fallback-locales/${locale}.json`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // المصدر القديم لملفات JSON (الأولوية الأدنى)
+    syncJSON({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+});
+```
+
+### حل النزاعات
+
+عندما يوجد نفس مفتاح الترجمة في مصادر JSON متعددة:
+
+1. يحدد المكون الإضافي ذو الأولوية الأعلى القيمة النهائية
+2. تُستخدم المصادر ذات الأولوية الأقل كاحتياطيات للمفاتيح المفقودة
+3. يتيح لك هذا الحفاظ على الترجمات القديمة أثناء الترحيل التدريجي إلى الهياكل الجديدة
+
+## التكاملات
+
+فيما يلي الخرائط الشائعة. احتفظ ببيئة التشغيل الخاصة بك دون تغيير؛ فقط أضف المكون الإضافي.
+
+### i18next
+
+تخطيط الملف النموذجي: `./public/locales/{locale}/{namespace}.json` أو `./locales/{locale}/{namespace}.json`.
+
+```ts fileName="intlayer.config.ts"
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+export default {
+  plugins: [
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+    }),
+  ],
+};
+```
+
+### next-intl
+
+رسائل JSON لكل لغة (غالبًا `./messages/{locale}.json`) أو لكل مساحة أسماء.
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
+  }),
+];
+```
+
+انظر أيضًا: `docs/ar/intlayer_with_next-intl.md`.
+
+### react-intl
+
+عادةً ما يكون ملف JSON واحد لكل لغة:
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ locale }) => `./locales/${locale}.json`,
+  }),
+];
+```
+
+### vue-i18n
+
+إما ملف واحد لكل لغة أو لكل مساحة أسماء:
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,
+  }),
+];
+```
+
+## CLI
+
+سيتم اعتبار ملفات JSON المتزامنة كملفات `.content` أخرى. هذا يعني أن جميع أوامر intlayer ستكون متاحة لملفات JSON المتزامنة. بما في ذلك:
+
+- `intlayer content test` لاختبار ما إذا كانت هناك ترجمات مفقودة
+- `intlayer content list` لعرض قائمة ملفات JSON المتزامنة
+- `intlayer content fill` لملء الترجمات المفقودة
+- `intlayer content push` لدفع ملفات JSON المتزامنة
+- `intlayer content pull` لسحب ملفات JSON المتزامنة
+
+راجع [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_cli.md) لمزيد من التفاصيل.
+
+## القيود (الحالية)
+
+- لا توجد إدخالات أو دعم للجمع/ICU عند استهداف مكتبات الطرف الثالث.
+- محرر بصري غير متوفر بعد لبيئات التشغيل غير الخاصة بـ Intlayer.
+- مزامنة JSON فقط؛ تنسيقات الكتالوج غير JSON غير مدعومة.
+
+## لماذا هذا مهم
+
+- يمكننا التوصية بحلول i18n المعروفة ووضع Intlayer كإضافة.
+- نستفيد من تحسين محركات البحث/الكلمات المفتاحية الخاصة بهم مع الدروس التي تنتهي باقتراح استخدام Intlayer لإدارة JSON.
+- يوسع الجمهور المستهدف من "المشاريع الجديدة" إلى "أي فريق يستخدم i18n بالفعل".

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

@@ -0,0 +1,244 @@
+---
+createdAt: 2025-03-13
+updatedAt: 2025-10-05
+title: Sync JSON Plugin
+description: Synchronisieren Sie Intlayer-Wörterbücher mit Drittanbieter-i18n-JSON-Dateien (i18next, next-intl, react-intl, vue-i18n und mehr). Behalten Sie Ihr bestehendes i18n bei und verwenden Sie Intlayer, um Ihre Nachrichten zu verwalten, zu übersetzen und zu testen.
+keywords:
+  - Intlayer
+  - Sync JSON
+  - i18next
+  - next-intl
+  - react-intl
+  - vue-i18n
+  - next-translate
+  - nuxt-i18n
+  - LinguiJS
+  - Polyglot.js
+  - Solid-i18next
+  - svelte-i18n
+  - i18n
+  - Übersetzungen
+slugs:
+  - doc
+  - plugin
+  - sync-json
+history:
+  - version: 6.1.6
+    date: 2025-10-05
+    changes: Erste Dokumentation des Sync JSON Plugins
+---
+
+# Sync JSON (i18n-Brücken)
+
+Verwenden Sie Intlayer als Ergänzung zu Ihrem bestehenden i18n-Stack. Dieses Plugin hält Ihre JSON-Nachrichten mit den Intlayer-Wörterbüchern synchron, sodass Sie:
+
+- i18next, next-intl, react-intl, vue-i18n, next-translate, nuxt-i18n, Solid-i18next, svelte-i18n usw. beibehalten können.
+- Ihre Nachrichten mit Intlayer (CLI, CI, Anbieter, CMS) verwalten und übersetzen, ohne Ihre App umzustrukturieren.
+- Tutorials und SEO-Inhalte für jedes Ökosystem bereitstellen und gleichzeitig Intlayer als JSON-Verwaltungsschicht vorschlagen.
+
+Hinweise und aktueller Umfang:
+
+- Die Externalisierung zum CMS funktioniert für Übersetzungen und klassischen Text.
+- Noch keine Unterstützung für Einfügungen, Pluralformen/ICU oder erweiterte Laufzeitfunktionen anderer Bibliotheken.
+- Der visuelle Editor wird für Ausgaben von Drittanbieter-i18n noch nicht unterstützt.
+
+### Wann Sie dieses Plugin verwenden sollten
+
+- Sie verwenden bereits eine i18n-Bibliothek und speichern Nachrichten in JSON-Dateien.
+- Sie möchten KI-unterstütztes Ausfüllen, Tests in CI und Content-Operationen durchführen, ohne Ihre Rendering-Laufzeit zu ändern.
+
+## Installation
+
+```bash
+pnpm add -D @intlayer/sync-json-plugin
+# oder
+npm i -D @intlayer/sync-json-plugin
+```
+
+## Schnellstart
+
+Fügen Sie das Plugin zu Ihrer `intlayer.config.ts` hinzu und verweisen Sie auf Ihre bestehende JSON-Struktur.
+
+```ts fileName="intlayer.config.ts"
+import { defineConfig, Locales } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+export default defineConfig({
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Halten Sie Ihre aktuellen JSON-Dateien mit den Intlayer-Wörterbüchern synchron
+  plugins: [
+    syncJSON({
+      // Pro-Locale, pro-Namespace Layout (z.B. next-intl, i18next mit Namespaces)
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+    }),
+  ],
+});
+```
+
+Alternative: Einzelne Datei pro Locale (häufig bei i18next/react-intl Setups):
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ locale }) => `./locales/${locale}.json`,
+  }),
+];
+```
+
+### Funktionsweise
+
+- Lesen: Das Plugin entdeckt JSON-Dateien über Ihren `source`-Builder und lädt sie als Intlayer-Wörterbücher.
+- Schreiben: Nach dem Build und Ausfüllen schreibt es die lokalisierten JSON-Dateien zurück an dieselben Pfade (mit einer abschließenden neuen Zeile, um Formatierungsprobleme zu vermeiden).
+- Auto-Fill: Das Plugin deklariert einen `autoFill`-Pfad für jedes Wörterbuch. Das Ausführen von `intlayer fill` aktualisiert standardmäßig nur fehlende Übersetzungen in Ihren JSON-Dateien.
+
+API:
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => string, // erforderlich
+  location?: string, // optionales Label, Standard: "plugin"
+  priority?: number, // optionale Priorität zur Konfliktlösung, Standard: 0
+});
+```
+
+## Mehrere JSON-Quellen und Priorität
+
+Sie können mehrere `syncJSON`-Plugins hinzufügen, um verschiedene JSON-Quellen zu synchronisieren. Dies ist nützlich, wenn Sie mehrere i18n-Bibliotheken oder unterschiedliche JSON-Strukturen in Ihrem Projekt haben.
+
+### Prioritätssystem
+
+Wenn mehrere Plugins denselben Wörterbuchschlüssel ansprechen, bestimmt der Parameter `priority`, welches Plugin Vorrang hat:
+
+- Höhere Prioritätszahlen haben Vorrang vor niedrigeren
+- Die Standardpriorität von `.content`-Dateien ist `0`
+- Die Standardpriorität von Plugin-Content-Dateien ist `-1`
+- Plugins mit derselben Priorität werden in der Reihenfolge verarbeitet, in der sie in der Konfiguration erscheinen
+
+```ts fileName="intlayer.config.ts"
+import { defineConfig, Locales } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+export default defineConfig({
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Primäre JSON-Quelle (höchste Priorität)
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // Fallback-JSON-Quelle (niedrigere Priorität)
+    syncJSON({
+      source: ({ locale }) => `./fallback-locales/${locale}.json`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // Legacy-JSON-Quelle (niedrigste Priorität)
+    syncJSON({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+});
+```
+
+### Konfliktlösung
+
+Wenn derselbe Übersetzungsschlüssel in mehreren JSON-Quellen vorhanden ist:
+
+1. Bestimmt das Plugin mit der höchsten Priorität den endgültigen Wert
+2. Werden Quellen mit niedrigerer Priorität als Fallbacks für fehlende Schlüssel verwendet
+3. Ermöglicht es Ihnen, Legacy-Übersetzungen beizubehalten und gleichzeitig schrittweise auf neue Strukturen umzusteigen
+
+## Integrationen
+
+Nachfolgend sind gängige Zuordnungen aufgeführt. Belassen Sie Ihre Laufzeit unverändert; fügen Sie nur das Plugin hinzu.
+
+### i18next
+
+Typische Dateistruktur: `./public/locales/{locale}/{namespace}.json` oder `./locales/{locale}/{namespace}.json`.
+
+```ts fileName="intlayer.config.ts"
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+export default {
+  plugins: [
+    syncJSON({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+    }),
+  ],
+};
+```
+
+### next-intl
+
+JSON-Nachrichten pro Locale (oft `./messages/{locale}.json`) oder pro Namespace.
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ locale, key }) => `./messages/${locale}/${key}.json`,
+  }),
+];
+```
+
+Siehe auch: `docs/de/intlayer_with_next-intl.md`.
+
+### react-intl
+
+Einzelne JSON-Datei pro Locale ist üblich:
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ locale }) => `./locales/${locale}.json`,
+  }),
+];
+```
+
+### vue-i18n
+
+Entweder eine einzelne Datei pro Locale oder pro Namespace:
+
+```ts fileName="intlayer.config.ts"
+plugins: [
+  syncJSON({
+    source: ({ key, locale }) => `./src/locales/${locale}/${key}.json`,
+  }),
+];
+```
+
+## CLI
+
+Die synchronisierten JSON-Dateien werden wie andere `.content`-Dateien behandelt. Das bedeutet, dass alle intlayer-Befehle für die synchronisierten JSON-Dateien verfügbar sind. Einschließlich:
+
+- `intlayer content test`, um zu testen, ob Übersetzungen fehlen
+- `intlayer content list`, um die synchronisierten JSON-Dateien aufzulisten
+- `intlayer content fill`, um fehlende Übersetzungen zu ergänzen
+- `intlayer content push`, um die synchronisierten JSON-Dateien zu pushen
+- `intlayer content pull`, um die synchronisierten JSON-Dateien zu pullen
+
+Siehe [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/intlayer_cli.md) für weitere Details.
+
+## Einschränkungen (aktuell)
+
+- Keine Unterstützung für Einfügungen oder Pluralformen/ICU bei der Verwendung von Drittanbieter-Bibliotheken.
+- Visueller Editor ist für Nicht-Intlayer-Laufzeiten noch nicht verfügbar.
+- Nur JSON-Synchronisierung; Nicht-JSON-Katalogformate werden nicht unterstützt.
+
+## Warum das wichtig ist
+
+- Wir können etablierte i18n-Lösungen empfehlen und Intlayer als Zusatzmodul positionieren.
+- Wir nutzen deren SEO/Schlüsselwörter mit Tutorials, die abschließend vorschlagen, Intlayer zur Verwaltung von JSON einzusetzen.
+- Erweitert die ansprechbare Zielgruppe von „neuen Projekten“ auf „jedes Team, das bereits i18n verwendet“.

package/docs/en/intlayer_cli.md

@@ -150,6 +150,10 @@ This command will find your declaration content files as default as `./src/**/*.
 
   > Example: `npx intlayer build --skip-prepare`
 
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer build --no-cache`
+
 ### Watch dictionaries
 
 ```bash
@@ -203,6 +207,10 @@ If [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
   > Example: `npx intlayer dictionary push --env-file .env.production.local`
 
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer build --no-cache`
+
 **Environment variables options:**
 
 - **`--env`**: Specify the environment (e.g., `development`, `production`). Useful in the case you use environment variables in your intlayer configuration file.
@@ -279,6 +287,10 @@ If [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/
 
   > Example: `npx intlayer dictionary push --env-file .env.production.local`
 
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer build --no-cache`
+
 **Environment variables options:**
 
 - **`--env`**: Specify the environment (e.g., `development`, `production`).
@@ -392,6 +404,10 @@ This command analyzes your content declaration files for potential issues such a
 
   > Example: `npx intlayer fill --base-dir ./src`
 
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer build --no-cache`
+
 **Preparation options:**
 
 - **`--build`**: Build the dictionaries before pushing to ensure the content is up to date. True will force the build, false will skip the build, undefined will allow using the cache of the build.
@@ -448,6 +464,10 @@ Total missing required locales: 0
 
   > Example: `npx intlayer content test --base-dir ./src --env-file .env.production.local`
 
+- **`--no-cache`**: Disable the cache.
+
+  > Example: `npx intlayer build --no-cache`
+
 **Preparation options:**
 
 - **`--build`**: Build the dictionaries before pushing to ensure the content is up to date. True will force the build, false will skip the build, undefined will allow using the cache of the build.
@@ -530,6 +550,7 @@ npx intlayer configuration get
 - **`--env-file`**: Provide a custom environment file to load variables from.
 - **`--base-dir`**: Specify the base directory for the project.
 - **`--verbose`**: Enable verbose logging for debugging. (default to true using CLI)
+- **`--no-cache`**: Disable the cache.
 
 #### Push Configuration
 
@@ -550,6 +571,7 @@ npx intlayer configuration push
 - **`--env-file`**: Provide a custom environment file to load variables from.
 - **`--base-dir`**: Specify the base directory for the project.
 - **`--verbose`**: Enable verbose logging for debugging. (default to true using CLI)
+- **`--no-cache`**: Disable the cache.
 
 By pushing the configuration, your project is fully integrated with the Intlayer CMS, enabling seamless dictionary management across teams.
 
@@ -623,6 +645,7 @@ npx intlayer doc translate
 - **`--env`**: Specify the environment (e.g., `development`, `production`).
 - **`--env-file [envFile]`**: Provide a custom environment file to load variables from.
 - **`--base-dir`**: Specify the base directory for the project.
+- **`--no-cache`**: Disable the cache.
 
   > Example: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
 
@@ -738,6 +761,8 @@ Live Sync lets your app reflect CMS content changes at runtime. No rebuild or re
 
 - **`--base-dir`**: Specify the base directory for the project. To retrieve the intlayer configuration, the command will look for the `intlayer.config.{ts,js,json,cjs,mjs}` file in the base directory.
 
+- **`--no-cache`**: Disable the cache.
+
   > Example: `npx intlayer dictionary push --env-file .env.production.local`
 
 **Log options:**

package/docs/en/intlayer_with_nextjs_14.md

@@ -1488,6 +1488,8 @@ yarn add @intlayer/swc --save-dev
 
 > Note: This package is not installed by default because SWC plugins are still experimental on Next.js. It may change in the future.
 
+> Note: If you set the option as `importMode: 'dynamic'` or `importMode: 'live'`, it will rely on Suspense, so you will have to wrap your `useIntlayer` calls in a `Suspense` boundary. That means, you will not be able to use the `useIntlayer` directly at the top level of your Page / Layout component.
+
 ### Configure TypeScript
 
 Intlayer use module augmentation to get benefits of TypeScript and make your codebase stronger.

package/docs/en/intlayer_with_nextjs_15.md

@@ -1550,6 +1550,8 @@ yarn add @intlayer/swc --save-dev
 
 > Note: This package is not installed by default because SWC plugins are still experimental on Next.js. It may change in the future.
 
+> Note: If you set the option as `importMode: 'dynamic'` or `importMode: 'live'`, it will rely on Suspense, so you will have to wrap your `useIntlayer` calls in a `Suspense` boundary. That means, you will not be able to use the `useIntlayer` directly at the top level of your Page / Layout component.
+
 ### Watch dictionaries changes on Turbopack
 
 When using Turbopack as your development server with the `next dev --turbopack` command, dictionary changes will not be automatically detected by default.

package/docs/en/intlayer_with_nextjs_16.md

@@ -1525,6 +1525,8 @@ yarn add @intlayer/swc --save-dev
 
 > Note: This package is not installed by default because SWC plugins are still experimental on Next.js. It may change in the future.
 
+> Note: If you set the option as `importMode: 'dynamic'` or `importMode: 'live'`, it will rely on Suspense, so you will have to wrap your `useIntlayer` calls in a `Suspense` boundary. That means, you will not be able to use the `useIntlayer` directly at the top level of your Page / Layout component.
+
 ### Watch dictionaries changes on Turbopack
 
 When using Turbopack as your development server with the `next dev` command, dictionary changes will not be automatically detected by default.

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

@@ -28,7 +28,7 @@ history:
     changes: Initial Sync JSON plugin documentation
 ---
 
-## Sync JSON (i18n bridges)
+# Sync JSON (i18n bridges)
 
 Use Intlayer as an add‑on to your existing i18n stack. This plugin keeps your JSON messages in sync with Intlayer dictionaries so you can: