@intlayer/docs 5.6.0 → 5.7.0

package/docs/hi/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: "यह एक परीक्षण एप्लिकेशन है",
   },
   build: {
-    activateDynamicImport: true,
+    importMode: "dynamic",
   },
 };
 
@@ -483,11 +483,9 @@ Intlayer बेहतर लचीलापन और विकल्प के
 
 बिल्ड विकल्प `@intlayer/babel` और `@intlayer/swc` प्लगइन्स पर लागू होते हैं।
 
-> विकास मोड में, Intlayer विकास अनुभव को सरल बनाने के लिए शब्दकोशों के लिए एक केंद्रीकृत स्थैतिक आयात का उपयोग करता है।
+> विकास मोड में, Intlayer विकास अनुभव को सरल बनाने के लिए शब्दकोशों के लिए स्थैतिक आयात का उपयोग करता है।
 
-> बिल्ड को अनुकूलित करके, Intlayer चंकिंग को अनुकूलित करने के लिए शब्दकोशों के सभी कॉल को बदल देगा। इस तरह अंतिम बंडल केवल उन शब्दकोशों को आयात करेगा जो उपयोग में हैं।
-
-- **नोट**: `@intlayer/babel` डिफ़ॉल्ट रूप से `vite-intlayer` पैकेज पर उपलब्ध है, लेकिन `@intlayer/swc` डिफ़ॉल्ट रूप से `next-intlayer` पैकेज पर स्थापित नहीं है क्योंकि SWC प्लगइन्स Next.js पर अभी भी प्रयोगात्मक हैं।
+> अनुकूलन के दौरान, Intlayer चंकिंग को अनुकूलित करने के लिए शब्दकोशों के कॉल को बदल देगा, ताकि अंतिम बंडल केवल वास्तव में उपयोग किए गए शब्दकोशों को आयात करे।
 
 #### गुण
 
@@ -497,21 +495,28 @@ Intlayer बेहतर लचीलापन और विकल्प के
   - _डिफ़ॉल्ट_: `process.env.NODE_ENV === 'production'`
   - _विवरण_: नियंत्रित करता है कि बिल्ड को अनुकूलित किया जाना चाहिए या नहीं।
   - _उदाहरण_: `true`
-  - _नोट_: यह केवल उपयोग किए गए शब्दकोशों को बंडल में आयात करने की अनुमति देगा। लेकिन सभी आयात स्थैतिक आयात के रूप में रहेंगे ताकि शब्दकोशों को लोड करते समय अतुल्यकालिक प्रसंस्करण से बचा जा सके।
-  - _नोट_: जब सक्षम किया जाता है, तो Intlayer सभी `useIntlayer` कॉल को `useDictionary` और `getIntlayer` को `getDictionary` से बदलकर शब्दकोश चंकिंग को अनुकूलित करेगा।
+  - _नोट_: जब सक्षम किया जाता है, तो Intlayer चंकिंग को अनुकूलित करने के लिए शब्दकोशों के सभी कॉल को बदल देगा। इस तरह अंतिम बंडल केवल उपयोग किए गए शब्दकोशों को आयात करेगा। सभी आयात स्थैतिक आयात के रूप में रहेंगे ताकि शब्दकोशों को लोड करते समय अतुल्यकालिक प्रसंस्करण से बचा जा सके।
+  - _नोट_: Intlayer `importMode` विकल्प द्वारा परिभाषित मोड के साथ सभी `useIntlayer` कॉल को बदल देगा और `getIntlayer` को `getDictionary` से बदल देगा।
+  - _नोट_: यह विकल्प `@intlayer/babel` और `@intlayer/swc` प्लगइन्स पर निर्भर करता है।
   - _नोट_: सुनिश्चित करें कि सभी कुंजियाँ `useIntlayer` कॉल में स्थैतिक रूप से घोषित की गई हैं। उदाहरण: `useIntlayer('navbar')`।
 
