@intlayer/babel 8.12.1 → 8.12.2

package/dist/esm/transformers.mjs

@@ -28,11 +28,23 @@ const BABEL_PARSER_OPTIONS = {
 	]
 };
 /**
-* Fast pre-check: matches files that could contain intlayer calls.
-* Avoids running Babel on files with no relevant identifiers.
+* Fast pre-check: matches files that could contain native intlayer calls
+* (`useIntlayer` / `getIntlayer`). Used by the optimize/transform pass, which
+* only rewrites native calls.
 */
 const INTLAYER_USAGE_REGEX = /\b(use|get)Intlayer\b/;
 /**
+* Fast pre-check: matches files that could contain compat-adapter namespace
+* callers (`useTranslation`, `useTranslations`, `getTranslations`, `getFixedT`,
+* `useI18n`). These are analysed for field usage (pruning) but never rewritten.
+*/
+const COMPAT_USAGE_REGEX = /\b(useTranslation|useTranslations|getTranslations|getFixedT|useI18n)\b/;
+/**
+* Fast pre-check for the usage-analysis phase: matches files containing either
+* native intlayer calls or compat-adapter namespace callers.
+*/
+const INTLAYER_OR_COMPAT_USAGE_REGEX = /\b(useIntlayer|getIntlayer|useTranslation|useTranslations|getTranslations|getFixedT|useI18n)\b/;
+/**
 * Matches source files that are valid targets for usage analysis and Babel
 * transformation. Excludes sourcemap files, declaration files, and other
 * non-source extensions.
@@ -44,10 +56,10 @@ const SOURCE_FILE_REGEX = /\.(tsx?|[mc]?jsx?|vue|svelte|astro)$/;
 * This is analysis-only: the transformed code output is discarded.
 * Throws if Babel cannot parse the content.
 */
