@intlayer/docs 5.6.0 → 5.7.0

package/docs/ar/configuration.md

@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -89,7 +89,7 @@ const config = {
     applicationContext: "This is a test application", // سياق التطبيق
   },
   build: {
-    activateDynamicImport: true, // تفعيل الاستيراد الديناميكي
+    importMode: "dynamic", // تفعيل الاستيراد الديناميكي
   },
 };
 
@@ -485,11 +485,9 @@ module.exports = config;
 
 تنطبق خيارات البناء على إضافات `@intlayer/babel` و `@intlayer/swc`.
 
-> في وضع التطوير، يستخدم Intlayer استيرادًا ثابتًا مركزيًا للقواميس لتبسيط تجربة التطوير.
+> في وضع التطوير، يستخدم Intlayer استيرادات ثابتة للقواميس لتبسيط تجربة التطوير.
 
-> من خلال تحسين البناء، سيقوم Intlayer باستبدال جميع استدعاءات القواميس لتحسين التجزئة. بهذه الطريقة سيقوم البناء النهائي باستيراد القواميس المستخدمة فقط.
-
-- **ملاحظة**: يتوفر `@intlayer/babel` بشكل افتراضي في حزمة `vite-intlayer`، لكن `@intlayer/swc` غير مثبت بشكل افتراضي في حزمة `next-intlayer` لأن إضافات SWC لا تزال تجريبية في Next.js.
+> عند التحسين، سيقوم Intlayer باستبدال استدعاءات القواميس لتحسين التجزئة، بحيث يقوم البناء النهائي باستيراد القواميس المستخدمة فعليًا فقط.
 
 #### الخصائص
 
@@ -499,21 +497,28 @@ module.exports = config;
   - _القيمة الافتراضية_: `process.env.NODE_ENV === 'production'`
   - _الوصف_: يتحكم في ما إذا كان يجب تحسين البناء.
   - _مثال_: `true`