-- **activateDynamicImport**:
-
-  - _प्रकार_: `boolean`
-  - _डिफ़ॉल्ट_: `false`
-  - _विवरण_: नियंत्रित करता है कि शब्दकोश सामग्री को प्रति भाषा डायनामिक रूप से आयात किया जाना चाहिए या नहीं।
-  - _उदाहरण_: `true`
-  - _नोट_: यह केवल वर्तमान भाषा के लिए शब्दकोश सामग्री को डायनामिक रूप से आयात करने की अनुमति देगा।
-  - _नोट_: डायनामिक आयात React Suspense पर निर्भर करते हैं और रेंडरिंग प्रदर्शन को थोड़ा प्रभावित कर सकते हैं। लेकिन यदि अक्षम है तो सभी भाषाएँ एक साथ लोड की जाएंगी, भले ही वे उपयोग में न हों।
-  - _नोट_: जब सक्षम किया जाता है, तो Intlayer सभी `useIntlayer` कॉल को `useDynamicDictionary` से बदलकर शब्दकोश चंकिंग को अनुकूलित करेगा।
-  - _नोट_: यह विकल्प अनदेखा कर दिया जाएगा यदि `optimize` अक्षम है।
+- **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` अक्षम है।
+  - _नोट_: अधिकांश मामलों में, React एप्लिकेशन के लिए `"dynamic"` का उपयोग किया जाएगा, Vue.js एप्लिकेशन के लिए `"async"` का उपयोग किया जाएगा।
+  - _नोट_: यह विकल्प `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` और `useDictionaryDynamic` फ़ंक्शन को प्रभावित नहीं करेगा।
 
 - **traversePattern**:
   - _प्रकार_: `string[]`

package/docs/hi/how_works_intlayer.md

@@ -103,7 +103,7 @@ Babel और SWC प्लगइन्स आपके एप्लिकेश
 
 डेवलपमेंट मोड में, Intlayer डिक्शनरीज़ के लिए केंद्रीकृत स्थिर आयात का उपयोग करता है ताकि विकास अनुभव को सरल बनाया जा सके।
 
-[कॉन्फ़िगरेशन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md) में `activateDynamicImport` विकल्प को सक्रिय करके, Intlayer डिक्शनरीज़ को लोड करने के लिए डायनेमिक आयात का उपयोग करेगा। यह विकल्प डिफ़ॉल्ट रूप से अक्षम है ताकि एप्लिकेशन को रेंडर करते समय असिंक्रोनस प्रोसेसिंग से बचा जा सके।
+[कॉन्फ़िगरेशन](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md) में `importMode = "dynamic"` विकल्प को सक्रिय करके, Intlayer डिक्शनरीज़ को लोड करने के लिए डायनेमिक आयात का उपयोग करेगा। यह विकल्प डिफ़ॉल्ट रूप से अक्षम है ताकि एप्लिकेशन को रेंडर करते समय असिंक्रोनस प्रोसेसिंग से बचा जा सके।
 
 > `@intlayer/babel` डिफ़ॉल्ट रूप से `vite-intlayer` पैकेज पर उपलब्ध है,
 

package/docs/it/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 @@ Impostazioni che controllano come Intlayer ottimizza e compila l'internazionaliz
 
 Le opzioni di build si applicano ai plugin `@intlayer/babel` e `@intlayer/swc`.
 
-> In modalità sviluppo, Intlayer utilizza un'importazione statica centralizzata per i dizionari per semplificare l'esperienza di sviluppo.
+> In modalità sviluppo, Intlayer utilizza importazioni statiche per i dizionari per semplificare l'esperienza di sviluppo.
 
-> Ottimizzando il build, Intlayer sostituirà tutte le chiamate dei dizionari per ottimizzare il chunking. In questo modo il bundle finale importerà solo i dizionari che vengono utilizzati.
-
-- **Nota**: `@intlayer/babel` è disponibile per impostazione predefinita nel pacchetto `vite-intlayer`, ma `@intlayer/swc` non è installato per impostazione predefinita nel pacchetto `next-intlayer` poiché i plugin SWC sono ancora sperimentali su Next.js.
+> Durante l'ottimizzazione, Intlayer sostituirà le chiamate ai dizionari per ottimizzare il chunking, in modo che il bundle finale importi solo i dizionari che vengono effettivamente utilizzati.
 
 #### Proprietà
 
@@ -494,21 +492,28 @@ Le opzioni di build si applicano ai plugin `@intlayer/babel` e `@intlayer/swc`.
   - _Predefinito_: `process.env.NODE_ENV === 'production'`
   - _Descrizione_: Controlla se il build deve essere ottimizzato.
   - _Esempio_: `true`
-  - _Nota_: Permetterà di importare solo i dizionari utilizzati nel bundle. Ma tutte le importazioni rimarranno come importazione statica per evitare l'elaborazione asincrona durante il caricamento dei dizionari.
-  - _Nota_: Quando abilitato, Intlayer ottimizzerà il chunking del dizionario sostituendo tutte le chiamate di `useIntlayer` con `useDictionary` e `getIntlayer` con `getDictionary`.
+  - _Nota_: Quando abilitato, Intlayer sostituirà tutte le chiamate dei dizionari per ottimizzare il chunking. In questo modo il bundle finale importerà solo i dizionari utilizzati. Tutte le importazioni rimarranno come importazioni statiche per evitare l'elaborazione asincrona durante il caricamento dei dizionari.
+  - _Nota_: Intlayer sostituirà tutte le chiamate di `useIntlayer` con la modalità definita dall'opzione `importMode` e `getIntlayer` con `getDictionary`.
+  - _Nota_: Questa opzione si basa sui plugin `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Assicurati che tutte le chiavi siano dichiarate staticamente nelle chiamate `useIntlayer`. ad esempio: `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _Tipo_: `boolean`
-  - _Predefinito_: `false`
-  - _Descrizione_: Controlla se il contenuto del dizionario deve essere importato dinamicamente per lingua.
-  - _Esempio_: `true`
-  - _Nota_: Permetterà di importare dinamicamente il contenuto del dizionario solo per la lingua corrente.
-  - _Nota_: Le importazioni dinamiche si basano su React Suspense e possono influire leggermente sulle prestazioni di rendering. Ma se disabilitato tutte le lingue verranno caricate contemporaneamente, anche se non vengono utilizzate.
-  - _Nota_: Quando abilitato, Intlayer ottimizzerà il chunking del dizionario sostituendo tutte le chiamate di `useIntlayer` con `useDynamicDictionary`.
-  - _Nota_: Questa opzione verrà ignorata se `optimize` è disabilitato.
+- **importMode**:
+
+  - _Tipo_: `'static' | 'dynamic' | 'async'`
+  - _Predefinito_: `'static'`
+  - _Descrizione_: Controlla come vengono importati i dizionari.
+  - _Esempio_: `'dynamic'`
+  - _Nota_: Modalità disponibili:
+    - "static": I dizionari vengono importati staticamente. Sostituisce `useIntlayer` con `useDictionary`.
+    - "dynamic": I dizionari vengono importati dinamicamente utilizzando Suspense. Sostituisce `useIntlayer` con `useDictionaryDynamic`.
+    - "async": I dizionari vengono importati dinamicamente in modo asincrono. Sostituisce `useIntlayer` con `await useDictionaryAsync`.
+  - _Nota_: Le importazioni dinamiche si basano su Suspense e possono influire leggermente sulle prestazioni di rendering.
+  - _Nota_: Se disabilitato, tutte le lingue verranno caricate contemporaneamente, anche se non vengono utilizzate.
+  - _Nota_: Questa opzione si basa sui plugin `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Assicurati che tutte le chiavi siano dichiarate staticamente nelle chiamate `useIntlayer`. ad esempio: `useIntlayer('navbar')`.
+  - _Nota_: Questa opzione verrà ignorata se `optimize` è disabilitato.
+  - _Nota_: Nella maggior parte dei casi, `"dynamic"` verrà utilizzato per le applicazioni React, `"async"` per le applicazioni Vue.js.
+  - _Nota_: Questa opzione non influenzerà le funzioni `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` e `useDictionaryDynamic`.
 
 - **traversePattern**:
   - _Tipo_: `string[]`