-const analyzeScriptContent = async (scriptContent, sourceFilePath, pruneContext) => {
+const analyzeScriptContent = async (scriptContent, sourceFilePath, pruneContext, compatCallers) => {
 	await transformAsync(scriptContent, {
 		filename: sourceFilePath,
-		plugins: [makeUsageAnalyzerBabelPlugin(pruneContext)],
+		plugins: [makeUsageAnalyzerBabelPlugin(pruneContext, { compatCallers })],
 		parserOpts: BABEL_PARSER_OPTIONS,
 		ast: false,
 		code: false
@@ -65,11 +77,11 @@ const analyzeScriptContent = async (scriptContent, sourceFilePath, pruneContext)
 * Throws if Babel cannot parse the file (caller should handle and flag
 * `pruneContext.hasUnparsableSourceFiles`).
 */
-const analyzeFieldUsageInFile = async (sourceFilePath, code, pruneContext) => {
+const analyzeFieldUsageInFile = async (sourceFilePath, code, pruneContext, compatCallers) => {
 	const scriptBlocks = extractScriptBlocks(sourceFilePath, code);
 	for (const block of scriptBlocks) {
-		if (!INTLAYER_USAGE_REGEX.test(block.content)) continue;
-		await analyzeScriptContent(block.content, sourceFilePath, pruneContext);
+		if (!INTLAYER_OR_COMPAT_USAGE_REGEX.test(block.content)) continue;
+		await analyzeScriptContent(block.content, sourceFilePath, pruneContext, compatCallers);
 	}
 };
 /**
@@ -138,5 +150,5 @@ const optimizeSourceFile = async (code, sourceFilePath, options) => {
 };
 
 //#endregion
-export { BABEL_PARSER_OPTIONS, INTLAYER_USAGE_REGEX, SOURCE_FILE_REGEX, analyzeFieldUsageInFile, optimizeSourceFile, renameFieldsInCode, renameFieldsInSourceFile };
+export { BABEL_PARSER_OPTIONS, COMPAT_USAGE_REGEX, INTLAYER_OR_COMPAT_USAGE_REGEX, INTLAYER_USAGE_REGEX, SOURCE_FILE_REGEX, analyzeFieldUsageInFile, optimizeSourceFile, renameFieldsInCode, renameFieldsInSourceFile };
 //# sourceMappingURL=transformers.mjs.map

package/dist/esm/transformers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.mjs","names":[],"sources":["../../src/transformers.ts"],"sourcesContent":["import { type TransformOptions, transformAsync } from '@babel/core';\nimport { makeFieldRenameBabelPlugin } from './babel-plugin-intlayer-field-rename';\nimport {\n  intlayerOptimizeBabelPlugin,\n  type OptimizePluginOptions,\n} from './babel-plugin-intlayer-optimize';\nimport {\n  makeUsageAnalyzerBabelPlugin,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\nimport { extractScriptBlocks, injectScriptBlocks } from './extractScriptBlocks';\n\n// ── Shared Babel parser configuration ─────────────────────────────────────────\n\n/**\n * Babel parser options covering the superset of syntaxes used across all\n * supported frameworks (React / Vue / Svelte / Angular / …).\n */\nexport const BABEL_PARSER_OPTIONS: NonNullable<TransformOptions['parserOpts']> =\n  {\n    sourceType: 'module',\n    allowImportExportEverywhere: true,\n    plugins: [\n      'typescript',\n      'jsx',\n      'decorators-legacy',\n      'classProperties',\n      'objectRestSpread',\n      'asyncGenerators',\n      'functionBind',\n      'exportDefaultFrom',\n      'exportNamespaceFrom',\n      'dynamicImport',\n      'nullishCoalescingOperator',\n      'optionalChaining',\n    ],\n  };\n\n/**\n * Fast pre-check: matches files that could contain intlayer calls.\n * Avoids running Babel on files with no relevant identifiers.\n */\nexport const INTLAYER_USAGE_REGEX = /\\b(use|get)Intlayer\\b/;\n\n/**\n * Matches source files that are valid targets for usage analysis and Babel\n * transformation. Excludes sourcemap files, declaration files, and other\n * non-source extensions.\n */\nexport const SOURCE_FILE_REGEX = /\\.(tsx?|[mc]?jsx?|vue|svelte|astro)$/;\n\n// ── High-level transformer functions ──────────────────────────────────────────\n\n/**\n * Runs the usage-analysis Babel plugin on a single JS/TS code string.\n *\n * This is analysis-only: the transformed code output is discarded.\n * Throws if Babel cannot parse the content.\n */\nconst analyzeScriptContent = async (\n  scriptContent: string,\n  sourceFilePath: string,\n  pruneContext: PruneContext\n): Promise<void> => {\n  await transformAsync(scriptContent, {\n    filename: sourceFilePath,\n    plugins: [makeUsageAnalyzerBabelPlugin(pruneContext)],\n    parserOpts: BABEL_PARSER_OPTIONS,\n    ast: false,\n    code: false, // analysis only – no output needed\n  });\n};\n\n/**\n * Runs the usage-analysis Babel plugin on a source file, accumulating\n * field-usage data into `pruneContext`.\n *\n * For Vue / Svelte SFC files, script blocks are extracted before analysis so\n * Babel does not attempt to parse the full SFC syntax (templates, styles, …).\n * For plain JS/TS files, the whole file content is analysed directly.\n *\n * This is analysis-only: the transformed code output is discarded.\n * Throws if Babel cannot parse the file (caller should handle and flag\n * `pruneContext.hasUnparsableSourceFiles`).\n */\nexport const analyzeFieldUsageInFile = async (\n  sourceFilePath: string,\n  code: string,\n  pruneContext: PruneContext\n): Promise<void> => {\n  const scriptBlocks = extractScriptBlocks(sourceFilePath, code);\n\n  // For SFC files (Vue / Svelte): scriptBlocks[0].contentStartOffset > 0\n  // means we extracted actual <script> tags from the file.\n  // For plain JS/TS: extractScriptBlocks returns the whole file as a single\n  // block with offset 0, so we fall through to the same path.\n  for (const block of scriptBlocks) {\n    if (!INTLAYER_USAGE_REGEX.test(block.content)) continue;\n    await analyzeScriptContent(block.content, sourceFilePath, pruneContext);\n  }\n};\n\n/**\n * Applies field-renaming to a single JS/TS code string (not an SFC).\n *\n * Returns the renamed code string, or `null` if nothing changed or if\n * Babel failed to parse the input (caller should fall back to original code).\n */\nexport const renameFieldsInCode = async (\n  code: string,\n  sourceFilePath: string,\n  pruneContext: PruneContext\n): Promise<string | null> => {\n  try {\n    const result = await transformAsync(code, {\n      filename: sourceFilePath,\n      plugins: [makeFieldRenameBabelPlugin(pruneContext)],\n      parserOpts: BABEL_PARSER_OPTIONS,\n      ast: false,\n    });\n    return result?.code ?? null;\n  } catch {\n    return null; // parse failure – caller falls back to original code\n  }\n};\n\n/**\n * Applies field-renaming to a source file, correctly handling both plain\n * JS/TS files and SFC files (Vue / Svelte) by operating on each script block\n * individually and injecting the results back into the original source.\n *\n * Returns the renamed code string, or `null` if nothing changed.\n */\nexport const renameFieldsInSourceFile = async (\n  sourceFilePath: string,\n  code: string,\n  pruneContext: PruneContext\n): Promise<string | null> => {\n  if (pruneContext.dictionaryKeyToFieldRenameMap.size === 0) return null;\n  if (!INTLAYER_USAGE_REGEX.test(code)) return null;\n\n  const scriptBlocks = extractScriptBlocks(sourceFilePath, code);\n\n  const isSFC =\n    scriptBlocks.length > 0 &&\n    ((scriptBlocks[0]?.contentStartOffset ?? 0) > 0 || scriptBlocks.length > 1);\n\n  if (isSFC) {\n    // Raw SFC: rename each script block individually and inject back.\n    const modifications: Array<{\n      block: (typeof scriptBlocks)[number];\n      modifiedContent: string;\n    }> = [];\n\n    for (const block of scriptBlocks) {\n      if (!INTLAYER_USAGE_REGEX.test(block.content)) continue;\n\n      const renamedCode = await renameFieldsInCode(\n        block.content,\n        sourceFilePath,\n        pruneContext\n      );\n      if (renamedCode && renamedCode !== block.content) {\n        modifications.push({ block, modifiedContent: renamedCode });\n      }\n    }\n\n    if (modifications.length === 0) return null;\n    return injectScriptBlocks(code, modifications);\n  }\n\n  // Plain JS/TS or compiled SFC (no block delimiters) – rename the whole file.\n  return renameFieldsInCode(code, sourceFilePath, pruneContext);\n};\n\n/**\n * Runs the intlayer optimize Babel plugin on a source file, transforming\n * `useIntlayer('key')` / `getIntlayer('key')` calls into `useDictionary(_hash)`\n * / `getDictionary(_hash)` and injecting the corresponding dictionary imports.\n *\n * Returns `{ code, map }` on success, or `null` if the transformation produced\n * no output.\n */\nexport const optimizeSourceFile = async (\n  code: string,\n  sourceFilePath: string,\n  options: OptimizePluginOptions\n): Promise<{\n  code: string;\n  map: string | object | null | undefined;\n} | null> => {\n  const result = await transformAsync(code, {\n    filename: sourceFilePath,\n    plugins: [[intlayerOptimizeBabelPlugin, options]],\n    parserOpts: BABEL_PARSER_OPTIONS,\n  });\n\n  if (!result?.code) return null;\n\n  return { code: result.code, map: result.map };\n};\n"],"mappings":";;;;;;;;;;;AAkBA,MAAa,uBACX;CACE,YAAY;CACZ,6BAA6B;CAC7B,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;AAMF,MAAa,uBAAuB;;;;;;AAOpC,MAAa,oBAAoB;;;;;;;AAUjC,MAAM,uBAAuB,OAC3B,eACA,gBACA,iBACkB;CAClB,MAAM,eAAe,eAAe;EAClC,UAAU;EACV,SAAS,CAAC,6BAA6B,YAAY,CAAC;EACpD,YAAY;EACZ,KAAK;EACL,MAAM;CACR,CAAC;AACH;;;;;;;;;;;;;AAcA,MAAa,0BAA0B,OACrC,gBACA,MACA,iBACkB;CAClB,MAAM,eAAe,oBAAoB,gBAAgB,IAAI;CAM7D,KAAK,MAAM,SAAS,cAAc;EAChC,IAAI,CAAC,qBAAqB,KAAK,MAAM,OAAO,GAAG;EAC/C,MAAM,qBAAqB,MAAM,SAAS,gBAAgB,YAAY;CACxE;AACF;;;;;;;AAQA,MAAa,qBAAqB,OAChC,MACA,gBACA,iBAC2B;CAC3B,IAAI;EAOF,QAAO,MANc,eAAe,MAAM;GACxC,UAAU;GACV,SAAS,CAAC,2BAA2B,YAAY,CAAC;GAClD,YAAY;GACZ,KAAK;EACP,CAAC,IACc,QAAQ;CACzB,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;AASA,MAAa,2BAA2B,OACtC,gBACA,MACA,iBAC2B;CAC3B,IAAI,aAAa,8BAA8B,SAAS,GAAG,OAAO;CAClE,IAAI,CAAC,qBAAqB,KAAK,IAAI,GAAG,OAAO;CAE7C,MAAM,eAAe,oBAAoB,gBAAgB,IAAI;CAM7D,IAHE,aAAa,SAAS,OACpB,aAAa,IAAI,sBAAsB,KAAK,KAAK,aAAa,SAAS,IAEhE;EAET,MAAM,gBAGD,CAAC;EAEN,KAAK,MAAM,SAAS,cAAc;GAChC,IAAI,CAAC,qBAAqB,KAAK,MAAM,OAAO,GAAG;GAE/C,MAAM,cAAc,MAAM,mBACxB,MAAM,SACN,gBACA,YACF;GACA,IAAI,eAAe,gBAAgB,MAAM,SACvC,cAAc,KAAK;IAAE;IAAO,iBAAiB;GAAY,CAAC;EAE9D;EAEA,IAAI,cAAc,WAAW,GAAG,OAAO;EACvC,OAAO,mBAAmB,MAAM,aAAa;CAC/C;CAGA,OAAO,mBAAmB,MAAM,gBAAgB,YAAY;AAC9D;;;;;;;;;AAUA,MAAa,qBAAqB,OAChC,MACA,gBACA,YAIW;CACX,MAAM,SAAS,MAAM,eAAe,MAAM;EACxC,UAAU;EACV,SAAS,CAAC,CAAC,6BAA6B,OAAO,CAAC;EAChD,YAAY;CACd,CAAC;CAED,IAAI,CAAC,QAAQ,MAAM,OAAO;CAE1B,OAAO;EAAE,MAAM,OAAO;EAAM,KAAK,OAAO;CAAI;AAC9C"}
+{"version":3,"file":"transformers.mjs","names":[],"sources":["../../src/transformers.ts"],"sourcesContent":["import { type TransformOptions, transformAsync } from '@babel/core';\nimport { makeFieldRenameBabelPlugin } from './babel-plugin-intlayer-field-rename';\nimport {\n  intlayerOptimizeBabelPlugin,\n  type OptimizePluginOptions,\n} from './babel-plugin-intlayer-optimize';\nimport {\n  type CompatCallerConfig,\n  makeUsageAnalyzerBabelPlugin,\n  type PruneContext,\n} from './babel-plugin-intlayer-usage-analyzer';\nimport { extractScriptBlocks, injectScriptBlocks } from './extractScriptBlocks';\n\n// ── Shared Babel parser configuration ─────────────────────────────────────────\n\n/**\n * Babel parser options covering the superset of syntaxes used across all\n * supported frameworks (React / Vue / Svelte / Angular / …).\n */\nexport const BABEL_PARSER_OPTIONS: NonNullable<TransformOptions['parserOpts']> =\n  {\n    sourceType: 'module',\n    allowImportExportEverywhere: true,\n    plugins: [\n      'typescript',\n      'jsx',\n      'decorators-legacy',\n      'classProperties',\n      'objectRestSpread',\n      'asyncGenerators',\n      'functionBind',\n      'exportDefaultFrom',\n      'exportNamespaceFrom',\n      'dynamicImport',\n      'nullishCoalescingOperator',\n      'optionalChaining',\n    ],\n  };\n\n/**\n * Fast pre-check: matches files that could contain native intlayer calls\n * (`useIntlayer` / `getIntlayer`). Used by the optimize/transform pass, which\n * only rewrites native calls.\n */\nexport const INTLAYER_USAGE_REGEX = /\\b(use|get)Intlayer\\b/;\n\n/**\n * Fast pre-check: matches files that could contain compat-adapter namespace\n * callers (`useTranslation`, `useTranslations`, `getTranslations`, `getFixedT`,\n * `useI18n`). These are analysed for field usage (pruning) but never rewritten.\n */\nexport const COMPAT_USAGE_REGEX =\n  /\\b(useTranslation|useTranslations|getTranslations|getFixedT|useI18n)\\b/;\n\n/**\n * Fast pre-check for the usage-analysis phase: matches files containing either\n * native intlayer calls or compat-adapter namespace callers.\n */\nexport const INTLAYER_OR_COMPAT_USAGE_REGEX =\n  /\\b(useIntlayer|getIntlayer|useTranslation|useTranslations|getTranslations|getFixedT|useI18n)\\b/;\n\n/**\n * Matches source files that are valid targets for usage analysis and Babel\n * transformation. Excludes sourcemap files, declaration files, and other\n * non-source extensions.\n */\nexport const SOURCE_FILE_REGEX = /\\.(tsx?|[mc]?jsx?|vue|svelte|astro)$/;\n\n// ── High-level transformer functions ──────────────────────────────────────────\n\n/**\n * Runs the usage-analysis Babel plugin on a single JS/TS code string.\n *\n * This is analysis-only: the transformed code output is discarded.\n * Throws if Babel cannot parse the content.\n */\nconst analyzeScriptContent = async (\n  scriptContent: string,\n  sourceFilePath: string,\n  pruneContext: PruneContext,\n  compatCallers?: CompatCallerConfig[]\n): Promise<void> => {\n  await transformAsync(scriptContent, {\n    filename: sourceFilePath,\n    plugins: [makeUsageAnalyzerBabelPlugin(pruneContext, { compatCallers })],\n    parserOpts: BABEL_PARSER_OPTIONS,\n    ast: false,\n    code: false, // analysis only – no output needed\n  });\n};\n\n/**\n * Runs the usage-analysis Babel plugin on a source file, accumulating\n * field-usage data into `pruneContext`.\n *\n * For Vue / Svelte SFC files, script blocks are extracted before analysis so\n * Babel does not attempt to parse the full SFC syntax (templates, styles, …).\n * For plain JS/TS files, the whole file content is analysed directly.\n *\n * This is analysis-only: the transformed code output is discarded.\n * Throws if Babel cannot parse the file (caller should handle and flag\n * `pruneContext.hasUnparsableSourceFiles`).\n */\nexport const analyzeFieldUsageInFile = async (\n  sourceFilePath: string,\n  code: string,\n  pruneContext: PruneContext,\n  compatCallers?: CompatCallerConfig[]\n): Promise<void> => {\n  const scriptBlocks = extractScriptBlocks(sourceFilePath, code);\n\n  // For SFC files (Vue / Svelte): scriptBlocks[0].contentStartOffset > 0\n  // means we extracted actual <script> tags from the file.\n  // For plain JS/TS: extractScriptBlocks returns the whole file as a single\n  // block with offset 0, so we fall through to the same path.\n  for (const block of scriptBlocks) {\n    if (!INTLAYER_OR_COMPAT_USAGE_REGEX.test(block.content)) continue;\n    await analyzeScriptContent(\n      block.content,\n      sourceFilePath,\n      pruneContext,\n      compatCallers\n    );\n  }\n};\n\n/**\n * Applies field-renaming to a single JS/TS code string (not an SFC).\n *\n * Returns the renamed code string, or `null` if nothing changed or if\n * Babel failed to parse the input (caller should fall back to original code).\n */\nexport const renameFieldsInCode = async (\n  code: string,\n  sourceFilePath: string,\n  pruneContext: PruneContext\n): Promise<string | null> => {\n  try {\n    const result = await transformAsync(code, {\n      filename: sourceFilePath,\n      plugins: [makeFieldRenameBabelPlugin(pruneContext)],\n      parserOpts: BABEL_PARSER_OPTIONS,\n      ast: false,\n    });\n    return result?.code ?? null;\n  } catch {\n    return null; // parse failure – caller falls back to original code\n  }\n};\n\n/**\n * Applies field-renaming to a source file, correctly handling both plain\n * JS/TS files and SFC files (Vue / Svelte) by operating on each script block\n * individually and injecting the results back into the original source.\n *\n * Returns the renamed code string, or `null` if nothing changed.\n */\nexport const renameFieldsInSourceFile = async (\n  sourceFilePath: string,\n  code: string,\n  pruneContext: PruneContext\n): Promise<string | null> => {\n  if (pruneContext.dictionaryKeyToFieldRenameMap.size === 0) return null;\n  if (!INTLAYER_USAGE_REGEX.test(code)) return null;\n\n  const scriptBlocks = extractScriptBlocks(sourceFilePath, code);\n\n  const isSFC =\n    scriptBlocks.length > 0 &&\n    ((scriptBlocks[0]?.contentStartOffset ?? 0) > 0 || scriptBlocks.length > 1);\n\n  if (isSFC) {\n    // Raw SFC: rename each script block individually and inject back.\n    const modifications: Array<{\n      block: (typeof scriptBlocks)[number];\n      modifiedContent: string;\n    }> = [];\n\n    for (const block of scriptBlocks) {\n      if (!INTLAYER_USAGE_REGEX.test(block.content)) continue;\n\n      const renamedCode = await renameFieldsInCode(\n        block.content,\n        sourceFilePath,\n        pruneContext\n      );\n      if (renamedCode && renamedCode !== block.content) {\n        modifications.push({ block, modifiedContent: renamedCode });\n      }\n    }\n\n    if (modifications.length === 0) return null;\n    return injectScriptBlocks(code, modifications);\n  }\n\n  // Plain JS/TS or compiled SFC (no block delimiters) – rename the whole file.\n  return renameFieldsInCode(code, sourceFilePath, pruneContext);\n};\n\n/**\n * Runs the intlayer optimize Babel plugin on a source file, transforming\n * `useIntlayer('key')` / `getIntlayer('key')` calls into `useDictionary(_hash)`\n * / `getDictionary(_hash)` and injecting the corresponding dictionary imports.\n *\n * Returns `{ code, map }` on success, or `null` if the transformation produced\n * no output.\n */\nexport const optimizeSourceFile = async (\n  code: string,\n  sourceFilePath: string,\n  options: OptimizePluginOptions\n): Promise<{\n  code: string;\n  map: string | object | null | undefined;\n} | null> => {\n  const result = await transformAsync(code, {\n    filename: sourceFilePath,\n    plugins: [[intlayerOptimizeBabelPlugin, options]],\n    parserOpts: BABEL_PARSER_OPTIONS,\n  });\n\n  if (!result?.code) return null;\n\n  return { code: result.code, map: result.map };\n};\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,uBACX;CACE,YAAY;CACZ,6BAA6B;CAC7B,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;;;;;AAOF,MAAa,uBAAuB;;;;;;AAOpC,MAAa,qBACX;;;;;AAMF,MAAa,iCACX;;;;;;AAOF,MAAa,oBAAoB;;;;;;;AAUjC,MAAM,uBAAuB,OAC3B,eACA,gBACA,cACA,kBACkB;CAClB,MAAM,eAAe,eAAe;EAClC,UAAU;EACV,SAAS,CAAC,6BAA6B,cAAc,EAAE,cAAc,CAAC,CAAC;EACvE,YAAY;EACZ,KAAK;EACL,MAAM;CACR,CAAC;AACH;;;;;;;;;;;;;AAcA,MAAa,0BAA0B,OACrC,gBACA,MACA,cACA,kBACkB;CAClB,MAAM,eAAe,oBAAoB,gBAAgB,IAAI;CAM7D,KAAK,MAAM,SAAS,cAAc;EAChC,IAAI,CAAC,+BAA+B,KAAK,MAAM,OAAO,GAAG;EACzD,MAAM,qBACJ,MAAM,SACN,gBACA,cACA,aACF;CACF;AACF;;;;;;;AAQA,MAAa,qBAAqB,OAChC,MACA,gBACA,iBAC2B;CAC3B,IAAI;EAOF,QAAO,MANc,eAAe,MAAM;GACxC,UAAU;GACV,SAAS,CAAC,2BAA2B,YAAY,CAAC;GAClD,YAAY;GACZ,KAAK;EACP,CAAC,IACc,QAAQ;CACzB,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;AASA,MAAa,2BAA2B,OACtC,gBACA,MACA,iBAC2B;CAC3B,IAAI,aAAa,8BAA8B,SAAS,GAAG,OAAO;CAClE,IAAI,CAAC,qBAAqB,KAAK,IAAI,GAAG,OAAO;CAE7C,MAAM,eAAe,oBAAoB,gBAAgB,IAAI;CAM7D,IAHE,aAAa,SAAS,OACpB,aAAa,IAAI,sBAAsB,KAAK,KAAK,aAAa,SAAS,IAEhE;EAET,MAAM,gBAGD,CAAC;EAEN,KAAK,MAAM,SAAS,cAAc;GAChC,IAAI,CAAC,qBAAqB,KAAK,MAAM,OAAO,GAAG;GAE/C,MAAM,cAAc,MAAM,mBACxB,MAAM,SACN,gBACA,YACF;GACA,IAAI,eAAe,gBAAgB,MAAM,SACvC,cAAc,KAAK;IAAE;IAAO,iBAAiB;GAAY,CAAC;EAE9D;EAEA,IAAI,cAAc,WAAW,GAAG,OAAO;EACvC,OAAO,mBAAmB,MAAM,aAAa;CAC/C;CAGA,OAAO,mBAAmB,MAAM,gBAAgB,YAAY;AAC9D;;;;;;;;;AAUA,MAAa,qBAAqB,OAChC,MACA,gBACA,YAIW;CACX,MAAM,SAAS,MAAM,eAAe,MAAM;EACxC,UAAU;EACV,SAAS,CAAC,CAAC,6BAA6B,OAAO,CAAC;EAChD,YAAY;CACd,CAAC;CAED,IAAI,CAAC,QAAQ,MAAM,OAAO;CAE1B,OAAO;EAAE,MAAM,OAAO;EAAM,KAAK,OAAO;CAAI;AAC9C"}

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

@@ -101,19 +101,87 @@ declare const createPruneContext: () => PruneContext;
 /** Canonical intlayer caller names that trigger usage analysis. */
 declare const INTLAYER_CALLER_NAMES: readonly ["useIntlayer", "getIntlayer"];
 type IntlayerCallerName = (typeof INTLAYER_CALLER_NAMES)[number];
+/**
+ * Describes how a compat-adapter "namespace caller" exposes the dictionary key
+ * (namespace) and the translation function `t`.
+ *
+ * Compat adapters (`@intlayer/react-i18next`, `@intlayer/next-intl`, …) expose
+ * the original i18n library API while delegating to intlayer under the hood.
+ * Their call sites look like:
+ *
+ *   const { t } = useTranslation('about');   t('counter.label')
+ *   const t     = useTranslations('about');  t('counter.label')
+ *   const t     = await getTranslations('about');
+ *   const t     = i18n.getFixedT(null, 'about', 'counter');
+ *   const { t } = useI18n({ namespace: 'about' });
+ *
+ * The dictionary key is the *namespace* argument and the consumed top-level
+ * field is the **first segment** of every dot-path passed to `t()` (or the
+ * first segment of `keyPrefix` when one is supplied).
+ */
+type CompatNamespaceSource = /** Namespace is a positional argument (string literal or `{ namespace }`). */{
+  from: 'argument';
+  index: number;
+} /** Namespace is a property of an options object argument. */ | {
+  from: 'option';
+  argumentIndex: number;
+  property: string;
+};
+/**
+ * Configuration entry for a single compat namespace caller.
+ */
+type CompatCallerConfig = {
+  /** The imported (or method) function name, e.g. `'useTranslation'`. */callerName: string;
+  /**
+   * Module specifiers from which `callerName` must be imported to be treated as
+   * a compat caller. Includes both the original library names and their
+   * `@intlayer/*` adapter equivalents, because the bundler aliases the former
+   * to the latter but user source code may import either.
+   *
+   * Ignored when `matchAsMethod` is `true`.
+   */
+  importSources: string[];
+  /**
+   * When `true`, the caller is matched by method name on any object
+   * (`x.getFixedT(...)`) without an import check. Used for `i18next` instance
+   * methods that are never imported as named specifiers.
+   */
+  matchAsMethod?: boolean; /** How the dictionary key (namespace) is read from the call arguments. */
+  namespace: CompatNamespaceSource;
+  /**
+   * Optional location of a `keyPrefix` that prefixes every `t()` path. When a
+   * static prefix is present, the only consumed top-level field is the first
+   * segment of the prefix.
+   */
+  keyPrefix?: CompatNamespaceSource; /** How the translation function is obtained from the call result. */
+  translationFunction: 'return-value' | 'destructured-t';
+};
+/**
+ * Default registry of compat namespace callers, covering every first-party
+ * `@intlayer/*` adapter package and its underlying i18n library.
+ */
+declare const DEFAULT_COMPAT_CALLERS: CompatCallerConfig[];
 /**
  * Creates a Babel plugin that traverses source files and records which
- * top-level dictionary fields each `useIntlayer` / `getIntlayer` call-site
- * accesses. Results are accumulated into `pruneContext`.
+ * top-level dictionary fields each `useIntlayer` / `getIntlayer` call-site —
+ * and each configured compat namespace caller — accesses. Results are
+ * accumulated into `pruneContext`.
  *
  * This plugin is analysis-only: it does not transform the code (`code: false`
  * should be passed to `transformAsync` when using it).
+ *
+ * @param pruneContext - Shared mutable state written by this plugin.
+ * @param options      - Optional overrides. `compatCallers` defaults to
+ *                       {@link DEFAULT_COMPAT_CALLERS}; pass `[]` to disable
+ *                       compat-adapter analysis entirely.
  */
-declare const makeUsageAnalyzerBabelPlugin: (pruneContext: PruneContext) => ({
+declare const makeUsageAnalyzerBabelPlugin: (pruneContext: PruneContext, options?: {
+  compatCallers?: CompatCallerConfig[];
+}) => ({
   types: babelTypes
 }: {
   types: typeof BabelTypes;
 }) => PluginObj;
 //#endregion
-export { DictionaryFieldUsage, INTLAYER_CALLER_NAMES, IntlayerCallerName, NestedRenameEntry, NestedRenameMap, PruneContext, createPruneContext, makeUsageAnalyzerBabelPlugin };
+export { CompatCallerConfig, CompatNamespaceSource, DEFAULT_COMPAT_CALLERS, DictionaryFieldUsage, INTLAYER_CALLER_NAMES, IntlayerCallerName, NestedRenameEntry, NestedRenameMap, PruneContext, createPruneContext, makeUsageAnalyzerBabelPlugin };
 //# sourceMappingURL=babel-plugin-intlayer-usage-analyzer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"babel-plugin-intlayer-usage-analyzer.d.ts","names":[],"sources":["../../src/babel-plugin-intlayer-usage-analyzer.ts"],"mappings":";;;;;;AAYA;;;;AAAsC;KAA1B,oBAAA,GAAuB,GAAG;;;;;;;;KAS1B,iBAAA;EACV,SAAA;EACA,QAAA,EAAU,eAAe;AAAA;;KAIf,eAAA,GAAkB,GAAG,SAAS,iBAAA;AAS1C;;;;;;;AAAA,KAAY,YAAA;EAiCqB;;;;;EA3B/B,4BAAA,EAA8B,GAAA,SAAY,oBAAA;EA+Db;;;;EAzD7B,yBAAA,EAA2B,GAAA;EAAA;;;;;EAO3B,wBAAA;EAc2C;;;;;EAP3C,mCAAA,EAAqC,GAAA;EA2CrC;;;;;EApCA,6BAAA,EAA+B,GAAA,SAAY,eAAA;EA0ChC;;;;AAYX;AAKF;;;EAjDE,sCAAA,EAAwC,GAAA,SAAY,GAAA;EAiDsB;AAC5E;;;;AAA8D;AA8Y9D;;;;;;EAlbE,+BAAA,EAAiC,GAAA;EAshB/B;;;;;;;;;;EA1gBF,wBAAA,EAA0B,GAAA;IAEtB,YAAA;IAAsB,aAAA;EAAA;AAAA;AAAA,cAIf,kBAAA,QAAyB,YAYpC;;cAKW,qBAAA;AAAA,KACD,kBAAA,WAA6B,qBAAqB;;;;;;;;;cA8YjD,4BAAA,GACV,YAAA,EAAc,YAAA;EACd,KAAA,EAAA;AAAA;EAAyB,KAAA,SAAc,UAAA;AAAA,MAAe,SAAA"}
+{"version":3,"file":"babel-plugin-intlayer-usage-analyzer.d.ts","names":[],"sources":["../../src/babel-plugin-intlayer-usage-analyzer.ts"],"mappings":";;;;;;AAYA;;;;AAAsC;KAA1B,oBAAA,GAAuB,GAAG;;;;;;;;KAS1B,iBAAA;EACV,SAAA;EACA,QAAA,EAAU,eAAe;AAAA;;KAIf,eAAA,GAAkB,GAAG,SAAS,iBAAA;AAS1C;;;;;;;AAAA,KAAY,YAAA;EAiCqB;;;;;EA3B/B,4BAAA,EAA8B,GAAA,SAAY,oBAAA;EA+Db;;;;EAzD7B,yBAAA,EAA2B,GAAA;EAAA;;;;;EAO3B,wBAAA;EAc2C;;;;;EAP3C,mCAAA,EAAqC,GAAA;EA2CrC;;;;;EApCA,6BAAA,EAA+B,GAAA,SAAY,eAAA;EA0ChC;;;;AAYX;AAKF;;;EAjDE,sCAAA,EAAwC,GAAA,SAAY,GAAA;EAiDsB;AAC5E;;;;AAA8D;AAsB9D;;;;;;EA1DE,+BAAA,EAAiC,GAAA;EA8Db;;;AAA+B;AAKrD;;;;;;EAvDE,wBAAA,EAA0B,GAAA;IAEtB,YAAA;IAAsB,aAAA;EAAA;AAAA;AAAA,cAIf,kBAAA,QAAyB,YAYpC;;cAKW,qBAAA;AAAA,KACD,kBAAA,WAA6B,qBAAqB;;;;AAiEP;AA2vBvD;;;;;;;;;;;;;;KAtyBY,qBAAA;EAEN,IAAA;EAAkB,KAAA;AAAA;EAElB,IAAA;EAAgB,aAAA;EAAuB,QAAA;AAAA;;;;KAKjC,kBAAA;yEAEV,UAAA;;;;;;;;;EASA,aAAA;;;;;;EAMA,aAAA;EAEA,SAAA,EAAW,qBAAA;;;;;;EAMX,SAAA,GAAY,qBAAqB;EAEjC,mBAAA;AAAA;;;;;cAOW,sBAAA,EAAwB,kBAAkB;;;;;;;;;;;;;;;cA2vB1C,4BAAA,GAET,YAAA,EAAc,YAAA,EACd,OAAA;EAAY,aAAA,GAAgB,kBAAA;AAAA;EAE7B,KAAA,EAAA;AAAA;EAAyB,KAAA,SAAc,UAAA;AAAA,MAAe,SAAA"}

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 import { ATTRIBUTES_TO_EXTRACT, PackageName, SERVER_CAPABLE_PACKAGES, packageList } from "./extractContent/utils/constants.js";
 import { ExtractPluginOptions, ExtractResult, intlayerExtractBabelPlugin } from "./babel-plugin-intlayer-extract.js";
-import { DictionaryFieldUsage, INTLAYER_CALLER_NAMES, IntlayerCallerName, NestedRenameEntry, NestedRenameMap, PruneContext, createPruneContext, makeUsageAnalyzerBabelPlugin } from "./babel-plugin-intlayer-usage-analyzer.js";
+import { CompatCallerConfig, CompatNamespaceSource, DEFAULT_COMPAT_CALLERS, DictionaryFieldUsage, INTLAYER_CALLER_NAMES, IntlayerCallerName, NestedRenameEntry, NestedRenameMap, PruneContext, createPruneContext, makeUsageAnalyzerBabelPlugin } from "./babel-plugin-intlayer-usage-analyzer.js";
 import { buildNestedRenameMapFromContent, generateShortFieldName, makeFieldRenameBabelPlugin } from "./babel-plugin-intlayer-field-rename.js";
 import { OptimizePluginOptions, intlayerOptimizeBabelPlugin } from "./babel-plugin-intlayer-optimize.js";
 import { mergeWithExistingMultilingualDictionary, mergeWithExistingPerLocaleDictionary, writeContentHelper } from "./extractContent/contentWriter.js";
@@ -13,5 +13,5 @@ import { ExtractIntlayerOptions, extractContent, extractContentSync } from "./ex
 import { ScriptBlock, extractScriptBlocks, injectScriptBlocks } from "./extractScriptBlocks.js";
 import { CompilerMode, getExtractPluginOptions } from "./getExtractPluginOptions.js";
 import { getOptimizePluginOptions } from "./getOptimizePluginOptions.js";
-import { BABEL_PARSER_OPTIONS, INTLAYER_USAGE_REGEX, SOURCE_FILE_REGEX, analyzeFieldUsageInFile, optimizeSourceFile, renameFieldsInCode, renameFieldsInSourceFile } from "./transformers.js";
-export { ATTRIBUTES_TO_EXTRACT, BABEL_PARSER_OPTIONS, CompilerMode, DictionaryFieldUsage, ExtractDictionaryInfoOptions, ExtractIntlayerOptions, ExtractPluginOptions, ExtractResult, INTLAYER_CALLER_NAMES, INTLAYER_USAGE_REGEX, IntlayerCallerName, NestedRenameEntry, NestedRenameMap, OptimizePluginOptions, PackageName, PruneContext, ResolveContentFilePaths, SERVER_CAPABLE_PACKAGES, SOURCE_FILE_REGEX, ScriptBlock, analyzeFieldUsageInFile, buildNestedRenameMapFromContent, createPruneContext, detectPackageName, extractContent, extractContentSync, extractDictionaryInfo, extractDictionaryKey, extractDictionaryKeyFromPath, extractScriptBlocks, generateKey, generateShortFieldName, getComponentName, getExtractPluginOptions, getOptimizePluginOptions, getOutput, injectScriptBlocks, intlayerExtractBabelPlugin, intlayerOptimizeBabelPlugin, makeFieldRenameBabelPlugin, makeUsageAnalyzerBabelPlugin, mergeWithExistingMultilingualDictionary, mergeWithExistingPerLocaleDictionary, optimizeSourceFile, packageList, renameFieldsInCode, renameFieldsInSourceFile, resolveContentFilePaths, writeContentHelper };
+import { BABEL_PARSER_OPTIONS, COMPAT_USAGE_REGEX, INTLAYER_OR_COMPAT_USAGE_REGEX, INTLAYER_USAGE_REGEX, SOURCE_FILE_REGEX, analyzeFieldUsageInFile, optimizeSourceFile, renameFieldsInCode, renameFieldsInSourceFile } from "./transformers.js";
+export { ATTRIBUTES_TO_EXTRACT, BABEL_PARSER_OPTIONS, COMPAT_USAGE_REGEX, CompatCallerConfig, CompatNamespaceSource, CompilerMode, DEFAULT_COMPAT_CALLERS, DictionaryFieldUsage, ExtractDictionaryInfoOptions, ExtractIntlayerOptions, ExtractPluginOptions, ExtractResult, INTLAYER_CALLER_NAMES, INTLAYER_OR_COMPAT_USAGE_REGEX, INTLAYER_USAGE_REGEX, IntlayerCallerName, NestedRenameEntry, NestedRenameMap, OptimizePluginOptions, PackageName, PruneContext, ResolveContentFilePaths, SERVER_CAPABLE_PACKAGES, SOURCE_FILE_REGEX, ScriptBlock, analyzeFieldUsageInFile, buildNestedRenameMapFromContent, createPruneContext, detectPackageName, extractContent, extractContentSync, extractDictionaryInfo, extractDictionaryKey, extractDictionaryKeyFromPath, extractScriptBlocks, generateKey, generateShortFieldName, getComponentName, getExtractPluginOptions, getOptimizePluginOptions, getOutput, injectScriptBlocks, intlayerExtractBabelPlugin, intlayerOptimizeBabelPlugin, makeFieldRenameBabelPlugin, makeUsageAnalyzerBabelPlugin, mergeWithExistingMultilingualDictionary, mergeWithExistingPerLocaleDictionary, optimizeSourceFile, packageList, renameFieldsInCode, renameFieldsInSourceFile, resolveContentFilePaths, writeContentHelper };

package/dist/types/transformers.d.ts

@@ -1,4 +1,4 @@
-import { PruneContext } from "./babel-plugin-intlayer-usage-analyzer.js";
+import { CompatCallerConfig, PruneContext } from "./babel-plugin-intlayer-usage-analyzer.js";
 import { OptimizePluginOptions } from "./babel-plugin-intlayer-optimize.js";
 import { TransformOptions } from "@babel/core";
 
@@ -9,10 +9,22 @@ import { TransformOptions } from "@babel/core";
  */
 declare const BABEL_PARSER_OPTIONS: NonNullable<TransformOptions['parserOpts']>;
 /**
- * Fast pre-check: matches files that could contain intlayer calls.
- * Avoids running Babel on files with no relevant identifiers.
+ * Fast pre-check: matches files that could contain native intlayer calls
+ * (`useIntlayer` / `getIntlayer`). Used by the optimize/transform pass, which
+ * only rewrites native calls.
  */
 declare const INTLAYER_USAGE_REGEX: RegExp;
+/**
+ * Fast pre-check: matches files that could contain compat-adapter namespace
+ * callers (`useTranslation`, `useTranslations`, `getTranslations`, `getFixedT`,
+ * `useI18n`). These are analysed for field usage (pruning) but never rewritten.
+ */
+declare const COMPAT_USAGE_REGEX: RegExp;
+/**
+ * Fast pre-check for the usage-analysis phase: matches files containing either
+ * native intlayer calls or compat-adapter namespace callers.
+ */
+declare const INTLAYER_OR_COMPAT_USAGE_REGEX: RegExp;
 /**
  * Matches source files that are valid targets for usage analysis and Babel
  * transformation. Excludes sourcemap files, declaration files, and other
@@ -31,7 +43,7 @@ declare const SOURCE_FILE_REGEX: RegExp;
  * Throws if Babel cannot parse the file (caller should handle and flag
  * `pruneContext.hasUnparsableSourceFiles`).
  */
-declare const analyzeFieldUsageInFile: (sourceFilePath: string, code: string, pruneContext: PruneContext) => Promise<void>;
+declare const analyzeFieldUsageInFile: (sourceFilePath: string, code: string, pruneContext: PruneContext, compatCallers?: CompatCallerConfig[]) => Promise<void>;
 /**
  * Applies field-renaming to a single JS/TS code string (not an SFC).
  *
@@ -60,5 +72,5 @@ declare const optimizeSourceFile: (code: string, sourceFilePath: string, options
   map: string | object | null | undefined;
 } | null>;
 //#endregion
-export { BABEL_PARSER_OPTIONS, INTLAYER_USAGE_REGEX, SOURCE_FILE_REGEX, analyzeFieldUsageInFile, optimizeSourceFile, renameFieldsInCode, renameFieldsInSourceFile };
+export { BABEL_PARSER_OPTIONS, COMPAT_USAGE_REGEX, INTLAYER_OR_COMPAT_USAGE_REGEX, INTLAYER_USAGE_REGEX, SOURCE_FILE_REGEX, analyzeFieldUsageInFile, optimizeSourceFile, renameFieldsInCode, renameFieldsInSourceFile };
 //# sourceMappingURL=transformers.d.ts.map

package/dist/types/transformers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformers.d.ts","names":[],"sources":["../../src/transformers.ts"],"mappings":";;;;;;;AAkBA;;cAAa,oBAAA,EAAsB,WAAW,CAAC,gBAAA;;AAAgB;AAwB/D;;cAAa,oBAAA,EAAoB,MAA0B;;AAAA;AAO3D;;;cAAa,iBAAA,EAAiB,MAAyC;AAAA;AAoCvE;;;;;;;;;;AAIU;AAxC6D,cAoC1D,uBAAA,GACX,cAAA,UACA,IAAA,UACA,YAAA,EAAc,YAAA,KACb,OAAO;;;;;;;cAmBG,kBAAA,GACX,IAAA,UACA,cAAA,UACA,YAAA,EAAc,YAAA,KACb,OAAO;;;AAAA;AAqBV;;;;cAAa,wBAAA,GACX,cAAA,UACA,IAAA,UACA,YAAA,EAAc,YAAA,KACb,OAAO;;;;;;AAAA;AA8CV;;cAAa,kBAAA,GACX,IAAA,UACA,cAAA,UACA,OAAA,EAAS,qBAAA,KACR,OAAO;EACR,IAAA;EACA,GAAA;AAAA"}
+{"version":3,"file":"transformers.d.ts","names":[],"sources":["../../src/transformers.ts"],"mappings":";;;;;;;AAmBA;;cAAa,oBAAA,EAAsB,WAAW,CAAC,gBAAA;;AAAgB;AAyB/D;;;cAAa,oBAAA,EAAoB,MAA0B;AAAA;AAO3D;;;;AAP2D,cAO9C,kBAAA,EAAkB,MAC2C;AAM1E;;;;AAAA,cAAa,8BAAA,EAA8B,MACuD;AAOlG;;;;AAAuE;AAAvE,cAAa,iBAAA,EAAiB,MAAyC;;;;;;;;;;;;;cAqC1D,uBAAA,GACX,cAAA,UACA,IAAA,UACA,YAAA,EAAc,YAAA,EACd,aAAA,GAAgB,kBAAA,OACf,OAAA;;;AAAO;AAwBV;;;cAAa,kBAAA,GACX,IAAA,UACA,cAAA,UACA,YAAA,EAAc,YAAA,KACb,OAAO;;;;;;;AAAA;cAqBG,wBAAA,GACX,cAAA,UACA,IAAA,UACA,YAAA,EAAc,YAAA,KACb,OAAO;;;;;;;;;cA8CG,kBAAA,GACX,IAAA,UACA,cAAA,UACA,OAAA,EAAS,qBAAA,KACR,OAAO;EACR,IAAA;EACA,GAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/babel",
-  "version": "8.12.1",
+  "version": "8.12.2",
   "private": false,
   "description": "A Babel plugin for Intlayer that transforms declaration files and provides internationalization features during the build process according to the Intlayer configuration.",
   "keywords": [
@@ -81,18 +81,18 @@
     "@babel/plugin-syntax-jsx": "7.29.7",
     "@babel/traverse": "7.29.7",
     "@babel/types": "7.29.7",
-    "@intlayer/chokidar": "8.12.1",
-    "@intlayer/config": "8.12.1",
-    "@intlayer/core": "8.12.1",
-    "@intlayer/dictionaries-entry": "8.12.1",
-    "@intlayer/types": "8.12.1",
-    "@intlayer/unmerged-dictionaries-entry": "8.12.1",
+    "@intlayer/chokidar": "8.12.2",
+    "@intlayer/config": "8.12.2",
+    "@intlayer/core": "8.12.2",
+    "@intlayer/dictionaries-entry": "8.12.2",
+    "@intlayer/types": "8.12.2",
+    "@intlayer/unmerged-dictionaries-entry": "8.12.2",
     "@types/babel__core": "7.20.5",
     "@types/babel__generator": "7.27.0",
     "@types/babel__traverse": "7.28.0"
   },
   "devDependencies": {
-    "@babel/plugin-syntax-jsx": "^7.29.7",
+    "@babel/plugin-syntax-jsx": "7.29.7",
     "@types/node": "25.9.1",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
@@ -104,8 +104,8 @@
     "vitest": "4.1.8"
   },
   "peerDependencies": {
-    "@intlayer/svelte-compiler": "8.12.1",
-    "@intlayer/vue-compiler": "8.12.1"
+    "@intlayer/svelte-compiler": "8.12.2",
+    "@intlayer/vue-compiler": "8.12.2"
   },
   "peerDependenciesMeta": {
     "@intlayer/svelte-compiler": {