@intlayer/engine 9.0.0-canary.13 → 9.0.0-canary.15

package/dist/esm/prepareIntlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prepareIntlayer.mjs","names":[],"sources":["../../src/prepareIntlayer.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport packageJson from '@intlayer/config/package.json' with { type: 'json' };\nimport { cacheDisk } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { buildDictionary } from './buildIntlayerDictionary/buildIntlayerDictionary';\nimport { writeRemoteDictionary } from './buildIntlayerDictionary/writeRemoteDictionary';\nimport { cleanOutputDir } from './cleanOutputDir';\nimport { createDictionaryEntryPoint } from './createDictionaryEntryPoint/createDictionaryEntryPoint';\nimport { createModuleAugmentation, createTypes } from './createType/index';\nimport { listDictionariesWithStats } from './listDictionariesPath';\nimport { loadDictionaries } from './loadDictionaries/loadDictionaries';\nimport { runOnce } from './utils/runOnce';\nimport {\n  isCachedConfigurationUpToDate,\n  writeConfiguration,\n} from './writeConfiguration';\n\ntype PrepareIntlayerOptions = {\n  clean?: boolean;\n  env?: 'prod' | 'dev';\n  format?: ('cjs' | 'esm')[];\n  forceRun?: boolean;\n  cacheTimeoutMs?: number;\n  onIsCached?: () => void | Promise<void>;\n};\n\nconst DEFAULT_PREPARE_INTLAYER_OPTIONS = {\n  clean: false,\n  env: 'dev',\n  format: ['cjs', 'esm'],\n  cacheTimeoutMs: 1000 * 60 * 60, // 1 hour\n} satisfies PrepareIntlayerOptions;\n\nexport const prepareIntlayer = async (\n  configuration: IntlayerConfig,\n  options?: PrepareIntlayerOptions\n) => {\n  const appLogger = getAppLogger(configuration);\n\n  const sentinelPath = join(\n    configuration.system.cacheDir,\n    'intlayer-prepared.lock'\n  );\n  // Clean output dir if the intlayer version has changed\n  const versionCache = cacheDisk(configuration, ['intlayer-version']);\n  const intlayerCacheVersion = await versionCache.get();\n  const isCorrectVersion = Boolean(\n    intlayerCacheVersion && intlayerCacheVersion === packageJson.version\n  );\n\n  const isConfigSimilar = await isCachedConfigurationUpToDate(configuration);\n\n  // Check if any dictionary has been changed to force a new rebuild\n  const dictionariesWithStats = await listDictionariesWithStats(configuration);\n  let isDictionaryChanged = false;\n  try {\n    // Try catch as sentinel file may not exist yet\n    const sentinelStats = await stat(sentinelPath);\n    isDictionaryChanged = dictionariesWithStats.some(\n      (dictionary) =>\n        dictionary.stats.mtime.getTime() > sentinelStats.mtime.getTime()\n    );\n  } catch {}\n\n  const resolvedPlugins = await Promise.all(configuration.plugins ?? []);\n  const hasPluginLoadDictionaries = resolvedPlugins.some((plugin) =>\n    Boolean(plugin.loadDictionaries)\n  ); // Disable cache if any plugin because it can have custom behavior\n\n  const { clean, format, forceRun, onIsCached, cacheTimeoutMs, env } = {\n    ...DEFAULT_PREPARE_INTLAYER_OPTIONS,\n    forceRun:\n      !isCorrectVersion ||\n      !isConfigSimilar ||\n      isDictionaryChanged ||\n      hasPluginLoadDictionaries,\n    ...(options ?? {}),\n  };\n\n  // Skip preparation if it has already been done recently\n  await runOnce(\n    sentinelPath,\n    async () => {\n      // comment because of issue with next and webpack\n      // await checkVersionsConsistency(configuration);\n\n      if (clean || !isCorrectVersion) {\n        await cleanOutputDir(configuration);\n      }\n\n      await versionCache.set(packageJson.version);\n\n      const preparationStartMs = Date.now();\n\n      appLogger([\n        'Preparing Intlayer',\n        colorize(`(v${packageJson.version})`, ANSIColors.GREY_DARK),\n      ]);\n\n      await writeConfiguration(configuration);\n\n      const configurationWrittenTime = Date.now();\n\n      appLogger(\n        [\n          'Configuration written',\n          colorize(\n            `(${configurationWrittenTime - preparationStartMs}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      const contentDeclarationPaths = dictionariesWithStats.map(\n        (dictionary) => dictionary.path\n      );\n\n      const dictionaries = await loadDictionaries(\n        contentDeclarationPaths,\n        configuration\n      );\n\n      const dictionariesLoadedTime = Date.now();\n\n      appLogger(\n        [\n          'Content loaded',\n          colorize(\n            [\n              dictionaries.remoteDictionaries.length +\n                dictionaries.pluginDictionaries.length >\n              0\n                ? [\n                    `(Total: ${dictionariesLoadedTime - configurationWrittenTime}ms`,\n                    dictionaries.localDictionaries.length > 0\n                      ? ` - Local: ${dictionaries.time.localDictionaries}ms`\n                      : '',\n                    dictionaries.remoteDictionaries.length > 0\n                      ? ` - Remote: ${dictionaries.time.remoteDictionaries}ms`\n                      : '',\n                    dictionaries.pluginDictionaries.length > 0\n                      ? ` - Plugin: ${dictionaries.time.pluginDictionaries}ms`\n                      : '',\n                    `)`,\n                  ].join('')\n                : `(${dictionariesLoadedTime - configurationWrittenTime}ms)`,\n            ].join(''),\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Build local dictionaries\n      const dictionariesOutput = await buildDictionary(\n        [\n          ...dictionaries.localDictionaries,\n          ...dictionaries.remoteDictionaries,\n          ...dictionaries.pluginDictionaries,\n        ],\n        configuration,\n        { formats: format, importOtherDictionaries: false, env }\n      );\n\n      // Write remote dictionaries\n      // Used as cache for next fetch\n      await writeRemoteDictionary(\n        dictionaries.remoteDictionaries,\n        configuration\n      );\n\n      const dictionariesToBuild = Object.values(\n        dictionariesOutput?.mergedDictionaries ?? {}\n      ).map((dictionary) => dictionary.dictionary);\n\n      await createTypes(dictionariesToBuild, configuration);\n\n      await createDictionaryEntryPoint(configuration, {\n        formats: options?.format,\n      });\n\n      const dictionariesBuiltTime = Date.now();\n\n      appLogger([\n        'Dictionaries built',\n        colorize(\n          `(${dictionariesBuiltTime - preparationStartMs}ms)`,\n          ANSIColors.GREY_DARK\n        ),\n      ]);\n\n      await createModuleAugmentation(configuration);\n\n      const moduleAugmentationBuiltTime = Date.now();\n\n      appLogger(\n        [\n          'Module augmentation built',\n          colorize(\n            `(${moduleAugmentationBuiltTime - dictionariesBuiltTime}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Plugin transformation\n      // Allow plugins to post-process the final build output (e.g., write back ICU JSON)\n      for await (const plugin of configuration.plugins ?? []) {\n        const { unmergedDictionaries, mergedDictionaries } = dictionariesOutput;\n\n        await plugin.afterBuild?.({\n          dictionaries: {\n            unmergedDictionaries,\n            mergedDictionaries,\n          },\n          configuration,\n        });\n      }\n\n      const preparationElapsedMs = Date.now() - preparationStartMs;\n      appLogger(\n        [`Done`, colorize(`${preparationElapsedMs}ms`, ANSIColors.GREEN)],\n        {\n          level: 'info',\n          isVerbose: true,\n        }\n      );\n    },\n    {\n      forceRun,\n      onIsCached,\n      cacheTimeoutMs,\n    }\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"prepareIntlayer.mjs","names":[],"sources":["../../src/prepareIntlayer.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport packageJson from '@intlayer/config/package.json' with { type: 'json' };\nimport { cacheDisk } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { buildDictionary } from './buildIntlayerDictionary/buildIntlayerDictionary';\nimport { writeRemoteDictionary } from './buildIntlayerDictionary/writeRemoteDictionary';\nimport { cleanOutputDir } from './cleanOutputDir';\nimport { createDictionaryEntryPoint } from './createDictionaryEntryPoint/createDictionaryEntryPoint';\nimport { createModuleAugmentation, createTypes } from './createType/index';\nimport { listDictionariesWithStats } from './listDictionariesPath';\nimport { loadDictionaries } from './loadDictionaries/loadDictionaries';\nimport { runOnce } from './utils/runOnce';\nimport {\n  isCachedConfigurationUpToDate,\n  writeConfiguration,\n} from './writeConfiguration';\n\ntype PrepareIntlayerOptions = {\n  clean?: boolean;\n  env?: 'prod' | 'dev';\n  format?: ('cjs' | 'esm')[];\n  forceRun?: boolean;\n  cacheTimeoutMs?: number;\n  onIsCached?: () => void | Promise<void>;\n};\n\nconst DEFAULT_PREPARE_INTLAYER_OPTIONS = {\n  clean: false,\n  env: 'dev',\n  format: ['cjs', 'esm'],\n  cacheTimeoutMs: 1000 * 60 * 60, // 1 hour\n} satisfies PrepareIntlayerOptions;\n\nexport const prepareIntlayer = async (\n  configuration: IntlayerConfig,\n  options?: PrepareIntlayerOptions\n) => {\n  const appLogger = getAppLogger(configuration);\n\n  const sentinelPath = join(\n    configuration.system.cacheDir,\n    'intlayer-prepared.lock'\n  );\n  // Clean output dir if the intlayer version has changed\n  const versionCache = cacheDisk(configuration, ['intlayer-version']);\n  const intlayerCacheVersion = await versionCache.get();\n  const isCorrectVersion = Boolean(\n    intlayerCacheVersion && intlayerCacheVersion === packageJson.version\n  );\n\n  const isConfigSimilar = await isCachedConfigurationUpToDate(configuration);\n\n  // Check if any dictionary has been changed to force a new rebuild\n  const dictionariesWithStats = await listDictionariesWithStats(configuration);\n  let isDictionaryChanged = false;\n  try {\n    // Try catch as sentinel file may not exist yet\n    const sentinelStats = await stat(sentinelPath);\n    isDictionaryChanged = dictionariesWithStats.some(\n      (dictionary) =>\n        dictionary.stats.mtime.getTime() > sentinelStats.mtime.getTime()\n    );\n  } catch {}\n\n  const resolvedPlugins = await Promise.all(configuration.plugins ?? []);\n  const hasPluginLoadDictionaries = resolvedPlugins.some((plugin) =>\n    Boolean(plugin.loadDictionaries)\n  ); // Disable cache if any plugin because it can have custom behavior\n\n  const { clean, format, forceRun, onIsCached, cacheTimeoutMs, env } = {\n    ...DEFAULT_PREPARE_INTLAYER_OPTIONS,\n    forceRun:\n      !isCorrectVersion ||\n      !isConfigSimilar ||\n      isDictionaryChanged ||\n      hasPluginLoadDictionaries,\n    ...(options ?? {}),\n  };\n\n  // Skip preparation if it has already been done recently\n  await runOnce(\n    sentinelPath,\n    async () => {\n      // comment because of issue with next and webpack\n      // await checkVersionsConsistency(configuration);\n\n      if (clean || !isCorrectVersion) {\n        await cleanOutputDir(configuration);\n      }\n\n      await versionCache.set(packageJson.version);\n\n      const preparationStartMs = Date.now();\n\n      appLogger([\n        'Preparing Intlayer',\n        colorize(`(v${packageJson.version})`, ANSIColors.GREY_DARK),\n      ]);\n\n      await writeConfiguration(configuration);\n\n      const configurationWrittenTime = Date.now();\n\n      appLogger(\n        [\n          'Configuration written',\n          colorize(\n            `(${configurationWrittenTime - preparationStartMs}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      const contentDeclarationPaths = dictionariesWithStats.map(\n        (dictionary) => dictionary.path\n      );\n\n      const dictionaries = await loadDictionaries(\n        contentDeclarationPaths,\n        configuration\n      );\n\n      const dictionariesLoadedTime = Date.now();\n\n      appLogger(\n        [\n          'Content loaded',\n          colorize(\n            [\n              dictionaries.remoteDictionaries.length +\n                dictionaries.pluginDictionaries.length >\n              0\n                ? [\n                    `(Total: ${dictionariesLoadedTime - configurationWrittenTime}ms`,\n                    dictionaries.localDictionaries.length > 0\n                      ? ` - Local: ${dictionaries.time.localDictionaries}ms`\n                      : '',\n                    dictionaries.remoteDictionaries.length > 0\n                      ? ` - Remote: ${dictionaries.time.remoteDictionaries}ms`\n                      : '',\n                    dictionaries.pluginDictionaries.length > 0\n                      ? ` - Plugin: ${dictionaries.time.pluginDictionaries}ms`\n                      : '',\n                    `)`,\n                  ].join('')\n                : `(${dictionariesLoadedTime - configurationWrittenTime}ms)`,\n            ].join(''),\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Build local dictionaries\n      const dictionariesOutput = await buildDictionary(\n        [\n          ...dictionaries.localDictionaries,\n          ...dictionaries.remoteDictionaries,\n          ...dictionaries.pluginDictionaries,\n        ],\n        configuration,\n        { formats: format, importOtherDictionaries: false, env }\n      );\n\n      // Write remote dictionaries\n      // Used as cache for next fetch\n      await writeRemoteDictionary(\n        dictionaries.remoteDictionaries,\n        configuration\n      );\n\n      const dictionariesToBuild = Object.values(\n        dictionariesOutput?.mergedDictionaries ?? {}\n      ).map((dictionary) => dictionary.dictionary);\n\n      await createTypes(dictionariesToBuild, configuration);\n\n      await createDictionaryEntryPoint(configuration, {\n        formats: options?.format,\n      });\n\n      const dictionariesBuiltTime = Date.now();\n\n      appLogger([\n        'Dictionaries built',\n        colorize(\n          `(${dictionariesBuiltTime - preparationStartMs}ms)`,\n          ANSIColors.GREY_DARK\n        ),\n      ]);\n\n      await createModuleAugmentation(configuration);\n\n      const moduleAugmentationBuiltTime = Date.now();\n\n      appLogger(\n        [\n          'Module augmentation built',\n          colorize(\n            `(${moduleAugmentationBuiltTime - dictionariesBuiltTime}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Plugin transformation\n      // Allow plugins to post-process the final build output (e.g., write back ICU JSON)\n      for await (const plugin of configuration.plugins ?? []) {\n        const { unmergedDictionaries, mergedDictionaries } = dictionariesOutput;\n\n        try {\n          await plugin.afterBuild?.({\n            dictionaries: {\n              unmergedDictionaries,\n              mergedDictionaries,\n            },\n            configuration,\n          });\n        } catch (error) {\n          // A failing write-back (e.g. transient network error on a remote\n          // target) must not invalidate the dictionaries already built.\n          appLogger(\n            [\n              `Plugin ${plugin.name} afterBuild failed:`,\n              (error as Error).message,\n            ],\n            { level: 'error' }\n          );\n        }\n      }\n\n      const preparationElapsedMs = Date.now() - preparationStartMs;\n      appLogger(\n        [`Done`, colorize(`${preparationElapsedMs}ms`, ANSIColors.GREEN)],\n        {\n          level: 'info',\n          isVerbose: true,\n        }\n      );\n    },\n    {\n      forceRun,\n      onIsCached,\n      cacheTimeoutMs,\n    }\n  );\n};\n"],"mappings":"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"}

package/dist/esm/syncPluginKit/createFileAdapter.mjs

@@ -0,0 +1,115 @@
+import { writeFileIfChanged } from "../writeFileIfChanged.mjs";
+import { extractKeyAndLocaleFromPath } from "./extractKeyAndLocaleFromPath.mjs";
+import { buildFilePathPatternContext } from "./filePathPatternHelpers.mjs";
+import { mkdir, readFile } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+import fg from "fast-glob";
+import { parseFilePathPattern } from "@intlayer/config/utils";
+
+//#region src/syncPluginKit/createFileAdapter.ts
+/**
+* Create a filesystem {@link ContentAdapter} for `createSyncPlugin`.
+*
+* Handles glob discovery of the source pattern, key/locale extraction from
+* paths, base-directory resolution, and change-detected atomic writes.
+*/
+const createFileAdapter = (options) => {
+	const { source, codec, discovery = "strict" } = options;
+	const readEntry = options.readEntry ?? createFileReader(codec.parse);
+	let patternMarkerPromise;
+	/**
+	* Source pattern with `{{key}}` / `{{locale}}` markers kept verbatim,
+	* memoized because pattern functions can be asynchronous.
+	*/
+	const getPatternMarker = () => {
+		patternMarkerPromise ??= parseFilePathPattern(source, buildFilePathPatternContext("{{key}}", "{{locale}}"));
+		return patternMarkerPromise;
+	};
+	const listMessages = async (context) => {
+		const { system, internationalization } = context.configuration;
+		const { baseDir } = system;
+		const { locales } = internationalization;
+		const result = {};
+		for (const locale of locales) {
+			const globPatternLocale = await parseFilePathPattern(source, buildFilePathPatternContext("**", locale));
+			const maskPatternLocale = await parseFilePathPattern(source, buildFilePathPatternContext("{{__KEY__}}", locale));
+			if (!globPatternLocale || !maskPatternLocale) continue;
+			const files = await fg(globPatternLocale.startsWith("./") ? globPatternLocale.slice(2) : globPatternLocale, { cwd: baseDir });
+			const hasLocaleInMask = maskPatternLocale.includes("{{__LOCALE__}}");
+			const hasKeyInMask = maskPatternLocale.includes("{{__KEY__}}");
+			for (const file of files) {
+				let key;
+				let extractedLocale;
+				if (hasLocaleInMask || hasKeyInMask) {
+					const extraction = extractKeyAndLocaleFromPath(file, maskPatternLocale, locales, locale);
+					if (!extraction) continue;
+					key = extraction.key;
+					extractedLocale = extraction.locale;
+				} else if (discovery === "inclusive") {
+					key = "index";
+					extractedLocale = locale;
+				} else continue;
+				const absoluteFoundPath = isAbsolute(file) ? file : resolve(baseDir, file);
+				if (discovery === "strict") {
+					const expectedPath = await parseFilePathPattern(source, buildFilePathPatternContext(key, extractedLocale));
+					if (absoluteFoundPath !== (isAbsolute(expectedPath) ? expectedPath : resolve(baseDir, expectedPath))) continue;
+				}
+				result[extractedLocale] ??= {};
+				result[extractedLocale][key] = absoluteFoundPath;
+			}
+		}
+		if (discovery === "inclusive") return result;
+		const hasKeyInMask = (await parseFilePathPattern(source, buildFilePathPatternContext("{{__KEY__}}", locales[0]))).includes("{{__KEY__}}");
+		const discoveredKeys = /* @__PURE__ */ new Set();
+		for (const locale of Object.keys(result)) for (const key of Object.keys(result[locale] ?? {})) discoveredKeys.add(key);
+		if (!hasKeyInMask) discoveredKeys.add("index");
+		for (const locale of locales) {
+			result[locale] ??= {};
+			for (const key of discoveredKeys) if (!result[locale][key]) {
+				const builtPath = await parseFilePathPattern(source, buildFilePathPatternContext(key, locale));
+				result[locale][key] = isAbsolute(builtPath) ? builtPath : resolve(baseDir, builtPath);
+			}
+		}
+		return result;
+	};
+	return {
+		list: async (context) => {
+			const messages = await listMessages(context);
+			return Object.entries(messages).flatMap(([locale, keysRecord]) => Object.entries(keysRecord).map(([key, absoluteFilePath]) => ({
+				key,
+				locale,
+				uri: absoluteFilePath,
+				filePath: absoluteFilePath
+			})));
+		},
+		read: async (entry, context) => await readEntry(entry.uri, context),
+		write: async ({ key, locale }, content, { configuration }) => {
+			const builderPath = await parseFilePathPattern(source, buildFilePathPatternContext(key, locale));
+			const absoluteFilePath = resolve(configuration.system.baseDir, builderPath);
+			await mkdir(dirname(absoluteFilePath), { recursive: true });
+			await writeFileIfChanged(absoluteFilePath, codec.serialize(content, { locale }), { tempDir: configuration.system?.tempDir });
+		},
+		resolveUri: async ({ key, locale }, { configuration }) => {
+			const builderPath = await parseFilePathPattern(source, buildFilePathPatternContext(key, locale));
+			return resolve(configuration.system.baseDir, builderPath);
+		},
+		getFillPattern: async () => await getPatternMarker(),
+		describeSource: async () => await getPatternMarker(),
+		detectSplitKeys: async () => !(await getPatternMarker()).includes("{{key}}")
+	};
+};
+/**
+* Default `readEntry` implementation: plain utf-8 read followed by the given
+* parser. Returns `undefined` for missing or unreadable files.
+*/
+const createFileReader = (parse) => async (absoluteFilePath) => {
+	try {
+		return parse(await readFile(absoluteFilePath, "utf-8"));
+	} catch {
+		return;
+	}
+};
+
+//#endregion
+export { createFileAdapter, createFileReader };
+//# sourceMappingURL=createFileAdapter.mjs.map

package/dist/esm/syncPluginKit/createFileAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFileAdapter.mjs","names":[],"sources":["../../../src/syncPluginKit/createFileAdapter.ts"],"sourcesContent":["import { mkdir, readFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { FilePathPattern } from '@intlayer/types/filePathPattern';\nimport fg from 'fast-glob';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { extractKeyAndLocaleFromPath } from './extractKeyAndLocaleFromPath';\nimport { buildFilePathPatternContext } from './filePathPatternHelpers';\nimport type {\n  ContentAdapter,\n  ContentEntry,\n  FormatCodec,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/**\n * Discovery strategy of the file adapter:\n * - `strict`: keep only files whose path rebuilds identically from the source\n *   pattern, and fabricate entries for missing locales/keys so every declared\n *   locale has a write-back target (sync plugins).\n * - `inclusive`: keep every glob match without fabricating missing entries\n *   (read-only load plugins, whose patterns may contain free `**` globs).\n */\nexport type FileAdapterDiscovery = 'strict' | 'inclusive';\n\nexport type CreateFileAdapterOptions = {\n  /**\n   * Location of the files, as a static string, a templated string\n   * (e.g. `./messages/{{locale}}/{{key}}.json`) or a function building the\n   * path from the key and locale.\n   */\n  source: FilePathPattern;\n\n  /**\n   * Format of the files: string payload ↔ structured content.\n   */\n  codec: FormatCodec;\n\n  /**\n   * Optional override of how one file is read and parsed. Defaults to a plain\n   * utf-8 read followed by `codec.parse`, returning `undefined` for missing or\n   * unreadable files. Adapters needing richer loading (e.g. JSON5 or\n   * transpiled TS sources) provide their own implementation here.\n   */\n  readEntry?: (\n    absoluteFilePath: string,\n    context: SyncPluginContext\n  ) => Promise<SyncContent | undefined>;\n\n  /**\n   * Discovery strategy. Defaults to `'strict'`.\n   */\n  discovery?: FileAdapterDiscovery;\n};\n\ntype FilePath = string;\ntype MessagesRecord = Record<Locale, Record<string, FilePath>>;\n\n/**\n * Create a filesystem {@link ContentAdapter} for `createSyncPlugin`.\n *\n * Handles glob discovery of the source pattern, key/locale extraction from\n * paths, base-directory resolution, and change-detected atomic writes.\n */\nexport const createFileAdapter = (\n  options: CreateFileAdapterOptions\n): ContentAdapter => {\n  const { source, codec, discovery = 'strict' } = options;\n  const readEntry = options.readEntry ?? createFileReader(codec.parse);\n\n  let patternMarkerPromise: Promise<string> | undefined;\n\n  /**\n   * Source pattern with `{{key}}` / `{{locale}}` markers kept verbatim,\n   * memoized because pattern functions can be asynchronous.\n   */\n  const getPatternMarker = () => {\n    patternMarkerPromise ??= parseFilePathPattern(\n      source,\n      buildFilePathPatternContext('{{key}}', '{{locale}}')\n    );\n\n    return patternMarkerPromise;\n  };\n\n  const listMessages = async (\n    context: SyncPluginContext\n  ): Promise<MessagesRecord> => {\n    const { system, internationalization } = context.configuration;\n    const { baseDir } = system;\n    const { locales } = internationalization;\n\n    const result: MessagesRecord = {} as MessagesRecord;\n\n    for (const locale of locales) {\n      const globPatternLocale = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext('**', locale)\n      );\n\n      const maskPatternLocale = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext('{{__KEY__}}', locale)\n      );\n\n      if (!globPatternLocale || !maskPatternLocale) {\n        continue;\n      }\n\n      const normalizedGlobPattern = globPatternLocale.startsWith('./')\n        ? globPatternLocale.slice(2)\n        : globPatternLocale;\n\n      const files = await fg(normalizedGlobPattern, {\n        cwd: baseDir,\n      });\n\n      const hasLocaleInMask = maskPatternLocale.includes('{{__LOCALE__}}');\n      const hasKeyInMask = maskPatternLocale.includes('{{__KEY__}}');\n\n      for (const file of files) {\n        let key: string;\n        let extractedLocale: Locale;\n\n        if (hasLocaleInMask || hasKeyInMask) {\n          const extraction = extractKeyAndLocaleFromPath(\n            file,\n            maskPatternLocale,\n            locales,\n            locale\n          );\n\n          if (!extraction) {\n            continue;\n          }\n\n          key = extraction.key;\n          extractedLocale = extraction.locale;\n        } else if (discovery === 'inclusive') {\n          // Mask has no placeholders — the file was found via a concrete\n          // locale glob. Attribute it directly to the current loop locale.\n          key = 'index';\n          extractedLocale = locale;\n        } else {\n          // Strict mode relies on the fabrication step below to attribute\n          // placeholder-free sources to their canonical paths.\n          continue;\n        }\n\n        const absoluteFoundPath = isAbsolute(file)\n          ? file\n          : resolve(baseDir, file);\n\n        if (discovery === 'strict') {\n          // Rebuild what the path SHOULD be for this key/locale. A mismatch\n          // means the file belongs to another plugin/structure.\n          const expectedPath = await parseFilePathPattern(\n            source,\n            buildFilePathPatternContext(key, extractedLocale)\n          );\n\n          const absoluteExpectedPath = isAbsolute(expectedPath)\n            ? expectedPath\n            : resolve(baseDir, expectedPath);\n\n          if (absoluteFoundPath !== absoluteExpectedPath) {\n            continue;\n          }\n        }\n\n        result[extractedLocale] ??= {};\n        result[extractedLocale][key] = absoluteFoundPath;\n      }\n    }\n\n    if (discovery === 'inclusive') {\n      // Read-only mode only uses actual discovered files; do not fabricate\n      // missing locales or keys, since no outputs are written.\n      return result;\n    }\n\n    // Ensure all declared locales are present even if the file doesn't exist yet\n    const maskWithKey = await parseFilePathPattern(\n      source,\n      buildFilePathPatternContext('{{__KEY__}}', locales[0])\n    );\n\n    const hasKeyInMask = maskWithKey.includes('{{__KEY__}}');\n    const discoveredKeys = new Set<string>();\n\n    for (const locale of Object.keys(result) as Locale[]) {\n      for (const key of Object.keys(result[locale] ?? {})) {\n        discoveredKeys.add(key);\n      }\n    }\n\n    if (!hasKeyInMask) {\n      discoveredKeys.add('index');\n    }\n\n    for (const locale of locales) {\n      result[locale] ??= {};\n\n      for (const key of discoveredKeys) {\n        if (!result[locale][key]) {\n          const builtPath = await parseFilePathPattern(\n            source,\n            buildFilePathPatternContext(key, locale)\n          );\n\n          result[locale][key] = isAbsolute(builtPath)\n            ? builtPath\n            : resolve(baseDir, builtPath);\n        }\n      }\n    }\n\n    return result;\n  };\n\n  return {\n    list: async (context) => {\n      const messages = await listMessages(context);\n\n      const entries: ContentEntry[] = (\n        Object.entries(messages) as [Locale, Record<string, FilePath>][]\n      ).flatMap(([locale, keysRecord]) =>\n        Object.entries(keysRecord).map(([key, absoluteFilePath]) => ({\n          key,\n          locale,\n          uri: absoluteFilePath,\n          filePath: absoluteFilePath,\n        }))\n      );\n\n      return entries;\n    },\n\n    read: async (entry, context) => await readEntry(entry.uri, context),\n\n    write: async ({ key, locale }, content, { configuration }) => {\n      const builderPath = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext(key, locale)\n      );\n\n      const absoluteFilePath = resolve(\n        configuration.system.baseDir,\n        builderPath\n      );\n\n      await mkdir(dirname(absoluteFilePath), { recursive: true });\n\n      await writeFileIfChanged(\n        absoluteFilePath,\n        codec.serialize(content, { locale }),\n        { tempDir: configuration.system?.tempDir }\n      );\n    },\n\n    resolveUri: async ({ key, locale }, { configuration }) => {\n      const builderPath = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext(key, locale)\n      );\n\n      return resolve(configuration.system.baseDir, builderPath);\n    },\n\n    getFillPattern: async () => await getPatternMarker(),\n\n    describeSource: async () => await getPatternMarker(),\n\n    detectSplitKeys: async () =>\n      !(await getPatternMarker()).includes('{{key}}'),\n  };\n};\n\n/**\n * Default `readEntry` implementation: plain utf-8 read followed by the given\n * parser. Returns `undefined` for missing or unreadable files.\n */\nexport const createFileReader =\n  (parse: (raw: string) => SyncContent) =>\n  async (absoluteFilePath: string): Promise<SyncContent | undefined> => {\n    try {\n      const raw = await readFile(absoluteFilePath, 'utf-8');\n\n      return parse(raw);\n    } catch {\n      return undefined;\n    }\n  };\n"],"mappings":"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"}

package/dist/esm/syncPluginKit/createSyncPlugin.mjs

@@ -0,0 +1,152 @@
+import { relative, resolve } from "node:path";
+import { colorizePath, getAppLogger } from "@intlayer/config/logger";
+
+//#region src/syncPluginKit/createSyncPlugin.ts
+/**
+* Content that carries nothing to persist: `undefined`, `null`, or an object
+* without any own key. Writing it back would erase the target.
+*/
+const isEmptyContent = (content) => typeof content === "undefined" || content === null || typeof content === "object" && Object.keys(content).length === 0;
+/**
+* Deep-clone formatted output into plain JSON data, stripping prototypes and
+* non-serializable values before the emptiness check and the write.
+*/
+const toPlainContent = (content) => typeof content === "undefined" ? void 0 : JSON.parse(JSON.stringify(content));
+/**
+* Build an Intlayer {@link Plugin} from a transport adapter.
+*
+* The factory implements the three plugin hooks once — ingestion
+* (`loadDictionaries`), content-declaration reformatting (`formatOutput`) and
+* write-back (`afterBuild`) — so adapters only describe *where* content lives
+* (filesystem, TMS such as Crowdin, extra CMS…) and codecs only describe the
+* payload format. Write-back only processes dictionaries whose `location`
+* matches this plugin instance, so adapters never see foreign content.
+*/
+const createSyncPlugin = (options) => {
+	const { name, adapter, direction = "both", location, priority = 0, format, localeOverride } = options;
+	let splitKeysPromise;
+	/**
+	* `splitKeys` resolution is asynchronous (adapter auto-detection may parse
+	* an async source pattern), so it is resolved lazily and memoized.
+	*/
+	const resolveSplitKeys = () => {
+		splitKeysPromise ??= (async () => options.splitKeys ?? await adapter.detectSplitKeys?.() ?? false)();
+		return splitKeysPromise;
+	};
+	const loadDictionaries = async ({ configuration }) => {
+		const context = { configuration };
+		const appLogger = getAppLogger(configuration);
+		const entries = await adapter.list(context);
+		if (entries.length === 0) appLogger(`[${name}] No dictionaries found at locations matching source pattern: ${colorizePath(await adapter.describeSource?.(context) ?? name)}`, { level: "warn" });
+		const shouldSplitByKeys = await resolveSplitKeys();
+		const { baseDir } = configuration.system;
+		const { defaultLocale } = configuration.internationalization;
+		let patternFill;
+		if (direction === "both" && adapter.getFillPattern) patternFill = relative(baseDir, resolve(baseDir, await adapter.getFillPattern(context)));
+		const dictionaries = [];
+		for (const entry of entries) {
+			const content = await adapter.read(entry, context) ?? {};
+			const relativeFilePath = entry.filePath ? relative(baseDir, entry.filePath) : void 0;
+			const usedLocale = localeOverride ?? entry.locale;
+			const filled = usedLocale !== defaultLocale ? true : void 0;
+			const fill = patternFill ?? relativeFilePath;
+			const identifier = relativeFilePath ?? entry.uri;
+			if (shouldSplitByKeys) {
+				for (const [namespaceKey, namespaceContent] of Object.entries(content)) dictionaries.push({
+					key: namespaceKey,
+					locale: usedLocale,
+					fill,
+					format,
+					localId: `${namespaceKey}::${location}::${identifier}`,
+					location,
+					filled,
+					content: namespaceContent,
+					filePath: relativeFilePath,
+					priority
+				});
+				continue;
+			}
+			dictionaries.push({
+				key: entry.key,
+				locale: usedLocale,
+				fill,
+				format,
+				localId: `${entry.key}::${location}::${identifier}`,
+				location,
+				filled,
+				content,
+				filePath: relativeFilePath,
+				priority
+			});
+		}
+		return dictionaries;
+	};
+	if (direction === "pull") return {
+		name,
+		loadDictionaries
+	};
+	const formatOutput = async ({ dictionary, configuration }) => {
+		if (!dictionary.filePath || !dictionary.locale) return dictionary;
+		if (await resolveSplitKeys()) return dictionary;
+		if (!adapter.resolveUri) return dictionary;
+		const canonicalUri = await adapter.resolveUri({
+			key: dictionary.key,
+			locale: dictionary.locale
+		}, { configuration });
+		const { baseDir } = configuration.system;
+		if (resolve(baseDir, canonicalUri) !== resolve(baseDir, dictionary.filePath)) return dictionary;
+		const { formatDictionaryOutput } = await import("../formatDictionary.mjs");
+		return formatDictionaryOutput(dictionary, format).content;
+	};
+	const afterBuild = async ({ dictionaries, configuration }) => {
+		const { getPerLocaleDictionary } = await import("@intlayer/core/plugins");
+		const { formatDictionaryOutput } = await import("../formatDictionary.mjs");
+		const { parallelize } = await import("../utils/parallelize.mjs");
+		const context = { configuration };
+		const { locales } = configuration.internationalization;
+		const ownedDictionaries = Object.entries(dictionaries.mergedDictionaries).map(([key, result]) => ({
+			key,
+			dictionary: result.dictionary
+		})).filter(({ dictionary }) => dictionary.location === location);
+		if (await resolveSplitKeys()) {
+			const mergedContentByLocale = {};
+			const writeKeyByLocale = {};
+			for (const { key, dictionary } of ownedDictionaries) for (const locale of locales) {
+				const content = toPlainContent(formatDictionaryOutput(getPerLocaleDictionary(dictionary, locale), format).content);
+				if (isEmptyContent(content)) continue;
+				mergedContentByLocale[locale] ??= {};
+				mergedContentByLocale[locale][key] = content;
+				writeKeyByLocale[locale] = key;
+			}
+			await parallelize(Object.keys(mergedContentByLocale), async (locale) => {
+				await adapter.write({
+					key: writeKeyByLocale[locale],
+					locale
+				}, mergedContentByLocale[locale], context);
+			});
+			return;
+		}
+		await parallelize(ownedDictionaries.flatMap(({ key, dictionary }) => locales.map((locale) => ({
+			key,
+			dictionary,
+			locale
+		}))), async ({ key, dictionary, locale }) => {
+			const content = toPlainContent(formatDictionaryOutput(getPerLocaleDictionary(dictionary, locale), format).content);
+			if (isEmptyContent(content)) return;
+			await adapter.write({
+				key,
+				locale
+			}, content, context);
+		});
+	};
+	return {
+		name,
+		loadDictionaries,
+		formatOutput,
+		afterBuild
+	};
+};
+
+//#endregion
+export { createSyncPlugin };
+//# sourceMappingURL=createSyncPlugin.mjs.map

package/dist/esm/syncPluginKit/createSyncPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSyncPlugin.mjs","names":[],"sources":["../../../src/syncPluginKit/createSyncPlugin.ts"],"sourcesContent":["import { relative, resolve } from 'node:path';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { Dictionary, LocalDictionaryId } from '@intlayer/types/dictionary';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport type {\n  CreateSyncPluginOptions,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/**\n * Content that carries nothing to persist: `undefined`, `null`, or an object\n * without any own key. Writing it back would erase the target.\n */\nconst isEmptyContent = (content: unknown): boolean =>\n  typeof content === 'undefined' ||\n  content === null ||\n  (typeof content === 'object' && Object.keys(content).length === 0);\n\n/**\n * Deep-clone formatted output into plain JSON data, stripping prototypes and\n * non-serializable values before the emptiness check and the write.\n */\nconst toPlainContent = (content: unknown): unknown =>\n  typeof content === 'undefined'\n    ? undefined\n    : JSON.parse(JSON.stringify(content));\n\n/**\n * Build an Intlayer {@link Plugin} from a transport adapter.\n *\n * The factory implements the three plugin hooks once — ingestion\n * (`loadDictionaries`), content-declaration reformatting (`formatOutput`) and\n * write-back (`afterBuild`) — so adapters only describe *where* content lives\n * (filesystem, TMS such as Crowdin, extra CMS…) and codecs only describe the\n * payload format. Write-back only processes dictionaries whose `location`\n * matches this plugin instance, so adapters never see foreign content.\n */\nexport const createSyncPlugin = (options: CreateSyncPluginOptions): Plugin => {\n  const {\n    name,\n    adapter,\n    direction = 'both',\n    location,\n    priority = 0,\n    format,\n    localeOverride,\n  } = options;\n\n  let splitKeysPromise: Promise<boolean> | undefined;\n\n  /**\n   * `splitKeys` resolution is asynchronous (adapter auto-detection may parse\n   * an async source pattern), so it is resolved lazily and memoized.\n   */\n  const resolveSplitKeys = (): Promise<boolean> => {\n    splitKeysPromise ??= (async () =>\n      options.splitKeys ?? (await adapter.detectSplitKeys?.()) ?? false)();\n\n    return splitKeysPromise;\n  };\n\n  const loadDictionaries: Plugin['loadDictionaries'] = async ({\n    configuration,\n  }) => {\n    const context: SyncPluginContext = { configuration };\n    const appLogger = getAppLogger(configuration);\n\n    const entries = await adapter.list(context);\n\n    if (entries.length === 0) {\n      const sourceDescription =\n        (await adapter.describeSource?.(context)) ?? name;\n\n      appLogger(\n        `[${name}] No dictionaries found at locations matching source pattern: ${colorizePath(sourceDescription)}`,\n        { level: 'warn' }\n      );\n    }\n\n    const shouldSplitByKeys = await resolveSplitKeys();\n    const { baseDir } = configuration.system;\n    const { defaultLocale } = configuration.internationalization;\n\n    // Sync plugins advertise the source pattern (with {{key}}/{{locale}}\n    // markers) as fill target; pull-only plugins fill each entry in place.\n    let patternFill: string | undefined;\n\n    if (direction === 'both' && adapter.getFillPattern) {\n      const fillPattern = await adapter.getFillPattern(context);\n      patternFill = relative(baseDir, resolve(baseDir, fillPattern));\n    }\n\n    const dictionaries: Dictionary[] = [];\n\n    for (const entry of entries) {\n      const content = (await adapter.read(entry, context)) ?? {};\n\n      const relativeFilePath = entry.filePath\n        ? relative(baseDir, entry.filePath)\n        : undefined;\n\n      const usedLocale = (localeOverride ?? entry.locale) as Locale;\n      const filled = usedLocale !== defaultLocale ? true : undefined;\n      const fill = patternFill ?? relativeFilePath;\n      const identifier = relativeFilePath ?? entry.uri;\n\n      // One entry groups several namespaces by its first-level keys: emit one\n      // dictionary per top-level key (e.g. `Hero`, `Nav`, …).\n      if (shouldSplitByKeys) {\n        for (const [namespaceKey, namespaceContent] of Object.entries(\n          content\n        )) {\n          dictionaries.push({\n            key: namespaceKey,\n            locale: usedLocale,\n            fill,\n            format,\n            localId:\n              `${namespaceKey}::${location}::${identifier}` as LocalDictionaryId,\n            location: location as Dictionary['location'],\n            filled,\n            content: namespaceContent as SyncContent,\n            filePath: relativeFilePath,\n            priority,\n          } as Dictionary);\n        }\n        continue;\n      }\n\n      dictionaries.push({\n        key: entry.key,\n        locale: usedLocale,\n        fill,\n        format,\n        localId:\n          `${entry.key}::${location}::${identifier}` as LocalDictionaryId,\n        location: location as Dictionary['location'],\n        filled,\n        content,\n        filePath: relativeFilePath,\n        priority,\n      } as Dictionary);\n    }\n\n    return dictionaries;\n  };\n\n  if (direction === 'pull') {\n    return { name, loadDictionaries };\n  }\n\n  const formatOutput: Plugin['formatOutput'] = async ({\n    dictionary,\n    configuration,\n  }) => {\n    if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n    // In split mode several namespaces share the same target; the target is\n    // re-assembled in `afterBuild`. Skip here to avoid overwriting the whole\n    // target with a single namespace.\n    if (await resolveSplitKeys()) return dictionary;\n\n    // Ownership check: only reformat declarations this adapter can identify\n    // as its own canonical target.\n    if (!adapter.resolveUri) return dictionary;\n\n    const canonicalUri = await adapter.resolveUri(\n      { key: dictionary.key, locale: dictionary.locale as Locale },\n      { configuration }\n    );\n\n    const { baseDir } = configuration.system;\n\n    if (\n      resolve(baseDir, canonicalUri) !== resolve(baseDir, dictionary.filePath)\n    ) {\n      return dictionary;\n    }\n\n    // Lazy import to keep the module graph light when configs are transpiled\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n\n    return formatDictionaryOutput(dictionary as Dictionary, format).content;\n  };\n\n  const afterBuild: Plugin['afterBuild'] = async ({\n    dictionaries,\n    configuration,\n  }) => {\n    // Lazy imports to keep the module graph light when configs are transpiled\n    const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n    const { parallelize } = await import('../utils/parallelize');\n\n    const context: SyncPluginContext = { configuration };\n    const { locales } = configuration.internationalization;\n\n    // Only ever hand the adapter dictionaries owned by THIS plugin instance.\n    const ownedDictionaries = Object.entries(dictionaries.mergedDictionaries)\n      .map(([key, result]) => ({\n        key,\n        dictionary: result.dictionary as Dictionary,\n      }))\n      .filter(({ dictionary }) => dictionary.location === location);\n\n    if (await resolveSplitKeys()) {\n      // Split mode: every namespace dictionary writes back into the same\n      // per-locale target. Re-assemble them under their top-level key and\n      // write each target once, instead of one write per key (which would\n      // overwrite).\n      const mergedContentByLocale = {} as Record<Locale, SyncContent>;\n      const writeKeyByLocale = {} as Record<Locale, string>;\n\n      for (const { key, dictionary } of ownedDictionaries) {\n        for (const locale of locales) {\n          const localizedDictionary = getPerLocaleDictionary(\n            dictionary,\n            locale\n          );\n\n          const formattedOutput = formatDictionaryOutput(\n            localizedDictionary,\n            format\n          );\n\n          const content = toPlainContent(formattedOutput.content);\n\n          if (isEmptyContent(content)) continue;\n\n          mergedContentByLocale[locale] ??= {};\n          mergedContentByLocale[locale][key] = content;\n          writeKeyByLocale[locale] = key;\n        }\n      }\n\n      await parallelize(\n        Object.keys(mergedContentByLocale) as Locale[],\n        async (locale) => {\n          await adapter.write(\n            { key: writeKeyByLocale[locale], locale },\n            mergedContentByLocale[locale],\n            context\n          );\n        }\n      );\n\n      return;\n    }\n\n    const writeTasks = ownedDictionaries.flatMap(({ key, dictionary }) =>\n      locales.map((locale) => ({ key, dictionary, locale }))\n    );\n\n    await parallelize(writeTasks, async ({ key, dictionary, locale }) => {\n      const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n      const formattedOutput = formatDictionaryOutput(\n        localizedDictionary,\n        format\n      );\n\n      const content = toPlainContent(formattedOutput.content);\n\n      if (isEmptyContent(content)) return;\n\n      await adapter.write({ key, locale }, content as SyncContent, context);\n    });\n  };\n\n  return { name, loadDictionaries, formatOutput, afterBuild };\n};\n"],"mappings":"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"}

package/dist/esm/syncPluginKit/extractKeyAndLocaleFromPath.mjs

@@ -0,0 +1,35 @@
+//#region src/syncPluginKit/extractKeyAndLocaleFromPath.ts
+const escapeRegex = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+* Extract the dictionary key and locale of a file path by matching it against
+* a mask pattern where `{{__KEY__}}` and `{{__LOCALE__}}` mark the positions
+* of the key and locale segments.
+*
+* Returns `null` when the path does not match the mask, or when the mask
+* contains no placeholder at all (no named capture group can be produced).
+* Missing placeholders fall back to `'index'` for the key and to
+* `defaultLocale` for the locale.
+*/
+const extractKeyAndLocaleFromPath = (filePath, maskPattern, locales, defaultLocale) => {
+	const keyPlaceholder = "{{__KEY__}}";
+	const localePlaceholder = "{{__LOCALE__}}";
+	const normalize = (path) => path.startsWith("./") ? path.slice(2) : path;
+	const normalizedFilePath = normalize(filePath);
+	const normalizedMask = normalize(maskPattern);
+	const localesAlternation = locales.join("|");
+	let regexString = `^${escapeRegex(normalizedMask)}$`;
+	regexString = regexString.replace(/\\\*\\\*/g, ".*");
+	regexString = regexString.replace(/\\\*/g, "[^/]*");
+	regexString = regexString.replace(escapeRegex(localePlaceholder), `(?<locale>${localesAlternation})`);
+	if (normalizedMask.includes(keyPlaceholder)) regexString = regexString.replace(escapeRegex(keyPlaceholder), "(?<key>.+)");
+	const match = new RegExp(regexString).exec(normalizedFilePath);
+	if (!match?.groups) return null;
+	return {
+		key: match.groups.key ?? "index",
+		locale: match.groups.locale ?? defaultLocale
+	};
+};
+
+//#endregion
+export { extractKeyAndLocaleFromPath };
+//# sourceMappingURL=extractKeyAndLocaleFromPath.mjs.map

package/dist/esm/syncPluginKit/extractKeyAndLocaleFromPath.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractKeyAndLocaleFromPath.mjs","names":[],"sources":["../../../src/syncPluginKit/extractKeyAndLocaleFromPath.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\n\nconst escapeRegex = (text: string) =>\n  text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/**\n * Extract the dictionary key and locale of a file path by matching it against\n * a mask pattern where `{{__KEY__}}` and `{{__LOCALE__}}` mark the positions\n * of the key and locale segments.\n *\n * Returns `null` when the path does not match the mask, or when the mask\n * contains no placeholder at all (no named capture group can be produced).\n * Missing placeholders fall back to `'index'` for the key and to\n * `defaultLocale` for the locale.\n */\nexport const extractKeyAndLocaleFromPath = (\n  filePath: string,\n  maskPattern: string,\n  locales: Locale[],\n  defaultLocale: Locale\n): { key: string; locale: Locale } | null => {\n  const keyPlaceholder = '{{__KEY__}}';\n  const localePlaceholder = '{{__LOCALE__}}';\n\n  // fast-glob strips leading \"./\" from returned paths; normalize both sides\n  const normalize = (path: string) =>\n    path.startsWith('./') ? path.slice(2) : path;\n\n  const normalizedFilePath = normalize(filePath);\n  const normalizedMask = normalize(maskPattern);\n\n  const localesAlternation = locales.join('|');\n\n  // Escape special regex chars, then convert glob wildcards to regex equivalents.\n  // Must replace ** before * to avoid double-replacing.\n  let regexString = `^${escapeRegex(normalizedMask)}$`;\n  regexString = regexString.replace(/\\\\\\*\\\\\\*/g, '.*'); // ** → match any path segments\n  regexString = regexString.replace(/\\\\\\*/g, '[^/]*'); // * → match within a single segment\n\n  regexString = regexString.replace(\n    escapeRegex(localePlaceholder),\n    `(?<locale>${localesAlternation})`\n  );\n\n  if (normalizedMask.includes(keyPlaceholder)) {\n    regexString = regexString.replace(\n      escapeRegex(keyPlaceholder),\n      '(?<key>.+)'\n    );\n  }\n\n  const maskRegex = new RegExp(regexString);\n  const match = maskRegex.exec(normalizedFilePath);\n\n  if (!match?.groups) {\n    return null;\n  }\n\n  const key = (match.groups.key as string | undefined) ?? 'index';\n  const locale = (match.groups.locale as Locale | undefined) ?? defaultLocale;\n\n  return { key, locale };\n};\n"],"mappings":";AAEA,MAAM,eAAe,SACnB,KAAK,QAAQ,uBAAuB,OAAO;;;;;;;;;;;AAY7C,MAAa,+BACX,UACA,aACA,SACA,kBAC2C;CAC3C,MAAM,iBAAiB;CACvB,MAAM,oBAAoB;CAG1B,MAAM,aAAa,SACjB,KAAK,WAAW,KAAK,GAAG,KAAK,MAAM,EAAE,GAAG;CAE1C,MAAM,qBAAqB,UAAU,SAAS;CAC9C,MAAM,iBAAiB,UAAU,YAAY;CAE7C,MAAM,qBAAqB,QAAQ,KAAK,IAAI;CAI5C,IAAI,cAAc,IAAI,YAAY,eAAe,CAAC;AAClD,eAAc,YAAY,QAAQ,aAAa,KAAK;AACpD,eAAc,YAAY,QAAQ,SAAS,QAAQ;AAEnD,eAAc,YAAY,QACxB,YAAY,kBAAkB,EAC9B,aAAa,mBAAmB,GACjC;AAED,KAAI,eAAe,SAAS,eAAe,CACzC,eAAc,YAAY,QACxB,YAAY,eAAe,EAC3B,aACD;CAIH,MAAM,QAAQ,IADQ,OAAO,YACN,CAAC,KAAK,mBAAmB;AAEhD,KAAI,CAAC,OAAO,OACV,QAAO;AAMT,QAAO;EAAE,KAHI,MAAM,OAAO,OAA8B;EAG1C,QAFE,MAAM,OAAO,UAAiC;EAExC"}

package/dist/esm/syncPluginKit/filePathPatternHelpers.mjs

@@ -0,0 +1,18 @@
+//#region src/syncPluginKit/filePathPatternHelpers.ts
+/**
+* Build the context handed to `parseFilePathPattern` from the only two
+* variables sync plugins resolve: the dictionary key and the locale.
+*
+* `FilePathPatternContext` declares extra fields (`fileName`, `extension`,
+* `format`…) that only apply to content-declaration paths; sync-plugin
+* patterns never reference them, so this single cast keeps the partial
+* context in one audited place instead of scattering `as any` at call sites.
+*/
+const buildFilePathPatternContext = (key, locale) => ({
+	key,
+	locale
+});
+
+//#endregion
+export { buildFilePathPatternContext };
+//# sourceMappingURL=filePathPatternHelpers.mjs.map

package/dist/esm/syncPluginKit/filePathPatternHelpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"filePathPatternHelpers.mjs","names":[],"sources":["../../../src/syncPluginKit/filePathPatternHelpers.ts"],"sourcesContent":["import type { FilePathPatternContext } from '@intlayer/types/filePathPattern';\n\n/**\n * Build the context handed to `parseFilePathPattern` from the only two\n * variables sync plugins resolve: the dictionary key and the locale.\n *\n * `FilePathPatternContext` declares extra fields (`fileName`, `extension`,\n * `format`…) that only apply to content-declaration paths; sync-plugin\n * patterns never reference them, so this single cast keeps the partial\n * context in one audited place instead of scattering `as any` at call sites.\n */\nexport const buildFilePathPatternContext = (\n  key: string,\n  locale?: string\n): FilePathPatternContext =>\n  ({\n    key,\n    locale,\n  }) as Partial<FilePathPatternContext> as FilePathPatternContext;\n"],"mappings":";;;;;;;;;;AAWA,MAAa,+BACX,KACA,YAEC;CACC;CACA;CACD"}

package/dist/esm/syncPluginKit/index.mjs

@@ -0,0 +1,6 @@
+import { createSyncPlugin } from "./createSyncPlugin.mjs";
+import { extractKeyAndLocaleFromPath } from "./extractKeyAndLocaleFromPath.mjs";
+import { buildFilePathPatternContext } from "./filePathPatternHelpers.mjs";
+import { createFileAdapter, createFileReader } from "./createFileAdapter.mjs";
+
+export { buildFilePathPatternContext, createFileAdapter, createFileReader, createSyncPlugin, extractKeyAndLocaleFromPath };

package/dist/esm/utils/runParallel/index.mjs

@@ -64,9 +64,9 @@ const runParallel = (proc) => {
 			}));
 		});
 	});
-	const kill = () => {
+	const kill = (signal = "SIGTERM") => {
 		try {
-			child.kill("SIGTERM");
+			child.kill(signal);
 		} catch {}
 	};
 	const handleExit = () => kill();

package/dist/esm/utils/runParallel/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/utils/runParallel/index.ts"],"sourcesContent":["import { delimiter, join } from 'node:path';\nimport { spawnPosix } from './spawnPosix';\nimport { spawnWin32 } from './spawnWin32';\n\nexport type ParallelHandle = {\n  kill: () => void;\n  result: Promise<any>;\n  commandText: string;\n};\n\n/**\n * Start a cross-platform parallel process using npm-run-all approach.\n * Accepts either a single string (e.g., 'next start') or an array of tokens (e.g., ['next', 'start']).\n */\nexport const runParallel = (proc?: string | string[]): ParallelHandle => {\n  if (!proc || (Array.isArray(proc) && proc.length === 0))\n    throw new Error('Invalid command');\n\n  const commandText = Array.isArray(proc) ? proc.join(' ') : proc;\n\n  const isArray = Array.isArray(proc);\n  const command = isArray ? (proc as string[])[0] : commandText;\n  const args = isArray ? (proc as string[]).slice(1) : [];\n\n  // Ensure local binaries (node_modules/.bin) are resolvable\n  const cwdBin = join(process.cwd(), 'node_modules', '.bin');\n  const PATH_KEY =\n    Object.keys(process.env).find((key) => key.toLowerCase() === 'path') ??\n    'PATH';\n\n  const extendedPath = [cwdBin, process.env[PATH_KEY] ?? '']\n    .filter(Boolean)\n    .join(delimiter);\n\n  const childEnv = {\n    ...process.env,\n    [PATH_KEY]: extendedPath,\n  } as NodeJS.ProcessEnv;\n\n  const isWin = process.platform === 'win32';\n  const spawnFunc = isWin ? spawnWin32 : spawnPosix;\n\n  // Spawn options\n  const spawnOptions = {\n    cwd: process.cwd(),\n    stdio: 'inherit' as const,\n    env: childEnv,\n    shell: isWin,\n  };\n\n  // Spawn the child process\n  const child = isArray\n    ? // If provided as a single string element that includes spaces, treat it like a shell command\n      args.length === 0 && /\\s/.test(command)\n      ? isWin\n        ? spawnFunc(\n            process.env.ComSpec ?? 'cmd.exe',\n            ['/d', '/s', '/c', command],\n            spawnOptions\n          )\n        : spawnFunc(\n            process.env.SHELL ?? '/bin/sh',\n            ['-c', command],\n            spawnOptions\n          )\n      : spawnFunc(command, args, spawnOptions)\n    : isWin\n      ? spawnFunc(\n          process.env.ComSpec ?? 'cmd.exe',\n          ['/d', '/s', '/c', commandText],\n          spawnOptions\n        )\n      : spawnFunc(\n          process.env.SHELL ?? '/bin/sh',\n          ['-c', commandText],\n          spawnOptions\n        );\n\n  const result = new Promise<void>((resolve, reject) => {\n    child.on('error', (err) => {\n      try {\n        console.error(\n          `[runParallel] Failed to start: ${err?.message ?? String(err)}`\n        );\n      } catch {}\n      reject(err);\n    });\n\n    child.on('exit', (code, signal) => {\n      // Treat common termination signals as graceful exits, not failures\n      const gracefulSignals = ['SIGINT', 'SIGTERM', 'SIGQUIT', 'SIGHUP'];\n      // Also treat shell-convention exit codes (128 + signal number) as graceful:\n      // 129 = SIGHUP, 130 = SIGINT, 131 = SIGQUIT, 143 = SIGTERM\n      const gracefulSignalCodes = new Set([129, 130, 131, 143]);\n      if (\n        code === 0 ||\n        gracefulSignalCodes.has(code ?? -1) ||\n        (signal && gracefulSignals.includes(signal))\n      ) {\n        resolve();\n      } else {\n        reject(\n          Object.assign(new Error('Parallel process failed'), { code, signal })\n        );\n      }\n    });\n  });\n\n  const kill = () => {\n    try {\n      child.kill('SIGTERM');\n    } catch {\n      // Best effort\n    }\n  };\n\n  const handleExit = () => kill();\n\n  const handleSigInt = () => {\n    kill();\n    process.off('SIGINT', handleSigInt);\n    process.kill(process.pid, 'SIGINT'); // Propagate to allow natural shutdown\n  };\n\n  const handleSigTerm = () => {\n    kill();\n    process.off('SIGTERM', handleSigTerm);\n    process.kill(process.pid, 'SIGTERM'); // Propagate to allow natural shutdown\n  };\n\n  process.on('exit', handleExit);\n  process.on('SIGINT', handleSigInt);\n  process.on('SIGTERM', handleSigTerm);\n\n  child.on('exit', () => {\n    process.off('exit', handleExit);\n    process.off('SIGINT', handleSigInt);\n    process.off('SIGTERM', handleSigTerm);\n  });\n\n  return { kill, result, commandText };\n};\n"],"mappings":";;;;;;;;;AAcA,MAAa,eAAe,SAA6C;AACvE,KAAI,CAAC,QAAS,MAAM,QAAQ,KAAK,IAAI,KAAK,WAAW,EACnD,OAAM,IAAI,MAAM,kBAAkB;CAEpC,MAAM,cAAc,MAAM,QAAQ,KAAK,GAAG,KAAK,KAAK,IAAI,GAAG;CAE3D,MAAM,UAAU,MAAM,QAAQ,KAAK;CACnC,MAAM,UAAU,UAAW,KAAkB,KAAK;CAClD,MAAM,OAAO,UAAW,KAAkB,MAAM,EAAE,GAAG,EAAE;CAGvD,MAAM,SAAS,KAAK,QAAQ,KAAK,EAAE,gBAAgB,OAAO;CAC1D,MAAM,WACJ,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,QAAQ,IAAI,aAAa,KAAK,OAAO,IACpE;CAEF,MAAM,eAAe,CAAC,QAAQ,QAAQ,IAAI,aAAa,GAAG,CACvD,OAAO,QAAQ,CACf,KAAK,UAAU;CAElB,MAAM,WAAW;EACf,GAAG,QAAQ;GACV,WAAW;EACb;CAED,MAAM,QAAQ,QAAQ,aAAa;CACnC,MAAM,YAAY,QAAQ,aAAa;CAGvC,MAAM,eAAe;EACnB,KAAK,QAAQ,KAAK;EAClB,OAAO;EACP,KAAK;EACL,OAAO;EACR;CAGD,MAAM,QAAQ,UAEV,KAAK,WAAW,KAAK,KAAK,KAAK,QAAQ,GACrC,QACE,UACE,QAAQ,IAAI,WAAW,WACvB;EAAC;EAAM;EAAM;EAAM;EAAQ,EAC3B,aACD,GACD,UACE,QAAQ,IAAI,SAAS,WACrB,CAAC,MAAM,QAAQ,EACf,aACD,GACH,UAAU,SAAS,MAAM,aAAa,GACxC,QACE,UACE,QAAQ,IAAI,WAAW,WACvB;EAAC;EAAM;EAAM;EAAM;EAAY,EAC/B,aACD,GACD,UACE,QAAQ,IAAI,SAAS,WACrB,CAAC,MAAM,YAAY,EACnB,aACD;CAEP,MAAM,SAAS,IAAI,SAAe,SAAS,WAAW;AACpD,QAAM,GAAG,UAAU,QAAQ;AACzB,OAAI;AACF,YAAQ,MACN,kCAAkC,KAAK,WAAW,OAAO,IAAI,GAC9D;WACK;AACR,UAAO,IAAI;IACX;AAEF,QAAM,GAAG,SAAS,MAAM,WAAW;AAMjC,OACE,SAAS,KACT,IAH8B,IAAI;IAAC;IAAK;IAAK;IAAK;IAAI,CAGnC,CAAC,IAAI,QAAQ,GAAG,IAClC,UAAU;IAPY;IAAU;IAAW;IAAW;IAO7B,CAAC,SAAS,OAAO,CAE3C,UAAS;OAET,QACE,OAAO,uBAAO,IAAI,MAAM,0BAA0B,EAAE;IAAE;IAAM;IAAQ,CAAC,CACtE;IAEH;GACF;CAEF,MAAM,aAAa;AACjB,MAAI;AACF,SAAM,KAAK,UAAU;UACf;;CAKV,MAAM,mBAAmB,MAAM;CAE/B,MAAM,qBAAqB;AACzB,QAAM;AACN,UAAQ,IAAI,UAAU,aAAa;AACnC,UAAQ,KAAK,QAAQ,KAAK,SAAS;;CAGrC,MAAM,sBAAsB;AAC1B,QAAM;AACN,UAAQ,IAAI,WAAW,cAAc;AACrC,UAAQ,KAAK,QAAQ,KAAK,UAAU;;AAGtC,SAAQ,GAAG,QAAQ,WAAW;AAC9B,SAAQ,GAAG,UAAU,aAAa;AAClC,SAAQ,GAAG,WAAW,cAAc;AAEpC,OAAM,GAAG,cAAc;AACrB,UAAQ,IAAI,QAAQ,WAAW;AAC/B,UAAQ,IAAI,UAAU,aAAa;AACnC,UAAQ,IAAI,WAAW,cAAc;GACrC;AAEF,QAAO;EAAE;EAAM;EAAQ;EAAa"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/utils/runParallel/index.ts"],"sourcesContent":["import { delimiter, join } from 'node:path';\nimport { spawnPosix } from './spawnPosix';\nimport { spawnWin32 } from './spawnWin32';\n\nexport type ParallelHandle = {\n  /**\n   * Terminate the child and its whole process group.\n   * @param signal Signal to send (default `SIGTERM`). Pass `SIGKILL` to force-kill\n   *   a child that ignores graceful termination.\n   */\n  kill: (signal?: NodeJS.Signals) => void;\n  result: Promise<any>;\n  commandText: string;\n};\n\n/**\n * Start a cross-platform parallel process using npm-run-all approach.\n * Accepts either a single string (e.g., 'next start') or an array of tokens (e.g., ['next', 'start']).\n */\nexport const runParallel = (proc?: string | string[]): ParallelHandle => {\n  if (!proc || (Array.isArray(proc) && proc.length === 0))\n    throw new Error('Invalid command');\n\n  const commandText = Array.isArray(proc) ? proc.join(' ') : proc;\n\n  const isArray = Array.isArray(proc);\n  const command = isArray ? (proc as string[])[0] : commandText;\n  const args = isArray ? (proc as string[]).slice(1) : [];\n\n  // Ensure local binaries (node_modules/.bin) are resolvable\n  const cwdBin = join(process.cwd(), 'node_modules', '.bin');\n  const PATH_KEY =\n    Object.keys(process.env).find((key) => key.toLowerCase() === 'path') ??\n    'PATH';\n\n  const extendedPath = [cwdBin, process.env[PATH_KEY] ?? '']\n    .filter(Boolean)\n    .join(delimiter);\n\n  const childEnv = {\n    ...process.env,\n    [PATH_KEY]: extendedPath,\n  } as NodeJS.ProcessEnv;\n\n  const isWin = process.platform === 'win32';\n  const spawnFunc = isWin ? spawnWin32 : spawnPosix;\n\n  // Spawn options\n  const spawnOptions = {\n    cwd: process.cwd(),\n    stdio: 'inherit' as const,\n    env: childEnv,\n    shell: isWin,\n  };\n\n  // Spawn the child process\n  const child = isArray\n    ? // If provided as a single string element that includes spaces, treat it like a shell command\n      args.length === 0 && /\\s/.test(command)\n      ? isWin\n        ? spawnFunc(\n            process.env.ComSpec ?? 'cmd.exe',\n            ['/d', '/s', '/c', command],\n            spawnOptions\n          )\n        : spawnFunc(\n            process.env.SHELL ?? '/bin/sh',\n            ['-c', command],\n            spawnOptions\n          )\n      : spawnFunc(command, args, spawnOptions)\n    : isWin\n      ? spawnFunc(\n          process.env.ComSpec ?? 'cmd.exe',\n          ['/d', '/s', '/c', commandText],\n          spawnOptions\n        )\n      : spawnFunc(\n          process.env.SHELL ?? '/bin/sh',\n          ['-c', commandText],\n          spawnOptions\n        );\n\n  const result = new Promise<void>((resolve, reject) => {\n    child.on('error', (err) => {\n      try {\n        console.error(\n          `[runParallel] Failed to start: ${err?.message ?? String(err)}`\n        );\n      } catch {}\n      reject(err);\n    });\n\n    child.on('exit', (code, signal) => {\n      // Treat common termination signals as graceful exits, not failures\n      const gracefulSignals = ['SIGINT', 'SIGTERM', 'SIGQUIT', 'SIGHUP'];\n      // Also treat shell-convention exit codes (128 + signal number) as graceful:\n      // 129 = SIGHUP, 130 = SIGINT, 131 = SIGQUIT, 143 = SIGTERM\n      const gracefulSignalCodes = new Set([129, 130, 131, 143]);\n      if (\n        code === 0 ||\n        gracefulSignalCodes.has(code ?? -1) ||\n        (signal && gracefulSignals.includes(signal))\n      ) {\n        resolve();\n      } else {\n        reject(\n          Object.assign(new Error('Parallel process failed'), { code, signal })\n        );\n      }\n    });\n  });\n\n  const kill = (signal: NodeJS.Signals = 'SIGTERM') => {\n    try {\n      child.kill(signal);\n    } catch {\n      // Best effort\n    }\n  };\n\n  const handleExit = () => kill();\n\n  const handleSigInt = () => {\n    kill();\n    process.off('SIGINT', handleSigInt);\n    process.kill(process.pid, 'SIGINT'); // Propagate to allow natural shutdown\n  };\n\n  const handleSigTerm = () => {\n    kill();\n    process.off('SIGTERM', handleSigTerm);\n    process.kill(process.pid, 'SIGTERM'); // Propagate to allow natural shutdown\n  };\n\n  process.on('exit', handleExit);\n  process.on('SIGINT', handleSigInt);\n  process.on('SIGTERM', handleSigTerm);\n\n  child.on('exit', () => {\n    process.off('exit', handleExit);\n    process.off('SIGINT', handleSigInt);\n    process.off('SIGTERM', handleSigTerm);\n  });\n\n  return { kill, result, commandText };\n};\n"],"mappings":";;;;;;;;;AAmBA,MAAa,eAAe,SAA6C;AACvE,KAAI,CAAC,QAAS,MAAM,QAAQ,KAAK,IAAI,KAAK,WAAW,EACnD,OAAM,IAAI,MAAM,kBAAkB;CAEpC,MAAM,cAAc,MAAM,QAAQ,KAAK,GAAG,KAAK,KAAK,IAAI,GAAG;CAE3D,MAAM,UAAU,MAAM,QAAQ,KAAK;CACnC,MAAM,UAAU,UAAW,KAAkB,KAAK;CAClD,MAAM,OAAO,UAAW,KAAkB,MAAM,EAAE,GAAG,EAAE;CAGvD,MAAM,SAAS,KAAK,QAAQ,KAAK,EAAE,gBAAgB,OAAO;CAC1D,MAAM,WACJ,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,QAAQ,IAAI,aAAa,KAAK,OAAO,IACpE;CAEF,MAAM,eAAe,CAAC,QAAQ,QAAQ,IAAI,aAAa,GAAG,CACvD,OAAO,QAAQ,CACf,KAAK,UAAU;CAElB,MAAM,WAAW;EACf,GAAG,QAAQ;GACV,WAAW;EACb;CAED,MAAM,QAAQ,QAAQ,aAAa;CACnC,MAAM,YAAY,QAAQ,aAAa;CAGvC,MAAM,eAAe;EACnB,KAAK,QAAQ,KAAK;EAClB,OAAO;EACP,KAAK;EACL,OAAO;EACR;CAGD,MAAM,QAAQ,UAEV,KAAK,WAAW,KAAK,KAAK,KAAK,QAAQ,GACrC,QACE,UACE,QAAQ,IAAI,WAAW,WACvB;EAAC;EAAM;EAAM;EAAM;EAAQ,EAC3B,aACD,GACD,UACE,QAAQ,IAAI,SAAS,WACrB,CAAC,MAAM,QAAQ,EACf,aACD,GACH,UAAU,SAAS,MAAM,aAAa,GACxC,QACE,UACE,QAAQ,IAAI,WAAW,WACvB;EAAC;EAAM;EAAM;EAAM;EAAY,EAC/B,aACD,GACD,UACE,QAAQ,IAAI,SAAS,WACrB,CAAC,MAAM,YAAY,EACnB,aACD;CAEP,MAAM,SAAS,IAAI,SAAe,SAAS,WAAW;AACpD,QAAM,GAAG,UAAU,QAAQ;AACzB,OAAI;AACF,YAAQ,MACN,kCAAkC,KAAK,WAAW,OAAO,IAAI,GAC9D;WACK;AACR,UAAO,IAAI;IACX;AAEF,QAAM,GAAG,SAAS,MAAM,WAAW;AAMjC,OACE,SAAS,KACT,IAH8B,IAAI;IAAC;IAAK;IAAK;IAAK;IAAI,CAGnC,CAAC,IAAI,QAAQ,GAAG,IAClC,UAAU;IAPY;IAAU;IAAW;IAAW;IAO7B,CAAC,SAAS,OAAO,CAE3C,UAAS;OAET,QACE,OAAO,uBAAO,IAAI,MAAM,0BAA0B,EAAE;IAAE;IAAM;IAAQ,CAAC,CACtE;IAEH;GACF;CAEF,MAAM,QAAQ,SAAyB,cAAc;AACnD,MAAI;AACF,SAAM,KAAK,OAAO;UACZ;;CAKV,MAAM,mBAAmB,MAAM;CAE/B,MAAM,qBAAqB;AACzB,QAAM;AACN,UAAQ,IAAI,UAAU,aAAa;AACnC,UAAQ,KAAK,QAAQ,KAAK,SAAS;;CAGrC,MAAM,sBAAsB;AAC1B,QAAM;AACN,UAAQ,IAAI,WAAW,cAAc;AACrC,UAAQ,KAAK,QAAQ,KAAK,UAAU;;AAGtC,SAAQ,GAAG,QAAQ,WAAW;AAC9B,SAAQ,GAAG,UAAU,aAAa;AAClC,SAAQ,GAAG,WAAW,cAAc;AAEpC,OAAM,GAAG,cAAc;AACrB,UAAQ,IAAI,QAAQ,WAAW;AAC/B,UAAQ,IAAI,UAAU,aAAa;AACnC,UAAQ,IAAI,WAAW,cAAc;GACrC;AAEF,QAAO;EAAE;EAAM;EAAQ;EAAa"}

package/dist/esm/watcher.mjs

@@ -12,7 +12,7 @@ import { getConfiguration, getConfigurationAndFilePath } from "@intlayer/config/
 import { existsSync, watch as watch$1 } from "node:fs";
 import { clearAllCache, clearDiskCacheMemory, clearModuleCache, normalizePath } from "@intlayer/config/utils";
 import * as ANSIColor from "@intlayer/config/colors";
-import { pathToFileURL } from "node:url";
+import { transpileTSToCJS } from "@intlayer/config/file";
 
 //#region src/watcher.ts
 const pendingUnlinks = /* @__PURE__ */ new Map();
@@ -80,9 +80,8 @@ const watch = async (options) => {
 				if (!rel || rel.includes("/")) continue;
 				if (rel.endsWith(".tmp")) continue;
 				if (event.type === "update") processEvent(async () => {
-					clearModuleCache(event.path);
 					try {
-						await import(`${pathToFileURL(event.path).href}?update=${Date.now()}`);
+						await transpileTSToCJS(await readFile(event.path, "utf-8"), event.path);
 					} catch {
 						appLogger(`Entry point ${basename(event.path)} failed to load, running clean rebuild...`, { level: "warn" });
 						await prepareIntlayer(configuration, {