package/docs/it/how_works_intlayer.md

@@ -103,7 +103,7 @@ I plugin Babel e SWC funzionano analizzando l'Abstract Syntax Tree (AST) della t
 
 In modalità sviluppo, Intlayer utilizza un'importazione statica centralizzata per i dizionari per semplificare l'esperienza di sviluppo.
 
-Attivando l'opzione `activateDynamicImport` nella [configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md), Intlayer utilizzerà l'importazione dinamica per caricare i dizionari. Questa opzione è disattivata di default per evitare processi asincroni durante il rendering dell'applicazione.
+Attivando l'opzione `importMode = "dynamic"` nella [configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md), Intlayer utilizzerà l'importazione dinamica per caricare i dizionari. Questa opzione è disattivata di default per evitare processi asincroni durante il rendering dell'applicazione.
 
 > `@intlayer/babel` è disponibile di default nel pacchetto `vite-intlayer`,
 

package/docs/ja/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 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
 
 ビルドオプションは`@intlayer/babel`および`@intlayer/swc`プラグインに適用されます。
 
-> 開発モードでは、Intlayerは開発体験を簡素化するために辞書の一元化された静的インポートを使用します。
+> 開発モードでは、Intlayerは開発体験を簡素化するために辞書の静的インポートを使用します。
 
