@intlayer/config 9.0.0-canary.11 → 9.0.0-canary.14

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

@@ -0,0 +1,42 @@
+//#region src/callers/compat/nextIntl.ts
+/**
+* next-intl — `@intlayer/next-intl` compat adapter.
+*
+* Mirrors `compat/next-intl/src/plugin/index.ts` (`NEXT_INTL_SWC_CALLERS`),
+* adding the `getTranslations({ locale, namespace })` object overload.
+*/
+const NEXT_INTL_CALLERS = [{
+	callerName: "useTranslations",
+	library: "next-intl",
+	importSources: ["next-intl", "@intlayer/next-intl"],
+	namespaceSources: [{
+		from: "argument",
+		index: 0
+	}],
+	translationFunction: "return-value",
+	nestedNamespace: true,
+	allowRootScope: true,
+	staticReplacement: "useDictionary",
+	dynamicReplacement: "useDictionaryDynamic"
+}, {
+	callerName: "getTranslations",
+	library: "next-intl",
+	importSources: ["next-intl/server", "@intlayer/next-intl/server"],
+	namespaceSources: [{
+		from: "argument",
+		index: 0
+	}, {
+		from: "option",
+		argumentIndex: 0,
+		property: "namespace"
+	}],
+	translationFunction: "return-value",
+	nestedNamespace: true,
+	allowRootScope: true,
+	staticReplacement: "getDictionary",
+	dynamicReplacement: "getDictionaryDynamic"
+}];
+
+//#endregion
+export { NEXT_INTL_CALLERS };
+//# sourceMappingURL=nextIntl.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextIntl.mjs","names":[],"sources":["../../../../src/callers/compat/nextIntl.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * next-intl — `@intlayer/next-intl` compat adapter.\n *\n * Mirrors `compat/next-intl/src/plugin/index.ts` (`NEXT_INTL_SWC_CALLERS`),\n * adding the `getTranslations({ locale, namespace })` object overload.\n */\nexport const NEXT_INTL_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useTranslations',\n    library: 'next-intl',\n    importSources: ['next-intl', '@intlayer/next-intl'],\n    namespaceSources: [{ from: 'argument', index: 0 }],\n    translationFunction: 'return-value',\n    // useTranslations('about.counter') → dictionary `about`, prefix `counter`\n    nestedNamespace: true,\n    // bare useTranslations() → first id segment is the dictionary\n    allowRootScope: true,\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: 'getTranslations',\n    library: 'next-intl',\n    importSources: ['next-intl/server', '@intlayer/next-intl/server'],\n    // Both overloads: getTranslations('ns') and\n    // getTranslations({ locale, namespace: 'ns' }).\n    namespaceSources: [\n      { from: 'argument', index: 0 },\n      { from: 'option', argumentIndex: 0, property: 'namespace' },\n    ],\n    translationFunction: 'return-value',\n    nestedNamespace: true,\n    allowRootScope: true,\n    staticReplacement: 'getDictionary',\n    dynamicReplacement: 'getDictionaryDynamic',\n  },\n];\n"],"mappings":";;;;;;;AAQA,MAAa,oBAAwC,CACnD;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,aAAa,sBAAsB;CACnD,kBAAkB,CAAC;EAAE,MAAM;EAAY,OAAO;EAAG,CAAC;CAClD,qBAAqB;CAErB,iBAAiB;CAEjB,gBAAgB;CAChB,mBAAmB;CACnB,oBAAoB;CACrB,EACD;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,oBAAoB,6BAA6B;CAGjE,kBAAkB,CAChB;EAAE,MAAM;EAAY,OAAO;EAAG,EAC9B;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;EAAa,CAC5D;CACD,qBAAqB;CACrB,iBAAiB;CACjB,gBAAgB;CAChB,mBAAmB;CACnB,oBAAoB;CACrB,CACF"}

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

@@ -0,0 +1,48 @@
+//#region src/callers/compat/reactI18next.ts
+/**
+* react-i18next / next-i18next — `@intlayer/react-i18next` and
+* `@intlayer/next-i18next` compat adapters (next-i18next re-exports the
+* react-i18next hook, so both libraries share the same callers).
+*
+* Mirrors `compat/react-i18next/src/plugin/index.ts` and
+* `compat/next-i18next/src/plugin/index.ts`.
+*/
+const REACT_I18NEXT_CALLERS = [{
+	callerName: "useTranslation",
+	library: "react-i18next",
+	importSources: [
+		"react-i18next",
+		"next-i18next",
+		"@intlayer/react-i18next",
+		"@intlayer/next-i18next"
+	],
+	namespaceSources: [{
+		from: "argument",
+		index: 0
+	}],
+	keyPrefixSources: [{
+		from: "option",
+		argumentIndex: 1,
+		property: "keyPrefix"
+	}],
+	translationFunction: "destructured-t",
+	staticReplacement: "useDictionary",
+	dynamicReplacement: "useDictionaryDynamic"
+}, {
+	callerName: "Trans",
+	library: "react-i18next",
+	importSources: [
+		"react-i18next",
+		"next-i18next",
+		"@intlayer/react-i18next",
+		"@intlayer/next-i18next"
+	],
+	jsxIdAttribute: "i18nKey",
+	jsxNamespaceAttribute: "ns",
+	namespaceSources: [],
+	translationFunction: "self"
+}];
+
+//#endregion
+export { REACT_I18NEXT_CALLERS };
+//# sourceMappingURL=reactI18next.mjs.map

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

@@ -0,0 +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;EACD;CACD,kBAAkB,CAAC;EAAE,MAAM;EAAY,OAAO;EAAG,CAAC;CAClD,kBAAkB,CAChB;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;EAAa,CAC5D;CACD,qBAAqB;CACrB,mBAAmB;CACnB,oBAAoB;CACrB,EACD;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EACb;EACA;EACA;EACA;EACD;CAID,gBAAgB;CAChB,uBAAuB;CACvB,kBAAkB,EAAE;CACpB,qBAAqB;CACtB,CACF"}

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

