@intlayer/config 9.0.0-canary.8 → 9.0.0

package/dist/esm/envVars/envVars.mjs

@@ -55,7 +55,7 @@ const formatDictionarySelectorEnvVar = (hasDictionarySelector, wrapKey = (key) =
 * // { 'process.env.INTLAYER_ROUTING_MODE': '"prefix-no-default"', ... }
 */
 const getConfigEnvVars = (config, wrapKey = (key) => key, wrapValue = (value) => value) => {
-	const { routing, editor } = config;
+	const { routing, editor, analytics } = config;
 	const envVars = { [wrapKey("INTLAYER_ROUTING_MODE")]: wrapValue(routing.mode) };
 	if (routing.enableProxy === false) envVars[wrapKey("INTLAYER_ROUTING_ENABLE_PROXY")] = wrapValue("false");
 	if (!routing.rewrite) envVars[wrapKey("INTLAYER_ROUTING_REWRITE_RULES")] = wrapValue("false");
@@ -65,6 +65,7 @@ const getConfigEnvVars = (config, wrapKey = (key) => key, wrapValue = (value) =>
 	if (!routing.storage.sessionStorage || routing.storage.sessionStorage.length === 0) envVars[wrapKey("INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE")] = wrapValue("false");
 	if (!routing.storage.headers || routing.storage.headers.length === 0) envVars[wrapKey("INTLAYER_ROUTING_STORAGE_HEADERS")] = wrapValue("false");
 	if (editor?.enabled === false) envVars[wrapKey("INTLAYER_EDITOR_ENABLED")] = wrapValue("false");
+	if (analytics?.enabled !== true || !editor?.clientId) envVars[wrapKey("INTLAYER_ANALYTICS_ENABLED")] = wrapValue("false");
 	return envVars;
 };
 

package/dist/esm/envVars/envVars.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"envVars.mjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a camelCase node-type string to SCREAMING_SNAKE_CASE so that\n * the generated env-var name matches what the plugin source files check.\n *\n * @example\n * toScreamingSnakeCase('reactNode')  // 'REACT_NODE'\n * toScreamingSnakeCase('markdown')   // 'MARKDOWN'\n */\nconst toScreamingSnakeCase = (str: string): string =>\n  str\n    .replace(/([A-Z])/g, '_$1')\n    .toUpperCase()\n    .replace(/^_/, ''); // strip any leading underscore\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['reactNode'], (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_NODE_TYPE_REACT_NODE': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[wrapKey(`INTLAYER_NODE_TYPE_${toScreamingSnakeCase(nodeType)}`)] =\n        wrapValue('false');\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns the env-var definition disabling the dictionary-selector resolution\n * path (collections, variants) when no built dictionary declares\n * a qualifier. Set to `\"false\"` so bundlers can dead-code-eliminate the\n * selector branch in `getIntlayer` / `useIntlayer`.\n *\n * Emits nothing when selectors are used, leaving the runtime default in place.\n *\n * @example\n * formatDictionarySelectorEnvVar(false)\n * // { INTLAYER_DICTIONARY_SELECTOR: '\"false\"' }\n *\n * formatDictionarySelectorEnvVar(true)\n * // {}\n *\n * formatDictionarySelectorEnvVar(false, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_DICTIONARY_SELECTOR': '\"false\"' }\n */\nexport const formatDictionarySelectorEnvVar = (\n  hasDictionarySelector: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  hasDictionarySelector\n    ? {}\n    : { [wrapKey('INTLAYER_DICTIONARY_SELECTOR')]: wrapValue('false') };\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> => {\n  const { routing, editor } = config;\n\n  const envVars: Record<string, string> = {\n    [wrapKey('INTLAYER_ROUTING_MODE')]: wrapValue(routing.mode),\n  };\n\n  if (routing.enableProxy === false) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('false');\n  }\n\n  if (!routing.rewrite) {\n    envVars[wrapKey('INTLAYER_ROUTING_REWRITE_RULES')] = wrapValue('false');\n  }\n\n  if (!routing.domains || Object.keys(routing.domains).length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_DOMAINS')] = wrapValue('false');\n  }\n\n  if (!routing.storage.cookies || routing.storage.cookies.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_COOKIES')] = wrapValue('false');\n  }\n\n  if (\n    !routing.storage.localStorage ||\n    routing.storage.localStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_LOCALSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (\n    !routing.storage.sessionStorage ||\n    routing.storage.sessionStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (!routing.storage.headers || routing.storage.headers.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_HEADERS')] = wrapValue('false');\n  }\n\n  if (editor?.enabled === false) {\n    envVars[wrapKey('INTLAYER_EDITOR_ENABLED')] = wrapValue('false');\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAM,wBAAwB,QAC5B,IACG,QAAQ,YAAY,MAAM,CAC1B,aAAa,CACb,QAAQ,MAAM,GAAG;;;;;;;;;;;;AAatB,MAAa,0BACX,WACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,UAAU,QACP,KAAK,aAAa;AACjB,KAAI,QAAQ,sBAAsB,qBAAqB,SAAS,GAAG,IACjE,UAAU,QAAQ;AACpB,QAAO;GAET,EAAE,CACH;;;;;;;;;;;;;;;;;;;AAoBH,MAAa,kCACX,uBACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,wBACI,EAAE,GACF,GAAG,QAAQ,+BAA+B,GAAG,UAAU,QAAQ,EAAE;;;;;;;;;;;;;AAcvE,MAAa,oBACX,QACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UACJ;CAC3B,MAAM,EAAE,SAAS,WAAW;CAE5B,MAAM,UAAkC,GACrC,QAAQ,wBAAwB,GAAG,UAAU,QAAQ,KAAK,EAC5D;AAED,KAAI,QAAQ,gBAAgB,MAC1B,SAAQ,QAAQ,gCAAgC,IAAI,UAAU,QAAQ;AAGxE,KAAI,CAAC,QAAQ,QACX,SAAQ,QAAQ,iCAAiC,IAAI,UAAU,QAAQ;AAGzE,KAAI,CAAC,QAAQ,WAAW,OAAO,KAAK,QAAQ,QAAQ,CAAC,WAAW,EAC9D,SAAQ,QAAQ,2BAA2B,IAAI,UAAU,QAAQ;AAGnE,KAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,EACjE,SAAQ,QAAQ,mCAAmC,IAAI,UAAU,QAAQ;AAG3E,KACE,CAAC,QAAQ,QAAQ,gBACjB,QAAQ,QAAQ,aAAa,WAAW,EAExC,SAAQ,QAAQ,wCAAwC,IACtD,UAAU,QAAQ;AAGtB,KACE,CAAC,QAAQ,QAAQ,kBACjB,QAAQ,QAAQ,eAAe,WAAW,EAE1C,SAAQ,QAAQ,0CAA0C,IACxD,UAAU,QAAQ;AAGtB,KAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,EACjE,SAAQ,QAAQ,mCAAmC,IAAI,UAAU,QAAQ;AAG3E,KAAI,QAAQ,YAAY,MACtB,SAAQ,QAAQ,0BAA0B,IAAI,UAAU,QAAQ;AAGlE,QAAO"}
+{"version":3,"file":"envVars.mjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a camelCase node-type string to SCREAMING_SNAKE_CASE so that\n * the generated env-var name matches what the plugin source files check.\n *\n * @example\n * toScreamingSnakeCase('reactNode')  // 'REACT_NODE'\n * toScreamingSnakeCase('markdown')   // 'MARKDOWN'\n */\nconst toScreamingSnakeCase = (str: string): string =>\n  str\n    .replace(/([A-Z])/g, '_$1')\n    .toUpperCase()\n    .replace(/^_/, ''); // strip any leading underscore\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['reactNode'], (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_NODE_TYPE_REACT_NODE': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[wrapKey(`INTLAYER_NODE_TYPE_${toScreamingSnakeCase(nodeType)}`)] =\n        wrapValue('false');\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns the env-var definition disabling the dictionary-selector resolution\n * path (collections, variants) when no built dictionary declares\n * a qualifier. Set to `\"false\"` so bundlers can dead-code-eliminate the\n * selector branch in `getIntlayer` / `useIntlayer`.\n *\n * Emits nothing when selectors are used, leaving the runtime default in place.\n *\n * @example\n * formatDictionarySelectorEnvVar(false)\n * // { INTLAYER_DICTIONARY_SELECTOR: '\"false\"' }\n *\n * formatDictionarySelectorEnvVar(true)\n * // {}\n *\n * formatDictionarySelectorEnvVar(false, (k) => `process.env.${k}`, (v) => `\"${v}\"`)\n * // { 'process.env.INTLAYER_DICTIONARY_SELECTOR': '\"false\"' }\n */\nexport const formatDictionarySelectorEnvVar = (\n  hasDictionarySelector: boolean,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> =>\n  hasDictionarySelector\n    ? {}\n    : { [wrapKey('INTLAYER_DICTIONARY_SELECTOR')]: wrapValue('false') };\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  wrapKey = (key: string) => key,\n  wrapValue = (value: string) => value\n): Record<string, string> => {\n  const { routing, editor, analytics } = config;\n\n  const envVars: Record<string, string> = {\n    [wrapKey('INTLAYER_ROUTING_MODE')]: wrapValue(routing.mode),\n  };\n\n  if (routing.enableProxy === false) {\n    envVars[wrapKey('INTLAYER_ROUTING_ENABLE_PROXY')] = wrapValue('false');\n  }\n\n  if (!routing.rewrite) {\n    envVars[wrapKey('INTLAYER_ROUTING_REWRITE_RULES')] = wrapValue('false');\n  }\n\n  if (!routing.domains || Object.keys(routing.domains).length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_DOMAINS')] = wrapValue('false');\n  }\n\n  if (!routing.storage.cookies || routing.storage.cookies.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_COOKIES')] = wrapValue('false');\n  }\n\n  if (\n    !routing.storage.localStorage ||\n    routing.storage.localStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_LOCALSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (\n    !routing.storage.sessionStorage ||\n    routing.storage.sessionStorage.length === 0\n  ) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE')] =\n      wrapValue('false');\n  }\n\n  if (!routing.storage.headers || routing.storage.headers.length === 0) {\n    envVars[wrapKey('INTLAYER_ROUTING_STORAGE_HEADERS')] = wrapValue('false');\n  }\n\n  if (editor?.enabled === false) {\n    envVars[wrapKey('INTLAYER_EDITOR_ENABLED')] = wrapValue('false');\n  }\n\n  // Analytics is strictly opt-in (`analytics.enabled === true`) and requires a\n  // project key (`editor.clientId`) for attribution. Otherwise, disable it so\n  // bundlers dead-code-eliminate the whole `@intlayer/analytics` integration\n  // (providers + node plugins).\n  if (analytics?.enabled !== true || !editor?.clientId) {\n    envVars[wrapKey('INTLAYER_ANALYTICS_ENABLED')] = wrapValue('false');\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAM,wBAAwB,QAC5B,IACG,QAAQ,YAAY,KAAK,CAAC,CAC1B,YAAY,CAAC,CACb,QAAQ,MAAM,EAAE;;;;;;;;;;;;AAarB,MAAa,0BACX,WACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,UAAU,QACP,KAAK,aAAa;CACjB,IAAI,QAAQ,sBAAsB,qBAAqB,QAAQ,GAAG,KAChE,UAAU,OAAO;CACnB,OAAO;AACT,GACA,CAAC,CACH;;;;;;;;;;;;;;;;;;;AAoBF,MAAa,kCACX,uBACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UAE/B,wBACI,CAAC,IACD,GAAG,QAAQ,8BAA8B,IAAI,UAAU,OAAO,EAAE;;;;;;;;;;;;;AActE,MAAa,oBACX,QACA,WAAW,QAAgB,KAC3B,aAAa,UAAkB,UACJ;CAC3B,MAAM,EAAE,SAAS,QAAQ,cAAc;CAEvC,MAAM,UAAkC,GACrC,QAAQ,uBAAuB,IAAI,UAAU,QAAQ,IAAI,EAC5D;CAEA,IAAI,QAAQ,gBAAgB,OAC1B,QAAQ,QAAQ,+BAA+B,KAAK,UAAU,OAAO;CAGvE,IAAI,CAAC,QAAQ,SACX,QAAQ,QAAQ,gCAAgC,KAAK,UAAU,OAAO;CAGxE,IAAI,CAAC,QAAQ,WAAW,OAAO,KAAK,QAAQ,OAAO,CAAC,CAAC,WAAW,GAC9D,QAAQ,QAAQ,0BAA0B,KAAK,UAAU,OAAO;CAGlE,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IACE,CAAC,QAAQ,QAAQ,gBACjB,QAAQ,QAAQ,aAAa,WAAW,GAExC,QAAQ,QAAQ,uCAAuC,KACrD,UAAU,OAAO;CAGrB,IACE,CAAC,QAAQ,QAAQ,kBACjB,QAAQ,QAAQ,eAAe,WAAW,GAE1C,QAAQ,QAAQ,yCAAyC,KACvD,UAAU,OAAO;CAGrB,IAAI,CAAC,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,QAAQ,WAAW,GACjE,QAAQ,QAAQ,kCAAkC,KAAK,UAAU,OAAO;CAG1E,IAAI,QAAQ,YAAY,OACtB,QAAQ,QAAQ,yBAAyB,KAAK,UAAU,OAAO;CAOjE,IAAI,WAAW,YAAY,QAAQ,CAAC,QAAQ,UAC1C,QAAQ,QAAQ,4BAA4B,KAAK,UAAU,OAAO;CAGpE,OAAO;AACT"}

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;CAKvB,QAJiB,UACb,CAAC,OAAO,IACR;EAAC,QAAQ,IAAI;EAAS,QAAQ;EAAO;EAAc;CAAM,EAE9C,CAAC,KAAK,UAAU;AACjC;;;;;;;AAkBA,MAAM,+BAAe,IAAI,IAA+B;AAExD,MAAM,gBAAgB,gBAAgD;CACpE,MAAM,YAAoC,CAAC;CAE3C,OAAO,OAAO;EACZ,MAAM;EACN,YAAY;EACZ,OAAO;CACT,CAAC;CAED,OAAO;AACT;AAEA,MAAa,eACX,YAC2B;CAC3B,MAAM,MAAM,SAAS,OAAO;CAG5B,MAAM,WAAW,GAAG,QAAQ,IAAI,EAAE,GAAG,IAAI,GAAG,SAAS,WAAW;CAEhE,MAAM,cAAc,aAAa,IAAI,QAAQ;CAE7C,IAAI,aACF,IAAI,YAAY,gBAAgB,QAG9B;MAAI,CADgB,eAAe,KAAK,SAAS,OAClC,GAAG,OAAO,YAAY;CAAS,OAE9C,IAAI;EACF,MAAM,QAAQ,SAAS,YAAY,WAAW;EAC9C,IACE,MAAM,YAAY,YAAY,WAC9B,MAAM,SAAS,YAAY,MAE3B,OAAO,YAAY;CAEvB,QAAQ,CAER;CAIJ,MAAM,cAAc,eAAe,KAAK,SAAS,OAAO;CAExD,IAAI,CAAC,aAAa;EAChB,aAAa,IAAI,UAAU;GACzB,aAAa;GACb,SAAS;GACT,MAAM;GACN,WAAW,CAAC;EACd,CAAC;EACD,OAAO,CAAC;CACV;CAEA,MAAM,YAAY,aAAa,WAAW;CAE1C,IAAI;EACF,MAAM,QAAQ,SAAS,WAAW;EAClC,aAAa,IAAI,UAAU;GACzB;GACA,SAAS,MAAM;GACf,MAAM,MAAM;GACZ;EACF,CAAC;CACH,QAAQ,CAER;CAEA,OAAO;AACT"}

package/dist/esm/loadExternalFile/bundleFile.mjs

@@ -39,10 +39,11 @@ const getTransformationOptions = (filePath) => ({
 	define: { "import.meta.url": JSON.stringify(pathToFileURL(filePath).href) }
 });
 const bundleFileSync = (code, filePath, options) => {
+	const extension = extname(filePath);
 	return buildSync({
 		stdin: {
 			contents: code,
-			loader: getLoader(extname(filePath)),
+			loader: getLoader(extension),
 			resolveDir: dirname(filePath),
 			sourcefile: filePath
 		},
@@ -51,10 +52,11 @@ const bundleFileSync = (code, filePath, options) => {
 	}).outputFiles?.[0].text;
 };
 const bundleFile = async (code, filePath, options) => {
+	const extension = extname(filePath);
 	return (await build({
 		stdin: {
 			contents: code,
-			loader: getLoader(extname(filePath)),
+			loader: getLoader(extension),
 			resolveDir: dirname(filePath),
 			sourcefile: filePath
 		},

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

@@ -1 +1 @@
-{"version":3,"file":"bundleFile.mjs","names":[],"sources":["../../../src/loadExternalFile/bundleFile.ts"],"sourcesContent":["import { dirname, extname } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  build,\n  buildSync,\n  type Loader,\n  type Plugin,\n} from 'esbuild';\n\nexport type ESBuildPlugin = Plugin;\n\nexport const getLoader = (extension: string): Loader => {\n  switch (extension) {\n    case '.js':\n      return 'js';\n    case '.jsx':\n      return 'jsx';\n    case '.mjs':\n      return 'js';\n    case '.ts':\n      return 'ts';\n    case '.tsx':\n      return 'tsx';\n    case '.cjs':\n      return 'js';\n    case '.json':\n      return 'json';\n    case '.md':\n      return 'text';\n    case '.mdx':\n      return 'text';\n    default:\n      return 'js';\n  }\n};\n\nconst getTransformationOptions = (filePath: string): BuildOptions => ({\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n  format: 'cjs',\n  target: 'node16',\n  platform: 'neutral',\n  write: false,\n  packages: 'bundle',\n  external: ['esbuild'],\n  bundle: true,\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n  },\n});\n\nexport const bundleFileSync = (\n  code: string,\n  filePath: string,\n  options?: BuildOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const moduleResult: BuildResult = buildSync({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n      sourcefile: filePath, // Add sourcefile for better error messages\n    },\n    ...getTransformationOptions(filePath),\n    ...options,\n  });\n\n  const moduleResultString = moduleResult.outputFiles?.[0].text;\n\n  return moduleResultString;\n};\n\nexport const bundleFile = async (\n  code: string,\n  filePath: string,\n  options?: BuildOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const moduleResult: BuildResult = await build({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n      sourcefile: filePath, // Add sourcefile for better error messages\n    },\n    ...getTransformationOptions(filePath),\n    ...options,\n  });\n\n  const moduleResultString = moduleResult.outputFiles?.[0].text;\n\n  return moduleResultString;\n};\n"],"mappings":";;;;;AAaA,MAAa,aAAa,cAA8B;AACtD,SAAQ,WAAR;EACE,KAAK,MACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,MACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,QACH,QAAO;EACT,KAAK,MACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,QACE,QAAO;;;AAIb,MAAM,4BAA4B,cAAoC;CACpE,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,OAAO;CACP,UAAU;CACV,UAAU,CAAC,UAAU;CACrB,QAAQ;CACR,QAAQ,EACN,mBAAmB,KAAK,UAAU,cAAc,SAAS,CAAC,KAAK,EAChE;CACF;AAED,MAAa,kBACX,MACA,UACA,YACuB;AAiBvB,QAbkC,UAAU;EAC1C,OAAO;GACL,UAAU;GACV,QALW,UADG,QAAQ,SACQ,CAKxB;GACN,YAAY,QAAQ,SAAS;GAC7B,YAAY;GACb;EACD,GAAG,yBAAyB,SAAS;EACrC,GAAG;EACJ,CAEsC,CAAC,cAAc,GAAG;;AAK3D,MAAa,aAAa,OACxB,MACA,UACA,YACgC;AAiBhC,SAF2B,MAXa,MAAM;EAC5C,OAAO;GACL,UAAU;GACV,QALW,UADG,QAAQ,SACQ,CAKxB;GACN,YAAY,QAAQ,SAAS;GAC7B,YAAY;GACb;EACD,GAAG,yBAAyB,SAAS;EACrC,GAAG;EACJ,CAAC,EAEsC,cAAc,GAAG"}
+{"version":3,"file":"bundleFile.mjs","names":[],"sources":["../../../src/loadExternalFile/bundleFile.ts"],"sourcesContent":["import { dirname, extname } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  build,\n  buildSync,\n  type Loader,\n  type Plugin,\n} from 'esbuild';\n\nexport type ESBuildPlugin = Plugin;\n\nexport const getLoader = (extension: string): Loader => {\n  switch (extension) {\n    case '.js':\n      return 'js';\n    case '.jsx':\n      return 'jsx';\n    case '.mjs':\n      return 'js';\n    case '.ts':\n      return 'ts';\n    case '.tsx':\n      return 'tsx';\n    case '.cjs':\n      return 'js';\n    case '.json':\n      return 'json';\n    case '.md':\n      return 'text';\n    case '.mdx':\n      return 'text';\n    default:\n      return 'js';\n  }\n};\n\nconst getTransformationOptions = (filePath: string): BuildOptions => ({\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n  format: 'cjs',\n  target: 'node16',\n  platform: 'neutral',\n  write: false,\n  packages: 'bundle',\n  external: ['esbuild'],\n  bundle: true,\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n  },\n});\n\nexport const bundleFileSync = (\n  code: string,\n  filePath: string,\n  options?: BuildOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const moduleResult: BuildResult = buildSync({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n      sourcefile: filePath, // Add sourcefile for better error messages\n    },\n    ...getTransformationOptions(filePath),\n    ...options,\n  });\n\n  const moduleResultString = moduleResult.outputFiles?.[0].text;\n\n  return moduleResultString;\n};\n\nexport const bundleFile = async (\n  code: string,\n  filePath: string,\n  options?: BuildOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const moduleResult: BuildResult = await build({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n      sourcefile: filePath, // Add sourcefile for better error messages\n    },\n    ...getTransformationOptions(filePath),\n    ...options,\n  });\n\n  const moduleResultString = moduleResult.outputFiles?.[0].text;\n\n  return moduleResultString;\n};\n"],"mappings":";;;;;AAaA,MAAa,aAAa,cAA8B;CACtD,QAAQ,WAAR;EACE,KAAK,OACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,SACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,SACE,OAAO;CACX;AACF;AAEA,MAAM,4BAA4B,cAAoC;CACpE,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;CACV;CACA,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,OAAO;CACP,UAAU;CACV,UAAU,CAAC,SAAS;CACpB,QAAQ;CACR,QAAQ,EACN,mBAAmB,KAAK,UAAU,cAAc,QAAQ,CAAC,CAAC,IAAI,EAChE;AACF;AAEA,MAAa,kBACX,MACA,UACA,YACuB;CACvB,MAAM,YAAY,QAAQ,QAAQ;CAgBlC,OAbkC,UAAU;EAC1C,OAAO;GACL,UAAU;GACV,QALW,UAAU,SAKhB;GACL,YAAY,QAAQ,QAAQ;GAC5B,YAAY;EACd;EACA,GAAG,yBAAyB,QAAQ;EACpC,GAAG;CACL,CAEsC,CAAC,CAAC,cAAc,EAAE,CAAC;AAG3D;AAEA,MAAa,aAAa,OACxB,MACA,UACA,YACgC;CAChC,MAAM,YAAY,QAAQ,QAAQ;CAgBlC,QAF2B,MAXa,MAAM;EAC5C,OAAO;GACL,UAAU;GACV,QALW,UAAU,SAKhB;GACL,YAAY,QAAQ,QAAQ;GAC5B,YAAY;EACd;EACA,GAAG,yBAAyB,QAAQ;EACpC,GAAG;CACL,CAAC,EAEsC,CAAC,cAAc,EAAE,CAAC;AAG3D"}

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

@@ -1 +1 @@
-{"version":3,"file":"bundleJSFile.mjs","names":[],"sources":["../../../src/loadExternalFile/bundleJSFile.ts"],"sourcesContent":["import { type BuildOptions, build } from 'esbuild';\n\nconst commonBuildOptions = {\n  bundle: true,\n  format: 'cjs',\n  platform: 'node',\n  target: 'es2019',\n  sourcemap: false,\n  logLevel: 'silent',\n  write: true,\n  // Bundle relative/local files, but keep bare module imports external\n  packages: 'external',\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n} as const;\n\nexport const bundleJSFile = async (buildOptions: BuildOptions) =>\n  await build({\n    ...commonBuildOptions,\n    ...buildOptions,\n  });\n"],"mappings":";;;AAEA,MAAM,qBAAqB;CACzB,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,QAAQ;CACR,WAAW;CACX,UAAU;CACV,OAAO;CAEP,UAAU;CACV,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;EACT;CACF;AAED,MAAa,eAAe,OAAO,iBACjC,MAAM,MAAM;CACV,GAAG;CACH,GAAG;CACJ,CAAC"}
+{"version":3,"file":"bundleJSFile.mjs","names":[],"sources":["../../../src/loadExternalFile/bundleJSFile.ts"],"sourcesContent":["import { type BuildOptions, build } from 'esbuild';\n\nconst commonBuildOptions = {\n  bundle: true,\n  format: 'cjs',\n  platform: 'node',\n  target: 'es2019',\n  sourcemap: false,\n  logLevel: 'silent',\n  write: true,\n  // Bundle relative/local files, but keep bare module imports external\n  packages: 'external',\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n} as const;\n\nexport const bundleJSFile = async (buildOptions: BuildOptions) =>\n  await build({\n    ...commonBuildOptions,\n    ...buildOptions,\n  });\n"],"mappings":";;;AAEA,MAAM,qBAAqB;CACzB,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,QAAQ;CACR,WAAW;CACX,UAAU;CACV,OAAO;CAEP,UAAU;CACV,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;CACV;AACF;AAEA,MAAa,eAAe,OAAO,iBACjC,MAAM,MAAM;CACV,GAAG;CACH,GAAG;AACL,CAAC"}

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];
 	}
 };
@@ -61,7 +63,10 @@ const withPreloadedGlobals = (globals, fn) => {
 const loadExternalFile = async (filePath, options) => {
 	const fileExtension = extname(filePath);
 	try {
-		if (fileExtension === ".json" || fileExtension === ".json5" || fileExtension === ".jsonc") return parseJSON5(await readFile(filePath, "utf-8"));
+		if (fileExtension === ".json" || fileExtension === ".json5" || fileExtension === ".jsonc") {
+			const fileContent = await readFile(filePath, "utf-8");
+			return parseJSON5(fileContent);
+		}
 		const moduleResultString = await transpileTSToCJS(await readFile(filePath, "utf-8"), filePath, options?.buildOptions);
 		if (!moduleResultString) {
 			logger("File could not be loaded.", { level: "error" });

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,QAAQ,KAAK;CAE3C,IAAI;EACF,IACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,UAGlB,OAAO,WAAW,aAAa,UAAU,OAAO,CAAC;EAMnD,MAAM,qBAAyC,qBAFlC,aAAa,UAAU,OAG/B,GACH,UACA,SAAS,YACX;EAEA,IAAI,CAAC,oBAAoB;GACvB,OAAO,6BAA6B,EAAE,OAAO,QAAQ,CAAC;GACtD;EACF;EAIA,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;EACpB,CAAC,CACH;EAEA,IAAI,OAAO,gBAAgB,aAAa;GACtC,OAAO,oCAAoC,UAAU;GACrD;EACF;EAEA,OAAO;CACT,SAAS,OAAO;EACd,OACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,CAAC,CAChD,GACA,EACE,OAAO,QACT,CACF;CACF;AACF;AAEA,MAAM,wBACJ,SACA,OACM;CACN,IAAI,CAAC,SAAS,OAAO,GAAG;CAExB,MAAM,aAAa;CACnB,MAAM,iBAA0C,CAAC;CACjD,MAAM,oBAA6C,CAAC;CAEpD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAAG;EAClD,kBAAkB,OAAO,OAAO;EAChC,eAAe,OAAO,WAAW;EACjC,WAAW,OAAO;CACpB;CAEA,IAAI;EACF,OAAO,GAAG;CACZ,UAAU;EACR,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GAGnC,IAAI,kBAAkB,MACpB,WAAW,OAAO,eAAe;OAEjC,OAAO,WAAW;CAGxB;AACF;;;;;;AAOA,MAAa,mBAAmB,OAC9B,UACA,YAC6B;CAC7B,MAAM,gBAAgB,QAAQ,QAAQ;CAEtC,IAAI;EACF,IACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,UAClB;GAEA,MAAM,cAAc,MAAM,SAAS,UAAU,OAAO;GACpD,OAAO,WAAW,WAAW;EAC/B;EAKA,MAAM,qBAAyC,MAAM,iBACnD,MAHiB,SAAS,UAAU,OAAO,GAI3C,UACA,SAAS,YACX;EAEA,IAAI,CAAC,oBAAoB;GACvB,OAAO,6BAA6B,EAAE,OAAO,QAAQ,CAAC;GACtD;EACF;EAIA,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;EACpB,CAAC,CACH;EAEA,IAAI,OAAO,gBAAgB,aAAa;GACtC,OAAO,oCAAoC,aAAa,QAAQ,GAAG;GACnE;EACF;EAEA,OAAO;CACT,SAAS,OAAO;EACd,IAAI,SAAS,YAAY,MACvB,OACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,CAAC,CAChD,GACA,EACE,OAAO,QACT,CACF;CAEJ;AACF"}

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;

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

@@ -1 +1 @@
-{"version":3,"file":"parseFileContent.mjs","names":[],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"sourcesContent":["import { type Context, runInNewContext } from 'node:vm';\nimport * as esbuild from 'esbuild';\nimport { type LoadEnvFileOptions, loadEnvFile } from '../loadEnvFile';\nimport { getProjectRequire } from '../utils/ESMxCJSHelpers';\n\nexport type SandBoxContextOptions = {\n  envVarOptions?: LoadEnvFileOptions;\n  projectRequire?: NodeJS.Require;\n  additionalEnvVars?: Record<string, string>;\n  /**\n   * Map of specifier -> mocked export to be returned when code in the VM calls require(specifier).\n   * Example:\n   *   mocks: {\n   *     '@intlayer/config/built': { getConfig: () => ({}), Locales: {} }\n   *   }\n   */\n  mocks?: Record<string, any>;\n  /**\n   * Optional alias map if you want to redirect specifiers.\n   * Useful when user code imports a subpath you want to collapse.\n   * Example:\n   *   aliases: { '@intlayer/config/built': '@intlayer/config' }\n   */\n  aliases?: Record<string, string>;\n};\n\n// Inject only Node.js-specific globals that are absent from a plain V8 context.\n// JS built-ins (Object, Array, Promise, Math, Date, JSON, Symbol, etc.) are\n// provided automatically by runInNewContext — no need to copy them.\n// Copying all of globalThis would retain hundreds of references (including the\n// full module cache via `global`) inside every sandbox, causing a memory leak.\nconst NODE_GLOBALS = [\n  'Buffer',\n  'setTimeout',\n  'clearTimeout',\n  'setInterval',\n  'clearInterval',\n  'setImmediate',\n  'clearImmediate',\n  'queueMicrotask',\n  'URL',\n  'URLSearchParams',\n  'TextEncoder',\n  'TextDecoder',\n  'AbortController',\n  'AbortSignal',\n  'performance',\n  'fetch',\n  'crypto',\n  'structuredClone',\n] as const;\n\nexport const getSandBoxContext = (options?: SandBoxContextOptions): Context => {\n  const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } =\n    options ?? {};\n\n  let additionalGlobalVar = {};\n\n  const baseRequire: NodeJS.Require =\n    typeof projectRequire === 'function' ? projectRequire : getProjectRequire();\n\n  // Wrap require to honor mocks and aliases inside the VM\n  const mockedRequire: NodeJS.Require = (() => {\n    const mockTable = Object.assign(\n      {\n        esbuild,\n      },\n      mocks\n    );\n    const aliasTable = Object.assign({}, aliases);\n\n    const wrappedRequire = function mockableRequire(id: string) {\n      const target = aliasTable?.[id] ? aliasTable[id] : id;\n\n      if (mockTable && Object.hasOwn(mockTable, target)) {\n        return mockTable[target];\n      }\n\n      // If the original id was aliased, allow mocks to be defined on either key.\n      if (target !== id && mockTable && Object.hasOwn(mockTable, id)) {\n        return mockTable[id];\n      }\n\n      return baseRequire(target);\n    } as NodeJS.Require;\n\n    // Mirror NodeJS.Require properties\n    wrappedRequire.resolve = baseRequire.resolve.bind(baseRequire);\n    wrappedRequire.main = baseRequire.main;\n    wrappedRequire.extensions = baseRequire.extensions;\n    wrappedRequire.cache = baseRequire.cache;\n\n    return wrappedRequire;\n  })();\n\n  try {\n    // Dynamically try to require React if it's installed in the project\n    additionalGlobalVar = {\n      React: baseRequire('react'),\n    };\n  } catch (_err) {\n    // React is not installed, so we inject a dummy React object to capture JSX elements\n    // This allows using JSX in content declarations even if React is not installed (e.g. in Solid.js or Vue projects)\n    // because esbuild's tsx loader defaults to React.createElement.\n    additionalGlobalVar = {\n      React: {\n        createElement: (type: any, props: any, ...children: any[]) => ({\n          type,\n          props: {\n            ...props,\n            children: children.length <= 1 ? children[0] : children,\n          },\n        }),\n        Fragment: Symbol.for('react.fragment'),\n      },\n    };\n  }\n\n  const sandboxContext: Context = {\n    exports: {\n      default: {},\n    },\n    module: {\n      exports: {},\n    },\n    process: {\n      ...process,\n      env: {\n        ...process.env,\n        ...loadEnvFile(envVarOptions),\n        ...additionalEnvVars,\n      },\n    },\n    console,\n    require: mockedRequire,\n    ...additionalGlobalVar,\n  };\n\n  for (const key of NODE_GLOBALS) {\n    if (!(key in sandboxContext) && key in globalThis) {\n      (sandboxContext as Record<string, unknown>)[key] =\n        globalThis[key as keyof typeof globalThis];\n    }\n  }\n\n  return sandboxContext;\n};\n\nexport const parseFileContent = <T>(\n  fileContentString: string,\n  options?: SandBoxContextOptions\n): T | undefined => {\n  const sandboxContext = getSandBoxContext(options);\n\n  // Force strict mode so illegal writes throw instead of silently failing.\n  runInNewContext(`\"use strict\";\\n${fileContentString}`, sandboxContext);\n\n  const candidates: unknown[] = [\n    sandboxContext.exports?.default,\n    sandboxContext.module?.exports?.defaults,\n    sandboxContext.module?.exports?.default,\n    sandboxContext.module?.exports,\n  ];\n\n  let result: T | undefined;\n  for (const candidate of candidates) {\n    if (\n      candidate &&\n      typeof candidate === 'object' &&\n      Object.keys(candidate as object).length > 0\n    ) {\n      result = candidate as T;\n      break;\n    }\n  }\n\n  // Drop heavy references so the V8 context created by runInNewContext can be\n  // garbage-collected promptly. The extracted `result` is a plain data object\n  // and does not retain the sandbox.\n  (sandboxContext as Record<string, unknown>).require = undefined;\n  (sandboxContext as Record<string, unknown>).process = undefined;\n  (sandboxContext as Record<string, unknown>).React = undefined;\n  (sandboxContext as Record<string, unknown>).module = undefined;\n  (sandboxContext as Record<string, unknown>).exports = undefined;\n\n  return result;\n};\n"],"mappings":";;;;;;AA+BA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,qBAAqB,YAA6C;CAC7E,MAAM,EAAE,eAAe,gBAAgB,mBAAmB,OAAO,YAC/D,WAAW,EAAE;CAEf,IAAI,sBAAsB,EAAE;CAE5B,MAAM,cACJ,OAAO,mBAAmB,aAAa,iBAAiB,mBAAmB;CAG7E,MAAM,uBAAuC;EAC3C,MAAM,YAAY,OAAO,OACvB,EACE,SACD,EACD,MACD;EACD,MAAM,aAAa,OAAO,OAAO,EAAE,EAAE,QAAQ;EAE7C,MAAM,iBAAiB,SAAS,gBAAgB,IAAY;GAC1D,MAAM,SAAS,aAAa,MAAM,WAAW,MAAM;AAEnD,OAAI,aAAa,OAAO,OAAO,WAAW,OAAO,CAC/C,QAAO,UAAU;AAInB,OAAI,WAAW,MAAM,aAAa,OAAO,OAAO,WAAW,GAAG,CAC5D,QAAO,UAAU;AAGnB,UAAO,YAAY,OAAO;;AAI5B,iBAAe,UAAU,YAAY,QAAQ,KAAK,YAAY;AAC9D,iBAAe,OAAO,YAAY;AAClC,iBAAe,aAAa,YAAY;AACxC,iBAAe,QAAQ,YAAY;AAEnC,SAAO;KACL;AAEJ,KAAI;AAEF,wBAAsB,EACpB,OAAO,YAAY,QAAQ,EAC5B;UACM,MAAM;AAIb,wBAAsB,EACpB,OAAO;GACL,gBAAgB,MAAW,OAAY,GAAG,cAAqB;IAC7D;IACA,OAAO;KACL,GAAG;KACH,UAAU,SAAS,UAAU,IAAI,SAAS,KAAK;KAChD;IACF;GACD,UAAU,OAAO,IAAI,iBAAiB;GACvC,EACF;;CAGH,MAAM,iBAA0B;EAC9B,SAAS,EACP,SAAS,EAAE,EACZ;EACD,QAAQ,EACN,SAAS,EAAE,EACZ;EACD,SAAS;GACP,GAAG;GACH,KAAK;IACH,GAAG,QAAQ;IACX,GAAG,YAAY,cAAc;IAC7B,GAAG;IACJ;GACF;EACD;EACA,SAAS;EACT,GAAG;EACJ;AAED,MAAK,MAAM,OAAO,aAChB,KAAI,EAAE,OAAO,mBAAmB,OAAO,WACrC,CAAC,eAA2C,OAC1C,WAAW;AAIjB,QAAO;;AAGT,MAAa,oBACX,mBACA,YACkB;CAClB,MAAM,iBAAiB,kBAAkB,QAAQ;AAGjD,iBAAgB,kBAAkB,qBAAqB,eAAe;CAEtE,MAAM,aAAwB;EAC5B,eAAe,SAAS;EACxB,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ;EACxB;CAED,IAAI;AACJ,MAAK,MAAM,aAAa,WACtB,KACE,aACA,OAAO,cAAc,YACrB,OAAO,KAAK,UAAoB,CAAC,SAAS,GAC1C;AACA,WAAS;AACT;;AAOJ,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,QAAQ;AACpD,CAAC,eAA2C,SAAS;AACrD,CAAC,eAA2C,UAAU;AAEtD,QAAO"}
+{"version":3,"file":"parseFileContent.mjs","names":[],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"sourcesContent":["import { type Context, runInNewContext } from 'node:vm';\nimport * as esbuild from 'esbuild';\nimport { type LoadEnvFileOptions, loadEnvFile } from '../loadEnvFile';\nimport { getProjectRequire } from '../utils/ESMxCJSHelpers';\n\nexport type SandBoxContextOptions = {\n  envVarOptions?: LoadEnvFileOptions;\n  projectRequire?: NodeJS.Require;\n  additionalEnvVars?: Record<string, string>;\n  /**\n   * Map of specifier -> mocked export to be returned when code in the VM calls require(specifier).\n   * Example:\n   *   mocks: {\n   *     '@intlayer/config/built': { getConfig: () => ({}), Locales: {} }\n   *   }\n   */\n  mocks?: Record<string, any>;\n  /**\n   * Optional alias map if you want to redirect specifiers.\n   * Useful when user code imports a subpath you want to collapse.\n   * Example:\n   *   aliases: { '@intlayer/config/built': '@intlayer/config' }\n   */\n  aliases?: Record<string, string>;\n};\n\n// Inject only Node.js-specific globals that are absent from a plain V8 context.\n// JS built-ins (Object, Array, Promise, Math, Date, JSON, Symbol, etc.) are\n// provided automatically by runInNewContext — no need to copy them.\n// Copying all of globalThis would retain hundreds of references (including the\n// full module cache via `global`) inside every sandbox, causing a memory leak.\nconst NODE_GLOBALS = [\n  'Buffer',\n  'setTimeout',\n  'clearTimeout',\n  'setInterval',\n  'clearInterval',\n  'setImmediate',\n  'clearImmediate',\n  'queueMicrotask',\n  'URL',\n  'URLSearchParams',\n  'TextEncoder',\n  'TextDecoder',\n  'AbortController',\n  'AbortSignal',\n  'performance',\n  'fetch',\n  'crypto',\n  'structuredClone',\n] as const;\n\n/**\n * Cache of the project's React module (or the JSX-capturing fallback) keyed by\n * the require's resolution paths. Node does not cache *failed* resolutions, so\n * without this every sandbox creation in a non-React project (Vue, Svelte,\n * Angular…) pays a full node_modules walk that ends in a throw.\n */\nconst reactModuleCache = new Map<string, { React: unknown }>();\n\n/**\n * Fallback React implementation used when React is not installed in the\n * project. It captures JSX elements as plain objects so JSX can be used in\n * content declarations (esbuild's tsx loader defaults to React.createElement).\n */\nconst createFallbackReact = () => ({\n  createElement: (type: any, props: any, ...children: any[]) => ({\n    type,\n    props: {\n      ...props,\n      children: children.length <= 1 ? children[0] : children,\n    },\n  }),\n  Fragment: Symbol.for('react.fragment'),\n});\n\nconst getReactGlobal = (baseRequire: NodeJS.Require): { React: unknown } => {\n  // resolve.paths() is computed in-memory (no fs access) and identifies the\n  // node_modules chain this require instance resolves against.\n  const resolutionKey =\n    baseRequire.resolve.paths?.('react')?.join('|') ?? '<default>';\n\n  const cachedReactModule = reactModuleCache.get(resolutionKey);\n  if (cachedReactModule) return cachedReactModule;\n\n  let reactGlobal: { React: unknown };\n  try {\n    // Dynamically try to require React if it's installed in the project\n    reactGlobal = { React: baseRequire('react') };\n  } catch (_err) {\n    reactGlobal = { React: createFallbackReact() };\n  }\n\n  reactModuleCache.set(resolutionKey, reactGlobal);\n\n  return reactGlobal;\n};\n\n/**\n * Snapshot of the non-env `process` properties, taken once at module load.\n * Spreading `process` enumerates ~100 properties (some behind getters); doing\n * it per sandbox is wasteful since everything except `env` is static.\n */\nconst processSnapshot = { ...process };\n\n/**\n * Builds the global context handed to `runInNewContext`.\n *\n * SECURITY NOTE: this sandbox exists for global-scope hygiene (fresh\n * module/exports, controlled env), NOT for containment. It exposes the real\n * project `require`, a copy of `process`, and `fetch` — code executed here has\n * full host privileges. Only ever run trusted, build-time project files\n * (same trust model as `vite.config.ts`).\n */\nexport const getSandBoxContext = (options?: SandBoxContextOptions): Context => {\n  const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } =\n    options ?? {};\n\n  const baseRequire: NodeJS.Require =\n    typeof projectRequire === 'function' ? projectRequire : getProjectRequire();\n\n  // Wrap require to honor mocks and aliases inside the VM\n  const mockedRequire: NodeJS.Require = (() => {\n    const mockTable = Object.assign(\n      {\n        esbuild,\n      },\n      mocks\n    );\n    const aliasTable = Object.assign({}, aliases);\n\n    const wrappedRequire = function mockableRequire(id: string) {\n      const target = aliasTable?.[id] ? aliasTable[id] : id;\n\n      if (mockTable && Object.hasOwn(mockTable, target)) {\n        return mockTable[target];\n      }\n\n      // If the original id was aliased, allow mocks to be defined on either key.\n      if (target !== id && mockTable && Object.hasOwn(mockTable, id)) {\n        return mockTable[id];\n      }\n\n      return baseRequire(target);\n    } as NodeJS.Require;\n\n    // Mirror NodeJS.Require properties\n    wrappedRequire.resolve = baseRequire.resolve.bind(baseRequire);\n    wrappedRequire.main = baseRequire.main;\n    wrappedRequire.extensions = baseRequire.extensions;\n    wrappedRequire.cache = baseRequire.cache;\n\n    return wrappedRequire;\n  })();\n\n  const sandboxContext: Context = {\n    exports: {\n      default: {},\n    },\n    module: {\n      exports: {},\n    },\n    process: {\n      ...processSnapshot,\n      env: {\n        ...process.env,\n        ...loadEnvFile(envVarOptions),\n        ...additionalEnvVars,\n      },\n    },\n    console,\n    require: mockedRequire,\n    ...getReactGlobal(baseRequire),\n  };\n\n  for (const key of NODE_GLOBALS) {\n    if (!(key in sandboxContext) && key in globalThis) {\n      (sandboxContext as Record<string, unknown>)[key] =\n        globalThis[key as keyof typeof globalThis];\n    }\n  }\n\n  return sandboxContext;\n};\n\nexport const parseFileContent = <T>(\n  fileContentString: string,\n  options?: SandBoxContextOptions\n): T | undefined => {\n  const sandboxContext = getSandBoxContext(options);\n\n  // Force strict mode so illegal writes throw instead of silently failing.\n  runInNewContext(`\"use strict\";\\n${fileContentString}`, sandboxContext);\n\n  const candidates: unknown[] = [\n    sandboxContext.exports?.default,\n    sandboxContext.module?.exports?.defaults,\n    sandboxContext.module?.exports?.default,\n    sandboxContext.module?.exports,\n  ];\n\n  let result: T | undefined;\n  for (const candidate of candidates) {\n    if (\n      candidate &&\n      typeof candidate === 'object' &&\n      Object.keys(candidate as object).length > 0\n    ) {\n      result = candidate as T;\n      break;\n    }\n  }\n\n  // Drop heavy references so the V8 context created by runInNewContext can be\n  // garbage-collected promptly. The extracted `result` is a plain data object\n  // and does not retain the sandbox.\n  (sandboxContext as Record<string, unknown>).require = undefined;\n  (sandboxContext as Record<string, unknown>).process = undefined;\n  (sandboxContext as Record<string, unknown>).React = undefined;\n  (sandboxContext as Record<string, unknown>).module = undefined;\n  (sandboxContext as Record<string, unknown>).exports = undefined;\n\n  return result;\n};\n"],"mappings":";;;;;;AA+BA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;AAQA,MAAM,mCAAmB,IAAI,IAAgC;;;;;;AAO7D,MAAM,6BAA6B;CACjC,gBAAgB,MAAW,OAAY,GAAG,cAAqB;EAC7D;EACA,OAAO;GACL,GAAG;GACH,UAAU,SAAS,UAAU,IAAI,SAAS,KAAK;EACjD;CACF;CACA,UAAU,OAAO,IAAI,gBAAgB;AACvC;AAEA,MAAM,kBAAkB,gBAAoD;CAG1E,MAAM,gBACJ,YAAY,QAAQ,QAAQ,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK;CAErD,MAAM,oBAAoB,iBAAiB,IAAI,aAAa;CAC5D,IAAI,mBAAmB,OAAO;CAE9B,IAAI;CACJ,IAAI;EAEF,cAAc,EAAE,OAAO,YAAY,OAAO,EAAE;CAC9C,SAAS,MAAM;EACb,cAAc,EAAE,OAAO,oBAAoB,EAAE;CAC/C;CAEA,iBAAiB,IAAI,eAAe,WAAW;CAE/C,OAAO;AACT;;;;;;AAOA,MAAM,kBAAkB,EAAE,GAAG,QAAQ;;;;;;;;;;AAWrC,MAAa,qBAAqB,YAA6C;CAC7E,MAAM,EAAE,eAAe,gBAAgB,mBAAmB,OAAO,YAC/D,WAAW,CAAC;CAEd,MAAM,cACJ,OAAO,mBAAmB,aAAa,iBAAiB,kBAAkB;CAG5E,MAAM,uBAAuC;EAC3C,MAAM,YAAY,OAAO,OACvB,EACE,QACF,GACA,KACF;EACA,MAAM,aAAa,OAAO,OAAO,CAAC,GAAG,OAAO;EAE5C,MAAM,iBAAiB,SAAS,gBAAgB,IAAY;GAC1D,MAAM,SAAS,aAAa,MAAM,WAAW,MAAM;GAEnD,IAAI,aAAa,OAAO,OAAO,WAAW,MAAM,GAC9C,OAAO,UAAU;GAInB,IAAI,WAAW,MAAM,aAAa,OAAO,OAAO,WAAW,EAAE,GAC3D,OAAO,UAAU;GAGnB,OAAO,YAAY,MAAM;EAC3B;EAGA,eAAe,UAAU,YAAY,QAAQ,KAAK,WAAW;EAC7D,eAAe,OAAO,YAAY;EAClC,eAAe,aAAa,YAAY;EACxC,eAAe,QAAQ,YAAY;EAEnC,OAAO;CACT,EAAC,CAAE;CAEH,MAAM,iBAA0B;EAC9B,SAAS,EACP,SAAS,CAAC,EACZ;EACA,QAAQ,EACN,SAAS,CAAC,EACZ;EACA,SAAS;GACP,GAAG;GACH,KAAK;IACH,GAAG,QAAQ;IACX,GAAG,YAAY,aAAa;IAC5B,GAAG;GACL;EACF;EACA;EACA,SAAS;EACT,GAAG,eAAe,WAAW;CAC/B;CAEA,KAAK,MAAM,OAAO,cAChB,IAAI,EAAE,OAAO,mBAAmB,OAAO,YACrC,AAAC,eAA2C,OAC1C,WAAW;CAIjB,OAAO;AACT;AAEA,MAAa,oBACX,mBACA,YACkB;CAClB,MAAM,iBAAiB,kBAAkB,OAAO;CAGhD,gBAAgB,kBAAkB,qBAAqB,cAAc;CAErE,MAAM,aAAwB;EAC5B,eAAe,SAAS;EACxB,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ;CACzB;CAEA,IAAI;CACJ,KAAK,MAAM,aAAa,YACtB,IACE,aACA,OAAO,cAAc,YACrB,OAAO,KAAK,SAAmB,CAAC,CAAC,SAAS,GAC1C;EACA,SAAS;EACT;CACF;CAMF,AAAC,eAA2C,UAAU;CACtD,AAAC,eAA2C,UAAU;CACtD,AAAC,eAA2C,QAAQ;CACpD,AAAC,eAA2C,SAAS;CACrD,AAAC,eAA2C,UAAU;CAEtD,OAAO;AACT"}

package/dist/esm/loadExternalFile/transpileTSToCJS.mjs

@@ -1,15 +1,30 @@
+import { computeKeyId } from "../utils/cacheMemory.mjs";
 import { getPackageJsonPath } from "../utils/getPackageJsonPath.mjs";
 import { getLoader } from "./bundleFile.mjs";
-import { existsSync } from "node:fs";
-import { dirname, extname, join } from "node:path";
+import { existsSync, statSync } from "node:fs";
+import { dirname, extname, isAbsolute, join, resolve } from "node:path";
 import { createRequire } from "node:module";
-import { buildSync, context } from "esbuild";
+import { build, buildSync } from "esbuild";
 import { pathToFileURL } from "node:url";
 
 //#region src/loadExternalFile/transpileTSToCJS.ts
+/**
+* Cache of resolved tsconfig paths keyed by the file's directory.
+* Avoids re-walking to package.json + existsSync on every transpilation.
+*/
+const tsConfigPathCache = /* @__PURE__ */ new Map();
 const getTsConfigPath = (filePath) => {
-	const tsconfigPath = join(getPackageJsonPath(dirname(filePath)).baseDir, "tsconfig.json");
-	return existsSync(tsconfigPath) ? tsconfigPath : void 0;
+	const fileDirectory = dirname(filePath);
+	if (tsConfigPathCache.has(fileDirectory)) return tsConfigPathCache.get(fileDirectory);
+	let resolvedPath;
+	try {
+		const tsconfigPath = join(getPackageJsonPath(fileDirectory).baseDir, "tsconfig.json");
+		resolvedPath = existsSync(tsconfigPath) ? tsconfigPath : void 0;
+	} catch {
+		resolvedPath = void 0;
+	}
+	tsConfigPathCache.set(fileDirectory, resolvedPath);
+	return resolvedPath;
 };
 const getTransformationOptions = (filePath) => ({
 	loader: {
@@ -29,15 +44,85 @@ const getTransformationOptions = (filePath) => ({
 	write: false,
 	packages: "external",
 	bundle: true,
+	metafile: true,
 	tsconfig: getTsConfigPath(filePath),
 	define: {
 		"import.meta.url": JSON.stringify(pathToFileURL(filePath).href),
 		"import.meta.env": "process.env"
 	}
 });
+/**
+* In-memory cache of transpiled outputs keyed by entry file path (one entry
+* per file, so re-transpilations replace rather than accumulate).
+* The entry file is validated by content hash; bundled relative imports are
+* validated by mtime + size so an edited dependency invalidates the cache.
+*/
+const transpileCache = /* @__PURE__ */ new Map();
+const isInputUnchanged = (input) => {
+	try {
+		const stats = statSync(input.path);
+		return stats.mtimeMs === input.mtimeMs && stats.size === input.size;
+	} catch {
+		return false;
+	}
+};
+const getCachedTranspilation = (filePath, codeHash, optionsKey) => {
+	const cacheEntry = transpileCache.get(filePath);
+	if (!cacheEntry) return void 0;
+	if (cacheEntry.codeHash !== codeHash) return void 0;
+	if (cacheEntry.optionsKey !== optionsKey) return void 0;
+	if (!cacheEntry.inputs.every(isInputUnchanged)) return void 0;
+	return cacheEntry.output;
+};
+/**
+* Extracts the fingerprints of every bundled input from the esbuild metafile.
+* Returns `undefined` when an input cannot be fingerprinted (the result should
+* then not be cached, as invalidation would be unreliable).
+*/
+const getInputFingerprints = (metafile, entryFilePath) => {
+	if (!metafile) return void 0;
+	const resolvedEntryFilePath = resolve(entryFilePath);
+	const inputs = [];
+	for (const inputPath of Object.keys(metafile.inputs)) {
+		if (inputPath === "<stdin>") continue;
+		if (inputPath.includes(":") && !isAbsolute(inputPath)) return void 0;
+		const absoluteInputPath = isAbsolute(inputPath) ? inputPath : resolve(process.cwd(), inputPath);
+		if (absoluteInputPath === resolvedEntryFilePath) continue;
+		try {
+			const stats = statSync(absoluteInputPath);
+			inputs.push({
+				path: absoluteInputPath,
+				mtimeMs: stats.mtimeMs,
+				size: stats.size
+			});
+		} catch {
+			return;
+		}
+	}
+	return inputs;
+};
+const setCachedTranspilation = (filePath, codeHash, optionsKey, moduleResult, output) => {
+	const inputs = getInputFingerprints(moduleResult.metafile, filePath);
+	if (!inputs) return;
+	transpileCache.set(filePath, {
+		codeHash,
+		optionsKey,
+		output,
+		inputs
+	});
+};
+/** Clears the in-memory transpilation cache (mainly for tests). */
+const clearTranspileCache = () => {
+	transpileCache.clear();
+	tsConfigPathCache.clear();
+};
 const transpileTSToCJSSync = (code, filePath, options) => {
 	const loader = getLoader(extname(filePath));
 	const { esbuildInstance, ...buildOptions } = options ?? {};
+	const codeHash = computeKeyId([code]);
+	const optionsKey = computeKeyId([buildOptions]);
+	const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);
+	if (typeof cachedOutput === "string") return cachedOutput;
 	const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;
 	const g = globalThis;
 	const hadFilename = typeof g.__filename === "string";
@@ -68,12 +153,18 @@ const transpileTSToCJSSync = (code, filePath, options) => {
 			else g.__dirname = prevDirname;
 		}
 	}
-	return moduleResult.outputFiles?.[0]?.text;
+	const moduleResultString = moduleResult.outputFiles?.[0]?.text;
+	if (typeof moduleResultString === "string") setCachedTranspilation(filePath, codeHash, optionsKey, moduleResult, moduleResultString);
+	return moduleResultString;
 };
 const transpileTSToCJS = async (code, filePath, options) => {
 	const loader = getLoader(extname(filePath));
 	const { esbuildInstance, ...buildOptions } = options ?? {};
-	const ctx = await (esbuildInstance?.context ?? context)({
+	const codeHash = computeKeyId([code]);
+	const optionsKey = computeKeyId([buildOptions]);
+	const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);
+	if (typeof cachedOutput === "string") return cachedOutput;
+	const moduleResult = await (esbuildInstance?.build ?? build)({
 		stdin: {
 			contents: code,
 			loader,
@@ -83,13 +174,11 @@ const transpileTSToCJS = async (code, filePath, options) => {
 		...getTransformationOptions(filePath),
 		...buildOptions
 	});
-	try {
-		return (await ctx.rebuild()).outputFiles?.[0].text;
-	} finally {
-		await ctx.dispose();
-	}
+	const moduleResultString = moduleResult.outputFiles?.[0]?.text;
+	if (typeof moduleResultString === "string") setCachedTranspilation(filePath, codeHash, optionsKey, moduleResult, moduleResultString);
+	return moduleResultString;
 };
 
 //#endregion
-export { transpileTSToCJS, transpileTSToCJSSync };
+export { clearTranspileCache, transpileTSToCJS, transpileTSToCJSSync };
 //# sourceMappingURL=transpileTSToCJS.mjs.map