-> ビルドを最適化することで、Intlayerはチャンキングを最適化するためにすべての辞書の呼び出しを置き換えます。これにより、最終的なバンドルは使用される辞書のみをインポートします。
-
-- **注意**: `@intlayer/babel`は`vite-intlayer`パッケージでデフォルトで利用可能ですが、`@intlayer/swc`はNext.jsでのSWCプラグインがまだ実験的であるため、`next-intlayer`パッケージではデフォルトでインストールされていません。
+> 最適化時、Intlayerはチャンキングを最適化するために辞書の呼び出しを置き換え、最終的なバンドルが実際に使用される辞書のみをインポートするようにします。
 
 #### プロパティ
 
@@ -495,21 +493,28 @@ Intlayerがアプリケーションの国際化をどのように最適化しビ
   - _デフォルト_: `process.env.NODE_ENV === 'production'`
   - _説明_: ビルドを最適化するかどうかを制御します。
   - _例_: `true`
-  - _注意_: 使用される辞書のみをバンドルにインポートすることを可能にします。ただし、すべてのインポートは辞書の読み込み時の非同期処理を避けるために静的インポートのままとなります。
-  - _注意_: 有効にすると、Intlayerはすべての`useIntlayer`呼び出しを`useDictionary`に、`getIntlayer`を`getDictionary`に置き換えることで辞書のチャンキングを最適化します。
+  - _注意_: 有効にすると、Intlayerはチャンキングを最適化するためにすべての辞書の呼び出しを置き換えます。これにより、最終的なバンドルは使用される辞書のみをインポートします。すべてのインポートは辞書の読み込み時の非同期処理を避けるために静的インポートのままとなります。
+  - _注意_: Intlayerは`importMode`オプションによって定義されたモードですべての`useIntlayer`呼び出しを置き換え、`getIntlayer`を`getDictionary`に置き換えます。
+  - _注意_: このオプションは`@intlayer/babel`および`@intlayer/swc`プラグインに依存します。
   - _注意_: すべてのキーが`useIntlayer`呼び出しで静的に宣言されていることを確認してください。例：`useIntlayer('navbar')`。
 
