@intlayer/config 9.7.0 → 9.7.2

package/dist/esm/defaultValues/index.mjs

@@ -1,12 +1,12 @@
 import { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE } from "./analytics.mjs";
-import { APPLICATION_URL, BACKEND_URL, CMS_URL, DICTIONARY_PRIORITY_STRATEGY, EDITOR_URL, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, PORT } from "./editor.mjs";
-import { DEFAULT_LOCALE, LOCALES, REQUIRED_LOCALES, STRICT_MODE } from "./internationalization.mjs";
-import { MODE, PREFIX } from "./log.mjs";
-import { BASE_PATH, COOKIE_NAME, ENABLE_PROXY, HEADER_NAME, LOCALE_STORAGE_NAME, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE } from "./routing.mjs";
 import { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "./build.mjs";
 import { COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS } from "./compiler.mjs";
 import { CODE_DIR, CONTENT_DIR, EXCLUDED_PATHS, FILE_EXTENSIONS, I18NEXT_DICTIONARIES_DIR, REACT_INTL_MESSAGES_DIR, WATCH } from "./content.mjs";
 import { CONTENT_AUTO_TRANSFORMATION, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, FILL, IMPORT_MODE, LOCATION, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY } from "./dictionary.mjs";
+import { APPLICATION_URL, BACKEND_URL, CMS_URL, DICTIONARY_PRIORITY_STRATEGY, EDITOR_URL, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, PORT } from "./editor.mjs";
+import { DEFAULT_LOCALE, LOCALES, REQUIRED_LOCALES, STRICT_MODE } from "./internationalization.mjs";
+import { MODE, PREFIX } from "./log.mjs";
+import { BASE_PATH, COOKIE_NAME, ENABLE_PROXY, HEADER_NAME, LOCALE_STORAGE_NAME, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE } from "./routing.mjs";
 import { CACHE_DIR, CONFIG_DIR, DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_DIR, FETCH_DICTIONARIES_DIR, MAIN_DIR, MASKS_DIR, MODULE_AUGMENTATION_DIR, REMOTE_DICTIONARIES_DIR, TEMP_DIR, TYPES_DIR, UNMERGED_DICTIONARIES_DIR } from "./system.mjs";
 
 export { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE, APPLICATION_URL, BACKEND_URL, BASE_PATH, BUILD_MODE, CACHE, CACHE_DIR, CHUNK_GROUPING, CMS_URL, CODE_DIR, COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS, CONFIG_DIR, CONTENT_AUTO_TRANSFORMATION, CONTENT_DIR, COOKIE_NAME, DEFAULT_LOCALE, DICTIONARIES_DIR, DICTIONARIES_PRELOAD, DICTIONARY_PRIORITY_STRATEGY, DYNAMIC_DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, EDITOR_URL, ENABLE_PROXY, EXCLUDED_PATHS, FETCH_DICTIONARIES_DIR, FILE_EXTENSIONS, FILL, HEADER_NAME, I18NEXT_DICTIONARIES_DIR, IMPORT_MODE, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, LOCALES, LOCALE_STORAGE_NAME, LOCATION, MAIN_DIR, MASKS_DIR, MINIFY, MODE, MODULE_AUGMENTATION_DIR, OPTIMIZE, OUTPUT_FORMAT, PORT, PREFIX, PRELOADED_DYNAMIC_KEY, PURGE, QUALIFIER_DYNAMIC_TYPES_KEY, REACT_INTL_MESSAGES_DIR, REMOTE_DICTIONARIES_DIR, REQUIRED_LOCALES, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE, STRICT_MODE, TEMP_DIR, TRAVERSE_PATTERN, TYPES_DIR, TYPE_CHECKING, UNMERGED_DICTIONARIES_DIR, WATCH };

package/dist/esm/defaultValues/internationalization.mjs

@@ -1,9 +1,8 @@
-//#region src/defaultValues/internationalization.ts
+// src/defaultValues/internationalization.ts
 const LOCALES = ["en"];
 const REQUIRED_LOCALES = [];
 const DEFAULT_LOCALE = "en";
 const STRICT_MODE = "inclusive";
 
-//#endregion
 export { DEFAULT_LOCALE, LOCALES, REQUIRED_LOCALES, STRICT_MODE };
 //# sourceMappingURL=internationalization.mjs.map

package/dist/esm/defaultValues/log.mjs

@@ -1,9 +1,8 @@
 import { GREY_DARK, RESET } from "../colors.mjs";
 
-//#region src/defaultValues/log.ts
+// src/defaultValues/log.ts
 const MODE = "default";
 const PREFIX = `${GREY_DARK}[intlayer] ${RESET}`;
 
-//#endregion
 export { MODE, PREFIX };
 //# sourceMappingURL=log.mjs.map

package/dist/esm/defaultValues/routing.mjs

@@ -1,4 +1,4 @@
-//#region src/defaultValues/routing.ts
+// src/defaultValues/routing.ts
 const HEADER_NAME = "x-intlayer-locale";
 const COOKIE_NAME = "INTLAYER_LOCALE";
 const LOCALE_STORAGE_NAME = "INTLAYER_LOCALE";
@@ -14,6 +14,5 @@ const ROUTING_MODE = "prefix-no-default";
 const ENABLE_PROXY = void 0;
 const STORAGE = ["cookie", "header"];
 
-//#endregion
 export { BASE_PATH, COOKIE_NAME, ENABLE_PROXY, HEADER_NAME, LOCALE_STORAGE_NAME, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE };
 //# sourceMappingURL=routing.mjs.map

package/dist/esm/defaultValues/system.mjs

@@ -1,4 +1,4 @@
-//#region src/defaultValues/system.ts
+// src/defaultValues/system.ts
 const MAIN_DIR = ".intlayer/main";
 const DICTIONARIES_DIR = ".intlayer/dictionary";
 const MASKS_DIR = ".intlayer/mask";
@@ -12,6 +12,5 @@ const CONFIG_DIR = ".intlayer/config";
 const CACHE_DIR = ".intlayer/cache";
 const TEMP_DIR = ".intlayer/tmp";
 
-//#endregion
 export { CACHE_DIR, CONFIG_DIR, DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_DIR, FETCH_DICTIONARIES_DIR, MAIN_DIR, MASKS_DIR, MODULE_AUGMENTATION_DIR, REMOTE_DICTIONARIES_DIR, TEMP_DIR, TYPES_DIR, UNMERGED_DICTIONARIES_DIR };
 //# sourceMappingURL=system.mjs.map

package/dist/esm/dictionaryPreload.mjs

@@ -1,7 +1,7 @@
 import { DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY } from "./defaultValues/dictionary.mjs";
 import { dirname, resolve } from "node:path";
 
-//#region src/dictionaryPreload.ts
+// src/dictionaryPreload.ts
 /**
 * Matches a generated dynamic entry point, whose layout is
 * `<dynamicDictionariesDir>/<key>.mjs`. The per-locale JSON chunks it imports
@@ -139,6 +139,5 @@ const addDynamicEntryPreload = (code, preloadModuleId) => {
 	return { code: buildPreloadImport(preloadModuleId) + code + PRELOAD_PREAMBLE };
 };
 
-//#endregion
 export { DYNAMIC_ENTRY_PATTERN, PRELOAD_MODULE_SPECIFIER, addDynamicEntryPreload, createDynamicEntryFilter, resolvePreloadModuleId };
 //# sourceMappingURL=dictionaryPreload.mjs.map

package/dist/esm/envVars/envVars.mjs

@@ -1,4 +1,4 @@
-//#region src/envVars/envVars.ts
+// src/envVars/envVars.ts
 /**
 * Converts a camelCase node-type string to SCREAMING_SNAKE_CASE so that
 * the generated env-var name matches what the plugin source files check.
@@ -92,6 +92,5 @@ const getConfigEnvVars = (config, wrapKey = (key) => key, wrapValue = (value) =>
 	return envVars;
 };
 
-//#endregion
 export { formatDictionarySelectorEnvVar, formatNodeTypeToEnvVar, formatOptimizedNestingEnvVar, getConfigEnvVars };
 //# sourceMappingURL=envVars.mjs.map

package/dist/esm/extract/constants.mjs

@@ -1,4 +1,4 @@
-//#region src/extract/constants.ts
+// src/extract/constants.ts
 /**
 * Attributes that should be extracted as translatable strings from JSX/HTML elements.
 * This is the single source of truth shared across all Intlayer compiler packages
@@ -13,6 +13,5 @@ const ATTRIBUTES_TO_EXTRACT = [
 	"label"
 ];
 
-//#endregion
 export { ATTRIBUTES_TO_EXTRACT };
 //# sourceMappingURL=constants.mjs.map

package/dist/esm/extract/shouldExtract.mjs

@@ -1,4 +1,4 @@
-//#region src/extract/shouldExtract.ts
+// src/extract/shouldExtract.ts
 /**
 * Checks whether the given text should be extracted as a translatable string.
 *
@@ -32,6 +32,5 @@ const shouldExtract = (text) => {
 	return true;
 };
 
-//#endregion
 export { shouldExtract };
 //# sourceMappingURL=shouldExtract.mjs.map

package/dist/esm/loadEnvFile.mjs

@@ -1,7 +1,7 @@
 import { existsSync, statSync } from "node:fs";
 import dotenv from "dotenv";
 
-//#region src/loadEnvFile.ts
+// src/loadEnvFile.ts
 const DEFAULT_ENV = process.env.NODE_ENV ?? "development";
 const getEnvFilePath = (env = process.env.NODE_ENV ?? "development", envFile) => {
 	return (envFile ? [envFile] : [
@@ -62,6 +62,5 @@ const loadEnvFile = (options) => {
 	return parsedEnv;
 };
 
-//#endregion
 export { getEnvFilePath, loadEnvFile };
 //# sourceMappingURL=loadEnvFile.mjs.map

package/dist/esm/loadExternalFile/bundleFile.mjs

@@ -2,7 +2,7 @@ import { dirname, extname } from "node:path";
 import { build, buildSync } from "esbuild";
 import { pathToFileURL } from "node:url";
 
-//#region src/loadExternalFile/bundleFile.ts
+// src/loadExternalFile/bundleFile.ts
 const getLoader = (extension) => {
 	switch (extension) {
 		case ".js": return "js";
@@ -67,6 +67,5 @@ const bundleFile = async (code, filePath, options) => {
 	})).outputFiles?.[0].text;
 };
 
-//#endregion
 export { bundleFile, bundleFileSync, getLoader };
 //# sourceMappingURL=bundleFile.mjs.map

package/dist/esm/loadExternalFile/bundleJSFile.mjs

@@ -1,6 +1,6 @@
 import { build } from "esbuild";
 
-//#region src/loadExternalFile/bundleJSFile.ts
+// src/loadExternalFile/bundleJSFile.ts
 const commonBuildOptions = {
 	bundle: true,
 	format: "cjs",
@@ -27,6 +27,5 @@ const bundleJSFile = async (buildOptions) => await build({
 	...buildOptions
 });
 
-//#endregion
 export { bundleJSFile };
 //# sourceMappingURL=bundleJSFile.mjs.map

package/dist/esm/loadExternalFile/index.mjs

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

package/dist/esm/loadExternalFile/loadExternalFile.mjs

@@ -6,7 +6,7 @@ import { extname } from "node:path";
 import { readFile } from "node:fs/promises";
 import JSON5 from "json5";
 
-//#region src/loadExternalFile/loadExternalFile.ts
+// src/loadExternalFile/loadExternalFile.ts
 const parseJSON5 = JSON5.parse || JSON5.default?.parse;
 /**
 * Load the content declaration from the given path
@@ -91,6 +91,5 @@ const loadExternalFile = async (filePath, options) => {
 	}
 };
 
-//#endregion
 export { loadExternalFile, loadExternalFileSync };
 //# sourceMappingURL=loadExternalFile.mjs.map

package/dist/esm/loadExternalFile/parseFileContent.mjs

@@ -3,7 +3,7 @@ import { getProjectRequire } from "../utils/ESMxCJSHelpers.mjs";
 import { runInNewContext } from "node:vm";
 import * as esbuild from "esbuild";
 
-//#region src/loadExternalFile/parseFileContent.ts
+// src/loadExternalFile/parseFileContent.ts
 const NODE_GLOBALS = [
 	"Buffer",
 	"setTimeout",
@@ -132,6 +132,5 @@ const parseFileContent = (fileContentString, options) => {
 	return result;
 };
 
-//#endregion
 export { getSandBoxContext, parseFileContent };
 //# sourceMappingURL=parseFileContent.mjs.map

package/dist/esm/loadExternalFile/transpileTSToCJS.mjs

@@ -7,7 +7,7 @@ import { createRequire } from "node:module";
 import { build, buildSync } from "esbuild";
 import { pathToFileURL } from "node:url";
 
-//#region src/loadExternalFile/transpileTSToCJS.ts
+// 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.
@@ -181,6 +181,5 @@ const transpileTSToCJS = async (code, filePath, options) => {
 	return moduleResultString;
 };
 
-//#endregion
 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, 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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"}
+{"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        // oxlint-disable-next-line typescript/no-dynamic-delete -- 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        // oxlint-disable-next-line typescript/no-dynamic-delete -- 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/esm/logger.mjs

@@ -1,6 +1,6 @@
 import { BEIGE, BLUE, GREEN, GREY, GREY_DARK, GREY_LIGHT, RED, RESET, WHITE } from "./colors.mjs";
 
-//#region src/logger.ts
+// src/logger.ts
 let loggerPrefix;
 const setPrefix = (prefix) => {
 	loggerPrefix = prefix;
@@ -135,6 +135,5 @@ const x = colorize("✗", RED);
 const v = colorize("✓", GREEN);
 const clock = colorize("⏲", BLUE);
 
-//#endregion
 export { clock, colon, colorize, colorizeKey, colorizeLocales, colorizeNumber, colorizeObject, colorizePath, getAppLogger, getPrefix, logger, removeColor, setPrefix, spinnerFrames, v, x };
 //# sourceMappingURL=logger.mjs.map

package/dist/esm/logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/logger.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n} from '@intlayer/types/config';\nimport type * as ANSIColorsTypes from './colors';\nimport {\n  BEIGE,\n  BLUE,\n  GREEN,\n  GREY,\n  GREY_DARK,\n  GREY_LIGHT,\n  RED,\n  RESET,\n  WHITE,\n} from './colors';\n\nexport type ANSIColorsType =\n  (typeof ANSIColorsTypes)[keyof typeof ANSIColorsTypes];\n\nexport type Details = {\n  isVerbose?: boolean;\n  level?: 'info' | 'warn' | 'error' | 'debug';\n  config?: CustomIntlayerConfig['log'];\n};\n\nexport type Logger = (content: any, details?: Details) => void;\n\nlet loggerPrefix: string | undefined;\n\nexport const setPrefix = (prefix: string | undefined) => {\n  loggerPrefix = prefix;\n};\n\nexport const getPrefix = (configPrefix?: string): string | undefined => {\n  if (typeof loggerPrefix !== 'undefined') {\n    return loggerPrefix;\n  }\n\n  return configPrefix;\n};\n\nexport const logger: Logger = (content, details) => {\n  const config = details?.config ?? {};\n  const mode = config.mode ?? 'default';\n\n  if (mode === 'disabled' || (details?.isVerbose && mode !== 'verbose')) return;\n\n  const prefix = getPrefix(config.prefix);\n  const flatContent = prefix ? [prefix, ...[content].flat()] : [content].flat();\n  const level = details?.level ?? 'info';\n\n  const logMethod =\n    config[level] ?? console[level] ?? config.log ?? console.log;\n\n  logMethod(...flatContent);\n};\n\nexport const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\n\n/**\n * The appLogger function takes the logger and merges it with the configuration from the intlayer config file.\n * It allows overriding the default configuration by passing a config object in the details parameter.\n * The configuration is merged with the default configuration from the intlayer config file.\n */\nexport const getAppLogger =\n  (configuration?: Pick<IntlayerConfig, 'log'>, globalDetails?: Details) =>\n  (content: any, details?: Details) =>\n    logger(content, {\n      ...(details ?? {}),\n      config: {\n        ...configuration?.log,\n        ...globalDetails?.config,\n        ...(details?.config ?? {}),\n      },\n    });\n\nexport const colorize = (\n  string: string,\n  color?: ANSIColorsType,\n  reset?: boolean | ANSIColorsType\n): string =>\n  color && typeof window === 'undefined'\n    ? `${color}${string}${reset ? (typeof reset === 'boolean' ? RESET : reset) : RESET}`\n    : string;\n\nexport const colorizeLocales = (\n  locales: Locale | Locale[],\n  color: ANSIColorsType = GREEN,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [locales]\n    .flat()\n    .map((locale) => colorize(locale, color, reset))\n    .join(`, `);\n\nexport const colorizeKey = (\n  keyPath: string | string[],\n  color: ANSIColorsType = BEIGE,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [keyPath]\n    .flat()\n    .map((key) => colorize(key, color, reset))\n    .join(`, `);\n\nexport const colorizePath = (\n  path: string | string[],\n  color: ANSIColorsType = GREY,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [path]\n    .flat()\n    .map((path) => colorize(path, color, reset))\n    .join(`, `);\n\nexport const colorizeNumber = (\n  number: number | string,\n  options: Partial<Record<Intl.LDMLPluralRule, ANSIColorsType>> = {\n    zero: BLUE,\n    one: BLUE,\n    two: BLUE,\n    few: BLUE,\n    many: BLUE,\n    other: BLUE,\n  }\n): string => {\n  if (number === 0 || number === '0') {\n    const color = options.zero ?? GREEN;\n    return colorize(number.toString(), color);\n  }\n\n  // Kept inside the function. Top-level instantiation of classes/APIs\n  // is treated as a side-effect and prevents tree-shaking if the function is unused.\n  const rule = new Intl.PluralRules('en').select(Number(number));\n  const color = options[rule];\n  return colorize(number.toString(), color);\n};\n\nexport const colorizeObject = (\n  obj: any,\n  indentLevel = 0,\n  indentSize = 2,\n  key?: string\n): string => {\n  const indent = ' '.repeat(indentLevel * indentSize);\n  const nextIndent = ' '.repeat((indentLevel + 1) * indentSize);\n\n  if (obj === null) {\n    return colorize('null', BLUE);\n  }\n\n  if (typeof obj === 'boolean') {\n    return colorize(obj.toString(), BLUE);\n  }\n\n  if (typeof obj === 'number') {\n    return colorize(obj.toString(), BLUE);\n  }\n\n  if (typeof obj === 'string') {\n    const isDateString = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}/.test(obj);\n    const isUrl = obj.startsWith('http://') || obj.startsWith('https://');\n    const isGlob = obj.includes('*') || obj.includes('?') || obj.includes('{');\n    const isPath =\n      obj.startsWith('/') ||\n      obj.startsWith('./') ||\n      obj.startsWith('../') ||\n      /\\.[a-zA-Z0-9]{2,5}$/.test(obj);\n    const isSecret =\n      /^[0-9a-fA-F]{24,}$/.test(obj) || (obj.length >= 40 && !/\\s/.test(obj));\n    const hasSpaces = /\\s/.test(obj);\n\n    if (isDateString) return colorize(`\"${obj}\"`, BEIGE);\n    if (isUrl) return colorize(`\"${obj}\"`, GREY_DARK);\n    if (isGlob) return colorize(`\"${obj}\"`, GREY);\n    if (isPath) return colorize(`\"${obj}\"`, GREY_DARK);\n    if (isSecret) return colorize(`\"${obj}\"`, GREY);\n    if (hasSpaces) return colorize(`\"${obj}\"`, WHITE);\n    return colorize(`\"${obj}\"`, BLUE);\n  }\n\n  if (Array.isArray(obj)) {\n    if (obj.length === 0) {\n      return '[]';\n    }\n    const items = obj\n      .map(\n        (item) =>\n          `${nextIndent}${colorizeObject(item, indentLevel + 1, indentSize, key)}`\n      )\n      .join(',\\n');\n    return `[\\n${items}\\n${indent}]`;\n  }\n\n  if (typeof obj === 'object') {\n    const keys = Object.keys(obj);\n\n    if (keys.length === 0) {\n      return '{}';\n    }\n\n    const fields = keys\n      .map((key) => {\n        const coloredKey = colorize(`\"${key}\"`, GREY_LIGHT);\n        const value = obj[key];\n        const coloredValue = colorizeObject(\n          value,\n          indentLevel + 1,\n          indentSize,\n          key\n        );\n        return `${nextIndent}${coloredKey}: ${coloredValue}`;\n      })\n      .join(',\\n');\n    return `{\\n${fields}\\n${indent}}`;\n  }\n\n  return colorize(String(obj), GREY);\n};\n\nexport const removeColor = (text: string) =>\n  // biome-ignore lint/suspicious/noControlCharactersInRegex: we need to remove the color codes\n  text.replace(/\\x1b\\[[0-9;]*m/g, '');\n\nconst getLength = (length: number | number[] | string | string[]): number => {\n  let value: number = 0;\n  if (typeof length === 'number') {\n    value = length;\n  }\n  if (typeof length === 'string') {\n    value = length.length;\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'string')\n  ) {\n    value = Math.max(...length.map((str) => str.length));\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'number')\n  ) {\n    value = Math.max(...length);\n  }\n  return Math.max(value, 0);\n};\n\nconst defaultColonOptions = {\n  colSize: 0,\n  minSize: 0,\n  maxSize: Infinity,\n  pad: 'right',\n  padChar: '0',\n};\n\n/**\n * Create a string of spaces of a given length.\n *\n * @param colSize - The length of the string to create.\n * @returns A string of spaces.\n */\nexport const colon = (\n  text: string | string[],\n  options?: {\n    colSize?: number | number[] | string | string[];\n    minSize?: number;\n    maxSize?: number;\n    pad?: 'left' | 'right';\n    padChar?: string;\n  }\n): string =>\n  [text]\n    .flat()\n    .map((text) => {\n      const { colSize, minSize, maxSize, pad } = {\n        ...defaultColonOptions,\n        ...(options ?? {}),\n      };\n\n      const length = getLength(colSize);\n      const spacesLength = Math.max(\n        minSize!,\n        Math.min(maxSize!, length - removeColor(text).length)\n      );\n\n      if (pad === 'left') {\n        return `${' '.repeat(spacesLength)}${text}`;\n      }\n\n      return `${text}${' '.repeat(spacesLength)}`;\n    })\n    .join('');\n\nexport const x = colorize('✗', RED);\nexport const v = colorize('✓', GREEN);\nexport const clock = colorize('⏲', BLUE);\n"],"mappings":"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"}
+{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/logger.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n} from '@intlayer/types/config';\nimport type * as ANSIColorsTypes from './colors';\nimport {\n  BEIGE,\n  BLUE,\n  GREEN,\n  GREY,\n  GREY_DARK,\n  GREY_LIGHT,\n  RED,\n  RESET,\n  WHITE,\n} from './colors';\n\nexport type ANSIColorsType =\n  (typeof ANSIColorsTypes)[keyof typeof ANSIColorsTypes];\n\nexport type Details = {\n  isVerbose?: boolean;\n  level?: 'info' | 'warn' | 'error' | 'debug';\n  config?: CustomIntlayerConfig['log'];\n};\n\nexport type Logger = (content: any, details?: Details) => void;\n\nlet loggerPrefix: string | undefined;\n\nexport const setPrefix = (prefix: string | undefined) => {\n  loggerPrefix = prefix;\n};\n\nexport const getPrefix = (configPrefix?: string): string | undefined => {\n  if (typeof loggerPrefix !== 'undefined') {\n    return loggerPrefix;\n  }\n\n  return configPrefix;\n};\n\nexport const logger: Logger = (content, details) => {\n  const config = details?.config ?? {};\n  const mode = config.mode ?? 'default';\n\n  if (mode === 'disabled' || (details?.isVerbose && mode !== 'verbose')) return;\n\n  const prefix = getPrefix(config.prefix);\n  const flatContent = prefix ? [prefix, ...[content].flat()] : [content].flat();\n  const level = details?.level ?? 'info';\n\n  const logMethod =\n    config[level] ?? console[level] ?? config.log ?? console.log;\n\n  logMethod(...flatContent);\n};\n\nexport const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\n\n/**\n * The appLogger function takes the logger and merges it with the configuration from the intlayer config file.\n * It allows overriding the default configuration by passing a config object in the details parameter.\n * The configuration is merged with the default configuration from the intlayer config file.\n */\nexport const getAppLogger =\n  (configuration?: Pick<IntlayerConfig, 'log'>, globalDetails?: Details) =>\n  (content: any, details?: Details) =>\n    logger(content, {\n      ...(details ?? {}),\n      config: {\n        ...configuration?.log,\n        ...globalDetails?.config,\n        ...(details?.config ?? {}),\n      },\n    });\n\nexport const colorize = (\n  string: string,\n  color?: ANSIColorsType,\n  reset?: boolean | ANSIColorsType\n): string =>\n  color && typeof window === 'undefined'\n    ? `${color}${string}${reset ? (typeof reset === 'boolean' ? RESET : reset) : RESET}`\n    : string;\n\nexport const colorizeLocales = (\n  locales: Locale | Locale[],\n  color: ANSIColorsType = GREEN,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [locales]\n    .flat()\n    .map((locale) => colorize(locale, color, reset))\n    .join(`, `);\n\nexport const colorizeKey = (\n  keyPath: string | string[],\n  color: ANSIColorsType = BEIGE,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [keyPath]\n    .flat()\n    .map((key) => colorize(key, color, reset))\n    .join(`, `);\n\nexport const colorizePath = (\n  path: string | string[],\n  color: ANSIColorsType = GREY,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [path]\n    .flat()\n    .map((path) => colorize(path, color, reset))\n    .join(`, `);\n\nexport const colorizeNumber = (\n  number: number | string,\n  options: Partial<Record<Intl.LDMLPluralRule, ANSIColorsType>> = {\n    zero: BLUE,\n    one: BLUE,\n    two: BLUE,\n    few: BLUE,\n    many: BLUE,\n    other: BLUE,\n  }\n): string => {\n  if (number === 0 || number === '0') {\n    const color = options.zero ?? GREEN;\n    return colorize(number.toString(), color);\n  }\n\n  // Kept inside the function. Top-level instantiation of classes/APIs\n  // is treated as a side-effect and prevents tree-shaking if the function is unused.\n  const rule = new Intl.PluralRules('en').select(Number(number));\n  const color = options[rule];\n  return colorize(number.toString(), color);\n};\n\nexport const colorizeObject = (\n  obj: any,\n  indentLevel = 0,\n  indentSize = 2,\n  key?: string\n): string => {\n  const indent = ' '.repeat(indentLevel * indentSize);\n  const nextIndent = ' '.repeat((indentLevel + 1) * indentSize);\n\n  if (obj === null) {\n    return colorize('null', BLUE);\n  }\n\n  if (typeof obj === 'boolean') {\n    return colorize(obj.toString(), BLUE);\n  }\n\n  if (typeof obj === 'number') {\n    return colorize(obj.toString(), BLUE);\n  }\n\n  if (typeof obj === 'string') {\n    const isDateString = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}/.test(obj);\n    const isUrl = obj.startsWith('http://') || obj.startsWith('https://');\n    const isGlob = obj.includes('*') || obj.includes('?') || obj.includes('{');\n    const isPath =\n      obj.startsWith('/') ||\n      obj.startsWith('./') ||\n      obj.startsWith('../') ||\n      /\\.[a-zA-Z0-9]{2,5}$/.test(obj);\n    const isSecret =\n      /^[0-9a-fA-F]{24,}$/.test(obj) || (obj.length >= 40 && !/\\s/.test(obj));\n    const hasSpaces = /\\s/.test(obj);\n\n    if (isDateString) return colorize(`\"${obj}\"`, BEIGE);\n    if (isUrl) return colorize(`\"${obj}\"`, GREY_DARK);\n    if (isGlob) return colorize(`\"${obj}\"`, GREY);\n    if (isPath) return colorize(`\"${obj}\"`, GREY_DARK);\n    if (isSecret) return colorize(`\"${obj}\"`, GREY);\n    if (hasSpaces) return colorize(`\"${obj}\"`, WHITE);\n    return colorize(`\"${obj}\"`, BLUE);\n  }\n\n  if (Array.isArray(obj)) {\n    if (obj.length === 0) {\n      return '[]';\n    }\n    const items = obj\n      .map(\n        (item) =>\n          `${nextIndent}${colorizeObject(item, indentLevel + 1, indentSize, key)}`\n      )\n      .join(',\\n');\n    return `[\\n${items}\\n${indent}]`;\n  }\n\n  if (typeof obj === 'object') {\n    const keys = Object.keys(obj);\n\n    if (keys.length === 0) {\n      return '{}';\n    }\n\n    const fields = keys\n      .map((key) => {\n        const coloredKey = colorize(`\"${key}\"`, GREY_LIGHT);\n        const value = obj[key];\n        const coloredValue = colorizeObject(\n          value,\n          indentLevel + 1,\n          indentSize,\n          key\n        );\n        return `${nextIndent}${coloredKey}: ${coloredValue}`;\n      })\n      .join(',\\n');\n    return `{\\n${fields}\\n${indent}}`;\n  }\n\n  return colorize(String(obj), GREY);\n};\n\nexport const removeColor = (text: string) =>\n  // oxlint-disable-next-line no-control-regex -- we need to remove the color codes\n  text.replace(/\\x1b\\[[0-9;]*m/g, '');\n\nconst getLength = (length: number | number[] | string | string[]): number => {\n  let value: number = 0;\n  if (typeof length === 'number') {\n    value = length;\n  }\n  if (typeof length === 'string') {\n    value = length.length;\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'string')\n  ) {\n    value = Math.max(...length.map((str) => str.length));\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'number')\n  ) {\n    value = Math.max(...length);\n  }\n  return Math.max(value, 0);\n};\n\nconst defaultColonOptions = {\n  colSize: 0,\n  minSize: 0,\n  maxSize: Infinity,\n  pad: 'right',\n  padChar: '0',\n};\n\n/**\n * Create a string of spaces of a given length.\n *\n * @param colSize - The length of the string to create.\n * @returns A string of spaces.\n */\nexport const colon = (\n  text: string | string[],\n  options?: {\n    colSize?: number | number[] | string | string[];\n    minSize?: number;\n    maxSize?: number;\n    pad?: 'left' | 'right';\n    padChar?: string;\n  }\n): string =>\n  [text]\n    .flat()\n    .map((text) => {\n      const { colSize, minSize, maxSize, pad } = {\n        ...defaultColonOptions,\n        ...(options ?? {}),\n      };\n\n      const length = getLength(colSize);\n      const spacesLength = Math.max(\n        minSize!,\n        Math.min(maxSize!, length - removeColor(text).length)\n      );\n\n      if (pad === 'left') {\n        return `${' '.repeat(spacesLength)}${text}`;\n      }\n\n      return `${text}${' '.repeat(spacesLength)}`;\n    })\n    .join('');\n\nexport const x = colorize('✗', RED);\nexport const v = colorize('✓', GREEN);\nexport const clock = colorize('⏲', BLUE);\n"],"mappings":"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"}

package/dist/esm/node.mjs

@@ -1,8 +1,8 @@
 import { buildAnalyticsFields, buildBrowserConfiguration, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, extractBrowserConfiguration } from "./configFile/buildBrowserConfiguration.mjs";
-import { aiSchema, analyticsSchema, buildSchema, compilerSchema, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, storageAttributesSchema, storageSchema, systemSchema } from "./configFile/configurationSchema.mjs";
 import { buildConfigurationFields } from "./configFile/buildConfigurationFields.mjs";
+import { aiSchema, analyticsSchema, buildSchema, compilerSchema, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, storageAttributesSchema, storageSchema, systemSchema } from "./configFile/configurationSchema.mjs";
 import { EDITOR_SERVER_PORT_ENV_VAR, applyEditorServerOverride, getEditorURLForPort } from "./configFile/editorServerOverride.mjs";
-import { configurationFilesCandidates, searchConfigurationFile } from "./configFile/searchConfigurationFile.mjs";
 import { getConfiguration, getConfigurationAndFilePath } from "./configFile/getConfiguration.mjs";
+import { configurationFilesCandidates, searchConfigurationFile } from "./configFile/searchConfigurationFile.mjs";
 
 export { EDITOR_SERVER_PORT_ENV_VAR, aiSchema, analyticsSchema, applyEditorServerOverride, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, getEditorURLForPort, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };

package/dist/esm/secrets.browser.mjs

@@ -1,4 +1,4 @@
-//#region src/secrets.browser.ts
+// src/secrets.browser.ts
 /**
 * Browser stub for {@link file://./secrets.ts}.
 *
@@ -15,6 +15,5 @@
 */
 const getEditorClientSecret = () => void 0;
 
-//#endregion
 export { getEditorClientSecret };
 //# sourceMappingURL=secrets.browser.mjs.map

package/dist/esm/secrets.mjs

@@ -1,4 +1,4 @@
-//#region src/secrets.ts
+// src/secrets.ts
 /**
 * Server-only access to the sensitive parts of the Intlayer configuration.
 *
@@ -41,6 +41,5 @@
 */
 const getEditorClientSecret = () => typeof process === "undefined" ? void 0 : process.env?.INTLAYER_CLIENT_SECRET;
 
-//#endregion
 export { getEditorClientSecret };
 //# sourceMappingURL=secrets.mjs.map

package/dist/esm/utils/ESMxCJSHelpers.mjs

@@ -2,7 +2,7 @@ import { __require } from "../_virtual/_rolldown/runtime.mjs";
 import { getPackageJsonPath } from "./getPackageJsonPath.mjs";
 import { createRequire } from "node:module";
 
-//#region src/utils/ESMxCJSHelpers.ts
+// src/utils/ESMxCJSHelpers.ts
 const isESModule = typeof import.meta.url === "string";
 /**
 * Require relative to the user project
@@ -20,6 +20,5 @@ const getProjectRequire = (startDir) => {
 */
 const configESMxCJSRequire = isESModule ? createRequire(import.meta.url) : __require;
 
-//#endregion
 export { configESMxCJSRequire, getProjectRequire, isESModule };
 //# sourceMappingURL=ESMxCJSHelpers.mjs.map

package/dist/esm/utils/alias.mjs

@@ -1,8 +1,8 @@
-import { normalizePath } from "./normalizePath.mjs";
 import { getExtension } from "./getExtension.mjs";
+import { normalizePath } from "./normalizePath.mjs";
 import { join, relative } from "node:path";
 
-//#region src/utils/alias.ts
+// src/utils/alias.ts
 /**
 * Generated entry files of `.intlayer/main`, keyed by the
 * `@intlayer/dictionaries-entry` subpath that resolves to them.
@@ -34,6 +34,5 @@ const getAlias = ({ configuration, format, formatter = (value) => value }) => {
 	};
 };
 
-//#endregion
 export { getAlias };
 //# sourceMappingURL=alias.mjs.map

package/dist/esm/utils/alias.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"alias.mjs","names":[],"sources":["../../../src/utils/alias.ts"],"sourcesContent":["import { join, relative } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { getExtension } from './getExtension';\nimport { normalizePath } from './normalizePath';\n\nexport type GetAliasOptions = {\n  configuration: IntlayerConfig;\n  format?: 'esm' | 'cjs';\n  formatter?: (value: string) => string;\n};\n\n/**\n * Generated entry files of `.intlayer/main`, keyed by the\n * `@intlayer/dictionaries-entry` subpath that resolves to them.\n */\nconst DICTIONARIES_ENTRY_SUBPATH_FILES = {\n  unmerged: 'unmerged_dictionaries',\n  remote: 'remote_dictionaries',\n  dynamic: 'dynamic_dictionaries',\n  fetch: 'fetch_dictionaries',\n} as const;\n\ntype DictionariesEntrySubpath = keyof typeof DICTIONARIES_ENTRY_SUBPATH_FILES;\n\ntype DictionariesEntrySubpathAlias = {\n  [Subpath in DictionariesEntrySubpath as `@intlayer/dictionaries-entry/${Subpath}`]: string;\n};\n\n/**\n * Maps the aliasable Intlayer packages to the generated `.intlayer` files so\n * bundlers (webpack, Vite, Turbopack, esbuild, Metro, …) resolve them to the\n * app's own dictionaries and hot reload on any content change.\n *\n * Key order matters: webpack (enhanced-resolve) and Vite match string aliases\n * by prefix and stop at the first hit, so the bare `@intlayer/dictionaries-entry`\n * key MUST come after its subpaths, otherwise `@intlayer/dictionaries-entry/remote`\n * would be rewritten to `<dictionaries entry>/remote`.\n */\nexport const getAlias = ({\n  configuration,\n  format,\n  formatter = (value: string) => value,\n}: GetAliasOptions) => {\n  const extension = getExtension(\n    configuration,\n    format ?? configuration.build.outputFormat[0] ?? 'esm'\n  );\n\n  const { baseDir, mainDir, configDir } = configuration.system;\n\n  const toAliasPath = (absolutePath: string) =>\n    formatter(normalizePath(relative(baseDir, absolutePath)));\n\n  const subpathAlias = Object.fromEntries(\n    Object.entries(DICTIONARIES_ENTRY_SUBPATH_FILES).map(\n      ([subpath, fileName]) => [\n        `@intlayer/dictionaries-entry/${subpath}`,\n        toAliasPath(join(mainDir, `${fileName}.${extension}`)),\n      ]\n    )\n  ) as DictionariesEntrySubpathAlias;\n\n  return {\n    ...subpathAlias,\n    '@intlayer/dictionaries-entry': toAliasPath(\n      join(mainDir, `dictionaries.${extension}`)\n    ),\n    '@intlayer/config/built': toAliasPath(\n      join(configDir, `configuration.${extension}`)\n    ),\n  };\n};\n"],"mappings":";;;;;;;;;AAeA,MAAM,mCAAmC;CACvC,UAAU;CACV,QAAQ;CACR,SAAS;CACT,OAAO;AACT;;;;;;;;;;;AAkBA,MAAa,YAAY,EACvB,eACA,QACA,aAAa,UAAkB,YACV;CACrB,MAAM,YAAY,aAChB,eACA,UAAU,cAAc,MAAM,aAAa,MAAM,KACnD;CAEA,MAAM,EAAE,SAAS,SAAS,cAAc,cAAc;CAEtD,MAAM,eAAe,iBACnB,UAAU,cAAc,SAAS,SAAS,YAAY,CAAC,CAAC;CAW1D,OAAO;EACL,GAVmB,OAAO,YAC1B,OAAO,QAAQ,gCAAgC,CAAC,CAAC,KAC9C,CAAC,SAAS,cAAc,CACvB,gCAAgC,WAChC,YAAY,KAAK,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,CACvD,CACF,CAIc;EACd,gCAAgC,YAC9B,KAAK,SAAS,gBAAgB,WAAW,CAC3C;EACA,0BAA0B,YACxB,KAAK,WAAW,iBAAiB,WAAW,CAC9C;CACF;AACF"}
+{"version":3,"file":"alias.mjs","names":[],"sources":["../../../src/utils/alias.ts"],"sourcesContent":["import { join, relative } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { getExtension } from './getExtension';\nimport { normalizePath } from './normalizePath';\n\nexport type GetAliasOptions = {\n  configuration: IntlayerConfig;\n  format?: 'esm' | 'cjs';\n  formatter?: (value: string) => string;\n};\n\n/**\n * Generated entry files of `.intlayer/main`, keyed by the\n * `@intlayer/dictionaries-entry` subpath that resolves to them.\n */\nconst DICTIONARIES_ENTRY_SUBPATH_FILES = {\n  unmerged: 'unmerged_dictionaries',\n  remote: 'remote_dictionaries',\n  dynamic: 'dynamic_dictionaries',\n  fetch: 'fetch_dictionaries',\n} as const;\n\ntype DictionariesEntrySubpath = keyof typeof DICTIONARIES_ENTRY_SUBPATH_FILES;\n\ntype DictionariesEntrySubpathAlias = {\n  [\n    Subpath in DictionariesEntrySubpath as `@intlayer/dictionaries-entry/${Subpath}`\n  ]: string;\n};\n\n/**\n * Maps the aliasable Intlayer packages to the generated `.intlayer` files so\n * bundlers (webpack, Vite, Turbopack, esbuild, Metro, …) resolve them to the\n * app's own dictionaries and hot reload on any content change.\n *\n * Key order matters: webpack (enhanced-resolve) and Vite match string aliases\n * by prefix and stop at the first hit, so the bare `@intlayer/dictionaries-entry`\n * key MUST come after its subpaths, otherwise `@intlayer/dictionaries-entry/remote`\n * would be rewritten to `<dictionaries entry>/remote`.\n */\nexport const getAlias = ({\n  configuration,\n  format,\n  formatter = (value: string) => value,\n}: GetAliasOptions) => {\n  const extension = getExtension(\n    configuration,\n    format ?? configuration.build.outputFormat[0] ?? 'esm'\n  );\n\n  const { baseDir, mainDir, configDir } = configuration.system;\n\n  const toAliasPath = (absolutePath: string) =>\n    formatter(normalizePath(relative(baseDir, absolutePath)));\n\n  const subpathAlias = Object.fromEntries(\n    Object.entries(DICTIONARIES_ENTRY_SUBPATH_FILES).map(\n      ([subpath, fileName]) => [\n        `@intlayer/dictionaries-entry/${subpath}`,\n        toAliasPath(join(mainDir, `${fileName}.${extension}`)),\n      ]\n    )\n  ) as DictionariesEntrySubpathAlias;\n\n  return {\n    ...subpathAlias,\n    '@intlayer/dictionaries-entry': toAliasPath(\n      join(mainDir, `dictionaries.${extension}`)\n    ),\n    '@intlayer/config/built': toAliasPath(\n      join(configDir, `configuration.${extension}`)\n    ),\n  };\n};\n"],"mappings":";;;;;;;;;AAeA,MAAM,mCAAmC;CACvC,UAAU;CACV,QAAQ;CACR,SAAS;CACT,OAAO;AACT;;;;;;;;;;;AAoBA,MAAa,YAAY,EACvB,eACA,QACA,aAAa,UAAkB,YACV;CACrB,MAAM,YAAY,aAChB,eACA,UAAU,cAAc,MAAM,aAAa,MAAM,KACnD;CAEA,MAAM,EAAE,SAAS,SAAS,cAAc,cAAc;CAEtD,MAAM,eAAe,iBACnB,UAAU,cAAc,SAAS,SAAS,YAAY,CAAC,CAAC;CAW1D,OAAO;EACL,GAVmB,OAAO,YAC1B,OAAO,QAAQ,gCAAgC,CAAC,CAAC,KAC9C,CAAC,SAAS,cAAc,CACvB,gCAAgC,WAChC,YAAY,KAAK,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,CACvD,CACF,CAIc;EACd,gCAAgC,YAC9B,KAAK,SAAS,gBAAgB,WAAW,CAC3C;EACA,0BAA0B,YACxB,KAAK,WAAW,iBAAiB,WAAW,CAC9C;CACF;AACF"}

package/dist/esm/utils/builtConfigKeys.mjs

@@ -1,4 +1,4 @@
-//#region src/utils/builtConfigKeys.ts
+// src/utils/builtConfigKeys.ts
 /**
 * Canonical list of configuration sections exposed as named exports by
 * `@intlayer/config/built`.
@@ -31,6 +31,5 @@ const BUILT_CONFIG_KEYS = [
 	"plugins"
 ];
 
-//#endregion
 export { BUILT_CONFIG_KEYS };
 //# sourceMappingURL=builtConfigKeys.mjs.map

package/dist/esm/utils/cacheDisk.mjs

@@ -5,7 +5,7 @@ import { deserialize, serialize } from "node:v8";
 import { gunzipSync, gzipSync } from "node:zlib";
 import configPackageJson from "@intlayer/types/package.json" with { type: "json" };
 
-//#region src/utils/cacheDisk.ts
+// src/utils/cacheDisk.ts
 const DEFAULTS = { compress: true };
 const ensureDir = async (dir) => {
 	await mkdir(dir, { recursive: true });
@@ -180,6 +180,5 @@ const cacheDisk = (intlayerConfig, keys, options) => {
 	};
 };
 
-//#endregion
 export { cacheDisk, clearDiskCacheMemory };
 //# sourceMappingURL=cacheDisk.mjs.map

package/dist/esm/utils/cacheDisk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cacheDisk.mjs","names":[],"sources":["../../../src/utils/cacheDisk.ts"],"sourcesContent":["import {\n  mkdir,\n  readFile,\n  rename,\n  rm,\n  stat,\n  unlink,\n  writeFile,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { deserialize, serialize } from 'node:v8';\nimport { gunzipSync, gzipSync } from 'node:zlib';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport configPackageJson from '@intlayer/types/package.json' with {\n  type: 'json',\n};\nimport { type CacheKey, clearAllCache, computeKeyId } from './cacheMemory';\n\n/** ------------------------- Persistence layer ------------------------- **/\n\n/** Cache envelope structure stored on disk */\ntype CacheEnvelope = {\n  /** Version of the config package (for cache invalidation) */\n  version: string;\n  /** Timestamp when the cache entry was created (in milliseconds) */\n  timestamp: number;\n  /** Data payload (the actual cached value) */\n  data: unknown;\n};\n\ntype LocalCacheOptions = {\n  /** Preferred new option name */\n  persistent?: boolean;\n  /** Time-to-live in ms; if expired, disk entry is ignored. */\n  ttlMs?: number;\n  /** Max age in ms based on stored creation timestamp; invalidates on exceed. */\n  maxTimeMs?: number;\n  /** Optional namespace to separate different logical caches. */\n  namespace?: string;\n  /** Gzip values on disk (on by default for blobs > 1KB). */\n  compress?: boolean;\n};\n\nconst DEFAULTS: Required<Pick<LocalCacheOptions, 'compress'>> = {\n  compress: true,\n};\n\nconst ensureDir = async (dir: string) => {\n  await mkdir(dir, { recursive: true });\n};\n\nconst atomicWriteFile = async (\n  file: string,\n  data: Buffer,\n  tempDir?: string\n) => {\n  if (tempDir) {\n    try {\n      await ensureDir(tempDir);\n    } catch {}\n  }\n\n  const tempFileName = `${basename(file)}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  const tmp = tempDir\n    ? join(tempDir, tempFileName)\n    : `${file}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  try {\n    await writeFile(tmp, data);\n    await rename(tmp, file);\n  } catch (error) {\n    try {\n      await rm(tmp, { force: true });\n    } catch {\n      // Ignore\n    }\n    throw error;\n  }\n};\n\nconst shouldUseCompression = (buf: Buffer, force?: boolean) =>\n  force === true || (force !== false && buf.byteLength > 1024);\n\n/** Derive on-disk path from config dir + namespace + key id. */\nconst cachePath = (cacheDir: string, id: string, ns?: string) =>\n  join(cacheDir, ns ? join(ns, id) : id);\n\n/** ------------------------- Local cache facade ------------------------- **/\n\nconst cacheMap = new Map<string, any>();\n\n/** Clears the in-memory portion of the disk cache without touching disk files. */\nexport const clearDiskCacheMemory = (): void => {\n  cacheMap.clear();\n};\n\nexport const cacheDisk = (\n  intlayerConfig: IntlayerConfig,\n  keys: CacheKey[],\n  options?: LocalCacheOptions\n) => {\n  const { cacheDir, tempDir } = intlayerConfig.system;\n  const buildCacheEnabled = intlayerConfig.build.cache ?? true;\n  const persistent =\n    options?.persistent === true ||\n    (typeof options?.persistent === 'undefined' && buildCacheEnabled);\n\n  const { compress, ttlMs, maxTimeMs, namespace } = {\n    ...DEFAULTS,\n    ...options,\n  };\n\n  // single stable id for this key tuple (works for both memory & disk)\n  const id = computeKeyId(keys);\n  const filePath = cachePath(cacheDir, id, namespace);\n\n  const readFromDisk = async (): Promise<unknown | undefined> => {\n    try {\n      const statValue = await stat(filePath).catch(() => undefined);\n\n      if (!statValue) return undefined;\n\n      if (typeof ttlMs === 'number' && ttlMs > 0) {\n        const age = Date.now() - statValue.mtimeMs;\n        if (age > ttlMs) return undefined;\n      }\n      let raw = await readFile(filePath);\n      // header: 1 byte flag (0x00 raw, 0x01 gzip)\n      const flag = raw[0];\n\n      raw = raw.subarray(1);\n\n      const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n      const deserialized = deserialize(payload) as unknown;\n\n      let value: unknown;\n      const maybeObj = deserialized as Record<string, unknown> | null;\n      const isEnvelope =\n        !!maybeObj &&\n        typeof maybeObj === 'object' &&\n        typeof (maybeObj as any).version === 'string' &&\n        typeof (maybeObj as any).timestamp === 'number' &&\n        Object.hasOwn(maybeObj, 'data');\n\n      if (isEnvelope) {\n        const entry = maybeObj as CacheEnvelope;\n\n        if (entry.version !== configPackageJson.version) {\n          try {\n            await unlink(filePath);\n          } catch {}\n          return undefined;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - entry.timestamp;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n\n        value = entry.data;\n      } else {\n        // Backward compatibility: old entries had raw serialized value.\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n        value = deserialized;\n      }\n\n      // hydrate memory cache as well\n      cacheMap.set(id, value);\n      return value;\n    } catch {\n      return undefined;\n    }\n  };\n\n  const writeToDisk = async (value: unknown) => {\n    try {\n      await ensureDir(dirname(filePath));\n      const envelope: CacheEnvelope = {\n        version: configPackageJson.version,\n        timestamp: Date.now(),\n        data: value,\n      };\n      const payload = Buffer.from(serialize(envelope));\n\n      const gz = shouldUseCompression(payload, compress)\n        ? gzipSync(payload)\n        : payload;\n\n      // prepend a 1-byte header indicating compression\n      const buf = Buffer.concat([\n        Buffer.from([gz === payload ? 0x00 : 0x01]),\n        gz,\n      ]);\n\n      await atomicWriteFile(filePath, buf, tempDir);\n    } catch {\n      // swallow disk errors for cache writes\n    }\n  };\n\n  return {\n    /** In-memory first, then disk (if enabled), otherwise undefined. */\n    get: async <T>(): Promise<T | undefined> => {\n      const mem = cacheMap.get(id);\n\n      if (mem !== undefined) return mem as T;\n\n      if (persistent && buildCacheEnabled) {\n        return (await readFromDisk()) as T | undefined;\n      }\n      return undefined;\n    },\n    /** Sets in-memory (always) and persists to disk if enabled. */\n    set: async (value: unknown): Promise<void> => {\n      cacheMap.set(id, value);\n\n      if (persistent && buildCacheEnabled) {\n        await writeToDisk(value);\n      }\n    },\n    /** Clears only this entry from memory and disk. */\n    clear: async (): Promise<void> => {\n      cacheMap.delete(id);\n\n      try {\n        await unlink(filePath);\n      } catch {}\n    },\n    /** Clears ALL cached entries (memory Map and entire cacheDir namespace if persistent). */\n    clearAll: async (): Promise<void> => {\n      clearAllCache();\n      if (persistent && buildCacheEnabled) {\n        // remove only the current namespace (if provided), else the root dir\n        const base = namespace ? join(cacheDir, namespace) : cacheDir;\n\n        try {\n          await rm(base, { recursive: true, force: true });\n        } catch {}\n\n        try {\n          await mkdir(base, { recursive: true });\n        } catch {}\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    isValid: async (): Promise<boolean> => {\n      const cachedValue = cacheMap.get(id);\n      if (cachedValue !== undefined) return true;\n\n      // If persistence is disabled or build cache disabled, only memory can be valid\n      if (!persistent || !buildCacheEnabled) return false;\n\n      try {\n        const statValue = await stat(filePath).catch(() => undefined);\n        if (!statValue) return false;\n\n        if (typeof ttlMs === 'number' && ttlMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > ttlMs) return false;\n        }\n\n        let raw = await readFile(filePath);\n        const flag = raw[0];\n        raw = raw.subarray(1);\n        const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n        const deserialized = deserialize(payload) as unknown;\n\n        const maybeObj = deserialized as Record<string, unknown> | null;\n        const isEnvelope =\n          !!maybeObj &&\n          typeof maybeObj === 'object' &&\n          typeof maybeObj.version === 'string' &&\n          typeof maybeObj.timestamp === 'number' &&\n          Object.hasOwn(maybeObj, 'data');\n\n        if (isEnvelope) {\n          const entry = maybeObj as CacheEnvelope;\n          if (entry.version !== configPackageJson.version) return false;\n\n          if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n            const age = Date.now() - entry.timestamp;\n            if (age > maxTimeMs) return false;\n          }\n          return true;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) return false;\n        }\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    id,\n    /** Expose the absolute file path for debugging. */\n    filePath,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"cacheDisk.mjs","names":[],"sources":["../../../src/utils/cacheDisk.ts"],"sourcesContent":["import {\n  mkdir,\n  readFile,\n  rename,\n  rm,\n  stat,\n  unlink,\n  writeFile,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { deserialize, serialize } from 'node:v8';\nimport { gunzipSync, gzipSync } from 'node:zlib';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport configPackageJson from '@intlayer/types/package.json' with { type: 'json' };\nimport { type CacheKey, clearAllCache, computeKeyId } from './cacheMemory';\n\n/** ------------------------- Persistence layer ------------------------- **/\n\n/** Cache envelope structure stored on disk */\ntype CacheEnvelope = {\n  /** Version of the config package (for cache invalidation) */\n  version: string;\n  /** Timestamp when the cache entry was created (in milliseconds) */\n  timestamp: number;\n  /** Data payload (the actual cached value) */\n  data: unknown;\n};\n\ntype LocalCacheOptions = {\n  /** Preferred new option name */\n  persistent?: boolean;\n  /** Time-to-live in ms; if expired, disk entry is ignored. */\n  ttlMs?: number;\n  /** Max age in ms based on stored creation timestamp; invalidates on exceed. */\n  maxTimeMs?: number;\n  /** Optional namespace to separate different logical caches. */\n  namespace?: string;\n  /** Gzip values on disk (on by default for blobs > 1KB). */\n  compress?: boolean;\n};\n\nconst DEFAULTS: Required<Pick<LocalCacheOptions, 'compress'>> = {\n  compress: true,\n};\n\nconst ensureDir = async (dir: string) => {\n  await mkdir(dir, { recursive: true });\n};\n\nconst atomicWriteFile = async (\n  file: string,\n  data: Buffer,\n  tempDir?: string\n) => {\n  if (tempDir) {\n    try {\n      await ensureDir(tempDir);\n    } catch {}\n  }\n\n  const tempFileName = `${basename(file)}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  const tmp = tempDir\n    ? join(tempDir, tempFileName)\n    : `${file}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  try {\n    await writeFile(tmp, data);\n    await rename(tmp, file);\n  } catch (error) {\n    try {\n      await rm(tmp, { force: true });\n    } catch {\n      // Ignore\n    }\n    throw error;\n  }\n};\n\nconst shouldUseCompression = (buf: Buffer, force?: boolean) =>\n  force === true || (force !== false && buf.byteLength > 1024);\n\n/** Derive on-disk path from config dir + namespace + key id. */\nconst cachePath = (cacheDir: string, id: string, ns?: string) =>\n  join(cacheDir, ns ? join(ns, id) : id);\n\n/** ------------------------- Local cache facade ------------------------- **/\n\nconst cacheMap = new Map<string, any>();\n\n/** Clears the in-memory portion of the disk cache without touching disk files. */\nexport const clearDiskCacheMemory = (): void => {\n  cacheMap.clear();\n};\n\nexport const cacheDisk = (\n  intlayerConfig: IntlayerConfig,\n  keys: CacheKey[],\n  options?: LocalCacheOptions\n) => {\n  const { cacheDir, tempDir } = intlayerConfig.system;\n  const buildCacheEnabled = intlayerConfig.build.cache ?? true;\n  const persistent =\n    options?.persistent === true ||\n    (typeof options?.persistent === 'undefined' && buildCacheEnabled);\n\n  const { compress, ttlMs, maxTimeMs, namespace } = {\n    ...DEFAULTS,\n    ...options,\n  };\n\n  // single stable id for this key tuple (works for both memory & disk)\n  const id = computeKeyId(keys);\n  const filePath = cachePath(cacheDir, id, namespace);\n\n  const readFromDisk = async (): Promise<unknown | undefined> => {\n    try {\n      const statValue = await stat(filePath).catch(() => undefined);\n\n      if (!statValue) return undefined;\n\n      if (typeof ttlMs === 'number' && ttlMs > 0) {\n        const age = Date.now() - statValue.mtimeMs;\n        if (age > ttlMs) return undefined;\n      }\n      let raw = await readFile(filePath);\n      // header: 1 byte flag (0x00 raw, 0x01 gzip)\n      const flag = raw[0];\n\n      raw = raw.subarray(1);\n\n      const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n      const deserialized = deserialize(payload) as unknown;\n\n      let value: unknown;\n      const maybeObj = deserialized as Record<string, unknown> | null;\n      const isEnvelope =\n        !!maybeObj &&\n        typeof maybeObj === 'object' &&\n        typeof (maybeObj as any).version === 'string' &&\n        typeof (maybeObj as any).timestamp === 'number' &&\n        Object.hasOwn(maybeObj, 'data');\n\n      if (isEnvelope) {\n        const entry = maybeObj as CacheEnvelope;\n\n        if (entry.version !== configPackageJson.version) {\n          try {\n            await unlink(filePath);\n          } catch {}\n          return undefined;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - entry.timestamp;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n\n        value = entry.data;\n      } else {\n        // Backward compatibility: old entries had raw serialized value.\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n        value = deserialized;\n      }\n\n      // hydrate memory cache as well\n      cacheMap.set(id, value);\n      return value;\n    } catch {\n      return undefined;\n    }\n  };\n\n  const writeToDisk = async (value: unknown) => {\n    try {\n      await ensureDir(dirname(filePath));\n      const envelope: CacheEnvelope = {\n        version: configPackageJson.version,\n        timestamp: Date.now(),\n        data: value,\n      };\n      const payload = Buffer.from(serialize(envelope));\n\n      const gz = shouldUseCompression(payload, compress)\n        ? gzipSync(payload)\n        : payload;\n\n      // prepend a 1-byte header indicating compression\n      const buf = Buffer.concat([\n        Buffer.from([gz === payload ? 0x00 : 0x01]),\n        gz,\n      ]);\n\n      await atomicWriteFile(filePath, buf, tempDir);\n    } catch {\n      // swallow disk errors for cache writes\n    }\n  };\n\n  return {\n    /** In-memory first, then disk (if enabled), otherwise undefined. */\n    get: async <T>(): Promise<T | undefined> => {\n      const mem = cacheMap.get(id);\n\n      if (mem !== undefined) return mem as T;\n\n      if (persistent && buildCacheEnabled) {\n        return (await readFromDisk()) as T | undefined;\n      }\n      return undefined;\n    },\n    /** Sets in-memory (always) and persists to disk if enabled. */\n    set: async (value: unknown): Promise<void> => {\n      cacheMap.set(id, value);\n\n      if (persistent && buildCacheEnabled) {\n        await writeToDisk(value);\n      }\n    },\n    /** Clears only this entry from memory and disk. */\n    clear: async (): Promise<void> => {\n      cacheMap.delete(id);\n\n      try {\n        await unlink(filePath);\n      } catch {}\n    },\n    /** Clears ALL cached entries (memory Map and entire cacheDir namespace if persistent). */\n    clearAll: async (): Promise<void> => {\n      clearAllCache();\n      if (persistent && buildCacheEnabled) {\n        // remove only the current namespace (if provided), else the root dir\n        const base = namespace ? join(cacheDir, namespace) : cacheDir;\n\n        try {\n          await rm(base, { recursive: true, force: true });\n        } catch {}\n\n        try {\n          await mkdir(base, { recursive: true });\n        } catch {}\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    isValid: async (): Promise<boolean> => {\n      const cachedValue = cacheMap.get(id);\n      if (cachedValue !== undefined) return true;\n\n      // If persistence is disabled or build cache disabled, only memory can be valid\n      if (!persistent || !buildCacheEnabled) return false;\n\n      try {\n        const statValue = await stat(filePath).catch(() => undefined);\n        if (!statValue) return false;\n\n        if (typeof ttlMs === 'number' && ttlMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > ttlMs) return false;\n        }\n\n        let raw = await readFile(filePath);\n        const flag = raw[0];\n        raw = raw.subarray(1);\n        const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n        const deserialized = deserialize(payload) as unknown;\n\n        const maybeObj = deserialized as Record<string, unknown> | null;\n        const isEnvelope =\n          !!maybeObj &&\n          typeof maybeObj === 'object' &&\n          typeof maybeObj.version === 'string' &&\n          typeof maybeObj.timestamp === 'number' &&\n          Object.hasOwn(maybeObj, 'data');\n\n        if (isEnvelope) {\n          const entry = maybeObj as CacheEnvelope;\n          if (entry.version !== configPackageJson.version) return false;\n\n          if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n            const age = Date.now() - entry.timestamp;\n            if (age > maxTimeMs) return false;\n          }\n          return true;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) return false;\n        }\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    id,\n    /** Expose the absolute file path for debugging. */\n    filePath,\n  };\n};\n"],"mappings":";;;;;;;;AAyCA,MAAM,WAA0D,EAC9D,UAAU,KACZ;AAEA,MAAM,YAAY,OAAO,QAAgB;CACvC,MAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AACtC;AAEA,MAAM,kBAAkB,OACtB,MACA,MACA,YACG;CACH,IAAI,SACF,IAAI;EACF,MAAM,UAAU,OAAO;CACzB,QAAQ,CAAC;CAGX,MAAM,eAAe,GAAG,SAAS,IAAI,EAAE,OAAO,QAAQ,IAAI,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;CAC/F,MAAM,MAAM,UACR,KAAK,SAAS,YAAY,IAC1B,GAAG,KAAK,OAAO,QAAQ,IAAI,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;CACpE,IAAI;EACF,MAAM,UAAU,KAAK,IAAI;EACzB,MAAM,OAAO,KAAK,IAAI;CACxB,SAAS,OAAO;EACd,IAAI;GACF,MAAM,GAAG,KAAK,EAAE,OAAO,KAAK,CAAC;EAC/B,QAAQ,CAER;EACA,MAAM;CACR;AACF;AAEA,MAAM,wBAAwB,KAAa,UACzC,UAAU,QAAS,UAAU,SAAS,IAAI,aAAa;;AAGzD,MAAM,aAAa,UAAkB,IAAY,OAC/C,KAAK,UAAU,KAAK,KAAK,IAAI,EAAE,IAAI,EAAE;;AAIvC,MAAM,2BAAW,IAAI,IAAiB;;AAGtC,MAAa,6BAAmC;CAC9C,SAAS,MAAM;AACjB;AAEA,MAAa,aACX,gBACA,MACA,YACG;CACH,MAAM,EAAE,UAAU,YAAY,eAAe;CAC7C,MAAM,oBAAoB,eAAe,MAAM,SAAS;CACxD,MAAM,aACJ,SAAS,eAAe,QACvB,OAAO,SAAS,eAAe,eAAe;CAEjD,MAAM,EAAE,UAAU,OAAO,WAAW,cAAc;EAChD,GAAG;EACH,GAAG;CACL;CAGA,MAAM,KAAK,aAAa,IAAI;CAC5B,MAAM,WAAW,UAAU,UAAU,IAAI,SAAS;CAElD,MAAM,eAAe,YAA0C;EAC7D,IAAI;GACF,MAAM,YAAY,MAAM,KAAK,QAAQ,CAAC,CAAC,YAAY,MAAS;GAE5D,IAAI,CAAC,WAAW,OAAO;GAEvB,IAAI,OAAO,UAAU,YAAY,QAAQ,GAEvC;QADY,KAAK,IAAI,IAAI,UAAU,UACzB,OAAO,OAAO;GAAS;GAEnC,IAAI,MAAM,MAAM,SAAS,QAAQ;GAEjC,MAAM,OAAO,IAAI;GAEjB,MAAM,IAAI,SAAS,CAAC;GAEpB,MAAM,UAAU,SAAS,IAAO,WAAW,GAAG,IAAI;GAClD,MAAM,eAAe,YAAY,OAAO;GAExC,IAAI;GACJ,MAAM,WAAW;GAQjB,IANE,CAAC,CAAC,YACF,OAAO,aAAa,YACpB,OAAQ,SAAiB,YAAY,YACrC,OAAQ,SAAiB,cAAc,YACvC,OAAO,OAAO,UAAU,MAAM,GAEhB;IACd,MAAM,QAAQ;IAEd,IAAI,MAAM,YAAY,kBAAkB,SAAS;KAC/C,IAAI;MACF,MAAM,OAAO,QAAQ;KACvB,QAAQ,CAAC;KACT;IACF;IAEA,IAAI,OAAO,cAAc,YAAY,YAAY,GAE/C;SADY,KAAK,IAAI,IAAI,MAAM,YACrB,WAAW;MACnB,IAAI;OACF,MAAM,OAAO,QAAQ;MACvB,QAAQ,CAAC;MACT;KACF;;IAGF,QAAQ,MAAM;GAChB,OAAO;IAEL,IAAI,OAAO,cAAc,YAAY,YAAY,GAE/C;SADY,KAAK,IAAI,IAAI,UAAU,UACzB,WAAW;MACnB,IAAI;OACF,MAAM,OAAO,QAAQ;MACvB,QAAQ,CAAC;MACT;KACF;;IAEF,QAAQ;GACV;GAGA,SAAS,IAAI,IAAI,KAAK;GACtB,OAAO;EACT,QAAQ;GACN;EACF;CACF;CAEA,MAAM,cAAc,OAAO,UAAmB;EAC5C,IAAI;GACF,MAAM,UAAU,QAAQ,QAAQ,CAAC;GACjC,MAAM,WAA0B;IAC9B,SAAS,kBAAkB;IAC3B,WAAW,KAAK,IAAI;IACpB,MAAM;GACR;GACA,MAAM,UAAU,OAAO,KAAK,UAAU,QAAQ,CAAC;GAE/C,MAAM,KAAK,qBAAqB,SAAS,QAAQ,IAC7C,SAAS,OAAO,IAChB;GAGJ,MAAM,MAAM,OAAO,OAAO,CACxB,OAAO,KAAK,CAAC,OAAO,UAAU,IAAO,CAAI,CAAC,GAC1C,EACF,CAAC;GAED,MAAM,gBAAgB,UAAU,KAAK,OAAO;EAC9C,QAAQ,CAER;CACF;CAEA,OAAO;;EAEL,KAAK,YAAuC;GAC1C,MAAM,MAAM,SAAS,IAAI,EAAE;GAE3B,IAAI,QAAQ,QAAW,OAAO;GAE9B,IAAI,cAAc,mBAChB,OAAQ,MAAM,aAAa;EAG/B;;EAEA,KAAK,OAAO,UAAkC;GAC5C,SAAS,IAAI,IAAI,KAAK;GAEtB,IAAI,cAAc,mBAChB,MAAM,YAAY,KAAK;EAE3B;;EAEA,OAAO,YAA2B;GAChC,SAAS,OAAO,EAAE;GAElB,IAAI;IACF,MAAM,OAAO,QAAQ;GACvB,QAAQ,CAAC;EACX;;EAEA,UAAU,YAA2B;GACnC,cAAc;GACd,IAAI,cAAc,mBAAmB;IAEnC,MAAM,OAAO,YAAY,KAAK,UAAU,SAAS,IAAI;IAErD,IAAI;KACF,MAAM,GAAG,MAAM;MAAE,WAAW;MAAM,OAAO;KAAK,CAAC;IACjD,QAAQ,CAAC;IAET,IAAI;KACF,MAAM,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;IACvC,QAAQ,CAAC;GACX;EACF;;EAEA,SAAS,YAA8B;GAErC,IADoB,SAAS,IAAI,EACnB,MAAM,QAAW,OAAO;GAGtC,IAAI,CAAC,cAAc,CAAC,mBAAmB,OAAO;GAE9C,IAAI;IACF,MAAM,YAAY,MAAM,KAAK,QAAQ,CAAC,CAAC,YAAY,MAAS;IAC5D,IAAI,CAAC,WAAW,OAAO;IAEvB,IAAI,OAAO,UAAU,YAAY,QAAQ,GAEvC;SADY,KAAK,IAAI,IAAI,UAAU,UACzB,OAAO,OAAO;IAAK;IAG/B,IAAI,MAAM,MAAM,SAAS,QAAQ;IACjC,MAAM,OAAO,IAAI;IACjB,MAAM,IAAI,SAAS,CAAC;IACpB,MAAM,UAAU,SAAS,IAAO,WAAW,GAAG,IAAI;IAGlD,MAAM,WAFe,YAAY,OAEL;IAQ5B,IANE,CAAC,CAAC,YACF,OAAO,aAAa,YACpB,OAAO,SAAS,YAAY,YAC5B,OAAO,SAAS,cAAc,YAC9B,OAAO,OAAO,UAAU,MAAM,GAEhB;KACd,MAAM,QAAQ;KACd,IAAI,MAAM,YAAY,kBAAkB,SAAS,OAAO;KAExD,IAAI,OAAO,cAAc,YAAY,YAAY,GAE/C;UADY,KAAK,IAAI,IAAI,MAAM,YACrB,WAAW,OAAO;KAAK;KAEnC,OAAO;IACT;IAEA,IAAI,OAAO,cAAc,YAAY,YAAY,GAE/C;SADY,KAAK,IAAI,IAAI,UAAU,UACzB,WAAW,OAAO;IAAK;IAEnC,OAAO;GACT,QAAQ;IACN,OAAO;GACT;EACF;;EAEA;;EAEA;CACF;AACF"}

package/dist/esm/utils/cacheMemory.mjs

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 
-//#region src/utils/cacheMemory.ts
+// src/utils/cacheMemory.ts
 /** ------------------------- Utilities ------------------------- **/
 /** Prefer a fast non-crypto hash if available, then fast crypto, then sha256. */
 const pickHashAlgorithm = () => {
@@ -257,6 +257,5 @@ const cacheMemory = {
 	clear: clearCache
 };
 
-//#endregion
 export { cacheMemory, clearAllCache, clearCache, computeKeyId, getCache, setCache, stableStringify };
 //# sourceMappingURL=cacheMemory.mjs.map