@intlayer/babel 5.5.3 → 5.5.4

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

@@ -50,12 +50,27 @@ const PACKAGE_LIST = [
   "solid-intlayer"
 ];
 const CALLER_LIST = ["useIntlayer", "getIntlayer"];
+const PACKAGE_LIST_DYNAMIC = [
+  "react-intlayer",
+  "react-intlayer/client",
+  "react-intlayer/server",
+  "next-intlayer",
+  "next-intlayer/client",
+  "next-intlayer/server"
+];
+const STATIC_IMPORT_FUNCTION = {
+  getIntlayer: "getDictionary",
+  useIntlayer: "useDictionary"
+};
+const DYNAMIC_IMPORT_FUNCTION = {
+  useIntlayer: "useDictionaryDynamic"
+};
 const makeIdent = (key) => {
   const hash = (0, import_chokidar.getFileHash)(key);
   return t.identifier(`_${hash}`);
 };
-const computeRelativeImport = (fromFile, dictDir, key) => {
-  const jsonPath = (0, import_node_path.join)(dictDir, `${key}.json`);
+const computeRelativeImport = (fromFile, dictionariesDir, dynamicDictionariesDir, key, isDynamic = false) => {
+  const jsonPath = isDynamic ? (0, import_node_path.join)(dynamicDictionariesDir, `${key}.mjs`) : (0, import_node_path.join)(dictionariesDir, `${key}.json`);
   let rel = (0, import_node_path.relative)((0, import_node_path.dirname)(fromFile), jsonPath).replace(/\\/g, "/");
   if (!rel.startsWith("./") && !rel.startsWith("../")) rel = `./${rel}`;
   return rel;
@@ -64,9 +79,20 @@ const intlayerBabelPlugin = () => {
   return {
     name: "babel-plugin-intlayer-transform",
     pre() {
-      this._newImports = /* @__PURE__ */ new Map();
+      this._newStaticImports = /* @__PURE__ */ new Map();
+      this._newDynamicImports = /* @__PURE__ */ new Map();
+      this._isIncluded = true;
       this._hasValidImport = false;
       this._isDictEntry = false;
+      this._useDynamicHelpers = false;
+      const filename = this.file.opts.filename;
+      if (this.opts.filesList && filename) {
+        const isIncluded = this.opts.filesList.includes(filename);
+        if (!isIncluded) {
+          this._isIncluded = false;
+          return;
+        }
+      }
     },
     visitor: {
       /* 0. If this file *is* the dictionaries entry, short-circuit: export {} */
@@ -85,11 +111,36 @@ const intlayerBabelPlugin = () => {
         exit(programPath, state) {
           if (state._isDictEntry) return;
           if (!state._hasValidImport) return;
+          if (!state._isIncluded) return;
           const file = state.file.opts.filename;
-          const dictDir = state.opts.dictionariesDir;
+          const dictionariesDir = state.opts.dictionariesDir;
+          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;
           const imports = [];
-          for (const [key, ident] of state._newImports) {
-            const rel = computeRelativeImport(file, dictDir, key);
+          for (const [key, ident] of state._newStaticImports) {
+            const rel = computeRelativeImport(
+              file,
+              dictionariesDir,
+              dynamicDictionariesDir,
+              key,
+              false
+              // Always static
+            );
+            imports.push(
+              t.importDeclaration(
+                [t.importDefaultSpecifier(t.identifier(ident.name))],
+                t.stringLiteral(rel)
+              )
+            );
+          }
+          for (const [key, ident] of state._newDynamicImports) {
+            const rel = computeRelativeImport(
+              file,
+              dictionariesDir,
+              dynamicDictionariesDir,
+              key,
+              true
+              // Always dynamic
+            );
             imports.push(
               t.importDeclaration(
                 [t.importDefaultSpecifier(t.identifier(ident.name))],
@@ -102,7 +153,7 @@ const intlayerBabelPlugin = () => {
           let insertPos = 0;
           for (const stmtPath of bodyPaths) {
             const stmt = stmtPath.node;
-            if (t.isExpressionStatement(stmt) && t.isStringLiteral(stmt.expression) && (stmt.expression.value === "use client" || stmt.expression.value === "use server")) {
+            if (t.isExpressionStatement(stmt) && t.isStringLiteral(stmt.expression) && !stmt.expression.value.startsWith("import") && !stmt.expression.value.startsWith("require")) {
               insertPos += 1;
             } else {
               break;
@@ -120,14 +171,22 @@ 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;
-          if (importedName === "useIntlayer") {
-            spec.imported = t.identifier("useDictionary");
-          } else if (importedName === "getIntlayer") {
-            spec.imported = t.identifier("getDictionary");
+          const activateDynamicImport = state.opts.activateDynamicImport;
+          const shouldUseDynamicHelpers = activateDynamicImport && PACKAGE_LIST_DYNAMIC.includes(src);
+          if (shouldUseDynamicHelpers) {
+            state._useDynamicHelpers = true;
+          }
+          const helperMap = shouldUseDynamicHelpers ? {
+            ...STATIC_IMPORT_FUNCTION,
+            ...DYNAMIC_IMPORT_FUNCTION
+          } : STATIC_IMPORT_FUNCTION;
+          const newIdentifier = helperMap[importedName];
+          if (newIdentifier) {
+            spec.imported = t.identifier(newIdentifier);
           }
         }
       },
-      /* 2. Replace calls: useIntlayer("foo") → useDictionary(_hash) */
+      /* 2. Replace calls: useIntlayer("foo") → useDictionary(_hash) or useDictionaryDynamic(_hash, "foo") */
       CallExpression(path, state) {
         if (state._isDictEntry) return;
         const callee = path.node.callee;
@@ -137,12 +196,30 @@ const intlayerBabelPlugin = () => {
         const arg = path.node.arguments[0];
         if (!arg || !t.isStringLiteral(arg)) return;
         const key = arg.value;
-        let ident = state._newImports.get(key);
-        if (!ident) {
-          ident = makeIdent(key);
-          state._newImports.set(key, ident);
+        const useDynamic = Boolean(state._useDynamicHelpers);
+        const shouldUseDynamicForThisCall = callee.name === "useIntlayer" && useDynamic;
+        let ident;
+        if (shouldUseDynamicForThisCall) {
+          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 = [
+            t.identifier(ident.name),
+            ...path.node.arguments
+          ];
+        } else {
+          let staticIdent = state._newStaticImports.get(key);
+          if (!staticIdent) {
+            staticIdent = makeIdent(key);
+            state._newStaticImports.set(key, staticIdent);
+          }
+          ident = staticIdent;
+          path.node.arguments[0] = t.identifier(ident.name);
         }
-        path.node.arguments[0] = t.identifier(ident.name);
       }
     }
   };

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/* ────────────────────────────────────────── types ───────────────────────── */\n\ntype State = PluginPass & {\n  opts: { dictionariesDir: string; dictionariesEntryPath: string };\n  /** map key → generated ident (per-file) */\n  _newImports?: 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};\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  dictDir: string,\n  key: string\n): string => {\n  const jsonPath = join(dictDir, `${key}.json`);\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 * **New behaviour**: if the currently processed file matches `dictionariesEntryPath`,\n * its entire contents are replaced with a simple `export default {}` so that it\n * never contains stale or circular references.\n *\n * The **critical detail** (bug-fix) is that we still **only rewrite** an import\n * specifier when its *imported* name is `useIntlayer`/`getIntlayer`.\n *\n * This means cases like:\n * ```ts\n * import { useDictionary as useIntlayer } from 'react-intlayer';\n * ```\n * —where `useIntlayer` is merely an *alias* or re-export—are left untouched\n * because `imported.name` is `useDictionary`.\n */\nexport const intlayerBabelPlugin = (): PluginObj<State> => {\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newImports = new Map();\n      this._hasValidImport = false;\n      this._isDictEntry = false;\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 (filename === state.opts.dictionariesEntryPath) {\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\n          const file = state.file.opts.filename!;\n          const dictDir = state.opts.dictionariesDir;\n          const imports: t.ImportDeclaration[] = [];\n\n          for (const [key, ident] of state._newImports!) {\n            const rel = computeRelativeImport(file, dictDir, key);\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 === 'use client' ||\n                stmt.expression.value === 'use server')\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          if (importedName === 'useIntlayer') {\n            spec.imported = t.identifier('useDictionary');\n          } else if (importedName === 'getIntlayer') {\n            spec.imported = t.identifier('getDictionary');\n          }\n        }\n      },\n\n      /* 2. Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) */\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        // per-file cache\n        let ident = state._newImports!.get(key);\n        if (!ident) {\n          ident = makeIdent(key);\n          state._newImports!.set(key, ident);\n        }\n\n        // replace first arg with ident\n        path.node.arguments[0] = t.identifier(ident.name);\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] 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 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 (filename === state.opts.dictionariesEntryPath) {\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            imports.push(\n              t.importDeclaration(\n                [t.importDefaultSpecifier(t.identifier(ident.name))],\n                t.stringLiteral(rel)\n              )\n            );\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":[]}

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

@@ -17,12 +17,27 @@ const PACKAGE_LIST = [
   "solid-intlayer"
 ];
 const CALLER_LIST = ["useIntlayer", "getIntlayer"];
+const PACKAGE_LIST_DYNAMIC = [
+  "react-intlayer",
+  "react-intlayer/client",
+  "react-intlayer/server",
+  "next-intlayer",
+  "next-intlayer/client",
+  "next-intlayer/server"
+];
+const STATIC_IMPORT_FUNCTION = {
+  getIntlayer: "getDictionary",
+  useIntlayer: "useDictionary"
+};
+const DYNAMIC_IMPORT_FUNCTION = {
+  useIntlayer: "useDictionaryDynamic"
+};
 const makeIdent = (key) => {
   const hash = getFileHash(key);
   return t.identifier(`_${hash}`);
 };
-const computeRelativeImport = (fromFile, dictDir, key) => {
-  const jsonPath = join(dictDir, `${key}.json`);
+const computeRelativeImport = (fromFile, dictionariesDir, dynamicDictionariesDir, key, isDynamic = false) => {
+  const jsonPath = isDynamic ? join(dynamicDictionariesDir, `${key}.mjs`) : join(dictionariesDir, `${key}.json`);
   let rel = relative(dirname(fromFile), jsonPath).replace(/\\/g, "/");
   if (!rel.startsWith("./") && !rel.startsWith("../")) rel = `./${rel}`;
   return rel;
@@ -31,9 +46,20 @@ const intlayerBabelPlugin = () => {
   return {
     name: "babel-plugin-intlayer-transform",
     pre() {
-      this._newImports = /* @__PURE__ */ new Map();
+      this._newStaticImports = /* @__PURE__ */ new Map();
+      this._newDynamicImports = /* @__PURE__ */ new Map();
+      this._isIncluded = true;
       this._hasValidImport = false;
       this._isDictEntry = false;
+      this._useDynamicHelpers = false;
+      const filename = this.file.opts.filename;
+      if (this.opts.filesList && filename) {
+        const isIncluded = this.opts.filesList.includes(filename);
+        if (!isIncluded) {
+          this._isIncluded = false;
+          return;
+        }
+      }
     },
     visitor: {
       /* 0. If this file *is* the dictionaries entry, short-circuit: export {} */
@@ -52,11 +78,36 @@ const intlayerBabelPlugin = () => {
         exit(programPath, state) {
           if (state._isDictEntry) return;
           if (!state._hasValidImport) return;
+          if (!state._isIncluded) return;
           const file = state.file.opts.filename;
-          const dictDir = state.opts.dictionariesDir;
+          const dictionariesDir = state.opts.dictionariesDir;
+          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;
           const imports = [];
-          for (const [key, ident] of state._newImports) {
-            const rel = computeRelativeImport(file, dictDir, key);
+          for (const [key, ident] of state._newStaticImports) {
+            const rel = computeRelativeImport(
+              file,
+              dictionariesDir,
+              dynamicDictionariesDir,
+              key,
+              false
+              // Always static
+            );
+            imports.push(
+              t.importDeclaration(
+                [t.importDefaultSpecifier(t.identifier(ident.name))],
+                t.stringLiteral(rel)
+              )
+            );
+          }
+          for (const [key, ident] of state._newDynamicImports) {
+            const rel = computeRelativeImport(
+              file,
+              dictionariesDir,
+              dynamicDictionariesDir,
+              key,
+              true
+              // Always dynamic
+            );
             imports.push(
               t.importDeclaration(
                 [t.importDefaultSpecifier(t.identifier(ident.name))],
@@ -69,7 +120,7 @@ const intlayerBabelPlugin = () => {
           let insertPos = 0;
           for (const stmtPath of bodyPaths) {
             const stmt = stmtPath.node;
-            if (t.isExpressionStatement(stmt) && t.isStringLiteral(stmt.expression) && (stmt.expression.value === "use client" || stmt.expression.value === "use server")) {
+            if (t.isExpressionStatement(stmt) && t.isStringLiteral(stmt.expression) && !stmt.expression.value.startsWith("import") && !stmt.expression.value.startsWith("require")) {
               insertPos += 1;
             } else {
               break;
@@ -87,14 +138,22 @@ 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;
-          if (importedName === "useIntlayer") {
-            spec.imported = t.identifier("useDictionary");
-          } else if (importedName === "getIntlayer") {
-            spec.imported = t.identifier("getDictionary");
+          const activateDynamicImport = state.opts.activateDynamicImport;
+          const shouldUseDynamicHelpers = activateDynamicImport && PACKAGE_LIST_DYNAMIC.includes(src);
+          if (shouldUseDynamicHelpers) {
+            state._useDynamicHelpers = true;
+          }
+          const helperMap = shouldUseDynamicHelpers ? {
+            ...STATIC_IMPORT_FUNCTION,
+            ...DYNAMIC_IMPORT_FUNCTION
+          } : STATIC_IMPORT_FUNCTION;
+          const newIdentifier = helperMap[importedName];
+          if (newIdentifier) {
+            spec.imported = t.identifier(newIdentifier);
           }
         }
       },
-      /* 2. Replace calls: useIntlayer("foo") → useDictionary(_hash) */
+      /* 2. Replace calls: useIntlayer("foo") → useDictionary(_hash) or useDictionaryDynamic(_hash, "foo") */
       CallExpression(path, state) {
         if (state._isDictEntry) return;
         const callee = path.node.callee;
@@ -104,12 +163,30 @@ const intlayerBabelPlugin = () => {
         const arg = path.node.arguments[0];
         if (!arg || !t.isStringLiteral(arg)) return;
         const key = arg.value;
-        let ident = state._newImports.get(key);
-        if (!ident) {
-          ident = makeIdent(key);
-          state._newImports.set(key, ident);
+        const useDynamic = Boolean(state._useDynamicHelpers);
+        const shouldUseDynamicForThisCall = callee.name === "useIntlayer" && useDynamic;
+        let ident;
+        if (shouldUseDynamicForThisCall) {
+          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 = [
+            t.identifier(ident.name),
+            ...path.node.arguments
+          ];
+        } else {
+          let staticIdent = state._newStaticImports.get(key);
+          if (!staticIdent) {
+            staticIdent = makeIdent(key);
+            state._newStaticImports.set(key, staticIdent);
+          }
+          ident = staticIdent;
+          path.node.arguments[0] = t.identifier(ident.name);
         }
-        path.node.arguments[0] = t.identifier(ident.name);
       }
     }
   };

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/* ────────────────────────────────────────── types ───────────────────────── */\n\ntype State = PluginPass & {\n  opts: { dictionariesDir: string; dictionariesEntryPath: string };\n  /** map key → generated ident (per-file) */\n  _newImports?: 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};\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  dictDir: string,\n  key: string\n): string => {\n  const jsonPath = join(dictDir, `${key}.json`);\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 * **New behaviour**: if the currently processed file matches `dictionariesEntryPath`,\n * its entire contents are replaced with a simple `export default {}` so that it\n * never contains stale or circular references.\n *\n * The **critical detail** (bug-fix) is that we still **only rewrite** an import\n * specifier when its *imported* name is `useIntlayer`/`getIntlayer`.\n *\n * This means cases like:\n * ```ts\n * import { useDictionary as useIntlayer } from 'react-intlayer';\n * ```\n * —where `useIntlayer` is merely an *alias* or re-export—are left untouched\n * because `imported.name` is `useDictionary`.\n */\nexport const intlayerBabelPlugin = (): PluginObj<State> => {\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newImports = new Map();\n      this._hasValidImport = false;\n      this._isDictEntry = false;\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 (filename === state.opts.dictionariesEntryPath) {\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\n          const file = state.file.opts.filename!;\n          const dictDir = state.opts.dictionariesDir;\n          const imports: t.ImportDeclaration[] = [];\n\n          for (const [key, ident] of state._newImports!) {\n            const rel = computeRelativeImport(file, dictDir, key);\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 === 'use client' ||\n                stmt.expression.value === 'use server')\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          if (importedName === 'useIntlayer') {\n            spec.imported = t.identifier('useDictionary');\n          } else if (importedName === 'getIntlayer') {\n            spec.imported = t.identifier('getDictionary');\n          }\n        }\n      },\n\n      /* 2. Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) */\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        // per-file cache\n        let ident = state._newImports!.get(key);\n        if (!ident) {\n          ident = makeIdent(key);\n          state._newImports!.set(key, ident);\n        }\n\n        // replace first arg with ident\n        path.node.arguments[0] = t.identifier(ident.name);\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] 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 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 (filename === state.opts.dictionariesEntryPath) {\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            imports.push(\n              t.importDeclaration(\n                [t.importDefaultSpecifier(t.identifier(ident.name))],\n                t.stringLiteral(rel)\n              )\n            );\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":"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;AACF;AAEA,MAAM,yBAAyB;AAAA,EAC7B,aAAa;AAAA,EACb,aAAa;AACf;AAEA,MAAM,0BAA0B;AAAA,EAC9B,aAAa;AACf;AAkDA,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;AAiDO,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;AAG1B,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,cAAI,aAAa,MAAM,KAAK,uBAAuB;AACjD,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,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;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,wBAAwB,MAAM,KAAK;AAKzC,gBAAM,0BACJ,yBAAyB,qBAAqB,SAAS,GAAU;AAGnE,cAAI,yBAAyB;AAC3B,kBAAM,qBAAqB;AAAA,UAC7B;AAEA,gBAAM,YAAY,0BACb;AAAA,YACC,GAAG;AAAA,YACH,GAAG;AAAA,UACL,IACC;AAEL,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;AAGnD,cAAM,8BACJ,OAAO,SAAS,iBAAiB;AAEnC,YAAI;AAEJ,YAAI,6BAA6B;AAE/B,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

@@ -2,33 +2,86 @@ import type { PluginObj, PluginPass } from '@babel/core';
 import * as t from '@babel/types';
 type State = PluginPass & {
     opts: {
+        /**
+         * The path to the dictionaries directory.
+         */
         dictionariesDir: string;
+        /**
+         * The path to the dictionaries entry file.
+         */
         dictionariesEntryPath: string;
+        /**
+         * The path to the dictionaries directory.
+         */
+        dynamicDictionariesDir: string;
+        /**
+         * The path to the dynamic dictionaries entry file.
+         */
+        dynamicDictionariesEntryPath: string;
+        /**
+         * If true, the plugin will activate the dynamic import of the dictionaries.
+         */
+        activateDynamicImport?: boolean;
+        /**
+         * Files list to traverse.
+         */
+        filesList?: string[];
     };
-    /** map key → generated ident (per-file) */
-    _newImports?: Map<string, t.Identifier>;
+    /** map key → generated ident (per-file) for static imports */
+    _newStaticImports?: Map<string, t.Identifier>;
+    /** map key → generated ident (per-file) for dynamic imports */
+    _newDynamicImports?: Map<string, t.Identifier>;
     /** whether the current file imported *any* intlayer package */
     _hasValidImport?: boolean;
     /** whether the current file *is* the dictionaries entry file */
     _isDictEntry?: boolean;
+    /** whether dynamic helpers are active for this file */
+    _useDynamicHelpers?: boolean;
 };
 /**
  * Babel plugin that transforms `useIntlayer/getIntlayer` calls into
  * `useDictionary/getDictionary` and auto-imports the required JSON dictionaries.
  *
- * **New behaviour**: if the currently processed file matches `dictionariesEntryPath`,
- * its entire contents are replaced with a simple `export default {}` so that it
- * never contains stale or circular references.
- *
- * The **critical detail** (bug-fix) is that we still **only rewrite** an import
- * specifier when its *imported* name is `useIntlayer`/`getIntlayer`.
  *
  * This means cases like:
+ *
  * ```ts
- * import { useDictionary as useIntlayer } from 'react-intlayer';
+ * import { getIntlayer } from 'intlayer';
+ * import { useIntlayer } from 'react-intlayer';
+ *
+ * // ...
+ *
+ * const content1 = getIntlayer('app');
+ * const content2 = useIntlayer('app');
+ * ```
+ *
+ * will be transformed into:
+ *
+ * ```ts
+ * import _dicHash from '../../.intlayer/dictionaries/app.mjs';
+ * import { getDictionary as getIntlayer } from 'intlayer';
+ * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';
+ *
+ * // ...
+ *
+ * const content1 = getIntlayer(_dicHash);
+ * const content2 = useIntlayer(_dicHash)
+ * ```
+ *
+ * Or if the `activateDynamicImport` option is enabled:
+ *
+ * ```ts
+ * import _dicHash from '../../.intlayer/dynamic_dictionaries/app.mjs';
+ * import _dicHash_dyn from '../../.intlayer/dictionaries/app.mjs';
+ *
+ * import { useDictionary as getIntlayer } from 'intlayer';
+ * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';
+ *
+ * // ...
+ *
+ * const content1 = getIntlayer(_dicHash);
+ * const content2 = useIntlayer(_dicHash_dyn, 'app');
  * ```
- * —where `useIntlayer` is merely an *alias* or re-export—are left untouched
- * because `imported.name` is `useDictionary`.
  */
 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;AA0BlC,KAAK,KAAK,GAAG,UAAU,GAAG;IACxB,IAAI,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,2CAA2C;IAC3C,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACxC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AA2BF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,QAAO,SAAS,CAAC,KAAK,CA4HrD,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;AA+ClC,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,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,CAyNrD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/babel",
-  "version": "5.5.3",
+  "version": "5.5.4",
   "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.1",
     "@babel/parser": "^7.27.2",
     "@babel/traverse": "^7.27.1",
-    "@intlayer/chokidar": "5.5.3",
-    "@intlayer/config": "5.5.3"
+    "@intlayer/chokidar": "5.5.4",
+    "@intlayer/config": "5.5.4"
   },
   "devDependencies": {
     "@babel/types": "^7.27.1",
@@ -82,14 +82,14 @@
     "tsc-alias": "^1.8.11",
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
-    "@utils/ts-config-types": "1.0.4",
-    "@utils/tsup-config": "1.0.4",
+    "@utils/eslint-config": "1.0.4",
     "@utils/ts-config": "1.0.4",
-    "@utils/eslint-config": "1.0.4"
+    "@utils/ts-config-types": "1.0.4",
+    "@utils/tsup-config": "1.0.4"
   },
   "peerDependencies": {
-    "@intlayer/chokidar": "5.5.3",
-    "@intlayer/config": "5.5.3"
+    "@intlayer/config": "5.5.4",
+    "@intlayer/chokidar": "5.5.4"
   },
   "engines": {
     "node": ">=14.18"