-- **activateDynamicImport**:
-
-  - _型_: `boolean`
-  - _デフォルト_: `false`
-  - _説明_: 辞書コンテンツをロケールごとに動的にインポートするかどうかを制御します。
-  - _例_: `true`
-  - _注意_: 現在のロケールの辞書コンテンツのみを動的にインポートすることを可能にします。
-  - _注意_: 動的インポートはReact Suspenseに依存し、レンダリングパフォーマンスに若干の影響を与える可能性があります。ただし、無効にすると、使用されていない場合でもすべてのロケールが一度に読み込まれます。
-  - _注意_: 有効にすると、Intlayerはすべての`useIntlayer`呼び出しを`useDynamicDictionary`に置き換えることで辞書のチャンキングを最適化します。
-  - _注意_: このオプションは`optimize`が無効の場合は無視されます。
+- **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`が無効の場合は無視されます。
+  - _注意_: ほとんどの場合、Reactアプリケーションには`"dynamic"`が、Vue.jsアプリケーションには`"async"`が使用されます。
+  - _注意_: このオプションは`getIntlayer`、`getDictionary`、`useDictionary`、`useDictionaryAsync`、`useDictionaryDynamic`関数に影響しません。
 
 - **traversePattern**:
   - _型_: `string[]`

package/docs/ja/how_works_intlayer.md

@@ -103,7 +103,7 @@ BabelおよびSWCプラグインは、アプリケーションの抽象構文木
 
 開発モードでは、Intlayerは辞書の集中型静的インポートを使用して開発体験を簡素化します。
 
-[設定](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)で`activateDynamicImport`オプションを有効にすると、Intlayerは動的インポートを使用して辞書をロードします。このオプションは、アプリケーションのレンダリング時に非同期処理を回避するためにデフォルトで無効になっています。
+[設定](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)で`importMode = "dynamic"`オプションを有効にすると、Intlayerは動的インポートを使用して辞書をロードします。このオプションは、アプリケーションのレンダリング時に非同期処理を回避するためにデフォルトで無効になっています。
 
 > `@intlayer/babel`は`vite-intlayer`パッケージでデフォルトで利用可能です。
 

package/docs/ko/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 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
 
 빌드 옵션은 `@intlayer/babel` 및 `@intlayer/swc` 플러그인에 적용됩니다.
 
-> 개발 모드에서 Intlayer는 개발 경험을 단순화하기 위해 사전에 대해 중앙 집중식 정적 가져오기를 사용합니다.
+> 개발 모드에서 Intlayer는 개발 경험을 단순화하기 위해 사전에 대해 정적 가져오기를 사용합니다.
 
-> 빌드를 최적화함으로써 Intlayer는 청킹을 최적화하기 위해 모든 사전 호출을 대체합니다. 이렇게 하면 최종 번들은 사용되는 사전만 가져옵니다.
-
-- **참고**: `@intlayer/babel`은 `vite-intlayer` 패키지에서 기본적으로 사용할 수 있지만, `@intlayer/swc`는 SWC 플러그인이 Next.js에서 아직 실험적이기 때문에 `next-intlayer` 패키지에서 기본적으로 설치되지 않습니다.
+> 최적화 시 Intlayer는 청킹을 최적화하기 위해 사전 호출을 대체하여 최종 번들이 실제로 사용되는 사전만 가져오도록 합니다.
 
 #### 속성
 
@@ -494,21 +492,28 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
   - _기본값_: `process.env.NODE_ENV === 'production'`
   - _설명_: 빌드를 최적화해야 하는지 여부를 제어합니다.
   - _예시_: `true`
-  - _참고_: 번들에 사용되는 사전만 가져올 수 있습니다. 하지만 모든 가져오기는 사전을 로드할 때 비동기 처리를 피하기 위해 정적 가져오기로 유지됩니다.
-  - _참고_: 활성화되면 Intlayer는 모든 `useIntlayer` 호출을 `useDictionary`로, `getIntlayer`를 `getDictionary`로 대체하여 사전 청킹을 최적화합니다.
+  - _참고_: 활성화되면 Intlayer는 청킹을 최적화하기 위해 모든 사전 호출을 대체합니다. 이렇게 하면 최종 번들이 사용되는 사전만 가져옵니다. 모든 가져오기는 사전을 로드할 때 비동기 처리를 피하기 위해 정적 가져오기로 유지됩니다.
+  - _참고_: Intlayer는 `importMode` 옵션에 의해 정의된 모드로 모든 `useIntlayer` 호출을 대체하고 `getIntlayer`를 `getDictionary`로 대체합니다.
+  - _참고_: 이 옵션은 `@intlayer/babel` 및 `@intlayer/swc` 플러그인에 의존합니다.
   - _참고_: 모든 키가 `useIntlayer` 호출에서 정적으로 선언되어 있는지 확인하세요. 예: `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _유형_: `boolean`
