@intlayer/babel 5.5.11 → 5.7.0

package/README.md

@@ -33,7 +33,7 @@
       <a href="https://www.facebook.com/intlayer" target="blank"><img align="center"
          src="https://img.shields.io/badge/facebook-4267B2.svg?style=for-the-badge&logo=facebook&logoColor=white"
          alt="Intlayer Facebook" height="30"/></a>
-      <a href="https://www.instagram.com/intlayer_org/" target="blank"><img align="center"
+      <a href="https://www.instagram.com/intlayer/" target="blank"><img align="center"
          src="https://img.shields.io/badge/instagram-%23E4405F.svg?style=for-the-badge&logo=Instagram&logoColor=white"
          alt="Intlayer Instagram" height="30"/></a>
       <a href="https://x.com/Intlayer183096" target="blank"><img align="center"

package/dist/cjs/babel-plugin-intlayer.cjs

@@ -57,12 +57,19 @@ const PACKAGE_LIST_DYNAMIC = [
   "next-intlayer",
   "next-intlayer/client",
   "next-intlayer/server",
-  "preact-intlayer"
+  "preact-intlayer",
+  "vue-intlayer",
+  "solid-intlayer",
+  "svelte-intlayer",
+  "angular-intlayer"
 ];
 const STATIC_IMPORT_FUNCTION = {
   getIntlayer: "getDictionary",
   useIntlayer: "useDictionary"
 };
+const ASYNC_IMPORT_FUNCTION = {
+  useIntlayer: "useDictionaryAsync"
+};
 const DYNAMIC_IMPORT_FUNCTION = {
   useIntlayer: "useDictionaryDynamic"
 };