-  - _ملاحظة_: سيسمح باستيراد القواميس المستخدمة فقط في الحزمة. لكن ستظل جميع عمليات الاستيراد كاستيراد ثابت لتجنب المعالجة غير المتزامنة عند تحميل القواميس.
-  - _ملاحظة_: عند التمكين، سيقوم Intlayer بتحسين تجزئة القاموس عن طريق استبدال جميع استدعاءات `useIntlayer` بـ `useDictionary` و `getIntlayer` بـ `getDictionary`.
+  - _ملاحظة_: عند التمكين، سيقوم Intlayer باستبدال جميع استدعاءات القواميس لتحسين التجزئة. بهذه الطريقة سيقوم البناء النهائي باستيراد القواميس المستخدمة فقط. ستظل جميع عمليات الاستيراد كاستيرادات ثابتة لتجنب المعالجة غير المتزامنة عند تحميل القواميس.
+  - _ملاحظة_: سيقوم Intlayer باستبدال جميع استدعاءات `useIntlayer` بالوضع المحدد بواسطة خيار `importMode` و `getIntlayer` بـ `getDictionary`.
+  - _ملاحظة_: تعتمد هذه الخيارات على إضافات `@intlayer/babel` و `@intlayer/swc`.
   - _ملاحظة_: تأكد من أن جميع المفاتيح معلنة بشكل ثابت في استدعاءات `useIntlayer`. مثال: `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _النوع_: `boolean`
-  - _القيمة الافتراضية_: `false`
-  - _الوصف_: يتحكم في ما إذا كان يجب استيراد محتوى القاموس ديناميكيًا لكل لغة.
-  - _مثال_: `true`
-  - _ملاحظة_: سيسمح باستيراد محتوى القاموس ديناميكيًا للغة الحالية فقط.
-  - _ملاحظة_: تعتمد الاستيرادات الديناميكية على React Suspense وقد تؤثر قليلاً على أداء العرض. ولكن إذا تم تعطيلها، سيتم تحميل جميع اللغات مرة واحدة، حتى لو لم يتم استخدامها.
-  - _ملاحظة_: عند التمكين، سيقوم Intlayer بتحسين تجزئة القاموس عن طريق استبدال جميع استدعاءات `useIntlayer` بـ `useDynamicDictionary`.
+- **importMode**:
+
+  - _النوع_: `'static' | 'dynamic' | 'async'`
+  - _القيمة الافتراضية_: `'static'`
+  - _الوصف_: يتحكم في كيفية استيراد القواميس.
+  - _مثال_: `'dynamic'`
+  - _ملاحظة_: الأوضاع المتاحة:
+    - "static": يتم استيراد القواميس بشكل ثابت. يستبدل `useIntlayer` بـ `useDictionary`.
+    - "dynamic": يتم استيراد القواميس ديناميكيًا باستخدام Suspense. يستبدل `useIntlayer` بـ `useDictionaryDynamic`.
+    - "async": يتم استيراد القواميس ديناميكيًا بشكل غير متزامن. يستبدل `useIntlayer` بـ `await useDictionaryAsync`.
+  - _ملاحظة_: تعتمد الاستيرادات الديناميكية على Suspense وقد تؤثر قليلاً على أداء العرض.
+  - _ملاحظة_: إذا تم تعطيلها، سيتم تحميل جميع اللغات مرة واحدة، حتى لو لم يتم استخدامها.
+  - _ملاحظة_: تعتمد هذه الخيارات على إضافات `@intlayer/babel` و `@intlayer/swc`.
+  - _ملاحظة_: تأكد من أن جميع المفاتيح معلنة بشكل ثابت في استدعاءات `useIntlayer`. مثال: `useIntlayer('navbar')`.
   - _ملاحظة_: سيتم تجاهل هذا الخيار إذا تم تعطيل `optimize`.
-  - _ملاحظة_: تأكد من إعلان جميع المفاتيح بشكل ثابت في استدعاءات `useIntlayer`. على سبيل المثال `useIntlayer('navbar')`.
+  - _ملاحظة_: في معظم الحالات، سيتم استخدام `"dynamic"` للتطبيقات React، `"async"` لتطبيقات Vue.js.
+  - _ملاحظة_: لن تؤثر هذه الخيارات على الدوال `getIntlayer`، `getDictionary`، `useDictionary`، `useDictionaryAsync` و `useDictionaryDynamic`.
 
 - **traversePattern**:
   - _النوع_: `string[]`

package/docs/ar/how_works_intlayer.md

@@ -103,7 +103,7 @@ const MyComponent = () => {
 
 في وضع التطوير، يستخدم Intlayer استيرادًا ثابتًا مركزيًا للقواميس لتبسيط تجربة التطوير.
 
-بتفعيل الخيار `activateDynamicImport` في [التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)، سيستخدم Intlayer الاستيراد الديناميكي لتحميل القواميس. هذا الخيار معطل افتراضيًا لتجنب المعالجة غير المتزامنة عند عرض التطبيق.
+بتفعيل الخيار `importMode = "dynamic"` في [التكوين](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md)، سيستخدم Intlayer الاستيراد الديناميكي لتحميل القواميس. هذا الخيار معطل افتراضيًا لتجنب المعالجة غير المتزامنة عند عرض التطبيق.
 
 > `@intlayer/babel` متاح افتراضيًا في حزمة `vite-intlayer`،
 

package/docs/de/configuration.md

@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -88,7 +88,7 @@ const config = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -481,11 +481,9 @@ Einstellungen, die steuern, wie Intlayer die Internationalisierung Ihrer Anwendu
 
 Build-Optionen gelten für die Plugins `@intlayer/babel` und `@intlayer/swc`.
 
-> Im Entwicklungsmodus verwendet Intlayer einen zentralisierten statischen Import für Wörterbücher, um die Entwicklungserfahrung zu vereinfachen.
+> Im Entwicklungsmodus verwendet Intlayer statische Importe für Wörterbücher, um die Entwicklungserfahrung zu vereinfachen.
 
-> Durch die Optimierung des Builds ersetzt Intlayer alle Aufrufe von Wörterbüchern, um das Chunking zu optimieren. So importiert das finale Bundle nur die tatsächlich verwendeten Wörterbücher.
-
-- **Hinweis**: `@intlayer/babel` ist standardmäßig im `vite-intlayer`-Paket verfügbar, aber `@intlayer/swc` ist im `next-intlayer`-Paket nicht standardmäßig installiert, da SWC-Plugins in Next.js noch experimentell sind.
+> Bei der Optimierung ersetzt Intlayer Wörterbuchaufrufe, um das Chunking zu optimieren, sodass das finale Bundle nur die tatsächlich verwendeten Wörterbücher importiert.
 
 #### Eigenschaften
 
@@ -495,21 +493,28 @@ Build-Optionen gelten für die Plugins `@intlayer/babel` und `@intlayer/swc`.
   - _Standard_: `process.env.NODE_ENV === 'production'`
   - _Beschreibung_: Steuert, ob der Build optimiert werden soll.
   - _Beispiel_: `true`
-  - _Hinweis_: Ermöglicht es, nur die tatsächlich verwendeten Wörterbücher in das Bundle zu importieren. Alle Importe bleiben jedoch statisch, um asynchrone Verarbeitung beim Laden der Wörterbücher zu vermeiden.
-  - _Hinweis_: Wenn aktiviert, optimiert Intlayer das Chunking der Wörterbücher, indem alle Aufrufe von `useIntlayer` durch `useDictionary` und `getIntlayer` durch `getDictionary` ersetzt werden.
+  - _Hinweis_: Wenn aktiviert, ersetzt Intlayer alle Aufrufe von Wörterbüchern, um das Chunking zu optimieren. So importiert das finale Bundle nur die verwendeten Wörterbücher. Alle Importe bleiben als statische Importe, um asynchrone Verarbeitung beim Laden der Wörterbücher zu vermeiden.
+  - _Hinweis_: Intlayer ersetzt alle Aufrufe von `useIntlayer` mit dem durch die `importMode`-Option definierten Modus und `getIntlayer` mit `getDictionary`.
+  - _Hinweis_: Diese Option basiert auf den Plugins `@intlayer/babel` und `@intlayer/swc`.
   - _Hinweis_: Stellen Sie sicher, dass alle Schlüssel statisch in den `useIntlayer`-Aufrufen deklariert sind, z. B. `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _Typ_: `boolean`