-  - _기본값_: `false`
-  - _설명_: 사전 콘텐츠를 로케일별로 동적으로 가져와야 하는지 여부를 제어합니다.
-  - _예시_: `true`
-  - _참고_: 현재 로케일의 사전 콘텐츠만 동적으로 가져올 수 있습니다.
-  - _참고_: 동적 가져오기는 React Suspense에 의존하며 렌더링 성능에 약간의 영향을 미칠 수 있습니다. 하지만 비활성화되면 사용되지 않더라도 모든 로케일이 한 번에 로드됩니다.
-  - _참고_: 활성화되면 Intlayer는 모든 `useIntlayer` 호출을 `useDynamicDictionary`로 대체하여 사전 청킹을 최적화합니다.
-  - _참고_: 이 옵션은 `optimize`가 비활성화된 경우 무시됩니다.
+- **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`가 비활성화된 경우 무시됩니다.
+  - _참고_: 대부분의 경우 React 애플리케이션에는 `"dynamic"`이, Vue.js 애플리케이션에는 `"async"`가 사용됩니다.
+  - _참고_: 이 옵션은 `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` 및 `useDictionaryDynamic` 함수에 영향을 미치지 않습니다.
 
 - **traversePattern**:
   - _유형_: `string[]`

package/docs/ko/how_works_intlayer.md

@@ -103,7 +103,7 @@ Babel 및 SWC 플러그인은 애플리케이션의 추상 구문 트리(Abstrac
 
 개발 모드에서는 Intlayer가 사전을 중앙 집중식 정적 가져오기로 사용하여 개발 경험을 단순화합니다.
 
-[설정](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에서 `activateDynamicImport` 옵션을 활성화하면 Intlayer는 동적 가져오기를 사용하여 사전을 로드합니다. 이 옵션은 애플리케이션 렌더링 시 비동기 처리를 방지하기 위해 기본적으로 비활성화되어 있습니다.
+[설정](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에서 `importMode = "dynamic"` 옵션을 활성화하면 Intlayer는 동적 가져오기를 사용하여 사전을 로드합니다. 이 옵션은 애플리케이션 렌더링 시 비동기 처리를 방지하기 위해 기본적으로 비활성화되어 있습니다.
 
 > `@intlayer/babel`는 `vite-intlayer` 패키지에 기본으로 포함되어 있습니다.
 

package/docs/pt/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",
   },
 };
 
@@ -482,11 +482,9 @@ Configurações que controlam como o Intlayer otimiza e compila a internacionali
 
 As opções de build se aplicam aos plugins `@intlayer/babel` e `@intlayer/swc`.
 
-> No modo de desenvolvimento, o Intlayer usa uma importação estática centralizada para dicionários para simplificar a experiência de desenvolvimento.
+> No modo de desenvolvimento, o Intlayer usa importações estáticas para dicionários para simplificar a experiência de desenvolvimento.
 
-> Ao otimizar o build, o Intlayer substituirá todas as chamadas de dicionários para otimizar o chunking. Dessa forma, o bundle final importará apenas os dicionários que são utilizados.
-
-- **Nota**: `@intlayer/babel` está disponível por padrão no pacote `vite-intlayer`, mas `@intlayer/swc` não está instalado por padrão no pacote `next-intlayer`, pois os plugins SWC ainda são experimentais no Next.js.
+> Durante a otimização, o Intlayer substituirá as chamadas aos dicionários para otimizar o chunking, de modo que o bundle final importe apenas os dicionários que são realmente utilizados.
 
 #### Propriedades
 
@@ -496,21 +494,28 @@ As opções de build se aplicam aos plugins `@intlayer/babel` e `@intlayer/swc`.
   - _Padrão_: `process.env.NODE_ENV === 'production'`
   - _Descrição_: Controla se o build deve ser otimizado.
   - _Exemplo_: `true`
-  - _Nota_: Permitirá importar apenas os dicionários que são utilizados no bundle. Mas todas as importações permanecerão como importação estática para evitar processamento assíncrono ao carregar os dicionários.
-  - _Nota_: Quando ativado, o Intlayer otimizará o chunking do dicionário substituindo todas as chamadas de `useIntlayer` por `useDictionary` e `getIntlayer` por `getDictionary`.
+  - _Nota_: Quando ativado, o Intlayer substituirá todas as chamadas de dicionários para otimizar o chunking. Dessa forma, o bundle final importará apenas os dicionários que são utilizados. Todas as importações permanecerão como importações estáticas para evitar processamento assíncrono ao carregar os dicionários.
+  - _Nota_: O Intlayer substituirá todas as chamadas de `useIntlayer` com o modo definido pela opção `importMode` e `getIntlayer` por `getDictionary`.
+  - _Nota_: Esta opção depende dos plugins `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Certifique-se de que todas as chaves sejam declaradas estaticamente nas chamadas `useIntlayer`. por exemplo: `useIntlayer('navbar')`.
 
