@intlayer/engine 9.4.3 → 9.5.0

package/dist/esm/utils/withFileLock.mjs

@@ -0,0 +1,132 @@
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { rmSync } from "node:fs";
+
+//#region src/utils/withFileLock.ts
+const DEFAULT_OPTIONS = {
+	staleTimeoutMs: 3e4,
+	acquireTimeoutMs: 6e4
+};
+/** Delay between two attempts to take a lock held by someone else. */
+const POLL_INTERVAL_MS = 25;
+const delay = (durationMs) => new Promise((resolve) => setTimeout(resolve, durationMs));
+/**
+* Locks held by this process, released synchronously on exit so a crash never
+* leaves a lock file that would stall every later run for `staleTimeoutMs`.
+*/
+const ownedLockFilePaths = /* @__PURE__ */ new Set();
+process.on("exit", () => {
+	for (const lockFilePath of ownedLockFilePaths) try {
+		rmSync(lockFilePath, { force: true });
+	} catch {}
+});
+/**
+* Whether the process holding the lock is still alive. An unreadable PID is
+* reported as alive so {@link WithFileLockOptions.staleTimeoutMs} stays the
+* only way to reclaim the lock.
+*/
+const getIsOwnerAlive = (pid) => {
+	if (!pid || pid === process.pid) return true;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error.code === "EPERM";
+	}
+};
+const readLockOwner = async (lockFilePath) => {
+	try {
+		const raw = await readFile(lockFilePath, "utf8");
+		const parsed = JSON.parse(raw);
+		return {
+			pid: parsed.pid ?? 0,
+			acquiredAt: parsed.acquiredAt ?? 0
+		};
+	} catch {
+		return;
+	}
+};
+const releaseLock = async (lockFilePath) => {
+	try {
+		await unlink(lockFilePath);
+	} catch {}
+};
+/**
+* Attempts to create the lock file. `wx` makes the creation atomic, so exactly
+* one process wins even when several try at the same moment.
+*/
+const tryAcquireLock = async (lockFilePath) => {
+	const data = JSON.stringify({
+		pid: process.pid,
+		acquiredAt: Date.now()
+	});
+	for (let attempt = 0; attempt < 2; attempt++) try {
+		await mkdir(dirname(lockFilePath), { recursive: true });
+		await writeFile(lockFilePath, data, { flag: "wx" });
+		return true;
+	} catch (error) {
+		const code = error.code;
+		if (code === "EEXIST") return false;
+		if (code === "ENOENT" && attempt === 0) continue;
+		throw error;
+	}
+	return false;
+};
+/**
+* Runs `callback` under a cross-process mutex materialised by a lock file.
+*
+* Unlike `runOnce`, which lets one process do the work and the others skip it,
+* every caller here runs the callback — just never at the same time. This is
+* what shared, read-modify-write outputs need (e.g. building the `.intlayer`
+* dictionaries, which merges every dictionary on disk): concurrent runs would
+* each read a half-written state.
+*
+* The lock is released even when the callback throws, and its error is
+* re-thrown to the caller unchanged.
+*
+* @param lockFilePath - Path of the lock file coordinating the callers.
+* @param callback - The critical section.
+* @param options - Staleness and acquisition timeouts.
+*
+* @example
+* ```typescript
+* await withFileLock(join(cacheDir, 'build-dictionary.lock'), () =>
+*   buildDictionary([dictionary], configuration)
+* );
+* ```
+*/
+const withFileLock = async (lockFilePath, callback, options) => {
+	const { staleTimeoutMs, acquireTimeoutMs } = {
+		...DEFAULT_OPTIONS,
+		...options ?? {}
+	};
+	const acquireDeadline = Date.now() + acquireTimeoutMs;
+	let hasAcquiredLock = false;
+	while (Date.now() < acquireDeadline) {
+		if (await tryAcquireLock(lockFilePath)) {
+			hasAcquiredLock = true;
+			break;
+		}
+		const owner = await readLockOwner(lockFilePath);
+		if (owner) {
+			if (!getIsOwnerAlive(owner.pid) || Date.now() - owner.acquiredAt > staleTimeoutMs) {
+				await releaseLock(lockFilePath);
+				continue;
+			}
+		}
+		await delay(POLL_INTERVAL_MS);
+	}
+	if (hasAcquiredLock) ownedLockFilePaths.add(lockFilePath);
+	try {
+		return await callback();
+	} finally {
+		if (hasAcquiredLock) {
+			ownedLockFilePaths.delete(lockFilePath);
+			await releaseLock(lockFilePath);
+		}
+	}
+};
+
+//#endregion
+export { withFileLock };
+//# sourceMappingURL=withFileLock.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"withFileLock.mjs","names":[],"sources":["../../../src/utils/withFileLock.ts"],"sourcesContent":["import { rmSync } from 'node:fs';\nimport { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\n\n/** Payload written inside a lock file, used to detect abandoned locks. */\ntype LockOwnerData = {\n  /** PID of the process currently holding the lock. */\n  pid: number;\n  /** Epoch milliseconds at which the lock was taken. */\n  acquiredAt: number;\n};\n\ntype WithFileLockOptions = {\n  /**\n   * How long a lock may be held before it is considered abandoned and taken\n   * over, in milliseconds.\n   *\n   * @default 30000 = 30 seconds\n   */\n  staleTimeoutMs?: number;\n  /**\n   * How long to wait for the lock before running the callback anyway, in\n   * milliseconds. Giving up serialises nothing, but it is strictly better than\n   * deadlocking a build behind a lock that never clears.\n   *\n   * @default 60000 = 1 minute\n   */\n  acquireTimeoutMs?: number;\n};\n\nconst DEFAULT_OPTIONS = {\n  staleTimeoutMs: 30 * 1000,\n  acquireTimeoutMs: 60 * 1000,\n} satisfies Required<WithFileLockOptions>;\n\n/** Delay between two attempts to take a lock held by someone else. */\nconst POLL_INTERVAL_MS = 25;\n\nconst delay = (durationMs: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, durationMs));\n\n/**\n * Locks held by this process, released synchronously on exit so a crash never\n * leaves a lock file that would stall every later run for `staleTimeoutMs`.\n */\nconst ownedLockFilePaths = new Set<string>();\n\nprocess.on('exit', () => {\n  for (const lockFilePath of ownedLockFilePaths) {\n    try {\n      rmSync(lockFilePath, { force: true });\n    } catch {}\n  }\n});\n\n/**\n * Whether the process holding the lock is still alive. An unreadable PID is\n * reported as alive so {@link WithFileLockOptions.staleTimeoutMs} stays the\n * only way to reclaim the lock.\n */\nconst getIsOwnerAlive = (pid: number): boolean => {\n  if (!pid || pid === process.pid) return true;\n\n  try {\n    // Signal 0 checks for existence without delivering a signal.\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    // EPERM means the process exists but belongs to another user.\n    return (error as NodeJS.ErrnoException).code === 'EPERM';\n  }\n};\n\nconst readLockOwner = async (\n  lockFilePath: string\n): Promise<LockOwnerData | undefined> => {\n  try {\n    const raw = await readFile(lockFilePath, 'utf8');\n    const parsed = JSON.parse(raw) as Partial<LockOwnerData>;\n\n    return {\n      pid: parsed.pid ?? 0,\n      acquiredAt: parsed.acquiredAt ?? 0,\n    };\n  } catch {\n    return undefined;\n  }\n};\n\nconst releaseLock = async (lockFilePath: string): Promise<void> => {\n  try {\n    await unlink(lockFilePath);\n  } catch {}\n};\n\n/**\n * Attempts to create the lock file. `wx` makes the creation atomic, so exactly\n * one process wins even when several try at the same moment.\n */\nconst tryAcquireLock = async (lockFilePath: string): Promise<boolean> => {\n  const data = JSON.stringify({\n    pid: process.pid,\n    acquiredAt: Date.now(),\n  } satisfies LockOwnerData);\n\n  for (let attempt = 0; attempt < 2; attempt++) {\n    try {\n      await mkdir(dirname(lockFilePath), { recursive: true });\n      await writeFile(lockFilePath, data, { flag: 'wx' });\n\n      return true;\n    } catch (error) {\n      const code = (error as NodeJS.ErrnoException).code;\n\n      if (code === 'EEXIST') return false;\n      // The directory was removed between the mkdir and the write (e.g. a\n      // concurrent output-directory clean); retry once.\n      if (code === 'ENOENT' && attempt === 0) continue;\n\n      throw error;\n    }\n  }\n\n  return false;\n};\n\n/**\n * Runs `callback` under a cross-process mutex materialised by a lock file.\n *\n * Unlike `runOnce`, which lets one process do the work and the others skip it,\n * every caller here runs the callback — just never at the same time. This is\n * what shared, read-modify-write outputs need (e.g. building the `.intlayer`\n * dictionaries, which merges every dictionary on disk): concurrent runs would\n * each read a half-written state.\n *\n * The lock is released even when the callback throws, and its error is\n * re-thrown to the caller unchanged.\n *\n * @param lockFilePath - Path of the lock file coordinating the callers.\n * @param callback - The critical section.\n * @param options - Staleness and acquisition timeouts.\n *\n * @example\n * ```typescript\n * await withFileLock(join(cacheDir, 'build-dictionary.lock'), () =>\n *   buildDictionary([dictionary], configuration)\n * );\n * ```\n */\nexport const withFileLock = async <T>(\n  lockFilePath: string,\n  callback: () => T | Promise<T>,\n  options?: WithFileLockOptions\n): Promise<T> => {\n  const { staleTimeoutMs, acquireTimeoutMs } = {\n    ...DEFAULT_OPTIONS,\n    ...(options ?? {}),\n  };\n\n  const acquireDeadline = Date.now() + acquireTimeoutMs;\n  let hasAcquiredLock = false;\n\n  while (Date.now() < acquireDeadline) {\n    if (await tryAcquireLock(lockFilePath)) {\n      hasAcquiredLock = true;\n      break;\n    }\n\n    const owner = await readLockOwner(lockFilePath);\n\n    // A missing owner means the lock was released between the two calls; loop\n    // back and try to take it.\n    if (owner) {\n      const isAbandoned =\n        !getIsOwnerAlive(owner.pid) ||\n        Date.now() - owner.acquiredAt > staleTimeoutMs;\n\n      if (isAbandoned) {\n        await releaseLock(lockFilePath);\n        continue;\n      }\n    }\n\n    await delay(POLL_INTERVAL_MS);\n  }\n\n  if (hasAcquiredLock) ownedLockFilePaths.add(lockFilePath);\n\n  try {\n    return await callback();\n  } finally {\n    if (hasAcquiredLock) {\n      ownedLockFilePaths.delete(lockFilePath);\n      await releaseLock(lockFilePath);\n    }\n  }\n};\n"],"mappings":";;;;;AA8BA,MAAM,kBAAkB;CACtB,gBAAgB;CAChB,kBAAkB;AACpB;;AAGA,MAAM,mBAAmB;AAEzB,MAAM,SAAS,eACb,IAAI,SAAS,YAAY,WAAW,SAAS,UAAU,CAAC;;;;;AAM1D,MAAM,qCAAqB,IAAI,IAAY;AAE3C,QAAQ,GAAG,cAAc;CACvB,KAAK,MAAM,gBAAgB,oBACzB,IAAI;EACF,OAAO,cAAc,EAAE,OAAO,KAAK,CAAC;CACtC,QAAQ,CAAC;AAEb,CAAC;;;;;;AAOD,MAAM,mBAAmB,QAAyB;CAChD,IAAI,CAAC,OAAO,QAAQ,QAAQ,KAAK,OAAO;CAExC,IAAI;EAEF,QAAQ,KAAK,KAAK,CAAC;EACnB,OAAO;CACT,SAAS,OAAO;EAEd,OAAQ,MAAgC,SAAS;CACnD;AACF;AAEA,MAAM,gBAAgB,OACpB,iBACuC;CACvC,IAAI;EACF,MAAM,MAAM,MAAM,SAAS,cAAc,MAAM;EAC/C,MAAM,SAAS,KAAK,MAAM,GAAG;EAE7B,OAAO;GACL,KAAK,OAAO,OAAO;GACnB,YAAY,OAAO,cAAc;EACnC;CACF,QAAQ;EACN;CACF;AACF;AAEA,MAAM,cAAc,OAAO,iBAAwC;CACjE,IAAI;EACF,MAAM,OAAO,YAAY;CAC3B,QAAQ,CAAC;AACX;;;;;AAMA,MAAM,iBAAiB,OAAO,iBAA2C;CACvE,MAAM,OAAO,KAAK,UAAU;EAC1B,KAAK,QAAQ;EACb,YAAY,KAAK,IAAI;CACvB,CAAyB;CAEzB,KAAK,IAAI,UAAU,GAAG,UAAU,GAAG,WACjC,IAAI;EACF,MAAM,MAAM,QAAQ,YAAY,GAAG,EAAE,WAAW,KAAK,CAAC;EACtD,MAAM,UAAU,cAAc,MAAM,EAAE,MAAM,KAAK,CAAC;EAElD,OAAO;CACT,SAAS,OAAO;EACd,MAAM,OAAQ,MAAgC;EAE9C,IAAI,SAAS,UAAU,OAAO;EAG9B,IAAI,SAAS,YAAY,YAAY,GAAG;EAExC,MAAM;CACR;CAGF,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAa,eAAe,OAC1B,cACA,UACA,YACe;CACf,MAAM,EAAE,gBAAgB,qBAAqB;EAC3C,GAAG;EACH,GAAI,WAAW,CAAC;CAClB;CAEA,MAAM,kBAAkB,KAAK,IAAI,IAAI;CACrC,IAAI,kBAAkB;CAEtB,OAAO,KAAK,IAAI,IAAI,iBAAiB;EACnC,IAAI,MAAM,eAAe,YAAY,GAAG;GACtC,kBAAkB;GAClB;EACF;EAEA,MAAM,QAAQ,MAAM,cAAc,YAAY;EAI9C,IAAI,OAKF;OAHE,CAAC,gBAAgB,MAAM,GAAG,KAC1B,KAAK,IAAI,IAAI,MAAM,aAAa,gBAEjB;IACf,MAAM,YAAY,YAAY;IAC9B;GACF;;EAGF,MAAM,MAAM,gBAAgB;CAC9B;CAEA,IAAI,iBAAiB,mBAAmB,IAAI,YAAY;CAExD,IAAI;EACF,OAAO,MAAM,SAAS;CACxB,UAAU;EACR,IAAI,iBAAiB;GACnB,mBAAmB,OAAO,YAAY;GACtC,MAAM,YAAY,YAAY;EAChC;CACF;AACF"}