-  - _Standard_: `false`
-  - _Beschreibung_: Steuert, ob der Wörterbuchinhalt pro Locale dynamisch importiert werden soll.
-  - _Beispiel_: `true`
-  - _Hinweis_: Ermöglicht den dynamischen Import des Wörterbuchinhalts nur für die aktuelle Locale.
-  - _Hinweis_: Dynamische Importe basieren auf React Suspense und können die Rendering-Leistung leicht beeinträchtigen. Wenn deaktiviert, werden alle Locales auf einmal geladen, auch wenn sie nicht verwendet werden.
-  - _Hinweis_: Wenn aktiviert, optimiert Intlayer die Wörterbuch-Aufteilung, indem alle Aufrufe von `useIntlayer` durch `useDynamicDictionary` ersetzt werden.
-  - _Hinweis_: Diese Option wird ignoriert, wenn `optimize` deaktiviert ist.
+- **importMode**:
+
+  - _Typ_: `'static' | 'dynamic' | 'async'`
+  - _Standard_: `'static'`
+  - _Beschreibung_: Steuert, wie Wörterbücher importiert werden.
+  - _Beispiel_: `'dynamic'`
+  - _Hinweis_: Verfügbare Modi:
+    - "static": Wörterbücher werden statisch importiert. Ersetzt `useIntlayer` durch `useDictionary`.
+    - "dynamic": Wörterbücher werden dynamisch mit Suspense importiert. Ersetzt `useIntlayer` durch `useDictionaryDynamic`.
+    - "async": Wörterbücher werden asynchron dynamisch importiert. Ersetzt `useIntlayer` durch `await useDictionaryAsync`.
+  - _Hinweis_: Dynamische Importe basieren auf Suspense und können die Rendering-Leistung leicht beeinträchtigen.
+  - _Hinweis_: Wenn deaktiviert, werden alle Locales auf einmal geladen, auch wenn sie nicht verwendet werden.
+  - _Hinweis_: Diese Option basiert auf den Plugins `@intlayer/babel` und `@intlayer/swc`.
   - _Hinweis_: Stellen Sie sicher, dass alle Schlüssel statisch in den `useIntlayer`-Aufrufen deklariert sind, z. B. `useIntlayer('navbar')`.
+  - _Hinweis_: Diese Option wird ignoriert, wenn `optimize` deaktiviert ist.
+  - _Hinweis_: In den meisten Fällen wird `"dynamic"` für React-Anwendungen und `"async"` für Vue.js-Anwendungen verwendet.
+  - _Hinweis_: Diese Option beeinträchtigt nicht die Funktionen `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` und `useDictionaryDynamic`.
 
 - **traversePattern**:
   - _Typ_: `string[]`

package/docs/de/how_works_intlayer.md

