@intlayer/config 9.4.4 → 9.5.0

package/README.md

@@ -69,8 +69,6 @@ With **per-locale content files**, **TypeScript autocompletion**, **tree-shakabl
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **Interoperability**<br><br>Allow interoperability with react-i18next, next-i18next, next-intl, react-intl, vue-i18n. <br><br> - [Intlayer and react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer and next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer and next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer and vue-i18n](https://intlayer.org/blog/intlayer-with-vue-i18n) <br> - [Intlayer compat adapters](https://intlayer.org/doc/compatibility) |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **Performances & Benchmark**<br><br>Uses advanced tree-shaking and dynamic loading to boost performances and keep the solution as light as possible. <br><br> - [Performances & Benchmark](https://intlayer.org/doc/benchmark)                                                                                                                                                                                                                                                                                                                        |
 
----
-
 ## 📦 Installation
 
 Start your journey with Intlayer today and experience a smoother, more powerful approach to internationalization.

package/dist/cjs/bundle/index.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_utils_alias = require('../utils/alias.cjs');
 const require_configFile_getConfiguration = require('../configFile/getConfiguration.cjs');
-const require_bundle_logBundle = require('./logBundle.cjs');
 const require_envVars_envVars = require('../envVars/envVars.cjs');
+const require_bundle_logBundle = require('./logBundle.cjs');
 let node_path = require("node:path");
 let node_fs_promises = require("node:fs/promises");
 let _intlayer_types_package_json = require("@intlayer/types/package.json");

package/dist/cjs/callers/compat/lingui.cjs

@@ -3,9 +3,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 /**
 * Lingui — `@intlayer/lingui` compat adapter.
 *
-* Lingui is a single-catalog library: every message lives in the `messages`
-* dictionary and catalog keys are flat (a dotted id such as
-* `results-table.bundleSize` is one literal key, not a nested path).
+* Lingui is a single-catalog library: the namespace lives *inside* the message
+* id rather than in the file layout, so `i18n._('footer.github')` names both
+* the group (`footer`) and the field (`github`).
+*
+* The adapter therefore addresses lingui catalogs by the id's first dot-segment,
+* which lets a catalog split with `syncJSON({ splitKeys: 'key-prefix' })` resolve
+* one small dictionary per call site instead of the whole catalog. None of these
+* callers carries a namespace argument, so the optimize passes leave them to the
+* runtime resolver and only the usage analysis reads the ids.
 *
 * `t` and `_` are generic names, so all lingui callers require an import from
 * a lingui module to participate in matching — this avoids false positives on
@@ -26,13 +32,9 @@ const LINGUI_CALLERS = [
 		callerName: "useLingui",
 		library: "lingui",
 		importSources: LINGUI_IMPORT_SOURCES,
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "destructured-t",
-		staticReplacement: "useDictionary",
-		dynamicReplacement: "useDictionaryDynamic"
+		namespaceSources: [],
+		allowRootScope: true,
+		translationFunction: "destructured-t"
 	},
 	{
 		callerName: "_",
@@ -40,12 +42,8 @@ const LINGUI_CALLERS = [
 		importSources: LINGUI_IMPORT_SOURCES,
 		requiresImport: true,
 		matchAsMethod: true,
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "self",
-		flatKey: true
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
 	},
 	{
 		callerName: "t",
@@ -54,12 +52,8 @@ const LINGUI_CALLERS = [
 		requiresImport: true,
 		matchAsMethod: true,
 		matchAsTaggedTemplate: true,
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "self",
-		flatKey: true
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
 	},
 	{
 		callerName: "Trans",
@@ -67,12 +61,8 @@ const LINGUI_CALLERS = [
 		importSources: LINGUI_IMPORT_SOURCES,
 		requiresImport: true,
 		jsxIdAttribute: "id",
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "self",
-		flatKey: true
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
 	}
 ];
 

package/dist/cjs/callers/compat/lingui.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"lingui.cjs","names":[],"sources":["../../../../src/callers/compat/lingui.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * Lingui — `@intlayer/lingui` compat adapter.\n *\n * Lingui is a single-catalog library: every message lives in the `messages`\n * dictionary and catalog keys are flat (a dotted id such as\n * `results-table.bundleSize` is one literal key, not a nested path).\n *\n * `t` and `_` are generic names, so all lingui callers require an import from\n * a lingui module to participate in matching — this avoids false positives on\n * unrelated `t()` helpers.\n *\n * Mirrors `compat/lingui/src/plugin/index.ts`.\n */\nconst LINGUI_IMPORT_SOURCES = [\n  '@lingui/core',\n  '@lingui/react',\n  '@lingui/macro',\n  '@lingui/core/macro',\n  '@lingui/react/macro',\n  '@intlayer/lingui',\n];\n\nexport const LINGUI_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useLingui',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    // `const { i18n, t, _ } = useLingui()` — single-catalog hook, no\n    // namespace argument: every call reads the `messages` dictionary.\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'destructured-t',\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: '_',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n._('id')` and the destructured `const { _ } = useLingui()` form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'self',\n    flatKey: true,\n  },\n  {\n    callerName: 't',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n.t('id')`, `t({ id: 'id' })` and the macro tagged template ``t`…` ``.\n    matchAsMethod: true,\n    matchAsTaggedTemplate: true,\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'self',\n    flatKey: true,\n  },\n  {\n    callerName: 'Trans',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // <Trans id=\"home.title\" message=\"Welcome\" />\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'self',\n    flatKey: true,\n  },\n];\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,iBAAqC;CAChD;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EAGf,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,mBAAmB;EACnB,oBAAoB;CACtB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,SAAS;CACX;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,uBAAuB;EACvB,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,SAAS;CACX;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,gBAAgB;EAChB,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,SAAS;CACX;AACF"}
+{"version":3,"file":"lingui.cjs","names":[],"sources":["../../../../src/callers/compat/lingui.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * Lingui — `@intlayer/lingui` compat adapter.\n *\n * Lingui is a single-catalog library: the namespace lives *inside* the message\n * id rather than in the file layout, so `i18n._('footer.github')` names both\n * the group (`footer`) and the field (`github`).\n *\n * The adapter therefore addresses lingui catalogs by the id's first dot-segment,\n * which lets a catalog split with `syncJSON({ splitKeys: 'key-prefix' })` resolve\n * one small dictionary per call site instead of the whole catalog. None of these\n * callers carries a namespace argument, so the optimize passes leave them to the\n * runtime resolver and only the usage analysis reads the ids.\n *\n * `t` and `_` are generic names, so all lingui callers require an import from\n * a lingui module to participate in matching — this avoids false positives on\n * unrelated `t()` helpers.\n *\n * Mirrors `compat/lingui/src/plugin/index.ts`.\n */\nconst LINGUI_IMPORT_SOURCES = [\n  '@lingui/core',\n  '@lingui/react',\n  '@lingui/macro',\n  '@lingui/core/macro',\n  '@lingui/react/macro',\n  '@intlayer/lingui',\n];\n\nexport const LINGUI_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useLingui',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    // `const { i18n, t, _ } = useLingui()` takes no namespace argument, so the\n    // dictionary is only knowable from the ids passed to the returned\n    // functions — which the usage analysis reads and the optimize passes do not.\n    namespaceSources: [],\n    allowRootScope: true,\n    translationFunction: 'destructured-t',\n  },\n  {\n    callerName: '_',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n._('id')` and the destructured `const { _ } = useLingui()` form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 't',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n.t('id')`, `t({ id: 'id' })` and the macro tagged template ``t`…` ``.\n    matchAsMethod: true,\n    matchAsTaggedTemplate: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 'Trans',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // <Trans id=\"home.title\" message=\"Welcome\" />\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,iBAAqC;CAChD;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EAIf,kBAAkB,CAAC;EACnB,gBAAgB;EAChB,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,uBAAuB;EACvB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,gBAAgB;EAChB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;AACF"}

package/dist/cjs/callers/compat/reactI18next.cjs

@@ -27,6 +27,7 @@ const REACT_I18NEXT_CALLERS = [{
 		property: "keyPrefix"
 	}],
 	translationFunction: "destructured-t",
+	allowRootScope: true,
 	staticReplacement: "useDictionary",
 	dynamicReplacement: "useDictionaryDynamic"
 }, {

package/dist/cjs/callers/compat/reactI18next.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"reactI18next.cjs","names":[],"sources":["../../../../src/callers/compat/reactI18next.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-i18next / next-i18next — `@intlayer/react-i18next` and\n * `@intlayer/next-i18next` compat adapters (next-i18next re-exports the\n * react-i18next hook, so both libraries share the same callers).\n *\n * Mirrors `compat/react-i18next/src/plugin/index.ts` and\n * `compat/next-i18next/src/plugin/index.ts`.\n */\nexport const REACT_I18NEXT_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useTranslation',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    namespaceSources: [{ from: 'argument', index: 0 }],\n    keyPrefixSources: [\n      { from: 'option', argumentIndex: 1, property: 'keyPrefix' },\n    ],\n    translationFunction: 'destructured-t',\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: 'Trans',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    // <Trans ns=\"home\" i18nKey=\"richText\" /> — the namespace attribute is\n    // optional; without it the analyser falls back to the single translator\n    // namespace declared in the same file.\n    jsxIdAttribute: 'i18nKey',\n    jsxNamespaceAttribute: 'ns',\n    namespaceSources: [],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;AAUA,MAAa,wBAA4C,CACvD;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CACA,kBAAkB,CAAC;EAAE,MAAM;EAAY,OAAO;CAAE,CAAC;CACjD,kBAAkB,CAChB;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;CAAY,CAC5D;CACA,qBAAqB;CACrB,mBAAmB;CACnB,oBAAoB;AACtB,GACA;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CAIA,gBAAgB;CAChB,uBAAuB;CACvB,kBAAkB,CAAC;CACnB,qBAAqB;AACvB,CACF"}
+{"version":3,"file":"reactI18next.cjs","names":[],"sources":["../../../../src/callers/compat/reactI18next.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-i18next / next-i18next — `@intlayer/react-i18next` and\n * `@intlayer/next-i18next` compat adapters (next-i18next re-exports the\n * react-i18next hook, so both libraries share the same callers).\n *\n * Mirrors `compat/react-i18next/src/plugin/index.ts` and\n * `compat/next-i18next/src/plugin/index.ts`.\n */\nexport const REACT_I18NEXT_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useTranslation',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    namespaceSources: [{ from: 'argument', index: 0 }],\n    keyPrefixSources: [\n      { from: 'option', argumentIndex: 1, property: 'keyPrefix' },\n    ],\n    translationFunction: 'destructured-t',\n    allowRootScope: true,\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: 'Trans',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    // <Trans ns=\"home\" i18nKey=\"richText\" /> — the namespace attribute is\n    // optional; without it the analyser falls back to the single translator\n    // namespace declared in the same file.\n    jsxIdAttribute: 'i18nKey',\n    jsxNamespaceAttribute: 'ns',\n    namespaceSources: [],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;AAUA,MAAa,wBAA4C,CACvD;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CACA,kBAAkB,CAAC;EAAE,MAAM;EAAY,OAAO;CAAE,CAAC;CACjD,kBAAkB,CAChB;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;CAAY,CAC5D;CACA,qBAAqB;CACrB,gBAAgB;CAChB,mBAAmB;CACnB,oBAAoB;AACtB,GACA;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CAIA,gBAAgB;CAChB,uBAAuB;CACvB,kBAAkB,CAAC;CACnB,qBAAqB;AACvB,CACF"}

package/dist/cjs/callers/compat/reactIntl.cjs

@@ -9,21 +9,32 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 *
 * Mirrors `compat/react-intl/src/plugin/index.ts`.
 */
-const REACT_INTL_CALLERS = [{
-	callerName: "formatMessage",
-	library: "react-intl",
-	importSources: ["react-intl", "@intlayer/react-intl"],
-	matchAsMethod: true,
-	namespaceSources: [{ from: "path-first-segment" }],
-	translationFunction: "self"
-}, {
-	callerName: "FormattedMessage",
-	library: "react-intl",
-	importSources: ["react-intl", "@intlayer/react-intl"],
-	jsxIdAttribute: "id",
-	namespaceSources: [{ from: "path-first-segment" }],
-	translationFunction: "self"
-}];
+const REACT_INTL_CALLERS = [
+	{
+		callerName: "useIntl",
+		library: "react-intl",
+		importSources: ["react-intl", "@intlayer/react-intl"],
+		namespaceSources: [],
+		allowRootScope: true,
+		translationFunction: "destructured-t"
+	},
+	{
+		callerName: "formatMessage",
+		library: "react-intl",
+		importSources: ["react-intl", "@intlayer/react-intl"],
+		matchAsMethod: true,
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
+	},
+	{
+		callerName: "FormattedMessage",
+		library: "react-intl",
+		importSources: ["react-intl", "@intlayer/react-intl"],
+		jsxIdAttribute: "id",
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
+	}
+];
 
 //#endregion
 exports.REACT_INTL_CALLERS = REACT_INTL_CALLERS;

package/dist/cjs/callers/compat/reactIntl.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"reactIntl.cjs","names":[],"sources":["../../../../src/callers/compat/reactIntl.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-intl (FormatJS) — `@intlayer/react-intl` compat adapter.\n *\n * The full dotted message id encodes both the dictionary key and the field\n * path: `formatMessage({ id: 'home.title' })` → dictionary `home`, field\n * `title`.\n *\n * Mirrors `compat/react-intl/src/plugin/index.ts`.\n */\nexport const REACT_INTL_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'formatMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    // Matches both `intl.formatMessage(...)` and the destructured\n    // `const { formatMessage } = useIntl()` identifier form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 'FormattedMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,qBAAyC,CACpD;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,cAAc,sBAAsB;CAGpD,eAAe;CACf,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;CACjD,qBAAqB;AACvB,GACA;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,cAAc,sBAAsB;CACpD,gBAAgB;CAChB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;CACjD,qBAAqB;AACvB,CACF"}
+{"version":3,"file":"reactIntl.cjs","names":[],"sources":["../../../../src/callers/compat/reactIntl.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-intl (FormatJS) — `@intlayer/react-intl` compat adapter.\n *\n * The full dotted message id encodes both the dictionary key and the field\n * path: `formatMessage({ id: 'home.title' })` → dictionary `home`, field\n * `title`.\n *\n * Mirrors `compat/react-intl/src/plugin/index.ts`.\n */\nexport const REACT_INTL_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useIntl',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    namespaceSources: [],\n    allowRootScope: true,\n    translationFunction: 'destructured-t',\n  },\n  {\n    callerName: 'formatMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    // Matches both `intl.formatMessage(...)` and the destructured\n    // `const { formatMessage } = useIntl()` identifier form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 'FormattedMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,qBAAyC;CACpD;EACE,YAAY;EACZ,SAAS;EACT,eAAe,CAAC,cAAc,sBAAsB;EACpD,kBAAkB,CAAC;EACnB,gBAAgB;EAChB,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe,CAAC,cAAc,sBAAsB;EAGpD,eAAe;EACf,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe,CAAC,cAAc,sBAAsB;EACpD,gBAAgB;EAChB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;AACF"}

package/dist/cjs/callers/index.cjs

@@ -83,5 +83,6 @@ exports.VUE_I18N_CALLERS = require_callers_compat_vueI18n.VUE_I18N_CALLERS;
 exports.getPositionalKeyCallerNames = getPositionalKeyCallerNames;
 exports.getRewritableCallers = require_callers_transform.getRewritableCallers;
 exports.isCallerActive = isCallerActive;
+exports.isRewritableCaller = require_callers_transform.isRewritableCaller;
 exports.toSwcExtraCallers = require_callers_transform.toSwcExtraCallers;
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/callers/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["I18NEXT_CALLERS","REACT_I18NEXT_CALLERS","NEXT_INTL_CALLERS","USE_INTL_CALLERS","REACT_INTL_CALLERS","LINGUI_CALLERS","VUE_I18N_CALLERS","BASE_CALLERS"],"sources":["../../../src/callers/index.ts"],"sourcesContent":["import { BASE_CALLERS } from './base';\nimport { I18NEXT_CALLERS } from './compat/i18next';\nimport { LINGUI_CALLERS } from './compat/lingui';\nimport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nimport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nimport { REACT_INTL_CALLERS } from './compat/reactIntl';\nimport { USE_INTL_CALLERS } from './compat/useIntl';\nimport { VUE_I18N_CALLERS } from './compat/vueI18n';\nimport type { CallerDescriptor } from './types';\n\nexport { BASE_CALLERS } from './base';\nexport { I18NEXT_CALLERS } from './compat/i18next';\nexport { LINGUI_CALLERS } from './compat/lingui';\nexport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nexport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nexport { REACT_INTL_CALLERS } from './compat/reactIntl';\nexport { USE_INTL_CALLERS } from './compat/useIntl';\nexport { VUE_I18N_CALLERS } from './compat/vueI18n';\nexport {\n  getRewritableCallers,\n  type SwcExtraCallerConfig,\n  toSwcExtraCallers,\n} from './transform';\nexport type {\n  CallerDescriptor,\n  CallerResultShape,\n  CallerValueSource,\n} from './types';\n\n/**\n * Compat-adapter callers, grouped in one list. Each compat package's bundler\n * plugin injects its own slice (e.g. `REACT_I18NEXT_CALLERS`) into the build\n * pipeline; this aggregate exists for consumers that need every syntax at\n * once, such as the LSP.\n */\nexport const COMPAT_CALLERS: CallerDescriptor[] = [\n  ...I18NEXT_CALLERS,\n  ...REACT_I18NEXT_CALLERS,\n  ...NEXT_INTL_CALLERS,\n  ...USE_INTL_CALLERS,\n  ...REACT_INTL_CALLERS,\n  ...LINGUI_CALLERS,\n  ...VUE_I18N_CALLERS,\n];\n\n/** Base + compat callers — the full registry the matchers run against. */\nexport const ALL_CALLERS: CallerDescriptor[] = [\n  ...BASE_CALLERS,\n  ...COMPAT_CALLERS,\n];\n\n/**\n * Descriptors indexed by caller name. A name can map to several descriptors\n * (e.g. `Trans` exists in both react-i18next and lingui with different\n * attributes); matchers try them in registry order.\n */\nexport const CALLERS_BY_NAME: Map<string, CallerDescriptor[]> = (() => {\n  const byName = new Map<string, CallerDescriptor[]>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const existing = byName.get(descriptor.callerName);\n\n    if (existing) {\n      existing.push(descriptor);\n    } else {\n      byName.set(descriptor.callerName, [descriptor]);\n    }\n  }\n\n  return byName;\n})();\n\n/**\n * Caller names whose dictionary key can appear as a positional string literal\n * argument (`caller('key', …)` / `caller(locale, 'key', …)`). Used to build\n * text-search regexes over project source files (find-references) and the\n * completion trigger pattern. Callers whose key never appears positionally\n * (fixed namespace, options object, JSX-only) are excluded on purpose.\n */\nexport const getPositionalKeyCallerNames = (): string[] => {\n  const names = new Set<string>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const hasPositionalNamespace = descriptor.namespaceSources.some(\n      (source) => source.from === 'argument'\n    );\n\n    if (hasPositionalNamespace) names.add(descriptor.callerName);\n  }\n\n  return [...names];\n};\n\n/**\n * Returns `true` when the descriptor may participate in matching for a file\n * importing from `importSources`. Descriptors flagged `requiresImport` only\n * activate when the file imports from one of their declared modules;\n * everything else is always active (results are still validated against the\n * project's dictionaries downstream).\n *\n * @param descriptor - The caller descriptor to gate.\n * @param fileImportSources - Module specifiers imported by the analysed file.\n */\nexport const isCallerActive = (\n  descriptor: CallerDescriptor,\n  fileImportSources: ReadonlySet<string>\n): boolean => {\n  if (!descriptor.requiresImport) return true;\n\n  return descriptor.importSources.some((source) =>\n    fileImportSources.has(source)\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmCA,MAAa,iBAAqC;CAChD,GAAGA;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;AACL;;AAGA,MAAa,cAAkC,CAC7C,GAAGC,mCACH,GAAG,cACL;;;;;;AAOA,MAAa,yBAA0D;CACrE,MAAM,yBAAS,IAAI,IAAgC;CAEnD,KAAK,MAAM,cAAc,aAAa;EACpC,MAAM,WAAW,OAAO,IAAI,WAAW,UAAU;EAEjD,IAAI,UACF,SAAS,KAAK,UAAU;OAExB,OAAO,IAAI,WAAW,YAAY,CAAC,UAAU,CAAC;CAElD;CAEA,OAAO;AACT,EAAC,CAAE;;;;;;;;AASH,MAAa,oCAA8C;CACzD,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,cAAc,aAKvB,IAJ+B,WAAW,iBAAiB,MACxD,WAAW,OAAO,SAAS,UAGL,GAAG,MAAM,IAAI,WAAW,UAAU;CAG7D,OAAO,CAAC,GAAG,KAAK;AAClB;;;;;;;;;;;AAYA,MAAa,kBACX,YACA,sBACY;CACZ,IAAI,CAAC,WAAW,gBAAgB,OAAO;CAEvC,OAAO,WAAW,cAAc,MAAM,WACpC,kBAAkB,IAAI,MAAM,CAC9B;AACF"}
+{"version":3,"file":"index.cjs","names":["I18NEXT_CALLERS","REACT_I18NEXT_CALLERS","NEXT_INTL_CALLERS","USE_INTL_CALLERS","REACT_INTL_CALLERS","LINGUI_CALLERS","VUE_I18N_CALLERS","BASE_CALLERS"],"sources":["../../../src/callers/index.ts"],"sourcesContent":["import { BASE_CALLERS } from './base';\nimport { I18NEXT_CALLERS } from './compat/i18next';\nimport { LINGUI_CALLERS } from './compat/lingui';\nimport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nimport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nimport { REACT_INTL_CALLERS } from './compat/reactIntl';\nimport { USE_INTL_CALLERS } from './compat/useIntl';\nimport { VUE_I18N_CALLERS } from './compat/vueI18n';\nimport type { CallerDescriptor } from './types';\n\nexport { BASE_CALLERS } from './base';\nexport { I18NEXT_CALLERS } from './compat/i18next';\nexport { LINGUI_CALLERS } from './compat/lingui';\nexport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nexport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nexport { REACT_INTL_CALLERS } from './compat/reactIntl';\nexport { USE_INTL_CALLERS } from './compat/useIntl';\nexport { VUE_I18N_CALLERS } from './compat/vueI18n';\nexport {\n  getRewritableCallers,\n  isRewritableCaller,\n  type SwcExtraCallerConfig,\n  toSwcExtraCallers,\n} from './transform';\nexport type {\n  CallerDescriptor,\n  CallerResultShape,\n  CallerValueSource,\n} from './types';\n\n/**\n * Compat-adapter callers, grouped in one list. Each compat package's bundler\n * plugin injects its own slice (e.g. `REACT_I18NEXT_CALLERS`) into the build\n * pipeline; this aggregate exists for consumers that need every syntax at\n * once, such as the LSP.\n */\nexport const COMPAT_CALLERS: CallerDescriptor[] = [\n  ...I18NEXT_CALLERS,\n  ...REACT_I18NEXT_CALLERS,\n  ...NEXT_INTL_CALLERS,\n  ...USE_INTL_CALLERS,\n  ...REACT_INTL_CALLERS,\n  ...LINGUI_CALLERS,\n  ...VUE_I18N_CALLERS,\n];\n\n/** Base + compat callers — the full registry the matchers run against. */\nexport const ALL_CALLERS: CallerDescriptor[] = [\n  ...BASE_CALLERS,\n  ...COMPAT_CALLERS,\n];\n\n/**\n * Descriptors indexed by caller name. A name can map to several descriptors\n * (e.g. `Trans` exists in both react-i18next and lingui with different\n * attributes); matchers try them in registry order.\n */\nexport const CALLERS_BY_NAME: Map<string, CallerDescriptor[]> = (() => {\n  const byName = new Map<string, CallerDescriptor[]>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const existing = byName.get(descriptor.callerName);\n\n    if (existing) {\n      existing.push(descriptor);\n    } else {\n      byName.set(descriptor.callerName, [descriptor]);\n    }\n  }\n\n  return byName;\n})();\n\n/**\n * Caller names whose dictionary key can appear as a positional string literal\n * argument (`caller('key', …)` / `caller(locale, 'key', …)`). Used to build\n * text-search regexes over project source files (find-references) and the\n * completion trigger pattern. Callers whose key never appears positionally\n * (fixed namespace, options object, JSX-only) are excluded on purpose.\n */\nexport const getPositionalKeyCallerNames = (): string[] => {\n  const names = new Set<string>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const hasPositionalNamespace = descriptor.namespaceSources.some(\n      (source) => source.from === 'argument'\n    );\n\n    if (hasPositionalNamespace) names.add(descriptor.callerName);\n  }\n\n  return [...names];\n};\n\n/**\n * Returns `true` when the descriptor may participate in matching for a file\n * importing from `importSources`. Descriptors flagged `requiresImport` only\n * activate when the file imports from one of their declared modules;\n * everything else is always active (results are still validated against the\n * project's dictionaries downstream).\n *\n * @param descriptor - The caller descriptor to gate.\n * @param fileImportSources - Module specifiers imported by the analysed file.\n */\nexport const isCallerActive = (\n  descriptor: CallerDescriptor,\n  fileImportSources: ReadonlySet<string>\n): boolean => {\n  if (!descriptor.requiresImport) return true;\n\n  return descriptor.importSources.some((source) =>\n    fileImportSources.has(source)\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoCA,MAAa,iBAAqC;CAChD,GAAGA;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;CACH,GAAGC;AACL;;AAGA,MAAa,cAAkC,CAC7C,GAAGC,mCACH,GAAG,cACL;;;;;;AAOA,MAAa,yBAA0D;CACrE,MAAM,yBAAS,IAAI,IAAgC;CAEnD,KAAK,MAAM,cAAc,aAAa;EACpC,MAAM,WAAW,OAAO,IAAI,WAAW,UAAU;EAEjD,IAAI,UACF,SAAS,KAAK,UAAU;OAExB,OAAO,IAAI,WAAW,YAAY,CAAC,UAAU,CAAC;CAElD;CAEA,OAAO;AACT,EAAC,CAAE;;;;;;;;AASH,MAAa,oCAA8C;CACzD,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,cAAc,aAKvB,IAJ+B,WAAW,iBAAiB,MACxD,WAAW,OAAO,SAAS,UAGL,GAAG,MAAM,IAAI,WAAW,UAAU;CAG7D,OAAO,CAAC,GAAG,KAAK;AAClB;;;;;;;;;;;AAYA,MAAa,kBACX,YACA,sBACY;CACZ,IAAI,CAAC,WAAW,gBAAgB,OAAO;CAEvC,OAAO,WAAW,cAAc,MAAM,WACpC,kBAAkB,IAAI,MAAM,CAC9B;AACF"}

package/dist/cjs/callers/transform.cjs

@@ -1,24 +1,30 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 //#region src/callers/transform.ts
 /**
-* Returns the callers of a registry slice that the optimize pass can rewrite
-* at build time: plain imported functions carrying both replacement names.
+* Whether the optimize pass can rewrite this caller's call sites at build time.
 *
-* Method-matched callers (`i18n.getFixedT`) and JSX components are excluded —
-* their call sites cannot be re-pointed through an import specifier rename.
+* Requires both replacement names and a call shape reachable through an import
+* specifier rename. Method-matched callers (`i18n.getFixedT`, `intl.formatMessage`)
+* and JSX components (`<Trans>`, `<FormattedMessage>`) are excluded — their call
+* sites keep resolving through the runtime dictionary registry.
+*/
+const isRewritableCaller = (descriptor) => descriptor.staticReplacement !== void 0 && descriptor.dynamicReplacement !== void 0 && descriptor.matchAsMethod !== true && descriptor.jsxIdAttribute === void 0;
+/**
+* Returns the callers of a registry slice that the optimize pass can rewrite
+* at build time. See {@link isRewritableCaller}.
 */
-const getRewritableCallers = (descriptors) => descriptors.filter((descriptor) => descriptor.staticReplacement !== void 0 && descriptor.dynamicReplacement !== void 0 && descriptor.matchAsMethod !== true && descriptor.jsxIdAttribute === void 0);
+const getRewritableCallers = (descriptors) => descriptors.filter(isRewritableCaller);
 const findSource = (sources, from) => sources.find((source) => source.from === from);
 /**
 * Serialises the rewritable callers of a registry slice into the
 * `@intlayer/swc` plugin wire format (`extraCallers` option).
 *
-* Callers whose namespace can only be derived per-message id
-* (`path-first-segment`) are skipped: the transform cannot bind a single
-* dictionary to the call site.
+* A caller with no statically readable namespace source is dropped: the plugin
+* binds a dictionary from an argument, an option property or a fixed value
+* only, so forwarding it would emit a descriptor no call site can match.
 *
 * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.
-* @returns Configs ready to pass as `swcExtraCallers` / `extraCallers`.
+* @returns Configs ready to pass as the plugin's `extraCallers` option.
 */
 const toSwcExtraCallers = (descriptors) => getRewritableCallers(descriptors).flatMap((descriptor) => {
 	const argumentSource = findSource(descriptor.namespaceSources, "argument");
@@ -41,5 +47,6 @@ const toSwcExtraCallers = (descriptors) => getRewritableCallers(descriptors).fla
 
 //#endregion
 exports.getRewritableCallers = getRewritableCallers;
+exports.isRewritableCaller = isRewritableCaller;
 exports.toSwcExtraCallers = toSwcExtraCallers;
 //# sourceMappingURL=transform.cjs.map

package/dist/cjs/callers/transform.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transform.cjs","names":[],"sources":["../../../src/callers/transform.ts"],"sourcesContent":["import type { CallerDescriptor, CallerValueSource } from './types';\n\n/**\n * Wire format of an extra caller forwarded to the `@intlayer/swc` plugin.\n *\n * Field names mirror the serde attributes of `ExtraCallerConfig` in\n * `packages/@intlayer/swc/src/lib.rs` — both sides must stay in sync.\n */\nexport type SwcExtraCallerConfig = {\n  /** The function name the user calls, e.g. `\"useTranslation\"`. */\n  callerName: string;\n  /** Module specifiers exporting the function (original + `@intlayer/*`). */\n  importSources: string[];\n  /**\n   * Zero-based index of the positional argument holding the namespace string.\n   * Omitted for fixed/option namespace callers.\n   */\n  namespaceArgIndex?: number;\n  /**\n   * Compile-time constant namespace — the dictionary ident is inserted as a\n   * new first argument (lingui's `useLingui()`).\n   */\n  fixedNamespace?: string;\n  /**\n   * Namespace read from a property of an options-object argument — the\n   * dictionary ident is inserted as a new first argument and the property is\n   * rewritten to the key-prefix remainder (vue-i18n's `useI18n({ namespace })`).\n   */\n  namespaceOption?: { argumentIndex: number; property: string };\n  /** Replacement function name for static import mode, e.g. `\"useDictionary\"`. */\n  staticReplacement: string;\n  /** Replacement function name for dynamic/fetch mode, e.g. `\"useDictionaryDynamic\"`. */\n  dynamicReplacement: string;\n};\n\n/**\n * Returns the callers of a registry slice that the optimize pass can rewrite\n * at build time: plain imported functions carrying both replacement names.\n *\n * Method-matched callers (`i18n.getFixedT`) and JSX components are excluded —\n * their call sites cannot be re-pointed through an import specifier rename.\n */\nexport const getRewritableCallers = (\n  descriptors: CallerDescriptor[]\n): CallerDescriptor[] =>\n  descriptors.filter(\n    (descriptor) =>\n      descriptor.staticReplacement !== undefined &&\n      descriptor.dynamicReplacement !== undefined &&\n      descriptor.matchAsMethod !== true &&\n      descriptor.jsxIdAttribute === undefined\n  );\n\nconst findSource = <F extends CallerValueSource['from']>(\n  sources: CallerValueSource[],\n  from: F\n): Extract<CallerValueSource, { from: F }> | undefined =>\n  sources.find(\n    (source): source is Extract<CallerValueSource, { from: F }> =>\n      source.from === from\n  );\n\n/**\n * Serialises the rewritable callers of a registry slice into the\n * `@intlayer/swc` plugin wire format (`extraCallers` option).\n *\n * Callers whose namespace can only be derived per-message id\n * (`path-first-segment`) are skipped: the transform cannot bind a single\n * dictionary to the call site.\n *\n * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.\n * @returns Configs ready to pass as `swcExtraCallers` / `extraCallers`.\n */\nexport const toSwcExtraCallers = (\n  descriptors: CallerDescriptor[]\n): SwcExtraCallerConfig[] =>\n  getRewritableCallers(descriptors).flatMap((descriptor) => {\n    const argumentSource = findSource(descriptor.namespaceSources, 'argument');\n    const optionSource = findSource(descriptor.namespaceSources, 'option');\n    const fixedSource = findSource(descriptor.namespaceSources, 'fixed');\n\n    if (!argumentSource && !optionSource && !fixedSource) return [];\n\n    return [\n      {\n        callerName: descriptor.callerName,\n        importSources: descriptor.importSources,\n        ...(argumentSource ? { namespaceArgIndex: argumentSource.index } : {}),\n        ...(fixedSource ? { fixedNamespace: fixedSource.value } : {}),\n        ...(optionSource\n          ? {\n              namespaceOption: {\n                argumentIndex: optionSource.argumentIndex,\n                property: optionSource.property,\n              },\n            }\n          : {}),\n        staticReplacement: descriptor.staticReplacement!,\n        dynamicReplacement: descriptor.dynamicReplacement!,\n      },\n    ];\n  });\n"],"mappings":";;;;;;;;;AA0CA,MAAa,wBACX,gBAEA,YAAY,QACT,eACC,WAAW,sBAAsB,UACjC,WAAW,uBAAuB,UAClC,WAAW,kBAAkB,QAC7B,WAAW,mBAAmB,MAClC;AAEF,MAAM,cACJ,SACA,SAEA,QAAQ,MACL,WACC,OAAO,SAAS,IACpB;;;;;;;;;;;;AAaF,MAAa,qBACX,gBAEA,qBAAqB,WAAW,CAAC,CAAC,SAAS,eAAe;CACxD,MAAM,iBAAiB,WAAW,WAAW,kBAAkB,UAAU;CACzE,MAAM,eAAe,WAAW,WAAW,kBAAkB,QAAQ;CACrE,MAAM,cAAc,WAAW,WAAW,kBAAkB,OAAO;CAEnE,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,aAAa,OAAO,CAAC;CAE9D,OAAO,CACL;EACE,YAAY,WAAW;EACvB,eAAe,WAAW;EAC1B,GAAI,iBAAiB,EAAE,mBAAmB,eAAe,MAAM,IAAI,CAAC;EACpE,GAAI,cAAc,EAAE,gBAAgB,YAAY,MAAM,IAAI,CAAC;EAC3D,GAAI,eACA,EACE,iBAAiB;GACf,eAAe,aAAa;GAC5B,UAAU,aAAa;EACzB,EACF,IACA,CAAC;EACL,mBAAmB,WAAW;EAC9B,oBAAoB,WAAW;CACjC,CACF;AACF,CAAC"}
+{"version":3,"file":"transform.cjs","names":[],"sources":["../../../src/callers/transform.ts"],"sourcesContent":["import type { CallerDescriptor, CallerValueSource } from './types';\n\n/**\n * Wire format of an extra caller forwarded to the `@intlayer/swc` plugin.\n *\n * Field names mirror the serde attributes of `ExtraCallerConfig` in\n * `packages/@intlayer/swc/src/lib.rs` — both sides must stay in sync.\n */\nexport type SwcExtraCallerConfig = {\n  /** The function name the user calls, e.g. `\"useTranslation\"`. */\n  callerName: string;\n  /** Module specifiers exporting the function (original + `@intlayer/*`). */\n  importSources: string[];\n  /**\n   * Zero-based index of the positional argument holding the namespace string.\n   * Omitted for fixed/option namespace callers.\n   */\n  namespaceArgIndex?: number;\n  /**\n   * Compile-time constant namespace — the dictionary ident is inserted as a\n   * new first argument (lingui's `useLingui()`).\n   */\n  fixedNamespace?: string;\n  /**\n   * Namespace read from a property of an options-object argument — the\n   * dictionary ident is inserted as a new first argument and the property is\n   * rewritten to the key-prefix remainder (vue-i18n's `useI18n({ namespace })`).\n   */\n  namespaceOption?: { argumentIndex: number; property: string };\n  /** Replacement function name for static import mode, e.g. `\"useDictionary\"`. */\n  staticReplacement: string;\n  /** Replacement function name for dynamic/fetch mode, e.g. `\"useDictionaryDynamic\"`. */\n  dynamicReplacement: string;\n};\n\n/**\n * Whether the optimize pass can rewrite this caller's call sites at build time.\n *\n * Requires both replacement names and a call shape reachable through an import\n * specifier rename. Method-matched callers (`i18n.getFixedT`, `intl.formatMessage`)\n * and JSX components (`<Trans>`, `<FormattedMessage>`) are excluded — their call\n * sites keep resolving through the runtime dictionary registry.\n */\nexport const isRewritableCaller = (descriptor: CallerDescriptor): boolean =>\n  descriptor.staticReplacement !== undefined &&\n  descriptor.dynamicReplacement !== undefined &&\n  descriptor.matchAsMethod !== true &&\n  descriptor.jsxIdAttribute === undefined;\n\n/**\n * Returns the callers of a registry slice that the optimize pass can rewrite\n * at build time. See {@link isRewritableCaller}.\n */\nexport const getRewritableCallers = (\n  descriptors: CallerDescriptor[]\n): CallerDescriptor[] => descriptors.filter(isRewritableCaller);\n\nconst findSource = <F extends CallerValueSource['from']>(\n  sources: CallerValueSource[],\n  from: F\n): Extract<CallerValueSource, { from: F }> | undefined =>\n  sources.find(\n    (source): source is Extract<CallerValueSource, { from: F }> =>\n      source.from === from\n  );\n\n/**\n * Serialises the rewritable callers of a registry slice into the\n * `@intlayer/swc` plugin wire format (`extraCallers` option).\n *\n * A caller with no statically readable namespace source is dropped: the plugin\n * binds a dictionary from an argument, an option property or a fixed value\n * only, so forwarding it would emit a descriptor no call site can match.\n *\n * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.\n * @returns Configs ready to pass as the plugin's `extraCallers` option.\n */\nexport const toSwcExtraCallers = (\n  descriptors: CallerDescriptor[]\n): SwcExtraCallerConfig[] =>\n  getRewritableCallers(descriptors).flatMap((descriptor) => {\n    const argumentSource = findSource(descriptor.namespaceSources, 'argument');\n    const optionSource = findSource(descriptor.namespaceSources, 'option');\n    const fixedSource = findSource(descriptor.namespaceSources, 'fixed');\n\n    if (!argumentSource && !optionSource && !fixedSource) return [];\n\n    return [\n      {\n        callerName: descriptor.callerName,\n        importSources: descriptor.importSources,\n        ...(argumentSource ? { namespaceArgIndex: argumentSource.index } : {}),\n        ...(fixedSource ? { fixedNamespace: fixedSource.value } : {}),\n        ...(optionSource\n          ? {\n              namespaceOption: {\n                argumentIndex: optionSource.argumentIndex,\n                property: optionSource.property,\n              },\n            }\n          : {}),\n        staticReplacement: descriptor.staticReplacement!,\n        dynamicReplacement: descriptor.dynamicReplacement!,\n      },\n    ];\n  });\n"],"mappings":";;;;;;;;;;AA2CA,MAAa,sBAAsB,eACjC,WAAW,sBAAsB,UACjC,WAAW,uBAAuB,UAClC,WAAW,kBAAkB,QAC7B,WAAW,mBAAmB;;;;;AAMhC,MAAa,wBACX,gBACuB,YAAY,OAAO,kBAAkB;AAE9D,MAAM,cACJ,SACA,SAEA,QAAQ,MACL,WACC,OAAO,SAAS,IACpB;;;;;;;;;;;;AAaF,MAAa,qBACX,gBAEA,qBAAqB,WAAW,CAAC,CAAC,SAAS,eAAe;CACxD,MAAM,iBAAiB,WAAW,WAAW,kBAAkB,UAAU;CACzE,MAAM,eAAe,WAAW,WAAW,kBAAkB,QAAQ;CACrE,MAAM,cAAc,WAAW,WAAW,kBAAkB,OAAO;CAEnE,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,aAAa,OAAO,CAAC;CAE9D,OAAO,CACL;EACE,YAAY,WAAW;EACvB,eAAe,WAAW;EAC1B,GAAI,iBAAiB,EAAE,mBAAmB,eAAe,MAAM,IAAI,CAAC;EACpE,GAAI,cAAc,EAAE,gBAAgB,YAAY,MAAM,IAAI,CAAC;EAC3D,GAAI,eACA,EACE,iBAAiB;GACf,eAAe,aAAa;GAC5B,UAAU,aAAa;EACzB,EACF,IACA,CAAC;EACL,mBAAmB,WAAW;EAC9B,oBAAoB,WAAW;CACjC,CACF;AACF,CAAC"}

package/dist/esm/bundle/index.mjs

@@ -1,7 +1,7 @@
 import { getAlias } from "../utils/alias.mjs";
 import { getConfiguration } from "../configFile/getConfiguration.mjs";
-import { getConfigEnvVars } from "../envVars/envVars.mjs";
 import { BundleLogger } from "./logBundle.mjs";
+import { getConfigEnvVars } from "../envVars/envVars.mjs";
 import { isAbsolute, join, resolve } from "node:path";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import configPackageJson from "@intlayer/types/package.json" with { type: "json" };

package/dist/esm/callers/compat/lingui.mjs

@@ -2,9 +2,15 @@
 /**
 * Lingui — `@intlayer/lingui` compat adapter.
 *
-* Lingui is a single-catalog library: every message lives in the `messages`
-* dictionary and catalog keys are flat (a dotted id such as
-* `results-table.bundleSize` is one literal key, not a nested path).
+* Lingui is a single-catalog library: the namespace lives *inside* the message
+* id rather than in the file layout, so `i18n._('footer.github')` names both
+* the group (`footer`) and the field (`github`).
+*
+* The adapter therefore addresses lingui catalogs by the id's first dot-segment,
+* which lets a catalog split with `syncJSON({ splitKeys: 'key-prefix' })` resolve
+* one small dictionary per call site instead of the whole catalog. None of these
+* callers carries a namespace argument, so the optimize passes leave them to the
+* runtime resolver and only the usage analysis reads the ids.
 *
 * `t` and `_` are generic names, so all lingui callers require an import from
 * a lingui module to participate in matching — this avoids false positives on
@@ -25,13 +31,9 @@ const LINGUI_CALLERS = [
 		callerName: "useLingui",
 		library: "lingui",
 		importSources: LINGUI_IMPORT_SOURCES,
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "destructured-t",
-		staticReplacement: "useDictionary",
-		dynamicReplacement: "useDictionaryDynamic"
+		namespaceSources: [],
+		allowRootScope: true,
+		translationFunction: "destructured-t"
 	},
 	{
 		callerName: "_",
@@ -39,12 +41,8 @@ const LINGUI_CALLERS = [
 		importSources: LINGUI_IMPORT_SOURCES,
 		requiresImport: true,
 		matchAsMethod: true,
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "self",
-		flatKey: true
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
 	},
 	{
 		callerName: "t",
@@ -53,12 +51,8 @@ const LINGUI_CALLERS = [
 		requiresImport: true,
 		matchAsMethod: true,
 		matchAsTaggedTemplate: true,
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "self",
-		flatKey: true
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
 	},
 	{
 		callerName: "Trans",
@@ -66,12 +60,8 @@ const LINGUI_CALLERS = [
 		importSources: LINGUI_IMPORT_SOURCES,
 		requiresImport: true,
 		jsxIdAttribute: "id",
-		namespaceSources: [{
-			from: "fixed",
-			value: "messages"
-		}],
-		translationFunction: "self",
-		flatKey: true
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
 	}
 ];
 

package/dist/esm/callers/compat/lingui.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lingui.mjs","names":[],"sources":["../../../../src/callers/compat/lingui.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * Lingui — `@intlayer/lingui` compat adapter.\n *\n * Lingui is a single-catalog library: every message lives in the `messages`\n * dictionary and catalog keys are flat (a dotted id such as\n * `results-table.bundleSize` is one literal key, not a nested path).\n *\n * `t` and `_` are generic names, so all lingui callers require an import from\n * a lingui module to participate in matching — this avoids false positives on\n * unrelated `t()` helpers.\n *\n * Mirrors `compat/lingui/src/plugin/index.ts`.\n */\nconst LINGUI_IMPORT_SOURCES = [\n  '@lingui/core',\n  '@lingui/react',\n  '@lingui/macro',\n  '@lingui/core/macro',\n  '@lingui/react/macro',\n  '@intlayer/lingui',\n];\n\nexport const LINGUI_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useLingui',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    // `const { i18n, t, _ } = useLingui()` — single-catalog hook, no\n    // namespace argument: every call reads the `messages` dictionary.\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'destructured-t',\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: '_',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n._('id')` and the destructured `const { _ } = useLingui()` form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'self',\n    flatKey: true,\n  },\n  {\n    callerName: 't',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n.t('id')`, `t({ id: 'id' })` and the macro tagged template ``t`…` ``.\n    matchAsMethod: true,\n    matchAsTaggedTemplate: true,\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'self',\n    flatKey: true,\n  },\n  {\n    callerName: 'Trans',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // <Trans id=\"home.title\" message=\"Welcome\" />\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'fixed', value: 'messages' }],\n    translationFunction: 'self',\n    flatKey: true,\n  },\n];\n"],"mappings":";;;;;;;;;;;;;;AAeA,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,iBAAqC;CAChD;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EAGf,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,mBAAmB;EACnB,oBAAoB;CACtB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,SAAS;CACX;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,uBAAuB;EACvB,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,SAAS;CACX;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,gBAAgB;EAChB,kBAAkB,CAAC;GAAE,MAAM;GAAS,OAAO;EAAW,CAAC;EACvD,qBAAqB;EACrB,SAAS;CACX;AACF"}
+{"version":3,"file":"lingui.mjs","names":[],"sources":["../../../../src/callers/compat/lingui.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * Lingui — `@intlayer/lingui` compat adapter.\n *\n * Lingui is a single-catalog library: the namespace lives *inside* the message\n * id rather than in the file layout, so `i18n._('footer.github')` names both\n * the group (`footer`) and the field (`github`).\n *\n * The adapter therefore addresses lingui catalogs by the id's first dot-segment,\n * which lets a catalog split with `syncJSON({ splitKeys: 'key-prefix' })` resolve\n * one small dictionary per call site instead of the whole catalog. None of these\n * callers carries a namespace argument, so the optimize passes leave them to the\n * runtime resolver and only the usage analysis reads the ids.\n *\n * `t` and `_` are generic names, so all lingui callers require an import from\n * a lingui module to participate in matching — this avoids false positives on\n * unrelated `t()` helpers.\n *\n * Mirrors `compat/lingui/src/plugin/index.ts`.\n */\nconst LINGUI_IMPORT_SOURCES = [\n  '@lingui/core',\n  '@lingui/react',\n  '@lingui/macro',\n  '@lingui/core/macro',\n  '@lingui/react/macro',\n  '@intlayer/lingui',\n];\n\nexport const LINGUI_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useLingui',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    // `const { i18n, t, _ } = useLingui()` takes no namespace argument, so the\n    // dictionary is only knowable from the ids passed to the returned\n    // functions — which the usage analysis reads and the optimize passes do not.\n    namespaceSources: [],\n    allowRootScope: true,\n    translationFunction: 'destructured-t',\n  },\n  {\n    callerName: '_',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n._('id')` and the destructured `const { _ } = useLingui()` form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 't',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // `i18n.t('id')`, `t({ id: 'id' })` and the macro tagged template ``t`…` ``.\n    matchAsMethod: true,\n    matchAsTaggedTemplate: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 'Trans',\n    library: 'lingui',\n    importSources: LINGUI_IMPORT_SOURCES,\n    requiresImport: true,\n    // <Trans id=\"home.title\" message=\"Welcome\" />\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,MAAM,wBAAwB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,iBAAqC;CAChD;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EAIf,kBAAkB,CAAC;EACnB,gBAAgB;EAChB,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,eAAe;EACf,uBAAuB;EACvB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe;EACf,gBAAgB;EAEhB,gBAAgB;EAChB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;AACF"}

package/dist/esm/callers/compat/reactI18next.mjs

@@ -26,6 +26,7 @@ const REACT_I18NEXT_CALLERS = [{
 		property: "keyPrefix"
 	}],
 	translationFunction: "destructured-t",
+	allowRootScope: true,
 	staticReplacement: "useDictionary",
 	dynamicReplacement: "useDictionaryDynamic"
 }, {

package/dist/esm/callers/compat/reactI18next.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reactI18next.mjs","names":[],"sources":["../../../../src/callers/compat/reactI18next.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-i18next / next-i18next — `@intlayer/react-i18next` and\n * `@intlayer/next-i18next` compat adapters (next-i18next re-exports the\n * react-i18next hook, so both libraries share the same callers).\n *\n * Mirrors `compat/react-i18next/src/plugin/index.ts` and\n * `compat/next-i18next/src/plugin/index.ts`.\n */\nexport const REACT_I18NEXT_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useTranslation',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    namespaceSources: [{ from: 'argument', index: 0 }],\n    keyPrefixSources: [\n      { from: 'option', argumentIndex: 1, property: 'keyPrefix' },\n    ],\n    translationFunction: 'destructured-t',\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: 'Trans',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    // <Trans ns=\"home\" i18nKey=\"richText\" /> — the namespace attribute is\n    // optional; without it the analyser falls back to the single translator\n    // namespace declared in the same file.\n    jsxIdAttribute: 'i18nKey',\n    jsxNamespaceAttribute: 'ns',\n    namespaceSources: [],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;AAUA,MAAa,wBAA4C,CACvD;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CACA,kBAAkB,CAAC;EAAE,MAAM;EAAY,OAAO;CAAE,CAAC;CACjD,kBAAkB,CAChB;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;CAAY,CAC5D;CACA,qBAAqB;CACrB,mBAAmB;CACnB,oBAAoB;AACtB,GACA;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CAIA,gBAAgB;CAChB,uBAAuB;CACvB,kBAAkB,CAAC;CACnB,qBAAqB;AACvB,CACF"}
+{"version":3,"file":"reactI18next.mjs","names":[],"sources":["../../../../src/callers/compat/reactI18next.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-i18next / next-i18next — `@intlayer/react-i18next` and\n * `@intlayer/next-i18next` compat adapters (next-i18next re-exports the\n * react-i18next hook, so both libraries share the same callers).\n *\n * Mirrors `compat/react-i18next/src/plugin/index.ts` and\n * `compat/next-i18next/src/plugin/index.ts`.\n */\nexport const REACT_I18NEXT_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useTranslation',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    namespaceSources: [{ from: 'argument', index: 0 }],\n    keyPrefixSources: [\n      { from: 'option', argumentIndex: 1, property: 'keyPrefix' },\n    ],\n    translationFunction: 'destructured-t',\n    allowRootScope: true,\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: 'Trans',\n    library: 'react-i18next',\n    importSources: [\n      'react-i18next',\n      'next-i18next',\n      '@intlayer/react-i18next',\n      '@intlayer/next-i18next',\n    ],\n    // <Trans ns=\"home\" i18nKey=\"richText\" /> — the namespace attribute is\n    // optional; without it the analyser falls back to the single translator\n    // namespace declared in the same file.\n    jsxIdAttribute: 'i18nKey',\n    jsxNamespaceAttribute: 'ns',\n    namespaceSources: [],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;AAUA,MAAa,wBAA4C,CACvD;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CACA,kBAAkB,CAAC;EAAE,MAAM;EAAY,OAAO;CAAE,CAAC;CACjD,kBAAkB,CAChB;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;CAAY,CAC5D;CACA,qBAAqB;CACrB,gBAAgB;CAChB,mBAAmB;CACnB,oBAAoB;AACtB,GACA;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;CACF;CAIA,gBAAgB;CAChB,uBAAuB;CACvB,kBAAkB,CAAC;CACnB,qBAAqB;AACvB,CACF"}

package/dist/esm/callers/compat/reactIntl.mjs

@@ -8,21 +8,32 @@
 *
 * Mirrors `compat/react-intl/src/plugin/index.ts`.
 */
-const REACT_INTL_CALLERS = [{
-	callerName: "formatMessage",
-	library: "react-intl",
-	importSources: ["react-intl", "@intlayer/react-intl"],
-	matchAsMethod: true,
-	namespaceSources: [{ from: "path-first-segment" }],
-	translationFunction: "self"
-}, {
-	callerName: "FormattedMessage",
-	library: "react-intl",
-	importSources: ["react-intl", "@intlayer/react-intl"],
-	jsxIdAttribute: "id",
-	namespaceSources: [{ from: "path-first-segment" }],
-	translationFunction: "self"
-}];
+const REACT_INTL_CALLERS = [
+	{
+		callerName: "useIntl",
+		library: "react-intl",
+		importSources: ["react-intl", "@intlayer/react-intl"],
+		namespaceSources: [],
+		allowRootScope: true,
+		translationFunction: "destructured-t"
+	},
+	{
+		callerName: "formatMessage",
+		library: "react-intl",
+		importSources: ["react-intl", "@intlayer/react-intl"],
+		matchAsMethod: true,
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
+	},
+	{
+		callerName: "FormattedMessage",
+		library: "react-intl",
+		importSources: ["react-intl", "@intlayer/react-intl"],
+		jsxIdAttribute: "id",
+		namespaceSources: [{ from: "path-first-segment" }],
+		translationFunction: "self"
+	}
+];
 
 //#endregion
 export { REACT_INTL_CALLERS };

package/dist/esm/callers/compat/reactIntl.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reactIntl.mjs","names":[],"sources":["../../../../src/callers/compat/reactIntl.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-intl (FormatJS) — `@intlayer/react-intl` compat adapter.\n *\n * The full dotted message id encodes both the dictionary key and the field\n * path: `formatMessage({ id: 'home.title' })` → dictionary `home`, field\n * `title`.\n *\n * Mirrors `compat/react-intl/src/plugin/index.ts`.\n */\nexport const REACT_INTL_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'formatMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    // Matches both `intl.formatMessage(...)` and the destructured\n    // `const { formatMessage } = useIntl()` identifier form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 'FormattedMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;AAWA,MAAa,qBAAyC,CACpD;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,cAAc,sBAAsB;CAGpD,eAAe;CACf,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;CACjD,qBAAqB;AACvB,GACA;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,cAAc,sBAAsB;CACpD,gBAAgB;CAChB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;CACjD,qBAAqB;AACvB,CACF"}
+{"version":3,"file":"reactIntl.mjs","names":[],"sources":["../../../../src/callers/compat/reactIntl.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * react-intl (FormatJS) — `@intlayer/react-intl` compat adapter.\n *\n * The full dotted message id encodes both the dictionary key and the field\n * path: `formatMessage({ id: 'home.title' })` → dictionary `home`, field\n * `title`.\n *\n * Mirrors `compat/react-intl/src/plugin/index.ts`.\n */\nexport const REACT_INTL_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useIntl',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    namespaceSources: [],\n    allowRootScope: true,\n    translationFunction: 'destructured-t',\n  },\n  {\n    callerName: 'formatMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    // Matches both `intl.formatMessage(...)` and the destructured\n    // `const { formatMessage } = useIntl()` identifier form.\n    matchAsMethod: true,\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n  {\n    callerName: 'FormattedMessage',\n    library: 'react-intl',\n    importSources: ['react-intl', '@intlayer/react-intl'],\n    jsxIdAttribute: 'id',\n    namespaceSources: [{ from: 'path-first-segment' }],\n    translationFunction: 'self',\n  },\n];\n"],"mappings":";;;;;;;;;;AAWA,MAAa,qBAAyC;CACpD;EACE,YAAY;EACZ,SAAS;EACT,eAAe,CAAC,cAAc,sBAAsB;EACpD,kBAAkB,CAAC;EACnB,gBAAgB;EAChB,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe,CAAC,cAAc,sBAAsB;EAGpD,eAAe;EACf,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;CACA;EACE,YAAY;EACZ,SAAS;EACT,eAAe,CAAC,cAAc,sBAAsB;EACpD,gBAAgB;EAChB,kBAAkB,CAAC,EAAE,MAAM,qBAAqB,CAAC;EACjD,qBAAqB;CACvB;AACF"}

package/dist/esm/callers/index.mjs

@@ -1,5 +1,5 @@
 import { BASE_CALLERS } from "./base.mjs";
-import { getRewritableCallers, toSwcExtraCallers } from "./transform.mjs";
+import { getRewritableCallers, isRewritableCaller, toSwcExtraCallers } from "./transform.mjs";
 import { I18NEXT_CALLERS } from "./compat/i18next.mjs";
 import { LINGUI_CALLERS } from "./compat/lingui.mjs";
 import { NEXT_INTL_CALLERS } from "./compat/nextIntl.mjs";
@@ -68,5 +68,5 @@ const isCallerActive = (descriptor, fileImportSources) => {
 };
 
 //#endregion
-export { ALL_CALLERS, BASE_CALLERS, CALLERS_BY_NAME, COMPAT_CALLERS, I18NEXT_CALLERS, LINGUI_CALLERS, NEXT_INTL_CALLERS, REACT_I18NEXT_CALLERS, REACT_INTL_CALLERS, USE_INTL_CALLERS, VUE_I18N_CALLERS, getPositionalKeyCallerNames, getRewritableCallers, isCallerActive, toSwcExtraCallers };
+export { ALL_CALLERS, BASE_CALLERS, CALLERS_BY_NAME, COMPAT_CALLERS, I18NEXT_CALLERS, LINGUI_CALLERS, NEXT_INTL_CALLERS, REACT_I18NEXT_CALLERS, REACT_INTL_CALLERS, USE_INTL_CALLERS, VUE_I18N_CALLERS, getPositionalKeyCallerNames, getRewritableCallers, isCallerActive, isRewritableCaller, toSwcExtraCallers };
 //# sourceMappingURL=index.mjs.map

package/dist/esm/callers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/callers/index.ts"],"sourcesContent":["import { BASE_CALLERS } from './base';\nimport { I18NEXT_CALLERS } from './compat/i18next';\nimport { LINGUI_CALLERS } from './compat/lingui';\nimport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nimport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nimport { REACT_INTL_CALLERS } from './compat/reactIntl';\nimport { USE_INTL_CALLERS } from './compat/useIntl';\nimport { VUE_I18N_CALLERS } from './compat/vueI18n';\nimport type { CallerDescriptor } from './types';\n\nexport { BASE_CALLERS } from './base';\nexport { I18NEXT_CALLERS } from './compat/i18next';\nexport { LINGUI_CALLERS } from './compat/lingui';\nexport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nexport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nexport { REACT_INTL_CALLERS } from './compat/reactIntl';\nexport { USE_INTL_CALLERS } from './compat/useIntl';\nexport { VUE_I18N_CALLERS } from './compat/vueI18n';\nexport {\n  getRewritableCallers,\n  type SwcExtraCallerConfig,\n  toSwcExtraCallers,\n} from './transform';\nexport type {\n  CallerDescriptor,\n  CallerResultShape,\n  CallerValueSource,\n} from './types';\n\n/**\n * Compat-adapter callers, grouped in one list. Each compat package's bundler\n * plugin injects its own slice (e.g. `REACT_I18NEXT_CALLERS`) into the build\n * pipeline; this aggregate exists for consumers that need every syntax at\n * once, such as the LSP.\n */\nexport const COMPAT_CALLERS: CallerDescriptor[] = [\n  ...I18NEXT_CALLERS,\n  ...REACT_I18NEXT_CALLERS,\n  ...NEXT_INTL_CALLERS,\n  ...USE_INTL_CALLERS,\n  ...REACT_INTL_CALLERS,\n  ...LINGUI_CALLERS,\n  ...VUE_I18N_CALLERS,\n];\n\n/** Base + compat callers — the full registry the matchers run against. */\nexport const ALL_CALLERS: CallerDescriptor[] = [\n  ...BASE_CALLERS,\n  ...COMPAT_CALLERS,\n];\n\n/**\n * Descriptors indexed by caller name. A name can map to several descriptors\n * (e.g. `Trans` exists in both react-i18next and lingui with different\n * attributes); matchers try them in registry order.\n */\nexport const CALLERS_BY_NAME: Map<string, CallerDescriptor[]> = (() => {\n  const byName = new Map<string, CallerDescriptor[]>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const existing = byName.get(descriptor.callerName);\n\n    if (existing) {\n      existing.push(descriptor);\n    } else {\n      byName.set(descriptor.callerName, [descriptor]);\n    }\n  }\n\n  return byName;\n})();\n\n/**\n * Caller names whose dictionary key can appear as a positional string literal\n * argument (`caller('key', …)` / `caller(locale, 'key', …)`). Used to build\n * text-search regexes over project source files (find-references) and the\n * completion trigger pattern. Callers whose key never appears positionally\n * (fixed namespace, options object, JSX-only) are excluded on purpose.\n */\nexport const getPositionalKeyCallerNames = (): string[] => {\n  const names = new Set<string>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const hasPositionalNamespace = descriptor.namespaceSources.some(\n      (source) => source.from === 'argument'\n    );\n\n    if (hasPositionalNamespace) names.add(descriptor.callerName);\n  }\n\n  return [...names];\n};\n\n/**\n * Returns `true` when the descriptor may participate in matching for a file\n * importing from `importSources`. Descriptors flagged `requiresImport` only\n * activate when the file imports from one of their declared modules;\n * everything else is always active (results are still validated against the\n * project's dictionaries downstream).\n *\n * @param descriptor - The caller descriptor to gate.\n * @param fileImportSources - Module specifiers imported by the analysed file.\n */\nexport const isCallerActive = (\n  descriptor: CallerDescriptor,\n  fileImportSources: ReadonlySet<string>\n): boolean => {\n  if (!descriptor.requiresImport) return true;\n\n  return descriptor.importSources.some((source) =>\n    fileImportSources.has(source)\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAmCA,MAAa,iBAAqC;CAChD,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL;;AAGA,MAAa,cAAkC,CAC7C,GAAG,cACH,GAAG,cACL;;;;;;AAOA,MAAa,yBAA0D;CACrE,MAAM,yBAAS,IAAI,IAAgC;CAEnD,KAAK,MAAM,cAAc,aAAa;EACpC,MAAM,WAAW,OAAO,IAAI,WAAW,UAAU;EAEjD,IAAI,UACF,SAAS,KAAK,UAAU;OAExB,OAAO,IAAI,WAAW,YAAY,CAAC,UAAU,CAAC;CAElD;CAEA,OAAO;AACT,EAAC,CAAE;;;;;;;;AASH,MAAa,oCAA8C;CACzD,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,cAAc,aAKvB,IAJ+B,WAAW,iBAAiB,MACxD,WAAW,OAAO,SAAS,UAGL,GAAG,MAAM,IAAI,WAAW,UAAU;CAG7D,OAAO,CAAC,GAAG,KAAK;AAClB;;;;;;;;;;;AAYA,MAAa,kBACX,YACA,sBACY;CACZ,IAAI,CAAC,WAAW,gBAAgB,OAAO;CAEvC,OAAO,WAAW,cAAc,MAAM,WACpC,kBAAkB,IAAI,MAAM,CAC9B;AACF"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/callers/index.ts"],"sourcesContent":["import { BASE_CALLERS } from './base';\nimport { I18NEXT_CALLERS } from './compat/i18next';\nimport { LINGUI_CALLERS } from './compat/lingui';\nimport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nimport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nimport { REACT_INTL_CALLERS } from './compat/reactIntl';\nimport { USE_INTL_CALLERS } from './compat/useIntl';\nimport { VUE_I18N_CALLERS } from './compat/vueI18n';\nimport type { CallerDescriptor } from './types';\n\nexport { BASE_CALLERS } from './base';\nexport { I18NEXT_CALLERS } from './compat/i18next';\nexport { LINGUI_CALLERS } from './compat/lingui';\nexport { NEXT_INTL_CALLERS } from './compat/nextIntl';\nexport { REACT_I18NEXT_CALLERS } from './compat/reactI18next';\nexport { REACT_INTL_CALLERS } from './compat/reactIntl';\nexport { USE_INTL_CALLERS } from './compat/useIntl';\nexport { VUE_I18N_CALLERS } from './compat/vueI18n';\nexport {\n  getRewritableCallers,\n  isRewritableCaller,\n  type SwcExtraCallerConfig,\n  toSwcExtraCallers,\n} from './transform';\nexport type {\n  CallerDescriptor,\n  CallerResultShape,\n  CallerValueSource,\n} from './types';\n\n/**\n * Compat-adapter callers, grouped in one list. Each compat package's bundler\n * plugin injects its own slice (e.g. `REACT_I18NEXT_CALLERS`) into the build\n * pipeline; this aggregate exists for consumers that need every syntax at\n * once, such as the LSP.\n */\nexport const COMPAT_CALLERS: CallerDescriptor[] = [\n  ...I18NEXT_CALLERS,\n  ...REACT_I18NEXT_CALLERS,\n  ...NEXT_INTL_CALLERS,\n  ...USE_INTL_CALLERS,\n  ...REACT_INTL_CALLERS,\n  ...LINGUI_CALLERS,\n  ...VUE_I18N_CALLERS,\n];\n\n/** Base + compat callers — the full registry the matchers run against. */\nexport const ALL_CALLERS: CallerDescriptor[] = [\n  ...BASE_CALLERS,\n  ...COMPAT_CALLERS,\n];\n\n/**\n * Descriptors indexed by caller name. A name can map to several descriptors\n * (e.g. `Trans` exists in both react-i18next and lingui with different\n * attributes); matchers try them in registry order.\n */\nexport const CALLERS_BY_NAME: Map<string, CallerDescriptor[]> = (() => {\n  const byName = new Map<string, CallerDescriptor[]>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const existing = byName.get(descriptor.callerName);\n\n    if (existing) {\n      existing.push(descriptor);\n    } else {\n      byName.set(descriptor.callerName, [descriptor]);\n    }\n  }\n\n  return byName;\n})();\n\n/**\n * Caller names whose dictionary key can appear as a positional string literal\n * argument (`caller('key', …)` / `caller(locale, 'key', …)`). Used to build\n * text-search regexes over project source files (find-references) and the\n * completion trigger pattern. Callers whose key never appears positionally\n * (fixed namespace, options object, JSX-only) are excluded on purpose.\n */\nexport const getPositionalKeyCallerNames = (): string[] => {\n  const names = new Set<string>();\n\n  for (const descriptor of ALL_CALLERS) {\n    const hasPositionalNamespace = descriptor.namespaceSources.some(\n      (source) => source.from === 'argument'\n    );\n\n    if (hasPositionalNamespace) names.add(descriptor.callerName);\n  }\n\n  return [...names];\n};\n\n/**\n * Returns `true` when the descriptor may participate in matching for a file\n * importing from `importSources`. Descriptors flagged `requiresImport` only\n * activate when the file imports from one of their declared modules;\n * everything else is always active (results are still validated against the\n * project's dictionaries downstream).\n *\n * @param descriptor - The caller descriptor to gate.\n * @param fileImportSources - Module specifiers imported by the analysed file.\n */\nexport const isCallerActive = (\n  descriptor: CallerDescriptor,\n  fileImportSources: ReadonlySet<string>\n): boolean => {\n  if (!descriptor.requiresImport) return true;\n\n  return descriptor.importSources.some((source) =>\n    fileImportSources.has(source)\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAoCA,MAAa,iBAAqC;CAChD,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;CACH,GAAG;AACL;;AAGA,MAAa,cAAkC,CAC7C,GAAG,cACH,GAAG,cACL;;;;;;AAOA,MAAa,yBAA0D;CACrE,MAAM,yBAAS,IAAI,IAAgC;CAEnD,KAAK,MAAM,cAAc,aAAa;EACpC,MAAM,WAAW,OAAO,IAAI,WAAW,UAAU;EAEjD,IAAI,UACF,SAAS,KAAK,UAAU;OAExB,OAAO,IAAI,WAAW,YAAY,CAAC,UAAU,CAAC;CAElD;CAEA,OAAO;AACT,EAAC,CAAE;;;;;;;;AASH,MAAa,oCAA8C;CACzD,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,cAAc,aAKvB,IAJ+B,WAAW,iBAAiB,MACxD,WAAW,OAAO,SAAS,UAGL,GAAG,MAAM,IAAI,WAAW,UAAU;CAG7D,OAAO,CAAC,GAAG,KAAK;AAClB;;;;;;;;;;;AAYA,MAAa,kBACX,YACA,sBACY;CACZ,IAAI,CAAC,WAAW,gBAAgB,OAAO;CAEvC,OAAO,WAAW,cAAc,MAAM,WACpC,kBAAkB,IAAI,MAAM,CAC9B;AACF"}

package/dist/esm/callers/transform.mjs

@@ -1,23 +1,29 @@
 //#region src/callers/transform.ts
 /**
-* Returns the callers of a registry slice that the optimize pass can rewrite
-* at build time: plain imported functions carrying both replacement names.
+* Whether the optimize pass can rewrite this caller's call sites at build time.
 *
-* Method-matched callers (`i18n.getFixedT`) and JSX components are excluded —
-* their call sites cannot be re-pointed through an import specifier rename.
+* Requires both replacement names and a call shape reachable through an import
+* specifier rename. Method-matched callers (`i18n.getFixedT`, `intl.formatMessage`)
+* and JSX components (`<Trans>`, `<FormattedMessage>`) are excluded — their call
+* sites keep resolving through the runtime dictionary registry.
+*/
+const isRewritableCaller = (descriptor) => descriptor.staticReplacement !== void 0 && descriptor.dynamicReplacement !== void 0 && descriptor.matchAsMethod !== true && descriptor.jsxIdAttribute === void 0;
+/**
+* Returns the callers of a registry slice that the optimize pass can rewrite
+* at build time. See {@link isRewritableCaller}.
 */
-const getRewritableCallers = (descriptors) => descriptors.filter((descriptor) => descriptor.staticReplacement !== void 0 && descriptor.dynamicReplacement !== void 0 && descriptor.matchAsMethod !== true && descriptor.jsxIdAttribute === void 0);
+const getRewritableCallers = (descriptors) => descriptors.filter(isRewritableCaller);
 const findSource = (sources, from) => sources.find((source) => source.from === from);
 /**
 * Serialises the rewritable callers of a registry slice into the
 * `@intlayer/swc` plugin wire format (`extraCallers` option).
 *
-* Callers whose namespace can only be derived per-message id
-* (`path-first-segment`) are skipped: the transform cannot bind a single
-* dictionary to the call site.
+* A caller with no statically readable namespace source is dropped: the plugin
+* binds a dictionary from an argument, an option property or a fixed value
+* only, so forwarding it would emit a descriptor no call site can match.
 *
 * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.
-* @returns Configs ready to pass as `swcExtraCallers` / `extraCallers`.
+* @returns Configs ready to pass as the plugin's `extraCallers` option.
 */
 const toSwcExtraCallers = (descriptors) => getRewritableCallers(descriptors).flatMap((descriptor) => {
 	const argumentSource = findSource(descriptor.namespaceSources, "argument");
@@ -39,5 +45,5 @@ const toSwcExtraCallers = (descriptors) => getRewritableCallers(descriptors).fla
 });
 
 //#endregion
-export { getRewritableCallers, toSwcExtraCallers };
+export { getRewritableCallers, isRewritableCaller, toSwcExtraCallers };
 //# sourceMappingURL=transform.mjs.map

package/dist/esm/callers/transform.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transform.mjs","names":[],"sources":["../../../src/callers/transform.ts"],"sourcesContent":["import type { CallerDescriptor, CallerValueSource } from './types';\n\n/**\n * Wire format of an extra caller forwarded to the `@intlayer/swc` plugin.\n *\n * Field names mirror the serde attributes of `ExtraCallerConfig` in\n * `packages/@intlayer/swc/src/lib.rs` — both sides must stay in sync.\n */\nexport type SwcExtraCallerConfig = {\n  /** The function name the user calls, e.g. `\"useTranslation\"`. */\n  callerName: string;\n  /** Module specifiers exporting the function (original + `@intlayer/*`). */\n  importSources: string[];\n  /**\n   * Zero-based index of the positional argument holding the namespace string.\n   * Omitted for fixed/option namespace callers.\n   */\n  namespaceArgIndex?: number;\n  /**\n   * Compile-time constant namespace — the dictionary ident is inserted as a\n   * new first argument (lingui's `useLingui()`).\n   */\n  fixedNamespace?: string;\n  /**\n   * Namespace read from a property of an options-object argument — the\n   * dictionary ident is inserted as a new first argument and the property is\n   * rewritten to the key-prefix remainder (vue-i18n's `useI18n({ namespace })`).\n   */\n  namespaceOption?: { argumentIndex: number; property: string };\n  /** Replacement function name for static import mode, e.g. `\"useDictionary\"`. */\n  staticReplacement: string;\n  /** Replacement function name for dynamic/fetch mode, e.g. `\"useDictionaryDynamic\"`. */\n  dynamicReplacement: string;\n};\n\n/**\n * Returns the callers of a registry slice that the optimize pass can rewrite\n * at build time: plain imported functions carrying both replacement names.\n *\n * Method-matched callers (`i18n.getFixedT`) and JSX components are excluded —\n * their call sites cannot be re-pointed through an import specifier rename.\n */\nexport const getRewritableCallers = (\n  descriptors: CallerDescriptor[]\n): CallerDescriptor[] =>\n  descriptors.filter(\n    (descriptor) =>\n      descriptor.staticReplacement !== undefined &&\n      descriptor.dynamicReplacement !== undefined &&\n      descriptor.matchAsMethod !== true &&\n      descriptor.jsxIdAttribute === undefined\n  );\n\nconst findSource = <F extends CallerValueSource['from']>(\n  sources: CallerValueSource[],\n  from: F\n): Extract<CallerValueSource, { from: F }> | undefined =>\n  sources.find(\n    (source): source is Extract<CallerValueSource, { from: F }> =>\n      source.from === from\n  );\n\n/**\n * Serialises the rewritable callers of a registry slice into the\n * `@intlayer/swc` plugin wire format (`extraCallers` option).\n *\n * Callers whose namespace can only be derived per-message id\n * (`path-first-segment`) are skipped: the transform cannot bind a single\n * dictionary to the call site.\n *\n * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.\n * @returns Configs ready to pass as `swcExtraCallers` / `extraCallers`.\n */\nexport const toSwcExtraCallers = (\n  descriptors: CallerDescriptor[]\n): SwcExtraCallerConfig[] =>\n  getRewritableCallers(descriptors).flatMap((descriptor) => {\n    const argumentSource = findSource(descriptor.namespaceSources, 'argument');\n    const optionSource = findSource(descriptor.namespaceSources, 'option');\n    const fixedSource = findSource(descriptor.namespaceSources, 'fixed');\n\n    if (!argumentSource && !optionSource && !fixedSource) return [];\n\n    return [\n      {\n        callerName: descriptor.callerName,\n        importSources: descriptor.importSources,\n        ...(argumentSource ? { namespaceArgIndex: argumentSource.index } : {}),\n        ...(fixedSource ? { fixedNamespace: fixedSource.value } : {}),\n        ...(optionSource\n          ? {\n              namespaceOption: {\n                argumentIndex: optionSource.argumentIndex,\n                property: optionSource.property,\n              },\n            }\n          : {}),\n        staticReplacement: descriptor.staticReplacement!,\n        dynamicReplacement: descriptor.dynamicReplacement!,\n      },\n    ];\n  });\n"],"mappings":";;;;;;;;AA0CA,MAAa,wBACX,gBAEA,YAAY,QACT,eACC,WAAW,sBAAsB,UACjC,WAAW,uBAAuB,UAClC,WAAW,kBAAkB,QAC7B,WAAW,mBAAmB,MAClC;AAEF,MAAM,cACJ,SACA,SAEA,QAAQ,MACL,WACC,OAAO,SAAS,IACpB;;;;;;;;;;;;AAaF,MAAa,qBACX,gBAEA,qBAAqB,WAAW,CAAC,CAAC,SAAS,eAAe;CACxD,MAAM,iBAAiB,WAAW,WAAW,kBAAkB,UAAU;CACzE,MAAM,eAAe,WAAW,WAAW,kBAAkB,QAAQ;CACrE,MAAM,cAAc,WAAW,WAAW,kBAAkB,OAAO;CAEnE,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,aAAa,OAAO,CAAC;CAE9D,OAAO,CACL;EACE,YAAY,WAAW;EACvB,eAAe,WAAW;EAC1B,GAAI,iBAAiB,EAAE,mBAAmB,eAAe,MAAM,IAAI,CAAC;EACpE,GAAI,cAAc,EAAE,gBAAgB,YAAY,MAAM,IAAI,CAAC;EAC3D,GAAI,eACA,EACE,iBAAiB;GACf,eAAe,aAAa;GAC5B,UAAU,aAAa;EACzB,EACF,IACA,CAAC;EACL,mBAAmB,WAAW;EAC9B,oBAAoB,WAAW;CACjC,CACF;AACF,CAAC"}
+{"version":3,"file":"transform.mjs","names":[],"sources":["../../../src/callers/transform.ts"],"sourcesContent":["import type { CallerDescriptor, CallerValueSource } from './types';\n\n/**\n * Wire format of an extra caller forwarded to the `@intlayer/swc` plugin.\n *\n * Field names mirror the serde attributes of `ExtraCallerConfig` in\n * `packages/@intlayer/swc/src/lib.rs` — both sides must stay in sync.\n */\nexport type SwcExtraCallerConfig = {\n  /** The function name the user calls, e.g. `\"useTranslation\"`. */\n  callerName: string;\n  /** Module specifiers exporting the function (original + `@intlayer/*`). */\n  importSources: string[];\n  /**\n   * Zero-based index of the positional argument holding the namespace string.\n   * Omitted for fixed/option namespace callers.\n   */\n  namespaceArgIndex?: number;\n  /**\n   * Compile-time constant namespace — the dictionary ident is inserted as a\n   * new first argument (lingui's `useLingui()`).\n   */\n  fixedNamespace?: string;\n  /**\n   * Namespace read from a property of an options-object argument — the\n   * dictionary ident is inserted as a new first argument and the property is\n   * rewritten to the key-prefix remainder (vue-i18n's `useI18n({ namespace })`).\n   */\n  namespaceOption?: { argumentIndex: number; property: string };\n  /** Replacement function name for static import mode, e.g. `\"useDictionary\"`. */\n  staticReplacement: string;\n  /** Replacement function name for dynamic/fetch mode, e.g. `\"useDictionaryDynamic\"`. */\n  dynamicReplacement: string;\n};\n\n/**\n * Whether the optimize pass can rewrite this caller's call sites at build time.\n *\n * Requires both replacement names and a call shape reachable through an import\n * specifier rename. Method-matched callers (`i18n.getFixedT`, `intl.formatMessage`)\n * and JSX components (`<Trans>`, `<FormattedMessage>`) are excluded — their call\n * sites keep resolving through the runtime dictionary registry.\n */\nexport const isRewritableCaller = (descriptor: CallerDescriptor): boolean =>\n  descriptor.staticReplacement !== undefined &&\n  descriptor.dynamicReplacement !== undefined &&\n  descriptor.matchAsMethod !== true &&\n  descriptor.jsxIdAttribute === undefined;\n\n/**\n * Returns the callers of a registry slice that the optimize pass can rewrite\n * at build time. See {@link isRewritableCaller}.\n */\nexport const getRewritableCallers = (\n  descriptors: CallerDescriptor[]\n): CallerDescriptor[] => descriptors.filter(isRewritableCaller);\n\nconst findSource = <F extends CallerValueSource['from']>(\n  sources: CallerValueSource[],\n  from: F\n): Extract<CallerValueSource, { from: F }> | undefined =>\n  sources.find(\n    (source): source is Extract<CallerValueSource, { from: F }> =>\n      source.from === from\n  );\n\n/**\n * Serialises the rewritable callers of a registry slice into the\n * `@intlayer/swc` plugin wire format (`extraCallers` option).\n *\n * A caller with no statically readable namespace source is dropped: the plugin\n * binds a dictionary from an argument, an option property or a fixed value\n * only, so forwarding it would emit a descriptor no call site can match.\n *\n * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.\n * @returns Configs ready to pass as the plugin's `extraCallers` option.\n */\nexport const toSwcExtraCallers = (\n  descriptors: CallerDescriptor[]\n): SwcExtraCallerConfig[] =>\n  getRewritableCallers(descriptors).flatMap((descriptor) => {\n    const argumentSource = findSource(descriptor.namespaceSources, 'argument');\n    const optionSource = findSource(descriptor.namespaceSources, 'option');\n    const fixedSource = findSource(descriptor.namespaceSources, 'fixed');\n\n    if (!argumentSource && !optionSource && !fixedSource) return [];\n\n    return [\n      {\n        callerName: descriptor.callerName,\n        importSources: descriptor.importSources,\n        ...(argumentSource ? { namespaceArgIndex: argumentSource.index } : {}),\n        ...(fixedSource ? { fixedNamespace: fixedSource.value } : {}),\n        ...(optionSource\n          ? {\n              namespaceOption: {\n                argumentIndex: optionSource.argumentIndex,\n                property: optionSource.property,\n              },\n            }\n          : {}),\n        staticReplacement: descriptor.staticReplacement!,\n        dynamicReplacement: descriptor.dynamicReplacement!,\n      },\n    ];\n  });\n"],"mappings":";;;;;;;;;AA2CA,MAAa,sBAAsB,eACjC,WAAW,sBAAsB,UACjC,WAAW,uBAAuB,UAClC,WAAW,kBAAkB,QAC7B,WAAW,mBAAmB;;;;;AAMhC,MAAa,wBACX,gBACuB,YAAY,OAAO,kBAAkB;AAE9D,MAAM,cACJ,SACA,SAEA,QAAQ,MACL,WACC,OAAO,SAAS,IACpB;;;;;;;;;;;;AAaF,MAAa,qBACX,gBAEA,qBAAqB,WAAW,CAAC,CAAC,SAAS,eAAe;CACxD,MAAM,iBAAiB,WAAW,WAAW,kBAAkB,UAAU;CACzE,MAAM,eAAe,WAAW,WAAW,kBAAkB,QAAQ;CACrE,MAAM,cAAc,WAAW,WAAW,kBAAkB,OAAO;CAEnE,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,aAAa,OAAO,CAAC;CAE9D,OAAO,CACL;EACE,YAAY,WAAW;EACvB,eAAe,WAAW;EAC1B,GAAI,iBAAiB,EAAE,mBAAmB,eAAe,MAAM,IAAI,CAAC;EACpE,GAAI,cAAc,EAAE,gBAAgB,YAAY,MAAM,IAAI,CAAC;EAC3D,GAAI,eACA,EACE,iBAAiB;GACf,eAAe,aAAa;GAC5B,UAAU,aAAa;EACzB,EACF,IACA,CAAC;EACL,mBAAmB,WAAW;EAC9B,oBAAoB,WAAW;CACjC,CACF;AACF,CAAC"}

package/dist/types/callers/compat/lingui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lingui.d.ts","names":[],"sources":["../../../../src/callers/compat/lingui.ts"],"mappings":";;qBAwBa,gBAAgB"}
+{"version":3,"file":"lingui.d.ts","names":[],"sources":["../../../../src/callers/compat/lingui.ts"],"mappings":";;qBA8Ba,gBAAgB"}

package/dist/types/callers/index.d.ts

@@ -7,7 +7,7 @@ import { REACT_I18NEXT_CALLERS } from "./compat/reactI18next.js";
 import { REACT_INTL_CALLERS } from "./compat/reactIntl.js";
 import { USE_INTL_CALLERS } from "./compat/useIntl.js";
 import { VUE_I18N_CALLERS } from "./compat/vueI18n.js";
-import { SwcExtraCallerConfig, getRewritableCallers, toSwcExtraCallers } from "./transform.js";
+import { SwcExtraCallerConfig, getRewritableCallers, isRewritableCaller, toSwcExtraCallers } from "./transform.js";
 //#region src/callers/index.d.ts
 /**
  * Compat-adapter callers, grouped in one list. Each compat package's bundler
@@ -44,5 +44,5 @@ export declare const getPositionalKeyCallerNames: () => string[];
  */
 export declare const isCallerActive: (descriptor: CallerDescriptor, fileImportSources: ReadonlySet<string>) => boolean;
 //#endregion
-export { BASE_CALLERS, type CallerDescriptor, type CallerResultShape, type CallerValueSource, I18NEXT_CALLERS, LINGUI_CALLERS, NEXT_INTL_CALLERS, REACT_I18NEXT_CALLERS, REACT_INTL_CALLERS, type SwcExtraCallerConfig, USE_INTL_CALLERS, VUE_I18N_CALLERS, getRewritableCallers, toSwcExtraCallers };
+export { BASE_CALLERS, type CallerDescriptor, type CallerResultShape, type CallerValueSource, I18NEXT_CALLERS, LINGUI_CALLERS, NEXT_INTL_CALLERS, REACT_I18NEXT_CALLERS, REACT_INTL_CALLERS, type SwcExtraCallerConfig, USE_INTL_CALLERS, VUE_I18N_CALLERS, getRewritableCallers, isRewritableCaller, toSwcExtraCallers };
 //# sourceMappingURL=index.d.ts.map

package/dist/types/callers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/callers/index.ts"],"mappings":";;;;;;;;;;;;;;;;;qBAmCa,gBAAgB;;qBAWhB,aAAa;;;;;;qBAUb,iBAAiB,YAAY;;;;;;;;qBAuB7B;;;;;;;;;;;qBAwBA,iBAAc,YACb,kBAAgB,mBACT"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/callers/index.ts"],"mappings":";;;;;;;;;;;;;;;;;qBAoCa,gBAAgB;;qBAWhB,aAAa;;;;;;qBAUb,iBAAiB,YAAY;;;;;;;;qBAuB7B;;;;;;;;;;;qBAwBA,iBAAc,YACb,kBAAgB,mBACT"}

package/dist/types/callers/transform.d.ts

@@ -36,23 +36,29 @@ export type SwcExtraCallerConfig = {
   dynamicReplacement: string;
 };
 /**
- * Returns the callers of a registry slice that the optimize pass can rewrite
- * at build time: plain imported functions carrying both replacement names.
+ * Whether the optimize pass can rewrite this caller's call sites at build time.
  *
- * Method-matched callers (`i18n.getFixedT`) and JSX components are excluded —
- * their call sites cannot be re-pointed through an import specifier rename.
+ * Requires both replacement names and a call shape reachable through an import
+ * specifier rename. Method-matched callers (`i18n.getFixedT`, `intl.formatMessage`)
+ * and JSX components (`<Trans>`, `<FormattedMessage>`) are excluded — their call
+ * sites keep resolving through the runtime dictionary registry.
+ */
+export declare const isRewritableCaller: (descriptor: CallerDescriptor) => boolean;
+/**
+ * Returns the callers of a registry slice that the optimize pass can rewrite
+ * at build time. See {@link isRewritableCaller}.
  */
 export declare const getRewritableCallers: (descriptors: CallerDescriptor[]) => CallerDescriptor[];
 /**
  * Serialises the rewritable callers of a registry slice into the
  * `@intlayer/swc` plugin wire format (`extraCallers` option).
  *
- * Callers whose namespace can only be derived per-message id
- * (`path-first-segment`) are skipped: the transform cannot bind a single
- * dictionary to the call site.
+ * A caller with no statically readable namespace source is dropped: the plugin
+ * binds a dictionary from an argument, an option property or a fixed value
+ * only, so forwarding it would emit a descriptor no call site can match.
  *
  * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.
- * @returns Configs ready to pass as `swcExtraCallers` / `extraCallers`.
+ * @returns Configs ready to pass as the plugin's `extraCallers` option.
  */
 export declare const toSwcExtraCallers: (descriptors: CallerDescriptor[]) => SwcExtraCallerConfig[];
 //#endregion

package/dist/types/callers/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","names":[],"sources":["../../../src/callers/transform.ts"],"mappings":";;;;;;;;YAQY;;EAEV;;EAEA;;;;;EAKA;;;;;EAKA;;;;;;EAMA;IAAoB;IAAuB;;;EAE3C;;EAEA;;;;;;;;;qBAUW,uBAAoB,aAClB,uBACZ;;;;;;;;;;;;qBA6BU,oBAAiB,aACf,uBACZ"}
+{"version":3,"file":"transform.d.ts","names":[],"sources":["../../../src/callers/transform.ts"],"mappings":";;;;;;;;YAQY;;EAEV;;EAEA;;;;;EAKA;;;;;EAKA;;;;;;EAMA;IAAoB;IAAuB;;;EAE3C;;EAEA;;;;;;;;;;qBAWW,qBAAkB,YAAgB;;;;;qBAUlC,uBAAoB,aAClB,uBACZ;;;;;;;;;;;;qBAsBU,oBAAiB,aACf,uBACZ"}

package/dist/types/callers/types.d.ts

@@ -129,6 +129,12 @@ export type CallerDescriptor = {
    * When `true`, the caller may be invoked without any namespace
    * (`useTranslations()` root scope) — the dictionary key is then the first
    * dot-segment of each message id passed to the returned `t()`.
+   *
+   * Analysis-only: the LSP resolves such bindings for go-to-definition, and
+   * the ESLint rule stops reporting the missing argument as a dynamic key.
+   * The optimize passes do **not** honour it — a call with no readable
+   * namespace is left to the runtime registry, so declaring it never changes
+   * the emitted bundle.
    */
   allowRootScope?: boolean;
   /** How translated content is obtained from the caller's result. */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/callers/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;YAyBY;;;EAEN;EAAkB;;;;EAElB;EAAgB;EAAuB;;;;;;;EAKvC;EAAe;;;;;;;;EAMf;;;;;;;;;;;;;;;;;;YAkBM;;;;YAUA;;EAEV;;EAEA;;;;;;EAMA;;;;;;EAMA;;;;;;EAMA;;EAEA;;;;;;EAMA;;;;;EAKA;;;;;EAKA,kBAAkB;;;;;;EAMlB,mBAAmB;;;;;;;EAOnB;;;;;;EAMA;;EAEA,qBAAqB;;;;;;EAMrB;;;;;;;;;;EAUA;;;;;EAKA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/callers/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;YAyBY;;;EAEN;EAAkB;;;;EAElB;EAAgB;EAAuB;;;;;;;EAKvC;EAAe;;;;;;;;EAMf;;;;;;;;;;;;;;;;;;YAkBM;;;;YAUA;;EAEV;;EAEA;;;;;;EAMA;;;;;;EAMA;;;;;;EAMA;;EAEA;;;;;;EAMA;;;;;EAKA;;;;;EAKA,kBAAkB;;;;;;EAMlB,mBAAmB;;;;;;;EAOnB;;;;;;;;;;;;EAYA;;EAEA,qBAAqB;;;;;;EAMrB;;;;;;;;;;EAUA;;;;;EAKA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "9.4.4",
+  "version": "9.5.0",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -189,7 +189,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.4.4",
+    "@intlayer/types": "9.5.0",
     "defu": "6.1.7",
     "dotenv": "17.4.2",
     "esbuild": "0.28.2",
@@ -197,7 +197,7 @@
     "zod": "4.5.4"
   },
   "devDependencies": {
-    "@types/node": "26.4.1",
+    "@types/node": "26.5.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",