@intlayer/babel 8.12.4 → 9.0.0-canary.0

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

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer-optimize.mjs","names":[],"sources":["../../src/babel-plugin-intlayer-optimize.ts"],"sourcesContent":["import { dirname, join, relative } from 'node:path';\nimport type { NodePath, PluginObj, PluginPass } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport { getPathHash } from '@intlayer/chokidar/utils';\nimport { normalizePath } from '@intlayer/config/utils';\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  'lit-intlayer',\n  'vanilla-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  'lit-intlayer',\n  'vanilla-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\ntype CallerName = (typeof CALLER_LIST)[number];\ntype ImportMode = 'static' | 'dynamic' | 'fetch';\n\n/**\n * Packages whose SSR dynamic helper should render synchronously with a static\n * dictionary. Solid streaming SSR can hydrate static output reliably, while\n * its dynamic resource path either suspends during hydration or serializes the\n * full dictionary into HTML.\n */\nconst PACKAGE_SSR_DYNAMIC_STATIC_FALLBACK = new Set<string>(['solid-intlayer']);\n\n/**\n * Options for the optimization Babel plugin\n */\nexport type OptimizePluginOptions = {\n  /**\n   * If false, the plugin will not apply any transformation.\n   */\n  optimize?: boolean;\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 unmerged dictionaries entry file.\n   */\n  unmergedDictionariesEntryPath: string;\n  /**\n   * The path to the unmerged dictionaries directory.\n   */\n  unmergedDictionariesDir: 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   * The path to the fetch dictionaries directory.\n   */\n  fetchDictionariesDir: string;\n  /**\n   * The path to the fetch dictionaries entry file.\n   */\n  fetchDictionariesEntryPath: 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' | 'fetch' | undefined;\n  /**\n   * Map of dictionary keys to their specific import mode.\n   */\n  dictionaryModeMap?: Record<\n    string,\n    'static' | 'dynamic' | 'fetch' | undefined\n  >;\n  /**\n   * Files list to traverse.\n   */\n  filesList: string[];\n  /**\n   * Whether the current transform is for an SSR bundle.\n   */\n  isServer?: boolean;\n};\n\ntype State = PluginPass & {\n  opts: OptimizePluginOptions;\n  /** map key → generated ident (per-file) for static imports */\n  _newStaticImports?: Map<string, BabelTypes.Identifier>;\n  /** map key → generated ident (per-file) for dynamic imports */\n  _newDynamicImports?: Map<string, BabelTypes.Identifier>;\n  /** whether the current file imported *any* intlayer package */\n  _hasValidImport?: boolean;\n  /** map from local identifier name to the imported intlayer func name ('useIntlayer' | 'getIntlayer') */\n  _callerMap?: Map<string, (typeof CALLER_LIST)[number]>;\n  /** map from local identifier name to the intlayer package it was imported from */\n  _callerPackageMap?: Map<string, string>;\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 the current file is included in the filesList */\n  _isIncluded?: boolean;\n};\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 = (\n  key: string,\n  t: typeof BabelTypes\n): BabelTypes.Identifier => {\n  const hash = getPathHash(key);\n  return t.identifier(`_${hash}`);\n};\n\nconst computeImport = (\n  fromFile: string,\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  fetchDictionariesDir: string,\n  key: string,\n  importMode: 'static' | 'dynamic' | 'fetch'\n): string => {\n  let relativePath = join(dictionariesDir, `${key}.json`);\n\n  if (importMode === 'fetch') {\n    relativePath = join(fetchDictionariesDir, `${key}.mjs`);\n  }\n\n  if (importMode === 'dynamic') {\n    relativePath = join(dynamicDictionariesDir, `${key}.mjs`);\n  }\n\n  let rel = relative(dirname(fromFile), relativePath);\n\n  // Fix windows path\n  rel = normalizePath(rel);\n\n  // Fix relative path\n  if (!rel.startsWith('./') && !rel.startsWith('../')) {\n    rel = `./${rel}`;\n  }\n\n  return rel;\n};\n\nconst getKeyFromArgument = (\n  arg: BabelTypes.Node | null | undefined,\n  t: typeof BabelTypes\n): string | undefined => {\n  if (arg && t.isStringLiteral(arg)) {\n    return arg.value;\n  }\n\n  if (\n    arg &&\n    t.isTemplateLiteral(arg) &&\n    arg.expressions.length === 0 &&\n    arg.quasis.length === 1\n  ) {\n    return arg.quasis[0]?.value.cooked ?? arg.quasis[0]?.value.raw;\n  }\n\n  return undefined;\n};\n\nconst isCallerName = (name: string): name is CallerName =>\n  CALLER_LIST.includes(name as CallerName);\n\nconst isDynamicPackage = (\n  packageName: string\n): packageName is (typeof PACKAGE_LIST_DYNAMIC)[number] =>\n  PACKAGE_LIST_DYNAMIC.includes(\n    packageName as (typeof PACKAGE_LIST_DYNAMIC)[number]\n  );\n\nconst shouldUseStaticSsrDynamicFallback = (\n  callerPackage: string | undefined,\n  importMode: ImportMode | undefined,\n  opts: OptimizePluginOptions\n): boolean =>\n  opts.isServer === true &&\n  importMode === 'dynamic' &&\n  callerPackage !== undefined &&\n  PACKAGE_SSR_DYNAMIC_STATIC_FALLBACK.has(callerPackage);\n\n/**\n * Babel plugin that transforms Intlayer function calls and auto-imports dictionaries.\n *\n * This plugin transforms calls to `useIntlayer()` and `getIntlayer()` from various Intlayer\n * packages into optimized dictionary access patterns, automatically importing the required\n * dictionary files based on the configured import mode.\n *\n * ## Supported Input Patterns\n *\n * The plugin recognizes these function calls:\n *\n * ```ts\n * // useIntlayer\n * import { useIntlayer } from 'react-intlayer';\n * import { useIntlayer } from 'next-intlayer';\n *\n * // getIntlayer\n * import { getIntlayer } from 'intlayer';\n *\n * // Usage\n * const content = useIntlayer('app');\n * const content = getIntlayer('app');\n * ```\n *\n * ## Transformation Modes\n *\n * ### Static Mode (default: `importMode = \"static\"`)\n *\n * Imports JSON dictionaries directly and replaces function calls with dictionary access:\n *\n * **Output:**\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import { useDictionary as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash);\n * const content2 = getIntlayer(_dicHash);\n * ```\n *\n * ### Dynamic Mode (`importMode = \"dynamic\"`)\n *\n * Uses dynamic dictionary loading with Suspense support:\n *\n * **Output:**\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import _dicHash_dyn from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash_dyn, 'app');\n * const content2 = getIntlayer(_dicHash);\n * ```\n *\n * ### Fetch Mode (`importMode = \"fetch\"`)\n *\n * Uses fetch-based dictionary loading for remote dictionaries:\n *\n * **Output if `dictionaryModeMap` includes the key with \"fetch\" value:**\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import _dicHash_fetch from '../../.intlayer/fetch_dictionaries/app.mjs';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash_fetch, \"app\");\n * const content2 = getIntlayer(_dicHash);\n * ```\n *\n * > If `dictionaryModeMap` does not include the key with \"fetch\" value, the plugin will fallback to the dynamic import mode.\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import _dicHash_dyn from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash_dyn, 'app');\n * const content2 = getIntlayer(_dicHash);\n * ```\n */\nexport const intlayerOptimizeBabelPlugin = (babel: {\n  types: typeof BabelTypes;\n}): PluginObj<State> => {\n  const { types: t } = babel;\n\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newStaticImports = new Map();\n      this._newDynamicImports = new Map();\n      this._callerMap = new Map();\n      this._callerPackageMap = new Map();\n      this._isIncluded = true;\n      this._hasValidImport = false;\n      this._isDictEntry = false;\n      this._useDynamicHelpers = false;\n\n      // If optimize is false, skip processing entirely\n      if (this.opts.optimize === false) {\n        this._isIncluded = false;\n        return;\n      }\n\n      // If filesList is provided, check if current file is included\n      const filename = this.file.opts.filename\n        ? normalizePath(this.file.opts.filename)\n        : undefined;\n      if (this.opts.filesList && filename) {\n        const filesList = this.opts.filesList.map(normalizePath);\n        const isIncluded = 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      /* If this file *is* the dictionaries entry, short-circuit: export {} */\n      Program: {\n        enter(programPath, state) {\n          // Safe access to filename\n          const filename = state.file.opts.filename\n            ? normalizePath(state.file.opts.filename)\n            : undefined;\n          const dictionariesEntryPath = state.opts.dictionariesEntryPath\n            ? normalizePath(state.opts.dictionariesEntryPath)\n            : undefined;\n\n          // Check if this is the correct file to transform\n\n          if (\n            state.opts.replaceDictionaryEntry &&\n            filename === dictionariesEntryPath\n          ) {\n            state._isDictEntry = true;\n\n            // Traverse the program to surgically remove/edit specific parts\n            programPath.traverse({\n              // Remove all import statements (cleaning up 'sssss.json')\n              ImportDeclaration(path) {\n                path.remove();\n              },\n\n              // Find the variable definition and empty the object\n              VariableDeclarator(path) {\n                // We look for: const x = { ... }\n\n                if (t.isObjectExpression(path.node.init)) {\n                  // Set the object properties to an empty array: {}\n                  path.node.init.properties = [];\n                }\n              },\n            });\n\n            // (Optional) Stop other plugins from processing this file further if needed\n            // programPath.stop();\n          }\n        },\n\n        /**\n         * After full traversal, process imports and call expressions, then inject the JSON dictionary imports.\n         *\n         * We do the transformation in Program.exit (via a manual traverse) rather than using\n         * top-level ImportDeclaration/CallExpression visitors. This ensures that if another plugin\n         * (like babel-plugin-intlayer-extract) adds new useIntlayer calls in its Program.exit,\n         * we will see and transform them here because our Program.exit runs after theirs.\n         */\n        exit(programPath, state) {\n          if (state._isDictEntry) return; // nothing else to do – already replaced\n\n          if (!state._isIncluded) return; // early-out if file is not included\n\n          // Manual traversal to process imports and call expressions\n          // This runs AFTER all other plugins' visitors have completed\n          programPath.traverse({\n            /* Inspect every intlayer import before deciding helper rewrites. */\n            ImportDeclaration(path) {\n              const src = path.node.source.value;\n\n              if (!PACKAGE_LIST.includes(src)) return;\n\n              state._hasValidImport = true;\n\n              for (const spec of path.node.specifiers) {\n                if (!t.isImportSpecifier(spec)) continue;\n\n                const importedName = t.isIdentifier(spec.imported)\n                  ? spec.imported.name\n                  : (spec.imported as BabelTypes.StringLiteral).value;\n\n                if (isCallerName(importedName)) {\n                  state._callerMap?.set(spec.local.name, importedName);\n                  state._callerPackageMap?.set(spec.local.name, src);\n                }\n              }\n            },\n          });\n\n          // Pre-pass to determine if dictionary-level overrides require the\n          // dynamic helper in an otherwise static file.\n          const packagesWithDynamicCall = new Set<string>();\n          const packagesWithFetchCall = new Set<string>();\n          programPath.traverse({\n            CallExpression(path) {\n              const callee = path.node.callee;\n\n              if (!t.isIdentifier(callee)) return;\n\n              const originalImportedName = state._callerMap?.get(callee.name);\n              if (originalImportedName !== 'useIntlayer') return;\n\n              const callerPackage = state._callerPackageMap?.get(callee.name);\n              if (!callerPackage) return;\n\n              const key = getKeyFromArgument(path.node.arguments[0], t);\n              if (!key) return;\n\n              const dictionaryOverrideMode =\n                state.opts.dictionaryModeMap?.[key];\n\n              if (dictionaryOverrideMode === 'dynamic') {\n                packagesWithDynamicCall.add(callerPackage);\n              } else if (dictionaryOverrideMode === 'fetch') {\n                packagesWithFetchCall.add(callerPackage);\n              }\n            },\n          });\n\n          programPath.traverse({\n            ImportDeclaration(path) {\n              const src = path.node.source.value;\n\n              if (!PACKAGE_LIST.includes(src)) return;\n\n              for (const spec of path.node.specifiers) {\n                if (!t.isImportSpecifier(spec)) continue;\n\n                const importedName = t.isIdentifier(spec.imported)\n                  ? spec.imported.name\n                  : (spec.imported as BabelTypes.StringLiteral).value;\n\n                if (!isCallerName(importedName)) continue;\n\n                const importMode = state.opts.importMode;\n                // Determine whether this import should use the dynamic helpers.\n                const packageHasDynamicCall = packagesWithDynamicCall.has(src);\n                const packageHasFetchCall = packagesWithFetchCall.has(src);\n                // A package import can be rewritten to only one helper. Fetch\n                // overrides therefore keep the dynamic helper for every\n                // useIntlayer call from that package in this file.\n                const shouldUseStaticFallback =\n                  !packageHasFetchCall &&\n                  shouldUseStaticSsrDynamicFallback(\n                    src,\n                    importMode === 'dynamic' || packageHasDynamicCall\n                      ? 'dynamic'\n                      : importMode,\n                    state.opts\n                  );\n                const shouldUseDynamicHelpers =\n                  isDynamicPackage(src) &&\n                  (importMode === 'fetch' ||\n                    packageHasFetchCall ||\n                    ((importMode === 'dynamic' || packageHasDynamicCall) &&\n                      !shouldUseStaticFallback));\n\n                // Remember for later (CallExpression) whether we are using the dynamic helpers\n\n                if (shouldUseDynamicHelpers) {\n                  state._useDynamicHelpers = true;\n                }\n\n                let helperMap: Record<string, string>;\n\n                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                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            /* Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) or useDictionaryDynamic(_hash, \"foo\") */\n            CallExpression(path) {\n              const callee = path.node.callee;\n\n              if (!t.isIdentifier(callee)) return;\n\n              const originalImportedName = state._callerMap?.get(callee.name);\n              if (!originalImportedName) 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 key = getKeyFromArgument(path.node.arguments[0], t);\n              if (!key) return;\n\n              const callerPackage = state._callerPackageMap?.get(callee.name);\n              const importMode = state.opts.importMode;\n              const isUseIntlayer = originalImportedName === 'useIntlayer';\n              const dictionaryOverrideMode =\n                state.opts.dictionaryModeMap?.[key];\n              const effectiveImportMode = dictionaryOverrideMode ?? importMode;\n              const packageHasFetchCall =\n                callerPackage !== undefined &&\n                packagesWithFetchCall.has(callerPackage);\n              const usesStaticSsrDynamicFallback =\n                isUseIntlayer &&\n                !packageHasFetchCall &&\n                shouldUseStaticSsrDynamicFallback(\n                  callerPackage,\n                  effectiveImportMode,\n                  state.opts\n                );\n              const useDynamicHelpers =\n                Boolean(state._useDynamicHelpers) &&\n                !usesStaticSsrDynamicFallback;\n\n              // Decide per-call mode: 'static' | 'dynamic' | 'fetch'\n              let perCallMode: ImportMode = 'static';\n\n              if (isUseIntlayer && useDynamicHelpers) {\n                if (dictionaryOverrideMode) {\n                  perCallMode = dictionaryOverrideMode;\n                } else if (importMode === 'dynamic') {\n                  perCallMode = 'dynamic';\n                } else if (importMode === 'fetch') {\n                  perCallMode = 'fetch';\n                }\n              } else if (\n                isUseIntlayer &&\n                !useDynamicHelpers &&\n                !usesStaticSsrDynamicFallback\n              ) {\n                // If dynamic helpers are NOT active (global mode is static),\n                // we STILL might want to force dynamic/fetch for this specific call\n\n                if (\n                  dictionaryOverrideMode === 'dynamic' ||\n                  dictionaryOverrideMode === 'fetch'\n                ) {\n                  perCallMode = dictionaryOverrideMode;\n                }\n              }\n\n              let ident: BabelTypes.Identifier;\n\n              if (perCallMode === 'fetch') {\n                // Use fetch dictionaries entry for selected keys\n                let dynamicIdent = state._newDynamicImports?.get(key);\n\n                if (!dynamicIdent) {\n                  const hash = getPathHash(key);\n                  dynamicIdent = t.identifier(`_${hash}_fetch`);\n                  state._newDynamicImports?.set(key, dynamicIdent);\n                }\n                ident = dynamicIdent;\n\n                // Helper: first argument is the dictionary entry, second is the key\n                path.node.arguments = [\n                  t.identifier(ident.name),\n                  ...path.node.arguments,\n                ];\n              } else if (perCallMode === 'dynamic') {\n                // Use dynamic dictionaries entry\n                let dynamicIdent = state._newDynamicImports?.get(key);\n\n                if (!dynamicIdent) {\n                  // Create a unique identifier for dynamic imports by appending a suffix\n                  const hash = getPathHash(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\n                if (!staticIdent) {\n                  staticIdent = makeIdent(key, t);\n                  state._newStaticImports?.set(key, staticIdent);\n                }\n                ident = staticIdent;\n\n                // Static helper (useDictionary / getDictionary): replace key with ident.\n                // After the splice above the key is always at index 0.\n                path.node.arguments[0] = t.identifier(ident.name);\n              }\n            },\n          });\n\n          // Early-out if we touched nothing\n\n          if (!state._hasValidImport) return;\n\n          const file = state.file.opts.filename!;\n          const dictionariesDir = state.opts.dictionariesDir;\n          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;\n          const fetchDictionariesDir = state.opts.fetchDictionariesDir;\n          const imports: BabelTypes.ImportDeclaration[] = [];\n\n          // Generate static JSON imports (getIntlayer always uses JSON dictionaries)\n          for (const [key, ident] of state._newStaticImports!) {\n            const rel = computeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              fetchDictionariesDir,\n              key,\n              'static'\n            );\n\n            const importDeclarationNode = t.importDeclaration(\n              [t.importDefaultSpecifier(t.identifier(ident.name))],\n              t.stringLiteral(rel)\n            );\n\n            // Add 'type: json' attribute for JSON files\n            importDeclarationNode.attributes = [\n              t.importAttribute(t.identifier('type'), t.stringLiteral('json')),\n            ];\n\n            imports.push(importDeclarationNode);\n          }\n\n          // Generate dynamic/fetch imports (for useIntlayer when using dynamic/fetch helpers)\n          for (const [key, ident] of state._newDynamicImports!) {\n            const modeForThisIdent: 'dynamic' | 'fetch' = ident.name.endsWith(\n              '_fetch'\n            )\n              ? 'fetch'\n              : 'dynamic';\n\n            const rel = computeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              fetchDictionariesDir,\n              key,\n              modeForThisIdent\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(\n            'body'\n          ) as NodePath<BabelTypes.Statement>[];\n          let insertPos = 0;\n          for (const stmtPath of bodyPaths) {\n            const stmt = stmtPath.node;\n\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  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"babel-plugin-intlayer-optimize.mjs","names":[],"sources":["../../src/babel-plugin-intlayer-optimize.ts"],"sourcesContent":["import { dirname, join, relative } from 'node:path';\nimport type { NodePath, PluginObj, PluginPass } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport { getPathHash } from '@intlayer/chokidar/utils';\nimport { normalizePath } from '@intlayer/config/utils';\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  'lit-intlayer',\n  'vanilla-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  'lit-intlayer',\n  'vanilla-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/**\n * Packages whose SSR-static `useDictionary` lives in a `/server` subpath\n * because it differs from the root one. Solid's reserves one hydration\n * resource slot so hydration ids stay aligned with the client's\n * `useDictionaryDynamic`; for other frameworks the root `useDictionary` is\n * already the correct SSR-static implementation.\n */\nconst SSR_STATIC_IMPORT_SOURCE: Partial<Record<string, string>> = {\n  'solid-intlayer': 'solid-intlayer/server',\n};\n\ntype CallerName = (typeof CALLER_LIST)[number];\ntype ImportMode = 'static' | 'dynamic' | 'fetch';\n\n/**\n * Options for the optimization Babel plugin\n */\nexport type OptimizePluginOptions = {\n  /**\n   * If false, the plugin will not apply any transformation.\n   */\n  optimize?: boolean;\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 unmerged dictionaries entry file.\n   */\n  unmergedDictionariesEntryPath: string;\n  /**\n   * The path to the unmerged dictionaries directory.\n   */\n  unmergedDictionariesDir: 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   * The path to the fetch dictionaries directory.\n   */\n  fetchDictionariesDir: string;\n  /**\n   * The path to the fetch dictionaries entry file.\n   */\n  fetchDictionariesEntryPath: 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' | 'fetch' | undefined;\n  /**\n   * Map of dictionary keys to their specific import mode.\n   */\n  dictionaryModeMap?: Record<\n    string,\n    'static' | 'dynamic' | 'fetch' | undefined\n  >;\n  /**\n   * Files list to traverse.\n   */\n  filesList: string[];\n  /**\n   * Whether the current transform is for an SSR bundle.\n   */\n  isServer?: boolean;\n};\n\ntype State = PluginPass & {\n  opts: OptimizePluginOptions;\n  /** map key → generated ident (per-file) for static imports */\n  _newStaticImports?: Map<string, BabelTypes.Identifier>;\n  /** map key → generated ident (per-file) for dynamic imports */\n  _newDynamicImports?: Map<string, BabelTypes.Identifier>;\n  /** whether the current file imported *any* intlayer package */\n  _hasValidImport?: boolean;\n  /** map from local identifier name to the imported intlayer func name ('useIntlayer' | 'getIntlayer') */\n  _callerMap?: Map<string, (typeof CALLER_LIST)[number]>;\n  /** map from local identifier name to the intlayer package it was imported from */\n  _callerPackageMap?: Map<string, string>;\n  /** whether the current file *is* the dictionaries entry file */\n  _isDictEntry?: boolean;\n  /** whether the current file is included in the filesList */\n  _isIncluded?: boolean;\n};\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 = (\n  key: string,\n  t: typeof BabelTypes\n): BabelTypes.Identifier => {\n  const hash = getPathHash(key);\n  return t.identifier(`_${hash}`);\n};\n\nconst computeImport = (\n  fromFile: string,\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  fetchDictionariesDir: string,\n  key: string,\n  importMode: 'static' | 'dynamic' | 'fetch'\n): string => {\n  let relativePath = join(dictionariesDir, `${key}.json`);\n\n  if (importMode === 'fetch') {\n    relativePath = join(fetchDictionariesDir, `${key}.mjs`);\n  }\n\n  if (importMode === 'dynamic') {\n    relativePath = join(dynamicDictionariesDir, `${key}.mjs`);\n  }\n\n  let rel = relative(dirname(fromFile), relativePath);\n\n  // Fix windows path\n  rel = normalizePath(rel);\n\n  // Fix relative path\n  if (!rel.startsWith('./') && !rel.startsWith('../')) {\n    rel = `./${rel}`;\n  }\n\n  return rel;\n};\n\nconst getKeyFromArgument = (\n  arg: BabelTypes.Node | null | undefined,\n  t: typeof BabelTypes\n): string | undefined => {\n  if (arg && t.isStringLiteral(arg)) {\n    return arg.value;\n  }\n\n  if (\n    arg &&\n    t.isTemplateLiteral(arg) &&\n    arg.expressions.length === 0 &&\n    arg.quasis.length === 1\n  ) {\n    return arg.quasis[0]?.value.cooked ?? arg.quasis[0]?.value.raw;\n  }\n\n  return undefined;\n};\n\nconst isCallerName = (name: string): name is CallerName =>\n  CALLER_LIST.includes(name as CallerName);\n\nconst isDynamicPackage = (\n  packageName: string\n): packageName is (typeof PACKAGE_LIST_DYNAMIC)[number] =>\n  PACKAGE_LIST_DYNAMIC.includes(\n    packageName as (typeof PACKAGE_LIST_DYNAMIC)[number]\n  );\n\n/**\n * Helper family every `useIntlayer`/`getIntlayer` call from one package import\n * resolves to in the current file. `ssrStatic` is the SSR bundle of a\n * dynamic-mode file: rewritten to the static `useDictionary` (from the\n * package's `/server` entry when it has one — see\n * `SSR_STATIC_IMPORT_SOURCE`) so the server renders static JSON while the\n * client keeps the dynamic loader.\n */\ntype PackageHelperPlan = 'static' | 'dynamic' | 'ssrStatic';\n\n/**\n * Decides, once per package import, which helper family applies to this file.\n * The import rewrite and the per-call rewrite must both derive from this\n * single decision, or the emitted helper and its argument shape diverge.\n *\n * Fetch wins over `ssrStatic`: fetch dictionaries are runtime content, so the\n * server must keep the real fetch path instead of rendering build-time JSON.\n */\nconst resolveHelperPlan = (\n  packageName: string,\n  importMode: ImportMode | undefined,\n  isServer: boolean | undefined,\n  packageHasDynamicCall: boolean,\n  packageHasFetchCall: boolean\n): PackageHelperPlan => {\n  if (!isDynamicPackage(packageName)) return 'static';\n\n  if (importMode === 'fetch' || packageHasFetchCall) return 'dynamic';\n\n  if (importMode === 'dynamic' || packageHasDynamicCall) {\n    return isServer === true ? 'ssrStatic' : 'dynamic';\n  }\n\n  return 'static';\n};\n\n/**\n * Babel plugin that transforms Intlayer function calls and auto-imports dictionaries.\n *\n * This plugin transforms calls to `useIntlayer()` and `getIntlayer()` from various Intlayer\n * packages into optimized dictionary access patterns, automatically importing the required\n * dictionary files based on the configured import mode.\n *\n * ## Supported Input Patterns\n *\n * The plugin recognizes these function calls:\n *\n * ```ts\n * // useIntlayer\n * import { useIntlayer } from 'react-intlayer';\n * import { useIntlayer } from 'next-intlayer';\n *\n * // getIntlayer\n * import { getIntlayer } from 'intlayer';\n *\n * // Usage\n * const content = useIntlayer('app');\n * const content = getIntlayer('app');\n * ```\n *\n * ## Transformation Modes\n *\n * ### Static Mode (default: `importMode = \"static\"`)\n *\n * Imports JSON dictionaries directly and replaces function calls with dictionary access:\n *\n * **Output:**\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import { useDictionary as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash);\n * const content2 = getIntlayer(_dicHash);\n * ```\n *\n * ### Dynamic Mode (`importMode = \"dynamic\"`)\n *\n * Uses dynamic dictionary loading with Suspense support:\n *\n * **Output:**\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import _dicHash_dyn from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash_dyn, 'app');\n * const content2 = getIntlayer(_dicHash);\n * ```\n *\n * ### Fetch Mode (`importMode = \"fetch\"`)\n *\n * Uses fetch-based dictionary loading for remote dictionaries:\n *\n * **Output if `dictionaryModeMap` includes the key with \"fetch\" value:**\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import _dicHash_fetch from '../../.intlayer/fetch_dictionaries/app.mjs';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash_fetch, \"app\");\n * const content2 = getIntlayer(_dicHash);\n * ```\n *\n * > If `dictionaryModeMap` does not include the key with \"fetch\" value, the plugin will fallback to the dynamic import mode.\n *\n * ```ts\n * import _dicHash from '../../.intlayer/dictionaries/app.json' with { type: 'json' };\n * import _dicHash_dyn from '../../.intlayer/dynamic_dictionaries/app.mjs';\n * import { useDictionaryDynamic as useIntlayer } from 'react-intlayer';\n * import { getDictionary as getIntlayer } from 'intlayer';\n *\n * const content1 = useIntlayer(_dicHash_dyn, 'app');\n * const content2 = getIntlayer(_dicHash);\n * ```\n */\nexport const intlayerOptimizeBabelPlugin = (babel: {\n  types: typeof BabelTypes;\n}): PluginObj<State> => {\n  const { types: t } = babel;\n\n  return {\n    name: 'babel-plugin-intlayer-transform',\n\n    pre() {\n      this._newStaticImports = new Map();\n      this._newDynamicImports = new Map();\n      this._callerMap = new Map();\n      this._callerPackageMap = new Map();\n      this._isIncluded = true;\n      this._hasValidImport = false;\n      this._isDictEntry = false;\n\n      // If optimize is false, skip processing entirely\n      if (this.opts.optimize === false) {\n        this._isIncluded = false;\n        return;\n      }\n\n      // If filesList is provided, check if current file is included\n      const filename = this.file.opts.filename\n        ? normalizePath(this.file.opts.filename)\n        : undefined;\n      if (this.opts.filesList && filename) {\n        const filesList = this.opts.filesList.map(normalizePath);\n        const isIncluded = 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      /* If this file *is* the dictionaries entry, short-circuit: export {} */\n      Program: {\n        enter(programPath, state) {\n          // Safe access to filename\n          const filename = state.file.opts.filename\n            ? normalizePath(state.file.opts.filename)\n            : undefined;\n          const dictionariesEntryPath = state.opts.dictionariesEntryPath\n            ? normalizePath(state.opts.dictionariesEntryPath)\n            : undefined;\n\n          // Check if this is the correct file to transform\n\n          if (\n            state.opts.replaceDictionaryEntry &&\n            filename === dictionariesEntryPath\n          ) {\n            state._isDictEntry = true;\n\n            // Traverse the program to surgically remove/edit specific parts\n            programPath.traverse({\n              // Remove all import statements (cleaning up 'sssss.json')\n              ImportDeclaration(path) {\n                path.remove();\n              },\n\n              // Find the variable definition and empty the object\n              VariableDeclarator(path) {\n                // We look for: const x = { ... }\n\n                if (t.isObjectExpression(path.node.init)) {\n                  // Set the object properties to an empty array: {}\n                  path.node.init.properties = [];\n                }\n              },\n            });\n\n            // (Optional) Stop other plugins from processing this file further if needed\n            // programPath.stop();\n          }\n        },\n\n        /**\n         * After full traversal, process imports and call expressions, then inject the JSON dictionary imports.\n         *\n         * We do the transformation in Program.exit (via a manual traverse) rather than using\n         * top-level ImportDeclaration/CallExpression visitors. This ensures that if another plugin\n         * (like babel-plugin-intlayer-extract) adds new useIntlayer calls in its Program.exit,\n         * we will see and transform them here because our Program.exit runs after theirs.\n         */\n        exit(programPath, state) {\n          if (state._isDictEntry) return; // nothing else to do – already replaced\n\n          if (!state._isIncluded) return; // early-out if file is not included\n\n          // Manual traversal to process imports and call expressions\n          // This runs AFTER all other plugins' visitors have completed\n          programPath.traverse({\n            /* Inspect every intlayer import before deciding helper rewrites. */\n            ImportDeclaration(path) {\n              const src = path.node.source.value;\n\n              if (!PACKAGE_LIST.includes(src)) return;\n\n              state._hasValidImport = true;\n\n              for (const spec of path.node.specifiers) {\n                if (!t.isImportSpecifier(spec)) continue;\n\n                const importedName = t.isIdentifier(spec.imported)\n                  ? spec.imported.name\n                  : (spec.imported as BabelTypes.StringLiteral).value;\n\n                if (isCallerName(importedName)) {\n                  state._callerMap?.set(spec.local.name, importedName);\n                  state._callerPackageMap?.set(spec.local.name, src);\n                }\n              }\n            },\n          });\n\n          // Pre-pass to determine if dictionary-level overrides require the\n          // dynamic helper in an otherwise static file.\n          const packagesWithDynamicCall = new Set<string>();\n          const packagesWithFetchCall = new Set<string>();\n          programPath.traverse({\n            CallExpression(path) {\n              const callee = path.node.callee;\n\n              if (!t.isIdentifier(callee)) return;\n\n              const originalImportedName = state._callerMap?.get(callee.name);\n              if (originalImportedName !== 'useIntlayer') return;\n\n              const callerPackage = state._callerPackageMap?.get(callee.name);\n              if (!callerPackage) return;\n\n              const key = getKeyFromArgument(path.node.arguments[0], t);\n              if (!key) return;\n\n              const dictionaryOverrideMode =\n                state.opts.dictionaryModeMap?.[key];\n\n              if (dictionaryOverrideMode === 'dynamic') {\n                packagesWithDynamicCall.add(callerPackage);\n              } else if (dictionaryOverrideMode === 'fetch') {\n                packagesWithFetchCall.add(callerPackage);\n              }\n            },\n          });\n\n          const getHelperPlan = (packageName: string): PackageHelperPlan =>\n            resolveHelperPlan(\n              packageName,\n              state.opts.importMode,\n              state.opts.isServer,\n              packagesWithDynamicCall.has(packageName),\n              packagesWithFetchCall.has(packageName)\n            );\n\n          programPath.traverse({\n            ImportDeclaration(path) {\n              const src = path.node.source.value;\n\n              if (!PACKAGE_LIST.includes(src)) return;\n\n              // Per-import swap, mirrored across bundles — Solid hydration\n              // ids rely on the SSR and client helpers consuming one\n              // resource slot per call alike (see solid-intlayer/server).\n              const helperPlan = getHelperPlan(src);\n              const serverSource =\n                helperPlan === 'ssrStatic'\n                  ? SSR_STATIC_IMPORT_SOURCE[src]\n                  : undefined;\n\n              const helperMap: Record<string, string> =\n                helperPlan === 'dynamic'\n                  ? { ...STATIC_IMPORT_FUNCTION, ...DYNAMIC_IMPORT_FUNCTION }\n                  : { ...STATIC_IMPORT_FUNCTION };\n\n              const serverSpecifiers: BabelTypes.ImportSpecifier[] = [];\n\n              for (const spec of path.node.specifiers) {\n                if (!t.isImportSpecifier(spec)) continue;\n\n                const importedName = t.isIdentifier(spec.imported)\n                  ? spec.imported.name\n                  : (spec.imported as BabelTypes.StringLiteral).value;\n\n                if (!isCallerName(importedName)) continue;\n\n                if (serverSource && importedName === 'useIntlayer') {\n                  spec.imported = t.identifier('useDictionary');\n                  serverSpecifiers.push(spec);\n                  continue;\n                }\n\n                const newIdentifier = helperMap[importedName];\n\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              if (serverSpecifiers.length > 0 && serverSource) {\n                // Move the helper to the /server entry, keeping any other\n                // specifiers (useLocale, …) on the original import.\n                path.insertAfter(\n                  t.importDeclaration(\n                    serverSpecifiers,\n                    t.stringLiteral(serverSource)\n                  )\n                );\n                path.node.specifiers = path.node.specifiers.filter(\n                  (spec) =>\n                    !serverSpecifiers.includes(\n                      spec as BabelTypes.ImportSpecifier\n                    )\n                );\n                if (path.node.specifiers.length === 0) {\n                  path.remove();\n                }\n              }\n            },\n\n            /* Replace calls: useIntlayer(\"foo\") → useDictionary(_hash) or useDictionaryDynamic(_hash, \"foo\") */\n            CallExpression(path) {\n              const callee = path.node.callee;\n\n              if (!t.isIdentifier(callee)) return;\n\n              const originalImportedName = state._callerMap?.get(callee.name);\n              if (!originalImportedName) 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 key = getKeyFromArgument(path.node.arguments[0], t);\n              if (!key) return;\n\n              const callerPackage = state._callerPackageMap?.get(callee.name);\n              const importMode = state.opts.importMode;\n              const isUseIntlayer = originalImportedName === 'useIntlayer';\n              const dictionaryOverrideMode =\n                state.opts.dictionaryModeMap?.[key];\n              const helperPlan =\n                callerPackage === undefined\n                  ? 'static'\n                  : getHelperPlan(callerPackage);\n\n              // Decide per-call mode: 'static' | 'dynamic' | 'fetch'.\n              let perCallMode: ImportMode = 'static';\n\n              if (isUseIntlayer && helperPlan === 'dynamic') {\n                if (dictionaryOverrideMode) {\n                  perCallMode = dictionaryOverrideMode;\n                } else if (importMode === 'dynamic' || importMode === 'fetch') {\n                  perCallMode = importMode;\n                }\n              } else if (isUseIntlayer && helperPlan === 'static') {\n                // The global mode is static, but a per-dictionary override can\n                // still force dynamic/fetch for this specific call.\n                if (\n                  dictionaryOverrideMode === 'dynamic' ||\n                  dictionaryOverrideMode === 'fetch'\n                ) {\n                  perCallMode = dictionaryOverrideMode;\n                }\n              }\n\n              let ident: BabelTypes.Identifier;\n\n              if (perCallMode === 'fetch') {\n                // Use fetch dictionaries entry for selected keys\n                let dynamicIdent = state._newDynamicImports?.get(key);\n\n                if (!dynamicIdent) {\n                  const hash = getPathHash(key);\n                  dynamicIdent = t.identifier(`_${hash}_fetch`);\n                  state._newDynamicImports?.set(key, dynamicIdent);\n                }\n                ident = dynamicIdent;\n\n                // Helper: first argument is the dictionary entry, second is the key\n                path.node.arguments = [\n                  t.identifier(ident.name),\n                  ...path.node.arguments,\n                ];\n              } else if (perCallMode === 'dynamic') {\n                // Use dynamic dictionaries entry\n                let dynamicIdent = state._newDynamicImports?.get(key);\n\n                if (!dynamicIdent) {\n                  // Create a unique identifier for dynamic imports by appending a suffix\n                  const hash = getPathHash(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\n                if (!staticIdent) {\n                  staticIdent = makeIdent(key, t);\n                  state._newStaticImports?.set(key, staticIdent);\n                }\n                ident = staticIdent;\n\n                // Static helper (useDictionary / getDictionary): replace key with ident.\n                // After the splice above the key is always at index 0.\n                path.node.arguments[0] = t.identifier(ident.name);\n              }\n            },\n          });\n\n          // Early-out if we touched nothing\n\n          if (!state._hasValidImport) return;\n\n          const file = state.file.opts.filename!;\n          const dictionariesDir = state.opts.dictionariesDir;\n          const dynamicDictionariesDir = state.opts.dynamicDictionariesDir;\n          const fetchDictionariesDir = state.opts.fetchDictionariesDir;\n          const imports: BabelTypes.ImportDeclaration[] = [];\n\n          // Generate static JSON imports (getIntlayer always uses JSON dictionaries)\n          for (const [key, ident] of state._newStaticImports!) {\n            const rel = computeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              fetchDictionariesDir,\n              key,\n              'static'\n            );\n\n            const importDeclarationNode = t.importDeclaration(\n              [t.importDefaultSpecifier(t.identifier(ident.name))],\n              t.stringLiteral(rel)\n            );\n\n            // Add 'type: json' attribute for JSON files\n            importDeclarationNode.attributes = [\n              t.importAttribute(t.identifier('type'), t.stringLiteral('json')),\n            ];\n\n            imports.push(importDeclarationNode);\n          }\n\n          // Generate dynamic/fetch imports (for useIntlayer when using dynamic/fetch helpers)\n          for (const [key, ident] of state._newDynamicImports!) {\n            const modeForThisIdent: 'dynamic' | 'fetch' = ident.name.endsWith(\n              '_fetch'\n            )\n              ? 'fetch'\n              : 'dynamic';\n\n            const rel = computeImport(\n              file,\n              dictionariesDir,\n              dynamicDictionariesDir,\n              fetchDictionariesDir,\n              key,\n              modeForThisIdent\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(\n            'body'\n          ) as NodePath<BabelTypes.Statement>[];\n          let insertPos = 0;\n          for (const stmtPath of bodyPaths) {\n            const stmt = stmtPath.node;\n\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  };\n};\n"],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import { createPruneContext, makeUsageAnalyzerBabelPlugin } from "./babel-plugin-intlayer-usage-analyzer.mjs";
 import { extractScriptBlocks } from "./extractScriptBlocks.mjs";
 import { buildNestedRenameMapFromContent } from "./babel-plugin-intlayer-field-rename.mjs";
-import { BABEL_PARSER_OPTIONS, INTLAYER_OR_COMPAT_USAGE_REGEX, SOURCE_FILE_REGEX } from "./transformers.mjs";
+import { BABEL_PARSER_OPTIONS, SOURCE_FILE_REGEX, buildUsageCheckRegex } from "./transformers.mjs";
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { transformSync } from "@babel/core";
@@ -137,11 +137,11 @@ const applyFieldRenameToDict = (dict, renameMap) => {
 * Runs the usage-analyser Babel plugin synchronously on a single code block,
 * accumulating results into `pruneContext`.
 */
-const analyzeCodeBlockSync = (code, sourceFilePath, pruneContext) => {
+const analyzeCodeBlockSync = (code, sourceFilePath, pruneContext, compatCallers) => {
 	try {
 		transformSync(code, {
 			filename: sourceFilePath,
-			plugins: [makeUsageAnalyzerBabelPlugin(pruneContext)],
+			plugins: [makeUsageAnalyzerBabelPlugin(pruneContext, { compatCallers })],
 			parserOpts: BABEL_PARSER_OPTIONS,
 			ast: false,
 			code: false
@@ -154,18 +154,19 @@ const analyzeCodeBlockSync = (code, sourceFilePath, pruneContext) => {
 * Reads a source file from disk and runs the usage-analyser synchronously.
 * SFC files (Vue / Svelte) are handled by extracting script blocks first.
 */
-const analyzeSourceFileSync = (sourceFilePath, pruneContext) => {
+const analyzeSourceFileSync = (sourceFilePath, pruneContext, compatCallers) => {
 	let code;
 	try {
 		code = readFileSync(sourceFilePath, "utf-8");
 	} catch {
 		return;
 	}
-	if (!INTLAYER_OR_COMPAT_USAGE_REGEX.test(code)) return;
+	const usageCheckRegex = buildUsageCheckRegex((compatCallers ?? []).map((caller) => caller.callerName));
+	if (!usageCheckRegex.test(code)) return;
 	const scriptBlocks = extractScriptBlocks(sourceFilePath, code);
 	for (const block of scriptBlocks) {
-		if (!INTLAYER_OR_COMPAT_USAGE_REGEX.test(block.content)) continue;
-		analyzeCodeBlockSync(block.content, sourceFilePath, pruneContext);
+		if (!usageCheckRegex.test(block.content)) continue;
+		analyzeCodeBlockSync(block.content, sourceFilePath, pruneContext, compatCallers);
 	}
 };
 /**
@@ -320,7 +321,7 @@ const processAllDictionaryFiles = (dictionariesDir, dynamicDictionariesDir, prun
 * unique `baseDir`.
 */
 const runPurgePipeline = (options) => {
-	const { baseDir, purge, minify, optimize, editorEnabled, dictionariesDir, dynamicDictionariesDir, componentFilesList, dictionaryKeyToImportModeMap } = options;
+	const { baseDir, purge, minify, optimize, editorEnabled, dictionariesDir, dynamicDictionariesDir, componentFilesList, dictionaryKeyToImportModeMap, compatCallers } = options;
 	const cachedContext = _pruneContextCache.get(baseDir);
 	if (cachedContext) return cachedContext;
 	const pruneContext = createPruneContext();
@@ -330,7 +331,7 @@ const runPurgePipeline = (options) => {
 	if (!shouldPurge && !shouldMinify || optimize === false) return pruneContext;
 	for (const sourceFilePath of componentFilesList) {
 		if (!SOURCE_FILE_REGEX.test(sourceFilePath)) continue;
-		analyzeSourceFileSync(sourceFilePath, pruneContext);
+		analyzeSourceFileSync(sourceFilePath, pruneContext, compatCallers);
 	}
 	if (shouldMinify) buildRenameMapsSynchronously(dictionariesDir, dynamicDictionariesDir, dictionaryKeyToImportModeMap, pruneContext);
 	processAllDictionaryFiles(dictionariesDir, dynamicDictionariesDir, pruneContext, shouldPurge, shouldMinify);

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

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer-purge.mjs","names":[],"sources":["../../src/babel-plugin-intlayer-purge.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { PluginObj, PluginPass } from '@babel/core';\nimport { transformSync } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport { buildNestedRenameMapFromContent } from './babel-plugin-intlayer-field-rename';\nimport {\n  createPruneContext,\n  makeUsageAnalyzerBabelPlugin,\n  type NestedRenameMap,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\nimport { extractScriptBlocks } from './extractScriptBlocks';\nimport {\n  BABEL_PARSER_OPTIONS,\n  INTLAYER_OR_COMPAT_USAGE_REGEX,\n  SOURCE_FILE_REGEX,\n} from './transformers';\n\n// ── Plugin options ────────────────────────────────────────────────────────────\n\n/**\n * Pre-resolved options accepted by {@link intlayerPurgeBabelPlugin}.\n *\n * All values are resolved at babel.config.js load time (via\n * {@link getPurgePluginOptions}) so the plugin itself does not need to read\n * the configuration file on every file transform.\n */\nexport type PurgePluginOptions = {\n  /**\n   * Absolute path to the project root.  Used as the cache key for the shared\n   * {@link PruneContext} so two Babel transform pipelines for different\n   * workspaces in the same process do not share state.\n   */\n  baseDir: string;\n\n  /**\n   * When `true`, remove unused content fields from compiled dictionary JSON\n   * files.  Mirrors `build.purge` in `intlayer.config.ts`.\n   */\n  purge: boolean;\n\n  /**\n   * When `true`, rename content fields to short alphabetic aliases\n   * (`title` → `a`, etc.) and strip top-level metadata from compiled\n   * dictionaries.  Mirrors `build.minify` in `intlayer.config.ts`.\n   */\n  minify: boolean;\n\n  /**\n   * Build optimisation toggle.  `undefined` means \"auto\" (active for\n   * production builds).  When explicitly `false`, the plugin is a no-op.\n   * Mirrors `build.optimize`.\n   */\n  optimize: boolean | undefined;\n\n  /**\n   * When `true` the plugin skips all processing to preserve full dictionary\n   * content for the visual editor.  Mirrors `editor.enabled`.\n   */\n  editorEnabled: boolean;\n\n  /**\n   * Absolute path to the compiled static dictionaries directory\n   * (`.intlayer/dictionaries/` by default).\n   */\n  dictionariesDir: string;\n\n  /**\n   * Absolute path to the compiled per-locale dynamic dictionaries directory\n   * (`.intlayer/dynamic_dictionaries/` by default).\n   */\n  dynamicDictionariesDir: string;\n\n  /**\n   * Pre-built list of component source file paths to analyse for field-usage.\n   * Populated by {@link getPurgePluginOptions} from the intlayer config's\n   * `content` glob patterns.\n   */\n  componentFilesList: string[];\n\n  /**\n   * Per-dictionary import-mode overrides, keyed by dictionary `key`.\n   * Dictionaries with mode `'fetch'` are excluded from field renaming because\n   * their JSON is served from a remote API using the original field names.\n   */\n  dictionaryKeyToImportModeMap: Record<\n    string,\n    'static' | 'dynamic' | 'fetch' | undefined\n  >;\n};\n\n// ── Shared module-level state ─────────────────────────────────────────────────\n\n/**\n * Cache of built {@link PruneContext} objects, keyed by the project's\n * `baseDir`.  Each context is built exactly once per Node.js process.\n */\nconst _pruneContextCache = new Map<string, PruneContext>();\n\n/**\n * Tracks base directories whose full analysis + dictionary-write cycle has\n * already completed, to avoid repeating work across file transforms.\n */\nconst _completedBaseDirs = new Set<string>();\n\n/**\n * Returns the shared {@link PruneContext} for the given base directory, or\n * `null` if {@link intlayerPurgeBabelPlugin} has not yet been initialised for\n * that directory.\n *\n * Used by {@link intlayerMinifyBabelPlugin} to read the rename map without\n * creating a circular dependency.\n */\nexport const getSharedPruneContext = (baseDir: string): PruneContext | null =>\n  _pruneContextCache.get(baseDir) ?? null;\n\n// ── Dictionary JSON types ─────────────────────────────────────────────────────\n\ntype TranslationNode = {\n  nodeType: 'translation';\n  translation: Record<string, unknown>;\n};\n\ntype CompiledDictionaryJson = {\n  key: string;\n  content: TranslationNode | Record<string, unknown>;\n  locale?: string;\n  [extraKey: string]: unknown;\n};\n\n// ── Type guards ───────────────────────────────────────────────────────────────\n\nconst isTranslationNode = (value: unknown): value is TranslationNode =>\n  typeof value === 'object' &&\n  value !== null &&\n  (value as Record<string, unknown>).nodeType === 'translation' &&\n  typeof (value as Record<string, unknown>).translation === 'object';\n\nconst isPlainRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n// ── Prune helpers (mirrors intlayerPrunePlugin) ───────────────────────────────\n\ntype PruneResult = {\n  prunedDictionary: CompiledDictionaryJson;\n  wasRecognised: boolean;\n};\n\n/**\n * Removes unused fields from a **static** dictionary (all locales in one\n * file). Supports shape A (translation node at the root) and shape B (flat\n * record of translation nodes per field).\n */\nconst pruneStaticDictionaryContent = (\n  dictionary: CompiledDictionaryJson,\n  usedFieldNames: Set<string>\n): PruneResult => {\n  const { content } = dictionary;\n\n  // Shape A: { nodeType: \"translation\", translation: { en: { f1, f2 } } }\n  if (isTranslationNode(content)) {\n    const firstLocaleValue = Object.values(content.translation)[0];\n    if (isPlainRecord(firstLocaleValue)) {\n      const prunedTranslation: Record<string, unknown> = {};\n      for (const [locale, localeContent] of Object.entries(\n        content.translation\n      )) {\n        if (!isPlainRecord(localeContent)) {\n          prunedTranslation[locale] = localeContent;\n          continue;\n        }\n        const prunedLocaleFields: Record<string, unknown> = {};\n        for (const [fieldName, fieldValue] of Object.entries(localeContent)) {\n          if (usedFieldNames.has(fieldName)) {\n            prunedLocaleFields[fieldName] = fieldValue;\n          }\n        }\n        prunedTranslation[locale] = prunedLocaleFields;\n      }\n      return {\n        prunedDictionary: {\n          ...dictionary,\n          content: { ...content, translation: prunedTranslation },\n        },\n        wasRecognised: true,\n      };\n    }\n  }\n\n  // Shape B: { field1: { nodeType: \"translation\", … }, field2: { … } }\n  if (isPlainRecord(content) && !isTranslationNode(content)) {\n    const prunedContent: Record<string, unknown> = {};\n    for (const [fieldName, fieldValue] of Object.entries(content)) {\n      if (usedFieldNames.has(fieldName)) {\n        prunedContent[fieldName] = fieldValue;\n      }\n    }\n    return {\n      prunedDictionary: {\n        ...dictionary,\n        content: prunedContent as CompiledDictionaryJson['content'],\n      },\n      wasRecognised: true,\n    };\n  }\n\n  return { prunedDictionary: dictionary, wasRecognised: false };\n};\n\n/**\n * Removes unused fields from a **dynamic / per-locale** dictionary file\n * (one JSON per locale, flat `content` record).\n */\nconst pruneDynamicDictionaryContent = (\n  dictionary: CompiledDictionaryJson,\n  usedFieldNames: Set<string>\n): PruneResult => {\n  const { content } = dictionary;\n  if (!isPlainRecord(content)) {\n    return { prunedDictionary: dictionary, wasRecognised: false };\n  }\n  const prunedContent: Record<string, unknown> = {};\n  for (const [fieldName, fieldValue] of Object.entries(content)) {\n    if (usedFieldNames.has(fieldName)) {\n      prunedContent[fieldName] = fieldValue;\n    }\n  }\n  return {\n    prunedDictionary: {\n      ...dictionary,\n      content: prunedContent as CompiledDictionaryJson['content'],\n    },\n    wasRecognised: true,\n  };\n};\n\n// ── Minify helpers (mirrors intlayerMinifyPlugin) ─────────────────────────────\n\n/**\n * Recursively renames user-defined content fields using `renameMap`.\n * Translation nodes, arrays, and primitives follow the same traversal rules\n * as in the Vite-based minify plugin.\n */\nconst renameContentRecursively = (\n  value: unknown,\n  renameMap: NestedRenameMap\n): unknown => {\n  if (Array.isArray(value)) {\n    return (value as unknown[]).map((element) =>\n      renameContentRecursively(element, renameMap)\n    );\n  }\n  if (!value || typeof value !== 'object') return value;\n\n  const record = value as Record<string, unknown>;\n\n  // Translation node: recurse into each locale value with the same map.\n  if (\n    typeof record.nodeType === 'string' &&\n    record.translation &&\n    typeof record.translation === 'object' &&\n    !Array.isArray(record.translation)\n  ) {\n    const renamedTranslation: Record<string, unknown> = {};\n    for (const [locale, localeValue] of Object.entries(\n      record.translation as Record<string, unknown>\n    )) {\n      renamedTranslation[locale] = renameContentRecursively(\n        localeValue,\n        renameMap\n      );\n    }\n    return { ...record, translation: renamedTranslation };\n  }\n\n  // User-defined record: rename keys and recurse into values.\n  const result: Record<string, unknown> = {};\n  for (const [key, val] of Object.entries(record)) {\n    const renameEntry = renameMap.get(key);\n    if (renameEntry) {\n      result[renameEntry.shortName] = renameContentRecursively(\n        val,\n        renameEntry.children\n      );\n    } else {\n      result[key] = val;\n    }\n  }\n  return result;\n};\n\n/**\n * Applies a {@link NestedRenameMap} to a parsed dictionary object, renaming\n * only the keys inside `content` while leaving top-level metadata untouched.\n */\nconst applyFieldRenameToDict = (\n  dict: Record<string, unknown>,\n  renameMap: NestedRenameMap\n): Record<string, unknown> => {\n  const content = dict.content;\n  if (!content || typeof content !== 'object' || Array.isArray(content))\n    return dict;\n  return {\n    ...dict,\n    content: renameContentRecursively(content, renameMap),\n  };\n};\n\n// ── Synchronous source-file analysis ─────────────────────────────────────────\n\n/**\n * Runs the usage-analyser Babel plugin synchronously on a single code block,\n * accumulating results into `pruneContext`.\n */\nconst analyzeCodeBlockSync = (\n  code: string,\n  sourceFilePath: string,\n  pruneContext: PruneContext\n): void => {\n  try {\n    transformSync(code, {\n      filename: sourceFilePath,\n      plugins: [makeUsageAnalyzerBabelPlugin(pruneContext)],\n      parserOpts: BABEL_PARSER_OPTIONS,\n      ast: false,\n      code: false,\n    });\n  } catch {\n    pruneContext.hasUnparsableSourceFiles = true;\n  }\n};\n\n/**\n * Reads a source file from disk and runs the usage-analyser synchronously.\n * SFC files (Vue / Svelte) are handled by extracting script blocks first.\n */\nconst analyzeSourceFileSync = (\n  sourceFilePath: string,\n  pruneContext: PruneContext\n): void => {\n  let code: string;\n  try {\n    code = readFileSync(sourceFilePath, 'utf-8');\n  } catch {\n    return;\n  }\n\n  if (!INTLAYER_OR_COMPAT_USAGE_REGEX.test(code)) return;\n\n  const scriptBlocks = extractScriptBlocks(sourceFilePath, code);\n  for (const block of scriptBlocks) {\n    if (!INTLAYER_OR_COMPAT_USAGE_REGEX.test(block.content)) continue;\n    analyzeCodeBlockSync(block.content, sourceFilePath, pruneContext);\n  }\n};\n\n// ── Build rename maps ─────────────────────────────────────────────────────────\n\n/**\n * Reads compiled dictionary JSON files to build the nested field-rename maps,\n * mirroring the Phase 4 logic in the Vite `intlayerOptimize` plugin's\n * `buildStart` hook.  Results are stored in\n * `pruneContext.dictionaryKeyToFieldRenameMap`.\n */\nconst buildRenameMapsSynchronously = (\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  dictionaryKeyToImportModeMap: PurgePluginOptions['dictionaryKeyToImportModeMap'],\n  pruneContext: PruneContext\n): void => {\n  for (const [\n    dictionaryKey,\n    fieldUsage,\n  ] of pruneContext.dictionaryKeyToFieldUsageMap) {\n    if (fieldUsage === 'all') continue;\n    if (dictionaryKeyToImportModeMap[dictionaryKey] === 'fetch') continue;\n    if (pruneContext.dictionariesSkippingFieldRename.has(dictionaryKey))\n      continue;\n\n    let dictionaryContent: unknown = null;\n\n    const staticJsonPath = join(dictionariesDir, `${dictionaryKey}.json`);\n    if (existsSync(staticJsonPath)) {\n      try {\n        const raw = readFileSync(staticJsonPath, 'utf-8');\n        const parsed = JSON.parse(raw) as Record<string, unknown>;\n        dictionaryContent = parsed.content;\n      } catch {\n        // Fall through to dynamic dict.\n      }\n    }\n\n    if (!dictionaryContent) {\n      const dynamicDirPath = join(dynamicDictionariesDir, dictionaryKey);\n      if (existsSync(dynamicDirPath)) {\n        try {\n          const localeFiles = readdirSync(dynamicDirPath);\n          const firstJsonFile = localeFiles.find((file) =>\n            file.endsWith('.json')\n          );\n          if (firstJsonFile) {\n            const raw = readFileSync(\n              join(dynamicDirPath, firstJsonFile),\n              'utf-8'\n            );\n            const parsed = JSON.parse(raw) as Record<string, unknown>;\n            dictionaryContent = parsed.content;\n          }\n        } catch {\n          // Dictionary not readable – skip rename for this key.\n        }\n      }\n    }\n\n    if (!dictionaryContent) continue;\n\n    const nestedRenameMap = buildNestedRenameMapFromContent(dictionaryContent);\n\n    // Preserve children of opaque fields to avoid breaking child components.\n    const opaqueFieldMap =\n      pruneContext.dictionaryKeysWithOpaqueTopLevelFields.get(dictionaryKey);\n    if (opaqueFieldMap) {\n      const dangerousEntries = [...opaqueFieldMap.entries()].filter(\n        ([fieldName]) =>\n          (nestedRenameMap.get(fieldName)?.children.size ?? 0) > 0\n      );\n      for (const [fieldName] of dangerousEntries) {\n        const entry = nestedRenameMap.get(fieldName);\n        if (entry) {\n          entry.children = new Map();\n        }\n      }\n    }\n\n    if (nestedRenameMap.size > 0) {\n      pruneContext.dictionaryKeyToFieldRenameMap.set(\n        dictionaryKey,\n        nestedRenameMap\n      );\n    }\n  }\n};\n\n// ── Dictionary file writing ───────────────────────────────────────────────────\n\nconst processStaticDictionaryFile = (\n  filePath: string,\n  pruneContext: PruneContext,\n  shouldPurge: boolean,\n  shouldMinify: boolean\n): void => {\n  let rawJson: string;\n  try {\n    rawJson = readFileSync(filePath, 'utf-8');\n  } catch {\n    return;\n  }\n\n  let parsedDict: CompiledDictionaryJson;\n  try {\n    parsedDict = JSON.parse(rawJson) as CompiledDictionaryJson;\n  } catch {\n    return;\n  }\n\n  const { key: dictionaryKey } = parsedDict;\n  if (!dictionaryKey) return;\n  if (pruneContext.dictionariesWithEdgeCases.has(dictionaryKey)) return;\n\n  let modified = false;\n\n  if (shouldPurge) {\n    const fieldUsage =\n      pruneContext.dictionaryKeyToFieldUsageMap.get(dictionaryKey);\n    if (fieldUsage && fieldUsage !== 'all') {\n      const { prunedDictionary, wasRecognised } = pruneStaticDictionaryContent(\n        parsedDict,\n        fieldUsage\n      );\n      if (!wasRecognised) {\n        pruneContext.dictionariesWithEdgeCases.add(dictionaryKey);\n        return;\n      }\n      parsedDict = prunedDictionary;\n      modified = true;\n    }\n  }\n\n  if (shouldMinify) {\n    const fieldRenameMap =\n      pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n    if (fieldRenameMap && fieldRenameMap.size > 0) {\n      parsedDict = applyFieldRenameToDict(\n        parsedDict as Record<string, unknown>,\n        fieldRenameMap\n      ) as CompiledDictionaryJson;\n      modified = true;\n    }\n  }\n\n  if (!modified) return;\n\n  const outputDict = shouldMinify\n    ? { key: parsedDict.key, content: parsedDict.content }\n    : parsedDict;\n\n  try {\n    writeFileSync(filePath, JSON.stringify(outputDict), 'utf-8');\n  } catch {\n    // Write failure – leave file unchanged.\n  }\n};\n\nconst processDynamicDictionaryFile = (\n  filePath: string,\n  pruneContext: PruneContext,\n  shouldPurge: boolean,\n  shouldMinify: boolean\n): void => {\n  let rawJson: string;\n  try {\n    rawJson = readFileSync(filePath, 'utf-8');\n  } catch {\n    return;\n  }\n\n  let parsedDict: CompiledDictionaryJson;\n  try {\n    parsedDict = JSON.parse(rawJson) as CompiledDictionaryJson;\n  } catch {\n    return;\n  }\n\n  const { key: dictionaryKey } = parsedDict;\n  if (!dictionaryKey) return;\n  if (pruneContext.dictionariesWithEdgeCases.has(dictionaryKey)) return;\n\n  let modified = false;\n\n  if (shouldPurge) {\n    const fieldUsage =\n      pruneContext.dictionaryKeyToFieldUsageMap.get(dictionaryKey);\n    if (fieldUsage && fieldUsage !== 'all') {\n      const { prunedDictionary, wasRecognised } = pruneDynamicDictionaryContent(\n        parsedDict,\n        fieldUsage\n      );\n      if (!wasRecognised) {\n        pruneContext.dictionariesWithEdgeCases.add(dictionaryKey);\n        return;\n      }\n      parsedDict = prunedDictionary;\n      modified = true;\n    }\n  }\n\n  if (shouldMinify) {\n    const fieldRenameMap =\n      pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n    if (fieldRenameMap && fieldRenameMap.size > 0) {\n      parsedDict = applyFieldRenameToDict(\n        parsedDict as Record<string, unknown>,\n        fieldRenameMap\n      ) as CompiledDictionaryJson;\n      modified = true;\n    }\n  }\n\n  if (!modified) return;\n\n  const outputDict = shouldMinify\n    ? {\n        key: parsedDict.key,\n        content: parsedDict.content,\n        locale: parsedDict.locale,\n      }\n    : parsedDict;\n\n  try {\n    writeFileSync(filePath, JSON.stringify(outputDict), 'utf-8');\n  } catch {\n    // Write failure – leave file unchanged.\n  }\n};\n\nconst processAllDictionaryFiles = (\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  pruneContext: PruneContext,\n  shouldPurge: boolean,\n  shouldMinify: boolean\n): void => {\n  if (existsSync(dictionariesDir)) {\n    for (const entry of readdirSync(dictionariesDir)) {\n      if (!entry.endsWith('.json')) continue;\n      processStaticDictionaryFile(\n        join(dictionariesDir, entry),\n        pruneContext,\n        shouldPurge,\n        shouldMinify\n      );\n    }\n  }\n\n  if (existsSync(dynamicDictionariesDir)) {\n    for (const keyDir of readdirSync(dynamicDictionariesDir)) {\n      const keyDirPath = join(dynamicDictionariesDir, keyDir);\n      try {\n        for (const localeFile of readdirSync(keyDirPath)) {\n          if (!localeFile.endsWith('.json')) continue;\n          processDynamicDictionaryFile(\n            join(keyDirPath, localeFile),\n            pruneContext,\n            shouldPurge,\n            shouldMinify\n          );\n        }\n      } catch {\n        // Unreadable key directory – skip.\n      }\n    }\n  }\n};\n\n// ── Main initialisation ───────────────────────────────────────────────────────\n\n/**\n * Runs the full purge/minify pipeline for the given options, using a\n * module-level cache so the work happens at most once per process per\n * unique `baseDir`.\n */\nconst runPurgePipeline = (options: PurgePluginOptions): PruneContext => {\n  const {\n    baseDir,\n    purge,\n    minify,\n    optimize,\n    editorEnabled,\n    dictionariesDir,\n    dynamicDictionariesDir,\n    componentFilesList,\n    dictionaryKeyToImportModeMap,\n  } = options;\n\n  const cachedContext = _pruneContextCache.get(baseDir);\n  if (cachedContext) return cachedContext;\n\n  const pruneContext = createPruneContext();\n  _pruneContextCache.set(baseDir, pruneContext);\n\n  const shouldPurge = purge && !editorEnabled;\n  const shouldMinify = minify && !editorEnabled;\n\n  if ((!shouldPurge && !shouldMinify) || optimize === false)\n    return pruneContext;\n\n  // Phase 1: Synchronously analyse all component source files.\n  for (const sourceFilePath of componentFilesList) {\n    if (!SOURCE_FILE_REGEX.test(sourceFilePath)) continue;\n    analyzeSourceFileSync(sourceFilePath, pruneContext);\n  }\n\n  // Phase 2: Build field-rename maps (minify only).\n  if (shouldMinify) {\n    buildRenameMapsSynchronously(\n      dictionariesDir,\n      dynamicDictionariesDir,\n      dictionaryKeyToImportModeMap,\n      pruneContext\n    );\n  }\n\n  // Phase 3: Write pruned / minified dictionary JSON files to disk.\n  processAllDictionaryFiles(\n    dictionariesDir,\n    dynamicDictionariesDir,\n    pruneContext,\n    shouldPurge,\n    shouldMinify\n  );\n\n  return pruneContext;\n};\n\n// ── Babel plugin ──────────────────────────────────────────────────────────────\n\n/**\n * Babel plugin that analyses all project source files and rewrites compiled\n * dictionary JSON files in-place to remove unused content fields\n * (`build.purge`) and/or rename them to short alphabetic aliases\n * (`build.minify`).\n *\n * All option values must be pre-resolved via {@link getPurgePluginOptions}\n * before being passed here — the plugin does not load the intlayer\n * configuration itself.\n *\n * This plugin performs **file I/O as a side effect**: on the very first Babel\n * transform in a given Node.js process it synchronously scans the component\n * files listed in `options.componentFilesList`, builds field-usage data, and\n * writes the processed dictionaries to disk.  Subsequent transforms are\n * no-ops.\n *\n * Source-code field renames (rewriting `content.title` → `content.a`) are\n * handled by the companion {@link intlayerMinifyBabelPlugin}.\n *\n * @example\n * ```js\n * // babel.config.js\n * const {\n *   intlayerPurgeBabelPlugin,\n *   intlayerMinifyBabelPlugin,\n *   intlayerOptimizeBabelPlugin,\n *   getPurgePluginOptions,\n *   getMinifyPluginOptions,\n *   getOptimizePluginOptions,\n * } = require(\"@intlayer/babel\");\n *\n * module.exports = {\n *   presets: [\"next/babel\"],\n *   plugins: [\n *     [intlayerPurgeBabelPlugin,    getPurgePluginOptions()],\n *     [intlayerMinifyBabelPlugin,   getMinifyPluginOptions()],\n *     [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],\n *   ],\n * };\n * ```\n *\n * @remarks\n * - Intended for **production builds** only.  Dictionary JSON files are\n *   overwritten in-place; running `intlayer build` afterwards restores the\n *   originals.\n * - The plugin is a no-op when `optimize` is `false` or `editorEnabled` is\n *   `true`.\n */\nexport const intlayerPurgeBabelPlugin = (_babel: {\n  types: typeof BabelTypes;\n}): PluginObj => ({\n  name: 'intlayer-purge',\n\n  pre(this: PluginPass & { opts: PurgePluginOptions }) {\n    const { baseDir } = this.opts;\n\n    if (_completedBaseDirs.has(baseDir)) return;\n    _completedBaseDirs.add(baseDir);\n\n    runPurgePipeline(this.opts);\n  },\n\n  visitor: {\n    // No AST transforms: all work is done as a side effect in pre().\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"babel-plugin-intlayer-purge.mjs","names":[],"sources":["../../src/babel-plugin-intlayer-purge.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { PluginObj, PluginPass } from '@babel/core';\nimport { transformSync } from '@babel/core';\nimport type * as BabelTypes from '@babel/types';\nimport { buildNestedRenameMapFromContent } from './babel-plugin-intlayer-field-rename';\nimport {\n  type CompatCallerConfig,\n  createPruneContext,\n  makeUsageAnalyzerBabelPlugin,\n  type NestedRenameMap,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\nimport { extractScriptBlocks } from './extractScriptBlocks';\nimport {\n  BABEL_PARSER_OPTIONS,\n  buildUsageCheckRegex,\n  SOURCE_FILE_REGEX,\n} from './transformers';\n\n// ── Plugin options ────────────────────────────────────────────────────────────\n\n/**\n * Pre-resolved options accepted by {@link intlayerPurgeBabelPlugin}.\n *\n * All values are resolved at babel.config.js load time (via\n * {@link getPurgePluginOptions}) so the plugin itself does not need to read\n * the configuration file on every file transform.\n */\nexport type PurgePluginOptions = {\n  /**\n   * Absolute path to the project root.  Used as the cache key for the shared\n   * {@link PruneContext} so two Babel transform pipelines for different\n   * workspaces in the same process do not share state.\n   */\n  baseDir: string;\n\n  /**\n   * When `true`, remove unused content fields from compiled dictionary JSON\n   * files.  Mirrors `build.purge` in `intlayer.config.ts`.\n   */\n  purge: boolean;\n\n  /**\n   * When `true`, rename content fields to short alphabetic aliases\n   * (`title` → `a`, etc.) and strip top-level metadata from compiled\n   * dictionaries.  Mirrors `build.minify` in `intlayer.config.ts`.\n   */\n  minify: boolean;\n\n  /**\n   * Build optimisation toggle.  `undefined` means \"auto\" (active for\n   * production builds).  When explicitly `false`, the plugin is a no-op.\n   * Mirrors `build.optimize`.\n   */\n  optimize: boolean | undefined;\n\n  /**\n   * When `true` the plugin skips all processing to preserve full dictionary\n   * content for the visual editor.  Mirrors `editor.enabled`.\n   */\n  editorEnabled: boolean;\n\n  /**\n   * Absolute path to the compiled static dictionaries directory\n   * (`.intlayer/dictionaries/` by default).\n   */\n  dictionariesDir: string;\n\n  /**\n   * Absolute path to the compiled per-locale dynamic dictionaries directory\n   * (`.intlayer/dynamic_dictionaries/` by default).\n   */\n  dynamicDictionariesDir: string;\n\n  /**\n   * Pre-built list of component source file paths to analyse for field-usage.\n   * Populated by {@link getPurgePluginOptions} from the intlayer config's\n   * `content` glob patterns.\n   */\n  componentFilesList: string[];\n\n  /**\n   * Per-dictionary import-mode overrides, keyed by dictionary `key`.\n   * Dictionaries with mode `'fetch'` are excluded from field renaming because\n   * their JSON is served from a remote API using the original field names.\n   */\n  dictionaryKeyToImportModeMap: Record<\n    string,\n    'static' | 'dynamic' | 'fetch' | undefined\n  >;\n\n  /**\n   * Compat-adapter namespace caller configurations.\n   *\n   * When set, the usage analyser recognises these additional translation\n   * function patterns and maps them to dictionary field usage.  Each compat\n   * adapter package (e.g. `@intlayer/react-i18next`) provides its own caller\n   * list; they are NOT hardcoded here so that `@intlayer/babel` stays\n   * framework-agnostic.\n   *\n   * Defaults to `[]` (no compat callers) when omitted.\n   */\n  compatCallers?: CompatCallerConfig[];\n};\n\n// ── Shared module-level state ─────────────────────────────────────────────────\n\n/**\n * Cache of built {@link PruneContext} objects, keyed by the project's\n * `baseDir`.  Each context is built exactly once per Node.js process.\n */\nconst _pruneContextCache = new Map<string, PruneContext>();\n\n/**\n * Tracks base directories whose full analysis + dictionary-write cycle has\n * already completed, to avoid repeating work across file transforms.\n */\nconst _completedBaseDirs = new Set<string>();\n\n/**\n * Returns the shared {@link PruneContext} for the given base directory, or\n * `null` if {@link intlayerPurgeBabelPlugin} has not yet been initialised for\n * that directory.\n *\n * Used by {@link intlayerMinifyBabelPlugin} to read the rename map without\n * creating a circular dependency.\n */\nexport const getSharedPruneContext = (baseDir: string): PruneContext | null =>\n  _pruneContextCache.get(baseDir) ?? null;\n\n// ── Dictionary JSON types ─────────────────────────────────────────────────────\n\ntype TranslationNode = {\n  nodeType: 'translation';\n  translation: Record<string, unknown>;\n};\n\ntype CompiledDictionaryJson = {\n  key: string;\n  content: TranslationNode | Record<string, unknown>;\n  locale?: string;\n  [extraKey: string]: unknown;\n};\n\n// ── Type guards ───────────────────────────────────────────────────────────────\n\nconst isTranslationNode = (value: unknown): value is TranslationNode =>\n  typeof value === 'object' &&\n  value !== null &&\n  (value as Record<string, unknown>).nodeType === 'translation' &&\n  typeof (value as Record<string, unknown>).translation === 'object';\n\nconst isPlainRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n// ── Prune helpers (mirrors intlayerPrunePlugin) ───────────────────────────────\n\ntype PruneResult = {\n  prunedDictionary: CompiledDictionaryJson;\n  wasRecognised: boolean;\n};\n\n/**\n * Removes unused fields from a **static** dictionary (all locales in one\n * file). Supports shape A (translation node at the root) and shape B (flat\n * record of translation nodes per field).\n */\nconst pruneStaticDictionaryContent = (\n  dictionary: CompiledDictionaryJson,\n  usedFieldNames: Set<string>\n): PruneResult => {\n  const { content } = dictionary;\n\n  // Shape A: { nodeType: \"translation\", translation: { en: { f1, f2 } } }\n  if (isTranslationNode(content)) {\n    const firstLocaleValue = Object.values(content.translation)[0];\n    if (isPlainRecord(firstLocaleValue)) {\n      const prunedTranslation: Record<string, unknown> = {};\n      for (const [locale, localeContent] of Object.entries(\n        content.translation\n      )) {\n        if (!isPlainRecord(localeContent)) {\n          prunedTranslation[locale] = localeContent;\n          continue;\n        }\n        const prunedLocaleFields: Record<string, unknown> = {};\n        for (const [fieldName, fieldValue] of Object.entries(localeContent)) {\n          if (usedFieldNames.has(fieldName)) {\n            prunedLocaleFields[fieldName] = fieldValue;\n          }\n        }\n        prunedTranslation[locale] = prunedLocaleFields;\n      }\n      return {\n        prunedDictionary: {\n          ...dictionary,\n          content: { ...content, translation: prunedTranslation },\n        },\n        wasRecognised: true,\n      };\n    }\n  }\n\n  // Shape B: { field1: { nodeType: \"translation\", … }, field2: { … } }\n  if (isPlainRecord(content) && !isTranslationNode(content)) {\n    const prunedContent: Record<string, unknown> = {};\n    for (const [fieldName, fieldValue] of Object.entries(content)) {\n      if (usedFieldNames.has(fieldName)) {\n        prunedContent[fieldName] = fieldValue;\n      }\n    }\n    return {\n      prunedDictionary: {\n        ...dictionary,\n        content: prunedContent as CompiledDictionaryJson['content'],\n      },\n      wasRecognised: true,\n    };\n  }\n\n  return { prunedDictionary: dictionary, wasRecognised: false };\n};\n\n/**\n * Removes unused fields from a **dynamic / per-locale** dictionary file\n * (one JSON per locale, flat `content` record).\n */\nconst pruneDynamicDictionaryContent = (\n  dictionary: CompiledDictionaryJson,\n  usedFieldNames: Set<string>\n): PruneResult => {\n  const { content } = dictionary;\n  if (!isPlainRecord(content)) {\n    return { prunedDictionary: dictionary, wasRecognised: false };\n  }\n  const prunedContent: Record<string, unknown> = {};\n  for (const [fieldName, fieldValue] of Object.entries(content)) {\n    if (usedFieldNames.has(fieldName)) {\n      prunedContent[fieldName] = fieldValue;\n    }\n  }\n  return {\n    prunedDictionary: {\n      ...dictionary,\n      content: prunedContent as CompiledDictionaryJson['content'],\n    },\n    wasRecognised: true,\n  };\n};\n\n// ── Minify helpers (mirrors intlayerMinifyPlugin) ─────────────────────────────\n\n/**\n * Recursively renames user-defined content fields using `renameMap`.\n * Translation nodes, arrays, and primitives follow the same traversal rules\n * as in the Vite-based minify plugin.\n */\nconst renameContentRecursively = (\n  value: unknown,\n  renameMap: NestedRenameMap\n): unknown => {\n  if (Array.isArray(value)) {\n    return (value as unknown[]).map((element) =>\n      renameContentRecursively(element, renameMap)\n    );\n  }\n  if (!value || typeof value !== 'object') return value;\n\n  const record = value as Record<string, unknown>;\n\n  // Translation node: recurse into each locale value with the same map.\n  if (\n    typeof record.nodeType === 'string' &&\n    record.translation &&\n    typeof record.translation === 'object' &&\n    !Array.isArray(record.translation)\n  ) {\n    const renamedTranslation: Record<string, unknown> = {};\n    for (const [locale, localeValue] of Object.entries(\n      record.translation as Record<string, unknown>\n    )) {\n      renamedTranslation[locale] = renameContentRecursively(\n        localeValue,\n        renameMap\n      );\n    }\n    return { ...record, translation: renamedTranslation };\n  }\n\n  // User-defined record: rename keys and recurse into values.\n  const result: Record<string, unknown> = {};\n  for (const [key, val] of Object.entries(record)) {\n    const renameEntry = renameMap.get(key);\n    if (renameEntry) {\n      result[renameEntry.shortName] = renameContentRecursively(\n        val,\n        renameEntry.children\n      );\n    } else {\n      result[key] = val;\n    }\n  }\n  return result;\n};\n\n/**\n * Applies a {@link NestedRenameMap} to a parsed dictionary object, renaming\n * only the keys inside `content` while leaving top-level metadata untouched.\n */\nconst applyFieldRenameToDict = (\n  dict: Record<string, unknown>,\n  renameMap: NestedRenameMap\n): Record<string, unknown> => {\n  const content = dict.content;\n  if (!content || typeof content !== 'object' || Array.isArray(content))\n    return dict;\n  return {\n    ...dict,\n    content: renameContentRecursively(content, renameMap),\n  };\n};\n\n// ── Synchronous source-file analysis ─────────────────────────────────────────\n\n/**\n * Runs the usage-analyser Babel plugin synchronously on a single code block,\n * accumulating results into `pruneContext`.\n */\nconst analyzeCodeBlockSync = (\n  code: string,\n  sourceFilePath: string,\n  pruneContext: PruneContext,\n  compatCallers?: CompatCallerConfig[]\n): void => {\n  try {\n    transformSync(code, {\n      filename: sourceFilePath,\n      plugins: [makeUsageAnalyzerBabelPlugin(pruneContext, { compatCallers })],\n      parserOpts: BABEL_PARSER_OPTIONS,\n      ast: false,\n      code: false,\n    });\n  } catch {\n    pruneContext.hasUnparsableSourceFiles = true;\n  }\n};\n\n/**\n * Reads a source file from disk and runs the usage-analyser synchronously.\n * SFC files (Vue / Svelte) are handled by extracting script blocks first.\n */\nconst analyzeSourceFileSync = (\n  sourceFilePath: string,\n  pruneContext: PruneContext,\n  compatCallers?: CompatCallerConfig[]\n): void => {\n  let code: string;\n  try {\n    code = readFileSync(sourceFilePath, 'utf-8');\n  } catch {\n    return;\n  }\n\n  const extraCallerNames = (compatCallers ?? []).map(\n    (caller) => caller.callerName\n  );\n  const usageCheckRegex = buildUsageCheckRegex(extraCallerNames);\n\n  if (!usageCheckRegex.test(code)) return;\n\n  const scriptBlocks = extractScriptBlocks(sourceFilePath, code);\n  for (const block of scriptBlocks) {\n    if (!usageCheckRegex.test(block.content)) continue;\n    analyzeCodeBlockSync(\n      block.content,\n      sourceFilePath,\n      pruneContext,\n      compatCallers\n    );\n  }\n};\n\n// ── Build rename maps ─────────────────────────────────────────────────────────\n\n/**\n * Reads compiled dictionary JSON files to build the nested field-rename maps,\n * mirroring the Phase 4 logic in the Vite `intlayerOptimize` plugin's\n * `buildStart` hook.  Results are stored in\n * `pruneContext.dictionaryKeyToFieldRenameMap`.\n */\nconst buildRenameMapsSynchronously = (\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  dictionaryKeyToImportModeMap: PurgePluginOptions['dictionaryKeyToImportModeMap'],\n  pruneContext: PruneContext\n): void => {\n  for (const [\n    dictionaryKey,\n    fieldUsage,\n  ] of pruneContext.dictionaryKeyToFieldUsageMap) {\n    if (fieldUsage === 'all') continue;\n    if (dictionaryKeyToImportModeMap[dictionaryKey] === 'fetch') continue;\n    if (pruneContext.dictionariesSkippingFieldRename.has(dictionaryKey))\n      continue;\n\n    let dictionaryContent: unknown = null;\n\n    const staticJsonPath = join(dictionariesDir, `${dictionaryKey}.json`);\n    if (existsSync(staticJsonPath)) {\n      try {\n        const raw = readFileSync(staticJsonPath, 'utf-8');\n        const parsed = JSON.parse(raw) as Record<string, unknown>;\n        dictionaryContent = parsed.content;\n      } catch {\n        // Fall through to dynamic dict.\n      }\n    }\n\n    if (!dictionaryContent) {\n      const dynamicDirPath = join(dynamicDictionariesDir, dictionaryKey);\n      if (existsSync(dynamicDirPath)) {\n        try {\n          const localeFiles = readdirSync(dynamicDirPath);\n          const firstJsonFile = localeFiles.find((file) =>\n            file.endsWith('.json')\n          );\n          if (firstJsonFile) {\n            const raw = readFileSync(\n              join(dynamicDirPath, firstJsonFile),\n              'utf-8'\n            );\n            const parsed = JSON.parse(raw) as Record<string, unknown>;\n            dictionaryContent = parsed.content;\n          }\n        } catch {\n          // Dictionary not readable – skip rename for this key.\n        }\n      }\n    }\n\n    if (!dictionaryContent) continue;\n\n    const nestedRenameMap = buildNestedRenameMapFromContent(dictionaryContent);\n\n    // Preserve children of opaque fields to avoid breaking child components.\n    const opaqueFieldMap =\n      pruneContext.dictionaryKeysWithOpaqueTopLevelFields.get(dictionaryKey);\n    if (opaqueFieldMap) {\n      const dangerousEntries = [...opaqueFieldMap.entries()].filter(\n        ([fieldName]) =>\n          (nestedRenameMap.get(fieldName)?.children.size ?? 0) > 0\n      );\n      for (const [fieldName] of dangerousEntries) {\n        const entry = nestedRenameMap.get(fieldName);\n        if (entry) {\n          entry.children = new Map();\n        }\n      }\n    }\n\n    if (nestedRenameMap.size > 0) {\n      pruneContext.dictionaryKeyToFieldRenameMap.set(\n        dictionaryKey,\n        nestedRenameMap\n      );\n    }\n  }\n};\n\n// ── Dictionary file writing ───────────────────────────────────────────────────\n\nconst processStaticDictionaryFile = (\n  filePath: string,\n  pruneContext: PruneContext,\n  shouldPurge: boolean,\n  shouldMinify: boolean\n): void => {\n  let rawJson: string;\n  try {\n    rawJson = readFileSync(filePath, 'utf-8');\n  } catch {\n    return;\n  }\n\n  let parsedDict: CompiledDictionaryJson;\n  try {\n    parsedDict = JSON.parse(rawJson) as CompiledDictionaryJson;\n  } catch {\n    return;\n  }\n\n  const { key: dictionaryKey } = parsedDict;\n  if (!dictionaryKey) return;\n  if (pruneContext.dictionariesWithEdgeCases.has(dictionaryKey)) return;\n\n  let modified = false;\n\n  if (shouldPurge) {\n    const fieldUsage =\n      pruneContext.dictionaryKeyToFieldUsageMap.get(dictionaryKey);\n    if (fieldUsage && fieldUsage !== 'all') {\n      const { prunedDictionary, wasRecognised } = pruneStaticDictionaryContent(\n        parsedDict,\n        fieldUsage\n      );\n      if (!wasRecognised) {\n        pruneContext.dictionariesWithEdgeCases.add(dictionaryKey);\n        return;\n      }\n      parsedDict = prunedDictionary;\n      modified = true;\n    }\n  }\n\n  if (shouldMinify) {\n    const fieldRenameMap =\n      pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n    if (fieldRenameMap && fieldRenameMap.size > 0) {\n      parsedDict = applyFieldRenameToDict(\n        parsedDict as Record<string, unknown>,\n        fieldRenameMap\n      ) as CompiledDictionaryJson;\n      modified = true;\n    }\n  }\n\n  if (!modified) return;\n\n  const outputDict = shouldMinify\n    ? { key: parsedDict.key, content: parsedDict.content }\n    : parsedDict;\n\n  try {\n    writeFileSync(filePath, JSON.stringify(outputDict), 'utf-8');\n  } catch {\n    // Write failure – leave file unchanged.\n  }\n};\n\nconst processDynamicDictionaryFile = (\n  filePath: string,\n  pruneContext: PruneContext,\n  shouldPurge: boolean,\n  shouldMinify: boolean\n): void => {\n  let rawJson: string;\n  try {\n    rawJson = readFileSync(filePath, 'utf-8');\n  } catch {\n    return;\n  }\n\n  let parsedDict: CompiledDictionaryJson;\n  try {\n    parsedDict = JSON.parse(rawJson) as CompiledDictionaryJson;\n  } catch {\n    return;\n  }\n\n  const { key: dictionaryKey } = parsedDict;\n  if (!dictionaryKey) return;\n  if (pruneContext.dictionariesWithEdgeCases.has(dictionaryKey)) return;\n\n  let modified = false;\n\n  if (shouldPurge) {\n    const fieldUsage =\n      pruneContext.dictionaryKeyToFieldUsageMap.get(dictionaryKey);\n    if (fieldUsage && fieldUsage !== 'all') {\n      const { prunedDictionary, wasRecognised } = pruneDynamicDictionaryContent(\n        parsedDict,\n        fieldUsage\n      );\n      if (!wasRecognised) {\n        pruneContext.dictionariesWithEdgeCases.add(dictionaryKey);\n        return;\n      }\n      parsedDict = prunedDictionary;\n      modified = true;\n    }\n  }\n\n  if (shouldMinify) {\n    const fieldRenameMap =\n      pruneContext.dictionaryKeyToFieldRenameMap.get(dictionaryKey);\n    if (fieldRenameMap && fieldRenameMap.size > 0) {\n      parsedDict = applyFieldRenameToDict(\n        parsedDict as Record<string, unknown>,\n        fieldRenameMap\n      ) as CompiledDictionaryJson;\n      modified = true;\n    }\n  }\n\n  if (!modified) return;\n\n  const outputDict = shouldMinify\n    ? {\n        key: parsedDict.key,\n        content: parsedDict.content,\n        locale: parsedDict.locale,\n      }\n    : parsedDict;\n\n  try {\n    writeFileSync(filePath, JSON.stringify(outputDict), 'utf-8');\n  } catch {\n    // Write failure – leave file unchanged.\n  }\n};\n\nconst processAllDictionaryFiles = (\n  dictionariesDir: string,\n  dynamicDictionariesDir: string,\n  pruneContext: PruneContext,\n  shouldPurge: boolean,\n  shouldMinify: boolean\n): void => {\n  if (existsSync(dictionariesDir)) {\n    for (const entry of readdirSync(dictionariesDir)) {\n      if (!entry.endsWith('.json')) continue;\n      processStaticDictionaryFile(\n        join(dictionariesDir, entry),\n        pruneContext,\n        shouldPurge,\n        shouldMinify\n      );\n    }\n  }\n\n  if (existsSync(dynamicDictionariesDir)) {\n    for (const keyDir of readdirSync(dynamicDictionariesDir)) {\n      const keyDirPath = join(dynamicDictionariesDir, keyDir);\n      try {\n        for (const localeFile of readdirSync(keyDirPath)) {\n          if (!localeFile.endsWith('.json')) continue;\n          processDynamicDictionaryFile(\n            join(keyDirPath, localeFile),\n            pruneContext,\n            shouldPurge,\n            shouldMinify\n          );\n        }\n      } catch {\n        // Unreadable key directory – skip.\n      }\n    }\n  }\n};\n\n// ── Main initialisation ───────────────────────────────────────────────────────\n\n/**\n * Runs the full purge/minify pipeline for the given options, using a\n * module-level cache so the work happens at most once per process per\n * unique `baseDir`.\n */\nconst runPurgePipeline = (options: PurgePluginOptions): PruneContext => {\n  const {\n    baseDir,\n    purge,\n    minify,\n    optimize,\n    editorEnabled,\n    dictionariesDir,\n    dynamicDictionariesDir,\n    componentFilesList,\n    dictionaryKeyToImportModeMap,\n    compatCallers,\n  } = options;\n\n  const cachedContext = _pruneContextCache.get(baseDir);\n  if (cachedContext) return cachedContext;\n\n  const pruneContext = createPruneContext();\n  _pruneContextCache.set(baseDir, pruneContext);\n\n  const shouldPurge = purge && !editorEnabled;\n  const shouldMinify = minify && !editorEnabled;\n\n  if ((!shouldPurge && !shouldMinify) || optimize === false)\n    return pruneContext;\n\n  // Phase 1: Synchronously analyse all component source files.\n  for (const sourceFilePath of componentFilesList) {\n    if (!SOURCE_FILE_REGEX.test(sourceFilePath)) continue;\n    analyzeSourceFileSync(sourceFilePath, pruneContext, compatCallers);\n  }\n\n  // Phase 2: Build field-rename maps (minify only).\n  if (shouldMinify) {\n    buildRenameMapsSynchronously(\n      dictionariesDir,\n      dynamicDictionariesDir,\n      dictionaryKeyToImportModeMap,\n      pruneContext\n    );\n  }\n\n  // Phase 3: Write pruned / minified dictionary JSON files to disk.\n  processAllDictionaryFiles(\n    dictionariesDir,\n    dynamicDictionariesDir,\n    pruneContext,\n    shouldPurge,\n    shouldMinify\n  );\n\n  return pruneContext;\n};\n\n// ── Babel plugin ──────────────────────────────────────────────────────────────\n\n/**\n * Babel plugin that analyses all project source files and rewrites compiled\n * dictionary JSON files in-place to remove unused content fields\n * (`build.purge`) and/or rename them to short alphabetic aliases\n * (`build.minify`).\n *\n * All option values must be pre-resolved via {@link getPurgePluginOptions}\n * before being passed here — the plugin does not load the intlayer\n * configuration itself.\n *\n * This plugin performs **file I/O as a side effect**: on the very first Babel\n * transform in a given Node.js process it synchronously scans the component\n * files listed in `options.componentFilesList`, builds field-usage data, and\n * writes the processed dictionaries to disk.  Subsequent transforms are\n * no-ops.\n *\n * Source-code field renames (rewriting `content.title` → `content.a`) are\n * handled by the companion {@link intlayerMinifyBabelPlugin}.\n *\n * @example\n * ```js\n * // babel.config.js\n * const {\n *   intlayerPurgeBabelPlugin,\n *   intlayerMinifyBabelPlugin,\n *   intlayerOptimizeBabelPlugin,\n *   getPurgePluginOptions,\n *   getMinifyPluginOptions,\n *   getOptimizePluginOptions,\n * } = require(\"@intlayer/babel\");\n *\n * module.exports = {\n *   presets: [\"next/babel\"],\n *   plugins: [\n *     [intlayerPurgeBabelPlugin,    getPurgePluginOptions()],\n *     [intlayerMinifyBabelPlugin,   getMinifyPluginOptions()],\n *     [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],\n *   ],\n * };\n * ```\n *\n * @remarks\n * - Intended for **production builds** only.  Dictionary JSON files are\n *   overwritten in-place; running `intlayer build` afterwards restores the\n *   originals.\n * - The plugin is a no-op when `optimize` is `false` or `editorEnabled` is\n *   `true`.\n */\nexport const intlayerPurgeBabelPlugin = (_babel: {\n  types: typeof BabelTypes;\n}): PluginObj => ({\n  name: 'intlayer-purge',\n\n  pre(this: PluginPass & { opts: PurgePluginOptions }) {\n    const { baseDir } = this.opts;\n\n    if (_completedBaseDirs.has(baseDir)) return;\n    _completedBaseDirs.add(baseDir);\n\n    runPurgePipeline(this.opts);\n  },\n\n  visitor: {\n    // No AST transforms: all work is done as a side effect in pre().\n  },\n});\n"],"mappings":"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"}

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

@@ -12,77 +12,16 @@ const createPruneContext = () => ({
 /** Canonical intlayer caller names that trigger usage analysis. */
 const INTLAYER_CALLER_NAMES = ["useIntlayer", "getIntlayer"];
 /**
-* Default registry of compat namespace callers, covering every first-party
-* `@intlayer/*` adapter package and its underlying i18n library.
+* Default registry of compat namespace callers.
+*
+* Intentionally empty — compat-specific caller configurations belong in their
+* respective adapter packages (e.g. `@intlayer/react-i18next/plugin`,
+* `@intlayer/vue-i18n/plugin`) and are injected into `makeUsageAnalyzerBabelPlugin`
+* via the `compatCallers` option.  Centralising them here would couple the
+* core `@intlayer/babel` package to every compat adapter, which violates the
+* design principle that compat logic lives in compat packages.
 */
-const DEFAULT_COMPAT_CALLERS = [
-	{
-		callerName: "useTranslation",
-		importSources: [
-			"react-i18next",
-			"@intlayer/react-i18next",
-			"next-i18next",
-			"@intlayer/next-i18next"
-		],
-		namespace: {
-			from: "argument",
-			index: 0
-		},
-		keyPrefix: {
-			from: "option",
-			argumentIndex: 1,
-			property: "keyPrefix"
-		},
-		translationFunction: "destructured-t"
-	},
-	{
-		callerName: "useTranslations",
-		importSources: ["next-intl", "@intlayer/next-intl"],
-		namespace: {
-			from: "argument",
-			index: 0
-		},
-		translationFunction: "return-value"
-	},
-	{
-		callerName: "getTranslations",
-		importSources: [
-			"next-intl/server",
-			"@intlayer/next-intl/server",
-			"next-intl",
-			"@intlayer/next-intl"
-		],
-		namespace: {
-			from: "argument",
-			index: 0
-		},
-		translationFunction: "return-value"
-	},
-	{
-		callerName: "getFixedT",
-		importSources: ["i18next", "@intlayer/i18next"],
-		matchAsMethod: true,
-		namespace: {
-			from: "argument",
-			index: 1
-		},
-		keyPrefix: {
-			from: "argument",
-			index: 2
-		},
-		translationFunction: "return-value"
-	},
-	{
-		callerName: "useI18n",
-		importSources: ["vue-i18n", "@intlayer/vue-i18n"],
-		namespace: {
-			from: "option",
-			argumentIndex: 0,
-			property: "namespace"
-		},
-		translationFunction: "destructured-t"
-	}
-];
+const DEFAULT_COMPAT_CALLERS = [];
 /** Default namespace used by compat callers when no namespace argument is given. */
 const DEFAULT_COMPAT_NAMESPACE = "translation";
 /**
@@ -212,7 +151,10 @@ const analyzeCallExpressionUsage = (babelTypes, pruneContext, callExpressionPath
 					hasUntrackedReferenceAccess = true;
 					break;
 				}
-			} else if (babelTypes.isArrayExpression(referenceParentNode)) {} else if ((babelTypes.isCallExpression(referenceParentNode) || babelTypes.isOptionalCallExpression(referenceParentNode)) && referenceParentNode.callee === variableReferencePath.node) {
+			} else if (babelTypes.isArrayExpression(referenceParentNode)) {
+				hasUntrackedReferenceAccess = true;
+				break;
+			} else if ((babelTypes.isCallExpression(referenceParentNode) || babelTypes.isOptionalCallExpression(referenceParentNode)) && referenceParentNode.callee === variableReferencePath.node) {
 				const callExprPath = variableReferencePath.parentPath;
 				const callParent = callExprPath?.parent;
 				if (callParent && (babelTypes.isMemberExpression(callParent) || babelTypes.isOptionalMemberExpression(callParent)) && callParent.object === callExprPath?.node) {