@@ -103,7 +103,7 @@ Die Babel- und SWC-Plugins funktionieren, indem sie den Abstract Syntax Tree (AS
 
 Im Entwicklungsmodus verwendet Intlayer einen zentralisierten statischen Import für Wörterbücher, um die Entwicklungserfahrung zu vereinfachen.
 
-Durch Aktivieren der Option `activateDynamicImport` in der [Konfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md) verwendet Intlayer den dynamischen Import, um die Wörterbücher zu laden. Diese Option ist standardmäßig deaktiviert, um asynchrone Verarbeitung beim Rendern der Anwendung zu vermeiden.
+Durch Aktivieren der Option `importMode = "dynamic"` in der [Konfiguration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/configuration.md) verwendet Intlayer den dynamischen Import, um die Wörterbücher zu laden. Diese Option ist standardmäßig deaktiviert, um asynchrone Verarbeitung beim Rendern der Anwendung zu vermeiden.
 
 > `@intlayer/babel` ist standardmäßig im `vite-intlayer`-Paket enthalten,
 

package/docs/en/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2025-07-13
+updatedAt: 2025-07-25
 title: Configuration
 description: Learn how to configure Intlayer for your application. Understand the various settings and options available to customize Intlayer to your needs.
 keywords:
@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -88,7 +88,7 @@ const config = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -101,11 +101,21 @@ module.exports = config;
     "locales": ["en"],
   },
   "content": {
-    "typesDir": "content/types",
+    "contentDir": ["src", "../ui-library"],
   },
   "middleware": {
     "noPrefix": false,
   },