@@ -86,6 +93,7 @@ const intlayerBabelPlugin = () => {
       this._hasValidImport = false;
       this._isDictEntry = false;
       this._useDynamicHelpers = false;
+      this._useAsyncHelpers = false;
       const filename = this.file.opts.filename;
       if (this.opts.filesList && filename) {
         const isIncluded = this.opts.filesList.includes(filename);
@@ -174,15 +182,29 @@ const intlayerBabelPlugin = () => {
         for (const spec of path.node.specifiers) {
           if (!t.isImportSpecifier(spec)) continue;
           const importedName = t.isIdentifier(spec.imported) ? spec.imported.name : spec.imported.value;
-          const activateDynamicImport = state.opts.activateDynamicImport;
-          const shouldUseDynamicHelpers = activateDynamicImport && PACKAGE_LIST_DYNAMIC.includes(src);
+          const importMode = state.opts.importMode;
+          const shouldUseDynamicHelpers = importMode === "dynamic" && PACKAGE_LIST_DYNAMIC.includes(src);
+          const shouldUseAsyncHelpers = importMode === "async" && PACKAGE_LIST_DYNAMIC.includes(src);
           if (shouldUseDynamicHelpers) {
             state._useDynamicHelpers = true;
           }
-          const helperMap = shouldUseDynamicHelpers ? {
-            ...STATIC_IMPORT_FUNCTION,
-            ...DYNAMIC_IMPORT_FUNCTION
-          } : STATIC_IMPORT_FUNCTION;
+          if (shouldUseAsyncHelpers) {
+            state._useAsyncHelpers = true;
+          }
+          let helperMap;
+          if (shouldUseAsyncHelpers) {
+            helperMap = {
+              ...STATIC_IMPORT_FUNCTION,
+              ...ASYNC_IMPORT_FUNCTION
+            };
+          } else if (shouldUseDynamicHelpers) {
+            helperMap = {
+              ...STATIC_IMPORT_FUNCTION,
+              ...DYNAMIC_IMPORT_FUNCTION
+            };
+          } else {
+            helperMap = STATIC_IMPORT_FUNCTION;
+          }
           const newIdentifier = helperMap[importedName];
           if (newIdentifier) {
             spec.imported = t.identifier(newIdentifier);
@@ -200,9 +222,22 @@ const intlayerBabelPlugin = () => {
         if (!arg || !t.isStringLiteral(arg)) return;
         const key = arg.value;
         const useDynamic = Boolean(state._useDynamicHelpers);
+        const useAsync = Boolean(state._useAsyncHelpers);
         const shouldUseDynamicForThisCall = callee.name === "useIntlayer" && useDynamic;
+        const shouldUseAsyncForThisCall = callee.name === "useIntlayer" && useAsync;
         let ident;
-        if (shouldUseDynamicForThisCall) {
+        if (shouldUseAsyncForThisCall) {
+          let dynamicIdent = state._newDynamicImports.get(key);
+          if (!dynamicIdent) {
+            const hash = (0, import_chokidar.getFileHash)(key);
+            dynamicIdent = t.identifier(`_${hash}_dyn`);
+            state._newDynamicImports.set(key, dynamicIdent);
+          }
+          ident = dynamicIdent;
+          path.node.arguments[0] = t.identifier(ident.name);
+          const awaitExpression = t.awaitExpression(path.node);
+          path.replaceWith(awaitExpression);
+        } else if (shouldUseDynamicForThisCall) {
           let dynamicIdent = state._newDynamicImports.get(key);
           if (!dynamicIdent) {
             const hash = (0, import_chokidar.getFileHash)(key);

package/dist/cjs/babel-plugin-intlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/babel-plugin-intlayer.ts"],"sourcesContent":["import type { NodePath, PluginObj, PluginPass } from '@babel/core';\nimport * as t from '@babel/types';\nimport { getFileHash } from '@intlayer/chokidar';\nimport { dirname, join, relative } from 'node:path';\n\n/* ────────────────────────────────────────── constants ───────────────────── */\n\nconst PACKAGE_LIST = [\n  'intlayer',\n  '@intlayer/core',\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'svelte-intlayer',\n  'vue-intlayer',\n  'angular-intlayer',\n  'preact-intlayer',\n  'solid-intlayer',\n];\n\nconst CALLER_LIST = ['useIntlayer', 'getIntlayer'] as const;\n\n/**\n * Packages that support dynamic import\n */\nconst PACKAGE_LIST_DYNAMIC = [\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'preact-intlayer',\n] as const;\n\nconst STATIC_IMPORT_FUNCTION = {\n  getIntlayer: 'getDictionary',\n  useIntlayer: 'useDictionary',\n} as const;\n\nconst DYNAMIC_IMPORT_FUNCTION = {\n  useIntlayer: 'useDictionaryDynamic',\n} as const;\n\n/* ────────────────────────────────────────── types ───────────────────────── */\n\ntype State = PluginPass & {\n  opts: {\n    /**\n     * The path to the dictionaries directory.\n     */\n    dictionariesDir: string;\n    /**\n     * The path to the dictionaries entry file.\n     */\n    dictionariesEntryPath: string;\n    /**\n     * The path to the dictionaries directory.\n     */\n    dynamicDictionariesDir: string;\n    /**\n     * The path to the dynamic dictionaries entry file.\n     */\n    dynamicDictionariesEntryPath: string;\n    /**\n     * If true, the plugin will replace the dictionary entry file with `export default {}`.\n     */\n    replaceDictionaryEntry?: boolean;\n    /**\n     * If true, the plugin will activate the dynamic import of the dictionaries.\n     */\n    activateDynamicImport?: boolean;\n    /**\n     * Files list to traverse.\n     */\n    filesList?: string[];\n  };\n  /** map key → generated ident (per-file) for static imports */\n  _newStaticImports?: Map<string, t.Identifier>;\n  /** map key → generated ident (per-file) for dynamic imports */\n  _newDynamicImports?: Map<string, t.Identifier>;\n  /** whether the current file imported *any* intlayer package */\n  _hasValidImport?: boolean;\n  /** whether the current file *is* the dictionaries entry file */\n  _isDictEntry?: boolean;\n  /** whether dynamic helpers are active for this file */\n  _useDynamicHelpers?: boolean;\n};\n\n/* ────────────────────────────────────────── helpers ─────────────────────── */\n\n/**\n * Replicates the xxHash64 → Base-62 algorithm used by the SWC version\n * and prefixes an underscore so the generated identifiers never collide\n * with user-defined ones.\n */\nconst makeIdent = (key: string): t.Identifier => {\n  const hash = getFileHash(key);\n  return t.identifier(`_${hash}`);\n};\n\nconst computeRelativeImport = (\n  fromFile: string,\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  key: string,\n  isDynamic = false\n): string => {\n  const jsonPath = isDynamic\n    ? join(dynamicDictionariesDir, `${key}.mjs`)\n    : join(dictionariesDir, `${key}.json`);\n\n  let rel = relative(dirname(fromFile), jsonPath).replace(/\\\\/g, '/'); // win →\n  if (!rel.startsWith('./') && !rel.startsWith('../')) rel = `./${rel}`;\n  return rel;\n};\n\n/* ────────────────────────────────────────── plugin ──────────────────────── */\n\n/**\n * Babel plugin that transforms `useIntlayer/getIntlayer` calls into\n * `useDictionary/getDictionary` and auto-imports the required JSON dictionaries.\n *\n *\n * This means cases like:\n *\n * ```ts\n * import { getIntlayer } from 'intlayer';\n * import { useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer('app');\n * const content2 = useIntlayer('app');\n * ```\n *\n * will be transformed into:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.mjs';\n * import { getDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash)\n * ```\n *\n * Or if the `activateDynamicImport` option is enabled:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import _dicHash_dyn from '../../.intlayer/dictionaries/app.mjs';\n *\n * import { useDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash_dyn, 'app');\n * ```\n */\nexport const intlayerBabelPlugin = (): PluginObj<State> => {\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newStaticImports = new Map();\n      this._newDynamicImports = new Map();\n      this._isIncluded = true;\n      this._hasValidImport = false;\n      this._isDictEntry = false;\n      this._useDynamicHelpers = false;\n\n      // If filesList is provided, check if current file is included\n      const filename = this.file.opts.filename;\n      if (this.opts.filesList && filename) {\n        const isIncluded = this.opts.filesList.includes(filename);\n\n        if (!isIncluded) {\n          // Force _isIncluded to false to skip processing\n          this._isIncluded = false;\n          return;\n        }\n      }\n    },\n\n    visitor: {\n      /* 0. If this file *is* the dictionaries entry, short-circuit: export {} */\n      Program: {\n        enter(programPath, state) {\n          const filename = state.file.opts.filename!;\n          if (\n            state.opts.replaceDictionaryEntry &&\n            filename === state.opts.dictionariesEntryPath\n          ) {\n            state._isDictEntry = true;\n            // Replace all existing statements with: export default {}\n            programPath.node.body = [\n              t.exportDefaultDeclaration(t.objectExpression([])),\n            ];\n            // Stop further traversal for this plugin – nothing else to transform\n            programPath.stop();\n          }\n        },\n\n        /* 3. After full traversal, inject the JSON dictionary imports. */\n        exit(programPath, state) {\n          if (state._isDictEntry) return; // nothing else to do – already replaced\n          if (!state._hasValidImport) return; // early-out if we touched nothing\n          if (!state._isIncluded) return; // early-out if file is not included\n\n          const file = state.file.opts.filename!;\n          const dictionariesDir = state.opts.dictionariesDir;\n          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;\n          const imports: t.ImportDeclaration[] = [];\n\n          // Generate static imports (for getIntlayer and useIntlayer when not using dynamic)\n          for (const [key, ident] of state._newStaticImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              false // Always static\n            );\n            const importDeclarationNode = t.importDeclaration(\n              [t.importDefaultSpecifier(t.identifier(ident.name))],\n              t.stringLiteral(rel)\n            );\n\n            importDeclarationNode.attributes = [\n              t.importAttribute(t.identifier('type'), t.stringLiteral('json')),\n            ];\n\n            imports.push(importDeclarationNode);\n          }\n\n          // Generate dynamic imports (for useIntlayer when using dynamic helpers)\n          for (const [key, ident] of state._newDynamicImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              true // Always dynamic\n            );\n            imports.push(\n              t.importDeclaration(\n                [t.importDefaultSpecifier(t.identifier(ident.name))],\n                t.stringLiteral(rel)\n              )\n            );\n          }\n\n          if (!imports.length) return;\n\n          /* Keep \"use client\" / \"use server\" directives at the very top. */\n          const bodyPaths = programPath.get('body') as NodePath<t.Statement>[];\n          let insertPos = 0;\n          for (const stmtPath of bodyPaths) {\n            const stmt = stmtPath.node;\n            if (\n              t.isExpressionStatement(stmt) &&\n              t.isStringLiteral(stmt.expression) &&\n              !stmt.expression.value.startsWith('import') &&\n              !stmt.expression.value.startsWith('require')\n            ) {\n              insertPos += 1;\n            } else {\n              break;\n            }\n          }\n\n          programPath.node.body.splice(insertPos, 0, ...imports);\n        },\n      },\n\n      /* 1. Inspect *every* intlayer import. */\n      ImportDeclaration(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const src = path.node.source.value;\n        if (!PACKAGE_LIST.includes(src)) return;\n\n        // Mark that we do import from an intlayer package in this file; this is\n        // enough to know that we *might* need to inject runtime helpers later.\n        state._hasValidImport = true;\n\n        for (const spec of path.node.specifiers) {\n          if (!t.isImportSpecifier(spec)) continue;\n\n          // ⚠️  We now key off *imported* name, *not* local name.\n          const importedName = t.isIdentifier(spec.imported)\n            ? spec.imported.name\n            : (spec.imported as t.StringLiteral).value;\n\n          const activateDynamicImport = state.opts.activateDynamicImport;\n          // Determine whether this import should use the dynamic helpers. We\n          // only switch to the dynamic helpers when (1) the option is turned\n          // on AND (2) the package we are importing from supports the dynamic\n          // helpers.\n          const shouldUseDynamicHelpers =\n            activateDynamicImport && PACKAGE_LIST_DYNAMIC.includes(src as any);\n\n          // Remember for later (CallExpression) whether we are using the dynamic helpers\n          if (shouldUseDynamicHelpers) {\n            state._useDynamicHelpers = true;\n          }\n\n          const helperMap = shouldUseDynamicHelpers\n            ? ({\n                ...STATIC_IMPORT_FUNCTION,\n                ...DYNAMIC_IMPORT_FUNCTION,\n              } as Record<string, string>)\n            : (STATIC_IMPORT_FUNCTION as Record<string, string>);\n\n          const newIdentifier = helperMap[importedName];\n\n          // Only rewrite when we actually have a mapping for the imported\n          // specifier (ignore unrelated named imports).\n          if (newIdentifier) {\n            // Keep the local alias intact (so calls remain `useIntlayer` /\n            // `getIntlayer`), but rewrite the imported identifier so it\n            // points to our helper implementation.\n            spec.imported = t.identifier(newIdentifier);\n          }\n        }\n      },\n\n      /* 2. Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) or useDictionaryDynamic(_hash, \"foo\") */\n      CallExpression(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const callee = path.node.callee;\n        if (!t.isIdentifier(callee)) return;\n        if (!CALLER_LIST.includes(callee.name as any)) return;\n\n        // Ensure we ultimately emit helper imports for files that *invoke*\n        // the hooks, even if they didn't import them directly (edge cases with\n        // re-exports).\n        state._hasValidImport = true;\n\n        const arg = path.node.arguments[0];\n        if (!arg || !t.isStringLiteral(arg)) return; // must be literal\n\n        const key = arg.value;\n        const useDynamic = Boolean(state._useDynamicHelpers);\n\n        // Determine if this specific call should use dynamic imports\n        const shouldUseDynamicForThisCall =\n          callee.name === 'useIntlayer' && useDynamic;\n\n        let ident: t.Identifier;\n\n        if (shouldUseDynamicForThisCall) {\n          // Use dynamic imports for useIntlayer when dynamic helpers are enabled\n          let dynamicIdent = state._newDynamicImports!.get(key);\n          if (!dynamicIdent) {\n            // Create a unique identifier for dynamic imports by appending a suffix\n            const hash = getFileHash(key);\n            dynamicIdent = t.identifier(`_${hash}_dyn`);\n            state._newDynamicImports!.set(key, dynamicIdent);\n          }\n          ident = dynamicIdent;\n\n          // Dynamic helper: first argument is the dictionary, second is the key.\n          path.node.arguments = [\n            t.identifier(ident.name),\n            ...path.node.arguments,\n          ];\n        } else {\n          // Use static imports for getIntlayer or useIntlayer when not using dynamic helpers\n          let staticIdent = state._newStaticImports!.get(key);\n          if (!staticIdent) {\n            staticIdent = makeIdent(key);\n            state._newStaticImports!.set(key, staticIdent);\n          }\n          ident = staticIdent;\n\n          // Static helper (useDictionary / getDictionary): replace key with ident.\n          path.node.arguments[0] = t.identifier(ident.name);\n        }\n      },\n    },\n  };\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/babel-plugin-intlayer.ts"],"sourcesContent":["import type { NodePath, PluginObj, PluginPass } from '@babel/core';\nimport * as t from '@babel/types';\nimport { getFileHash } from '@intlayer/chokidar';\nimport { dirname, join, relative } from 'node:path';\n\n/* ────────────────────────────────────────── constants ───────────────────── */\n\nconst PACKAGE_LIST = [\n  'intlayer',\n  '@intlayer/core',\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'svelte-intlayer',\n  'vue-intlayer',\n  'angular-intlayer',\n  'preact-intlayer',\n  'solid-intlayer',\n];\n\nconst CALLER_LIST = ['useIntlayer', 'getIntlayer'] as const;\n\n/**\n * Packages that support dynamic import\n */\nconst PACKAGE_LIST_DYNAMIC = [\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'preact-intlayer',\n  'vue-intlayer',\n  'solid-intlayer',\n  'svelte-intlayer',\n  'angular-intlayer',\n] as const;\n\nconst STATIC_IMPORT_FUNCTION = {\n  getIntlayer: 'getDictionary',\n  useIntlayer: 'useDictionary',\n} as const;\n\nconst ASYNC_IMPORT_FUNCTION = {\n  useIntlayer: 'useDictionaryAsync',\n} as const;\n\nconst DYNAMIC_IMPORT_FUNCTION = {\n  useIntlayer: 'useDictionaryDynamic',\n} as const;\n\n/* ────────────────────────────────────────── types ───────────────────────── */\n\ntype State = PluginPass & {\n  opts: {\n    /**\n     * The path to the dictionaries directory.\n     */\n    dictionariesDir: string;\n    /**\n     * The path to the dictionaries entry file.\n     */\n    dictionariesEntryPath: string;\n    /**\n     * The path to the dictionaries directory.\n     */\n    dynamicDictionariesDir: string;\n    /**\n     * The path to the dynamic dictionaries entry file.\n     */\n    dynamicDictionariesEntryPath: string;\n    /**\n     * If true, the plugin will replace the dictionary entry file with `export default {}`.\n     */\n    replaceDictionaryEntry?: boolean;\n    /**\n     * If true, the plugin will activate the dynamic import of the dictionaries. It will rely on Suspense to load the dictionaries.\n     */\n    importMode?: 'static' | 'dynamic' | 'async';\n    /**\n     * Files list to traverse.\n     */\n    filesList?: string[];\n  };\n  /** map key → generated ident (per-file) for static imports */\n  _newStaticImports?: Map<string, t.Identifier>;\n  /** map key → generated ident (per-file) for dynamic imports */\n  _newDynamicImports?: Map<string, t.Identifier>;\n  /** whether the current file imported *any* intlayer package */\n  _hasValidImport?: boolean;\n  /** whether the current file *is* the dictionaries entry file */\n  _isDictEntry?: boolean;\n  /** whether dynamic helpers are active for this file */\n  _useDynamicHelpers?: boolean;\n  /** whether async helpers are active for this file */\n  _useAsyncHelpers?: boolean;\n};\n\n/* ────────────────────────────────────────── helpers ─────────────────────── */\n\n/**\n * Replicates the xxHash64 → Base-62 algorithm used by the SWC version\n * and prefixes an underscore so the generated identifiers never collide\n * with user-defined ones.\n */\nconst makeIdent = (key: string): t.Identifier => {\n  const hash = getFileHash(key);\n  return t.identifier(`_${hash}`);\n};\n\nconst computeRelativeImport = (\n  fromFile: string,\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  key: string,\n  isDynamic = false\n): string => {\n  const jsonPath = isDynamic\n    ? join(dynamicDictionariesDir, `${key}.mjs`)\n    : join(dictionariesDir, `${key}.json`);\n\n  let rel = relative(dirname(fromFile), jsonPath).replace(/\\\\/g, '/'); // win →\n  if (!rel.startsWith('./') && !rel.startsWith('../')) rel = `./${rel}`;\n  return rel;\n};\n\n/* ────────────────────────────────────────── plugin ──────────────────────── */\n\n/**\n * Babel plugin that transforms `useIntlayer/getIntlayer` calls into\n * `useDictionary/getDictionary` and auto-imports the required JSON dictionaries.\n *\n *\n * This means cases like:\n *\n * ```ts\n * import { getIntlayer } from 'intlayer';\n * import { useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer('app');\n * const content2 = useIntlayer('app');\n * ```\n *\n * will be transformed into:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.mjs';\n * import { getDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash)\n * ```\n *\n * If the `importMode = \"dynamic\"` option:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import _dicHash_dyn from '../../.intlayer/dictionaries/app.mjs';\n *\n * import { useDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash_dyn, 'app');\n * ```\n *\n * Or if the `importMode = \"async\"` option:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.mjs';\n * import { useDictionaryAsync as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = await useIntlayer(_dicHash_dyn);\n * ```\n */\nexport const intlayerBabelPlugin = (): PluginObj<State> => {\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newStaticImports = new Map();\n      this._newDynamicImports = new Map();\n      this._isIncluded = true;\n      this._hasValidImport = false;\n      this._isDictEntry = false;\n      this._useDynamicHelpers = false;\n      this._useAsyncHelpers = false;\n\n      // If filesList is provided, check if current file is included\n      const filename = this.file.opts.filename;\n      if (this.opts.filesList && filename) {\n        const isIncluded = this.opts.filesList.includes(filename);\n\n        if (!isIncluded) {\n          // Force _isIncluded to false to skip processing\n          this._isIncluded = false;\n          return;\n        }\n      }\n    },\n\n    visitor: {\n      /* 0. If this file *is* the dictionaries entry, short-circuit: export {} */\n      Program: {\n        enter(programPath, state) {\n          const filename = state.file.opts.filename!;\n          if (\n            state.opts.replaceDictionaryEntry &&\n            filename === state.opts.dictionariesEntryPath\n          ) {\n            state._isDictEntry = true;\n            // Replace all existing statements with: export default {}\n            programPath.node.body = [\n              t.exportDefaultDeclaration(t.objectExpression([])),\n            ];\n            // Stop further traversal for this plugin – nothing else to transform\n            programPath.stop();\n          }\n        },\n\n        /* 3. After full traversal, inject the JSON dictionary imports. */\n        exit(programPath, state) {\n          if (state._isDictEntry) return; // nothing else to do – already replaced\n          if (!state._hasValidImport) return; // early-out if we touched nothing\n          if (!state._isIncluded) return; // early-out if file is not included\n\n          const file = state.file.opts.filename!;\n          const dictionariesDir = state.opts.dictionariesDir;\n          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;\n          const imports: t.ImportDeclaration[] = [];\n\n          // Generate static imports (for getIntlayer and useIntlayer when not using dynamic)\n          for (const [key, ident] of state._newStaticImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              false // Always static\n            );\n            const importDeclarationNode = t.importDeclaration(\n              [t.importDefaultSpecifier(t.identifier(ident.name))],\n              t.stringLiteral(rel)\n            );\n\n            importDeclarationNode.attributes = [\n              t.importAttribute(t.identifier('type'), t.stringLiteral('json')),\n            ];\n\n            imports.push(importDeclarationNode);\n          }\n\n          // Generate dynamic imports (for useIntlayer when using dynamic helpers)\n          for (const [key, ident] of state._newDynamicImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              true // Always dynamic\n            );\n            imports.push(\n              t.importDeclaration(\n                [t.importDefaultSpecifier(t.identifier(ident.name))],\n                t.stringLiteral(rel)\n              )\n            );\n          }\n\n          if (!imports.length) return;\n\n          /* Keep \"use client\" / \"use server\" directives at the very top. */\n          const bodyPaths = programPath.get('body') as NodePath<t.Statement>[];\n          let insertPos = 0;\n          for (const stmtPath of bodyPaths) {\n            const stmt = stmtPath.node;\n            if (\n              t.isExpressionStatement(stmt) &&\n              t.isStringLiteral(stmt.expression) &&\n              !stmt.expression.value.startsWith('import') &&\n              !stmt.expression.value.startsWith('require')\n            ) {\n              insertPos += 1;\n            } else {\n              break;\n            }\n          }\n\n          programPath.node.body.splice(insertPos, 0, ...imports);\n        },\n      },\n\n      /* 1. Inspect *every* intlayer import. */\n      ImportDeclaration(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const src = path.node.source.value;\n        if (!PACKAGE_LIST.includes(src)) return;\n\n        // Mark that we do import from an intlayer package in this file; this is\n        // enough to know that we *might* need to inject runtime helpers later.\n        state._hasValidImport = true;\n\n        for (const spec of path.node.specifiers) {\n          if (!t.isImportSpecifier(spec)) continue;\n\n          // ⚠️  We now key off *imported* name, *not* local name.\n          const importedName = t.isIdentifier(spec.imported)\n            ? spec.imported.name\n            : (spec.imported as t.StringLiteral).value;\n\n          const importMode = state.opts.importMode;\n          // Determine whether this import should use the dynamic helpers. We\n          // only switch to the dynamic helpers when (1) the option is turned\n          // on AND (2) the package we are importing from supports the dynamic\n          // helpers.\n          const shouldUseDynamicHelpers =\n            importMode === 'dynamic' &&\n            PACKAGE_LIST_DYNAMIC.includes(src as any);\n\n          // Determine whether this import should use the async helpers. We\n          // only switch to the async helpers when (1) the option is turned\n          // on AND (2) the package we are importing from supports the async\n          // helpers.\n          const shouldUseAsyncHelpers =\n            importMode === 'async' && PACKAGE_LIST_DYNAMIC.includes(src as any);\n\n          // Remember for later (CallExpression) whether we are using the dynamic helpers\n          if (shouldUseDynamicHelpers) {\n            state._useDynamicHelpers = true;\n          }\n\n          // Remember for later (CallExpression) whether we are using the async helpers\n          if (shouldUseAsyncHelpers) {\n            state._useAsyncHelpers = true;\n          }\n\n          let helperMap: Record<string, string>;\n\n          if (shouldUseAsyncHelpers) {\n            // Use async helpers for useIntlayer when async mode is enabled\n            helperMap = {\n              ...STATIC_IMPORT_FUNCTION,\n              ...ASYNC_IMPORT_FUNCTION,\n            } as Record<string, string>;\n          } else if (shouldUseDynamicHelpers) {\n            // Use dynamic helpers for useIntlayer when dynamic mode is enabled\n            helperMap = {\n              ...STATIC_IMPORT_FUNCTION,\n              ...DYNAMIC_IMPORT_FUNCTION,\n            } as Record<string, string>;\n          } else {\n            // Use static helpers by default\n            helperMap = STATIC_IMPORT_FUNCTION as Record<string, string>;\n          }\n\n          const newIdentifier = helperMap[importedName];\n\n          // Only rewrite when we actually have a mapping for the imported\n          // specifier (ignore unrelated named imports).\n          if (newIdentifier) {\n            // Keep the local alias intact (so calls remain `useIntlayer` /\n            // `getIntlayer`), but rewrite the imported identifier so it\n            // points to our helper implementation.\n            spec.imported = t.identifier(newIdentifier);\n          }\n        }\n      },\n\n      /* 2. Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) or useDictionaryDynamic(_hash, \"foo\") */\n      CallExpression(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const callee = path.node.callee;\n        if (!t.isIdentifier(callee)) return;\n        if (!CALLER_LIST.includes(callee.name as any)) return;\n\n        // Ensure we ultimately emit helper imports for files that *invoke*\n        // the hooks, even if they didn't import them directly (edge cases with\n        // re-exports).\n        state._hasValidImport = true;\n\n        const arg = path.node.arguments[0];\n        if (!arg || !t.isStringLiteral(arg)) return; // must be literal\n\n        const key = arg.value;\n        const useDynamic = Boolean(state._useDynamicHelpers);\n        const useAsync = Boolean(state._useAsyncHelpers);\n\n        // Determine if this specific call should use dynamic imports\n        const shouldUseDynamicForThisCall =\n          callee.name === 'useIntlayer' && useDynamic;\n\n        // Determine if this specific call should use async imports\n        const shouldUseAsyncForThisCall =\n          callee.name === 'useIntlayer' && useAsync;\n\n        let ident: t.Identifier;\n\n        if (shouldUseAsyncForThisCall) {\n          // Use dynamic imports for useIntlayer when async helpers are enabled\n          let dynamicIdent = state._newDynamicImports!.get(key);\n          if (!dynamicIdent) {\n            // Create a unique identifier for dynamic imports by appending a suffix\n            const hash = getFileHash(key);\n            dynamicIdent = t.identifier(`_${hash}_dyn`);\n            state._newDynamicImports!.set(key, dynamicIdent);\n          }\n          ident = dynamicIdent;\n\n          // Async helper: first argument is the dictionary promise.\n          path.node.arguments[0] = t.identifier(ident.name);\n\n          // Wrap the call with await for async helpers\n          const awaitExpression = t.awaitExpression(path.node);\n          path.replaceWith(awaitExpression);\n        } else if (shouldUseDynamicForThisCall) {\n          // Use dynamic imports for useIntlayer when dynamic helpers are enabled\n          let dynamicIdent = state._newDynamicImports!.get(key);\n          if (!dynamicIdent) {\n            // Create a unique identifier for dynamic imports by appending a suffix\n            const hash = getFileHash(key);\n            dynamicIdent = t.identifier(`_${hash}_dyn`);\n            state._newDynamicImports!.set(key, dynamicIdent);\n          }\n          ident = dynamicIdent;\n\n          // Dynamic helper: first argument is the dictionary, second is the key.\n          path.node.arguments = [\n            t.identifier(ident.name),\n            ...path.node.arguments,\n          ];\n        } else {\n          // Use static imports for getIntlayer or useIntlayer when not using dynamic helpers\n          let staticIdent = state._newStaticImports!.get(key);\n          if (!staticIdent) {\n            staticIdent = makeIdent(key);\n            state._newStaticImports!.set(key, staticIdent);\n          }\n          ident = staticIdent;\n\n          // Static helper (useDictionary / getDictionary): replace key with ident.\n          path.node.arguments[0] = t.identifier(ident.name);\n        }\n      },\n    },\n  };\n};\n"],"mappings":"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","names":[]}

package/dist/esm/babel-plugin-intlayer.mjs

@@ -24,12 +24,19 @@ const PACKAGE_LIST_DYNAMIC = [
   "next-intlayer",
   "next-intlayer/client",
   "next-intlayer/server",
-  "preact-intlayer"
+  "preact-intlayer",
+  "vue-intlayer",
+  "solid-intlayer",
+  "svelte-intlayer",
+  "angular-intlayer"
 ];
 const STATIC_IMPORT_FUNCTION = {
   getIntlayer: "getDictionary",
   useIntlayer: "useDictionary"
 };
+const ASYNC_IMPORT_FUNCTION = {
+  useIntlayer: "useDictionaryAsync"
+};
 const DYNAMIC_IMPORT_FUNCTION = {
   useIntlayer: "useDictionaryDynamic"
 };
@@ -53,6 +60,7 @@ const intlayerBabelPlugin = () => {
       this._hasValidImport = false;
       this._isDictEntry = false;
       this._useDynamicHelpers = false;
+      this._useAsyncHelpers = false;
       const filename = this.file.opts.filename;
       if (this.opts.filesList && filename) {
         const isIncluded = this.opts.filesList.includes(filename);
@@ -141,15 +149,29 @@ const intlayerBabelPlugin = () => {
         for (const spec of path.node.specifiers) {
           if (!t.isImportSpecifier(spec)) continue;
           const importedName = t.isIdentifier(spec.imported) ? spec.imported.name : spec.imported.value;
-          const activateDynamicImport = state.opts.activateDynamicImport;
-          const shouldUseDynamicHelpers = activateDynamicImport && PACKAGE_LIST_DYNAMIC.includes(src);
+          const importMode = state.opts.importMode;
+          const shouldUseDynamicHelpers = importMode === "dynamic" && PACKAGE_LIST_DYNAMIC.includes(src);
+          const shouldUseAsyncHelpers = importMode === "async" && PACKAGE_LIST_DYNAMIC.includes(src);
           if (shouldUseDynamicHelpers) {
             state._useDynamicHelpers = true;
           }
-          const helperMap = shouldUseDynamicHelpers ? {
-            ...STATIC_IMPORT_FUNCTION,
-            ...DYNAMIC_IMPORT_FUNCTION
-          } : STATIC_IMPORT_FUNCTION;
+          if (shouldUseAsyncHelpers) {
+            state._useAsyncHelpers = true;
+          }
+          let helperMap;
+          if (shouldUseAsyncHelpers) {
+            helperMap = {
+              ...STATIC_IMPORT_FUNCTION,
+              ...ASYNC_IMPORT_FUNCTION
+            };
+          } else if (shouldUseDynamicHelpers) {
+            helperMap = {
+              ...STATIC_IMPORT_FUNCTION,
+              ...DYNAMIC_IMPORT_FUNCTION
+            };
+          } else {
+            helperMap = STATIC_IMPORT_FUNCTION;
+          }
           const newIdentifier = helperMap[importedName];
           if (newIdentifier) {
             spec.imported = t.identifier(newIdentifier);
@@ -167,9 +189,22 @@ const intlayerBabelPlugin = () => {
         if (!arg || !t.isStringLiteral(arg)) return;
         const key = arg.value;
         const useDynamic = Boolean(state._useDynamicHelpers);
+        const useAsync = Boolean(state._useAsyncHelpers);
         const shouldUseDynamicForThisCall = callee.name === "useIntlayer" && useDynamic;
+        const shouldUseAsyncForThisCall = callee.name === "useIntlayer" && useAsync;
         let ident;
-        if (shouldUseDynamicForThisCall) {
+        if (shouldUseAsyncForThisCall) {
+          let dynamicIdent = state._newDynamicImports.get(key);
+          if (!dynamicIdent) {
+            const hash = getFileHash(key);
+            dynamicIdent = t.identifier(`_${hash}_dyn`);
+            state._newDynamicImports.set(key, dynamicIdent);
+          }
+          ident = dynamicIdent;
+          path.node.arguments[0] = t.identifier(ident.name);
+          const awaitExpression = t.awaitExpression(path.node);
+          path.replaceWith(awaitExpression);
+        } else if (shouldUseDynamicForThisCall) {
           let dynamicIdent = state._newDynamicImports.get(key);
           if (!dynamicIdent) {
             const hash = getFileHash(key);

package/dist/esm/babel-plugin-intlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/babel-plugin-intlayer.ts"],"sourcesContent":["import type { NodePath, PluginObj, PluginPass } from '@babel/core';\nimport * as t from '@babel/types';\nimport { getFileHash } from '@intlayer/chokidar';\nimport { dirname, join, relative } from 'node:path';\n\n/* ────────────────────────────────────────── constants ───────────────────── */\n\nconst PACKAGE_LIST = [\n  'intlayer',\n  '@intlayer/core',\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'svelte-intlayer',\n  'vue-intlayer',\n  'angular-intlayer',\n  'preact-intlayer',\n  'solid-intlayer',\n];\n\nconst CALLER_LIST = ['useIntlayer', 'getIntlayer'] as const;\n\n/**\n * Packages that support dynamic import\n */\nconst PACKAGE_LIST_DYNAMIC = [\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'preact-intlayer',\n] as const;\n\nconst STATIC_IMPORT_FUNCTION = {\n  getIntlayer: 'getDictionary',\n  useIntlayer: 'useDictionary',\n} as const;\n\nconst DYNAMIC_IMPORT_FUNCTION = {\n  useIntlayer: 'useDictionaryDynamic',\n} as const;\n\n/* ────────────────────────────────────────── types ───────────────────────── */\n\ntype State = PluginPass & {\n  opts: {\n    /**\n     * The path to the dictionaries directory.\n     */\n    dictionariesDir: string;\n    /**\n     * The path to the dictionaries entry file.\n     */\n    dictionariesEntryPath: string;\n    /**\n     * The path to the dictionaries directory.\n     */\n    dynamicDictionariesDir: string;\n    /**\n     * The path to the dynamic dictionaries entry file.\n     */\n    dynamicDictionariesEntryPath: string;\n    /**\n     * If true, the plugin will replace the dictionary entry file with `export default {}`.\n     */\n    replaceDictionaryEntry?: boolean;\n    /**\n     * If true, the plugin will activate the dynamic import of the dictionaries.\n     */\n    activateDynamicImport?: boolean;\n    /**\n     * Files list to traverse.\n     */\n    filesList?: string[];\n  };\n  /** map key → generated ident (per-file) for static imports */\n  _newStaticImports?: Map<string, t.Identifier>;\n  /** map key → generated ident (per-file) for dynamic imports */\n  _newDynamicImports?: Map<string, t.Identifier>;\n  /** whether the current file imported *any* intlayer package */\n  _hasValidImport?: boolean;\n  /** whether the current file *is* the dictionaries entry file */\n  _isDictEntry?: boolean;\n  /** whether dynamic helpers are active for this file */\n  _useDynamicHelpers?: boolean;\n};\n\n/* ────────────────────────────────────────── helpers ─────────────────────── */\n\n/**\n * Replicates the xxHash64 → Base-62 algorithm used by the SWC version\n * and prefixes an underscore so the generated identifiers never collide\n * with user-defined ones.\n */\nconst makeIdent = (key: string): t.Identifier => {\n  const hash = getFileHash(key);\n  return t.identifier(`_${hash}`);\n};\n\nconst computeRelativeImport = (\n  fromFile: string,\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  key: string,\n  isDynamic = false\n): string => {\n  const jsonPath = isDynamic\n    ? join(dynamicDictionariesDir, `${key}.mjs`)\n    : join(dictionariesDir, `${key}.json`);\n\n  let rel = relative(dirname(fromFile), jsonPath).replace(/\\\\/g, '/'); // win →\n  if (!rel.startsWith('./') && !rel.startsWith('../')) rel = `./${rel}`;\n  return rel;\n};\n\n/* ────────────────────────────────────────── plugin ──────────────────────── */\n\n/**\n * Babel plugin that transforms `useIntlayer/getIntlayer` calls into\n * `useDictionary/getDictionary` and auto-imports the required JSON dictionaries.\n *\n *\n * This means cases like:\n *\n * ```ts\n * import { getIntlayer } from 'intlayer';\n * import { useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer('app');\n * const content2 = useIntlayer('app');\n * ```\n *\n * will be transformed into:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.mjs';\n * import { getDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash)\n * ```\n *\n * Or if the `activateDynamicImport` option is enabled:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import _dicHash_dyn from '../../.intlayer/dictionaries/app.mjs';\n *\n * import { useDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash_dyn, 'app');\n * ```\n */\nexport const intlayerBabelPlugin = (): PluginObj<State> => {\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newStaticImports = new Map();\n      this._newDynamicImports = new Map();\n      this._isIncluded = true;\n      this._hasValidImport = false;\n      this._isDictEntry = false;\n      this._useDynamicHelpers = false;\n\n      // If filesList is provided, check if current file is included\n      const filename = this.file.opts.filename;\n      if (this.opts.filesList && filename) {\n        const isIncluded = this.opts.filesList.includes(filename);\n\n        if (!isIncluded) {\n          // Force _isIncluded to false to skip processing\n          this._isIncluded = false;\n          return;\n        }\n      }\n    },\n\n    visitor: {\n      /* 0. If this file *is* the dictionaries entry, short-circuit: export {} */\n      Program: {\n        enter(programPath, state) {\n          const filename = state.file.opts.filename!;\n          if (\n            state.opts.replaceDictionaryEntry &&\n            filename === state.opts.dictionariesEntryPath\n          ) {\n            state._isDictEntry = true;\n            // Replace all existing statements with: export default {}\n            programPath.node.body = [\n              t.exportDefaultDeclaration(t.objectExpression([])),\n            ];\n            // Stop further traversal for this plugin – nothing else to transform\n            programPath.stop();\n          }\n        },\n\n        /* 3. After full traversal, inject the JSON dictionary imports. */\n        exit(programPath, state) {\n          if (state._isDictEntry) return; // nothing else to do – already replaced\n          if (!state._hasValidImport) return; // early-out if we touched nothing\n          if (!state._isIncluded) return; // early-out if file is not included\n\n          const file = state.file.opts.filename!;\n          const dictionariesDir = state.opts.dictionariesDir;\n          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;\n          const imports: t.ImportDeclaration[] = [];\n\n          // Generate static imports (for getIntlayer and useIntlayer when not using dynamic)\n          for (const [key, ident] of state._newStaticImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              false // Always static\n            );\n            const importDeclarationNode = t.importDeclaration(\n              [t.importDefaultSpecifier(t.identifier(ident.name))],\n              t.stringLiteral(rel)\n            );\n\n            importDeclarationNode.attributes = [\n              t.importAttribute(t.identifier('type'), t.stringLiteral('json')),\n            ];\n\n            imports.push(importDeclarationNode);\n          }\n\n          // Generate dynamic imports (for useIntlayer when using dynamic helpers)\n          for (const [key, ident] of state._newDynamicImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              true // Always dynamic\n            );\n            imports.push(\n              t.importDeclaration(\n                [t.importDefaultSpecifier(t.identifier(ident.name))],\n                t.stringLiteral(rel)\n              )\n            );\n          }\n\n          if (!imports.length) return;\n\n          /* Keep \"use client\" / \"use server\" directives at the very top. */\n          const bodyPaths = programPath.get('body') as NodePath<t.Statement>[];\n          let insertPos = 0;\n          for (const stmtPath of bodyPaths) {\n            const stmt = stmtPath.node;\n            if (\n              t.isExpressionStatement(stmt) &&\n              t.isStringLiteral(stmt.expression) &&\n              !stmt.expression.value.startsWith('import') &&\n              !stmt.expression.value.startsWith('require')\n            ) {\n              insertPos += 1;\n            } else {\n              break;\n            }\n          }\n\n          programPath.node.body.splice(insertPos, 0, ...imports);\n        },\n      },\n\n      /* 1. Inspect *every* intlayer import. */\n      ImportDeclaration(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const src = path.node.source.value;\n        if (!PACKAGE_LIST.includes(src)) return;\n\n        // Mark that we do import from an intlayer package in this file; this is\n        // enough to know that we *might* need to inject runtime helpers later.\n        state._hasValidImport = true;\n\n        for (const spec of path.node.specifiers) {\n          if (!t.isImportSpecifier(spec)) continue;\n\n          // ⚠️  We now key off *imported* name, *not* local name.\n          const importedName = t.isIdentifier(spec.imported)\n            ? spec.imported.name\n            : (spec.imported as t.StringLiteral).value;\n\n          const activateDynamicImport = state.opts.activateDynamicImport;\n          // Determine whether this import should use the dynamic helpers. We\n          // only switch to the dynamic helpers when (1) the option is turned\n          // on AND (2) the package we are importing from supports the dynamic\n          // helpers.\n          const shouldUseDynamicHelpers =\n            activateDynamicImport && PACKAGE_LIST_DYNAMIC.includes(src as any);\n\n          // Remember for later (CallExpression) whether we are using the dynamic helpers\n          if (shouldUseDynamicHelpers) {\n            state._useDynamicHelpers = true;\n          }\n\n          const helperMap = shouldUseDynamicHelpers\n            ? ({\n                ...STATIC_IMPORT_FUNCTION,\n                ...DYNAMIC_IMPORT_FUNCTION,\n              } as Record<string, string>)\n            : (STATIC_IMPORT_FUNCTION as Record<string, string>);\n\n          const newIdentifier = helperMap[importedName];\n\n          // Only rewrite when we actually have a mapping for the imported\n          // specifier (ignore unrelated named imports).\n          if (newIdentifier) {\n            // Keep the local alias intact (so calls remain `useIntlayer` /\n            // `getIntlayer`), but rewrite the imported identifier so it\n            // points to our helper implementation.\n            spec.imported = t.identifier(newIdentifier);\n          }\n        }\n      },\n\n      /* 2. Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) or useDictionaryDynamic(_hash, \"foo\") */\n      CallExpression(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const callee = path.node.callee;\n        if (!t.isIdentifier(callee)) return;\n        if (!CALLER_LIST.includes(callee.name as any)) return;\n\n        // Ensure we ultimately emit helper imports for files that *invoke*\n        // the hooks, even if they didn't import them directly (edge cases with\n        // re-exports).\n        state._hasValidImport = true;\n\n        const arg = path.node.arguments[0];\n        if (!arg || !t.isStringLiteral(arg)) return; // must be literal\n\n        const key = arg.value;\n        const useDynamic = Boolean(state._useDynamicHelpers);\n\n        // Determine if this specific call should use dynamic imports\n        const shouldUseDynamicForThisCall =\n          callee.name === 'useIntlayer' && useDynamic;\n\n        let ident: t.Identifier;\n\n        if (shouldUseDynamicForThisCall) {\n          // Use dynamic imports for useIntlayer when dynamic helpers are enabled\n          let dynamicIdent = state._newDynamicImports!.get(key);\n          if (!dynamicIdent) {\n            // Create a unique identifier for dynamic imports by appending a suffix\n            const hash = getFileHash(key);\n            dynamicIdent = t.identifier(`_${hash}_dyn`);\n            state._newDynamicImports!.set(key, dynamicIdent);\n          }\n          ident = dynamicIdent;\n\n          // Dynamic helper: first argument is the dictionary, second is the key.\n          path.node.arguments = [\n            t.identifier(ident.name),\n            ...path.node.arguments,\n          ];\n        } else {\n          // Use static imports for getIntlayer or useIntlayer when not using dynamic helpers\n          let staticIdent = state._newStaticImports!.get(key);\n          if (!staticIdent) {\n            staticIdent = makeIdent(key);\n            state._newStaticImports!.set(key, staticIdent);\n          }\n          ident = staticIdent;\n\n          // Static helper (useDictionary / getDictionary): replace key with ident.\n          path.node.arguments[0] = t.identifier(ident.name);\n        }\n      },\n    },\n  };\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/babel-plugin-intlayer.ts"],"sourcesContent":["import type { NodePath, PluginObj, PluginPass } from '@babel/core';\nimport * as t from '@babel/types';\nimport { getFileHash } from '@intlayer/chokidar';\nimport { dirname, join, relative } from 'node:path';\n\n/* ────────────────────────────────────────── constants ───────────────────── */\n\nconst PACKAGE_LIST = [\n  'intlayer',\n  '@intlayer/core',\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'svelte-intlayer',\n  'vue-intlayer',\n  'angular-intlayer',\n  'preact-intlayer',\n  'solid-intlayer',\n];\n\nconst CALLER_LIST = ['useIntlayer', 'getIntlayer'] as const;\n\n/**\n * Packages that support dynamic import\n */\nconst PACKAGE_LIST_DYNAMIC = [\n  'react-intlayer',\n  'react-intlayer/client',\n  'react-intlayer/server',\n  'next-intlayer',\n  'next-intlayer/client',\n  'next-intlayer/server',\n  'preact-intlayer',\n  'vue-intlayer',\n  'solid-intlayer',\n  'svelte-intlayer',\n  'angular-intlayer',\n] as const;\n\nconst STATIC_IMPORT_FUNCTION = {\n  getIntlayer: 'getDictionary',\n  useIntlayer: 'useDictionary',\n} as const;\n\nconst ASYNC_IMPORT_FUNCTION = {\n  useIntlayer: 'useDictionaryAsync',\n} as const;\n\nconst DYNAMIC_IMPORT_FUNCTION = {\n  useIntlayer: 'useDictionaryDynamic',\n} as const;\n\n/* ────────────────────────────────────────── types ───────────────────────── */\n\ntype State = PluginPass & {\n  opts: {\n    /**\n     * The path to the dictionaries directory.\n     */\n    dictionariesDir: string;\n    /**\n     * The path to the dictionaries entry file.\n     */\n    dictionariesEntryPath: string;\n    /**\n     * The path to the dictionaries directory.\n     */\n    dynamicDictionariesDir: string;\n    /**\n     * The path to the dynamic dictionaries entry file.\n     */\n    dynamicDictionariesEntryPath: string;\n    /**\n     * If true, the plugin will replace the dictionary entry file with `export default {}`.\n     */\n    replaceDictionaryEntry?: boolean;\n    /**\n     * If true, the plugin will activate the dynamic import of the dictionaries. It will rely on Suspense to load the dictionaries.\n     */\n    importMode?: 'static' | 'dynamic' | 'async';\n    /**\n     * Files list to traverse.\n     */\n    filesList?: string[];\n  };\n  /** map key → generated ident (per-file) for static imports */\n  _newStaticImports?: Map<string, t.Identifier>;\n  /** map key → generated ident (per-file) for dynamic imports */\n  _newDynamicImports?: Map<string, t.Identifier>;\n  /** whether the current file imported *any* intlayer package */\n  _hasValidImport?: boolean;\n  /** whether the current file *is* the dictionaries entry file */\n  _isDictEntry?: boolean;\n  /** whether dynamic helpers are active for this file */\n  _useDynamicHelpers?: boolean;\n  /** whether async helpers are active for this file */\n  _useAsyncHelpers?: boolean;\n};\n\n/* ────────────────────────────────────────── helpers ─────────────────────── */\n\n/**\n * Replicates the xxHash64 → Base-62 algorithm used by the SWC version\n * and prefixes an underscore so the generated identifiers never collide\n * with user-defined ones.\n */\nconst makeIdent = (key: string): t.Identifier => {\n  const hash = getFileHash(key);\n  return t.identifier(`_${hash}`);\n};\n\nconst computeRelativeImport = (\n  fromFile: string,\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  key: string,\n  isDynamic = false\n): string => {\n  const jsonPath = isDynamic\n    ? join(dynamicDictionariesDir, `${key}.mjs`)\n    : join(dictionariesDir, `${key}.json`);\n\n  let rel = relative(dirname(fromFile), jsonPath).replace(/\\\\/g, '/'); // win →\n  if (!rel.startsWith('./') && !rel.startsWith('../')) rel = `./${rel}`;\n  return rel;\n};\n\n/* ────────────────────────────────────────── plugin ──────────────────────── */\n\n/**\n * Babel plugin that transforms `useIntlayer/getIntlayer` calls into\n * `useDictionary/getDictionary` and auto-imports the required JSON dictionaries.\n *\n *\n * This means cases like:\n *\n * ```ts\n * import { getIntlayer } from 'intlayer';\n * import { useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer('app');\n * const content2 = useIntlayer('app');\n * ```\n *\n * will be transformed into:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.mjs';\n * import { getDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash)\n * ```\n *\n * If the `importMode = \"dynamic\"` option:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import _dicHash_dyn from '../../.intlayer/dictionaries/app.mjs';\n *\n * import { useDictionary as getIntlayer } from 'intlayer';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = useIntlayer(_dicHash_dyn, 'app');\n * ```\n *\n * Or if the `importMode = \"async\"` option:\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.mjs';\n * import { useDictionaryAsync as useIntlayer } from 'react-intlayer';\n *\n * // ...\n *\n * const content1 = getIntlayer(_dicHash);\n * const content2 = await useIntlayer(_dicHash_dyn);\n * ```\n */\nexport const intlayerBabelPlugin = (): PluginObj<State> => {\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newStaticImports = new Map();\n      this._newDynamicImports = new Map();\n      this._isIncluded = true;\n      this._hasValidImport = false;\n      this._isDictEntry = false;\n      this._useDynamicHelpers = false;\n      this._useAsyncHelpers = false;\n\n      // If filesList is provided, check if current file is included\n      const filename = this.file.opts.filename;\n      if (this.opts.filesList && filename) {\n        const isIncluded = this.opts.filesList.includes(filename);\n\n        if (!isIncluded) {\n          // Force _isIncluded to false to skip processing\n          this._isIncluded = false;\n          return;\n        }\n      }\n    },\n\n    visitor: {\n      /* 0. If this file *is* the dictionaries entry, short-circuit: export {} */\n      Program: {\n        enter(programPath, state) {\n          const filename = state.file.opts.filename!;\n          if (\n            state.opts.replaceDictionaryEntry &&\n            filename === state.opts.dictionariesEntryPath\n          ) {\n            state._isDictEntry = true;\n            // Replace all existing statements with: export default {}\n            programPath.node.body = [\n              t.exportDefaultDeclaration(t.objectExpression([])),\n            ];\n            // Stop further traversal for this plugin – nothing else to transform\n            programPath.stop();\n          }\n        },\n\n        /* 3. After full traversal, inject the JSON dictionary imports. */\n        exit(programPath, state) {\n          if (state._isDictEntry) return; // nothing else to do – already replaced\n          if (!state._hasValidImport) return; // early-out if we touched nothing\n          if (!state._isIncluded) return; // early-out if file is not included\n\n          const file = state.file.opts.filename!;\n          const dictionariesDir = state.opts.dictionariesDir;\n          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;\n          const imports: t.ImportDeclaration[] = [];\n\n          // Generate static imports (for getIntlayer and useIntlayer when not using dynamic)\n          for (const [key, ident] of state._newStaticImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              false // Always static\n            );\n            const importDeclarationNode = t.importDeclaration(\n              [t.importDefaultSpecifier(t.identifier(ident.name))],\n              t.stringLiteral(rel)\n            );\n\n            importDeclarationNode.attributes = [\n              t.importAttribute(t.identifier('type'), t.stringLiteral('json')),\n            ];\n\n            imports.push(importDeclarationNode);\n          }\n\n          // Generate dynamic imports (for useIntlayer when using dynamic helpers)\n          for (const [key, ident] of state._newDynamicImports!) {\n            const rel = computeRelativeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              key,\n              true // Always dynamic\n            );\n            imports.push(\n              t.importDeclaration(\n                [t.importDefaultSpecifier(t.identifier(ident.name))],\n                t.stringLiteral(rel)\n              )\n            );\n          }\n\n          if (!imports.length) return;\n\n          /* Keep \"use client\" / \"use server\" directives at the very top. */\n          const bodyPaths = programPath.get('body') as NodePath<t.Statement>[];\n          let insertPos = 0;\n          for (const stmtPath of bodyPaths) {\n            const stmt = stmtPath.node;\n            if (\n              t.isExpressionStatement(stmt) &&\n              t.isStringLiteral(stmt.expression) &&\n              !stmt.expression.value.startsWith('import') &&\n              !stmt.expression.value.startsWith('require')\n            ) {\n              insertPos += 1;\n            } else {\n              break;\n            }\n          }\n\n          programPath.node.body.splice(insertPos, 0, ...imports);\n        },\n      },\n\n      /* 1. Inspect *every* intlayer import. */\n      ImportDeclaration(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const src = path.node.source.value;\n        if (!PACKAGE_LIST.includes(src)) return;\n\n        // Mark that we do import from an intlayer package in this file; this is\n        // enough to know that we *might* need to inject runtime helpers later.\n        state._hasValidImport = true;\n\n        for (const spec of path.node.specifiers) {\n          if (!t.isImportSpecifier(spec)) continue;\n\n          // ⚠️  We now key off *imported* name, *not* local name.\n          const importedName = t.isIdentifier(spec.imported)\n            ? spec.imported.name\n            : (spec.imported as t.StringLiteral).value;\n\n          const importMode = state.opts.importMode;\n          // Determine whether this import should use the dynamic helpers. We\n          // only switch to the dynamic helpers when (1) the option is turned\n          // on AND (2) the package we are importing from supports the dynamic\n          // helpers.\n          const shouldUseDynamicHelpers =\n            importMode === 'dynamic' &&\n            PACKAGE_LIST_DYNAMIC.includes(src as any);\n\n          // Determine whether this import should use the async helpers. We\n          // only switch to the async helpers when (1) the option is turned\n          // on AND (2) the package we are importing from supports the async\n          // helpers.\n          const shouldUseAsyncHelpers =\n            importMode === 'async' && PACKAGE_LIST_DYNAMIC.includes(src as any);\n\n          // Remember for later (CallExpression) whether we are using the dynamic helpers\n          if (shouldUseDynamicHelpers) {\n            state._useDynamicHelpers = true;\n          }\n\n          // Remember for later (CallExpression) whether we are using the async helpers\n          if (shouldUseAsyncHelpers) {\n            state._useAsyncHelpers = true;\n          }\n\n          let helperMap: Record<string, string>;\n\n          if (shouldUseAsyncHelpers) {\n            // Use async helpers for useIntlayer when async mode is enabled\n            helperMap = {\n              ...STATIC_IMPORT_FUNCTION,\n              ...ASYNC_IMPORT_FUNCTION,\n            } as Record<string, string>;\n          } else if (shouldUseDynamicHelpers) {\n            // Use dynamic helpers for useIntlayer when dynamic mode is enabled\n            helperMap = {\n              ...STATIC_IMPORT_FUNCTION,\n              ...DYNAMIC_IMPORT_FUNCTION,\n            } as Record<string, string>;\n          } else {\n            // Use static helpers by default\n            helperMap = STATIC_IMPORT_FUNCTION as Record<string, string>;\n          }\n\n          const newIdentifier = helperMap[importedName];\n\n          // Only rewrite when we actually have a mapping for the imported\n          // specifier (ignore unrelated named imports).\n          if (newIdentifier) {\n            // Keep the local alias intact (so calls remain `useIntlayer` /\n            // `getIntlayer`), but rewrite the imported identifier so it\n            // points to our helper implementation.\n            spec.imported = t.identifier(newIdentifier);\n          }\n        }\n      },\n\n      /* 2. Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) or useDictionaryDynamic(_hash, \"foo\") */\n      CallExpression(path, state) {\n        if (state._isDictEntry) return; // skip if entry file – already handled\n\n        const callee = path.node.callee;\n        if (!t.isIdentifier(callee)) return;\n        if (!CALLER_LIST.includes(callee.name as any)) return;\n\n        // Ensure we ultimately emit helper imports for files that *invoke*\n        // the hooks, even if they didn't import them directly (edge cases with\n        // re-exports).\n        state._hasValidImport = true;\n\n        const arg = path.node.arguments[0];\n        if (!arg || !t.isStringLiteral(arg)) return; // must be literal\n\n        const key = arg.value;\n        const useDynamic = Boolean(state._useDynamicHelpers);\n        const useAsync = Boolean(state._useAsyncHelpers);\n\n        // Determine if this specific call should use dynamic imports\n        const shouldUseDynamicForThisCall =\n          callee.name === 'useIntlayer' && useDynamic;\n\n        // Determine if this specific call should use async imports\n        const shouldUseAsyncForThisCall =\n          callee.name === 'useIntlayer' && useAsync;\n\n        let ident: t.Identifier;\n\n        if (shouldUseAsyncForThisCall) {\n          // Use dynamic imports for useIntlayer when async helpers are enabled\n          let dynamicIdent = state._newDynamicImports!.get(key);\n          if (!dynamicIdent) {\n            // Create a unique identifier for dynamic imports by appending a suffix\n            const hash = getFileHash(key);\n            dynamicIdent = t.identifier(`_${hash}_dyn`);\n            state._newDynamicImports!.set(key, dynamicIdent);\n          }\n          ident = dynamicIdent;\n\n          // Async helper: first argument is the dictionary promise.\n          path.node.arguments[0] = t.identifier(ident.name);\n\n          // Wrap the call with await for async helpers\n          const awaitExpression = t.awaitExpression(path.node);\n          path.replaceWith(awaitExpression);\n        } else if (shouldUseDynamicForThisCall) {\n          // Use dynamic imports for useIntlayer when dynamic helpers are enabled\n          let dynamicIdent = state._newDynamicImports!.get(key);\n          if (!dynamicIdent) {\n            // Create a unique identifier for dynamic imports by appending a suffix\n            const hash = getFileHash(key);\n            dynamicIdent = t.identifier(`_${hash}_dyn`);\n            state._newDynamicImports!.set(key, dynamicIdent);\n          }\n          ident = dynamicIdent;\n\n          // Dynamic helper: first argument is the dictionary, second is the key.\n          path.node.arguments = [\n            t.identifier(ident.name),\n            ...path.node.arguments,\n          ];\n        } else {\n          // Use static imports for getIntlayer or useIntlayer when not using dynamic helpers\n          let staticIdent = state._newStaticImports!.get(key);\n          if (!staticIdent) {\n            staticIdent = makeIdent(key);\n            state._newStaticImports!.set(key, staticIdent);\n          }\n          ident = staticIdent;\n\n          // Static helper (useDictionary / getDictionary): replace key with ident.\n          path.node.arguments[0] = t.identifier(ident.name);\n        }\n      },\n    },\n  };\n};\n"],"mappings":"AACA,YAAY,OAAO;AACnB,SAAS,mBAAmB;AAC5B,SAAS,SAAS,MAAM,gBAAgB;AAIxC,MAAM,eAAe;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,cAAc,CAAC,eAAe,aAAa;AAKjD,MAAM,uBAAuB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,yBAAyB;AAAA,EAC7B,aAAa;AAAA,EACb,aAAa;AACf;AAEA,MAAM,wBAAwB;AAAA,EAC5B,aAAa;AACf;AAEA,MAAM,0BAA0B;AAAA,EAC9B,aAAa;AACf;AAwDA,MAAM,YAAY,CAAC,QAA8B;AAC/C,QAAM,OAAO,YAAY,GAAG;AAC5B,SAAO,EAAE,WAAW,IAAI,IAAI,EAAE;AAChC;AAEA,MAAM,wBAAwB,CAC5B,UACA,iBACA,wBACA,KACA,YAAY,UACD;AACX,QAAM,WAAW,YACb,KAAK,wBAAwB,GAAG,GAAG,MAAM,IACzC,KAAK,iBAAiB,GAAG,GAAG,OAAO;AAEvC,MAAI,MAAM,SAAS,QAAQ,QAAQ,GAAG,QAAQ,EAAE,QAAQ,OAAO,GAAG;AAClE,MAAI,CAAC,IAAI,WAAW,IAAI,KAAK,CAAC,IAAI,WAAW,KAAK,EAAG,OAAM,KAAK,GAAG;AACnE,SAAO;AACT;AA6DO,MAAM,sBAAsB,MAAwB;AACzD,SAAO;AAAA,IACL,MAAM;AAAA,IAEN,MAAM;AACJ,WAAK,oBAAoB,oBAAI,IAAI;AACjC,WAAK,qBAAqB,oBAAI,IAAI;AAClC,WAAK,cAAc;AACnB,WAAK,kBAAkB;AACvB,WAAK,eAAe;AACpB,WAAK,qBAAqB;AAC1B,WAAK,mBAAmB;AAGxB,YAAM,WAAW,KAAK,KAAK,KAAK;AAChC,UAAI,KAAK,KAAK,aAAa,UAAU;AACnC,cAAM,aAAa,KAAK,KAAK,UAAU,SAAS,QAAQ;AAExD,YAAI,CAAC,YAAY;AAEf,eAAK,cAAc;AACnB;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEA,SAAS;AAAA;AAAA,MAEP,SAAS;AAAA,QACP,MAAM,aAAa,OAAO;AACxB,gBAAM,WAAW,MAAM,KAAK,KAAK;AACjC,cACE,MAAM,KAAK,0BACX,aAAa,MAAM,KAAK,uBACxB;AACA,kBAAM,eAAe;AAErB,wBAAY,KAAK,OAAO;AAAA,cACtB,EAAE,yBAAyB,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAAA,YACnD;AAEA,wBAAY,KAAK;AAAA,UACnB;AAAA,QACF;AAAA;AAAA,QAGA,KAAK,aAAa,OAAO;AACvB,cAAI,MAAM,aAAc;AACxB,cAAI,CAAC,MAAM,gBAAiB;AAC5B,cAAI,CAAC,MAAM,YAAa;AAExB,gBAAM,OAAO,MAAM,KAAK,KAAK;AAC7B,gBAAM,kBAAkB,MAAM,KAAK;AACnC,gBAAM,yBAAyB,MAAM,KAAK;AAC1C,gBAAM,UAAiC,CAAC;AAGxC,qBAAW,CAAC,KAAK,KAAK,KAAK,MAAM,mBAAoB;AACnD,kBAAM,MAAM;AAAA,cACV;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA;AAAA,YACF;AACA,kBAAM,wBAAwB,EAAE;AAAA,cAC9B,CAAC,EAAE,uBAAuB,EAAE,WAAW,MAAM,IAAI,CAAC,CAAC;AAAA,cACnD,EAAE,cAAc,GAAG;AAAA,YACrB;AAEA,kCAAsB,aAAa;AAAA,cACjC,EAAE,gBAAgB,EAAE,WAAW,MAAM,GAAG,EAAE,cAAc,MAAM,CAAC;AAAA,YACjE;AAEA,oBAAQ,KAAK,qBAAqB;AAAA,UACpC;AAGA,qBAAW,CAAC,KAAK,KAAK,KAAK,MAAM,oBAAqB;AACpD,kBAAM,MAAM;AAAA,cACV;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA,cACA;AAAA;AAAA,YACF;AACA,oBAAQ;AAAA,cACN,EAAE;AAAA,gBACA,CAAC,EAAE,uBAAuB,EAAE,WAAW,MAAM,IAAI,CAAC,CAAC;AAAA,gBACnD,EAAE,cAAc,GAAG;AAAA,cACrB;AAAA,YACF;AAAA,UACF;AAEA,cAAI,CAAC,QAAQ,OAAQ;AAGrB,gBAAM,YAAY,YAAY,IAAI,MAAM;AACxC,cAAI,YAAY;AAChB,qBAAW,YAAY,WAAW;AAChC,kBAAM,OAAO,SAAS;AACtB,gBACE,EAAE,sBAAsB,IAAI,KAC5B,EAAE,gBAAgB,KAAK,UAAU,KACjC,CAAC,KAAK,WAAW,MAAM,WAAW,QAAQ,KAC1C,CAAC,KAAK,WAAW,MAAM,WAAW,SAAS,GAC3C;AACA,2BAAa;AAAA,YACf,OAAO;AACL;AAAA,YACF;AAAA,UACF;AAEA,sBAAY,KAAK,KAAK,OAAO,WAAW,GAAG,GAAG,OAAO;AAAA,QACvD;AAAA,MACF;AAAA;AAAA,MAGA,kBAAkB,MAAM,OAAO;AAC7B,YAAI,MAAM,aAAc;AAExB,cAAM,MAAM,KAAK,KAAK,OAAO;AAC7B,YAAI,CAAC,aAAa,SAAS,GAAG,EAAG;AAIjC,cAAM,kBAAkB;AAExB,mBAAW,QAAQ,KAAK,KAAK,YAAY;AACvC,cAAI,CAAC,EAAE,kBAAkB,IAAI,EAAG;AAGhC,gBAAM,eAAe,EAAE,aAAa,KAAK,QAAQ,IAC7C,KAAK,SAAS,OACb,KAAK,SAA6B;AAEvC,gBAAM,aAAa,MAAM,KAAK;AAK9B,gBAAM,0BACJ,eAAe,aACf,qBAAqB,SAAS,GAAU;AAM1C,gBAAM,wBACJ,eAAe,WAAW,qBAAqB,SAAS,GAAU;AAGpE,cAAI,yBAAyB;AAC3B,kBAAM,qBAAqB;AAAA,UAC7B;AAGA,cAAI,uBAAuB;AACzB,kBAAM,mBAAmB;AAAA,UAC3B;AAEA,cAAI;AAEJ,cAAI,uBAAuB;AAEzB,wBAAY;AAAA,cACV,GAAG;AAAA,cACH,GAAG;AAAA,YACL;AAAA,UACF,WAAW,yBAAyB;AAElC,wBAAY;AAAA,cACV,GAAG;AAAA,cACH,GAAG;AAAA,YACL;AAAA,UACF,OAAO;AAEL,wBAAY;AAAA,UACd;AAEA,gBAAM,gBAAgB,UAAU,YAAY;AAI5C,cAAI,eAAe;AAIjB,iBAAK,WAAW,EAAE,WAAW,aAAa;AAAA,UAC5C;AAAA,QACF;AAAA,MACF;AAAA;AAAA,MAGA,eAAe,MAAM,OAAO;AAC1B,YAAI,MAAM,aAAc;AAExB,cAAM,SAAS,KAAK,KAAK;AACzB,YAAI,CAAC,EAAE,aAAa,MAAM,EAAG;AAC7B,YAAI,CAAC,YAAY,SAAS,OAAO,IAAW,EAAG;AAK/C,cAAM,kBAAkB;AAExB,cAAM,MAAM,KAAK,KAAK,UAAU,CAAC;AACjC,YAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,EAAG;AAErC,cAAM,MAAM,IAAI;AAChB,cAAM,aAAa,QAAQ,MAAM,kBAAkB;AACnD,cAAM,WAAW,QAAQ,MAAM,gBAAgB;AAG/C,cAAM,8BACJ,OAAO,SAAS,iBAAiB;AAGnC,cAAM,4BACJ,OAAO,SAAS,iBAAiB;AAEnC,YAAI;AAEJ,YAAI,2BAA2B;AAE7B,cAAI,eAAe,MAAM,mBAAoB,IAAI,GAAG;AACpD,cAAI,CAAC,cAAc;AAEjB,kBAAM,OAAO,YAAY,GAAG;AAC5B,2BAAe,EAAE,WAAW,IAAI,IAAI,MAAM;AAC1C,kBAAM,mBAAoB,IAAI,KAAK,YAAY;AAAA,UACjD;AACA,kBAAQ;AAGR,eAAK,KAAK,UAAU,CAAC,IAAI,EAAE,WAAW,MAAM,IAAI;AAGhD,gBAAM,kBAAkB,EAAE,gBAAgB,KAAK,IAAI;AACnD,eAAK,YAAY,eAAe;AAAA,QAClC,WAAW,6BAA6B;AAEtC,cAAI,eAAe,MAAM,mBAAoB,IAAI,GAAG;AACpD,cAAI,CAAC,cAAc;AAEjB,kBAAM,OAAO,YAAY,GAAG;AAC5B,2BAAe,EAAE,WAAW,IAAI,IAAI,MAAM;AAC1C,kBAAM,mBAAoB,IAAI,KAAK,YAAY;AAAA,UACjD;AACA,kBAAQ;AAGR,eAAK,KAAK,YAAY;AAAA,YACpB,EAAE,WAAW,MAAM,IAAI;AAAA,YACvB,GAAG,KAAK,KAAK;AAAA,UACf;AAAA,QACF,OAAO;AAEL,cAAI,cAAc,MAAM,kBAAmB,IAAI,GAAG;AAClD,cAAI,CAAC,aAAa;AAChB,0BAAc,UAAU,GAAG;AAC3B,kBAAM,kBAAmB,IAAI,KAAK,WAAW;AAAA,UAC/C;AACA,kBAAQ;AAGR,eAAK,KAAK,UAAU,CAAC,IAAI,EAAE,WAAW,MAAM,IAAI;AAAA,QAClD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/types/babel-plugin-intlayer.d.ts

@@ -23,9 +23,9 @@ type State = PluginPass & {
          */
         replaceDictionaryEntry?: boolean;
         /**
-         * If true, the plugin will activate the dynamic import of the dictionaries.
+         * If true, the plugin will activate the dynamic import of the dictionaries. It will rely on Suspense to load the dictionaries.
          */
-        activateDynamicImport?: boolean;
+        importMode?: 'static' | 'dynamic' | 'async';
         /**
          * Files list to traverse.
          */
@@ -41,6 +41,8 @@ type State = PluginPass & {
     _isDictEntry?: boolean;
     /** whether dynamic helpers are active for this file */
     _useDynamicHelpers?: boolean;
+    /** whether async helpers are active for this file */
+    _useAsyncHelpers?: boolean;
 };
 /**
  * Babel plugin that transforms `useIntlayer/getIntlayer` calls into
@@ -72,7 +74,7 @@ type State = PluginPass & {
  * const content2 = useIntlayer(_dicHash)
  * ```
  *
- * Or if the `activateDynamicImport` option is enabled:
+ * If the `importMode = "dynamic"` option:
  *
  * ```ts
  * import _dicHash from '../../.intlayer/dynamic_dictionaries/app.mjs';
@@ -86,6 +88,18 @@ type State = PluginPass & {
  * const content1 = getIntlayer(_dicHash);
  * const content2 = useIntlayer(_dicHash_dyn, 'app');
  * ```
+ *
+ * Or if the `importMode = "async"` option:
+ *
+ * ```ts
+ * import _dicHash from '../../.intlayer/dictionaries/app.mjs';
+ * import { useDictionaryAsync as useIntlayer } from 'react-intlayer';
+ *
+ * // ...
+ *
+ * const content1 = getIntlayer(_dicHash);
+ * const content2 = await useIntlayer(_dicHash_dyn);
+ * ```
  */
 export declare const intlayerBabelPlugin: () => PluginObj<State>;
 export {};

package/dist/types/babel-plugin-intlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer.d.ts","sourceRoot":"","sources":["../../src/babel-plugin-intlayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAgDlC,KAAK,KAAK,GAAG,UAAU,GAAG;IACxB,IAAI,EAAE;QACJ;;WAEG;QACH,eAAe,EAAE,MAAM,CAAC;QACxB;;WAEG;QACH,qBAAqB,EAAE,MAAM,CAAC;QAC9B;;WAEG;QACH,sBAAsB,EAAE,MAAM,CAAC;QAC/B;;WAEG;QACH,4BAA4B,EAAE,MAAM,CAAC;QACrC;;WAEG;QACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC;;WAEG;QACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/C,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAgCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,mBAAmB,QAAO,SAAS,CAAC,KAAK,CAgOrD,CAAC"}
+{"version":3,"file":"babel-plugin-intlayer.d.ts","sourceRoot":"","sources":["../../src/babel-plugin-intlayer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,CAAC,MAAM,cAAc,CAAC;AAwDlC,KAAK,KAAK,GAAG,UAAU,GAAG;IACxB,IAAI,EAAE;QACJ;;WAEG;QACH,eAAe,EAAE,MAAM,CAAC;QACxB;;WAEG;QACH,qBAAqB,EAAE,MAAM,CAAC;QAC9B;;WAEG;QACH,sBAAsB,EAAE,MAAM,CAAC;QAC/B;;WAEG;QACH,4BAA4B,EAAE,MAAM,CAAC;QACrC;;WAEG;QACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC;;WAEG;QACH,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;QAC5C;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC9C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/C,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAgCF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,mBAAmB,QAAO,SAAS,CAAC,KAAK,CAgRrD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/babel",
-  "version": "5.5.11",
+  "version": "5.7.0",
   "private": false,
   "description": "A Babel plugin for Intlayer that transforms declaration files and provides internationalization features during the build process according to the Intlayer configuration.",
   "keywords": [
@@ -62,8 +62,8 @@
     "@babel/generator": "^7.27.5",
     "@babel/parser": "^7.27.5",
     "@babel/traverse": "^7.27.4",
-    "@intlayer/config": "5.5.11",
-    "@intlayer/chokidar": "5.5.11"
+    "@intlayer/config": "5.7.0",
+    "@intlayer/chokidar": "5.7.0"
   },
   "devDependencies": {
     "@babel/types": "^7.27.6",
@@ -83,14 +83,14 @@
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.2",
-    "@utils/ts-config": "1.0.4",
     "@utils/eslint-config": "1.0.4",
-    "@utils/tsup-config": "1.0.4",
-    "@utils/ts-config-types": "1.0.4"
+    "@utils/ts-config": "1.0.4",
+    "@utils/ts-config-types": "1.0.4",
+    "@utils/tsup-config": "1.0.4"
   },
   "peerDependencies": {
-    "@intlayer/chokidar": "5.5.11",
-    "@intlayer/config": "5.5.11"
+    "@intlayer/chokidar": "5.7.0",
+    "@intlayer/config": "5.7.0"
   },
   "engines": {
     "node": ">=14.18"