@intlayer/sync-json-plugin 8.12.5-canary.0 → 9.0.0-canary.3

package/dist/cjs/loadJSON.cjs

@@ -3,6 +3,7 @@ const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_syncJSON = require('./syncJSON.cjs');
 let node_path = require("node:path");
 let _intlayer_config_file = require("@intlayer/config/file");
+let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_utils = require("@intlayer/config/utils");
 let fast_glob = require("fast-glob");
 fast_glob = require_runtime.__toESM(fast_glob);
@@ -65,25 +66,50 @@ const loadJSON = (options) => {
 	return {
 		name: "load-json",
 		loadDictionaries: async ({ configuration }) => {
+			const appLogger = (0, _intlayer_config_logger.getAppLogger)(configuration);
 			const dictionariesMap = await loadMessagePathMap(options.source, configuration);
+			if (dictionariesMap.length === 0) appLogger(`No dictionaries found at locations matching source pattern: ${(0, _intlayer_config_logger.colorizePath)(await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
+				key: "{{key}}",
+				locale: "{{locale}}"
+			}))}`, { level: "warn" });
+			const hasKeyPlaceholder = (await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
+				key: "{{key}}",
+				locale: "{{locale}}"
+			})).includes("{{key}}");
+			const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;
 			const dictionaries = [];
 			for (const { path, key, locale: entryLocale } of dictionariesMap) {
 				const json = await (0, _intlayer_config_file.loadExternalFile)(path, { logError: false }) ?? {};
 				const filePath = (0, node_path.relative)(configuration.system.baseDir, path);
 				const entryUsedLocale = locale ?? entryLocale;
-				const dictionary = {
+				const filled = entryUsedLocale !== configuration.internationalization.defaultLocale ? true : void 0;
+				if (shouldSplitByKeys) {
+					for (const [namespaceKey, namespaceContent] of Object.entries(json)) dictionaries.push({
+						key: namespaceKey,
+						locale: entryUsedLocale,
+						fill: filePath,
+						format,
+						localId: `${namespaceKey}::${location}::${filePath}`,
+						location,
+						filled,
+						content: namespaceContent,
+						filePath,
+						priority
+					});
+					continue;
+				}
+				dictionaries.push({
 					key,
 					locale: entryUsedLocale,
 					fill: filePath,
 					format,
 					localId: `${key}::${location}::${filePath}`,
 					location,
-					filled: entryUsedLocale !== configuration.internationalization.defaultLocale ? true : void 0,
+					filled,
 					content: json,
 					filePath,
 					priority
-				};
-				dictionaries.push(dictionary);
+				});
 			}
 			return dictionaries;
 		}

package/dist/cjs/loadJSON.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadJSON.cjs","names":["extractKeyAndLocaleFromPath","sourcePattern"],"sources":["../../src/loadJSON.ts"],"sourcesContent":["import { isAbsolute, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\nimport { extractKeyAndLocaleFromPath } from './syncJSON';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      // extractKeyAndLocaleFromPath requires at least one named capture group\n      // ({{__LOCALE__}} or {{__KEY__}}) in the mask to return a non-null result.\n      // When the mask is fully concrete (e.g. `messages_ICU/en.json` — the source\n      // has {{locale}} but no {{key}}), no groups exist and it returns null.\n      // In that case, fall back directly to the loop locale and key = 'index'.\n      const hasLocaleInMask = maskPatternLocale.includes('{{__LOCALE__}}');\n      const hasKeyInMask = maskPatternLocale.includes('{{__KEY__}}');\n\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 {\n        // Mask has no placeholders — the file was found via a concrete locale\n        // glob. Attribute it directly to the current loop locale.\n        key = 'index';\n        extractedLocale = locale;\n      }\n\n      const absolutePath = isAbsolute(file) ? file : resolve(baseDir, file);\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absolutePath;\n    }\n  }\n\n  // For the load plugin we only use actual discovered files; do not fabricate\n  // missing locales or keys, since we don't write outputs.\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const sourcePattern = source as FilePathPattern;\n  const messages: MessagesRecord = await listMessages(\n    sourcePattern,\n    configuration\n  );\n\n  // Always include all discovered locales — loadJSON is read-only and should\n  // ingest every locale file that exists, just like syncJSON does.\n  const entries = Object.entries(messages) as [\n    Locale,\n    Record<Dictionary['key'], FilePath>,\n  ][];\n\n  const dictionariesPathMap: DictionariesMap = entries.flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype LoadJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Locale\n   *\n   * If not provided, the plugin will consider the default locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   *   locale: Locales.ENGLISH,\n   * })\n   * ```\n   */\n  locale?: Locale;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * @example\n   * ```ts\n   * const config = {\n   *   plugins: [\n   *     loadJSON({\n   *       source: ({ key }) => `./resources/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     loadJSON({\n   *       source: ({ key }) => `./messages/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: string;\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionary content.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   format: 'icu',\n   * })\n   * ```\n   */\n  format?: DictionaryFormat;\n};\n\nexport const loadJSON = (options: LoadJSONPluginOptions): Plugin => {\n  const { location, priority, locale, format } = {\n    location: 'plugin',\n    priority: 0,\n    ...options,\n  } as const;\n\n  return {\n    name: 'load-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { path, key, locale: entryLocale } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // use ?? {} to guarantee a plain object regardless.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        // Use the per-entry locale discovered from the file path. If a fixed\n        // locale override was provided, use it only as a fallback.\n        const entryUsedLocale = (locale ?? entryLocale) as Locale;\n\n        const dictionary: Dictionary = {\n          key,\n          locale: entryUsedLocale,\n          fill: filePath,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled:\n            entryUsedLocale !== configuration.internationalization.defaultLocale\n              ? true\n              : undefined,\n          content: json,\n          filePath,\n          priority,\n        };\n\n        dictionaries.push(dictionary);\n      }\n\n      return dictionaries;\n    },\n  };\n};\n"],"mappings":";;;;;;;;;;AAwBA,MAAM,eAAe,OACnB,QACA,kBAC4B;CAC5B,MAAM,EAAE,QAAQ,yBAAyB;CAEzC,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,YAAY;CAEpB,MAAM,SAAyB,EAAE;AAEjC,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,oBAAoB,uDAA2B,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;EAEnC,MAAM,oBAAoB,uDAA2B,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;AAEnC,MAAI,CAAC,qBAAqB,CAAC,kBACzB;EAOF,MAAM,QAAQ,6BAJgB,kBAAkB,WAAW,KAAK,GAC5D,kBAAkB,MAAM,EAAE,GAC1B,mBAE0C,EAC5C,KAAK,SACN,CAAC;AAEF,OAAK,MAAM,QAAQ,OAAO;GAMxB,MAAM,kBAAkB,kBAAkB,SAAS,iBAAiB;GACpE,MAAM,eAAe,kBAAkB,SAAS,cAAc;GAE9D,IAAI;GACJ,IAAI;AAEJ,OAAI,mBAAmB,cAAc;IACnC,MAAM,aAAaA,6CACjB,MACA,mBACA,SACA,OACD;AAED,QAAI,CAAC,WACH;AAGF,UAAM,WAAW;AACjB,sBAAkB,WAAW;UACxB;AAGL,UAAM;AACN,sBAAkB;;GAGpB,MAAM,yCAA0B,KAAK,GAAG,8BAAe,SAAS,KAAK;GAErE,MAAM,aAAa;AACnB,OAAI,CAAC,OAAO,YACV,QAAO,cAAc,EAAE;AAGzB,UAAO,YAAY,OAA4B;;;AAMnD,QAAO;;AAKT,MAAM,qBAAqB,OACzB,QACA,kBACG;CAEH,MAAM,WAA2B,MAAM,aACrCC,QACA,cACD;AAwBD,QApBgB,OAAO,QAAQ,SAKqB,CAAC,SAClD,CAAC,QAAQ,gBACR,OAAO,QAAQ,WAAW,CAAC,KAAK,CAAC,KAAK,UAAU;AAK9C,SAAO;GACL,gCAL8B,KAAK,GACjC,8BACQ,cAAc,OAAO,SAAS,KAAK;GAI7C;GACA;GACD;GACD,CAGoB;;AA+E5B,MAAa,YAAY,YAA2C;CAClE,MAAM,EAAE,UAAU,UAAU,QAAQ,WAAW;EAC7C,UAAU;EACV,UAAU;EACV,GAAG;EACJ;AAED,QAAO;EACL,MAAM;EAEN,kBAAkB,OAAO,EAAE,oBAAoB;GAC7C,MAAM,kBAAmC,MAAM,mBAC7C,QAAQ,QACR,cACD;GAED,MAAM,eAA6B,EAAE;AAErC,QAAK,MAAM,EAAE,MAAM,KAAK,QAAQ,iBAAiB,iBAAiB;IAGhE,MAAM,OACH,kDAAuB,MAAM,EAAE,UAAU,OAAO,CAAC,IAAK,EAAE;IAE3D,MAAM,mCAAoB,cAAc,OAAO,SAAS,KAAK;IAI7D,MAAM,kBAAmB,UAAU;IAEnC,MAAM,aAAyB;KAC7B;KACA,QAAQ;KACR,MAAM;KACN;KACA,SAAS,GAAG,IAAI,IAAI,SAAS,IAAI;KACvB;KACV,QACE,oBAAoB,cAAc,qBAAqB,gBACnD,OACA;KACN,SAAS;KACT;KACA;KACD;AAED,iBAAa,KAAK,WAAW;;AAG/B,UAAO;;EAEV"}
+{"version":3,"file":"loadJSON.cjs","names":["extractKeyAndLocaleFromPath","sourcePattern"],"sources":["../../src/loadJSON.ts"],"sourcesContent":["import { isAbsolute, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\nimport { extractKeyAndLocaleFromPath } from './syncJSON';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      // extractKeyAndLocaleFromPath requires at least one named capture group\n      // ({{__LOCALE__}} or {{__KEY__}}) in the mask to return a non-null result.\n      // When the mask is fully concrete (e.g. `messages_ICU/en.json` — the source\n      // has {{locale}} but no {{key}}), no groups exist and it returns null.\n      // In that case, fall back directly to the loop locale and key = 'index'.\n      const hasLocaleInMask = maskPatternLocale.includes('{{__LOCALE__}}');\n      const hasKeyInMask = maskPatternLocale.includes('{{__KEY__}}');\n\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 {\n        // Mask has no placeholders — the file was found via a concrete locale\n        // glob. Attribute it directly to the current loop locale.\n        key = 'index';\n        extractedLocale = locale;\n      }\n\n      const absolutePath = isAbsolute(file) ? file : resolve(baseDir, file);\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absolutePath;\n    }\n  }\n\n  // For the load plugin we only use actual discovered files; do not fabricate\n  // missing locales or keys, since we don't write outputs.\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const sourcePattern = source as FilePathPattern;\n  const messages: MessagesRecord = await listMessages(\n    sourcePattern,\n    configuration\n  );\n\n  // Always include all discovered locales — loadJSON is read-only and should\n  // ingest every locale file that exists, just like syncJSON does.\n  const entries = Object.entries(messages) as [\n    Locale,\n    Record<Dictionary['key'], FilePath>,\n  ][];\n\n  const dictionariesPathMap: DictionariesMap = entries.flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype LoadJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Locale\n   *\n   * If not provided, the plugin will consider the default locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   *   locale: Locales.ENGLISH,\n   * })\n   * ```\n   */\n  locale?: Locale;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * @example\n   * ```ts\n   * const config = {\n   *   plugins: [\n   *     loadJSON({\n   *       source: ({ key }) => `./resources/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     loadJSON({\n   *       source: ({ key }) => `./messages/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: string;\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionary content.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   format: 'icu',\n   * })\n   * ```\n   */\n  format?: DictionaryFormat;\n\n  /**\n   * Whether each top-level key of the JSON file should become its own\n   * dictionary (keyed by that top-level key) instead of a single dictionary\n   * holding the whole file.\n   *\n   * This matches the namespace model of libraries such as `next-intl` /\n   * `react-intl`, where a single `messages/{locale}.json` file groups several\n   * namespaces by its first-level keys.\n   *\n   * When omitted, it is auto-detected: the file is split when the `source`\n   * pattern has no `{{key}}` segment, and kept as a single dictionary otherwise.\n   */\n  splitKeys?: boolean;\n};\n\nexport const loadJSON = (options: LoadJSONPluginOptions): Plugin => {\n  const { location, priority, locale, format } = {\n    location: 'plugin',\n    priority: 0,\n    ...options,\n  } as const;\n\n  return {\n    name: 'load-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const appLogger = getAppLogger(configuration);\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      if (dictionariesMap.length === 0) {\n        const pattern = await parseFilePathPattern(options.source, {\n          key: '{{key}}',\n          locale: '{{locale}}',\n        } as any as FilePathPatternContext);\n\n        appLogger(\n          `No dictionaries found at locations matching source pattern: ${colorizePath(pattern)}`,\n          { level: 'warn' }\n        );\n      }\n\n      // When the source pattern has no `{{key}}` segment, a single file holds\n      // every namespace as a first-level key (the next-intl / react-intl model).\n      // In that case each top-level key becomes its own dictionary.\n      const patternMarker = await parseFilePathPattern(options.source, {\n        key: '{{key}}',\n        locale: '{{locale}}',\n      } as any as FilePathPatternContext);\n      const hasKeyPlaceholder = patternMarker.includes('{{key}}');\n      const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { path, key, locale: entryLocale } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // use ?? {} to guarantee a plain object regardless.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        // Use the per-entry locale discovered from the file path. If a fixed\n        // locale override was provided, use it only as a fallback.\n        const entryUsedLocale = (locale ?? entryLocale) as Locale;\n\n        const filled =\n          entryUsedLocale !== configuration.internationalization.defaultLocale\n            ? true\n            : undefined;\n\n        if (shouldSplitByKeys) {\n          for (const [namespaceKey, namespaceContent] of Object.entries(json)) {\n            dictionaries.push({\n              key: namespaceKey,\n              locale: entryUsedLocale,\n              fill: filePath,\n              format,\n              localId:\n                `${namespaceKey}::${location}::${filePath}` as LocalDictionaryId,\n              location: location as Dictionary['location'],\n              filled,\n              content: namespaceContent as JSONContent,\n              filePath,\n              priority,\n            });\n          }\n          continue;\n        }\n\n        dictionaries.push({\n          key,\n          locale: entryUsedLocale,\n          fill: filePath,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled,\n          content: json,\n          filePath,\n          priority,\n        });\n      }\n\n      return dictionaries;\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/cjs/syncJSON.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 let node_path = require("node:path");
 let _intlayer_config_file = require("@intlayer/config/file");
+let _intlayer_config_logger = require("@intlayer/config/logger");
 let _intlayer_config_utils = require("@intlayer/config/utils");
 let fast_glob = require("fast-glob");
 fast_glob = require_runtime.__toESM(fast_glob);
@@ -95,18 +96,26 @@ const loadMessagePathMap = async (source, configuration) => {
 	}));
 };
 const syncJSON = async (options) => {
+	const patternMarker = await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
+		key: "{{key}}",
+		locale: "{{locale}}"
+	});
 	const { location, priority, format } = {
-		location: `sync-json::${await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
-			key: "{{key}}",
-			locale: "{{locale}}"
-		})}`,
+		location: `sync-json::${patternMarker}`,
 		priority: 0,
 		...options
 	};