@@ -0,0 +1,29 @@
+//#region src/callers/compat/reactIntl.ts
+/**
+* react-intl (FormatJS) — `@intlayer/react-intl` compat adapter.
+*
+* The full dotted message id encodes both the dictionary key and the field
+* path: `formatMessage({ id: 'home.title' })` → dictionary `home`, field
+* `title`.
+*
+* 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"
+}];
+
+//#endregion
+export { REACT_INTL_CALLERS };
+//# sourceMappingURL=reactIntl.mjs.map

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

@@ -0,0 +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,uBAAuB;CAGrD,eAAe;CACf,kBAAkB,CAAC,EAAE,MAAM,sBAAsB,CAAC;CAClD,qBAAqB;CACtB,EACD;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,cAAc,uBAAuB;CACrD,gBAAgB;CAChB,kBAAkB,CAAC,EAAE,MAAM,sBAAsB,CAAC;CAClD,qBAAqB;CACtB,CACF"}

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

@@ -0,0 +1,44 @@
+//#region src/callers/compat/useIntl.ts
+/**
+* use-intl — `@intlayer/use-intl` compat adapter.
+*
+* Mirrors `compat/use-intl/src/plugin/index.ts`.
+*/
+const USE_INTL_CALLERS = [{
+	callerName: "useTranslations",
+	library: "use-intl",
+	importSources: [
+		"use-intl",
+		"use-intl/react",
+		"@intlayer/use-intl"
+	],
+	namespaceSources: [{
+		from: "argument",
+		index: 0
+	}],
+	translationFunction: "return-value",
+	nestedNamespace: true,
+	allowRootScope: true,
+	staticReplacement: "useDictionary",
+	dynamicReplacement: "useDictionaryDynamic"
+}, {
+	callerName: "createTranslator",
+	library: "use-intl",
+	importSources: [
+		"use-intl",
+		"use-intl/core",
+		"@intlayer/use-intl"
+	],
+	namespaceSources: [{
+		from: "option",
+		argumentIndex: 0,
+		property: "namespace"
+	}],
+	translationFunction: "return-value",
+	nestedNamespace: true,
+	allowRootScope: true
+}];
+
+//#endregion
+export { USE_INTL_CALLERS };
+//# sourceMappingURL=useIntl.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useIntl.mjs","names":[],"sources":["../../../../src/callers/compat/useIntl.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * use-intl — `@intlayer/use-intl` compat adapter.\n *\n * Mirrors `compat/use-intl/src/plugin/index.ts`.\n */\nexport const USE_INTL_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useTranslations',\n    library: 'use-intl',\n    importSources: ['use-intl', 'use-intl/react', '@intlayer/use-intl'],\n    namespaceSources: [{ from: 'argument', index: 0 }],\n    translationFunction: 'return-value',\n    // Same namespace semantics as next-intl (next-intl re-exports use-intl).\n    nestedNamespace: true,\n    allowRootScope: true,\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: 'createTranslator',\n    library: 'use-intl',\n    importSources: ['use-intl', 'use-intl/core', '@intlayer/use-intl'],\n    namespaceSources: [\n      { from: 'option', argumentIndex: 0, property: 'namespace' },\n    ],\n    translationFunction: 'return-value',\n    nestedNamespace: true,\n    allowRootScope: true,\n  },\n];\n"],"mappings":";;;;;;AAOA,MAAa,mBAAuC,CAClD;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EAAC;EAAY;EAAkB;EAAqB;CACnE,kBAAkB,CAAC;EAAE,MAAM;EAAY,OAAO;EAAG,CAAC;CAClD,qBAAqB;CAErB,iBAAiB;CACjB,gBAAgB;CAChB,mBAAmB;CACnB,oBAAoB;CACrB,EACD;CACE,YAAY;CACZ,SAAS;CACT,eAAe;EAAC;EAAY;EAAiB;EAAqB;CAClE,kBAAkB,CAChB;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;EAAa,CAC5D;CACD,qBAAqB;CACrB,iBAAiB;CACjB,gBAAgB;CACjB,CACF"}

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

@@ -0,0 +1,24 @@
+//#region src/callers/compat/vueI18n.ts
+/**
+* vue-i18n — `@intlayer/vue-i18n` compat adapter.
+*
+* Mirrors `compat/vue-i18n/src/plugin/index.ts`.
+*/
+const VUE_I18N_CALLERS = [{
+	callerName: "useI18n",
+	library: "vue-i18n",
+	importSources: ["vue-i18n", "@intlayer/vue-i18n"],
+	namespaceSources: [{
+		from: "option",
+		argumentIndex: 0,
+		property: "namespace"
+	}],
+	translationFunction: "destructured-t",
+	allowRootScope: true,
+	staticReplacement: "useDictionary",
+	dynamicReplacement: "useDictionaryDynamic"
+}];
+
+//#endregion
+export { VUE_I18N_CALLERS };
+//# sourceMappingURL=vueI18n.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vueI18n.mjs","names":[],"sources":["../../../../src/callers/compat/vueI18n.ts"],"sourcesContent":["import type { CallerDescriptor } from '../types';\n\n/**\n * vue-i18n — `@intlayer/vue-i18n` compat adapter.\n *\n * Mirrors `compat/vue-i18n/src/plugin/index.ts`.\n */\nexport const VUE_I18N_CALLERS: CallerDescriptor[] = [\n  {\n    callerName: 'useI18n',\n    library: 'vue-i18n',\n    importSources: ['vue-i18n', '@intlayer/vue-i18n'],\n    // `const { t } = useI18n({ namespace: 'ns' })` — the namespace is an\n    // intlayer extension of vue-i18n's options object.\n    namespaceSources: [\n      { from: 'option', argumentIndex: 0, property: 'namespace' },\n    ],\n    translationFunction: 'destructured-t',\n    // Bare `useI18n()` resolves the first key segment as the dictionary:\n    // `t('footer.github')` → dictionary `footer`, field `github`.\n    allowRootScope: true,\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n];\n"],"mappings":";;;;;;AAOA,MAAa,mBAAuC,CAClD;CACE,YAAY;CACZ,SAAS;CACT,eAAe,CAAC,YAAY,qBAAqB;CAGjD,kBAAkB,CAChB;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;EAAa,CAC5D;CACD,qBAAqB;CAGrB,gBAAgB;CAChB,mBAAmB;CACnB,oBAAoB;CACrB,CACF"}