-- **activateDynamicImport**:
-
-  - _Tipo_: `boolean`
-  - _Padrão_: `false`
-  - _Descrição_: Controla se o conteúdo do dicionário deve ser importado dinamicamente por idioma.
-  - _Exemplo_: `true`
-  - _Nota_: Permitirá importar dinamicamente o conteúdo do dicionário apenas para o idioma atual.
-  - _Nota_: Importações dinâmicas dependem do React Suspense e podem impactar levemente o desempenho de renderização. Mas se desativado todos os idiomas serão carregados de uma vez, mesmo que não sejam utilizados.
-  - _Nota_: Quando ativado, o Intlayer otimizará o chunking do dicionário substituindo todas as chamadas de `useIntlayer` por `useDynamicDictionary`.
-  - _Nota_: Esta opção será ignorada se `optimize` estiver desativado.
+- **importMode**:
+
+  - _Tipo_: `'static' | 'dynamic' | 'async'`
+  - _Padrão_: `'static'`
+  - _Descrição_: Controla como os dicionários são importados.
+  - _Exemplo_: `'dynamic'`
+  - _Nota_: Modos disponíveis:
+    - "static": Os dicionários são importados estaticamente. Substitui `useIntlayer` por `useDictionary`.
+    - "dynamic": Os dicionários são importados dinamicamente usando Suspense. Substitui `useIntlayer` por `useDictionaryDynamic`.
+    - "async": Os dicionários são importados dinamicamente de forma assíncrona. Substitui `useIntlayer` por `await useDictionaryAsync`.
+  - _Nota_: Importações dinâmicas dependem do Suspense e podem impactar levemente o desempenho de renderização.
+  - _Nota_: Se desativado, todos os idiomas serão carregados de uma vez, mesmo que não sejam utilizados.
+  - _Nota_: Esta opção depende dos plugins `@intlayer/babel` e `@intlayer/swc`.
   - _Nota_: Certifique-se de que todas as chaves sejam declaradas estaticamente nas chamadas `useIntlayer`. por exemplo: `useIntlayer('navbar')`.
+  - _Nota_: Esta opção será ignorada se `optimize` estiver desativado.
+  - _Nota_: Na maioria dos casos, `"dynamic"` será usado para aplicações React, `"async"` para aplicações Vue.js.
+  - _Nota_: Esta opção não afetará as funções `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` e `useDictionaryDynamic`.
 
 - **traversePattern**:
   - _Tipo_: `string[]`

package/docs/pt/how_works_intlayer.md

@@ -104,7 +104,7 @@ Os plugins Babel e SWC funcionam analisando a Árvore de Sintaxe Abstrata (AST)
 
 No modo de desenvolvimento, o Intlayer usa uma importação estática centralizada para os dicionários, simplificando a experiência de desenvolvimento.
 
-Ao ativar a opção `activateDynamicImport` na [configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md), o Intlayer usará a importação dinâmica para carregar os dicionários. Essa opção está desativada por padrão para evitar processamento assíncrono ao renderizar a aplicação.
+Ao ativar a opção `importMode = "dynamic"` na [configuração](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/configuration.md), o Intlayer usará a importação dinâmica para carregar os dicionários. Essa opção está desativada por padrão para evitar processamento assíncrono ao renderizar a aplicação.
 
 > `@intlayer/babel` está disponível por padrão no pacote `vite-intlayer`,
 

package/docs/ru/configuration.md

@@ -59,7 +59,7 @@ const config: IntlayerConfig = {
     applicationContext: "Это тестовое приложение",
   },
   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 @@ Intlayer поддерживает нескольких провайдеров AI
 
 Параметры сборки применяются к плагинам `@intlayer/babel` и `@intlayer/swc`.
 
-> В режиме разработки Intlayer использует централизованный статический импорт для словарей, чтобы упростить процесс разработки.
+> В режиме разработки Intlayer использует статические импорты для словарей, чтобы упростить процесс разработки.
 
