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

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;CACD;;;;;;;AAQD,MAAM,mCAAmB,IAAI,KAAiC;;;;;;AAO9D,MAAM,6BAA6B;CACjC,gBAAgB,MAAW,OAAY,GAAG,cAAqB;EAC7D;EACA,OAAO;GACL,GAAG;GACH,UAAU,SAAS,UAAU,IAAI,SAAS,KAAK;GAChD;EACF;CACD,UAAU,OAAO,IAAI,iBAAiB;CACvC;AAED,MAAM,kBAAkB,gBAAoD;CAG1E,MAAM,gBACJ,YAAY,QAAQ,QAAQ,QAAQ,EAAE,KAAK,IAAI,IAAI;CAErD,MAAM,oBAAoB,iBAAiB,IAAI,cAAc;AAC7D,KAAI,kBAAmB,QAAO;CAE9B,IAAI;AACJ,KAAI;AAEF,gBAAc,EAAE,OAAO,YAAY,QAAQ,EAAE;UACtC,MAAM;AACb,gBAAc,EAAE,OAAO,qBAAqB,EAAE;;AAGhD,kBAAiB,IAAI,eAAe,YAAY;AAEhD,QAAO;;;;;;;AAQT,MAAM,kBAAkB,EAAE,GAAG,SAAS;;;;;;;;;;AAWtC,MAAa,qBAAqB,YAA6C;CAC7E,MAAM,EAAE,eAAe,gBAAgB,mBAAmB,OAAO,YAC/D,WAAW,EAAE;CAEf,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;CAEJ,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,eAAe,YAAY;EAC/B;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"}

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

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