+  "editor": {
+    "applicationURL": "https://example.com",
+  },
+  "ai": {
+    "apiKey": "XXXX",
+    "applicationContext": "This is a test application",
+  },
+  "build": {
+    "importMode": "dynamic",
+  },
 }
 ```
 
@@ -483,11 +493,9 @@ Settings that control how Intlayer optimizes and builds your application's inter
 
 Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
 
-> In development mode, Intlayer use a centralized static import for dictionaries to simplify the development experience.
+> In development mode, Intlayer uses static imports for dictionaries to simplify the development experience.
 
-> By optimizing the build, Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.
-
-- **Note**: `@intlayer/babel` is available by default on `vite-intlayer` package, but `@intlayer/swc` is not installed by default on `next-intlayer` package as SWC plugins are still experimental on Next.js.
+> When optimized, Intlayer will replace dictionary calls to optimize chunking, so the final bundle only imports dictionaries that are actually used.
 
 #### Properties
 
@@ -497,21 +505,28 @@ Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Default_: `process.env.NODE_ENV === 'production'`
   - _Description_: Controls whether the build should be optimized.
   - _Example_: `true`
-  - _Note_: It will allows to import only the dictionaries that are used into the bundle. But all imports will stay as static import to avoid async processing when loading the dictionaries.
-  - _Note_: When enabled, Intlayer will optimize dictionary chunking by replacing all calls of `useIntlayer` with `useDictionary` and `getIntlayer` with `getDictionary`.
+  - _Note_: When enabled, Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used. All imports will stay as static import to avoid async processing when loading the dictionaries.
+  - _Note_: Intlayer will replace all calls of `useIntlayer` with the defined mode by the `importMode` option and `getIntlayer` with `getDictionary`.
+  - _Note_: This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Note_: Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Controls whether dictionary content should be dynamically imported per locale.
-  - _Example_: `true`
-  - _Note_: It will allows to import dynamically the dictionary content for the current locale only.
-  - _Note_: Dynamic imports rely on React Suspense and may slightly impact rendering performance. But if desabled all locales will be loaded at once, even if they are not used.
-  - _Note_: When enabled, Intlayer will optimize dictionary chunking by replacing all calls of `useIntlayer` calls with `useDynamicDictionary`.
-  - _Note_: This option will be ignored if `optimize` is disabled.
+- **importMode**:
+
+  - _Type_: `'static' | 'dynamic' | 'async'`
+  - _Default_: `'static'`
+  - _Description_: Controls how dictionaries are imported.
+  - _Example_: `'dynamic'`
+  - _Note_: Available modes:
+    - "static": Dictionaries are imported statically. Replaces `useIntlayer` with `useDictionary`.
+    - "dynamic": Dictionaries are imported dynamically using Suspense. Replaces `useIntlayer` with `useDictionaryDynamic`.
+    - "async": Dictionaries are imported dynamically asynchronously. Replaces `useIntlayer` with `await useDictionaryAsync`.
+  - _Note_: Dynamic imports rely on Suspense and may slightly impact rendering performance.
+  - _Note_: If disabled all locales will be loaded at once, even if they are not used.
+  - _Note_: This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Note_: Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
+  - _Note_: This option will be ignored if `optimize` is disabled.
+  - _Note_: In most cases, `"dynamic"` will be used for React applications, `"async"` for Vue.js applications.
+  - _Note_: This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions.
 
 - **traversePattern**:
   - _Type_: `string[]`
@@ -524,8 +539,8 @@ Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
 
 ## Doc History
 
-| Version | Date       | Changes                              |
-| ------- | ---------- | ------------------------------------ |
-| 5.6.0   | 2025-07-13 | Change default contentDir to `['.']` |
-| 5.5.11  | 2025-06-29 | Add `docs` commands                  |
-| 5.5.10  | 2025-06-29 | Init history                         |
+| Version | Date       | Changes                                                  |
+| ------- | ---------- | -------------------------------------------------------- |
+| 5.6.1   | 2025-07-25 | Replace `activateDynamicImport` with `importMode` option |
+| 5.6.0   | 2025-07-13 | Change default contentDir from `['src']` to `['.']`      |
+| 5.5.11  | 2025-06-29 | Add `docs` commands                                      |

package/docs/en/how_works_intlayer.md

@@ -106,7 +106,7 @@ The Babel and SWC plugins work by analyzing your application's Abstract Syntax T
 
 In development mode, Intlayer uses a centralized static import for dictionaries to simplify the development experience.
 
-By activating the option `activateDynamicImport` in the [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md), Intlayer will use the dynamic import to load the dictionaries. This option is disabled by default to avoid async processing when rendering the application.
+By activating the option `importMode = "dynamic"` in the [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md), Intlayer will use the dynamic import to load the dictionaries. This option is disabled by default to avoid async processing when rendering the application.
 
 > `@intlayer/babel` is available by default on `vite-intlayer` package,
 

package/docs/en-GB/configuration.md

@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -88,7 +88,7 @@ const config = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -481,11 +481,9 @@ Settings that control how Intlayer optimises and builds your application's inter
 
 Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
 
-> In development mode, Intlayer uses a centralised static import for dictionaries to simplify the development experience.
+> In development mode, Intlayer uses static imports for dictionaries to simplify the development experience.
 
-> By optimising the build, Intlayer will replace all calls of dictionaries to optimise chunking. That way the final bundle will import only the dictionaries that are used.
-
-- **Note**: `@intlayer/babel` is available by default on `vite-intlayer` package, but `@intlayer/swc` is not installed by default on `next-intlayer` package as SWC plugins are still experimental on Next.js.
+> When optimised, Intlayer will replace dictionary calls to optimise chunking, so the final bundle only imports dictionaries that are actually used.
 
 #### Properties
 
@@ -495,21 +493,28 @@ Build options apply to the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Default_: `process.env.NODE_ENV === 'production'`
   - _Description_: Controls whether the build should be optimised.
   - _Example_: `true`
-  - _Note_: It will allow importing only the dictionaries that are used into the bundle. But all imports will remain as static imports to avoid async processing when loading the dictionaries.
-  - _Note_: When enabled, Intlayer will optimise dictionary chunking by replacing all calls of `useIntlayer` with `useDictionary` and `getIntlayer` with `getDictionary`.
+  - _Note_: When enabled, Intlayer will replace all calls of dictionaries to optimise chunking. That way the final bundle will import only the dictionaries that are used. All imports will stay as static import to avoid async processing when loading the dictionaries.
+  - _Note_: Intlayer will replace all calls of `useIntlayer` with the defined mode by the `importMode` option and `getIntlayer` with `getDictionary`.
+  - _Note_: This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Note_: Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _Type_: `boolean`
-  - _Default_: `false`
-  - _Description_: Controls whether dictionary content should be dynamically imported per locale.
-  - _Example_: `true`
-  - _Note_: It will allow importing dynamically the dictionary content for the current locale only.
-  - _Note_: Dynamic imports rely on React Suspense and may slightly impact rendering performance. But if disabled all locales will be loaded at once, even if they are not used.
-  - _Note_: When enabled, Intlayer will optimise dictionary chunking by replacing all calls of `useIntlayer` with `useDynamicDictionary`.
-  - _Note_: This option will be ignored if `optimize` is disabled.
+- **importMode**:
+
+  - _Type_: `'static' | 'dynamic' | 'async'`
+  - _Default_: `'static'`
+  - _Description_: Controls how dictionaries are imported.
+  - _Example_: `'dynamic'`
+  - _Note_: Available modes:
+    - "static": Dictionaries are imported statically. Replaces `useIntlayer` with `useDictionary`.
+    - "dynamic": Dictionaries are imported dynamically using Suspense. Replaces `useIntlayer` with `useDictionaryDynamic`.
+    - "async": Dictionaries are imported dynamically asynchronously. Replaces `useIntlayer` with `await useDictionaryAsync`.
+  - _Note_: Dynamic imports rely on Suspense and may slightly impact rendering performance.
+  - _Note_: If disabled all locales will be loaded at once, even if they are not used.
+  - _Note_: This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.
   - _Note_: Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.
+  - _Note_: This option will be ignored if `optimize` is disabled.
+  - _Note_: In most cases, `"dynamic"` will be used for React applications, `"async"` for Vue.js applications.
+  - _Note_: This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions.
 
 - **traversePattern**:
   - _Type_: `string[]`

package/docs/en-GB/how_works_intlayer.md

@@ -103,7 +103,7 @@ The Babel and SWC plugins work by analysing your application's Abstract Syntax T
 
 In development mode, Intlayer uses a centralised static import for dictionaries to simplify the development experience.
 
-By activating the option `activateDynamicImport` in the [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md), Intlayer will use the dynamic import to load the dictionaries. This option is disabled by default to avoid async processing when rendering the application.
+By activating the option `importMode = "dynamic"` in the [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/configuration.md), Intlayer will use the dynamic import to load the dictionaries. This option is disabled by default to avoid async processing when rendering the application.
 
 > `@intlayer/babel` is available by default on the `vite-intlayer` package,
 

package/docs/es/configuration.md

@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -88,7 +88,7 @@ const config = {
     applicationContext: "This is a test application",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -480,11 +480,9 @@ Ajustes que controlan cómo Intlayer optimiza y compila la internacionalización
 
 Las opciones de compilación se aplican a los plugins `@intlayer/babel` y `@intlayer/swc`.
 
-> En modo desarrollo, Intlayer utiliza una importación estática centralizada para los diccionarios para simplificar la experiencia de desarrollo.
+> En modo desarrollo, Intlayer utiliza importaciones estáticas para los diccionarios para simplificar la experiencia de desarrollo.
 
-> Al optimizar la compilación, Intlayer reemplazará todas las llamadas de diccionarios para optimizar el chunking. De esta manera, el bundle final importará solo los diccionarios que se utilizan.
-
-- **Nota**: `@intlayer/babel` está disponible por defecto en el paquete `vite-intlayer`, pero `@intlayer/swc` no está instalado por defecto en el paquete `next-intlayer` ya que los plugins SWC aún son experimentales en Next.js.
+> Al optimizar, Intlayer reemplazará las llamadas a los diccionarios para optimizar el chunking, de modo que el bundle final solo importe los diccionarios que realmente se utilizan.
 
 #### Propiedades
 
@@ -494,21 +492,28 @@ Las opciones de compilación se aplican a los plugins `@intlayer/babel` y `@intl
   - _Valor por defecto_: `process.env.NODE_ENV === 'production'`
   - _Descripción_: Controla si la compilación debe ser optimizada.
   - _Ejemplo_: `true`