+	const hasKeyPlaceholder = patternMarker.includes("{{key}}");
+	const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;
 	return {
 		name: "sync-json",
 		loadDictionaries: async ({ configuration }) => {
+			const appLogger = (0, _intlayer_config_logger.getAppLogger)(configuration);
 			const dictionariesMap = await loadMessagePathMap(options.source, configuration);
+			if (dictionariesMap.length === 0) appLogger(`[sync-json] No dictionaries found at locations matching source pattern: ${(0, _intlayer_config_logger.colorizePath)(await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
+				key: "{{key}}",
+				locale: "{{locale}}"
+			}))}`, { level: "warn" });
 			let fill = await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
 				key: "{{key}}",
 				locale: "{{locale}}"
@@ -116,25 +125,41 @@ const syncJSON = async (options) => {
 			for (const { locale, path, key } of dictionariesMap) {
 				const json = await (0, _intlayer_config_file.loadExternalFile)(path, { logError: false }) ?? {};
 				const filePath = (0, node_path.relative)(configuration.system.baseDir, path);
-				const dictionary = {
+				const filled = locale !== configuration.internationalization.defaultLocale ? true : void 0;
+				if (shouldSplitByKeys) {
+					for (const [namespaceKey, namespaceContent] of Object.entries(json)) dictionaries.push({
+						key: namespaceKey,
+						locale,
+						fill,
+						format,
+						localId: `${namespaceKey}::${location}::${filePath}`,
+						location,
+						filled,
+						content: namespaceContent,
+						filePath,
+						priority
+					});
+					continue;
+				}
+				dictionaries.push({
 					key,
 					locale,
 					fill,
 					format,
 					localId: `${key}::${location}::${filePath}`,
 					location,
-					filled: locale !== configuration.internationalization.defaultLocale ? true : void 0,
+					filled,
 					content: json,
 					filePath,
 					priority
-				};
-				dictionaries.push(dictionary);
+				});
 			}
 			return dictionaries;
 		},
 		formatOutput: async ({ dictionary, configuration }) => {
 			const { formatDictionaryOutput } = await import("@intlayer/chokidar/build");
 			if (!dictionary.filePath || !dictionary.locale) return dictionary;
+			if (shouldSplitByKeys) return dictionary;
 			const builderPath = await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
 				key: dictionary.key,
 				locale: dictionary.locale
@@ -147,6 +172,32 @@ const syncJSON = async (options) => {
 			const { parallelize } = await import("@intlayer/chokidar/utils");
 			const { formatDictionaryOutput } = await import("@intlayer/chokidar/build");
 			const { locales } = configuration.internationalization;
+			if (shouldSplitByKeys) {
+				const mergedByLocale = {};
+				const filePathByLocale = {};
+				for (const [key, entry] of Object.entries(dictionaries.mergedDictionaries)) {
+					const dictionary = entry.dictionary;
+					if (dictionary.location !== location) continue;
+					for (const locale of locales) {
+						const formattedOutput = formatDictionaryOutput(getPerLocaleDictionary(dictionary, locale), format);
+						const content = JSON.parse(JSON.stringify(formattedOutput.content));
+						if (typeof content === "undefined" || typeof content === "object" && content !== null && Object.keys(content).length === 0) continue;
+						mergedByLocale[locale] ??= {};
+						mergedByLocale[locale][key] = content;
+						filePathByLocale[locale] = await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
+							key,
+							locale
+						});
+					}
+				}
+				await parallelize(Object.keys(mergedByLocale), async (locale) => {
+					const builderPath = filePathByLocale[locale];
+					if (!builderPath) return;
+					await (0, node_fs_promises.mkdir)((0, node_path.dirname)(builderPath), { recursive: true });
+					await (0, node_fs_promises.writeFile)(builderPath, `${JSON.stringify(mergedByLocale[locale], null, 2)}\n`, "utf-8");
+				});
+				return;
+			}
 			await parallelize(Object.entries(dictionaries.mergedDictionaries).flatMap(([key, dictionary]) => locales.map((locale) => ({
 				key,
 				dictionary: dictionary.dictionary,

package/dist/cjs/syncJSON.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"syncJSON.cjs","names":[],"sources":["../../src/syncJSON.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  DictionaryLocation,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst escapeRegex = (str: string) => str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\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 regexStr = `^${escapeRegex(normalizedMask)}$`;\n  regexStr = regexStr.replace(/\\\\\\*\\\\\\*/g, '.*'); // ** → match any path segments\n  regexStr = regexStr.replace(/\\\\\\*/g, '[^/]*'); // * → match within a single segment\n\n  regexStr = regexStr.replace(\n    escapeRegex(localePlaceholder),\n    `(?<locale>${localesAlternation})`\n  );\n\n  if (normalizedMask.includes(keyPlaceholder)) {\n    regexStr = regexStr.replace(escapeRegex(keyPlaceholder), '(?<key>.+)');\n  }\n\n  const maskRegex = new RegExp(regexStr);\n  const match = maskRegex.exec(normalizedFilePath);\n\n  if (!match?.groups) {\n    return null;\n  }\n\n  let locale = match.groups.locale as Locale | undefined;\n  let key = (match.groups.key as string | undefined) ?? 'index';\n\n  if (typeof key === 'undefined') {\n    key = 'index';\n  }\n\n  if (typeof locale === 'undefined') {\n    locale = defaultLocale;\n  }\n\n  return {\n    key,\n    locale,\n  };\n};\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      const extraction = extractKeyAndLocaleFromPath(\n        file,\n        maskPatternLocale,\n        locales,\n        locale\n      );\n\n      if (!extraction) {\n        continue;\n      }\n\n      const { key, locale: extractedLocale } = extraction;\n\n      // Generate what the path SHOULD be for this key/locale using the current builder\n      const expectedPath = await parseFilePathPattern(source, {\n        key,\n        locale: extractedLocale,\n      } as any as FilePathPatternContext);\n\n      // Resolve both to absolute paths to ensure safe comparison\n      const absoluteFoundPath = isAbsolute(file)\n        ? file\n        : resolve(baseDir, file);\n      const absoluteExpectedPath = isAbsolute(expectedPath)\n        ? expectedPath\n        : resolve(baseDir, expectedPath);\n\n      // If the file found doesn't exactly match the file expected, it belongs to another plugin/structure\n      if (absoluteFoundPath !== absoluteExpectedPath) {\n        continue;\n      }\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absoluteFoundPath;\n    }\n  }\n\n  // Ensure all declared locales are present even if the file doesn't exist yet\n  const maskWithKey = await parseFilePathPattern(source, {\n    key: '{{__KEY__}}',\n    locale: locales[0],\n  } as any as FilePathPatternContext);\n\n  const hasKeyInMask = maskWithKey.includes('{{__KEY__}}');\n  const discoveredKeys = new Set<string>();\n\n  for (const locale of Object.keys(result)) {\n    for (const key of Object.keys(result[locale as Locale] ?? {})) {\n      discoveredKeys.add(key);\n    }\n  }\n\n  if (!hasKeyInMask) {\n    discoveredKeys.add('index');\n  }\n\n  const keysToEnsure =\n    discoveredKeys.size > 0 ? Array.from(discoveredKeys) : [];\n\n  for (const locale of locales) {\n    if (!result[locale]) {\n      result[locale] = {} as Record<Dictionary['key'], FilePath>;\n    }\n\n    for (const key of keysToEnsure) {\n      if (!result[locale][key as Dictionary['key']]) {\n        const builtPath = await parseFilePathPattern(source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n        const absoluteBuiltPath = isAbsolute(builtPath)\n          ? builtPath\n          : resolve(baseDir, builtPath);\n\n        result[locale][key as Dictionary['key']] = absoluteBuiltPath;\n      }\n    }\n  }\n\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const messages: MessagesRecord = await listMessages(\n    source as FilePathPattern,\n    configuration\n  );\n\n  const dictionariesPathMap: DictionariesMap = Object.entries(messages).flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype SyncJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * ```ts\n   * syncJSON({\n   * source: ({ key, locale }) => `./messages/${locale}/${key}.json`\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * ```ts\n   * // Example usage:\n   * const config = {\n   *   plugins: [\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./resources/${locale}/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./messages/${locale}/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: DictionaryLocation | (string & {});\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionaries created by the plugin.\n   *\n   * Default: 'intlayer'\n   *\n   * The format of the dictionaries created by the plugin.\n   */\n  format?: DictionaryFormat;\n};\n\nexport const syncJSON = async (\n  options: SyncJSONPluginOptions\n): Promise<Plugin> => {\n  // Generate a unique default location based on the source pattern.\n  // This ensures that if you have multiple plugins, they don't share the same 'plugin' ID.\n  const patternMarker = await parseFilePathPattern(options.source, {\n    key: '{{key}}',\n    locale: '{{locale}}',\n  } as any as FilePathPatternContext);\n  const defaultLocation = `sync-json::${patternMarker}`;\n\n  const { location, priority, format } = {\n    location: defaultLocation,\n    priority: 0,\n    ...options,\n  };\n\n  return {\n    name: 'sync-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      let fill: string = await parseFilePathPattern(options.source, {\n        key: '{{key}}',\n        locale: '{{locale}}',\n      } as any as FilePathPatternContext);\n\n      if (fill) {\n        fill = relative(\n          configuration.system.baseDir,\n          resolve(configuration.system.baseDir, fill)\n        );\n      }\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { locale, path, key } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // the try/catch does not help here — use ?? {} to guarantee a plain object.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        const dictionary: Dictionary = {\n          key,\n          locale,\n          fill,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled:\n            locale !== configuration.internationalization.defaultLocale\n              ? true\n              : undefined,\n          content: json,\n          filePath,\n          priority,\n        };\n\n        dictionaries.push(dictionary);\n      }\n\n      return dictionaries;\n    },\n\n    formatOutput: async ({ dictionary, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n      const builderPath = await parseFilePathPattern(options.source, {\n        key: dictionary.key,\n        locale: dictionary.locale,\n      } as FilePathPatternContext);\n\n      // Verification to ensure we are formatting the correct file\n      if (\n        resolve(configuration.system.baseDir, builderPath) !==\n        resolve(configuration.system.baseDir, dictionary.filePath)\n      ) {\n        return dictionary;\n      }\n\n      const formattedOutput = formatDictionaryOutput(dictionary, format);\n\n      return formattedOutput.content;\n    },\n\n    afterBuild: async ({ dictionaries, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n      const { parallelize } = await import('@intlayer/chokidar/utils');\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      const { locales } = configuration.internationalization;\n\n      type RecordList = {\n        key: string;\n        dictionary: Dictionary;\n        locale: Locale;\n      };\n\n      // We get all dictionaries, but we need to filter them\n      const recordList: RecordList[] = Object.entries(\n        dictionaries.mergedDictionaries\n      ).flatMap(([key, dictionary]) =>\n        locales.map((locale) => ({\n          key,\n          dictionary: dictionary.dictionary as Dictionary,\n          locale,\n        }))\n      );\n\n      await parallelize(recordList, async ({ key, dictionary, locale }) => {\n        // Only process dictionaries that belong to THIS plugin instance.\n        if (dictionary.location !== location) {\n          return;\n        }\n\n        const builderPath = await parseFilePathPattern(options.source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n\n        const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n        const formattedOutput = formatDictionaryOutput(\n          localizedDictionary,\n          format\n        );\n\n        const content = JSON.parse(JSON.stringify(formattedOutput.content));\n\n        if (\n          typeof content === 'undefined' ||\n          (typeof content === 'object' &&\n            Object.keys(content as Record<string, unknown>).length === 0)\n        ) {\n          return;\n        }\n\n        await mkdir(dirname(builderPath), { recursive: true });\n\n        const stringContent = JSON.stringify(content, null, 2);\n\n        await writeFile(builderPath, `${stringContent}\\n`, 'utf-8');\n      });\n    },\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"syncJSON.cjs","names":[],"sources":["../../src/syncJSON.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  DictionaryLocation,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst escapeRegex = (str: string) => str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\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 regexStr = `^${escapeRegex(normalizedMask)}$`;\n  regexStr = regexStr.replace(/\\\\\\*\\\\\\*/g, '.*'); // ** → match any path segments\n  regexStr = regexStr.replace(/\\\\\\*/g, '[^/]*'); // * → match within a single segment\n\n  regexStr = regexStr.replace(\n    escapeRegex(localePlaceholder),\n    `(?<locale>${localesAlternation})`\n  );\n\n  if (normalizedMask.includes(keyPlaceholder)) {\n    regexStr = regexStr.replace(escapeRegex(keyPlaceholder), '(?<key>.+)');\n  }\n\n  const maskRegex = new RegExp(regexStr);\n  const match = maskRegex.exec(normalizedFilePath);\n\n  if (!match?.groups) {\n    return null;\n  }\n\n  let locale = match.groups.locale as Locale | undefined;\n  let key = (match.groups.key as string | undefined) ?? 'index';\n\n  if (typeof key === 'undefined') {\n    key = 'index';\n  }\n\n  if (typeof locale === 'undefined') {\n    locale = defaultLocale;\n  }\n\n  return {\n    key,\n    locale,\n  };\n};\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      const extraction = extractKeyAndLocaleFromPath(\n        file,\n        maskPatternLocale,\n        locales,\n        locale\n      );\n\n      if (!extraction) {\n        continue;\n      }\n\n      const { key, locale: extractedLocale } = extraction;\n\n      // Generate what the path SHOULD be for this key/locale using the current builder\n      const expectedPath = await parseFilePathPattern(source, {\n        key,\n        locale: extractedLocale,\n      } as any as FilePathPatternContext);\n\n      // Resolve both to absolute paths to ensure safe comparison\n      const absoluteFoundPath = isAbsolute(file)\n        ? file\n        : resolve(baseDir, file);\n      const absoluteExpectedPath = isAbsolute(expectedPath)\n        ? expectedPath\n        : resolve(baseDir, expectedPath);\n\n      // If the file found doesn't exactly match the file expected, it belongs to another plugin/structure\n      if (absoluteFoundPath !== absoluteExpectedPath) {\n        continue;\n      }\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absoluteFoundPath;\n    }\n  }\n\n  // Ensure all declared locales are present even if the file doesn't exist yet\n  const maskWithKey = await parseFilePathPattern(source, {\n    key: '{{__KEY__}}',\n    locale: locales[0],\n  } as any as FilePathPatternContext);\n\n  const hasKeyInMask = maskWithKey.includes('{{__KEY__}}');\n  const discoveredKeys = new Set<string>();\n\n  for (const locale of Object.keys(result)) {\n    for (const key of Object.keys(result[locale as Locale] ?? {})) {\n      discoveredKeys.add(key);\n    }\n  }\n\n  if (!hasKeyInMask) {\n    discoveredKeys.add('index');\n  }\n\n  const keysToEnsure =\n    discoveredKeys.size > 0 ? Array.from(discoveredKeys) : [];\n\n  for (const locale of locales) {\n    if (!result[locale]) {\n      result[locale] = {} as Record<Dictionary['key'], FilePath>;\n    }\n\n    for (const key of keysToEnsure) {\n      if (!result[locale][key as Dictionary['key']]) {\n        const builtPath = await parseFilePathPattern(source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n        const absoluteBuiltPath = isAbsolute(builtPath)\n          ? builtPath\n          : resolve(baseDir, builtPath);\n\n        result[locale][key as Dictionary['key']] = absoluteBuiltPath;\n      }\n    }\n  }\n\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const messages: MessagesRecord = await listMessages(\n    source as FilePathPattern,\n    configuration\n  );\n\n  const dictionariesPathMap: DictionariesMap = Object.entries(messages).flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype SyncJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * ```ts\n   * syncJSON({\n   * source: ({ key, locale }) => `./messages/${locale}/${key}.json`\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * ```ts\n   * // Example usage:\n   * const config = {\n   *   plugins: [\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./resources/${locale}/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./messages/${locale}/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: DictionaryLocation | (string & {});\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionaries created by the plugin.\n   *\n   * Default: 'intlayer'\n   *\n   * The format of the dictionaries created by the plugin.\n   */\n  format?: DictionaryFormat;\n\n  /**\n   * Whether each top-level key of the JSON file should become its own\n   * dictionary (keyed by that top-level key) instead of a single dictionary\n   * holding the whole file.\n   *\n   * This matches the namespace model of libraries such as `next-intl` /\n   * `react-intl`, where a single `messages/{locale}.json` file groups several\n   * namespaces by its first-level keys and each namespace is addressed\n   * independently (e.g. `useTranslations('Hero')` → dictionary `Hero`).\n   *\n   * When omitted, it is auto-detected: the file is split when the `source`\n   * pattern has no `{{key}}` segment (i.e. one file holds every namespace),\n   * and kept as a single dictionary otherwise (one file per key).\n   *\n   * @example\n   * ```ts\n   * // messages/en.json → dictionaries: Hero, Nav, About, …\n   * syncJSON({\n   *   source: ({ locale }) => `./messages/${locale}.json`,\n   *   splitKeys: true,\n   * })\n   * ```\n   */\n  splitKeys?: boolean;\n};\n\nexport const syncJSON = async (\n  options: SyncJSONPluginOptions\n): Promise<Plugin> => {\n  // Generate a unique default location based on the source pattern.\n  // This ensures that if you have multiple plugins, they don't share the same 'plugin' ID.\n  const patternMarker = await parseFilePathPattern(options.source, {\n    key: '{{key}}',\n    locale: '{{locale}}',\n  } as any as FilePathPatternContext);\n  const defaultLocation = `sync-json::${patternMarker}`;\n\n  const { location, priority, format } = {\n    location: defaultLocation,\n    priority: 0,\n    ...options,\n  };\n\n  // When the source pattern has no `{{key}}` segment, a single file holds every\n  // namespace as a first-level key (the next-intl / react-intl model). In that\n  // case each top-level key becomes its own dictionary. Can be forced via the\n  // `splitKeys` option.\n  const hasKeyPlaceholder = patternMarker.includes('{{key}}');\n  const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;\n\n  return {\n    name: 'sync-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const appLogger = getAppLogger(configuration);\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      if (dictionariesMap.length === 0) {\n        const pattern = await parseFilePathPattern(options.source, {\n          key: '{{key}}',\n          locale: '{{locale}}',\n        } as any as FilePathPatternContext);\n\n        appLogger(\n          `[sync-json] No dictionaries found at locations matching source pattern: ${colorizePath(pattern)}`,\n          { level: 'warn' }\n        );\n      }\n\n      let fill: string = await parseFilePathPattern(options.source, {\n        key: '{{key}}',\n        locale: '{{locale}}',\n      } as any as FilePathPatternContext);\n\n      if (fill) {\n        fill = relative(\n          configuration.system.baseDir,\n          resolve(configuration.system.baseDir, fill)\n        );\n      }\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { locale, path, key } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // the try/catch does not help here — use ?? {} to guarantee a plain object.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        const filled =\n          locale !== configuration.internationalization.defaultLocale\n            ? true\n            : undefined;\n\n        // One file 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(json)) {\n            dictionaries.push({\n              key: namespaceKey,\n              locale,\n              fill,\n              format,\n              localId:\n                `${namespaceKey}::${location}::${filePath}` as LocalDictionaryId,\n              location: location as Dictionary['location'],\n              filled,\n              content: namespaceContent as JSONContent,\n              filePath,\n              priority,\n            });\n          }\n          continue;\n        }\n\n        dictionaries.push({\n          key,\n          locale,\n          fill,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled,\n          content: json,\n          filePath,\n          priority,\n        });\n      }\n\n      return dictionaries;\n    },\n\n    formatOutput: async ({ dictionary, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n      // In split mode several namespaces share the same file; the file is\n      // re-assembled in `afterBuild`. Skip here to avoid overwriting the whole\n      // file with a single namespace.\n      if (shouldSplitByKeys) return dictionary;\n\n      const builderPath = await parseFilePathPattern(options.source, {\n        key: dictionary.key,\n        locale: dictionary.locale,\n      } as FilePathPatternContext);\n\n      // Verification to ensure we are formatting the correct file\n      if (\n        resolve(configuration.system.baseDir, builderPath) !==\n        resolve(configuration.system.baseDir, dictionary.filePath)\n      ) {\n        return dictionary;\n      }\n\n      const formattedOutput = formatDictionaryOutput(dictionary, format);\n\n      return formattedOutput.content;\n    },\n\n    afterBuild: async ({ dictionaries, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n      const { parallelize } = await import('@intlayer/chokidar/utils');\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      const { locales } = configuration.internationalization;\n\n      // Split mode: every namespace dictionary writes back into the same\n      // per-locale file. Re-assemble them under their top-level key and write\n      // each file once, instead of one file per key (which would overwrite).\n      if (shouldSplitByKeys) {\n        const mergedByLocale: Record<string, Record<string, unknown>> = {};\n        const filePathByLocale: Record<string, string> = {};\n\n        for (const [key, entry] of Object.entries(\n          dictionaries.mergedDictionaries\n        )) {\n          const dictionary = entry.dictionary as Dictionary;\n\n          // Only process dictionaries that belong to THIS plugin instance.\n          if (dictionary.location !== location) continue;\n\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 = JSON.parse(JSON.stringify(formattedOutput.content));\n\n            if (\n              typeof content === 'undefined' ||\n              (typeof content === 'object' &&\n                content !== null &&\n                Object.keys(content as Record<string, unknown>).length === 0)\n            ) {\n              continue;\n            }\n\n            mergedByLocale[locale] ??= {};\n            mergedByLocale[locale][key] = content;\n            filePathByLocale[locale] = await parseFilePathPattern(\n              options.source,\n              { key, locale } as any as FilePathPatternContext\n            );\n          }\n        }\n\n        await parallelize(Object.keys(mergedByLocale), async (locale) => {\n          const builderPath = filePathByLocale[locale];\n\n          if (!builderPath) return;\n\n          await mkdir(dirname(builderPath), { recursive: true });\n\n          const stringContent = JSON.stringify(mergedByLocale[locale], null, 2);\n\n          await writeFile(builderPath, `${stringContent}\\n`, 'utf-8');\n        });\n\n        return;\n      }\n\n      type RecordList = {\n        key: string;\n        dictionary: Dictionary;\n        locale: Locale;\n      };\n\n      // We get all dictionaries, but we need to filter them\n      const recordList: RecordList[] = Object.entries(\n        dictionaries.mergedDictionaries\n      ).flatMap(([key, dictionary]) =>\n        locales.map((locale) => ({\n          key,\n          dictionary: dictionary.dictionary as Dictionary,\n          locale,\n        }))\n      );\n\n      await parallelize(recordList, async ({ key, dictionary, locale }) => {\n        // Only process dictionaries that belong to THIS plugin instance.\n        if (dictionary.location !== location) {\n          return;\n        }\n\n        const builderPath = await parseFilePathPattern(options.source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n\n        const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n        const formattedOutput = formatDictionaryOutput(\n          localizedDictionary,\n          format\n        );\n\n        const content = JSON.parse(JSON.stringify(formattedOutput.content));\n\n        if (\n          typeof content === 'undefined' ||\n          (typeof content === 'object' &&\n            Object.keys(content as Record<string, unknown>).length === 0)\n        ) {\n          return;\n        }\n\n        await mkdir(dirname(builderPath), { recursive: true });\n\n        const stringContent = JSON.stringify(content, null, 2);\n\n        await writeFile(builderPath, `${stringContent}\\n`, 'utf-8');\n      });\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/esm/loadJSON.mjs

@@ -1,6 +1,7 @@
 import { extractKeyAndLocaleFromPath } from "./syncJSON.mjs";
 import { isAbsolute, relative, resolve } from "node:path";
 import { loadExternalFile } from "@intlayer/config/file";
+import { colorizePath, getAppLogger } from "@intlayer/config/logger";
 import { parseFilePathPattern } from "@intlayer/config/utils";
 import fg from "fast-glob";
 
@@ -62,25 +63,50 @@ const loadJSON = (options) => {
 	return {
 		name: "load-json",
 		loadDictionaries: async ({ configuration }) => {
+			const appLogger = getAppLogger(configuration);
 			const dictionariesMap = await loadMessagePathMap(options.source, configuration);
+			if (dictionariesMap.length === 0) appLogger(`No dictionaries found at locations matching source pattern: ${colorizePath(await parseFilePathPattern(options.source, {
+				key: "{{key}}",
+				locale: "{{locale}}"
+			}))}`, { level: "warn" });
+			const hasKeyPlaceholder = (await parseFilePathPattern(options.source, {
+				key: "{{key}}",
+				locale: "{{locale}}"
+			})).includes("{{key}}");
+			const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;
 			const dictionaries = [];
 			for (const { path, key, locale: entryLocale } of dictionariesMap) {
 				const json = await loadExternalFile(path, { logError: false }) ?? {};
 				const filePath = relative(configuration.system.baseDir, path);
 				const entryUsedLocale = locale ?? entryLocale;
-				const dictionary = {
+				const filled = entryUsedLocale !== configuration.internationalization.defaultLocale ? true : void 0;
+				if (shouldSplitByKeys) {
+					for (const [namespaceKey, namespaceContent] of Object.entries(json)) dictionaries.push({
+						key: namespaceKey,
+						locale: entryUsedLocale,
+						fill: filePath,
+						format,
+						localId: `${namespaceKey}::${location}::${filePath}`,
+						location,
+						filled,
+						content: namespaceContent,
+						filePath,
+						priority
+					});
+					continue;
+				}
+				dictionaries.push({
 					key,
 					locale: entryUsedLocale,
 					fill: filePath,
 					format,
 					localId: `${key}::${location}::${filePath}`,
 					location,
-					filled: entryUsedLocale !== configuration.internationalization.defaultLocale ? true : void 0,
+					filled,
 					content: json,
 					filePath,
 					priority
-				};
-				dictionaries.push(dictionary);
+				});
 			}
 			return dictionaries;
 		}

package/dist/esm/loadJSON.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadJSON.mjs","names":["sourcePattern"],"sources":["../../src/loadJSON.ts"],"sourcesContent":["import { isAbsolute, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\nimport { extractKeyAndLocaleFromPath } from './syncJSON';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      // extractKeyAndLocaleFromPath requires at least one named capture group\n      // ({{__LOCALE__}} or {{__KEY__}}) in the mask to return a non-null result.\n      // When the mask is fully concrete (e.g. `messages_ICU/en.json` — the source\n      // has {{locale}} but no {{key}}), no groups exist and it returns null.\n      // In that case, fall back directly to the loop locale and key = 'index'.\n      const hasLocaleInMask = maskPatternLocale.includes('{{__LOCALE__}}');\n      const hasKeyInMask = maskPatternLocale.includes('{{__KEY__}}');\n\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 {\n        // Mask has no placeholders — the file was found via a concrete locale\n        // glob. Attribute it directly to the current loop locale.\n        key = 'index';\n        extractedLocale = locale;\n      }\n\n      const absolutePath = isAbsolute(file) ? file : resolve(baseDir, file);\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absolutePath;\n    }\n  }\n\n  // For the load plugin we only use actual discovered files; do not fabricate\n  // missing locales or keys, since we don't write outputs.\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const sourcePattern = source as FilePathPattern;\n  const messages: MessagesRecord = await listMessages(\n    sourcePattern,\n    configuration\n  );\n\n  // Always include all discovered locales — loadJSON is read-only and should\n  // ingest every locale file that exists, just like syncJSON does.\n  const entries = Object.entries(messages) as [\n    Locale,\n    Record<Dictionary['key'], FilePath>,\n  ][];\n\n  const dictionariesPathMap: DictionariesMap = entries.flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype LoadJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Locale\n   *\n   * If not provided, the plugin will consider the default locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   *   locale: Locales.ENGLISH,\n   * })\n   * ```\n   */\n  locale?: Locale;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * @example\n   * ```ts\n   * const config = {\n   *   plugins: [\n   *     loadJSON({\n   *       source: ({ key }) => `./resources/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     loadJSON({\n   *       source: ({ key }) => `./messages/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: string;\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionary content.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   format: 'icu',\n   * })\n   * ```\n   */\n  format?: DictionaryFormat;\n};\n\nexport const loadJSON = (options: LoadJSONPluginOptions): Plugin => {\n  const { location, priority, locale, format } = {\n    location: 'plugin',\n    priority: 0,\n    ...options,\n  } as const;\n\n  return {\n    name: 'load-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { path, key, locale: entryLocale } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // use ?? {} to guarantee a plain object regardless.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        // Use the per-entry locale discovered from the file path. If a fixed\n        // locale override was provided, use it only as a fallback.\n        const entryUsedLocale = (locale ?? entryLocale) as Locale;\n\n        const dictionary: Dictionary = {\n          key,\n          locale: entryUsedLocale,\n          fill: filePath,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled:\n            entryUsedLocale !== configuration.internationalization.defaultLocale\n              ? true\n              : undefined,\n          content: json,\n          filePath,\n          priority,\n        };\n\n        dictionaries.push(dictionary);\n      }\n\n      return dictionaries;\n    },\n  };\n};\n"],"mappings":";;;;;;;AAwBA,MAAM,eAAe,OACnB,QACA,kBAC4B;CAC5B,MAAM,EAAE,QAAQ,yBAAyB;CAEzC,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,YAAY;CAEpB,MAAM,SAAyB,EAAE;AAEjC,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,oBAAoB,MAAM,qBAAqB,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;EAEnC,MAAM,oBAAoB,MAAM,qBAAqB,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;AAEnC,MAAI,CAAC,qBAAqB,CAAC,kBACzB;EAOF,MAAM,QAAQ,MAAM,GAJU,kBAAkB,WAAW,KAAK,GAC5D,kBAAkB,MAAM,EAAE,GAC1B,mBAE0C,EAC5C,KAAK,SACN,CAAC;AAEF,OAAK,MAAM,QAAQ,OAAO;GAMxB,MAAM,kBAAkB,kBAAkB,SAAS,iBAAiB;GACpE,MAAM,eAAe,kBAAkB,SAAS,cAAc;GAE9D,IAAI;GACJ,IAAI;AAEJ,OAAI,mBAAmB,cAAc;IACnC,MAAM,aAAa,4BACjB,MACA,mBACA,SACA,OACD;AAED,QAAI,CAAC,WACH;AAGF,UAAM,WAAW;AACjB,sBAAkB,WAAW;UACxB;AAGL,UAAM;AACN,sBAAkB;;GAGpB,MAAM,eAAe,WAAW,KAAK,GAAG,OAAO,QAAQ,SAAS,KAAK;GAErE,MAAM,aAAa;AACnB,OAAI,CAAC,OAAO,YACV,QAAO,cAAc,EAAE;AAGzB,UAAO,YAAY,OAA4B;;;AAMnD,QAAO;;AAKT,MAAM,qBAAqB,OACzB,QACA,kBACG;CAEH,MAAM,WAA2B,MAAM,aACrCA,QACA,cACD;AAwBD,QApBgB,OAAO,QAAQ,SAKqB,CAAC,SAClD,CAAC,QAAQ,gBACR,OAAO,QAAQ,WAAW,CAAC,KAAK,CAAC,KAAK,UAAU;AAK9C,SAAO;GACL,MALmB,WAAW,KAAK,GACjC,OACA,QAAQ,cAAc,OAAO,SAAS,KAAK;GAI7C;GACA;GACD;GACD,CAGoB;;AA+E5B,MAAa,YAAY,YAA2C;CAClE,MAAM,EAAE,UAAU,UAAU,QAAQ,WAAW;EAC7C,UAAU;EACV,UAAU;EACV,GAAG;EACJ;AAED,QAAO;EACL,MAAM;EAEN,kBAAkB,OAAO,EAAE,oBAAoB;GAC7C,MAAM,kBAAmC,MAAM,mBAC7C,QAAQ,QACR,cACD;GAED,MAAM,eAA6B,EAAE;AAErC,QAAK,MAAM,EAAE,MAAM,KAAK,QAAQ,iBAAiB,iBAAiB;IAGhE,MAAM,OACH,MAAM,iBAAiB,MAAM,EAAE,UAAU,OAAO,CAAC,IAAK,EAAE;IAE3D,MAAM,WAAW,SAAS,cAAc,OAAO,SAAS,KAAK;IAI7D,MAAM,kBAAmB,UAAU;IAEnC,MAAM,aAAyB;KAC7B;KACA,QAAQ;KACR,MAAM;KACN;KACA,SAAS,GAAG,IAAI,IAAI,SAAS,IAAI;KACvB;KACV,QACE,oBAAoB,cAAc,qBAAqB,gBACnD,OACA;KACN,SAAS;KACT;KACA;KACD;AAED,iBAAa,KAAK,WAAW;;AAG/B,UAAO;;EAEV"}
+{"version":3,"file":"loadJSON.mjs","names":["sourcePattern"],"sources":["../../src/loadJSON.ts"],"sourcesContent":["import { isAbsolute, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\nimport { extractKeyAndLocaleFromPath } from './syncJSON';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      // extractKeyAndLocaleFromPath requires at least one named capture group\n      // ({{__LOCALE__}} or {{__KEY__}}) in the mask to return a non-null result.\n      // When the mask is fully concrete (e.g. `messages_ICU/en.json` — the source\n      // has {{locale}} but no {{key}}), no groups exist and it returns null.\n      // In that case, fall back directly to the loop locale and key = 'index'.\n      const hasLocaleInMask = maskPatternLocale.includes('{{__LOCALE__}}');\n      const hasKeyInMask = maskPatternLocale.includes('{{__KEY__}}');\n\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 {\n        // Mask has no placeholders — the file was found via a concrete locale\n        // glob. Attribute it directly to the current loop locale.\n        key = 'index';\n        extractedLocale = locale;\n      }\n\n      const absolutePath = isAbsolute(file) ? file : resolve(baseDir, file);\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absolutePath;\n    }\n  }\n\n  // For the load plugin we only use actual discovered files; do not fabricate\n  // missing locales or keys, since we don't write outputs.\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const sourcePattern = source as FilePathPattern;\n  const messages: MessagesRecord = await listMessages(\n    sourcePattern,\n    configuration\n  );\n\n  // Always include all discovered locales — loadJSON is read-only and should\n  // ingest every locale file that exists, just like syncJSON does.\n  const entries = Object.entries(messages) as [\n    Locale,\n    Record<Dictionary['key'], FilePath>,\n  ][];\n\n  const dictionariesPathMap: DictionariesMap = entries.flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype LoadJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Locale\n   *\n   * If not provided, the plugin will consider the default locale.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   source: ({ key }) => `blog/${'**'}/${key}.i18n.json`,\n   *   locale: Locales.ENGLISH,\n   * })\n   * ```\n   */\n  locale?: Locale;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * @example\n   * ```ts\n   * const config = {\n   *   plugins: [\n   *     loadJSON({\n   *       source: ({ key }) => `./resources/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     loadJSON({\n   *       source: ({ key }) => `./messages/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: string;\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionary content.\n   *\n   * @example\n   * ```ts\n   * loadJSON({\n   *   format: 'icu',\n   * })\n   * ```\n   */\n  format?: DictionaryFormat;\n\n  /**\n   * Whether each top-level key of the JSON file should become its own\n   * dictionary (keyed by that top-level key) instead of a single dictionary\n   * holding the whole file.\n   *\n   * This matches the namespace model of libraries such as `next-intl` /\n   * `react-intl`, where a single `messages/{locale}.json` file groups several\n   * namespaces by its first-level keys.\n   *\n   * When omitted, it is auto-detected: the file is split when the `source`\n   * pattern has no `{{key}}` segment, and kept as a single dictionary otherwise.\n   */\n  splitKeys?: boolean;\n};\n\nexport const loadJSON = (options: LoadJSONPluginOptions): Plugin => {\n  const { location, priority, locale, format } = {\n    location: 'plugin',\n    priority: 0,\n    ...options,\n  } as const;\n\n  return {\n    name: 'load-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const appLogger = getAppLogger(configuration);\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      if (dictionariesMap.length === 0) {\n        const pattern = await parseFilePathPattern(options.source, {\n          key: '{{key}}',\n          locale: '{{locale}}',\n        } as any as FilePathPatternContext);\n\n        appLogger(\n          `No dictionaries found at locations matching source pattern: ${colorizePath(pattern)}`,\n          { level: 'warn' }\n        );\n      }\n\n      // When the source pattern has no `{{key}}` segment, a single file holds\n      // every namespace as a first-level key (the next-intl / react-intl model).\n      // In that case each top-level key becomes its own dictionary.\n      const patternMarker = await parseFilePathPattern(options.source, {\n        key: '{{key}}',\n        locale: '{{locale}}',\n      } as any as FilePathPatternContext);\n      const hasKeyPlaceholder = patternMarker.includes('{{key}}');\n      const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { path, key, locale: entryLocale } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // use ?? {} to guarantee a plain object regardless.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        // Use the per-entry locale discovered from the file path. If a fixed\n        // locale override was provided, use it only as a fallback.\n        const entryUsedLocale = (locale ?? entryLocale) as Locale;\n\n        const filled =\n          entryUsedLocale !== configuration.internationalization.defaultLocale\n            ? true\n            : undefined;\n\n        if (shouldSplitByKeys) {\n          for (const [namespaceKey, namespaceContent] of Object.entries(json)) {\n            dictionaries.push({\n              key: namespaceKey,\n              locale: entryUsedLocale,\n              fill: filePath,\n              format,\n              localId:\n                `${namespaceKey}::${location}::${filePath}` as LocalDictionaryId,\n              location: location as Dictionary['location'],\n              filled,\n              content: namespaceContent as JSONContent,\n              filePath,\n              priority,\n            });\n          }\n          continue;\n        }\n\n        dictionaries.push({\n          key,\n          locale: entryUsedLocale,\n          fill: filePath,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled,\n          content: json,\n          filePath,\n          priority,\n        });\n      }\n\n      return dictionaries;\n    },\n  };\n};\n"],"mappings":";;;;;;;;AAyBA,MAAM,eAAe,OACnB,QACA,kBAC4B;CAC5B,MAAM,EAAE,QAAQ,yBAAyB;CAEzC,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,YAAY;CAEpB,MAAM,SAAyB,EAAE;AAEjC,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,oBAAoB,MAAM,qBAAqB,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;EAEnC,MAAM,oBAAoB,MAAM,qBAAqB,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;AAEnC,MAAI,CAAC,qBAAqB,CAAC,kBACzB;EAOF,MAAM,QAAQ,MAAM,GAJU,kBAAkB,WAAW,KAAK,GAC5D,kBAAkB,MAAM,EAAE,GAC1B,mBAE0C,EAC5C,KAAK,SACN,CAAC;AAEF,OAAK,MAAM,QAAQ,OAAO;GAMxB,MAAM,kBAAkB,kBAAkB,SAAS,iBAAiB;GACpE,MAAM,eAAe,kBAAkB,SAAS,cAAc;GAE9D,IAAI;GACJ,IAAI;AAEJ,OAAI,mBAAmB,cAAc;IACnC,MAAM,aAAa,4BACjB,MACA,mBACA,SACA,OACD;AAED,QAAI,CAAC,WACH;AAGF,UAAM,WAAW;AACjB,sBAAkB,WAAW;UACxB;AAGL,UAAM;AACN,sBAAkB;;GAGpB,MAAM,eAAe,WAAW,KAAK,GAAG,OAAO,QAAQ,SAAS,KAAK;GAErE,MAAM,aAAa;AACnB,OAAI,CAAC,OAAO,YACV,QAAO,cAAc,EAAE;AAGzB,UAAO,YAAY,OAA4B;;;AAMnD,QAAO;;AAKT,MAAM,qBAAqB,OACzB,QACA,kBACG;CAEH,MAAM,WAA2B,MAAM,aACrCA,QACA,cACD;AAwBD,QApBgB,OAAO,QAAQ,SAKqB,CAAC,SAClD,CAAC,QAAQ,gBACR,OAAO,QAAQ,WAAW,CAAC,KAAK,CAAC,KAAK,UAAU;AAK9C,SAAO;GACL,MALmB,WAAW,KAAK,GACjC,OACA,QAAQ,cAAc,OAAO,SAAS,KAAK;GAI7C;GACA;GACD;GACD,CAGoB;;AA6F5B,MAAa,YAAY,YAA2C;CAClE,MAAM,EAAE,UAAU,UAAU,QAAQ,WAAW;EAC7C,UAAU;EACV,UAAU;EACV,GAAG;EACJ;AAED,QAAO;EACL,MAAM;EAEN,kBAAkB,OAAO,EAAE,oBAAoB;GAC7C,MAAM,YAAY,aAAa,cAAc;GAC7C,MAAM,kBAAmC,MAAM,mBAC7C,QAAQ,QACR,cACD;AAED,OAAI,gBAAgB,WAAW,EAM7B,WACE,+DAA+D,aAAa,MANxD,qBAAqB,QAAQ,QAAQ;IACzD,KAAK;IACL,QAAQ;IACT,CAAkC,CAGmD,IACpF,EAAE,OAAO,QAAQ,CAClB;GAUH,MAAM,qBAAoB,MAJE,qBAAqB,QAAQ,QAAQ;IAC/D,KAAK;IACL,QAAQ;IACT,CAAkC,EACK,SAAS,UAAU;GAC3D,MAAM,oBAAoB,QAAQ,aAAa,CAAC;GAEhD,MAAM,eAA6B,EAAE;AAErC,QAAK,MAAM,EAAE,MAAM,KAAK,QAAQ,iBAAiB,iBAAiB;IAGhE,MAAM,OACH,MAAM,iBAAiB,MAAM,EAAE,UAAU,OAAO,CAAC,IAAK,EAAE;IAE3D,MAAM,WAAW,SAAS,cAAc,OAAO,SAAS,KAAK;IAI7D,MAAM,kBAAmB,UAAU;IAEnC,MAAM,SACJ,oBAAoB,cAAc,qBAAqB,gBACnD,OACA;AAEN,QAAI,mBAAmB;AACrB,UAAK,MAAM,CAAC,cAAc,qBAAqB,OAAO,QAAQ,KAAK,CACjE,cAAa,KAAK;MAChB,KAAK;MACL,QAAQ;MACR,MAAM;MACN;MACA,SACE,GAAG,aAAa,IAAI,SAAS,IAAI;MACzB;MACV;MACA,SAAS;MACT;MACA;MACD,CAAC;AAEJ;;AAGF,iBAAa,KAAK;KAChB;KACA,QAAQ;KACR,MAAM;KACN;KACA,SAAS,GAAG,IAAI,IAAI,SAAS,IAAI;KACvB;KACV;KACA,SAAS;KACT;KACA;KACD,CAAC;;AAGJ,UAAO;;EAEV"}

package/dist/esm/syncJSON.mjs

@@ -1,5 +1,6 @@
 import { dirname, isAbsolute, relative, resolve } from "node:path";
 import { loadExternalFile } from "@intlayer/config/file";
+import { colorizePath, getAppLogger } from "@intlayer/config/logger";
 import { parseFilePathPattern } from "@intlayer/config/utils";
 import fg from "fast-glob";
 import { mkdir, writeFile } from "node:fs/promises";
@@ -92,18 +93,26 @@ const loadMessagePathMap = async (source, configuration) => {
 	}));
 };
 const syncJSON = async (options) => {
+	const patternMarker = await parseFilePathPattern(options.source, {
+		key: "{{key}}",
+		locale: "{{locale}}"
+	});
 	const { location, priority, format } = {
-		location: `sync-json::${await parseFilePathPattern(options.source, {
-			key: "{{key}}",
-			locale: "{{locale}}"
-		})}`,
+		location: `sync-json::${patternMarker}`,
 		priority: 0,
 		...options
 	};
+	const hasKeyPlaceholder = patternMarker.includes("{{key}}");
+	const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;
 	return {
 		name: "sync-json",
 		loadDictionaries: async ({ configuration }) => {
+			const appLogger = getAppLogger(configuration);
 			const dictionariesMap = await loadMessagePathMap(options.source, configuration);
+			if (dictionariesMap.length === 0) appLogger(`[sync-json] No dictionaries found at locations matching source pattern: ${colorizePath(await parseFilePathPattern(options.source, {
+				key: "{{key}}",
+				locale: "{{locale}}"
+			}))}`, { level: "warn" });
 			let fill = await parseFilePathPattern(options.source, {
 				key: "{{key}}",
 				locale: "{{locale}}"
@@ -113,25 +122,41 @@ const syncJSON = async (options) => {
 			for (const { locale, path, key } of dictionariesMap) {
 				const json = await loadExternalFile(path, { logError: false }) ?? {};
 				const filePath = relative(configuration.system.baseDir, path);
-				const dictionary = {
+				const filled = locale !== configuration.internationalization.defaultLocale ? true : void 0;
+				if (shouldSplitByKeys) {
+					for (const [namespaceKey, namespaceContent] of Object.entries(json)) dictionaries.push({
+						key: namespaceKey,
+						locale,
+						fill,
+						format,
+						localId: `${namespaceKey}::${location}::${filePath}`,
+						location,
+						filled,
+						content: namespaceContent,
+						filePath,
+						priority
+					});
+					continue;
+				}
+				dictionaries.push({
 					key,
 					locale,
 					fill,
 					format,
 					localId: `${key}::${location}::${filePath}`,
 					location,
-					filled: locale !== configuration.internationalization.defaultLocale ? true : void 0,
+					filled,
 					content: json,
 					filePath,
 					priority
-				};
-				dictionaries.push(dictionary);
+				});
 			}
 			return dictionaries;
 		},
 		formatOutput: async ({ dictionary, configuration }) => {
 			const { formatDictionaryOutput } = await import("@intlayer/chokidar/build");
 			if (!dictionary.filePath || !dictionary.locale) return dictionary;
+			if (shouldSplitByKeys) return dictionary;
 			const builderPath = await parseFilePathPattern(options.source, {
 				key: dictionary.key,
 				locale: dictionary.locale
@@ -144,6 +169,32 @@ const syncJSON = async (options) => {
 			const { parallelize } = await import("@intlayer/chokidar/utils");
 			const { formatDictionaryOutput } = await import("@intlayer/chokidar/build");
 			const { locales } = configuration.internationalization;
+			if (shouldSplitByKeys) {
+				const mergedByLocale = {};
+				const filePathByLocale = {};
+				for (const [key, entry] of Object.entries(dictionaries.mergedDictionaries)) {
+					const dictionary = entry.dictionary;
+					if (dictionary.location !== location) continue;
+					for (const locale of locales) {
+						const formattedOutput = formatDictionaryOutput(getPerLocaleDictionary(dictionary, locale), format);
+						const content = JSON.parse(JSON.stringify(formattedOutput.content));
+						if (typeof content === "undefined" || typeof content === "object" && content !== null && Object.keys(content).length === 0) continue;
+						mergedByLocale[locale] ??= {};
+						mergedByLocale[locale][key] = content;
+						filePathByLocale[locale] = await parseFilePathPattern(options.source, {
+							key,
+							locale
+						});
+					}
+				}
+				await parallelize(Object.keys(mergedByLocale), async (locale) => {
+					const builderPath = filePathByLocale[locale];
+					if (!builderPath) return;
+					await mkdir(dirname(builderPath), { recursive: true });
+					await writeFile(builderPath, `${JSON.stringify(mergedByLocale[locale], null, 2)}\n`, "utf-8");
+				});
+				return;
+			}
 			await parallelize(Object.entries(dictionaries.mergedDictionaries).flatMap(([key, dictionary]) => locales.map((locale) => ({
 				key,
 				dictionary: dictionary.dictionary,

package/dist/esm/syncJSON.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"syncJSON.mjs","names":[],"sources":["../../src/syncJSON.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  DictionaryLocation,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst escapeRegex = (str: string) => str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\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 regexStr = `^${escapeRegex(normalizedMask)}$`;\n  regexStr = regexStr.replace(/\\\\\\*\\\\\\*/g, '.*'); // ** → match any path segments\n  regexStr = regexStr.replace(/\\\\\\*/g, '[^/]*'); // * → match within a single segment\n\n  regexStr = regexStr.replace(\n    escapeRegex(localePlaceholder),\n    `(?<locale>${localesAlternation})`\n  );\n\n  if (normalizedMask.includes(keyPlaceholder)) {\n    regexStr = regexStr.replace(escapeRegex(keyPlaceholder), '(?<key>.+)');\n  }\n\n  const maskRegex = new RegExp(regexStr);\n  const match = maskRegex.exec(normalizedFilePath);\n\n  if (!match?.groups) {\n    return null;\n  }\n\n  let locale = match.groups.locale as Locale | undefined;\n  let key = (match.groups.key as string | undefined) ?? 'index';\n\n  if (typeof key === 'undefined') {\n    key = 'index';\n  }\n\n  if (typeof locale === 'undefined') {\n    locale = defaultLocale;\n  }\n\n  return {\n    key,\n    locale,\n  };\n};\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      const extraction = extractKeyAndLocaleFromPath(\n        file,\n        maskPatternLocale,\n        locales,\n        locale\n      );\n\n      if (!extraction) {\n        continue;\n      }\n\n      const { key, locale: extractedLocale } = extraction;\n\n      // Generate what the path SHOULD be for this key/locale using the current builder\n      const expectedPath = await parseFilePathPattern(source, {\n        key,\n        locale: extractedLocale,\n      } as any as FilePathPatternContext);\n\n      // Resolve both to absolute paths to ensure safe comparison\n      const absoluteFoundPath = isAbsolute(file)\n        ? file\n        : resolve(baseDir, file);\n      const absoluteExpectedPath = isAbsolute(expectedPath)\n        ? expectedPath\n        : resolve(baseDir, expectedPath);\n\n      // If the file found doesn't exactly match the file expected, it belongs to another plugin/structure\n      if (absoluteFoundPath !== absoluteExpectedPath) {\n        continue;\n      }\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absoluteFoundPath;\n    }\n  }\n\n  // Ensure all declared locales are present even if the file doesn't exist yet\n  const maskWithKey = await parseFilePathPattern(source, {\n    key: '{{__KEY__}}',\n    locale: locales[0],\n  } as any as FilePathPatternContext);\n\n  const hasKeyInMask = maskWithKey.includes('{{__KEY__}}');\n  const discoveredKeys = new Set<string>();\n\n  for (const locale of Object.keys(result)) {\n    for (const key of Object.keys(result[locale as Locale] ?? {})) {\n      discoveredKeys.add(key);\n    }\n  }\n\n  if (!hasKeyInMask) {\n    discoveredKeys.add('index');\n  }\n\n  const keysToEnsure =\n    discoveredKeys.size > 0 ? Array.from(discoveredKeys) : [];\n\n  for (const locale of locales) {\n    if (!result[locale]) {\n      result[locale] = {} as Record<Dictionary['key'], FilePath>;\n    }\n\n    for (const key of keysToEnsure) {\n      if (!result[locale][key as Dictionary['key']]) {\n        const builtPath = await parseFilePathPattern(source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n        const absoluteBuiltPath = isAbsolute(builtPath)\n          ? builtPath\n          : resolve(baseDir, builtPath);\n\n        result[locale][key as Dictionary['key']] = absoluteBuiltPath;\n      }\n    }\n  }\n\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const messages: MessagesRecord = await listMessages(\n    source as FilePathPattern,\n    configuration\n  );\n\n  const dictionariesPathMap: DictionariesMap = Object.entries(messages).flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype SyncJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * ```ts\n   * syncJSON({\n   * source: ({ key, locale }) => `./messages/${locale}/${key}.json`\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * ```ts\n   * // Example usage:\n   * const config = {\n   *   plugins: [\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./resources/${locale}/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./messages/${locale}/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: DictionaryLocation | (string & {});\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionaries created by the plugin.\n   *\n   * Default: 'intlayer'\n   *\n   * The format of the dictionaries created by the plugin.\n   */\n  format?: DictionaryFormat;\n};\n\nexport const syncJSON = async (\n  options: SyncJSONPluginOptions\n): Promise<Plugin> => {\n  // Generate a unique default location based on the source pattern.\n  // This ensures that if you have multiple plugins, they don't share the same 'plugin' ID.\n  const patternMarker = await parseFilePathPattern(options.source, {\n    key: '{{key}}',\n    locale: '{{locale}}',\n  } as any as FilePathPatternContext);\n  const defaultLocation = `sync-json::${patternMarker}`;\n\n  const { location, priority, format } = {\n    location: defaultLocation,\n    priority: 0,\n    ...options,\n  };\n\n  return {\n    name: 'sync-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      let fill: string = await parseFilePathPattern(options.source, {\n        key: '{{key}}',\n        locale: '{{locale}}',\n      } as any as FilePathPatternContext);\n\n      if (fill) {\n        fill = relative(\n          configuration.system.baseDir,\n          resolve(configuration.system.baseDir, fill)\n        );\n      }\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { locale, path, key } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // the try/catch does not help here — use ?? {} to guarantee a plain object.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        const dictionary: Dictionary = {\n          key,\n          locale,\n          fill,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled:\n            locale !== configuration.internationalization.defaultLocale\n              ? true\n              : undefined,\n          content: json,\n          filePath,\n          priority,\n        };\n\n        dictionaries.push(dictionary);\n      }\n\n      return dictionaries;\n    },\n\n    formatOutput: async ({ dictionary, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n      const builderPath = await parseFilePathPattern(options.source, {\n        key: dictionary.key,\n        locale: dictionary.locale,\n      } as FilePathPatternContext);\n\n      // Verification to ensure we are formatting the correct file\n      if (\n        resolve(configuration.system.baseDir, builderPath) !==\n        resolve(configuration.system.baseDir, dictionary.filePath)\n      ) {\n        return dictionary;\n      }\n\n      const formattedOutput = formatDictionaryOutput(dictionary, format);\n\n      return formattedOutput.content;\n    },\n\n    afterBuild: async ({ dictionaries, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n      const { parallelize } = await import('@intlayer/chokidar/utils');\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      const { locales } = configuration.internationalization;\n\n      type RecordList = {\n        key: string;\n        dictionary: Dictionary;\n        locale: Locale;\n      };\n\n      // We get all dictionaries, but we need to filter them\n      const recordList: RecordList[] = Object.entries(\n        dictionaries.mergedDictionaries\n      ).flatMap(([key, dictionary]) =>\n        locales.map((locale) => ({\n          key,\n          dictionary: dictionary.dictionary as Dictionary,\n          locale,\n        }))\n      );\n\n      await parallelize(recordList, async ({ key, dictionary, locale }) => {\n        // Only process dictionaries that belong to THIS plugin instance.\n        if (dictionary.location !== location) {\n          return;\n        }\n\n        const builderPath = await parseFilePathPattern(options.source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n\n        const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n        const formattedOutput = formatDictionaryOutput(\n          localizedDictionary,\n          format\n        );\n\n        const content = JSON.parse(JSON.stringify(formattedOutput.content));\n\n        if (\n          typeof content === 'undefined' ||\n          (typeof content === 'object' &&\n            Object.keys(content as Record<string, unknown>).length === 0)\n        ) {\n          return;\n        }\n\n        await mkdir(dirname(builderPath), { recursive: true });\n\n        const stringContent = JSON.stringify(content, null, 2);\n\n        await writeFile(builderPath, `${stringContent}\\n`, 'utf-8');\n      });\n    },\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"syncJSON.mjs","names":[],"sources":["../../src/syncJSON.ts"],"sourcesContent":["import { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, relative, resolve } from 'node:path';\nimport { loadExternalFile } from '@intlayer/config/file';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type {\n  Dictionary,\n  DictionaryFormat,\n  DictionaryLocation,\n  LocalDictionaryId,\n} from '@intlayer/types/dictionary';\nimport type {\n  FilePathPattern,\n  FilePathPatternContext,\n} from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport fg from 'fast-glob';\n\ntype JSONContent = Record<string, any>;\n\ntype FilePath = string;\n\ntype MessagesRecord = Record<Locale, Record<Dictionary['key'], FilePath>>;\n\nconst escapeRegex = (str: string) => str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\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 regexStr = `^${escapeRegex(normalizedMask)}$`;\n  regexStr = regexStr.replace(/\\\\\\*\\\\\\*/g, '.*'); // ** → match any path segments\n  regexStr = regexStr.replace(/\\\\\\*/g, '[^/]*'); // * → match within a single segment\n\n  regexStr = regexStr.replace(\n    escapeRegex(localePlaceholder),\n    `(?<locale>${localesAlternation})`\n  );\n\n  if (normalizedMask.includes(keyPlaceholder)) {\n    regexStr = regexStr.replace(escapeRegex(keyPlaceholder), '(?<key>.+)');\n  }\n\n  const maskRegex = new RegExp(regexStr);\n  const match = maskRegex.exec(normalizedFilePath);\n\n  if (!match?.groups) {\n    return null;\n  }\n\n  let locale = match.groups.locale as Locale | undefined;\n  let key = (match.groups.key as string | undefined) ?? 'index';\n\n  if (typeof key === 'undefined') {\n    key = 'index';\n  }\n\n  if (typeof locale === 'undefined') {\n    locale = defaultLocale;\n  }\n\n  return {\n    key,\n    locale,\n  };\n};\n\nconst listMessages = async (\n  source: FilePathPattern,\n  configuration: IntlayerConfig\n): Promise<MessagesRecord> => {\n  const { system, internationalization } = configuration;\n\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(source, {\n      key: '**',\n      locale,\n    } as any as FilePathPatternContext);\n\n    const maskPatternLocale = await parseFilePathPattern(source, {\n      key: '{{__KEY__}}',\n      locale,\n    } as any as FilePathPatternContext);\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    for (const file of files) {\n      const extraction = extractKeyAndLocaleFromPath(\n        file,\n        maskPatternLocale,\n        locales,\n        locale\n      );\n\n      if (!extraction) {\n        continue;\n      }\n\n      const { key, locale: extractedLocale } = extraction;\n\n      // Generate what the path SHOULD be for this key/locale using the current builder\n      const expectedPath = await parseFilePathPattern(source, {\n        key,\n        locale: extractedLocale,\n      } as any as FilePathPatternContext);\n\n      // Resolve both to absolute paths to ensure safe comparison\n      const absoluteFoundPath = isAbsolute(file)\n        ? file\n        : resolve(baseDir, file);\n      const absoluteExpectedPath = isAbsolute(expectedPath)\n        ? expectedPath\n        : resolve(baseDir, expectedPath);\n\n      // If the file found doesn't exactly match the file expected, it belongs to another plugin/structure\n      if (absoluteFoundPath !== absoluteExpectedPath) {\n        continue;\n      }\n\n      const usedLocale = extractedLocale as Locale;\n      if (!result[usedLocale]) {\n        result[usedLocale] = {};\n      }\n\n      result[usedLocale][key as Dictionary['key']] = absoluteFoundPath;\n    }\n  }\n\n  // Ensure all declared locales are present even if the file doesn't exist yet\n  const maskWithKey = await parseFilePathPattern(source, {\n    key: '{{__KEY__}}',\n    locale: locales[0],\n  } as any as FilePathPatternContext);\n\n  const hasKeyInMask = maskWithKey.includes('{{__KEY__}}');\n  const discoveredKeys = new Set<string>();\n\n  for (const locale of Object.keys(result)) {\n    for (const key of Object.keys(result[locale as Locale] ?? {})) {\n      discoveredKeys.add(key);\n    }\n  }\n\n  if (!hasKeyInMask) {\n    discoveredKeys.add('index');\n  }\n\n  const keysToEnsure =\n    discoveredKeys.size > 0 ? Array.from(discoveredKeys) : [];\n\n  for (const locale of locales) {\n    if (!result[locale]) {\n      result[locale] = {} as Record<Dictionary['key'], FilePath>;\n    }\n\n    for (const key of keysToEnsure) {\n      if (!result[locale][key as Dictionary['key']]) {\n        const builtPath = await parseFilePathPattern(source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n        const absoluteBuiltPath = isAbsolute(builtPath)\n          ? builtPath\n          : resolve(baseDir, builtPath);\n\n        result[locale][key as Dictionary['key']] = absoluteBuiltPath;\n      }\n    }\n  }\n\n  return result;\n};\n\ntype DictionariesMap = { path: string; locale: Locale; key: string }[];\n\nconst loadMessagePathMap = async (\n  source: MessagesRecord | FilePathPattern,\n  configuration: IntlayerConfig\n) => {\n  const messages: MessagesRecord = await listMessages(\n    source as FilePathPattern,\n    configuration\n  );\n\n  const dictionariesPathMap: DictionariesMap = Object.entries(messages).flatMap(\n    ([locale, keysRecord]) =>\n      Object.entries(keysRecord).map(([key, path]) => {\n        const absolutePath = isAbsolute(path)\n          ? path\n          : resolve(configuration.system.baseDir, path);\n\n        return {\n          path: absolutePath,\n          locale,\n          key,\n        } as DictionariesMap[number];\n      })\n  );\n\n  return dictionariesPathMap;\n};\n\ntype SyncJSONPluginOptions = {\n  /**\n   * The source of the plugin.\n   * Is a function to build the source from the key and locale.\n   *\n   * ```ts\n   * syncJSON({\n   * source: ({ key, locale }) => `./messages/${locale}/${key}.json`\n   * })\n   * ```\n   */\n  source: FilePathPattern;\n\n  /**\n   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.\n   * Used to identify the plugin in the dictionary.\n   *\n   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.\n   *\n   * ```ts\n   * // Example usage:\n   * const config = {\n   *   plugins: [\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./resources/${locale}/${key}.json`,\n   *       location: 'plugin-i18next',\n   *     }),\n   *     syncJSON({\n   *       source: ({ key, locale }) => `./messages/${locale}/${key}.json`,\n   *       location: 'plugin-next-intl',\n   *     }),\n   *   ]\n   * }\n   * ```\n   */\n  location?: DictionaryLocation | (string & {});\n\n  /**\n   * The priority of the dictionaries created by the plugin.\n   *\n   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.\n   *\n   * Default is -1. (.content file priority is 0)\n   *\n   */\n  priority?: number;\n\n  /**\n   * The format of the dictionaries created by the plugin.\n   *\n   * Default: 'intlayer'\n   *\n   * The format of the dictionaries created by the plugin.\n   */\n  format?: DictionaryFormat;\n\n  /**\n   * Whether each top-level key of the JSON file should become its own\n   * dictionary (keyed by that top-level key) instead of a single dictionary\n   * holding the whole file.\n   *\n   * This matches the namespace model of libraries such as `next-intl` /\n   * `react-intl`, where a single `messages/{locale}.json` file groups several\n   * namespaces by its first-level keys and each namespace is addressed\n   * independently (e.g. `useTranslations('Hero')` → dictionary `Hero`).\n   *\n   * When omitted, it is auto-detected: the file is split when the `source`\n   * pattern has no `{{key}}` segment (i.e. one file holds every namespace),\n   * and kept as a single dictionary otherwise (one file per key).\n   *\n   * @example\n   * ```ts\n   * // messages/en.json → dictionaries: Hero, Nav, About, …\n   * syncJSON({\n   *   source: ({ locale }) => `./messages/${locale}.json`,\n   *   splitKeys: true,\n   * })\n   * ```\n   */\n  splitKeys?: boolean;\n};\n\nexport const syncJSON = async (\n  options: SyncJSONPluginOptions\n): Promise<Plugin> => {\n  // Generate a unique default location based on the source pattern.\n  // This ensures that if you have multiple plugins, they don't share the same 'plugin' ID.\n  const patternMarker = await parseFilePathPattern(options.source, {\n    key: '{{key}}',\n    locale: '{{locale}}',\n  } as any as FilePathPatternContext);\n  const defaultLocation = `sync-json::${patternMarker}`;\n\n  const { location, priority, format } = {\n    location: defaultLocation,\n    priority: 0,\n    ...options,\n  };\n\n  // When the source pattern has no `{{key}}` segment, a single file holds every\n  // namespace as a first-level key (the next-intl / react-intl model). In that\n  // case each top-level key becomes its own dictionary. Can be forced via the\n  // `splitKeys` option.\n  const hasKeyPlaceholder = patternMarker.includes('{{key}}');\n  const shouldSplitByKeys = options.splitKeys ?? !hasKeyPlaceholder;\n\n  return {\n    name: 'sync-json',\n\n    loadDictionaries: async ({ configuration }) => {\n      const appLogger = getAppLogger(configuration);\n      const dictionariesMap: DictionariesMap = await loadMessagePathMap(\n        options.source,\n        configuration\n      );\n\n      if (dictionariesMap.length === 0) {\n        const pattern = await parseFilePathPattern(options.source, {\n          key: '{{key}}',\n          locale: '{{locale}}',\n        } as any as FilePathPatternContext);\n\n        appLogger(\n          `[sync-json] No dictionaries found at locations matching source pattern: ${colorizePath(pattern)}`,\n          { level: 'warn' }\n        );\n      }\n\n      let fill: string = await parseFilePathPattern(options.source, {\n        key: '{{key}}',\n        locale: '{{locale}}',\n      } as any as FilePathPatternContext);\n\n      if (fill) {\n        fill = relative(\n          configuration.system.baseDir,\n          resolve(configuration.system.baseDir, fill)\n        );\n      }\n\n      const dictionaries: Dictionary[] = [];\n\n      for (const { locale, path, key } of dictionariesMap) {\n        // loadExternalFile swallows errors and returns undefined for missing files;\n        // the try/catch does not help here — use ?? {} to guarantee a plain object.\n        const json: JSONContent =\n          (await loadExternalFile(path, { logError: false })) ?? {};\n\n        const filePath = relative(configuration.system.baseDir, path);\n\n        const filled =\n          locale !== configuration.internationalization.defaultLocale\n            ? true\n            : undefined;\n\n        // One file 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(json)) {\n            dictionaries.push({\n              key: namespaceKey,\n              locale,\n              fill,\n              format,\n              localId:\n                `${namespaceKey}::${location}::${filePath}` as LocalDictionaryId,\n              location: location as Dictionary['location'],\n              filled,\n              content: namespaceContent as JSONContent,\n              filePath,\n              priority,\n            });\n          }\n          continue;\n        }\n\n        dictionaries.push({\n          key,\n          locale,\n          fill,\n          format,\n          localId: `${key}::${location}::${filePath}` as LocalDictionaryId,\n          location: location as Dictionary['location'],\n          filled,\n          content: json,\n          filePath,\n          priority,\n        });\n      }\n\n      return dictionaries;\n    },\n\n    formatOutput: async ({ dictionary, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n      // In split mode several namespaces share the same file; the file is\n      // re-assembled in `afterBuild`. Skip here to avoid overwriting the whole\n      // file with a single namespace.\n      if (shouldSplitByKeys) return dictionary;\n\n      const builderPath = await parseFilePathPattern(options.source, {\n        key: dictionary.key,\n        locale: dictionary.locale,\n      } as FilePathPatternContext);\n\n      // Verification to ensure we are formatting the correct file\n      if (\n        resolve(configuration.system.baseDir, builderPath) !==\n        resolve(configuration.system.baseDir, dictionary.filePath)\n      ) {\n        return dictionary;\n      }\n\n      const formattedOutput = formatDictionaryOutput(dictionary, format);\n\n      return formattedOutput.content;\n    },\n\n    afterBuild: async ({ dictionaries, configuration }) => {\n      // Lazy import intlayer modules to avoid circular dependencies\n      const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n      const { parallelize } = await import('@intlayer/chokidar/utils');\n      const { formatDictionaryOutput } = await import(\n        '@intlayer/chokidar/build'\n      );\n\n      const { locales } = configuration.internationalization;\n\n      // Split mode: every namespace dictionary writes back into the same\n      // per-locale file. Re-assemble them under their top-level key and write\n      // each file once, instead of one file per key (which would overwrite).\n      if (shouldSplitByKeys) {\n        const mergedByLocale: Record<string, Record<string, unknown>> = {};\n        const filePathByLocale: Record<string, string> = {};\n\n        for (const [key, entry] of Object.entries(\n          dictionaries.mergedDictionaries\n        )) {\n          const dictionary = entry.dictionary as Dictionary;\n\n          // Only process dictionaries that belong to THIS plugin instance.\n          if (dictionary.location !== location) continue;\n\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 = JSON.parse(JSON.stringify(formattedOutput.content));\n\n            if (\n              typeof content === 'undefined' ||\n              (typeof content === 'object' &&\n                content !== null &&\n                Object.keys(content as Record<string, unknown>).length === 0)\n            ) {\n              continue;\n            }\n\n            mergedByLocale[locale] ??= {};\n            mergedByLocale[locale][key] = content;\n            filePathByLocale[locale] = await parseFilePathPattern(\n              options.source,\n              { key, locale } as any as FilePathPatternContext\n            );\n          }\n        }\n\n        await parallelize(Object.keys(mergedByLocale), async (locale) => {\n          const builderPath = filePathByLocale[locale];\n\n          if (!builderPath) return;\n\n          await mkdir(dirname(builderPath), { recursive: true });\n\n          const stringContent = JSON.stringify(mergedByLocale[locale], null, 2);\n\n          await writeFile(builderPath, `${stringContent}\\n`, 'utf-8');\n        });\n\n        return;\n      }\n\n      type RecordList = {\n        key: string;\n        dictionary: Dictionary;\n        locale: Locale;\n      };\n\n      // We get all dictionaries, but we need to filter them\n      const recordList: RecordList[] = Object.entries(\n        dictionaries.mergedDictionaries\n      ).flatMap(([key, dictionary]) =>\n        locales.map((locale) => ({\n          key,\n          dictionary: dictionary.dictionary as Dictionary,\n          locale,\n        }))\n      );\n\n      await parallelize(recordList, async ({ key, dictionary, locale }) => {\n        // Only process dictionaries that belong to THIS plugin instance.\n        if (dictionary.location !== location) {\n          return;\n        }\n\n        const builderPath = await parseFilePathPattern(options.source, {\n          key,\n          locale,\n        } as any as FilePathPatternContext);\n\n        const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n        const formattedOutput = formatDictionaryOutput(\n          localizedDictionary,\n          format\n        );\n\n        const content = JSON.parse(JSON.stringify(formattedOutput.content));\n\n        if (\n          typeof content === 'undefined' ||\n          (typeof content === 'object' &&\n            Object.keys(content as Record<string, unknown>).length === 0)\n        ) {\n          return;\n        }\n\n        await mkdir(dirname(builderPath), { recursive: true });\n\n        const stringContent = JSON.stringify(content, null, 2);\n\n        await writeFile(builderPath, `${stringContent}\\n`, 'utf-8');\n      });\n    },\n  };\n};\n"],"mappings":";;;;;;;;AA0BA,MAAM,eAAe,QAAgB,IAAI,QAAQ,uBAAuB,OAAO;AAE/E,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,WAAW,IAAI,YAAY,eAAe,CAAC;AAC/C,YAAW,SAAS,QAAQ,aAAa,KAAK;AAC9C,YAAW,SAAS,QAAQ,SAAS,QAAQ;AAE7C,YAAW,SAAS,QAClB,YAAY,kBAAkB,EAC9B,aAAa,mBAAmB,GACjC;AAED,KAAI,eAAe,SAAS,eAAe,CACzC,YAAW,SAAS,QAAQ,YAAY,eAAe,EAAE,aAAa;CAIxE,MAAM,QAAQ,IADQ,OAAO,SACN,CAAC,KAAK,mBAAmB;AAEhD,KAAI,CAAC,OAAO,OACV,QAAO;CAGT,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,MAAO,MAAM,OAAO,OAA8B;AAEtD,KAAI,OAAO,QAAQ,YACjB,OAAM;AAGR,KAAI,OAAO,WAAW,YACpB,UAAS;AAGX,QAAO;EACL;EACA;EACD;;AAGH,MAAM,eAAe,OACnB,QACA,kBAC4B;CAC5B,MAAM,EAAE,QAAQ,yBAAyB;CAEzC,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,YAAY;CAEpB,MAAM,SAAyB,EAAE;AAEjC,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,oBAAoB,MAAM,qBAAqB,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;EAEnC,MAAM,oBAAoB,MAAM,qBAAqB,QAAQ;GAC3D,KAAK;GACL;GACD,CAAkC;AAEnC,MAAI,CAAC,qBAAqB,CAAC,kBACzB;EAOF,MAAM,QAAQ,MAAM,GAJU,kBAAkB,WAAW,KAAK,GAC5D,kBAAkB,MAAM,EAAE,GAC1B,mBAE0C,EAC5C,KAAK,SACN,CAAC;AAEF,OAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,aAAa,4BACjB,MACA,mBACA,SACA,OACD;AAED,OAAI,CAAC,WACH;GAGF,MAAM,EAAE,KAAK,QAAQ,oBAAoB;GAGzC,MAAM,eAAe,MAAM,qBAAqB,QAAQ;IACtD;IACA,QAAQ;IACT,CAAkC;GAGnC,MAAM,oBAAoB,WAAW,KAAK,GACtC,OACA,QAAQ,SAAS,KAAK;AAM1B,OAAI,uBALyB,WAAW,aAAa,GACjD,eACA,QAAQ,SAAS,aAAa,EAIhC;GAGF,MAAM,aAAa;AACnB,OAAI,CAAC,OAAO,YACV,QAAO,cAAc,EAAE;AAGzB,UAAO,YAAY,OAA4B;;;CAUnD,MAAM,gBAAe,MALK,qBAAqB,QAAQ;EACrD,KAAK;EACL,QAAQ,QAAQ;EACjB,CAAkC,EAEF,SAAS,cAAc;CACxD,MAAM,iCAAiB,IAAI,KAAa;AAExC,MAAK,MAAM,UAAU,OAAO,KAAK,OAAO,CACtC,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,WAAqB,EAAE,CAAC,CAC3D,gBAAe,IAAI,IAAI;AAI3B,KAAI,CAAC,aACH,gBAAe,IAAI,QAAQ;CAG7B,MAAM,eACJ,eAAe,OAAO,IAAI,MAAM,KAAK,eAAe,GAAG,EAAE;AAE3D,MAAK,MAAM,UAAU,SAAS;AAC5B,MAAI,CAAC,OAAO,QACV,QAAO,UAAU,EAAE;AAGrB,OAAK,MAAM,OAAO,aAChB,KAAI,CAAC,OAAO,QAAQ,MAA2B;GAC7C,MAAM,YAAY,MAAM,qBAAqB,QAAQ;IACnD;IACA;IACD,CAAkC;GACnC,MAAM,oBAAoB,WAAW,UAAU,GAC3C,YACA,QAAQ,SAAS,UAAU;AAE/B,UAAO,QAAQ,OAA4B;;;AAKjD,QAAO;;AAKT,MAAM,qBAAqB,OACzB,QACA,kBACG;CACH,MAAM,WAA2B,MAAM,aACrC,QACA,cACD;AAiBD,QAf6C,OAAO,QAAQ,SAAS,CAAC,SACnE,CAAC,QAAQ,gBACR,OAAO,QAAQ,WAAW,CAAC,KAAK,CAAC,KAAK,UAAU;AAK9C,SAAO;GACL,MALmB,WAAW,KAAK,GACjC,OACA,QAAQ,cAAc,OAAO,SAAS,KAAK;GAI7C;GACA;GACD;GACD,CAGoB;;AAqF5B,MAAa,WAAW,OACtB,YACoB;CAGpB,MAAM,gBAAgB,MAAM,qBAAqB,QAAQ,QAAQ;EAC/D,KAAK;EACL,QAAQ;EACT,CAAkC;CAGnC,MAAM,EAAE,UAAU,UAAU,WAAW;EACrC,UAAU,cAH0B;EAIpC,UAAU;EACV,GAAG;EACJ;CAMD,MAAM,oBAAoB,cAAc,SAAS,UAAU;CAC3D,MAAM,oBAAoB,QAAQ,aAAa,CAAC;AAEhD,QAAO;EACL,MAAM;EAEN,kBAAkB,OAAO,EAAE,oBAAoB;GAC7C,MAAM,YAAY,aAAa,cAAc;GAC7C,MAAM,kBAAmC,MAAM,mBAC7C,QAAQ,QACR,cACD;AAED,OAAI,gBAAgB,WAAW,EAM7B,WACE,2EAA2E,aAAa,MANpE,qBAAqB,QAAQ,QAAQ;IACzD,KAAK;IACL,QAAQ;IACT,CAAkC,CAG+D,IAChG,EAAE,OAAO,QAAQ,CAClB;GAGH,IAAI,OAAe,MAAM,qBAAqB,QAAQ,QAAQ;IAC5D,KAAK;IACL,QAAQ;IACT,CAAkC;AAEnC,OAAI,KACF,QAAO,SACL,cAAc,OAAO,SACrB,QAAQ,cAAc,OAAO,SAAS,KAAK,CAC5C;GAGH,MAAM,eAA6B,EAAE;AAErC,QAAK,MAAM,EAAE,QAAQ,MAAM,SAAS,iBAAiB;IAGnD,MAAM,OACH,MAAM,iBAAiB,MAAM,EAAE,UAAU,OAAO,CAAC,IAAK,EAAE;IAE3D,MAAM,WAAW,SAAS,cAAc,OAAO,SAAS,KAAK;IAE7D,MAAM,SACJ,WAAW,cAAc,qBAAqB,gBAC1C,OACA;AAIN,QAAI,mBAAmB;AACrB,UAAK,MAAM,CAAC,cAAc,qBAAqB,OAAO,QAAQ,KAAK,CACjE,cAAa,KAAK;MAChB,KAAK;MACL;MACA;MACA;MACA,SACE,GAAG,aAAa,IAAI,SAAS,IAAI;MACzB;MACV;MACA,SAAS;MACT;MACA;MACD,CAAC;AAEJ;;AAGF,iBAAa,KAAK;KAChB;KACA;KACA;KACA;KACA,SAAS,GAAG,IAAI,IAAI,SAAS,IAAI;KACvB;KACV;KACA,SAAS;KACT;KACA;KACD,CAAC;;AAGJ,UAAO;;EAGT,cAAc,OAAO,EAAE,YAAY,oBAAoB;GAErD,MAAM,EAAE,2BAA2B,MAAM,OACvC;AAGF,OAAI,CAAC,WAAW,YAAY,CAAC,WAAW,OAAQ,QAAO;AAKvD,OAAI,kBAAmB,QAAO;GAE9B,MAAM,cAAc,MAAM,qBAAqB,QAAQ,QAAQ;IAC7D,KAAK,WAAW;IAChB,QAAQ,WAAW;IACpB,CAA2B;AAG5B,OACE,QAAQ,cAAc,OAAO,SAAS,YAAY,KAClD,QAAQ,cAAc,OAAO,SAAS,WAAW,SAAS,CAE1D,QAAO;AAKT,UAFwB,uBAAuB,YAAY,OAErC,CAAC;;EAGzB,YAAY,OAAO,EAAE,cAAc,oBAAoB;GAErD,MAAM,EAAE,2BAA2B,MAAM,OAAO;GAChD,MAAM,EAAE,gBAAgB,MAAM,OAAO;GACrC,MAAM,EAAE,2BAA2B,MAAM,OACvC;GAGF,MAAM,EAAE,YAAY,cAAc;AAKlC,OAAI,mBAAmB;IACrB,MAAM,iBAA0D,EAAE;IAClE,MAAM,mBAA2C,EAAE;AAEnD,SAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAChC,aAAa,mBACd,EAAE;KACD,MAAM,aAAa,MAAM;AAGzB,SAAI,WAAW,aAAa,SAAU;AAEtC,UAAK,MAAM,UAAU,SAAS;MAM5B,MAAM,kBAAkB,uBALI,uBAC1B,YACA,OAImB,EACnB,OACD;MAED,MAAM,UAAU,KAAK,MAAM,KAAK,UAAU,gBAAgB,QAAQ,CAAC;AAEnE,UACE,OAAO,YAAY,eAClB,OAAO,YAAY,YAClB,YAAY,QACZ,OAAO,KAAK,QAAmC,CAAC,WAAW,EAE7D;AAGF,qBAAe,YAAY,EAAE;AAC7B,qBAAe,QAAQ,OAAO;AAC9B,uBAAiB,UAAU,MAAM,qBAC/B,QAAQ,QACR;OAAE;OAAK;OAAQ,CAChB;;;AAIL,UAAM,YAAY,OAAO,KAAK,eAAe,EAAE,OAAO,WAAW;KAC/D,MAAM,cAAc,iBAAiB;AAErC,SAAI,CAAC,YAAa;AAElB,WAAM,MAAM,QAAQ,YAAY,EAAE,EAAE,WAAW,MAAM,CAAC;AAItD,WAAM,UAAU,aAAa,GAFP,KAAK,UAAU,eAAe,SAAS,MAAM,EAEtB,CAAC,KAAK,QAAQ;MAC3D;AAEF;;AAoBF,SAAM,YAV2B,OAAO,QACtC,aAAa,mBACd,CAAC,SAAS,CAAC,KAAK,gBACf,QAAQ,KAAK,YAAY;IACvB;IACA,YAAY,WAAW;IACvB;IACD,EAAE,CAGuB,EAAE,OAAO,EAAE,KAAK,YAAY,aAAa;AAEnE,QAAI,WAAW,aAAa,SAC1B;IAGF,MAAM,cAAc,MAAM,qBAAqB,QAAQ,QAAQ;KAC7D;KACA;KACD,CAAkC;IAInC,MAAM,kBAAkB,uBAFI,uBAAuB,YAAY,OAG1C,EACnB,OACD;IAED,MAAM,UAAU,KAAK,MAAM,KAAK,UAAU,gBAAgB,QAAQ,CAAC;AAEnE,QACE,OAAO,YAAY,eAClB,OAAO,YAAY,YAClB,OAAO,KAAK,QAAmC,CAAC,WAAW,EAE7D;AAGF,UAAM,MAAM,QAAQ,YAAY,EAAE,EAAE,WAAW,MAAM,CAAC;AAItD,UAAM,UAAU,aAAa,GAFP,KAAK,UAAU,SAAS,MAAM,EAEP,CAAC,KAAK,QAAQ;KAC3D;;EAEL"}

package/dist/types/loadJSON.d.ts

@@ -74,6 +74,19 @@ type LoadJSONPluginOptions = {
    * ```
    */
   format?: DictionaryFormat;
+  /**
+   * Whether each top-level key of the JSON file should become its own
+   * dictionary (keyed by that top-level key) instead of a single dictionary
+   * holding the whole file.
+   *
+   * This matches the namespace model of libraries such as `next-intl` /
+   * `react-intl`, where a single `messages/{locale}.json` file groups several
+   * namespaces by its first-level keys.
+   *
+   * When omitted, it is auto-detected: the file is split when the `source`
+   * pattern has no `{{key}}` segment, and kept as a single dictionary otherwise.
+   */
+  splitKeys?: boolean;
 };
 declare const loadJSON: (options: LoadJSONPluginOptions) => Plugin;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"loadJSON.d.ts","names":[],"sources":["../../src/loadJSON.ts"],"mappings":";;;;;;KAgJK,qBAAA;;AAlIgD;;;;;;;;;;EA8InD,MAAA,EAAQ,eAAA;EAeC;;;;;;;AAiDX;;;;;;EAjDE,MAAA,GAAS,MAAA;EAqGV;;;;;;;;;;;;;;;;;;;;;;EA7EC,QAAA;;;;;;;;;EAUA,QAAA;;;;;;;;;;;EAYA,MAAA,GAAS,gBAAA;AAAA;AAAA,cAGE,QAAA,GAAY,OAAA,EAAS,qBAAA,KAAwB,MAAA"}
+{"version":3,"file":"loadJSON.d.ts","names":[],"sources":["../../src/loadJSON.ts"],"mappings":";;;;;;KAiJK,qBAAA;;AAlIgD;;;;;;;;;;EA8InD,MAAA,EAAQ,eAAA;EAeC;;;;;;;;AA+DX;;;;;EA/DE,MAAA,GAAS,MAAA;EA+D+C;;;;;;;;;;;;;;;;;;;;;;EAvCxD,QAAA;;;;;;;;;EAUA,QAAA;;;;;;;;;;;EAYA,MAAA,GAAS,gBAAA;;;;;;;;;;;;;EAcT,SAAA;AAAA;AAAA,cAGW,QAAA,GAAY,OAAA,EAAS,qBAAA,KAAwB,MAAA"}

package/dist/types/syncJSON.d.ts

@@ -60,6 +60,30 @@ type SyncJSONPluginOptions = {
    * The format of the dictionaries created by the plugin.
    */
   format?: DictionaryFormat;
+  /**
+   * Whether each top-level key of the JSON file should become its own
+   * dictionary (keyed by that top-level key) instead of a single dictionary
+   * holding the whole file.
+   *
+   * This matches the namespace model of libraries such as `next-intl` /
+   * `react-intl`, where a single `messages/{locale}.json` file groups several
+   * namespaces by its first-level keys and each namespace is addressed
+   * independently (e.g. `useTranslations('Hero')` → dictionary `Hero`).
+   *
+   * When omitted, it is auto-detected: the file is split when the `source`
+   * pattern has no `{{key}}` segment (i.e. one file holds every namespace),
+   * and kept as a single dictionary otherwise (one file per key).
+   *
+   * @example
+   * ```ts
+   * // messages/en.json → dictionaries: Hero, Nav, About, …
+   * syncJSON({
+   *   source: ({ locale }) => `./messages/${locale}.json`,
+   *   splitKeys: true,
+   * })
+   * ```
+   */
+  splitKeys?: boolean;
 };
 declare const syncJSON: (options: SyncJSONPluginOptions) => Promise<Plugin>;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"syncJSON.d.ts","names":[],"sources":["../../src/syncJSON.ts"],"mappings":";;;;;;cA2Ba,2BAAA,GACX,QAAA,UACA,WAAA,UACA,OAAA,EAAS,MAAA,IACT,aAAA,EAAe,MAAA;EACZ,GAAA;EAAa,MAAA,EAAQ,MAAA;AAAA;AAAA,KA0MrB,qBAAA;EA5MM;;;;;;;;;;EAuNT,MAAA,EAAQ,eAAA;EArNL;;;;;AAkDH;;;;;;;;;;;;;;;;;EA2LA,QAAA,GAAW,kBAAA;EAqLZ;;;;;;;;EA3KC,QAAA;EAcC;;;;;;;EALD,MAAA,GAAS,gBAAA;AAAA;AAAA,cAGE,QAAA,GACX,OAAA,EAAS,qBAAA,KACR,OAAA,CAAQ,MAAA"}
+{"version":3,"file":"syncJSON.d.ts","names":[],"sources":["../../src/syncJSON.ts"],"mappings":";;;;;;cA4Ba,2BAAA,GACX,QAAA,UACA,WAAA,UACA,OAAA,EAAS,MAAA,IACT,aAAA,EAAe,MAAA;EACZ,GAAA;EAAa,MAAA,EAAQ,MAAA;AAAA;AAAA,KA0MrB,qBAAA;EA5MM;;;;;;;;;;EAuNT,MAAA,EAAQ,eAAA;EArNL;;;;;AAkDH;;;;;;;;;;;;;;;;;EA2LA,QAAA,GAAW,kBAAA;EA+CA;;;;;;;;EArCX,QAAA;EAsCA;;;;;;;EA7BA,MAAA,GAAS,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;EAyBT,SAAA;AAAA;AAAA,cAGW,QAAA,GACX,OAAA,EAAS,qBAAA,KACR,OAAA,CAAQ,MAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/sync-json-plugin",
-  "version": "8.12.5-canary.0",
+  "version": "9.0.0-canary.3",
   "private": false,
   "description": "A plugin for Intlayer that syncs JSON files to dictionaries.",
   "keywords": [
@@ -71,21 +71,21 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/chokidar": "8.12.5-canary.0",
-    "@intlayer/config": "8.12.5-canary.0",
-    "@intlayer/core": "8.12.5-canary.0",
-    "@intlayer/types": "8.12.5-canary.0",
+    "@intlayer/chokidar": "9.0.0-canary.3",
+    "@intlayer/config": "9.0.0-canary.3",
+    "@intlayer/core": "9.0.0-canary.3",
+    "@intlayer/types": "9.0.0-canary.3",
     "fast-glob": "3.3.3"
   },
   "devDependencies": {
-    "@types/node": "25.9.2",
+    "@types/node": "25.9.3",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
     "rimraf": "6.1.3",
     "tsdown": "0.21.10",
     "typescript": "6.0.3",
-    "vitest": "4.1.8"
+    "vitest": "4.1.9"
   },
   "engines": {
     "node": ">=14.18"