@@ -1 +1 @@
-{"version":3,"file":"transpileTSToCJS.mjs","names":[],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, extname, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  buildSync,\n  context,\n} from 'esbuild';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { getLoader } from './bundleFile';\n\nexport type TranspileOptions = BuildOptions & {\n  /**\n   * Optional custom esbuild instance to use for transpilation.\n   * Useful in environments (e.g. VS Code extensions) where the bundled\n   * esbuild binary may not match the host platform.\n   * When provided, its `buildSync`/`build` methods are used instead of\n   * the ones imported from the `esbuild` package.\n   */\n  esbuildInstance?: typeof import('esbuild');\n};\n\nconst getTsConfigPath = (filePath: string): string | undefined => {\n  const tsconfigPath = join(\n    getPackageJsonPath(dirname(filePath)).baseDir,\n    'tsconfig.json'\n  );\n\n  // Only return the tsconfig path if it exists\n  return existsSync(tsconfigPath) ? tsconfigPath : undefined;\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: 'node20',\n  platform: 'node',\n  write: false,\n  packages: 'external',\n  bundle: true,\n  tsconfig: getTsConfigPath(filePath),\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n    'import.meta.env': 'process.env',\n  },\n});\n\nexport const transpileTSToCJSSync = (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n  const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;\n\n  // esbuild's worker thread service calls `new Worker(__filename, …)` on first use.\n  // In Vite's SSR module runner the SSR-optimised chunk is ESM and __filename is\n  // never declared (confirmed: accessing it throws ReferenceError, not undefined).\n  // Because there is no local declaration the bare `__filename` lookup falls\n  // through to globalThis, so we set it there to esbuild's own CJS entry-point –\n  // the exact path esbuild would use if it were loaded in a normal CJS context.\n  //\n  // IMPORTANT: We save/restore the globals so this temporary shim does not leak\n  // to other Vite plugins (e.g. `@vitejs/plugin-react-swc`) that check\n  // `typeof __dirname !== \"undefined\"` to locate their own assets.\n  const g = globalThis as Record<string, unknown>;\n  const hadFilename = typeof g.__filename === 'string';\n  const prevFilename = g.__filename;\n  const prevDirname = g.__dirname;\n\n  if (!hadFilename) {\n    try {\n      const _require = createRequire(import.meta.url);\n      const esbuildEntry = _require.resolve('esbuild');\n      g.__filename = esbuildEntry;\n      g.__dirname = dirname(esbuildEntry);\n    } catch {\n      // Best-effort: if esbuild can't be resolved the caller's catch handles it\n    }\n  }\n\n  let moduleResult: BuildResult;\n  try {\n    moduleResult = esbuildBuildSync({\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      ...buildOptions,\n    });\n  } finally {\n    // Always restore the previous values so the globals don't linger.\n    if (!hadFilename) {\n      if (prevFilename === undefined) {\n        delete g.__filename;\n      } else {\n        g.__filename = prevFilename;\n      }\n      if (prevDirname === undefined) {\n        delete g.__dirname;\n      } else {\n        g.__dirname = prevDirname;\n      }\n    }\n  }\n\n  const moduleResultString = moduleResult!.outputFiles?.[0]?.text;\n\n  return moduleResultString;\n};\n\nexport const transpileTSToCJS = async (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n  // Use context() + rebuild() + dispose() so esbuild deterministically releases\n  // Go-subprocess resources for each one-shot transpilation, preventing them\n  // from accumulating between rapid HMR-driven file changes.\n  const esbuildContext = esbuildInstance?.context ?? context;\n\n  const ctx = await esbuildContext({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath),\n      sourcefile: filePath,\n    },\n    ...getTransformationOptions(filePath),\n    ...buildOptions,\n  });\n\n  try {\n    const moduleResult = await ctx.rebuild();\n    return moduleResult.outputFiles?.[0].text;\n  } finally {\n    await ctx.dispose();\n  }\n};\n"],"mappings":";;;;;;;;;AAwBA,MAAM,mBAAmB,aAAyC;CAChE,MAAM,eAAe,KACnB,mBAAmB,QAAQ,SAAS,CAAC,CAAC,SACtC,gBACD;AAGD,QAAO,WAAW,aAAa,GAAG,eAAe;;AAGnD,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,QAAQ;CACR,UAAU,gBAAgB,SAAS;CACnC,QAAQ;EACN,mBAAmB,KAAK,UAAU,cAAc,SAAS,CAAC,KAAK;EAC/D,mBAAmB;EACpB;CACF;AAED,MAAa,wBACX,MACA,UACA,YACuB;CAEvB,MAAM,SAAS,UADG,QAAQ,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAC1D,MAAM,mBAAmB,iBAAiB,aAAa;CAYvD,MAAM,IAAI;CACV,MAAM,cAAc,OAAO,EAAE,eAAe;CAC5C,MAAM,eAAe,EAAE;CACvB,MAAM,cAAc,EAAE;AAEtB,KAAI,CAAC,YACH,KAAI;EAEF,MAAM,eADW,cAAc,OAAO,KAAK,IACd,CAAC,QAAQ,UAAU;AAChD,IAAE,aAAa;AACf,IAAE,YAAY,QAAQ,aAAa;SAC7B;CAKV,IAAI;AACJ,KAAI;AACF,iBAAe,iBAAiB;GAC9B,OAAO;IACL,UAAU;IACV;IACA,YAAY,QAAQ,SAAS;IAC7B,YAAY;IACb;GACD,GAAG,yBAAyB,SAAS;GACrC,GAAG;GACJ,CAAC;WACM;AAER,MAAI,CAAC,aAAa;AAChB,OAAI,iBAAiB,OACnB,QAAO,EAAE;OAET,GAAE,aAAa;AAEjB,OAAI,gBAAgB,OAClB,QAAO,EAAE;OAET,GAAE,YAAY;;;AAOpB,QAF2B,aAAc,cAAc,IAAI;;AAK7D,MAAa,mBAAmB,OAC9B,MACA,UACA,YACgC;CAEhC,MAAM,SAAS,UADG,QAAQ,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAM1D,MAAM,MAAM,OAFW,iBAAiB,WAAW,SAElB;EAC/B,OAAO;GACL,UAAU;GACV;GACA,YAAY,QAAQ,SAAS;GAC7B,YAAY;GACb;EACD,GAAG,yBAAyB,SAAS;EACrC,GAAG;EACJ,CAAC;AAEF,KAAI;AAEF,UAAO,MADoB,IAAI,SAAS,EACpB,cAAc,GAAG;WAC7B;AACR,QAAM,IAAI,SAAS"}
+{"version":3,"file":"transpileTSToCJS.mjs","names":[],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"sourcesContent":["import { existsSync, statSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, extname, isAbsolute, join, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  build,\n  buildSync,\n  type Metafile,\n} from 'esbuild';\nimport { computeKeyId } from '../utils/cacheMemory';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { getLoader } from './bundleFile';\n\nexport type TranspileOptions = BuildOptions & {\n  /**\n   * Optional custom esbuild instance to use for transpilation.\n   * Useful in environments (e.g. VS Code extensions) where the bundled\n   * esbuild binary may not match the host platform.\n   * When provided, its `buildSync`/`build` methods are used instead of\n   * the ones imported from the `esbuild` package.\n   */\n  esbuildInstance?: typeof import('esbuild');\n};\n\n/**\n * Cache of resolved tsconfig paths keyed by the file's directory.\n * Avoids re-walking to package.json + existsSync on every transpilation.\n */\nconst tsConfigPathCache = new Map<string, string | undefined>();\n\nconst getTsConfigPath = (filePath: string): string | undefined => {\n  const fileDirectory = dirname(filePath);\n\n  if (tsConfigPathCache.has(fileDirectory)) {\n    return tsConfigPathCache.get(fileDirectory);\n  }\n\n  let resolvedPath: string | undefined;\n  try {\n    const tsconfigPath = join(\n      getPackageJsonPath(fileDirectory).baseDir,\n      'tsconfig.json'\n    );\n\n    // Only return the tsconfig path if it exists\n    resolvedPath = existsSync(tsconfigPath) ? tsconfigPath : undefined;\n  } catch {\n    // No package.json found up the tree — transpile without a tsconfig\n    resolvedPath = undefined;\n  }\n\n  tsConfigPathCache.set(fileDirectory, resolvedPath);\n\n  return resolvedPath;\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: 'node20',\n  platform: 'node',\n  write: false,\n  packages: 'external',\n  bundle: true,\n  // The metafile lists every bundled input, which the transpile cache uses to\n  // invalidate when an imported file changes (the entry itself is keyed by hash).\n  metafile: true,\n  tsconfig: getTsConfigPath(filePath),\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n    'import.meta.env': 'process.env',\n  },\n});\n\n/** Fingerprint of a bundled input file, used to detect changes without re-reading it. */\ntype TranspileCacheInput = {\n  path: string;\n  mtimeMs: number;\n  size: number;\n};\n\ntype TranspileCacheEntry = {\n  /** Hash of the entry file's source code. */\n  codeHash: string;\n  /** Hash of the build options, so different option sets don't collide. */\n  optionsKey: string;\n  /** The transpiled CJS output. */\n  output: string;\n  /** Fingerprints of every non-entry input bundled into the output. */\n  inputs: TranspileCacheInput[];\n};\n\n/**\n * In-memory cache of transpiled outputs keyed by entry file path (one entry\n * per file, so re-transpilations replace rather than accumulate).\n * The entry file is validated by content hash; bundled relative imports are\n * validated by mtime + size so an edited dependency invalidates the cache.\n */\nconst transpileCache = new Map<string, TranspileCacheEntry>();\n\nconst isInputUnchanged = (input: TranspileCacheInput): boolean => {\n  try {\n    const stats = statSync(input.path);\n    return stats.mtimeMs === input.mtimeMs && stats.size === input.size;\n  } catch {\n    // File removed or unreadable — treat as changed\n    return false;\n  }\n};\n\nconst getCachedTranspilation = (\n  filePath: string,\n  codeHash: string,\n  optionsKey: string\n): string | undefined => {\n  const cacheEntry = transpileCache.get(filePath);\n\n  if (!cacheEntry) return undefined;\n  if (cacheEntry.codeHash !== codeHash) return undefined;\n  if (cacheEntry.optionsKey !== optionsKey) return undefined;\n  if (!cacheEntry.inputs.every(isInputUnchanged)) return undefined;\n\n  return cacheEntry.output;\n};\n\n/**\n * Extracts the fingerprints of every bundled input from the esbuild metafile.\n * Returns `undefined` when an input cannot be fingerprinted (the result should\n * then not be cached, as invalidation would be unreliable).\n */\nconst getInputFingerprints = (\n  metafile: Metafile | undefined,\n  entryFilePath: string\n): TranspileCacheInput[] | undefined => {\n  if (!metafile) return undefined;\n\n  const resolvedEntryFilePath = resolve(entryFilePath);\n  const inputs: TranspileCacheInput[] = [];\n\n  for (const inputPath of Object.keys(metafile.inputs)) {\n    // The entry itself is provided via stdin and validated by content hash.\n    // esbuild labels it \"<stdin>\", or with the sourcefile path when set.\n    if (inputPath === '<stdin>') continue;\n    // Virtual modules from plugins (e.g. \"plugin:...\") cannot be fingerprinted\n    if (inputPath.includes(':') && !isAbsolute(inputPath)) return undefined;\n\n    const absoluteInputPath = isAbsolute(inputPath)\n      ? inputPath\n      : resolve(process.cwd(), inputPath);\n\n    if (absoluteInputPath === resolvedEntryFilePath) continue;\n\n    try {\n      const stats = statSync(absoluteInputPath);\n      inputs.push({\n        path: absoluteInputPath,\n        mtimeMs: stats.mtimeMs,\n        size: stats.size,\n      });\n    } catch {\n      return undefined;\n    }\n  }\n\n  return inputs;\n};\n\nconst setCachedTranspilation = (\n  filePath: string,\n  codeHash: string,\n  optionsKey: string,\n  moduleResult: BuildResult,\n  output: string\n): void => {\n  const inputs = getInputFingerprints(moduleResult.metafile, filePath);\n\n  // Without a usable metafile the cache cannot be invalidated reliably — skip\n  if (!inputs) return;\n\n  transpileCache.set(filePath, { codeHash, optionsKey, output, inputs });\n};\n\n/** Clears the in-memory transpilation cache (mainly for tests). */\nexport const clearTranspileCache = (): void => {\n  transpileCache.clear();\n  tsConfigPathCache.clear();\n};\n\nexport const transpileTSToCJSSync = (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n\n  const codeHash = computeKeyId([code]);\n  const optionsKey = computeKeyId([buildOptions]);\n\n  const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);\n  if (typeof cachedOutput === 'string') return cachedOutput;\n\n  const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;\n\n  // esbuild's worker thread service calls `new Worker(__filename, …)` on first use.\n  // In Vite's SSR module runner the SSR-optimised chunk is ESM and __filename is\n  // never declared (confirmed: accessing it throws ReferenceError, not undefined).\n  // Because there is no local declaration the bare `__filename` lookup falls\n  // through to globalThis, so we set it there to esbuild's own CJS entry-point –\n  // the exact path esbuild would use if it were loaded in a normal CJS context.\n  //\n  // IMPORTANT: We save/restore the globals so this temporary shim does not leak\n  // to other Vite plugins (e.g. `@vitejs/plugin-react-swc`) that check\n  // `typeof __dirname !== \"undefined\"` to locate their own assets.\n  const g = globalThis as Record<string, unknown>;\n  const hadFilename = typeof g.__filename === 'string';\n  const prevFilename = g.__filename;\n  const prevDirname = g.__dirname;\n\n  if (!hadFilename) {\n    try {\n      const _require = createRequire(import.meta.url);\n      const esbuildEntry = _require.resolve('esbuild');\n      g.__filename = esbuildEntry;\n      g.__dirname = dirname(esbuildEntry);\n    } catch {\n      // Best-effort: if esbuild can't be resolved the caller's catch handles it\n    }\n  }\n\n  let moduleResult: BuildResult;\n  try {\n    moduleResult = esbuildBuildSync({\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      ...buildOptions,\n    });\n  } finally {\n    // Always restore the previous values so the globals don't linger.\n    if (!hadFilename) {\n      if (prevFilename === undefined) {\n        // biome-ignore lint/performance/noDelete: the global must be truly absent — assigning undefined would leave the key present and break `typeof __filename` checks in other tools\n        delete g.__filename;\n      } else {\n        g.__filename = prevFilename;\n      }\n      if (prevDirname === undefined) {\n        // biome-ignore lint/performance/noDelete: same as __filename above\n        delete g.__dirname;\n      } else {\n        g.__dirname = prevDirname;\n      }\n    }\n  }\n\n  const moduleResultString = moduleResult!.outputFiles?.[0]?.text;\n\n  if (typeof moduleResultString === 'string') {\n    setCachedTranspilation(\n      filePath,\n      codeHash,\n      optionsKey,\n      moduleResult!,\n      moduleResultString\n    );\n  }\n\n  return moduleResultString;\n};\n\nexport const transpileTSToCJS = async (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n\n  const codeHash = computeKeyId([code]);\n  const optionsKey = computeKeyId([buildOptions]);\n\n  const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);\n  if (typeof cachedOutput === 'string') return cachedOutput;\n\n  // A one-shot build() releases its Go-side resources on completion and costs a\n  // single service round-trip (context()+rebuild()+dispose() costs three).\n  const esbuildBuild = esbuildInstance?.build ?? build;\n\n  const moduleResult = await esbuildBuild({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath),\n      sourcefile: filePath,\n    },\n    ...getTransformationOptions(filePath),\n    ...buildOptions,\n  });\n\n  const moduleResultString = moduleResult.outputFiles?.[0]?.text;\n\n  if (typeof moduleResultString === 'string') {\n    setCachedTranspilation(\n      filePath,\n      codeHash,\n      optionsKey,\n      moduleResult,\n      moduleResultString\n    );\n  }\n\n  return moduleResultString;\n};\n"],"mappings":"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"}

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

@@ -0,0 +1,14 @@
+import { CallerDescriptor } from "./types.js";
+
+//#region src/callers/base.d.ts
+/**
+ * Base intlayer getters — always active, independent of any compat library.
+ *
+ * Their result is the dictionary content object itself: fields are consumed
+ * through member access (`content.title`) or destructuring
+ * (`const { title } = useIntlayer('home')`).
+ */
+declare const BASE_CALLERS: CallerDescriptor[];
+//#endregion
+export { BASE_CALLERS };
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../../src/callers/base.ts"],"mappings":";;;;;AASA;;;;;cAAa,YAAA,EAAc,gBAAA"}

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

@@ -0,0 +1,12 @@
+import { CallerDescriptor } from "../types.js";
+
+//#region src/callers/compat/i18next.d.ts
+/**
+ * i18next — `@intlayer/i18next` compat adapter.
+ *
+ * Mirrors `compat/i18next/src/plugin/index.ts` (`I18NEXT_COMPAT_CALLERS`).
+ */
+declare const I18NEXT_CALLERS: CallerDescriptor[];
+//#endregion
+export { I18NEXT_CALLERS };
+//# sourceMappingURL=i18next.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18next.d.ts","names":[],"sources":["../../../../src/callers/compat/i18next.ts"],"mappings":";;;;;AAOA;;;cAAa,eAAA,EAAiB,gBAAA"}

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

@@ -0,0 +1,7 @@
+import { CallerDescriptor } from "../types.js";
+
+//#region src/callers/compat/lingui.d.ts
+declare const LINGUI_CALLERS: CallerDescriptor[];
+//#endregion
+export { LINGUI_CALLERS };
+//# sourceMappingURL=lingui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lingui.d.ts","names":[],"sources":["../../../../src/callers/compat/lingui.ts"],"mappings":";;;cAwBa,cAAA,EAAgB,gBAAA"}

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

@@ -0,0 +1,13 @@
+import { CallerDescriptor } from "../types.js";
+
+//#region src/callers/compat/nextIntl.d.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.
+ */
+declare const NEXT_INTL_CALLERS: CallerDescriptor[];
+//#endregion
+export { NEXT_INTL_CALLERS };
+//# sourceMappingURL=nextIntl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextIntl.d.ts","names":[],"sources":["../../../../src/callers/compat/nextIntl.ts"],"mappings":";;;;;AAQA;;;;cAAa,iBAAA,EAAmB,gBAAA"}

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

@@ -0,0 +1,15 @@
+import { CallerDescriptor } from "../types.js";
+
+//#region src/callers/compat/reactI18next.d.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`.
+ */
+declare const REACT_I18NEXT_CALLERS: CallerDescriptor[];
+//#endregion
+export { REACT_I18NEXT_CALLERS };
+//# sourceMappingURL=reactI18next.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactI18next.d.ts","names":[],"sources":["../../../../src/callers/compat/reactI18next.ts"],"mappings":";;;;;AAUA;;;;;;cAAa,qBAAA,EAAuB,gBAAA"}

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

@@ -0,0 +1,16 @@
+import { CallerDescriptor } from "../types.js";
+
+//#region src/callers/compat/reactIntl.d.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`.
+ */
+declare const REACT_INTL_CALLERS: CallerDescriptor[];
+//#endregion
+export { REACT_INTL_CALLERS };
+//# sourceMappingURL=reactIntl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactIntl.d.ts","names":[],"sources":["../../../../src/callers/compat/reactIntl.ts"],"mappings":";;;;;AAWA;;;;;;;cAAa,kBAAA,EAAoB,gBAAA"}

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

@@ -0,0 +1,12 @@
+import { CallerDescriptor } from "../types.js";
+
+//#region src/callers/compat/useIntl.d.ts
+/**
+ * use-intl — `@intlayer/use-intl` compat adapter.
+ *
+ * Mirrors `compat/use-intl/src/plugin/index.ts`.
+ */
+declare const USE_INTL_CALLERS: CallerDescriptor[];
+//#endregion
+export { USE_INTL_CALLERS };
+//# sourceMappingURL=useIntl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useIntl.d.ts","names":[],"sources":["../../../../src/callers/compat/useIntl.ts"],"mappings":";;;;;AAOA;;;cAAa,gBAAA,EAAkB,gBAAA"}

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

@@ -0,0 +1,12 @@
+import { CallerDescriptor } from "../types.js";
+
+//#region src/callers/compat/vueI18n.d.ts
+/**
+ * vue-i18n — `@intlayer/vue-i18n` compat adapter.
+ *
+ * Mirrors `compat/vue-i18n/src/plugin/index.ts`.
+ */
+declare const VUE_I18N_CALLERS: CallerDescriptor[];
+//#endregion
+export { VUE_I18N_CALLERS };
+//# sourceMappingURL=vueI18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vueI18n.d.ts","names":[],"sources":["../../../../src/callers/compat/vueI18n.ts"],"mappings":";;;;;AAOA;;;cAAa,gBAAA,EAAkB,gBAAA"}

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

@@ -0,0 +1,49 @@
+import { CallerDescriptor, CallerResultShape, CallerValueSource } from "./types.js";
+import { BASE_CALLERS } from "./base.js";
+import { I18NEXT_CALLERS } from "./compat/i18next.js";
+import { LINGUI_CALLERS } from "./compat/lingui.js";
+import { NEXT_INTL_CALLERS } from "./compat/nextIntl.js";
+import { REACT_I18NEXT_CALLERS } from "./compat/reactI18next.js";
+import { REACT_INTL_CALLERS } from "./compat/reactIntl.js";
+import { USE_INTL_CALLERS } from "./compat/useIntl.js";
+import { VUE_I18N_CALLERS } from "./compat/vueI18n.js";
+import { SwcExtraCallerConfig, getRewritableCallers, toSwcExtraCallers } from "./transform.js";
+
+//#region src/callers/index.d.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.
+ */
+declare const COMPAT_CALLERS: CallerDescriptor[];
+/** Base + compat callers — the full registry the matchers run against. */
+declare const ALL_CALLERS: CallerDescriptor[];
+/**
+ * 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.
+ */
+declare const CALLERS_BY_NAME: Map<string, CallerDescriptor[]>;
+/**
+ * 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.
+ */
+declare const getPositionalKeyCallerNames: () => string[];
+/**
+ * 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.
+ */
+declare const isCallerActive: (descriptor: CallerDescriptor, fileImportSources: ReadonlySet<string>) => boolean;
+//#endregion
+export { ALL_CALLERS, BASE_CALLERS, CALLERS_BY_NAME, COMPAT_CALLERS, type CallerDescriptor, type CallerResultShape, type CallerValueSource, I18NEXT_CALLERS, LINGUI_CALLERS, NEXT_INTL_CALLERS, REACT_I18NEXT_CALLERS, REACT_INTL_CALLERS, type SwcExtraCallerConfig, USE_INTL_CALLERS, VUE_I18N_CALLERS, getPositionalKeyCallerNames, getRewritableCallers, isCallerActive, toSwcExtraCallers };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/callers/index.ts"],"mappings":";;;;;;;;;;;;;AAmCA;;;;;cAAa,cAAA,EAAgB,gBAAA;;cAWhB,WAAA,EAAa,gBAAA;;;AAU1B;;;cAAa,eAAA,EAAiB,GAAA,SAAY,gBAAA;;AAuB1C;;;;;AAwBA;cAxBa,2BAAA;;;;;;;;;;;cAwBA,cAAA,GACX,UAAA,EAAY,gBAAA,EACZ,iBAAA,EAAmB,WAAA"}

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

@@ -0,0 +1,57 @@
+import { CallerDescriptor } from "./types.js";
+
+//#region src/callers/transform.d.ts
+/**
+ * Wire format of an extra caller forwarded to the `@intlayer/swc` plugin.
+ *
+ * Field names mirror the serde attributes of `ExtraCallerConfig` in
+ * `packages/@intlayer/swc/src/lib.rs` — both sides must stay in sync.
+ */
+type SwcExtraCallerConfig = {
+  /** The function name the user calls, e.g. `"useTranslation"`. */callerName: string; /** Module specifiers exporting the function (original + `@intlayer/*`). */
+  importSources: string[];
+  /**
+   * Zero-based index of the positional argument holding the namespace string.
+   * Omitted for fixed/option namespace callers.
+   */
+  namespaceArgIndex?: number;
+  /**
+   * Compile-time constant namespace — the dictionary ident is inserted as a
+   * new first argument (lingui's `useLingui()`).
+   */
+  fixedNamespace?: string;
+  /**
+   * Namespace read from a property of an options-object argument — the
+   * dictionary ident is inserted as a new first argument and the property is
+   * rewritten to the key-prefix remainder (vue-i18n's `useI18n({ namespace })`).
+   */
+  namespaceOption?: {
+    argumentIndex: number;
+    property: string;
+  }; /** Replacement function name for static import mode, e.g. `"useDictionary"`. */
+  staticReplacement: string; /** Replacement function name for dynamic/fetch mode, e.g. `"useDictionaryDynamic"`. */
+  dynamicReplacement: string;
+};
+/**
+ * Returns the callers of a registry slice that the optimize pass can rewrite
+ * at build time: plain imported functions carrying both replacement names.
+ *
+ * Method-matched callers (`i18n.getFixedT`) and JSX components are excluded —
+ * their call sites cannot be re-pointed through an import specifier rename.
+ */
+declare const getRewritableCallers: (descriptors: CallerDescriptor[]) => CallerDescriptor[];
+/**
+ * Serialises the rewritable callers of a registry slice into the
+ * `@intlayer/swc` plugin wire format (`extraCallers` option).
+ *
+ * Callers whose namespace can only be derived per-message id
+ * (`path-first-segment`) are skipped: the transform cannot bind a single
+ * dictionary to the call site.
+ *
+ * @param descriptors - Registry slice, e.g. `REACT_I18NEXT_CALLERS`.
+ * @returns Configs ready to pass as `swcExtraCallers` / `extraCallers`.
+ */
+declare const toSwcExtraCallers: (descriptors: CallerDescriptor[]) => SwcExtraCallerConfig[];
+//#endregion
+export { SwcExtraCallerConfig, getRewritableCallers, toSwcExtraCallers };
+//# sourceMappingURL=transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","names":[],"sources":["../../../src/callers/transform.ts"],"mappings":";;;;;AAQA;;;;KAAY,oBAAA;EAIV,iEAFA,UAAA,UAYA;EAVA,aAAA;EAgBoB;;;;EAXpB,iBAAA;EAekB;AAUpB;;;EApBE,cAAA;EAqBa;;;;;EAfb,eAAA;IAAoB,aAAA;IAAuB,QAAA;EAAA,GA8C9B;EA5Cb,iBAAA,UA6CC;EA3CD,kBAAA;AAAA;;;;;;;;cAUW,oBAAA,GACX,WAAA,EAAa,gBAAA,OACZ,gBAAA;;;;;;;;;;;;cA6BU,iBAAA,GACX,WAAA,EAAa,gBAAA,OACZ,oBAAA"}