-  - _Nota_: Permitirá importar solo los diccionarios que se utilizan en el bundle. Pero todas las importaciones permanecerán como importación estática para evitar el procesamiento asíncrono al cargar los diccionarios.
-  - _Nota_: Cuando está habilitado, Intlayer optimizará el chunking del diccionario reemplazando todas las llamadas de `useIntlayer` con `useDictionary` y `getIntlayer` con `getDictionary`.
+  - _Nota_: Cuando está habilitado, Intlayer reemplazará todas las llamadas de diccionarios para optimizar el chunking. De esta manera, el bundle final solo importará los diccionarios que se utilizan. Todas las importaciones permanecerán como importaciones estáticas para evitar el procesamiento asíncrono al cargar los diccionarios.
+  - _Nota_: Intlayer reemplazará todas las llamadas de `useIntlayer` con el modo definido por la opción `importMode` y `getIntlayer` con `getDictionary`.
+  - _Nota_: Esta opción se basa en los plugins `@intlayer/babel` y `@intlayer/swc`.
   - _Nota_: Asegúrate de que todas las claves estén declaradas estáticamente en las llamadas `useIntlayer`. por ejemplo: `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _Tipo_: `boolean`
-  - _Valor por defecto_: `false`
-  - _Descripción_: Controla si el contenido del diccionario debe importarse dinámicamente por idioma.
-  - _Ejemplo_: `true`
-  - _Nota_: Permitirá importar dinámicamente el contenido del diccionario solo para el idioma actual.
-  - _Nota_: Las importaciones dinámicas dependen de React Suspense y pueden afectar ligeramente el rendimiento del renderizado. Pero si está deshabilitado, todos los idiomas se cargarán a la vez, incluso si no se utilizan.
-  - _Nota_: Cuando está habilitado, Intlayer optimizará el chunking del diccionario reemplazando todas las llamadas de `useIntlayer` con `useDynamicDictionary`.
-  - _Nota_: Esta opción será ignorada si `optimize` está deshabilitado.
+- **importMode**:
+
+  - _Tipo_: `'static' | 'dynamic' | 'async'`
+  - _Valor por defecto_: `'static'`
+  - _Descripción_: Controla cómo se importan los diccionarios.
+  - _Ejemplo_: `'dynamic'`
+  - _Nota_: Modos disponibles:
+    - "static": Los diccionarios se importan estáticamente. Reemplaza `useIntlayer` con `useDictionary`.
+    - "dynamic": Los diccionarios se importan dinámicamente usando Suspense. Reemplaza `useIntlayer` con `useDictionaryDynamic`.
+    - "async": Los diccionarios se importan dinámicamente de forma asíncrona. Reemplaza `useIntlayer` con `await useDictionaryAsync`.
+  - _Nota_: Las importaciones dinámicas dependen de Suspense y pueden afectar ligeramente el rendimiento del renderizado.
+  - _Nota_: Si está deshabilitado, todos los idiomas se cargarán a la vez, incluso si no se utilizan.
+  - _Nota_: Esta opción se basa en los plugins `@intlayer/babel` y `@intlayer/swc`.
   - _Nota_: Asegúrate de que todas las claves estén declaradas estáticamente en las llamadas `useIntlayer`. por ejemplo: `useIntlayer('navbar')`.
+  - _Nota_: Esta opción será ignorada si `optimize` está deshabilitado.
+  - _Nota_: En la mayoría de los casos, `"dynamic"` se usará para aplicaciones React, `"async"` para aplicaciones Vue.js.
+  - _Nota_: Esta opción no afectará las funciones `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` y `useDictionaryDynamic`.
 
 - **traversePattern**:
   - _Tipo_: `string[]`
@@ -521,4 +526,8 @@ Las opciones de compilación se aplican a los plugins `@intlayer/babel` y `@intl
 
 ## Historial de la documentación
 