package/dist/esm/callers/index.mjs

@@ -0,0 +1,72 @@
+import { BASE_CALLERS } from "./base.mjs";
+import { getRewritableCallers, 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";
+import { REACT_I18NEXT_CALLERS } from "./compat/reactI18next.mjs";
+import { REACT_INTL_CALLERS } from "./compat/reactIntl.mjs";
+import { USE_INTL_CALLERS } from "./compat/useIntl.mjs";
+import { VUE_I18N_CALLERS } from "./compat/vueI18n.mjs";
+
+//#region src/callers/index.ts
+/**
+* Compat-adapter callers, grouped in one list. Each compat package's bundler
+* plugin injects its own slice (e.g. `REACT_I18NEXT_CALLERS`) into the build
+* pipeline; this aggregate exists for consumers that need every syntax at
+* once, such as the LSP.
+*/
+const COMPAT_CALLERS = [
+	...I18NEXT_CALLERS,
+	...REACT_I18NEXT_CALLERS,
+	...NEXT_INTL_CALLERS,
+	...USE_INTL_CALLERS,
+	...REACT_INTL_CALLERS,
+	...LINGUI_CALLERS,
+	...VUE_I18N_CALLERS
+];
+/** Base + compat callers — the full registry the matchers run against. */
+const ALL_CALLERS = [...BASE_CALLERS, ...COMPAT_CALLERS];
+/**
+* Descriptors indexed by caller name. A name can map to several descriptors
+* (e.g. `Trans` exists in both react-i18next and lingui with different
+* attributes); matchers try them in registry order.
+*/
+const CALLERS_BY_NAME = (() => {
+	const byName = /* @__PURE__ */ new Map();
+	for (const descriptor of ALL_CALLERS) {
+		const existing = byName.get(descriptor.callerName);
+		if (existing) existing.push(descriptor);
+		else byName.set(descriptor.callerName, [descriptor]);
+	}
+	return byName;
+})();
+/**
+* Caller names whose dictionary key can appear as a positional string literal
+* argument (`caller('key', …)` / `caller(locale, 'key', …)`). Used to build
+* text-search regexes over project source files (find-references) and the
+* completion trigger pattern. Callers whose key never appears positionally
+* (fixed namespace, options object, JSX-only) are excluded on purpose.
+*/
+const getPositionalKeyCallerNames = () => {
+	const names = /* @__PURE__ */ new Set();
+	for (const descriptor of ALL_CALLERS) if (descriptor.namespaceSources.some((source) => source.from === "argument")) names.add(descriptor.callerName);
+	return [...names];
+};
+/**
+* Returns `true` when the descriptor may participate in matching for a file
+* importing from `importSources`. Descriptors flagged `requiresImport` only
+* activate when the file imports from one of their declared modules;
+* everything else is always active (results are still validated against the
+* project's dictionaries downstream).
+*
+* @param descriptor - The caller descriptor to gate.
+* @param fileImportSources - Module specifiers imported by the analysed file.
+*/
+const isCallerActive = (descriptor, fileImportSources) => {
+	if (!descriptor.requiresImport) return true;
+	return descriptor.importSources.some((source) => fileImportSources.has(source));
+};
+
+//#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 };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +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;CACJ;;AAGD,MAAa,cAAkC,CAC7C,GAAG,cACH,GAAG,eACJ;;;;;;AAOD,MAAa,yBAA0D;CACrE,MAAM,yBAAS,IAAI,KAAiC;AAEpD,MAAK,MAAM,cAAc,aAAa;EACpC,MAAM,WAAW,OAAO,IAAI,WAAW,WAAW;AAElD,MAAI,SACF,UAAS,KAAK,WAAW;MAEzB,QAAO,IAAI,WAAW,YAAY,CAAC,WAAW,CAAC;;AAInD,QAAO;IACL;;;;;;;;AASJ,MAAa,oCAA8C;CACzD,MAAM,wBAAQ,IAAI,KAAa;AAE/B,MAAK,MAAM,cAAc,YAKvB,KAJ+B,WAAW,iBAAiB,MACxD,WAAW,OAAO,SAAS,WAGJ,CAAE,OAAM,IAAI,WAAW,WAAW;AAG9D,QAAO,CAAC,GAAG,MAAM;;;;;;;;;;;;AAanB,MAAa,kBACX,YACA,sBACY;AACZ,KAAI,CAAC,WAAW,eAAgB,QAAO;AAEvC,QAAO,WAAW,cAAc,MAAM,WACpC,kBAAkB,IAAI,OAAO,CAC9B"}

package/dist/esm/callers/transform.mjs

@@ -0,0 +1,43 @@
+//#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.
+*
+* Method-matched callers (`i18n.getFixedT`) and JSX components are excluded —
+* their call sites cannot be re-pointed through an import specifier rename.
+*/
+const getRewritableCallers = (descriptors) => descriptors.filter((descriptor) => descriptor.staticReplacement !== void 0 && descriptor.dynamicReplacement !== void 0 && descriptor.matchAsMethod !== true && descriptor.jsxIdAttribute === void 0);
+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.
+*
+* @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.
+* @returns Configs ready to pass as `swcExtraCallers` / `extraCallers`.
+*/
+const toSwcExtraCallers = (descriptors) => getRewritableCallers(descriptors).flatMap((descriptor) => {
+	const argumentSource = findSource(descriptor.namespaceSources, "argument");
+	const optionSource = findSource(descriptor.namespaceSources, "option");
+	const fixedSource = findSource(descriptor.namespaceSources, "fixed");
+	if (!argumentSource && !optionSource && !fixedSource) return [];
+	return [{
+		callerName: descriptor.callerName,
+		importSources: descriptor.importSources,
+		...argumentSource ? { namespaceArgIndex: argumentSource.index } : {},
+		...fixedSource ? { fixedNamespace: fixedSource.value } : {},
+		...optionSource ? { namespaceOption: {
+			argumentIndex: optionSource.argumentIndex,
+			property: optionSource.property
+		} } : {},
+		staticReplacement: descriptor.staticReplacement,
+		dynamicReplacement: descriptor.dynamicReplacement
+	}];
+});
+
+//#endregion
+export { getRewritableCallers, toSwcExtraCallers };
+//# sourceMappingURL=transform.mjs.map

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

@@ -0,0 +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,OACjC;AAEH,MAAM,cACJ,SACA,SAEA,QAAQ,MACL,WACC,OAAO,SAAS,KACnB;;;;;;;;;;;;AAaH,MAAa,qBACX,gBAEA,qBAAqB,YAAY,CAAC,SAAS,eAAe;CACxD,MAAM,iBAAiB,WAAW,WAAW,kBAAkB,WAAW;CAC1E,MAAM,eAAe,WAAW,WAAW,kBAAkB,SAAS;CACtE,MAAM,cAAc,WAAW,WAAW,kBAAkB,QAAQ;AAEpE,KAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,YAAa,QAAO,EAAE;AAE/D,QAAO,CACL;EACE,YAAY,WAAW;EACvB,eAAe,WAAW;EAC1B,GAAI,iBAAiB,EAAE,mBAAmB,eAAe,OAAO,GAAG,EAAE;EACrE,GAAI,cAAc,EAAE,gBAAgB,YAAY,OAAO,GAAG,EAAE;EAC5D,GAAI,eACA,EACE,iBAAiB;GACf,eAAe,aAAa;GAC5B,UAAU,aAAa;GACxB,EACF,GACD,EAAE;EACN,mBAAmB,WAAW;EAC9B,oBAAoB,WAAW;EAChC,CACF;EACD"}

package/dist/esm/loadEnvFile.mjs

@@ -1,4 +1,4 @@
-import { existsSync } from "node:fs";
+import { existsSync, statSync } from "node:fs";
 import dotenv from "dotenv";
 
 //#region src/loadEnvFile.ts
@@ -11,16 +11,53 @@ const getEnvFilePath = (env = "development", envFile) => {
 		".env"
 	]).find(existsSync);
 };