package/dist/esm/watcher.mjs

@@ -1,4 +1,6 @@
 import { formatPath } from "./utils/formatter.mjs";
+import { getFormatFromExtension } from "./utils/getFormatFromExtension.mjs";
+import { parseContentDeclarationFileName } from "./utils/parseContentDeclarationFileName.mjs";
 import { handleContentDeclarationFileChange } from "./handleContentDeclarationFileChange.mjs";
 import { handleContentDeclarationFileMoved } from "./handleContentDeclarationFileMoved.mjs";
 import { handleAdditionalContentDeclarationFile } from "./handleAdditionalContentDeclarationFile.mjs";
@@ -6,7 +8,7 @@ import { handleUnlinkedContentDeclarationFile } from "./handleUnlinkedContentDec
 import { prepareIntlayer } from "./prepareIntlayer.mjs";
 import { writeContentDeclaration } from "./writeContentDeclaration/writeContentDeclaration.mjs";
 import { readFile } from "node:fs/promises";
-import { basename, dirname, resolve } from "node:path";
+import { basename, dirname, extname, resolve } from "node:path";
 import { colorize, getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration, getConfigurationAndFilePath } from "@intlayer/config/node";
 import { existsSync, watch as watch$1 } from "node:fs";
@@ -166,10 +168,12 @@ const watch = async (options) => {
 				else scheduleStable(path, () => {
 					processEvent(async () => {
 						if (await readFile(filePath, "utf-8") === "") {
-							const extensionPattern = fileExtensions.map((ext) => ext.replace(/\./g, "\\.")).join("|");
-							const name = fileName.replace(new RegExp(`(${extensionPattern})$`), "");
+							const { key, locale } = parseContentDeclarationFileName(filePath, configuration);
+							const isMarkdown = getFormatFromExtension(extname(filePath)) === "md";
+							const declaredLocale = locale ?? (isMarkdown ? configuration.internationalization.defaultLocale : void 0);
 							await writeContentDeclaration({
-								key: name,
+								key,
+								...declaredLocale && { locale: declaredLocale },
 								content: {},
 								filePath
 							}, configuration);

package/dist/esm/watcher.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.mjs","names":["fsWatch"],"sources":["../../src/watcher.ts"],"sourcesContent":["import { existsSync, watch as fsWatch } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { basename, dirname, resolve } from 'node:path';\nimport * as ANSIColor from '@intlayer/config/colors';\nimport { transpileTSToCJS } from '@intlayer/config/file';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n  getConfigurationAndFilePath,\n} from '@intlayer/config/node';\nimport {\n  clearAllCache,\n  clearDiskCacheMemory,\n  clearModuleCache,\n  normalizePath,\n} from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { handleAdditionalContentDeclarationFile } from './handleAdditionalContentDeclarationFile';\nimport { handleContentDeclarationFileChange } from './handleContentDeclarationFileChange';\nimport { handleContentDeclarationFileMoved } from './handleContentDeclarationFileMoved';\nimport { handleUnlinkedContentDeclarationFile } from './handleUnlinkedContentDeclarationFile';\nimport { prepareIntlayer } from './prepareIntlayer';\nimport { formatPath } from './utils';\nimport { writeContentDeclaration } from './writeContentDeclaration';\n\n// Map to track files that were recently unlinked: oldPath -> { timer, timestamp }\nconst pendingUnlinks = new Map<\n  string,\n  { timer: NodeJS.Timeout; oldPath: string }\n>();\n\n// Array-based sequential task queue — no Promise chain accumulation, no race conditions\nconst taskQueue: (() => Promise<void>)[] = [];\nlet isProcessing = false;\n\nconst processQueue = async () => {\n  if (isProcessing) return;\n  isProcessing = true;\n  while (taskQueue.length > 0) {\n    const task = taskQueue.shift()!;\n    try {\n      await task();\n    } catch (error) {\n      console.error(error);\n    }\n  }\n  isProcessing = false;\n};\n\nconst processEvent = (task: () => Promise<void>) => {\n  taskQueue.push(task);\n  processQueue();\n};\n\ntype WatchOptions = {\n  configuration?: IntlayerConfig;\n  configOptions?: GetConfigurationOptions;\n  skipPrepare?: boolean;\n  persistent?: boolean;\n};\n\n// awaitWriteFinish equivalent: debounce per path until the file is stable\nconst STABILITY_THRESHOLD = 1000;\n\nconst createStabilityDebounce = () => {\n  const pending = new Map<string, NodeJS.Timeout>();\n  return (path: string, handler: () => void) => {\n    const existing = pending.get(path);\n    if (existing) clearTimeout(existing);\n    pending.set(\n      path,\n      setTimeout(() => {\n        pending.delete(path);\n        handler();\n      }, STABILITY_THRESHOLD)\n    );\n  };\n};\n\n// Initialize @parcel/watcher (non-persistent until subscribed)\nexport const watch = async (options?: WatchOptions) => {\n  const { subscribe } = await import('@parcel/watcher');\n\n  const configResult = getConfigurationAndFilePath(options?.configOptions);\n  const configurationFilePath = configResult.configurationFilePath;\n  let configuration: IntlayerConfig =\n    options?.configuration ?? configResult.configuration;\n  const appLogger = getAppLogger(configuration);\n\n  const {\n    watch: isWatchMode,\n    fileExtensions,\n    contentDir,\n    excludedPath,\n  } = configuration.content;\n\n  if (!configuration.content.watch) return;\n\n  appLogger('Watching Intlayer content declarations');\n\n  if (configuration.build.optimize === true) {\n    appLogger(\n      [\n        `Build optimization is forced to ${colorize('true', ANSIColor.GREY)}, but watching is enabled too.`,\n        'It may lead to dev mode performance degradation as well as import errors.',\n        'Its recommended to keep the',\n        colorize('`build.optimized`', ANSIColor.BLUE),\n        'option',\n        colorize('undefined', ANSIColor.GREY),\n        'to get the best dev mode experience',\n      ],\n      {\n        level: 'warn',\n      }\n    );\n  }\n\n  // Strip glob markers from excludedPath entries to get plain segments (e.g. 'node_modules')\n  const excludedSegments = excludedPath.map((segment) =>\n    segment.replace(/^\\*\\*\\//, '').replace(/\\/\\*\\*$/, '')\n  );\n\n  const normalizedConfigPath = configurationFilePath\n    ? normalizePath(configurationFilePath)\n    : null;\n\n  const { mainDir, baseDir } = configuration.system;\n  const normalizedMainDir = normalizePath(mainDir);\n  const normalizedIntlayerDir = normalizePath(dirname(mainDir));\n\n  const subscriptions: { unsubscribe: () => Promise<void> }[] = [];\n\n  const scheduleStable = createStabilityDebounce();\n\n  // ── mainDir watcher (depth 0) ──────────────────────────────────────────────\n  // Detects broken or missing entry-point files inside .intlayer/main\n  if (existsSync(mainDir)) {\n    const mainDirSub = await subscribe(normalizedMainDir, (err, events) => {\n      if (err || isProcessing) return;\n\n      for (const event of events) {\n        const eventPath = normalizePath(event.path);\n        // depth-0 filter: only files directly inside mainDir\n        const rel = eventPath.slice(normalizedMainDir.length + 1);\n        if (!rel || rel.includes('/')) continue;\n        // Temp files written by the bundler (write-then-rename) are build-internal;\n        // their deletion must not trigger a clean rebuild.\n        if (rel.endsWith('.tmp')) continue;\n\n        if (event.type === 'update') {\n          processEvent(async () => {\n            try {\n              // Validate that the regenerated entry point — and the relative\n              // dictionary graph it imports — still resolves, by bundling it\n              // in-memory with esbuild (via the shared, freshness-checked\n              // transpile cache). This replaces a cache-busting dynamic\n              // `import()`, which leaked a permanent record into Node's ESM\n              // registry on every rebuild since that registry is never evicted.\n              const entryCode = await readFile(event.path, 'utf-8');\n              await transpileTSToCJS(entryCode, event.path);\n            } catch {\n              appLogger(\n                `Entry point ${basename(event.path)} failed to load, running clean rebuild...`,\n                { level: 'warn' }\n              );\n              await prepareIntlayer(configuration, {\n                clean: true,\n                forceRun: true,\n              });\n            }\n          });\n        } else if (event.type === 'delete') {\n          processEvent(async () => {\n            appLogger(\n              [\n                'Entry point',\n                formatPath(basename(event.path)),\n                'was removed, running clean rebuild...',\n              ],\n              { level: 'warn' }\n            );\n            await prepareIntlayer(configuration, {\n              clean: true,\n              forceRun: true,\n            });\n          });\n        }\n      }\n    });\n    subscriptions.push(mainDirSub);\n  }\n\n  // ── baseDir watcher (depth 0) — detect .intlayer directory removal ─────────\n  // Native fs.watch is non-recursive and ideal for single-directory depth-0 detection.\n  const intlayerDirName = basename(normalizedIntlayerDir);\n  const fsDirWatcher = fsWatch(\n    baseDir,\n    { persistent: isWatchMode },\n    (eventType, filename) => {\n      if (isProcessing || !filename) return;\n      if (filename !== intlayerDirName) return;\n\n      const fullPath = normalizePath(resolve(baseDir, filename));\n      if (fullPath !== normalizedIntlayerDir) return;\n\n      if (eventType === 'rename' && !existsSync(normalizedIntlayerDir)) {\n        appLogger([\n          formatPath('.intlayer'),\n          'directory removed, running clean rebuild...',\n        ]);\n        processEvent(() =>\n          prepareIntlayer(configuration, { clean: true, forceRun: true })\n        );\n      }\n    }\n  );\n  subscriptions.push({\n    unsubscribe: async () => {\n      fsDirWatcher.close();\n    },\n  });\n\n  // ── main content watcher ───────────────────────────────────────────────────\n  // Ignore patterns for @parcel/watcher (micromatch globs)\n  const ignorePatterns = excludedSegments.map((s) => `**/${s}/**`);\n\n  // Strip trailing slashes so directory matching stays exact. A user-supplied\n  const contentDirs = contentDir\n    .map((dir) => normalizePath(dir).replace(/\\/+$/, ''))\n    .filter(existsSync);\n\n  // Collect unique directories to subscribe to (dirs only, not file paths)\n  const dirsToWatch = new Set<string>(contentDirs);\n  if (normalizedConfigPath) {\n    dirsToWatch.add(normalizePath(dirname(normalizedConfigPath)));\n  }\n\n  const contentHandler = (\n    err: Error | null,\n    events: Array<{ type: string; path: string }>\n  ) => {\n    if (err) {\n      appLogger(`Watcher error: ${err}`, { level: 'error' });\n      appLogger('Restarting watcher');\n      prepareIntlayer(configuration);\n      return;\n    }\n\n    for (const event of events) {\n      const filePath = event.path;\n      const path = normalizePath(filePath);\n\n      const isConfigFile =\n        normalizedConfigPath && path === normalizedConfigPath;\n\n      if (!isConfigFile) {\n        // Must originate from a watched content directory\n        const isInContentDir = contentDirs.some(\n          (d) => path.startsWith(`${d}/`) || path === d\n        );\n        if (!isInContentDir) continue;\n\n        if (excludedSegments.some((segment) => path.includes(`/${segment}`)))\n          continue;\n\n        if (!fileExtensions.some((extension) => path.endsWith(extension)))\n          continue;\n      }\n\n      if (event.type === 'create') {\n        const fileName = basename(filePath);\n\n        // Move detection must happen synchronously before any debounce\n        let isMove = false;\n        let matchedOldPath: string | undefined;\n\n        for (const [oldPath] of pendingUnlinks) {\n          if (basename(oldPath) === fileName) {\n            matchedOldPath = oldPath;\n            break;\n          }\n        }\n\n        if (!matchedOldPath && pendingUnlinks.size === 1) {\n          matchedOldPath = pendingUnlinks.keys().next().value;\n        }\n\n        if (matchedOldPath) {\n          const pending = pendingUnlinks.get(matchedOldPath);\n          if (pending) {\n            clearTimeout(pending.timer);\n            pendingUnlinks.delete(matchedOldPath);\n          }\n          isMove = true;\n          appLogger(`File moved from ${matchedOldPath} to ${filePath}`);\n        }\n\n        if (isMove && matchedOldPath) {\n          processEvent(async () => {\n            await handleContentDeclarationFileMoved(\n              matchedOldPath!,\n              filePath,\n              configuration\n            );\n          });\n        } else {\n          // Debounce: wait for write to finish before reading the file\n          scheduleStable(path, () => {\n            processEvent(async () => {\n              const fileContent = await readFile(filePath, 'utf-8');\n              const isEmpty = fileContent === '';\n\n              if (isEmpty) {\n                const extensionPattern = fileExtensions\n                  .map((ext) => ext.replace(/\\./g, '\\\\.'))\n                  .join('|');\n                const name = fileName.replace(\n                  new RegExp(`(${extensionPattern})$`),\n                  ''\n                );\n\n                await writeContentDeclaration(\n                  { key: name, content: {}, filePath },\n                  configuration\n                );\n              }\n\n              await handleAdditionalContentDeclarationFile(\n                filePath,\n                configuration\n              );\n            });\n          });\n        }\n      } else if (event.type === 'update') {\n        scheduleStable(path, () => {\n          processEvent(async () => {\n            if (isConfigFile) {\n              appLogger('Configuration file changed, repreparing Intlayer');\n\n              clearModuleCache(filePath);\n              clearAllCache();\n\n              const { configuration: newConfiguration } =\n                getConfigurationAndFilePath(options?.configOptions);\n\n              configuration = options?.configuration ?? newConfiguration;\n\n              await prepareIntlayer(configuration, { clean: false });\n            } else {\n              // Clear module cache for the changed file to avoid stale require() results\n              clearModuleCache(filePath);\n              // Evict in-memory caches so loadContentDeclaration picks up fresh content\n              clearAllCache();\n              clearDiskCacheMemory();\n              await handleContentDeclarationFileChange(filePath, configuration);\n            }\n          });\n        });\n      } else if (event.type === 'delete') {\n        // Delay unlink processing to see if an 'add' event occurs (indicating a move)\n        const timer = setTimeout(async () => {\n          // If timer fires, the file was genuinely removed\n          pendingUnlinks.delete(filePath);\n          processEvent(async () =>\n            handleUnlinkedContentDeclarationFile(filePath, configuration)\n          );\n        }, 200); // 200ms window to catch the 'create' event\n\n        pendingUnlinks.set(filePath, { timer, oldPath: filePath });\n      }\n    }\n  };\n\n  for (const dir of dirsToWatch) {\n    const sub = await subscribe(dir, contentHandler, {\n      ignore: ignorePatterns,\n    });\n\n    subscriptions.push(sub);\n  }\n\n  return subscriptions;\n};\n\nexport const buildAndWatchIntlayer = async (options?: WatchOptions) => {\n  const { skipPrepare, ...rest } = options ?? {};\n  const configuration =\n    options?.configuration ?? getConfiguration(options?.configOptions);\n\n  if (!skipPrepare) {\n    await prepareIntlayer(configuration, { forceRun: true });\n  }\n\n  // Only enter watch mode when the caller explicitly opts in via `persistent`.\n  // `configuration.content.watch` is the dev-mode signal consumed by bundler\n  // plugins (e.g. vite-intlayer's `configureServer`); it must not coerce\n  // `intlayer build` (which passes `persistent: false`) into a persistent\n  // watcher, since that prevents the build command from ever exiting.\n  if (options?.persistent) {\n    await watch({ ...rest, configuration });\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"watcher.mjs","names":["fsWatch"],"sources":["../../src/watcher.ts"],"sourcesContent":["import { existsSync, watch as fsWatch } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { basename, dirname, extname, resolve } from 'node:path';\nimport * as ANSIColor from '@intlayer/config/colors';\nimport { transpileTSToCJS } from '@intlayer/config/file';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n  getConfigurationAndFilePath,\n} from '@intlayer/config/node';\nimport {\n  clearAllCache,\n  clearDiskCacheMemory,\n  clearModuleCache,\n  normalizePath,\n} from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { handleAdditionalContentDeclarationFile } from './handleAdditionalContentDeclarationFile';\nimport { handleContentDeclarationFileChange } from './handleContentDeclarationFileChange';\nimport { handleContentDeclarationFileMoved } from './handleContentDeclarationFileMoved';\nimport { handleUnlinkedContentDeclarationFile } from './handleUnlinkedContentDeclarationFile';\nimport { prepareIntlayer } from './prepareIntlayer';\nimport {\n  formatPath,\n  getFormatFromExtension,\n  parseContentDeclarationFileName,\n} from './utils';\nimport { writeContentDeclaration } from './writeContentDeclaration';\n\n// Map to track files that were recently unlinked: oldPath -> { timer, timestamp }\nconst pendingUnlinks = new Map<\n  string,\n  { timer: NodeJS.Timeout; oldPath: string }\n>();\n\n// Array-based sequential task queue — no Promise chain accumulation, no race conditions\nconst taskQueue: (() => Promise<void>)[] = [];\nlet isProcessing = false;\n\nconst processQueue = async () => {\n  if (isProcessing) return;\n  isProcessing = true;\n  while (taskQueue.length > 0) {\n    const task = taskQueue.shift()!;\n    try {\n      await task();\n    } catch (error) {\n      console.error(error);\n    }\n  }\n  isProcessing = false;\n};\n\nconst processEvent = (task: () => Promise<void>) => {\n  taskQueue.push(task);\n  processQueue();\n};\n\ntype WatchOptions = {\n  configuration?: IntlayerConfig;\n  configOptions?: GetConfigurationOptions;\n  skipPrepare?: boolean;\n  persistent?: boolean;\n};\n\n// awaitWriteFinish equivalent: debounce per path until the file is stable\nconst STABILITY_THRESHOLD = 1000;\n\nconst createStabilityDebounce = () => {\n  const pending = new Map<string, NodeJS.Timeout>();\n  return (path: string, handler: () => void) => {\n    const existing = pending.get(path);\n    if (existing) clearTimeout(existing);\n    pending.set(\n      path,\n      setTimeout(() => {\n        pending.delete(path);\n        handler();\n      }, STABILITY_THRESHOLD)\n    );\n  };\n};\n\n// Initialize @parcel/watcher (non-persistent until subscribed)\nexport const watch = async (options?: WatchOptions) => {\n  const { subscribe } = await import('@parcel/watcher');\n\n  const configResult = getConfigurationAndFilePath(options?.configOptions);\n  const configurationFilePath = configResult.configurationFilePath;\n  let configuration: IntlayerConfig =\n    options?.configuration ?? configResult.configuration;\n  const appLogger = getAppLogger(configuration);\n\n  const {\n    watch: isWatchMode,\n    fileExtensions,\n    contentDir,\n    excludedPath,\n  } = configuration.content;\n\n  if (!configuration.content.watch) return;\n\n  appLogger('Watching Intlayer content declarations');\n\n  if (configuration.build.optimize === true) {\n    appLogger(\n      [\n        `Build optimization is forced to ${colorize('true', ANSIColor.GREY)}, but watching is enabled too.`,\n        'It may lead to dev mode performance degradation as well as import errors.',\n        'Its recommended to keep the',\n        colorize('`build.optimized`', ANSIColor.BLUE),\n        'option',\n        colorize('undefined', ANSIColor.GREY),\n        'to get the best dev mode experience',\n      ],\n      {\n        level: 'warn',\n      }\n    );\n  }\n\n  // Strip glob markers from excludedPath entries to get plain segments (e.g. 'node_modules')\n  const excludedSegments = excludedPath.map((segment) =>\n    segment.replace(/^\\*\\*\\//, '').replace(/\\/\\*\\*$/, '')\n  );\n\n  const normalizedConfigPath = configurationFilePath\n    ? normalizePath(configurationFilePath)\n    : null;\n\n  const { mainDir, baseDir } = configuration.system;\n  const normalizedMainDir = normalizePath(mainDir);\n  const normalizedIntlayerDir = normalizePath(dirname(mainDir));\n\n  const subscriptions: { unsubscribe: () => Promise<void> }[] = [];\n\n  const scheduleStable = createStabilityDebounce();\n\n  // ── mainDir watcher (depth 0) ──────────────────────────────────────────────\n  // Detects broken or missing entry-point files inside .intlayer/main\n  if (existsSync(mainDir)) {\n    const mainDirSub = await subscribe(normalizedMainDir, (err, events) => {\n      if (err || isProcessing) return;\n\n      for (const event of events) {\n        const eventPath = normalizePath(event.path);\n        // depth-0 filter: only files directly inside mainDir\n        const rel = eventPath.slice(normalizedMainDir.length + 1);\n        if (!rel || rel.includes('/')) continue;\n        // Temp files written by the bundler (write-then-rename) are build-internal;\n        // their deletion must not trigger a clean rebuild.\n        if (rel.endsWith('.tmp')) continue;\n\n        if (event.type === 'update') {\n          processEvent(async () => {\n            try {\n              // Validate that the regenerated entry point — and the relative\n              // dictionary graph it imports — still resolves, by bundling it\n              // in-memory with esbuild (via the shared, freshness-checked\n              // transpile cache). This replaces a cache-busting dynamic\n              // `import()`, which leaked a permanent record into Node's ESM\n              // registry on every rebuild since that registry is never evicted.\n              const entryCode = await readFile(event.path, 'utf-8');\n              await transpileTSToCJS(entryCode, event.path);\n            } catch {\n              appLogger(\n                `Entry point ${basename(event.path)} failed to load, running clean rebuild...`,\n                { level: 'warn' }\n              );\n              await prepareIntlayer(configuration, {\n                clean: true,\n                forceRun: true,\n              });\n            }\n          });\n        } else if (event.type === 'delete') {\n          processEvent(async () => {\n            appLogger(\n              [\n                'Entry point',\n                formatPath(basename(event.path)),\n                'was removed, running clean rebuild...',\n              ],\n              { level: 'warn' }\n            );\n            await prepareIntlayer(configuration, {\n              clean: true,\n              forceRun: true,\n            });\n          });\n        }\n      }\n    });\n    subscriptions.push(mainDirSub);\n  }\n\n  // ── baseDir watcher (depth 0) — detect .intlayer directory removal ─────────\n  // Native fs.watch is non-recursive and ideal for single-directory depth-0 detection.\n  const intlayerDirName = basename(normalizedIntlayerDir);\n  const fsDirWatcher = fsWatch(\n    baseDir,\n    { persistent: isWatchMode },\n    (eventType, filename) => {\n      if (isProcessing || !filename) return;\n      if (filename !== intlayerDirName) return;\n\n      const fullPath = normalizePath(resolve(baseDir, filename));\n      if (fullPath !== normalizedIntlayerDir) return;\n\n      if (eventType === 'rename' && !existsSync(normalizedIntlayerDir)) {\n        appLogger([\n          formatPath('.intlayer'),\n          'directory removed, running clean rebuild...',\n        ]);\n        processEvent(() =>\n          prepareIntlayer(configuration, { clean: true, forceRun: true })\n        );\n      }\n    }\n  );\n  subscriptions.push({\n    unsubscribe: async () => {\n      fsDirWatcher.close();\n    },\n  });\n\n  // ── main content watcher ───────────────────────────────────────────────────\n  // Ignore patterns for @parcel/watcher (micromatch globs)\n  const ignorePatterns = excludedSegments.map((s) => `**/${s}/**`);\n\n  // Strip trailing slashes so directory matching stays exact. A user-supplied\n  const contentDirs = contentDir\n    .map((dir) => normalizePath(dir).replace(/\\/+$/, ''))\n    .filter(existsSync);\n\n  // Collect unique directories to subscribe to (dirs only, not file paths)\n  const dirsToWatch = new Set<string>(contentDirs);\n  if (normalizedConfigPath) {\n    dirsToWatch.add(normalizePath(dirname(normalizedConfigPath)));\n  }\n\n  const contentHandler = (\n    err: Error | null,\n    events: Array<{ type: string; path: string }>\n  ) => {\n    if (err) {\n      appLogger(`Watcher error: ${err}`, { level: 'error' });\n      appLogger('Restarting watcher');\n      prepareIntlayer(configuration);\n      return;\n    }\n\n    for (const event of events) {\n      const filePath = event.path;\n      const path = normalizePath(filePath);\n\n      const isConfigFile =\n        normalizedConfigPath && path === normalizedConfigPath;\n\n      if (!isConfigFile) {\n        // Must originate from a watched content directory\n        const isInContentDir = contentDirs.some(\n          (d) => path.startsWith(`${d}/`) || path === d\n        );\n        if (!isInContentDir) continue;\n\n        if (excludedSegments.some((segment) => path.includes(`/${segment}`)))\n          continue;\n\n        if (!fileExtensions.some((extension) => path.endsWith(extension)))\n          continue;\n      }\n\n      if (event.type === 'create') {\n        const fileName = basename(filePath);\n\n        // Move detection must happen synchronously before any debounce\n        let isMove = false;\n        let matchedOldPath: string | undefined;\n\n        for (const [oldPath] of pendingUnlinks) {\n          if (basename(oldPath) === fileName) {\n            matchedOldPath = oldPath;\n            break;\n          }\n        }\n\n        if (!matchedOldPath && pendingUnlinks.size === 1) {\n          matchedOldPath = pendingUnlinks.keys().next().value;\n        }\n\n        if (matchedOldPath) {\n          const pending = pendingUnlinks.get(matchedOldPath);\n          if (pending) {\n            clearTimeout(pending.timer);\n            pendingUnlinks.delete(matchedOldPath);\n          }\n          isMove = true;\n          appLogger(`File moved from ${matchedOldPath} to ${filePath}`);\n        }\n\n        if (isMove && matchedOldPath) {\n          processEvent(async () => {\n            await handleContentDeclarationFileMoved(\n              matchedOldPath!,\n              filePath,\n              configuration\n            );\n          });\n        } else {\n          // Debounce: wait for write to finish before reading the file\n          scheduleStable(path, () => {\n            processEvent(async () => {\n              const fileContent = await readFile(filePath, 'utf-8');\n              const isEmpty = fileContent === '';\n\n              if (isEmpty) {\n                const { key, locale } = parseContentDeclarationFileName(\n                  filePath,\n                  configuration\n                );\n\n                // A markdown declaration carries a single locale body, so it\n                // must always state which locale it holds.\n                const isMarkdown =\n                  getFormatFromExtension(extname(filePath)) === 'md';\n                const declaredLocale =\n                  locale ??\n                  (isMarkdown\n                    ? configuration.internationalization.defaultLocale\n                    : undefined);\n\n                await writeContentDeclaration(\n                  {\n                    key,\n                    ...(declaredLocale && { locale: declaredLocale }),\n                    content: {},\n                    filePath,\n                  },\n                  configuration\n                );\n              }\n\n              await handleAdditionalContentDeclarationFile(\n                filePath,\n                configuration\n              );\n            });\n          });\n        }\n      } else if (event.type === 'update') {\n        scheduleStable(path, () => {\n          processEvent(async () => {\n            if (isConfigFile) {\n              appLogger('Configuration file changed, repreparing Intlayer');\n\n              clearModuleCache(filePath);\n              clearAllCache();\n\n              const { configuration: newConfiguration } =\n                getConfigurationAndFilePath(options?.configOptions);\n\n              configuration = options?.configuration ?? newConfiguration;\n\n              await prepareIntlayer(configuration, { clean: false });\n            } else {\n              // Clear module cache for the changed file to avoid stale require() results\n              clearModuleCache(filePath);\n              // Evict in-memory caches so loadContentDeclaration picks up fresh content\n              clearAllCache();\n              clearDiskCacheMemory();\n              await handleContentDeclarationFileChange(filePath, configuration);\n            }\n          });\n        });\n      } else if (event.type === 'delete') {\n        // Delay unlink processing to see if an 'add' event occurs (indicating a move)\n        const timer = setTimeout(async () => {\n          // If timer fires, the file was genuinely removed\n          pendingUnlinks.delete(filePath);\n          processEvent(async () =>\n            handleUnlinkedContentDeclarationFile(filePath, configuration)\n          );\n        }, 200); // 200ms window to catch the 'create' event\n\n        pendingUnlinks.set(filePath, { timer, oldPath: filePath });\n      }\n    }\n  };\n\n  for (const dir of dirsToWatch) {\n    const sub = await subscribe(dir, contentHandler, {\n      ignore: ignorePatterns,\n    });\n\n    subscriptions.push(sub);\n  }\n\n  return subscriptions;\n};\n\nexport const buildAndWatchIntlayer = async (options?: WatchOptions) => {\n  const { skipPrepare, ...rest } = options ?? {};\n  const configuration =\n    options?.configuration ?? getConfiguration(options?.configOptions);\n\n  if (!skipPrepare) {\n    await prepareIntlayer(configuration, { forceRun: true });\n  }\n\n  // Only enter watch mode when the caller explicitly opts in via `persistent`.\n  // `configuration.content.watch` is the dev-mode signal consumed by bundler\n  // plugins (e.g. vite-intlayer's `configureServer`); it must not coerce\n  // `intlayer build` (which passes `persistent: false`) into a persistent\n  // watcher, since that prevents the build command from ever exiting.\n  if (options?.persistent) {\n    await watch({ ...rest, configuration });\n  }\n};\n"],"mappings":"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"}

package/dist/types/buildIntlayerDictionary/buildIntlayerDictionary.d.ts

@@ -5,7 +5,7 @@ import { IntlayerConfig } from "@intlayer/types/config";
 import { Dictionary } from "@intlayer/types/dictionary";
 import { OUTPUT_FORMAT } from "@intlayer/config/defaultValues";
 //#region src/buildIntlayerDictionary/buildIntlayerDictionary.d.ts
-type BuildDictionariesOptions = Partial<{
+export type BuildDictionariesOptions = Partial<{
   formats: typeof OUTPUT_FORMAT;
   importOtherDictionaries: boolean;
   env: 'prod' | 'dev';
@@ -13,12 +13,11 @@ type BuildDictionariesOptions = Partial<{
 /**
  * This function transpile the bundled code to to make dictionaries as JSON files
  */
-declare const buildDictionary: (localDictionariesEntries: Dictionary[], configuration: IntlayerConfig, options?: BuildDictionariesOptions) => Promise<{
+export declare const buildDictionary: (localDictionariesEntries: Dictionary[], configuration: IntlayerConfig, options?: BuildDictionariesOptions) => Promise<{
   unmergedDictionaries: UnmergedDictionaryOutput;
   mergedDictionaries: MergedDictionaryOutput;
   dynamicDictionaries: LocalizedDictionaryOutput;
   fetchDictionaries: LocalizedDictionaryOutput;
 }>;
 //#endregion
-export { BuildDictionariesOptions, buildDictionary };
 //# sourceMappingURL=buildIntlayerDictionary.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"buildIntlayerDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/buildIntlayerDictionary.ts"],"mappings":";;;;;;;KAuBY,2BAA2B;EACrC,gBAAgB;EAChB;EACA;;;;;cAYW,kBAAe,0BACA,cAAY,eACvB,gBAAc,UACnB,6BAAwB;wBAAxB"}
+{"version":3,"file":"buildIntlayerDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/buildIntlayerDictionary.ts"],"mappings":";;;;;;;YAuBY,2BAA2B;EACrC,gBAAgB;EAChB;EACA;;;;;qBAYW,kBAAe,0BACA,cAAY,eACvB,gBAAc,UACnB,6BAAwB;wBAAxB"}

package/dist/types/buildIntlayerDictionary/processContentDeclaration.d.ts

@@ -4,7 +4,6 @@ import { Dictionary } from "@intlayer/types/dictionary";
 /**
  * Function to load, process the module and return the Intlayer Dictionary from the module file
  */
-declare const processContentDeclaration: (contentDeclaration: Dictionary, configuration: IntlayerConfig) => Promise<Dictionary | undefined>;
+export declare const processContentDeclaration: (contentDeclaration: Dictionary, configuration: IntlayerConfig) => Promise<Dictionary | undefined>;
 //#endregion
-export { processContentDeclaration };
 //# sourceMappingURL=processContentDeclaration.d.ts.map

package/dist/types/buildIntlayerDictionary/processContentDeclaration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processContentDeclaration.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/processContentDeclaration.ts"],"mappings":";;;;;;cASa,4BAAyB,oBAChB,YAAU,eACf,mBACd,QAAQ"}
+{"version":3,"file":"processContentDeclaration.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/processContentDeclaration.ts"],"mappings":";;;;;;qBASa,4BAAyB,oBAChB,YAAU,eACf,mBACd,QAAQ"}

package/dist/types/buildIntlayerDictionary/writeDynamicDictionary.d.ts

@@ -3,12 +3,12 @@ import { IntlayerConfig } from "@intlayer/types/config";
 import { Dictionary, DictionaryQualifierType, QualifiedDictionaryGroup } from "@intlayer/types/dictionary";
 import { Locale } from "@intlayer/types/allLocales";
 //#region src/buildIntlayerDictionary/writeDynamicDictionary.d.ts
-type DictionaryResult = {
+export type DictionaryResult = {
   dictionaryPath: string;
   dictionary: Dictionary;
 };
-type LocalizedDictionaryResult = Partial<Record<Locale, DictionaryResult>>;
-type LocalizedDictionaryOutput = Record<string, LocalizedDictionaryResult>;
+export type LocalizedDictionaryResult = Partial<Record<Locale, DictionaryResult>>;
+export type LocalizedDictionaryOutput = Record<string, LocalizedDictionaryResult>;
 /**
  * Generates the content of a dictionary entry point file.
  *
@@ -24,7 +24,7 @@ type LocalizedDictionaryOutput = Record<string, LocalizedDictionaryResult>;
  * @param format - Output module format.
  * @param nestedKeys - Keys referenced through `nest()`, transitively.
  */
-declare const generateDictionaryEntryPoint: (key: string, locales: string[], format?: 'cjs' | 'esm', nestedKeys?: string[]) => string;
+export declare const generateDictionaryEntryPoint: (key: string, locales: string[], format?: 'cjs' | 'esm', nestedKeys?: string[]) => string;
 /**
  * One entry of a qualified loader map.
  *
@@ -34,7 +34,7 @@ declare const generateDictionaryEntryPoint: (key: string, locales: string[], for
  * fan-out): the alias keeps its own tree position but points at the canonical
  * entry's chunk, so equal content is emitted — and downloaded — only once.
  */
-type QualifiedEntrySegments = {
+export type QualifiedEntrySegments = {
   treeSegments: string[];
   chunkSegments: string[];
 };
@@ -49,7 +49,7 @@ type QualifiedEntrySegments = {
  * dynamic imports (Turbopack). Entries whose content is identical share one
  * chunk: their leaves point at the canonical entry's import path.
  */
-declare const generateQualifiedDictionaryEntryPoint: (key: string, qualifierTypes: DictionaryQualifierType[], entries: QualifiedEntrySegments[], locales: string[], format?: 'cjs' | 'esm') => string;
+export declare const generateQualifiedDictionaryEntryPoint: (key: string, qualifierTypes: DictionaryQualifierType[], entries: QualifiedEntrySegments[], locales: string[], format?: 'cjs' | 'esm') => string;
 /**
  * Write the localized dictionaries to the dictionariesDir
  * @param mergedDictionaries - The merged dictionaries
@@ -66,12 +66,12 @@ declare const generateQualifiedDictionaryEntryPoint: (key: string, qualifierType
  * // .intlayer/dynamic_dictionary/dictionaries/fr_home.json
  * ```
  */
-declare const writeDynamicDictionary: (mergedDictionaries: PlainMergedDictionaryOutput, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[], nestedDictionaryGraph?: Map<string, Set<string>>) => Promise<LocalizedDictionaryOutput>;
-type QualifiedMergedDictionaryResult = {
+export declare const writeDynamicDictionary: (mergedDictionaries: PlainMergedDictionaryOutput, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[], nestedDictionaryGraph?: Map<string, Set<string>>) => Promise<LocalizedDictionaryOutput>;
+export type QualifiedMergedDictionaryResult = {
   dictionaryPath: string;
   dictionary: QualifiedDictionaryGroup;
 };
-type QualifiedMergedDictionaryOutput = Record<string, QualifiedMergedDictionaryResult>;
+export type QualifiedMergedDictionaryOutput = Record<string, QualifiedMergedDictionaryResult>;
 /**
  * Writes the dynamic chunks and entry points of qualified dictionaries
  * (collections, variants — possibly combined) in
@@ -82,7 +82,6 @@ type QualifiedMergedDictionaryOutput = Record<string, QualifiedMergedDictionaryR
  * `{key}.{ext}` entry point exposes the matching nested loader tree, so the
  * entry point is discovered and aggregated exactly like a plain dynamic one.
  */
-declare const writeDynamicQualifiedDictionaries: (qualifiedDictionaries: QualifiedMergedDictionaryOutput, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[]) => Promise<void>;
+export declare const writeDynamicQualifiedDictionaries: (qualifiedDictionaries: QualifiedMergedDictionaryOutput, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[]) => Promise<void>;
 //#endregion
-export { DictionaryResult, LocalizedDictionaryOutput, LocalizedDictionaryResult, QualifiedEntrySegments, QualifiedMergedDictionaryOutput, QualifiedMergedDictionaryResult, generateDictionaryEntryPoint, generateQualifiedDictionaryEntryPoint, writeDynamicDictionary, writeDynamicQualifiedDictionaries };
 //# sourceMappingURL=writeDynamicDictionary.d.ts.map

package/dist/types/buildIntlayerDictionary/writeDynamicDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeDynamicDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"mappings":";;;;;KA2BY;EACV;EACA,YAAY;;KAGF,4BAA4B,QACtC,OAAO,QAAQ;KAGL,4BAA4B,eAEtC;;;;;;;;;;;;;;;;cAyCW,+BAA4B,aAC5B,mBACM,wBACI;;;;;;;;;;KAoEX;EACV;EACA;;;;;;;;;;;;;cA8EW,wCAAqC,aACrC,gBACK,2BAAyB,SAChC,0BAAwB,mBAChB;;;;;;;;;;;;;;;;;cAyCN,yBAAsB,oBACb,6BAA2B,eAChC,gBAAc,6BACH,wBACH,YAAY,iBAClC,QAAQ;KA2EC;EACV;EACA,YAAY;;KAGF,kCAAkC,eAE5C;;;;;;;;;;;cAaW,oCAAiC,uBACrB,iCAA+B,eACvC,gBAAc,gCAE5B"}
+{"version":3,"file":"writeDynamicDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"mappings":";;;;;YA2BY;EACV;EACA,YAAY;;YAGF,4BAA4B,QACtC,OAAO,QAAQ;YAGL,4BAA4B,eAEtC;;;;;;;;;;;;;;;;qBAyCW,+BAA4B,aAC5B,mBACM,wBACI;;;;;;;;;;YAoEX;EACV;EACA;;;;;;;;;;;;;qBA8EW,wCAAqC,aACrC,gBACK,2BAAyB,SAChC,0BAAwB,mBAChB;;;;;;;;;;;;;;;;;qBAyCN,yBAAsB,oBACb,6BAA2B,eAChC,gBAAc,6BACH,wBACH,YAAY,iBAClC,QAAQ;YA2EC;EACV;EACA,YAAY;;YAGF,kCAAkC,eAE5C;;;;;;;;;;;qBAaW,oCAAiC,uBACrB,iCAA+B,eACvC,gBAAc,gCAE5B"}

package/dist/types/buildIntlayerDictionary/writeFetchDictionary.d.ts

@@ -15,7 +15,7 @@ import { IntlayerConfig } from "@intlayer/types/config";
  * @param format - Output module format.
  * @param nestedKeys - Keys referenced through `nest()`, transitively.
  */
-declare const generateDictionaryEntryPoint: (key: string, locales: string[], relativePrefix: string, format?: 'cjs' | 'esm', nestedKeys?: string[]) => string;
+export declare const generateDictionaryEntryPoint: (key: string, locales: string[], relativePrefix: string, format?: 'cjs' | 'esm', nestedKeys?: string[]) => string;
 /**
  * Write the localized dictionaries to the dictionariesDir
  * @param mergedDictionaries - The merged dictionaries
@@ -32,7 +32,6 @@ declare const generateDictionaryEntryPoint: (key: string, locales: string[], rel
  * // .intlayer/fetch_dictionary/home.cjs
  * ```
  */
-declare const writeFetchDictionary: (dynamicDictionaries: LocalizedDictionaryOutput, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[], nestedDictionaryGraph?: Map<string, Set<string>>) => Promise<LocalizedDictionaryOutput>;
+export declare const writeFetchDictionary: (dynamicDictionaries: LocalizedDictionaryOutput, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[], nestedDictionaryGraph?: Map<string, Set<string>>) => Promise<LocalizedDictionaryOutput>;
 //#endregion
-export { generateDictionaryEntryPoint, writeFetchDictionary };
 //# sourceMappingURL=writeFetchDictionary.d.ts.map

package/dist/types/buildIntlayerDictionary/writeFetchDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeFetchDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeFetchDictionary.ts"],"mappings":";;;;;;;;;;;;;;;;;cAqDa,+BAA4B,aAC5B,mBACM,wBACK,wBACD;;;;;;;;;;;;;;;;;cA2FV,uBAAoB,qBACV,2BAAyB,eAC/B,gBAAc,6BACH,wBACH,YAAY,iBAClC,QAAQ"}
+{"version":3,"file":"writeFetchDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeFetchDictionary.ts"],"mappings":";;;;;;;;;;;;;;;;;qBAqDa,+BAA4B,aAC5B,mBACM,wBACK,wBACD;;;;;;;;;;;;;;;;;qBA2FV,uBAAoB,qBACV,2BAAyB,eAC/B,gBAAc,6BACH,wBACH,YAAY,iBAClC,QAAQ"}

package/dist/types/buildIntlayerDictionary/writeMergedDictionary.d.ts

@@ -2,21 +2,21 @@ import { UnmergedDictionaryOutput } from "./writeUnmergedDictionary.js";
 import { IntlayerConfig } from "@intlayer/types/config";
 import { Dictionary, QualifiedDictionaryGroup } from "@intlayer/types/dictionary";
 //#region src/buildIntlayerDictionary/writeMergedDictionary.d.ts
-type MergedDictionaryResult = {
+export type MergedDictionaryResult = {
   dictionaryPath: string;
   dictionary: Dictionary | QualifiedDictionaryGroup;
 };
-type MergedDictionaryOutput = Record<string, MergedDictionaryResult>;
+export type MergedDictionaryOutput = Record<string, MergedDictionaryResult>;
 /**
  * Merged output restricted to plain (unqualified) dictionaries — qualified
  * groups (collections, variants) are static-only and filtered
  * out before the dynamic/fetch build steps.
  */
-type PlainMergedDictionaryResult = {
+export type PlainMergedDictionaryResult = {
   dictionaryPath: string;
   dictionary: Dictionary;
 };
-type PlainMergedDictionaryOutput = Record<string, PlainMergedDictionaryResult>;
+export type PlainMergedDictionaryOutput = Record<string, PlainMergedDictionaryResult>;
 /**
  * Write the merged dictionaries to the dictionariesDir
  * @param groupedDictionaries - The grouped dictionaries
@@ -33,7 +33,6 @@ type PlainMergedDictionaryOutput = Record<string, PlainMergedDictionaryResult>;
  * // { key: 'home', content: { ... } },
  * ```
  */
-declare const writeMergedDictionaries: (groupedDictionaries: UnmergedDictionaryOutput, configuration: IntlayerConfig) => Promise<MergedDictionaryOutput>;
+export declare const writeMergedDictionaries: (groupedDictionaries: UnmergedDictionaryOutput, configuration: IntlayerConfig) => Promise<MergedDictionaryOutput>;
 //#endregion
-export { MergedDictionaryOutput, MergedDictionaryResult, PlainMergedDictionaryOutput, PlainMergedDictionaryResult, writeMergedDictionaries };
 //# sourceMappingURL=writeMergedDictionary.d.ts.map

package/dist/types/buildIntlayerDictionary/writeMergedDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeMergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"mappings":";;;;KAiBY;EACV;EACA,YAAY,aAAa;;KAGf,yBAAyB,eAAe;;;;;;KAOxC;EACV;EACA,YAAY;;KAGF,8BAA8B,eAExC;;;;;;;;;;;;;;;;;cAmBW,0BAAuB,qBACb,0BAAwB,eAC9B,mBACd,QAAQ"}
+{"version":3,"file":"writeMergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"mappings":";;;;YAiBY;EACV;EACA,YAAY,aAAa;;YAGf,yBAAyB,eAAe;;;;;;YAOxC;EACV;EACA,YAAY;;YAGF,8BAA8B,eAExC;;;;;;;;;;;;;;;;;qBAmBW,0BAAuB,qBACb,0BAAwB,eAC9B,mBACd,QAAQ"}

package/dist/types/buildIntlayerDictionary/writeNestedDictionary.d.ts

@@ -6,7 +6,7 @@ import { IntlayerConfig } from "@intlayer/types/config";
  * because the `**\/*.json` globs listing compiled dictionaries never match the
  * `.mjs` / `.cjs` files written here.
  */
-declare const NESTED_DICTIONARIES_SUBDIR = "nested";
+export declare const NESTED_DICTIONARIES_SUBDIR = "nested";
 /**
  * Path of the companion module carrying the `nest()` targets of a dictionary.
  *
@@ -18,7 +18,7 @@ declare const NESTED_DICTIONARIES_SUBDIR = "nested";
  * @param key - The dictionary key.
  * @param extension - Module extension, `'mjs'` (default) or `'cjs'`.
  */
-declare const getNestedDictionaryPath: (dictionariesDir: string, key: string, extension?: 'mjs' | 'cjs') => string;
+export declare const getNestedDictionaryPath: (dictionariesDir: string, key: string, extension?: 'mjs' | 'cjs') => string;
 /**
  * Generates a companion module that re-exports a compiled dictionary with its
  * `nest()` targets attached.
@@ -40,7 +40,7 @@ declare const getNestedDictionaryPath: (dictionariesDir: string, key: string, ex
  * export default { ..._dictionary, nestedDictionaries: { 'common': _1a2b3c } };
  * ```
  */
-declare const generateNestedDictionaryEntryPoint: (key: string, nestedKeys: string[], format?: 'cjs' | 'esm') => string;
+export declare const generateNestedDictionaryEntryPoint: (key: string, nestedKeys: string[], format?: 'cjs' | 'esm') => string;
 /**
  * Writes one companion module per dictionary holding `nest()` references.
  *
@@ -48,7 +48,6 @@ declare const generateNestedDictionaryEntryPoint: (key: string, nestedKeys: stri
  * @param configuration - The resolved intlayer configuration.
  * @param formats - Module formats to emit.
  */
-declare const writeNestedDictionaries: (nestedDictionaryGraph: Map<string, Set<string>>, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[]) => Promise<void>;
+export declare const writeNestedDictionaries: (nestedDictionaryGraph: Map<string, Set<string>>, configuration: IntlayerConfig, formats?: ('cjs' | 'esm')[]) => Promise<void>;
 //#endregion
-export { NESTED_DICTIONARIES_SUBDIR, generateNestedDictionaryEntryPoint, getNestedDictionaryPath, writeNestedDictionaries };
 //# sourceMappingURL=writeNestedDictionary.d.ts.map

package/dist/types/buildIntlayerDictionary/writeNestedDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeNestedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeNestedDictionary.ts"],"mappings":";;;;;;;;cAgBa;;;;;;;;;;;;cAoBA,0BAAuB,yBACX,aACZ;;;;;;;;;;;;;;;;;;;;;;cA0BA,qCAAkC,aAClC,sBACS;;;;;;;;cAkDT,0BAAuB,uBACX,YAAY,cAAY,eAChC,gBAAc,gCAE5B"}
+{"version":3,"file":"writeNestedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeNestedDictionary.ts"],"mappings":";;;;;;;;qBAgBa;;;;;;;;;;;;qBAoBA,0BAAuB,yBACX,aACZ;;;;;;;;;;;;;;;;;;;;;;qBA0BA,qCAAkC,aAClC,sBACS;;;;;;;;qBAkDT,0BAAuB,uBACX,YAAY,cAAY,eAChC,gBAAc,gCAE5B"}

package/dist/types/buildIntlayerDictionary/writeRemoteDictionary.d.ts

@@ -1,11 +1,11 @@
 import { IntlayerConfig } from "@intlayer/types/config";
 import { Dictionary } from "@intlayer/types/dictionary";
 //#region src/buildIntlayerDictionary/writeRemoteDictionary.d.ts
-type RemoteDictionaryResult = {
+export type RemoteDictionaryResult = {
   dictionaryPath: string;
   dictionaries: Dictionary[];
 };
-type RemoteDictionaryOutput = Record<string, RemoteDictionaryResult>;
+export type RemoteDictionaryOutput = Record<string, RemoteDictionaryResult>;
 /**
  * Write the localized dictionaries to the dictionariesDir
  * @param mergedDictionaries - The merged dictionaries
@@ -22,7 +22,6 @@ type RemoteDictionaryOutput = Record<string, RemoteDictionaryResult>;
  * // { key: 'home', content: { ... } },
  * ```
  */
-declare const writeRemoteDictionary: (remoteDictionaries: Dictionary[], configuration: IntlayerConfig) => Promise<RemoteDictionaryOutput>;
+export declare const writeRemoteDictionary: (remoteDictionaries: Dictionary[], configuration: IntlayerConfig) => Promise<RemoteDictionaryOutput>;
 //#endregion
-export { RemoteDictionaryOutput, RemoteDictionaryResult, writeRemoteDictionary };
 //# sourceMappingURL=writeRemoteDictionary.d.ts.map

package/dist/types/buildIntlayerDictionary/writeRemoteDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeRemoteDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeRemoteDictionary.ts"],"mappings":";;;KAeY;EACV;EACA,cAAc;;KAGJ,yBAAyB,eAAe;;;;;;;;;;;;;;;;;cAkBvC,wBAAqB,oBACZ,cAAY,eACjB,mBACd,QAAQ"}
+{"version":3,"file":"writeRemoteDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeRemoteDictionary.ts"],"mappings":";;;YAeY;EACV;EACA,cAAc;;YAGJ,yBAAyB,eAAe;;;;;;;;;;;;;;;;;qBAkBvC,wBAAqB,oBACZ,cAAY,eACjB,mBACd,QAAQ"}

package/dist/types/buildIntlayerDictionary/writeUnmergedDictionary.d.ts

@@ -1,12 +1,12 @@
 import { IntlayerConfig } from "@intlayer/types/config";
 import { Dictionary, DictionaryKey } from "@intlayer/types/dictionary";
 //#region src/buildIntlayerDictionary/writeUnmergedDictionary.d.ts
-declare const groupDictionariesByKey: (dictionaries: Dictionary[]) => Record<string, Dictionary[]>;
-type UnmergedDictionaryResult = {
+export declare const groupDictionariesByKey: (dictionaries: Dictionary[]) => Record<string, Dictionary[]>;
+export type UnmergedDictionaryResult = {
   dictionaryPath: string;
   dictionaries: Dictionary[];
 };
-type UnmergedDictionaryOutput = Record<DictionaryKey, UnmergedDictionaryResult>;
+export type UnmergedDictionaryOutput = Record<DictionaryKey, UnmergedDictionaryResult>;
 /**
  * Write the unmerged dictionaries to the unmergedDictionariesDir
  * @param dictionaries - The dictionaries to write
@@ -27,7 +27,6 @@ type UnmergedDictionaryOutput = Record<DictionaryKey, UnmergedDictionaryResult>;
  * // }
  * ```
  */
-declare const writeUnmergedDictionaries: (dictionaries: Dictionary[], configuration: IntlayerConfig, env: 'prod' | 'dev') => Promise<UnmergedDictionaryOutput>;
+export declare const writeUnmergedDictionaries: (dictionaries: Dictionary[], configuration: IntlayerConfig, env: 'prod' | 'dev') => Promise<UnmergedDictionaryOutput>;
 //#endregion
-export { UnmergedDictionaryOutput, UnmergedDictionaryResult, groupDictionariesByKey, writeUnmergedDictionaries };
 //# sourceMappingURL=writeUnmergedDictionary.d.ts.map

package/dist/types/buildIntlayerDictionary/writeUnmergedDictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeUnmergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"mappings":";;;cAWa,yBAAsB,cACnB,iBACb,eAAe;KAaN;EACV;EACA,cAAc;;KAGJ,2BAA2B,OACrC,eACA;;;;;;;;;;;;;;;;;;;;;cAuBW,4BAAyB,cACtB,cAAY,eACX,gBAAc,wBAE5B,QAAQ"}
+{"version":3,"file":"writeUnmergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"mappings":";;;qBAWa,yBAAsB,cACnB,iBACb,eAAe;YAaN;EACV;EACA,cAAc;;YAGJ,2BAA2B,OACrC,eACA;;;;;;;;;;;;;;;;;;;;;qBAuBW,4BAAyB,cACtB,cAAY,eACX,gBAAc,wBAE5B,QAAQ"}

package/dist/types/cleanOutputDir.d.ts

@@ -1,6 +1,5 @@
 import { IntlayerConfig } from "@intlayer/types/config";
 //#region src/cleanOutputDir.d.ts
-declare const cleanOutputDir: (configuration: IntlayerConfig) => Promise<void>;
+export declare const cleanOutputDir: (configuration: IntlayerConfig) => Promise<void>;
 //#endregion
-export { cleanOutputDir };
 //# sourceMappingURL=cleanOutputDir.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cleanOutputDir.d.ts","names":[],"sources":["../../src/cleanOutputDir.ts"],"mappings":";;cAKa,iBAAc,eAAyB,mBAAc"}
+{"version":3,"file":"cleanOutputDir.d.ts","names":[],"sources":["../../src/cleanOutputDir.ts"],"mappings":";;qBAKa,iBAAc,eAAyB,mBAAc"}

package/dist/types/cleanRemovedContentDeclaration.d.ts

@@ -1,10 +1,9 @@
 import { IntlayerConfig } from "@intlayer/types/config";
 //#region src/cleanRemovedContentDeclaration.d.ts
-declare const cleanRemovedContentDeclaration: (filePath: string, keysToKeep: string[], configuration: IntlayerConfig) => Promise<{
+export declare const cleanRemovedContentDeclaration: (filePath: string, keysToKeep: string[], configuration: IntlayerConfig) => Promise<{
   changedDictionariesLocalIds: string[];
   excludeKeys: string[];
   hasRebuilt: boolean;
 }>;
 //#endregion
-export { cleanRemovedContentDeclaration };
 //# sourceMappingURL=cleanRemovedContentDeclaration.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cleanRemovedContentDeclaration.d.ts","names":[],"sources":["../../src/cleanRemovedContentDeclaration.ts"],"mappings":";;cAea,iCAA8B,kBACzB,sBACI,eACL,mBACd;EACD;EACA;EACA"}
+{"version":3,"file":"cleanRemovedContentDeclaration.d.ts","names":[],"sources":["../../src/cleanRemovedContentDeclaration.ts"],"mappings":";;qBAea,iCAA8B,kBACzB,sBACI,eACL,mBACd;EACD;EACA;EACA"}

package/dist/types/createDictionaryEntryPoint/createDictionaryEntryPoint.d.ts

@@ -1,12 +1,11 @@
 //#region src/createDictionaryEntryPoint/createDictionaryEntryPoint.d.ts
-type CreateDictionaryEntryPointOptions = {
+export type CreateDictionaryEntryPointOptions = {
   formats?: ('cjs' | 'esm')[];
   excludeKeys?: string[];
 };
 /**
  * This function generates a list of dictionaries in the main directory
  */
-declare const createDictionaryEntryPoint: (configuration?: import("@intlayer/types").IntlayerConfig, options?: CreateDictionaryEntryPointOptions) => Promise<void>;
+export declare const createDictionaryEntryPoint: (configuration?: import("@intlayer/types").IntlayerConfig, options?: CreateDictionaryEntryPointOptions) => Promise<void>;
 //#endregion
-export { CreateDictionaryEntryPointOptions, createDictionaryEntryPoint };
 //# sourceMappingURL=createDictionaryEntryPoint.d.ts.map