-- 5.5.11 - 2025-06-29: Añadidos comandos `docs`
+| Versión | Fecha      | Cambios                                                         |
+| ------- | ---------- | --------------------------------------------------------------- |
+| 5.6.1   | 2025-07-25 | Reemplazo de `activateDynamicImport` con la opción `importMode` |
+| 5.6.0   | 2025-07-13 | Cambio del contentDir predeterminado a `['.']`                  |
+| 5.5.11  | 2025-06-29 | Añadidos comandos `docs`                                        |

package/docs/es/how_works_intlayer.md

@@ -104,7 +104,7 @@ Los plugins de Babel y SWC funcionan analizando el Árbol de Sintaxis Abstracta
 
 En modo de desarrollo, Intlayer utiliza una importación estática centralizada para los diccionarios para simplificar la experiencia de desarrollo.
 
-Al activar la opción `activateDynamicImport` en la [configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md), Intlayer usará la importación dinámica para cargar los diccionarios. Esta opción está desactivada por defecto para evitar el procesamiento asíncrono al renderizar la aplicación.
+Al activar la opción `importMode = "dynamic"` en la [configuración](https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/configuration.md), Intlayer usará la importación dinámica para cargar los diccionarios. Esta opción está desactivada por defecto para evitar el procesamiento asíncrono al renderizar la aplicación.
 
 > `@intlayer/babel` está disponible por defecto en el paquete `vite-intlayer`,
 

package/docs/fr/configuration.md

@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "Ceci est une application de test", // Contexte de l'application
   },
   build: {
-    activateDynamicImport: true, // Active l'importation dynamique
+    importMode: "dynamic",
   },
 };
 
@@ -88,7 +88,7 @@ const config = {
     applicationContext: "Ceci est une application de test", // Contexte de l'application
   },
   build: {
-    activateDynamicImport: true, // Active l'importation dynamique
+    importMode: "dynamic",
   },
 };
 