-const loadEnvFile = (options) => {
-	const envFiles = getEnvFilePath(options?.env ?? DEFAULT_ENV, options?.envFile);
-	if (!envFiles) return {};
-	const result = {};
+/**
+* Cache of parsed env files keyed by `cwd|env|envFile`. Loading content
+* declarations calls `loadEnvFile` once per file; without this every call pays
+* up to 4 `existsSync` probes plus a dotenv read+parse. A cached hit is
+* validated with a single `stat` so edits to the env file are still picked up.
+*/
+const envFileCache = /* @__PURE__ */ new Map();
+const parseEnvFile = (envFilePath) => {
+	const parsedEnv = {};
 	dotenv.config({
-		path: envFiles,
-		processEnv: result,
+		path: envFilePath,
+		processEnv: parsedEnv,
 		quiet: true
 	});
-	return result;
+	return parsedEnv;
+};
+const loadEnvFile = (options) => {
+	const env = options?.env ?? DEFAULT_ENV;
+	const cacheKey = `${process.cwd()}|${env}|${options?.envFile ?? ""}`;
+	const cachedEntry = envFileCache.get(cacheKey);
+	if (cachedEntry) if (cachedEntry.envFilePath === void 0) {
+		if (!getEnvFilePath(env, options?.envFile)) return cachedEntry.parsedEnv;
+	} else try {
+		const stats = statSync(cachedEntry.envFilePath);
+		if (stats.mtimeMs === cachedEntry.mtimeMs && stats.size === cachedEntry.size) return cachedEntry.parsedEnv;
+	} catch {}
+	const envFilePath = getEnvFilePath(env, options?.envFile);
+	if (!envFilePath) {
+		envFileCache.set(cacheKey, {
+			envFilePath: void 0,
+			mtimeMs: 0,
+			size: 0,
+			parsedEnv: {}
+		});
+		return {};
+	}
+	const parsedEnv = parseEnvFile(envFilePath);
+	try {
+		const stats = statSync(envFilePath);
+		envFileCache.set(cacheKey, {
+			envFilePath,
+			mtimeMs: stats.mtimeMs,
+			size: stats.size,
+			parsedEnv
+		});
+	} catch {}
+	return parsedEnv;
 };
 
 //#endregion

package/dist/esm/loadEnvFile.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadEnvFile.mjs","names":[],"sources":["../../src/loadEnvFile.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport dotenv from 'dotenv';\n\nconst DEFAULT_ENV = process.env.NODE_ENV ?? 'development';\n\nexport type LoadEnvFileOptions = {\n  env?: string;\n  envFile?: string;\n};\n\nexport const getEnvFilePath = (\n  env: string = process.env.NODE_ENV ?? 'development',\n  envFile?: string\n): string | undefined => {\n  const envFiles = envFile\n    ? [envFile]\n    : [`.env.${env}.local`, `.env.${env}`, '.env.local', '.env'];\n\n  return envFiles.find(existsSync); // Returns the first existing env file\n};\n\nexport const loadEnvFile = (options?: Partial<LoadEnvFileOptions>) => {\n  const env = options?.env ?? DEFAULT_ENV;\n\n  const envFiles = getEnvFilePath(env, options?.envFile);\n\n  if (!envFiles) {\n    return {};\n  }\n\n  const result = {};\n\n  dotenv.config({\n    path: envFiles,\n    processEnv: result,\n    quiet: true,\n  });\n\n  return result; // Return the parsed env object\n};\n"],"mappings":";;;;AAGA,MAAM;AAON,MAAa,kBACX,qBACA,YACuB;AAKvB,SAJiB,UACb,CAAC,QAAQ,GACT;EAAC,QAAQ,IAAI;EAAS,QAAQ;EAAO;EAAc;EAAO,EAE9C,KAAK,WAAW;;AAGlC,MAAa,eAAe,YAA0C;CAGpE,MAAM,WAAW,eAFL,SAAS,OAAO,aAES,SAAS,QAAQ;AAEtD,KAAI,CAAC,SACH,QAAO,EAAE;CAGX,MAAM,SAAS,EAAE;AAEjB,QAAO,OAAO;EACZ,MAAM;EACN,YAAY;EACZ,OAAO;EACR,CAAC;AAEF,QAAO"}
+{"version":3,"file":"loadEnvFile.mjs","names":[],"sources":["../../src/loadEnvFile.ts"],"sourcesContent":["import { existsSync, statSync } from 'node:fs';\nimport dotenv from 'dotenv';\n\nconst DEFAULT_ENV = process.env.NODE_ENV ?? 'development';\n\nexport type LoadEnvFileOptions = {\n  env?: string;\n  envFile?: string;\n};\n\nexport const getEnvFilePath = (\n  env: string = process.env.NODE_ENV ?? 'development',\n  envFile?: string\n): string | undefined => {\n  const envFiles = envFile\n    ? [envFile]\n    : [`.env.${env}.local`, `.env.${env}`, '.env.local', '.env'];\n\n  return envFiles.find(existsSync); // Returns the first existing env file\n};\n\ntype EnvFileCacheEntry = {\n  /** The env file that was resolved and parsed (undefined if none exists). */\n  envFilePath: string | undefined;\n  /** Fingerprint of the parsed file, used to detect edits. */\n  mtimeMs: number;\n  size: number;\n  /** The parsed env variables. */\n  parsedEnv: Record<string, string>;\n};\n\n/**\n * Cache of parsed env files keyed by `cwd|env|envFile`. Loading content\n * declarations calls `loadEnvFile` once per file; without this every call pays\n * up to 4 `existsSync` probes plus a dotenv read+parse. A cached hit is\n * validated with a single `stat` so edits to the env file are still picked up.\n */\nconst envFileCache = new Map<string, EnvFileCacheEntry>();\n\nconst parseEnvFile = (envFilePath: string): Record<string, string> => {\n  const parsedEnv: Record<string, string> = {};\n\n  dotenv.config({\n    path: envFilePath,\n    processEnv: parsedEnv,\n    quiet: true,\n  });\n\n  return parsedEnv;\n};\n\nexport const loadEnvFile = (\n  options?: Partial<LoadEnvFileOptions>\n): Record<string, string> => {\n  const env = options?.env ?? DEFAULT_ENV;\n\n  // Env file candidates are resolved relative to the working directory\n  const cacheKey = `${process.cwd()}|${env}|${options?.envFile ?? ''}`;\n\n  const cachedEntry = envFileCache.get(cacheKey);\n\n  if (cachedEntry) {\n    if (cachedEntry.envFilePath === undefined) {\n      // No env file existed. Re-probe cheaply in case one was created since.\n      const envFilePath = getEnvFilePath(env, options?.envFile);\n      if (!envFilePath) return cachedEntry.parsedEnv;\n    } else {\n      try {\n        const stats = statSync(cachedEntry.envFilePath);\n        if (\n          stats.mtimeMs === cachedEntry.mtimeMs &&\n          stats.size === cachedEntry.size\n        ) {\n          return cachedEntry.parsedEnv;\n        }\n      } catch {\n        // File was removed — fall through and re-resolve\n      }\n    }\n  }\n\n  const envFilePath = getEnvFilePath(env, options?.envFile);\n\n  if (!envFilePath) {\n    envFileCache.set(cacheKey, {\n      envFilePath: undefined,\n      mtimeMs: 0,\n      size: 0,\n      parsedEnv: {},\n    });\n    return {};\n  }\n\n  const parsedEnv = parseEnvFile(envFilePath);\n\n  try {\n    const stats = statSync(envFilePath);\n    envFileCache.set(cacheKey, {\n      envFilePath,\n      mtimeMs: stats.mtimeMs,\n      size: stats.size,\n      parsedEnv,\n    });\n  } catch {\n    // Race: file removed between parse and stat — skip caching this round\n  }\n\n  return parsedEnv; // Return the parsed env object\n};\n"],"mappings":";;;;AAGA,MAAM;AAON,MAAa,kBACX,qBACA,YACuB;AAKvB,SAJiB,UACb,CAAC,QAAQ,GACT;EAAC,QAAQ,IAAI;EAAS,QAAQ;EAAO;EAAc;EAAO,EAE9C,KAAK,WAAW;;;;;;;;AAmBlC,MAAM,+BAAe,IAAI,KAAgC;AAEzD,MAAM,gBAAgB,gBAAgD;CACpE,MAAM,YAAoC,EAAE;AAE5C,QAAO,OAAO;EACZ,MAAM;EACN,YAAY;EACZ,OAAO;EACR,CAAC;AAEF,QAAO;;AAGT,MAAa,eACX,YAC2B;CAC3B,MAAM,MAAM,SAAS,OAAO;CAG5B,MAAM,WAAW,GAAG,QAAQ,KAAK,CAAC,GAAG,IAAI,GAAG,SAAS,WAAW;CAEhE,MAAM,cAAc,aAAa,IAAI,SAAS;AAE9C,KAAI,YACF,KAAI,YAAY,gBAAgB,QAG9B;MAAI,CADgB,eAAe,KAAK,SAAS,QACjC,CAAE,QAAO,YAAY;OAErC,KAAI;EACF,MAAM,QAAQ,SAAS,YAAY,YAAY;AAC/C,MACE,MAAM,YAAY,YAAY,WAC9B,MAAM,SAAS,YAAY,KAE3B,QAAO,YAAY;SAEf;CAMZ,MAAM,cAAc,eAAe,KAAK,SAAS,QAAQ;AAEzD,KAAI,CAAC,aAAa;AAChB,eAAa,IAAI,UAAU;GACzB,aAAa;GACb,SAAS;GACT,MAAM;GACN,WAAW,EAAE;GACd,CAAC;AACF,SAAO,EAAE;;CAGX,MAAM,YAAY,aAAa,YAAY;AAE3C,KAAI;EACF,MAAM,QAAQ,SAAS,YAAY;AACnC,eAAa,IAAI,UAAU;GACzB;GACA,SAAS,MAAM;GACf,MAAM,MAAM;GACZ;GACD,CAAC;SACI;AAIR,QAAO"}

package/dist/esm/loadExternalFile/index.mjs

@@ -1,7 +1,7 @@
 import { getSandBoxContext, parseFileContent } from "./parseFileContent.mjs";
 import { bundleFile, bundleFileSync, getLoader } from "./bundleFile.mjs";
-import { transpileTSToCJS, transpileTSToCJSSync } from "./transpileTSToCJS.mjs";
+import { clearTranspileCache, transpileTSToCJS, transpileTSToCJSSync } from "./transpileTSToCJS.mjs";
 import { loadExternalFile, loadExternalFileSync } from "./loadExternalFile.mjs";
 import { bundleJSFile } from "./bundleJSFile.mjs";
 
-export { bundleFile, bundleFileSync, bundleJSFile, getLoader, getSandBoxContext, loadExternalFile, loadExternalFileSync, parseFileContent, transpileTSToCJS, transpileTSToCJSSync };
+export { bundleFile, bundleFileSync, bundleJSFile, clearTranspileCache, getLoader, getSandBoxContext, loadExternalFile, loadExternalFileSync, parseFileContent, transpileTSToCJS, transpileTSToCJSSync };

package/dist/esm/loadExternalFile/loadExternalFile.mjs

@@ -22,13 +22,13 @@ const loadExternalFileSync = (filePath, options) => {
 			logger("File could not be loaded.", { level: "error" });
 			return;
 		}
-		const fileContent = parseFileContent(moduleResultString, {
+		const fileContent = withPreloadedGlobals(options?.preloadGlobals, () => parseFileContent(moduleResultString, {
 			projectRequire: options?.projectRequire,
 			envVarOptions: options?.envVarOptions,
 			additionalEnvVars: options?.additionalEnvVars,
 			mocks: options?.mocks,
 			aliases: options?.aliases
-		});
+		}));
 		if (typeof fileContent === "undefined") {
 			logger(`File could not be loaded. Path : ${filePath}`);
 			return;
@@ -41,15 +41,17 @@ const loadExternalFileSync = (filePath, options) => {
 const withPreloadedGlobals = (globals, fn) => {
 	if (!globals) return fn();
 	const globalVars = globalThis;
-	const prev = {};
+	const previousValues = {};
+	const previouslyPresent = {};
 	for (const [key, value] of Object.entries(globals)) {
-		prev[key] = globalVars[key];
+		previouslyPresent[key] = key in globalVars;
+		previousValues[key] = globalVars[key];
 		globalVars[key] = value;
 	}
 	try {
 		return fn();
 	} finally {
-		for (const key of Object.keys(globals)) if (prev[key] !== void 0) globalVars[key] = prev[key];
+		for (const key of Object.keys(globals)) if (previouslyPresent[key]) globalVars[key] = previousValues[key];
 		else delete globalVars[key];
 	}
 };

package/dist/esm/loadExternalFile/loadExternalFile.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadExternalFile.mjs","names":[],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport JSON5 from 'json5';\nimport { colorizePath, logger } from '../logger';\nimport {\n  parseFileContent,\n  type SandBoxContextOptions,\n} from './parseFileContent';\nimport {\n  type TranspileOptions,\n  transpileTSToCJS,\n  transpileTSToCJSSync,\n} from './transpileTSToCJS';\n\n// CJS MJS cross usage\nconst parseJSON5 = JSON5.parse || (JSON5 as any).default?.parse;\n\nexport type LoadExternalFileOptions = {\n  configuration?: IntlayerConfig;\n  buildOptions?: TranspileOptions;\n  logError?: boolean;\n  /**\n   * Key-value pairs to temporarily set on the main Node.js `globalThis` for the\n   * synchronous duration of `parseFileContent` / `runInNewContext`. External modules\n   * loaded via `require()` inside the VM (e.g. `@intlayer/core`'s `file()` helper)\n   * run in the main context and read from the real `globalThis`, not the VM sandbox.\n   * Values are restored (or deleted) after `runInNewContext` returns.\n   */\n  preloadGlobals?: Record<string, unknown>;\n} & SandBoxContextOptions;\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFileSync = (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): any | undefined => {\n  const fileExtension = extname(filePath) || '.json';\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Assume JSON\n      return parseJSON5(readFileSync(filePath, 'utf-8'));\n    }\n\n    // Rest is JS, MJS or TS\n    const code = readFileSync(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = transpileTSToCJSSync(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    const fileContent = parseFileContent(moduleResultString, {\n      projectRequire: options?.projectRequire,\n      envVarOptions: options?.envVarOptions,\n      additionalEnvVars: options?.additionalEnvVars,\n      mocks: options?.mocks,\n      aliases: options?.aliases,\n    });\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${filePath}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    logger(\n      [\n        `Error: ${(error as Error).message} - `,\n        JSON.stringify((error as Error).stack, null, 2),\n      ],\n      {\n        level: 'error',\n      }\n    );\n  }\n};\n\nconst withPreloadedGlobals = <T>(\n  globals: Record<string, unknown> | undefined,\n  fn: () => T\n): T => {\n  if (!globals) return fn();\n\n  const globalVars = globalThis as Record<string, unknown>;\n  const prev: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(globals)) {\n    prev[key] = globalVars[key];\n    globalVars[key] = value;\n  }\n\n  try {\n    return fn();\n  } finally {\n    for (const key of Object.keys(globals)) {\n      if (prev[key] !== undefined) {\n        globalVars[key] = prev[key];\n      } else {\n        delete globalVars[key];\n      }\n    }\n  }\n};\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFile = async (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): Promise<any | undefined> => {\n  const fileExtension = extname(filePath);\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Remove cache to force getting fresh content\n      const fileContent = await readFile(filePath, 'utf-8');\n      return parseJSON5(fileContent);\n    }\n\n    // Rest is JS, MJS or TS\n    const code = await readFile(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = await transpileTSToCJS(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // has no interleaving risk even when multiple files are processed concurrently.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${colorizePath(filePath)}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    if (options?.logError ?? true) {\n      logger(\n        [\n          `Error: ${(error as Error).message} - `,\n          JSON.stringify((error as Error).stack, null, 2),\n        ],\n        {\n          level: 'error',\n        }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;AAiBA,MAAM,aAAa,MAAM,SAAU,MAAc,SAAS;;;;;;AAqB1D,MAAa,wBACX,UACA,YACoB;CACpB,MAAM,gBAAgB,QAAQ,SAAS,IAAI;AAE3C,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAGlB,QAAO,WAAW,aAAa,UAAU,QAAQ,CAAC;EAMpD,MAAM,qBAAyC,qBAFlC,aAAa,UAAU,QAG9B,EACJ,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAGF,MAAM,cAAc,iBAAiB,oBAAoB;GACvD,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC;AAEF,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,WAAW;AACtD;;AAGF,SAAO;UACA,OAAO;AACd,SACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF;;;AAIL,MAAM,wBACJ,SACA,OACM;AACN,KAAI,CAAC,QAAS,QAAO,IAAI;CAEzB,MAAM,aAAa;CACnB,MAAM,OAAgC,EAAE;AAExC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,OAAK,OAAO,WAAW;AACvB,aAAW,OAAO;;AAGpB,KAAI;AACF,SAAO,IAAI;WACH;AACR,OAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,KAAK,SAAS,OAChB,YAAW,OAAO,KAAK;MAEvB,QAAO,WAAW;;;;;;;;AAW1B,MAAa,mBAAmB,OAC9B,UACA,YAC6B;CAC7B,MAAM,gBAAgB,QAAQ,SAAS;AAEvC,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAIlB,QAAO,WAAW,MADQ,SAAS,UAAU,QAAQ,CACvB;EAMhC,MAAM,qBAAyC,MAAM,iBACnD,MAHiB,SAAS,UAAU,QAAQ,EAI5C,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,aAAa,SAAS,GAAG;AACpE;;AAGF,SAAO;UACA,OAAO;AACd,MAAI,SAAS,YAAY,KACvB,QACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF"}
+{"version":3,"file":"loadExternalFile.mjs","names":[],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport JSON5 from 'json5';\nimport { colorizePath, logger } from '../logger';\nimport {\n  parseFileContent,\n  type SandBoxContextOptions,\n} from './parseFileContent';\nimport {\n  type TranspileOptions,\n  transpileTSToCJS,\n  transpileTSToCJSSync,\n} from './transpileTSToCJS';\n\n// CJS MJS cross usage\nconst parseJSON5 = JSON5.parse || (JSON5 as any).default?.parse;\n\nexport type LoadExternalFileOptions = {\n  configuration?: IntlayerConfig;\n  buildOptions?: TranspileOptions;\n  logError?: boolean;\n  /**\n   * Key-value pairs to temporarily set on the main Node.js `globalThis` for the\n   * synchronous duration of `parseFileContent` / `runInNewContext`. External modules\n   * loaded via `require()` inside the VM (e.g. `@intlayer/core`'s `file()` helper)\n   * run in the main context and read from the real `globalThis`, not the VM sandbox.\n   * Values are restored (or deleted) after `runInNewContext` returns.\n   */\n  preloadGlobals?: Record<string, unknown>;\n} & SandBoxContextOptions;\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFileSync = (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): any | undefined => {\n  const fileExtension = extname(filePath) || '.json';\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Assume JSON\n      return parseJSON5(readFileSync(filePath, 'utf-8'));\n    }\n\n    // Rest is JS, MJS or TS\n    const code = readFileSync(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = transpileTSToCJSSync(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // fully restores the globals before returning.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${filePath}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    logger(\n      [\n        `Error: ${(error as Error).message} - `,\n        JSON.stringify((error as Error).stack, null, 2),\n      ],\n      {\n        level: 'error',\n      }\n    );\n  }\n};\n\nconst withPreloadedGlobals = <T>(\n  globals: Record<string, unknown> | undefined,\n  fn: () => T\n): T => {\n  if (!globals) return fn();\n\n  const globalVars = globalThis as Record<string, unknown>;\n  const previousValues: Record<string, unknown> = {};\n  const previouslyPresent: Record<string, boolean> = {};\n\n  for (const [key, value] of Object.entries(globals)) {\n    previouslyPresent[key] = key in globalVars;\n    previousValues[key] = globalVars[key];\n    globalVars[key] = value;\n  }\n\n  try {\n    return fn();\n  } finally {\n    for (const key of Object.keys(globals)) {\n      // `in` check (not `!== undefined`) so a global that legitimately held\n      // `undefined` is restored rather than deleted.\n      if (previouslyPresent[key]) {\n        globalVars[key] = previousValues[key];\n      } else {\n        delete globalVars[key];\n      }\n    }\n  }\n};\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFile = async (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): Promise<any | undefined> => {\n  const fileExtension = extname(filePath);\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Remove cache to force getting fresh content\n      const fileContent = await readFile(filePath, 'utf-8');\n      return parseJSON5(fileContent);\n    }\n\n    // Rest is JS, MJS or TS\n    const code = await readFile(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = await transpileTSToCJS(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // has no interleaving risk even when multiple files are processed concurrently.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${colorizePath(filePath)}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    if (options?.logError ?? true) {\n      logger(\n        [\n          `Error: ${(error as Error).message} - `,\n          JSON.stringify((error as Error).stack, null, 2),\n        ],\n        {\n          level: 'error',\n        }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;AAiBA,MAAM,aAAa,MAAM,SAAU,MAAc,SAAS;;;;;;AAqB1D,MAAa,wBACX,UACA,YACoB;CACpB,MAAM,gBAAgB,QAAQ,SAAS,IAAI;AAE3C,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAGlB,QAAO,WAAW,aAAa,UAAU,QAAQ,CAAC;EAMpD,MAAM,qBAAyC,qBAFlC,aAAa,UAAU,QAG9B,EACJ,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,WAAW;AACtD;;AAGF,SAAO;UACA,OAAO;AACd,SACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF;;;AAIL,MAAM,wBACJ,SACA,OACM;AACN,KAAI,CAAC,QAAS,QAAO,IAAI;CAEzB,MAAM,aAAa;CACnB,MAAM,iBAA0C,EAAE;CAClD,MAAM,oBAA6C,EAAE;AAErD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,oBAAkB,OAAO,OAAO;AAChC,iBAAe,OAAO,WAAW;AACjC,aAAW,OAAO;;AAGpB,KAAI;AACF,SAAO,IAAI;WACH;AACR,OAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CAGpC,KAAI,kBAAkB,KACpB,YAAW,OAAO,eAAe;MAEjC,QAAO,WAAW;;;;;;;;AAW1B,MAAa,mBAAmB,OAC9B,UACA,YAC6B;CAC7B,MAAM,gBAAgB,QAAQ,SAAS;AAEvC,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAIlB,QAAO,WAAW,MADQ,SAAS,UAAU,QAAQ,CACvB;EAMhC,MAAM,qBAAyC,MAAM,iBACnD,MAHiB,SAAS,UAAU,QAAQ,EAI5C,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,aAAa,SAAS,GAAG;AACpE;;AAGF,SAAO;UACA,OAAO;AACd,MAAI,SAAS,YAAY,KACvB,QACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF"}

package/dist/esm/loadExternalFile/parseFileContent.mjs

@@ -24,9 +24,58 @@ const NODE_GLOBALS = [
 	"crypto",
 	"structuredClone"
 ];
+/**
+* Cache of the project's React module (or the JSX-capturing fallback) keyed by
+* the require's resolution paths. Node does not cache *failed* resolutions, so
+* without this every sandbox creation in a non-React project (Vue, Svelte,
+* Angular…) pays a full node_modules walk that ends in a throw.
+*/
+const reactModuleCache = /* @__PURE__ */ new Map();
+/**
+* Fallback React implementation used when React is not installed in the
+* project. It captures JSX elements as plain objects so JSX can be used in
+* content declarations (esbuild's tsx loader defaults to React.createElement).
+*/
+const createFallbackReact = () => ({
+	createElement: (type, props, ...children) => ({
+		type,
+		props: {
+			...props,
+			children: children.length <= 1 ? children[0] : children
+		}
+	}),
+	Fragment: Symbol.for("react.fragment")
+});
+const getReactGlobal = (baseRequire) => {
+	const resolutionKey = baseRequire.resolve.paths?.("react")?.join("|") ?? "<default>";
+	const cachedReactModule = reactModuleCache.get(resolutionKey);
+	if (cachedReactModule) return cachedReactModule;
+	let reactGlobal;
+	try {
+		reactGlobal = { React: baseRequire("react") };
+	} catch (_err) {
+		reactGlobal = { React: createFallbackReact() };
+	}
+	reactModuleCache.set(resolutionKey, reactGlobal);
+	return reactGlobal;
+};
+/**
+* Snapshot of the non-env `process` properties, taken once at module load.
+* Spreading `process` enumerates ~100 properties (some behind getters); doing
+* it per sandbox is wasteful since everything except `env` is static.
+*/
+const processSnapshot = { ...process };
+/**
+* Builds the global context handed to `runInNewContext`.
+*
+* SECURITY NOTE: this sandbox exists for global-scope hygiene (fresh
+* module/exports, controlled env), NOT for containment. It exposes the real
+* project `require`, a copy of `process`, and `fetch` — code executed here has
+* full host privileges. Only ever run trusted, build-time project files
+* (same trust model as `vite.config.ts`).
+*/
 const getSandBoxContext = (options) => {
 	const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } = options ?? {};
-	let additionalGlobalVar = {};
 	const baseRequire = typeof projectRequire === "function" ? projectRequire : getProjectRequire();
 	const mockedRequire = (() => {
 		const mockTable = Object.assign({ esbuild }, mocks);
@@ -43,25 +92,11 @@ const getSandBoxContext = (options) => {
 		wrappedRequire.cache = baseRequire.cache;
 		return wrappedRequire;
 	})();
-	try {
-		additionalGlobalVar = { React: baseRequire("react") };
-	} catch (_err) {
-		additionalGlobalVar = { React: {
-			createElement: (type, props, ...children) => ({
-				type,
-				props: {
-					...props,
-					children: children.length <= 1 ? children[0] : children
-				}
-			}),
-			Fragment: Symbol.for("react.fragment")
-		} };
-	}
 	const sandboxContext = {
 		exports: { default: {} },
 		module: { exports: {} },
 		process: {
-			...process,
+			...processSnapshot,
 			env: {
 				...process.env,
 				...loadEnvFile(envVarOptions),
@@ -70,7 +105,7 @@ const getSandBoxContext = (options) => {
 		},
 		console,
 		require: mockedRequire,
-		...additionalGlobalVar
+		...getReactGlobal(baseRequire)
 	};
 	for (const key of NODE_GLOBALS) if (!(key in sandboxContext) && key in globalThis) sandboxContext[key] = globalThis[key];
 	return sandboxContext;