-> При оптимизации сборки Intlayer заменит все вызовы словарей для оптимизации разделения на чанки. Таким образом, финальный бандл будет импортировать только используемые словари.
-
-- **Примечание**: `@intlayer/babel` доступен по умолчанию в пакете `vite-intlayer`, но `@intlayer/swc` не установлен по умолчанию в пакете `next-intlayer`, так как плагины SWC все еще экспериментальны в Next.js.
+> При оптимизации Intlayer заменит вызовы словарей для оптимизации разделения на чанки, чтобы финальный бандл импортировал только действительно используемые словари.
 
 #### Свойства
 
@@ -494,21 +492,28 @@ Intlayer поддерживает нескольких провайдеров AI
   - _По умолчанию_: `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`.
-  - _Примечание_: Эта опция будет проигнорирована, если `optimize` отключен.
+- **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` отключен.
+  - _Примечание_: В большинстве случаев `"dynamic"` будет использоваться для React-приложений, `"async"` для Vue.js-приложений.
+  - _Примечание_: Эта опция не повлияет на функции `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` и `useDictionaryDynamic`.
 
 - **traversePattern**:
   - _Тип_: `string[]`

package/docs/ru/how_works_intlayer.md

@@ -103,7 +103,7 @@ Intlayer также предоставляет визуальный редакт
 
 В режиме разработки Intlayer использует централизованный статический импорт для словарей, чтобы упростить процесс разработки.
 
-Активировав опцию `activateDynamicImport` в [конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md), Intlayer будет использовать динамический импорт для загрузки словарей. Эта опция отключена по умолчанию, чтобы избежать асинхронной обработки при рендеринге приложения.
+Активировав опцию `importMode = "dynamic"` в [конфигурации](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md), Intlayer будет использовать динамический импорт для загрузки словарей. Эта опция отключена по умолчанию, чтобы избежать асинхронной обработки при рендеринге приложения.
 
 > `@intlayer/babel` доступен по умолчанию в пакете `vite-intlayer`,
 

package/docs/zh/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", // 启用动态导入
   },
 };
 
@@ -482,11 +482,9 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择性。目前支
 
 构建选项适用于 `@intlayer/babel` 和 `@intlayer/swc` 插件。
 
-> 在开发模式下，Intlayer 使用集中式静态导入字典以简化开发体验。
+> 在开发模式下，Intlayer 使用静态导入字典以简化开发体验。
 
-> 通过优化构建，Intlayer 将替换所有字典调用以优化分块。这样，最终的包只会导入使用到的字典。
-
-- **注意**：`@intlayer/babel` 在 `vite-intlayer` 包中默认可用，但由于 SWC 插件在 Next.js 中仍处于实验阶段，`@intlayer/swc` 在 `next-intlayer` 包中默认未安装。
+> 优化时，Intlayer 将替换字典调用以优化分块，以便最终包只导入实际使用的字典。
 
 #### 属性
 
@@ -496,21 +494,28 @@ Intlayer 支持多个 AI 提供商，以增强灵活性和选择性。目前支
   - _默认值_：`process.env.NODE_ENV === 'production'`
   - _描述_：控制构建是否应被优化。
   - _示例_：`true`
-  - _注意_：这将允许只导入包中使用的字典。但所有导入都将保持为静态导入，以避免加载字典时的异步处理。
-  - _注意_：启用时，Intlayer 将通过将所有 `useIntlayer` 调用替换为 `useDictionary` 和 `getIntlayer` 替换为 `getDictionary` 来优化字典分块。
+  - _注意_：启用时，Intlayer 将替换所有字典调用以优化分块。这样，最终包将只导入使用的字典。所有导入都将保持为静态导入，以避免加载字典时的异步处理。
+  - _注意_：Intlayer 将用 `importMode` 选项定义的模式替换所有 `useIntlayer` 调用，并将 `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')`。
+  - _注意_：在大多数情况下，React 应用程序将使用 `"dynamic"`，Vue.js 应用程序将使用 `"async"`。
+  - _注意_：此选项不会影响 `getIntlayer`、`getDictionary`、`useDictionary`、`useDictionaryAsync` 和 `useDictionaryDynamic` 函数。
 
 - **traversePattern**：
   - _类型_：`string[]`