@@ -499,17 +499,23 @@ Les options de build s'appliquent aux plugins `@intlayer/babel` et `@intlayer/sw
   - _Remarque_ : Lorsqu’il est activé, Intlayer optimisera le découpage des dictionnaires en remplaçant tous les appels à `useIntlayer` par `useDictionary` et `getIntlayer` par `getDictionary`.
   - _Remarque_ : Assurez-vous que toutes les clés soient déclarées statiquement dans les appels à `useIntlayer`. Par exemple : `useIntlayer('navbar')`.
 
-- **activateDynamicImport** :
-
-  - _Type_ : `boolean`
-  - _Par défaut_ : `false`
-  - _Description_ : Contrôle si le contenu du dictionnaire doit être importé dynamiquement par locale.
-  - _Exemple_ : `true`
-  - _Remarque_ : Cela permettra d'importer dynamiquement le contenu du dictionnaire uniquement pour la locale actuelle.
-  - _Remarque_ : Les imports dynamiques reposent sur React Suspense et peuvent légèrement impacter les performances de rendu. Mais si cette option est désactivée, toutes les locales seront chargées en même temps, même si elles ne sont pas utilisées.
-  - _Remarque_ : Lorsqu'elle est activée, Intlayer optimisera le découpage des dictionnaires en remplaçant tous les appels à `useIntlayer` par `useDynamicDictionary`.
-  - _Remarque_ : Cette option sera ignorée si `optimize` est désactivé.
+- **importMode** :
+
+  - _Type_ : `'static' | 'dynamic' | 'async'`
+  - _Par défaut_ : `'static'`
+  - _Description_ : Contrôle comment les dictionnaires sont importés.
+  - _Exemple_ : `'dynamic'`
+  - _Remarque_ : Modes disponibles :
+    - "static" : Les dictionnaires sont importés statiquement. Remplace `useIntlayer` par `useDictionary`.
+    - "dynamic" : Les dictionnaires sont importés dynamiquement en utilisant Suspense. Remplace `useIntlayer` par `useDictionaryDynamic`.
+    - "async" : Les dictionnaires sont importés dynamiquement de manière asynchrone. Remplace `useIntlayer` par `await useDictionaryAsync`.
+  - _Remarque_ : Les imports dynamiques reposent sur Suspense et peuvent légèrement impacter les performances de rendu.
+  - _Remarque_ : Si désactivé, toutes les locales seront chargées en même temps, même si elles ne sont pas utilisées.
+  - _Remarque_ : Cette option s'appuie sur les plugins `@intlayer/babel` et `@intlayer/swc`.
   - _Remarque_ : Assurez-vous que toutes les clés soient déclarées statiquement dans les appels à `useIntlayer`. Par exemple : `useIntlayer('navbar')`.
+  - _Remarque_ : Cette option sera ignorée si `optimize` est désactivé.
+  - _Remarque_ : Dans la plupart des cas, `"dynamic"` sera utilisé pour les applications React, `"async"` pour les applications Vue.js.
+  - _Remarque_ : Cette option n'impactera pas les fonctions `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` et `useDictionaryDynamic`.
 
 - **traversePattern** :
   - _Type_ : `string[]`
@@ -522,4 +528,8 @@ Les options de build s'appliquent aux plugins `@intlayer/babel` et `@intlayer/sw
 
 ## Historique de la documentation
 
-- 5.5.11 - 2025-06-29 : Ajout des commandes `docs`
+| Version | Date       | Changements                                                       |
+| ------- | ---------- | ----------------------------------------------------------------- |
+| 5.6.1   | 2025-07-25 | Remplacement de `activateDynamicImport` par l'option `importMode` |
+| 5.6.0   | 2025-07-13 | Changement du contentDir par défaut vers `['.']`                  |
+| 5.5.11  | 2025-06-29 | Ajout des commandes `docs`                                        |

package/docs/fr/how_works_intlayer.md

@@ -105,7 +105,7 @@ Les plugins Babel et SWC fonctionnent en analysant l'arbre de syntaxe abstraite
 
 En mode développement, Intlayer utilise une importation statique centralisée pour les dictionnaires afin de simplifier l'expérience de développement.
 
-En activant l'option `activateDynamicImport` dans la [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md), Intlayer utilisera l'importation dynamique pour charger les dictionnaires. Cette option est désactivée par défaut pour éviter le traitement asynchrone lors du rendu de l'application.
+En activant l'option `importMode = "dynamic"` dans la [configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/configuration.md), Intlayer utilisera l'importation dynamique pour charger les dictionnaires. Cette option est désactivée par défaut pour éviter le traitement asynchrone lors du rendu de l'application.
 
 > `@intlayer/babel` est disponible par défaut dans le package `vite-intlayer`,