@intlayer/sync-json-plugin 9.0.0-canary.2 → 9.0.0-canary.20

package/dist/cjs/index.cjs

@@ -1,7 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_syncJSON = require('./syncJSON.cjs');
+const require_jsonCodec = require('./jsonCodec.cjs');
 const require_loadJSON = require('./loadJSON.cjs');
+const require_syncJSON = require('./syncJSON.cjs');
+let _intlayer_engine_syncPluginKit = require("@intlayer/engine/syncPluginKit");
 
-exports.extractKeyAndLocaleFromPath = require_syncJSON.extractKeyAndLocaleFromPath;
+Object.defineProperty(exports, 'extractKeyAndLocaleFromPath', {
+  enumerable: true,
+  get: function () {
+    return _intlayer_engine_syncPluginKit.extractKeyAndLocaleFromPath;
+  }
+});
+exports.jsonCodec = require_jsonCodec.jsonCodec;
 exports.loadJSON = require_loadJSON.loadJSON;
+exports.readJSONEntry = require_jsonCodec.readJSONEntry;
 exports.syncJSON = require_syncJSON.syncJSON;

package/dist/cjs/jsonCodec.cjs

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _intlayer_config_file = require("@intlayer/config/file");
+
+//#region src/jsonCodec.ts
+/**
+* JSON payload codec: standard JSON parsing, pretty-printed serialization
+* (2-space indentation, trailing newline).
+*/
+const jsonCodec = {
+	parse: (raw) => JSON.parse(raw),
+	serialize: (content) => `${JSON.stringify(content, null, 2)}\n`
+};
+/**
+* Read one JSON source through `loadExternalFile`, which also supports JSON5,
+* JSONC and transpiled JS/TS message files. Returns `undefined` for missing or
+* unreadable files so callers fall back to empty content.
+*/
+const readJSONEntry = async (absoluteFilePath) => await (0, _intlayer_config_file.loadExternalFile)(absoluteFilePath, { logError: false });
+
+//#endregion
+exports.jsonCodec = jsonCodec;
+exports.readJSONEntry = readJSONEntry;
+//# sourceMappingURL=jsonCodec.cjs.map

package/dist/cjs/jsonCodec.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonCodec.cjs","names":[],"sources":["../../src/jsonCodec.ts"],"sourcesContent":["import { loadExternalFile } from '@intlayer/config/file';\nimport type { FormatCodec, SyncContent } from '@intlayer/engine/syncPluginKit';\n\n/**\n * JSON payload codec: standard JSON parsing, pretty-printed serialization\n * (2-space indentation, trailing newline).\n */\nexport const jsonCodec: FormatCodec = {\n  parse: (raw) => JSON.parse(raw),\n  serialize: (content) => `${JSON.stringify(content, null, 2)}\\n`,\n};\n\n/**\n * Read one JSON source through `loadExternalFile`, which also supports JSON5,\n * JSONC and transpiled JS/TS message files. Returns `undefined` for missing or\n * unreadable files so callers fall back to empty content.\n */\nexport const readJSONEntry = async (\n  absoluteFilePath: string\n): Promise<SyncContent | undefined> =>\n  await loadExternalFile(absoluteFilePath, { logError: false });\n"],"mappings":";;;;;;;;AAOA,MAAa,YAAyB;CACpC,QAAQ,QAAQ,KAAK,MAAM,GAAG;CAC9B,YAAY,YAAY,GAAG,KAAK,UAAU,SAAS,MAAM,CAAC,EAAE;AAC9D;;;;;;AAOA,MAAa,gBAAgB,OAC3B,qBAEA,kDAAuB,kBAAkB,EAAE,UAAU,MAAM,CAAC"}

package/dist/cjs/loadJSON.cjs

@@ -1,100 +1,27 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-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);
+const require_jsonCodec = require('./jsonCodec.cjs');
+let _intlayer_engine_syncPluginKit = require("@intlayer/engine/syncPluginKit");
 
 //#region src/loadJSON.ts
-const listMessages = async (source, configuration) => {
-	const { system, internationalization } = configuration;
-	const { baseDir } = system;
-	const { locales } = internationalization;
-	const result = {};
-	for (const locale of locales) {
-		const globPatternLocale = await (0, _intlayer_config_utils.parseFilePathPattern)(source, {
-			key: "**",
-			locale
-		});
-		const maskPatternLocale = await (0, _intlayer_config_utils.parseFilePathPattern)(source, {
-			key: "{{__KEY__}}",
-			locale
-		});
-		if (!globPatternLocale || !maskPatternLocale) continue;
-		const files = await (0, fast_glob.default)(globPatternLocale.startsWith("./") ? globPatternLocale.slice(2) : globPatternLocale, { cwd: baseDir });
-		for (const file of files) {
-			const hasLocaleInMask = maskPatternLocale.includes("{{__LOCALE__}}");
-			const hasKeyInMask = maskPatternLocale.includes("{{__KEY__}}");
-			let key;
-			let extractedLocale;
-			if (hasLocaleInMask || hasKeyInMask) {
-				const extraction = require_syncJSON.extractKeyAndLocaleFromPath(file, maskPatternLocale, locales, locale);
-				if (!extraction) continue;
-				key = extraction.key;
-				extractedLocale = extraction.locale;
-			} else {
-				key = "index";
-				extractedLocale = locale;
-			}
-			const absolutePath = (0, node_path.isAbsolute)(file) ? file : (0, node_path.resolve)(baseDir, file);
-			const usedLocale = extractedLocale;
-			if (!result[usedLocale]) result[usedLocale] = {};
-			result[usedLocale][key] = absolutePath;
-		}
-	}
-	return result;
-};
-const loadMessagePathMap = async (source, configuration) => {
-	const messages = await listMessages(source, configuration);
-	return Object.entries(messages).flatMap(([locale, keysRecord]) => Object.entries(keysRecord).map(([key, path]) => {
-		return {
-			path: (0, node_path.isAbsolute)(path) ? path : (0, node_path.resolve)(configuration.system.baseDir, path),
-			locale,
-			key
-		};
-	}));
-};
-const loadJSON = (options) => {
-	const { location, priority, locale, format } = {
-		location: "plugin",
-		priority: 0,
-		...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 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 = {
-					key,
-					locale: entryUsedLocale,
-					fill: filePath,
-					format,
-					localId: `${key}::${location}::${filePath}`,
-					location,
-					filled: entryUsedLocale !== configuration.internationalization.defaultLocale ? true : void 0,
-					content: json,
-					filePath,
-					priority
-				};
-				dictionaries.push(dictionary);
-			}
-			return dictionaries;
-		}
-	};
-};
+/**
+* Read-only JSON ingestion plugin: loads JSON message files as dictionaries
+* without ever writing back to them.
+*/
+const loadJSON = (options) => (0, _intlayer_engine_syncPluginKit.createSyncPlugin)({
+	name: "load-json",
+	adapter: (0, _intlayer_engine_syncPluginKit.createFileAdapter)({
+		source: options.source,
+		codec: require_jsonCodec.jsonCodec,
+		readEntry: require_jsonCodec.readJSONEntry,
+		discovery: "inclusive"
+	}),
+	direction: "pull",
+	location: options.location ?? "plugin",
+	priority: options.priority ?? 0,
+	format: options.format,
+	splitKeys: options.splitKeys,
+	localeOverride: options.locale
+});
 
 //#endregion
 exports.loadJSON = loadJSON;

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 { 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\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      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":";;;;;;;;;;;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,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,sDAAyB,cAAc;GAC7C,MAAM,kBAAmC,MAAM,mBAC7C,QAAQ,QACR,cACD;AAED,OAAI,gBAAgB,WAAW,EAM7B,WACE,yGAA4E,uDANnC,QAAQ,QAAQ;IACzD,KAAK;IACL,QAAQ;IACT,CAAkC,CAGmD,IACpF,EAAE,OAAO,QAAQ,CAClB;GAGH,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":["jsonCodec","readJSONEntry"],"sources":["../../src/loadJSON.ts"],"sourcesContent":["import {\n  createFileAdapter,\n  createSyncPlugin,\n} from '@intlayer/engine/syncPluginKit';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { DictionaryFormat } from '@intlayer/types/dictionary';\nimport type { FilePathPattern } from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport { jsonCodec, readJSONEntry } from './jsonCodec';\n\nexport type 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\n/**\n * Read-only JSON ingestion plugin: loads JSON message files as dictionaries\n * without ever writing back to them.\n */\nexport const loadJSON = (options: LoadJSONPluginOptions): Plugin =>\n  createSyncPlugin({\n    name: 'load-json',\n    adapter: createFileAdapter({\n      source: options.source,\n      codec: jsonCodec,\n      readEntry: readJSONEntry,\n      discovery: 'inclusive',\n    }),\n    direction: 'pull',\n    location: options.location ?? 'plugin',\n    priority: options.priority ?? 0,\n    format: options.format,\n    splitKeys: options.splitKeys,\n    localeOverride: options.locale,\n  });\n"],"mappings":";;;;;;;;;AAwGA,MAAa,YAAY,iEACN;CACf,MAAM;CACN,+DAA2B;EACzB,QAAQ,QAAQ;EAChB,OAAOA;EACP,WAAWC;EACX,WAAW;CACb,CAAC;CACD,WAAW;CACX,UAAU,QAAQ,YAAY;CAC9B,UAAU,QAAQ,YAAY;CAC9B,QAAQ,QAAQ;CAChB,WAAW,QAAQ;CACnB,gBAAgB,QAAQ;AAC1B,CAAC"}

package/dist/cjs/syncJSON.cjs

@@ -1,179 +1,37 @@
 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");
+const require_jsonCodec = require('./jsonCodec.cjs');
+let _intlayer_engine_syncPluginKit = require("@intlayer/engine/syncPluginKit");
 let _intlayer_config_utils = require("@intlayer/config/utils");
-let fast_glob = require("fast-glob");
-fast_glob = require_runtime.__toESM(fast_glob);
-let node_fs_promises = require("node:fs/promises");
 
 //#region src/syncJSON.ts
-const escapeRegex = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-const extractKeyAndLocaleFromPath = (filePath, maskPattern, locales, defaultLocale) => {
-	const keyPlaceholder = "{{__KEY__}}";
-	const localePlaceholder = "{{__LOCALE__}}";
-	const normalize = (path) => path.startsWith("./") ? path.slice(2) : path;
-	const normalizedFilePath = normalize(filePath);
-	const normalizedMask = normalize(maskPattern);
-	const localesAlternation = locales.join("|");
-	let regexStr = `^${escapeRegex(normalizedMask)}$`;
-	regexStr = regexStr.replace(/\\\*\\\*/g, ".*");
-	regexStr = regexStr.replace(/\\\*/g, "[^/]*");
-	regexStr = regexStr.replace(escapeRegex(localePlaceholder), `(?<locale>${localesAlternation})`);
-	if (normalizedMask.includes(keyPlaceholder)) regexStr = regexStr.replace(escapeRegex(keyPlaceholder), "(?<key>.+)");
-	const match = new RegExp(regexStr).exec(normalizedFilePath);
-	if (!match?.groups) return null;
-	let locale = match.groups.locale;
-	let key = match.groups.key ?? "index";
-	if (typeof key === "undefined") key = "index";
-	if (typeof locale === "undefined") locale = defaultLocale;
-	return {
-		key,
-		locale
-	};
-};
-const listMessages = async (source, configuration) => {
-	const { system, internationalization } = configuration;
-	const { baseDir } = system;
-	const { locales } = internationalization;
-	const result = {};
-	for (const locale of locales) {
-		const globPatternLocale = await (0, _intlayer_config_utils.parseFilePathPattern)(source, {
-			key: "**",
-			locale
-		});
-		const maskPatternLocale = await (0, _intlayer_config_utils.parseFilePathPattern)(source, {
-			key: "{{__KEY__}}",
-			locale
-		});
-		if (!globPatternLocale || !maskPatternLocale) continue;
-		const files = await (0, fast_glob.default)(globPatternLocale.startsWith("./") ? globPatternLocale.slice(2) : globPatternLocale, { cwd: baseDir });
-		for (const file of files) {
-			const extraction = extractKeyAndLocaleFromPath(file, maskPatternLocale, locales, locale);
-			if (!extraction) continue;
-			const { key, locale: extractedLocale } = extraction;
-			const expectedPath = await (0, _intlayer_config_utils.parseFilePathPattern)(source, {
-				key,
-				locale: extractedLocale
-			});
-			const absoluteFoundPath = (0, node_path.isAbsolute)(file) ? file : (0, node_path.resolve)(baseDir, file);
-			if (absoluteFoundPath !== ((0, node_path.isAbsolute)(expectedPath) ? expectedPath : (0, node_path.resolve)(baseDir, expectedPath))) continue;
-			const usedLocale = extractedLocale;
-			if (!result[usedLocale]) result[usedLocale] = {};
-			result[usedLocale][key] = absoluteFoundPath;
-		}
-	}
-	const hasKeyInMask = (await (0, _intlayer_config_utils.parseFilePathPattern)(source, {
-		key: "{{__KEY__}}",
-		locale: locales[0]
-	})).includes("{{__KEY__}}");
-	const discoveredKeys = /* @__PURE__ */ new Set();
-	for (const locale of Object.keys(result)) for (const key of Object.keys(result[locale] ?? {})) discoveredKeys.add(key);
-	if (!hasKeyInMask) discoveredKeys.add("index");
-	const keysToEnsure = discoveredKeys.size > 0 ? Array.from(discoveredKeys) : [];
-	for (const locale of locales) {
-		if (!result[locale]) result[locale] = {};
-		for (const key of keysToEnsure) if (!result[locale][key]) {
-			const builtPath = await (0, _intlayer_config_utils.parseFilePathPattern)(source, {
-				key,
-				locale
-			});
-			const absoluteBuiltPath = (0, node_path.isAbsolute)(builtPath) ? builtPath : (0, node_path.resolve)(baseDir, builtPath);
-			result[locale][key] = absoluteBuiltPath;
-		}
-	}
-	return result;
-};
-const loadMessagePathMap = async (source, configuration) => {
-	const messages = await listMessages(source, configuration);
-	return Object.entries(messages).flatMap(([locale, keysRecord]) => Object.entries(keysRecord).map(([key, path]) => {
-		return {
-			path: (0, node_path.isAbsolute)(path) ? path : (0, node_path.resolve)(configuration.system.baseDir, path),
-			locale,
-			key
-		};
-	}));
-};
+/**
+* Two-way JSON synchronization plugin: ingests JSON message files as
+* dictionaries and writes the merged build output back to the same files.
+*/
 const syncJSON = async (options) => {
-	const { location, priority, format } = {
-		location: `sync-json::${await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
-			key: "{{key}}",
-			locale: "{{locale}}"
-		})}`,
-		priority: 0,
-		...options
-	};
-	return {
+	const defaultLocation = `sync-json::${await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, (0, _intlayer_engine_syncPluginKit.buildFilePathPatternContext)("{{key}}", "{{locale}}"))}`;
+	return (0, _intlayer_engine_syncPluginKit.createSyncPlugin)({
 		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}}"
-			});
-			if (fill) fill = (0, node_path.relative)(configuration.system.baseDir, (0, node_path.resolve)(configuration.system.baseDir, fill));
-			const dictionaries = [];
-			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 = {
-					key,
-					locale,
-					fill,
-					format,
-					localId: `${key}::${location}::${filePath}`,
-					location,
-					filled: locale !== configuration.internationalization.defaultLocale ? true : void 0,
-					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;
-			const builderPath = await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
-				key: dictionary.key,
-				locale: dictionary.locale
-			});
-			if ((0, node_path.resolve)(configuration.system.baseDir, builderPath) !== (0, node_path.resolve)(configuration.system.baseDir, dictionary.filePath)) return dictionary;
-			return formatDictionaryOutput(dictionary, format).content;
-		},
-		afterBuild: async ({ dictionaries, configuration }) => {
-			const { getPerLocaleDictionary } = await import("@intlayer/core/plugins");
-			const { parallelize } = await import("@intlayer/chokidar/utils");
-			const { formatDictionaryOutput } = await import("@intlayer/chokidar/build");
-			const { locales } = configuration.internationalization;
-			await parallelize(Object.entries(dictionaries.mergedDictionaries).flatMap(([key, dictionary]) => locales.map((locale) => ({
-				key,
-				dictionary: dictionary.dictionary,
-				locale
-			}))), async ({ key, dictionary, locale }) => {
-				if (dictionary.location !== location) return;
-				const builderPath = await (0, _intlayer_config_utils.parseFilePathPattern)(options.source, {
-					key,
-					locale
-				});
-				const formattedOutput = formatDictionaryOutput(getPerLocaleDictionary(dictionary, locale), format);
-				const content = JSON.parse(JSON.stringify(formattedOutput.content));
-				if (typeof content === "undefined" || typeof content === "object" && Object.keys(content).length === 0) return;
-				await (0, node_fs_promises.mkdir)((0, node_path.dirname)(builderPath), { recursive: true });
-				await (0, node_fs_promises.writeFile)(builderPath, `${JSON.stringify(content, null, 2)}\n`, "utf-8");
-			});
-		}
-	};
+		adapter: (0, _intlayer_engine_syncPluginKit.createFileAdapter)({
+			source: options.source,
+			codec: require_jsonCodec.jsonCodec,
+			readEntry: require_jsonCodec.readJSONEntry,
+			discovery: "strict"
+		}),
+		direction: "both",
+		location: options.location ?? defaultLocation,
+		priority: options.priority ?? 0,
+		format: options.format,
+		splitKeys: options.splitKeys
+	});
 };
 
 //#endregion
-exports.extractKeyAndLocaleFromPath = extractKeyAndLocaleFromPath;
+Object.defineProperty(exports, 'extractKeyAndLocaleFromPath', {
+  enumerable: true,
+  get: function () {
+    return _intlayer_engine_syncPluginKit.extractKeyAndLocaleFromPath;
+  }
+});
 exports.syncJSON = syncJSON;
 //# sourceMappingURL=syncJSON.cjs.map

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, 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\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 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 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":["jsonCodec","readJSONEntry"],"sources":["../../src/syncJSON.ts"],"sourcesContent":["import { parseFilePathPattern } from '@intlayer/config/utils';\nimport {\n  buildFilePathPatternContext,\n  createFileAdapter,\n  createSyncPlugin,\n} from '@intlayer/engine/syncPluginKit';\nimport type {\n  DictionaryFormat,\n  DictionaryLocation,\n} from '@intlayer/types/dictionary';\nimport type { FilePathPattern } from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport { jsonCodec, readJSONEntry } from './jsonCodec';\n\n// Re-exported for backward compatibility: this helper used to live here.\nexport { extractKeyAndLocaleFromPath } from '@intlayer/engine/syncPluginKit';\n\nexport type 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\n/**\n * Two-way JSON synchronization plugin: ingests JSON message files as\n * dictionaries and writes the merged build output back to the same files.\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(\n    options.source,\n    buildFilePathPatternContext('{{key}}', '{{locale}}')\n  );\n  const defaultLocation = `sync-json::${patternMarker}`;\n\n  return createSyncPlugin({\n    name: 'sync-json',\n    adapter: createFileAdapter({\n      source: options.source,\n      codec: jsonCodec,\n      readEntry: readJSONEntry,\n      discovery: 'strict',\n    }),\n    direction: 'both',\n    location: options.location ?? defaultLocation,\n    priority: options.priority ?? 0,\n    format: options.format,\n    // Auto-detected by the file adapter when omitted: split when the source\n    // pattern has no `{{key}}` segment (one file holds every namespace).\n    splitKeys: options.splitKeys,\n  });\n};\n"],"mappings":";;;;;;;;;;AAuGA,MAAa,WAAW,OACtB,YACoB;CAOpB,MAAM,kBAAkB,cAAc,uDAHpC,QAAQ,wEACoB,WAAW,YAAY,CACrD;CAGA,4DAAwB;EACtB,MAAM;EACN,+DAA2B;GACzB,QAAQ,QAAQ;GAChB,OAAOA;GACP,WAAWC;GACX,WAAW;EACb,CAAC;EACD,WAAW;EACX,UAAU,QAAQ,YAAY;EAC9B,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ;EAGhB,WAAW,QAAQ;CACrB,CAAC;AACH"}

package/dist/esm/index.mjs

@@ -1,4 +1,5 @@
-import { extractKeyAndLocaleFromPath, syncJSON } from "./syncJSON.mjs";
+import { jsonCodec, readJSONEntry } from "./jsonCodec.mjs";
 import { loadJSON } from "./loadJSON.mjs";
+import { extractKeyAndLocaleFromPath, syncJSON } from "./syncJSON.mjs";
 
-export { extractKeyAndLocaleFromPath, loadJSON, syncJSON };
+export { extractKeyAndLocaleFromPath, jsonCodec, loadJSON, readJSONEntry, syncJSON };

package/dist/esm/jsonCodec.mjs

@@ -0,0 +1,21 @@
+import { loadExternalFile } from "@intlayer/config/file";
+
+//#region src/jsonCodec.ts
+/**
+* JSON payload codec: standard JSON parsing, pretty-printed serialization
+* (2-space indentation, trailing newline).
+*/
+const jsonCodec = {
+	parse: (raw) => JSON.parse(raw),
+	serialize: (content) => `${JSON.stringify(content, null, 2)}\n`
+};
+/**
+* Read one JSON source through `loadExternalFile`, which also supports JSON5,
+* JSONC and transpiled JS/TS message files. Returns `undefined` for missing or
+* unreadable files so callers fall back to empty content.
+*/
+const readJSONEntry = async (absoluteFilePath) => await loadExternalFile(absoluteFilePath, { logError: false });
+
+//#endregion
+export { jsonCodec, readJSONEntry };
+//# sourceMappingURL=jsonCodec.mjs.map

package/dist/esm/jsonCodec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonCodec.mjs","names":[],"sources":["../../src/jsonCodec.ts"],"sourcesContent":["import { loadExternalFile } from '@intlayer/config/file';\nimport type { FormatCodec, SyncContent } from '@intlayer/engine/syncPluginKit';\n\n/**\n * JSON payload codec: standard JSON parsing, pretty-printed serialization\n * (2-space indentation, trailing newline).\n */\nexport const jsonCodec: FormatCodec = {\n  parse: (raw) => JSON.parse(raw),\n  serialize: (content) => `${JSON.stringify(content, null, 2)}\\n`,\n};\n\n/**\n * Read one JSON source through `loadExternalFile`, which also supports JSON5,\n * JSONC and transpiled JS/TS message files. Returns `undefined` for missing or\n * unreadable files so callers fall back to empty content.\n */\nexport const readJSONEntry = async (\n  absoluteFilePath: string\n): Promise<SyncContent | undefined> =>\n  await loadExternalFile(absoluteFilePath, { logError: false });\n"],"mappings":";;;;;;;AAOA,MAAa,YAAyB;CACpC,QAAQ,QAAQ,KAAK,MAAM,GAAG;CAC9B,YAAY,YAAY,GAAG,KAAK,UAAU,SAAS,MAAM,CAAC,EAAE;AAC9D;;;;;;AAOA,MAAa,gBAAgB,OAC3B,qBAEA,MAAM,iBAAiB,kBAAkB,EAAE,UAAU,MAAM,CAAC"}

package/dist/esm/loadJSON.mjs

@@ -1,97 +1,26 @@
-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";
+import { jsonCodec, readJSONEntry } from "./jsonCodec.mjs";
+import { createFileAdapter, createSyncPlugin } from "@intlayer/engine/syncPluginKit";
 
 //#region src/loadJSON.ts
-const listMessages = async (source, configuration) => {
-	const { system, internationalization } = configuration;
-	const { baseDir } = system;
-	const { locales } = internationalization;
-	const result = {};
-	for (const locale of locales) {
-		const globPatternLocale = await parseFilePathPattern(source, {
-			key: "**",
-			locale
-		});
-		const maskPatternLocale = await parseFilePathPattern(source, {
-			key: "{{__KEY__}}",
-			locale
-		});
-		if (!globPatternLocale || !maskPatternLocale) continue;
-		const files = await fg(globPatternLocale.startsWith("./") ? globPatternLocale.slice(2) : globPatternLocale, { cwd: baseDir });
-		for (const file of files) {
-			const hasLocaleInMask = maskPatternLocale.includes("{{__LOCALE__}}");
-			const hasKeyInMask = maskPatternLocale.includes("{{__KEY__}}");
-			let key;
-			let extractedLocale;
-			if (hasLocaleInMask || hasKeyInMask) {
-				const extraction = extractKeyAndLocaleFromPath(file, maskPatternLocale, locales, locale);
-				if (!extraction) continue;
-				key = extraction.key;
-				extractedLocale = extraction.locale;
-			} else {
-				key = "index";
-				extractedLocale = locale;
-			}
-			const absolutePath = isAbsolute(file) ? file : resolve(baseDir, file);
-			const usedLocale = extractedLocale;
-			if (!result[usedLocale]) result[usedLocale] = {};
-			result[usedLocale][key] = absolutePath;
-		}
-	}
-	return result;
-};
-const loadMessagePathMap = async (source, configuration) => {
-	const messages = await listMessages(source, configuration);
-	return Object.entries(messages).flatMap(([locale, keysRecord]) => Object.entries(keysRecord).map(([key, path]) => {
-		return {
-			path: isAbsolute(path) ? path : resolve(configuration.system.baseDir, path),
-			locale,
-			key
-		};
-	}));
-};
-const loadJSON = (options) => {
-	const { location, priority, locale, format } = {
-		location: "plugin",
-		priority: 0,
-		...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 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 = {
-					key,
-					locale: entryUsedLocale,
-					fill: filePath,
-					format,
-					localId: `${key}::${location}::${filePath}`,
-					location,
-					filled: entryUsedLocale !== configuration.internationalization.defaultLocale ? true : void 0,
-					content: json,
-					filePath,
-					priority
-				};
-				dictionaries.push(dictionary);
-			}
-			return dictionaries;
-		}
-	};
-};
+/**
+* Read-only JSON ingestion plugin: loads JSON message files as dictionaries
+* without ever writing back to them.
+*/
+const loadJSON = (options) => createSyncPlugin({
+	name: "load-json",
+	adapter: createFileAdapter({
+		source: options.source,
+		codec: jsonCodec,
+		readEntry: readJSONEntry,
+		discovery: "inclusive"
+	}),
+	direction: "pull",
+	location: options.location ?? "plugin",
+	priority: options.priority ?? 0,
+	format: options.format,
+	splitKeys: options.splitKeys,
+	localeOverride: options.locale
+});
 
 //#endregion
 export { loadJSON };

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 { 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\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      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":";;;;;;;;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;;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,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;GAGH,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":[],"sources":["../../src/loadJSON.ts"],"sourcesContent":["import {\n  createFileAdapter,\n  createSyncPlugin,\n} from '@intlayer/engine/syncPluginKit';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { DictionaryFormat } from '@intlayer/types/dictionary';\nimport type { FilePathPattern } from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport { jsonCodec, readJSONEntry } from './jsonCodec';\n\nexport type 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\n/**\n * Read-only JSON ingestion plugin: loads JSON message files as dictionaries\n * without ever writing back to them.\n */\nexport const loadJSON = (options: LoadJSONPluginOptions): Plugin =>\n  createSyncPlugin({\n    name: 'load-json',\n    adapter: createFileAdapter({\n      source: options.source,\n      codec: jsonCodec,\n      readEntry: readJSONEntry,\n      discovery: 'inclusive',\n    }),\n    direction: 'pull',\n    location: options.location ?? 'plugin',\n    priority: options.priority ?? 0,\n    format: options.format,\n    splitKeys: options.splitKeys,\n    localeOverride: options.locale,\n  });\n"],"mappings":";;;;;;;;AAwGA,MAAa,YAAY,YACvB,iBAAiB;CACf,MAAM;CACN,SAAS,kBAAkB;EACzB,QAAQ,QAAQ;EAChB,OAAO;EACP,WAAW;EACX,WAAW;CACb,CAAC;CACD,WAAW;CACX,UAAU,QAAQ,YAAY;CAC9B,UAAU,QAAQ,YAAY;CAC9B,QAAQ,QAAQ;CAChB,WAAW,QAAQ;CACnB,gBAAgB,QAAQ;AAC1B,CAAC"}

package/dist/esm/syncJSON.mjs

@@ -1,173 +1,28 @@
-import { dirname, isAbsolute, relative, resolve } from "node:path";
-import { loadExternalFile } from "@intlayer/config/file";
-import { colorizePath, getAppLogger } from "@intlayer/config/logger";
+import { jsonCodec, readJSONEntry } from "./jsonCodec.mjs";
+import { buildFilePathPatternContext, createFileAdapter, createSyncPlugin, extractKeyAndLocaleFromPath } from "@intlayer/engine/syncPluginKit";
 import { parseFilePathPattern } from "@intlayer/config/utils";
-import fg from "fast-glob";
-import { mkdir, writeFile } from "node:fs/promises";
 
 //#region src/syncJSON.ts
-const escapeRegex = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-const extractKeyAndLocaleFromPath = (filePath, maskPattern, locales, defaultLocale) => {
-	const keyPlaceholder = "{{__KEY__}}";
-	const localePlaceholder = "{{__LOCALE__}}";
-	const normalize = (path) => path.startsWith("./") ? path.slice(2) : path;
-	const normalizedFilePath = normalize(filePath);
-	const normalizedMask = normalize(maskPattern);
-	const localesAlternation = locales.join("|");
-	let regexStr = `^${escapeRegex(normalizedMask)}$`;
-	regexStr = regexStr.replace(/\\\*\\\*/g, ".*");
-	regexStr = regexStr.replace(/\\\*/g, "[^/]*");
-	regexStr = regexStr.replace(escapeRegex(localePlaceholder), `(?<locale>${localesAlternation})`);
-	if (normalizedMask.includes(keyPlaceholder)) regexStr = regexStr.replace(escapeRegex(keyPlaceholder), "(?<key>.+)");
-	const match = new RegExp(regexStr).exec(normalizedFilePath);
-	if (!match?.groups) return null;
-	let locale = match.groups.locale;
-	let key = match.groups.key ?? "index";
-	if (typeof key === "undefined") key = "index";
-	if (typeof locale === "undefined") locale = defaultLocale;
-	return {
-		key,
-		locale
-	};
-};
-const listMessages = async (source, configuration) => {
-	const { system, internationalization } = configuration;
-	const { baseDir } = system;
-	const { locales } = internationalization;
-	const result = {};
-	for (const locale of locales) {
-		const globPatternLocale = await parseFilePathPattern(source, {
-			key: "**",
-			locale
-		});
-		const maskPatternLocale = await parseFilePathPattern(source, {
-			key: "{{__KEY__}}",
-			locale
-		});
-		if (!globPatternLocale || !maskPatternLocale) continue;
-		const files = await fg(globPatternLocale.startsWith("./") ? globPatternLocale.slice(2) : globPatternLocale, { cwd: baseDir });
-		for (const file of files) {
-			const extraction = extractKeyAndLocaleFromPath(file, maskPatternLocale, locales, locale);
-			if (!extraction) continue;
-			const { key, locale: extractedLocale } = extraction;
-			const expectedPath = await parseFilePathPattern(source, {
-				key,
-				locale: extractedLocale
-			});
-			const absoluteFoundPath = isAbsolute(file) ? file : resolve(baseDir, file);
-			if (absoluteFoundPath !== (isAbsolute(expectedPath) ? expectedPath : resolve(baseDir, expectedPath))) continue;
-			const usedLocale = extractedLocale;
-			if (!result[usedLocale]) result[usedLocale] = {};
-			result[usedLocale][key] = absoluteFoundPath;
-		}
-	}
-	const hasKeyInMask = (await parseFilePathPattern(source, {
-		key: "{{__KEY__}}",
-		locale: locales[0]
-	})).includes("{{__KEY__}}");
-	const discoveredKeys = /* @__PURE__ */ new Set();
-	for (const locale of Object.keys(result)) for (const key of Object.keys(result[locale] ?? {})) discoveredKeys.add(key);
-	if (!hasKeyInMask) discoveredKeys.add("index");
-	const keysToEnsure = discoveredKeys.size > 0 ? Array.from(discoveredKeys) : [];
-	for (const locale of locales) {
-		if (!result[locale]) result[locale] = {};
-		for (const key of keysToEnsure) if (!result[locale][key]) {
-			const builtPath = await parseFilePathPattern(source, {
-				key,
-				locale
-			});
-			const absoluteBuiltPath = isAbsolute(builtPath) ? builtPath : resolve(baseDir, builtPath);
-			result[locale][key] = absoluteBuiltPath;
-		}
-	}
-	return result;
-};
-const loadMessagePathMap = async (source, configuration) => {
-	const messages = await listMessages(source, configuration);
-	return Object.entries(messages).flatMap(([locale, keysRecord]) => Object.entries(keysRecord).map(([key, path]) => {
-		return {
-			path: isAbsolute(path) ? path : resolve(configuration.system.baseDir, path),
-			locale,
-			key
-		};
-	}));
-};
+/**
+* Two-way JSON synchronization plugin: ingests JSON message files as
+* dictionaries and writes the merged build output back to the same files.
+*/
 const syncJSON = async (options) => {
-	const { location, priority, format } = {
-		location: `sync-json::${await parseFilePathPattern(options.source, {
-			key: "{{key}}",
-			locale: "{{locale}}"
-		})}`,
-		priority: 0,
-		...options
-	};
-	return {
+	const defaultLocation = `sync-json::${await parseFilePathPattern(options.source, buildFilePathPatternContext("{{key}}", "{{locale}}"))}`;
+	return createSyncPlugin({
 		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}}"
-			});
-			if (fill) fill = relative(configuration.system.baseDir, resolve(configuration.system.baseDir, fill));
-			const dictionaries = [];
-			for (const { locale, path, key } of dictionariesMap) {
-				const json = await loadExternalFile(path, { logError: false }) ?? {};
-				const filePath = relative(configuration.system.baseDir, path);
-				const dictionary = {
-					key,
-					locale,
-					fill,
-					format,
-					localId: `${key}::${location}::${filePath}`,
-					location,
-					filled: locale !== configuration.internationalization.defaultLocale ? true : void 0,
-					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;
-			const builderPath = await parseFilePathPattern(options.source, {
-				key: dictionary.key,
-				locale: dictionary.locale
-			});
-			if (resolve(configuration.system.baseDir, builderPath) !== resolve(configuration.system.baseDir, dictionary.filePath)) return dictionary;
-			return formatDictionaryOutput(dictionary, format).content;
-		},
-		afterBuild: async ({ dictionaries, configuration }) => {
-			const { getPerLocaleDictionary } = await import("@intlayer/core/plugins");
-			const { parallelize } = await import("@intlayer/chokidar/utils");
-			const { formatDictionaryOutput } = await import("@intlayer/chokidar/build");
-			const { locales } = configuration.internationalization;
-			await parallelize(Object.entries(dictionaries.mergedDictionaries).flatMap(([key, dictionary]) => locales.map((locale) => ({
-				key,
-				dictionary: dictionary.dictionary,
-				locale
-			}))), async ({ key, dictionary, locale }) => {
-				if (dictionary.location !== location) return;
-				const builderPath = await parseFilePathPattern(options.source, {
-					key,
-					locale
-				});
-				const formattedOutput = formatDictionaryOutput(getPerLocaleDictionary(dictionary, locale), format);
-				const content = JSON.parse(JSON.stringify(formattedOutput.content));
-				if (typeof content === "undefined" || typeof content === "object" && Object.keys(content).length === 0) return;
-				await mkdir(dirname(builderPath), { recursive: true });
-				await writeFile(builderPath, `${JSON.stringify(content, null, 2)}\n`, "utf-8");
-			});
-		}
-	};
+		adapter: createFileAdapter({
+			source: options.source,
+			codec: jsonCodec,
+			readEntry: readJSONEntry,
+			discovery: "strict"
+		}),
+		direction: "both",
+		location: options.location ?? defaultLocation,
+		priority: options.priority ?? 0,
+		format: options.format,
+		splitKeys: options.splitKeys
+	});
 };
 
 //#endregion

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, 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\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 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 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 { parseFilePathPattern } from '@intlayer/config/utils';\nimport {\n  buildFilePathPatternContext,\n  createFileAdapter,\n  createSyncPlugin,\n} from '@intlayer/engine/syncPluginKit';\nimport type {\n  DictionaryFormat,\n  DictionaryLocation,\n} from '@intlayer/types/dictionary';\nimport type { FilePathPattern } from '@intlayer/types/filePathPattern';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport { jsonCodec, readJSONEntry } from './jsonCodec';\n\n// Re-exported for backward compatibility: this helper used to live here.\nexport { extractKeyAndLocaleFromPath } from '@intlayer/engine/syncPluginKit';\n\nexport type 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\n/**\n * Two-way JSON synchronization plugin: ingests JSON message files as\n * dictionaries and writes the merged build output back to the same files.\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(\n    options.source,\n    buildFilePathPatternContext('{{key}}', '{{locale}}')\n  );\n  const defaultLocation = `sync-json::${patternMarker}`;\n\n  return createSyncPlugin({\n    name: 'sync-json',\n    adapter: createFileAdapter({\n      source: options.source,\n      codec: jsonCodec,\n      readEntry: readJSONEntry,\n      discovery: 'strict',\n    }),\n    direction: 'both',\n    location: options.location ?? defaultLocation,\n    priority: options.priority ?? 0,\n    format: options.format,\n    // Auto-detected by the file adapter when omitted: split when the source\n    // pattern has no `{{key}}` segment (one file holds every namespace).\n    splitKeys: options.splitKeys,\n  });\n};\n"],"mappings":";;;;;;;;;AAuGA,MAAa,WAAW,OACtB,YACoB;CAOpB,MAAM,kBAAkB,cAAc,MAJV,qBAC1B,QAAQ,QACR,4BAA4B,WAAW,YAAY,CACrD;CAGA,OAAO,iBAAiB;EACtB,MAAM;EACN,SAAS,kBAAkB;GACzB,QAAQ,QAAQ;GAChB,OAAO;GACP,WAAW;GACX,WAAW;EACb,CAAC;EACD,WAAW;EACX,UAAU,QAAQ,YAAY;EAC9B,UAAU,QAAQ,YAAY;EAC9B,QAAQ,QAAQ;EAGhB,WAAW,QAAQ;CACrB,CAAC;AACH"}

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
-import { loadJSON } from "./loadJSON.js";
-import { extractKeyAndLocaleFromPath, syncJSON } from "./syncJSON.js";
-export { extractKeyAndLocaleFromPath, loadJSON, syncJSON };
+import { jsonCodec, readJSONEntry } from "./jsonCodec.js";
+import { LoadJSONPluginOptions, loadJSON } from "./loadJSON.js";
+import { SyncJSONPluginOptions, extractKeyAndLocaleFromPath, syncJSON } from "./syncJSON.js";
+export { LoadJSONPluginOptions, SyncJSONPluginOptions, extractKeyAndLocaleFromPath, jsonCodec, loadJSON, readJSONEntry, syncJSON };

package/dist/types/jsonCodec.d.ts

@@ -0,0 +1,16 @@
+import { FormatCodec, SyncContent } from "@intlayer/engine/syncPluginKit";
+//#region src/jsonCodec.d.ts
+/**
+ * JSON payload codec: standard JSON parsing, pretty-printed serialization
+ * (2-space indentation, trailing newline).
+ */
+declare const jsonCodec: FormatCodec;
+/**
+ * Read one JSON source through `loadExternalFile`, which also supports JSON5,
+ * JSONC and transpiled JS/TS message files. Returns `undefined` for missing or
+ * unreadable files so callers fall back to empty content.
+ */
+declare const readJSONEntry: (absoluteFilePath: string) => Promise<SyncContent | undefined>;
+//#endregion
+export { jsonCodec, readJSONEntry };
+//# sourceMappingURL=jsonCodec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonCodec.d.ts","names":[],"sources":["../../src/jsonCodec.ts"],"mappings":";;;;;;cAOa,WAAW;;;;;;cAUX,gBAAa,6BAEvB,QAAQ"}

package/dist/types/loadJSON.d.ts

@@ -2,7 +2,6 @@ import { Locale } from "@intlayer/types/allLocales";
 import { DictionaryFormat } from "@intlayer/types/dictionary";
 import { FilePathPattern } from "@intlayer/types/filePathPattern";
 import { Plugin } from "@intlayer/types/plugin";
-
 //#region src/loadJSON.d.ts
 type LoadJSONPluginOptions = {
   /**
@@ -74,8 +73,25 @@ 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;
 };
+/**
+ * Read-only JSON ingestion plugin: loads JSON message files as dictionaries
+ * without ever writing back to them.
+ */
 declare const loadJSON: (options: LoadJSONPluginOptions) => Plugin;
 //#endregion
-export { loadJSON };
+export { LoadJSONPluginOptions, loadJSON };
 //# sourceMappingURL=loadJSON.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"loadJSON.d.ts","names":[],"sources":["../../src/loadJSON.ts"],"mappings":";;;;;;KAiJK,qBAAA;;AAlIgD;;;;;;;;;;EA8InD,MAAA,EAAQ,eAAA;EAeC;;;;;;;AAiDX;;;;;;EAjDE,MAAA,GAAS,MAAA;EAkHV;;;;;;;;;;;;;;;;;;;;;;EA1FC,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":";;;;;KAUY;;;;;;;;;;;;EAYV,QAAQ;;;;;;;;;;;;;;EAeR,SAAS;;;;;;;;;;;;;;;;;;;;;;;EAwBT;;;;;;;;;EAUA;;;;;;;;;;;EAYA,SAAS;;;;;;;;;;;;;EAcT;;;;;;cAOW,WAAQ,SAAa,0BAAwB"}

package/dist/types/syncJSON.d.ts

@@ -1,13 +1,8 @@
-import { Locale } from "@intlayer/types/allLocales";
+import { extractKeyAndLocaleFromPath } from "@intlayer/engine/syncPluginKit";
 import { DictionaryFormat, DictionaryLocation } from "@intlayer/types/dictionary";
 import { FilePathPattern } from "@intlayer/types/filePathPattern";
 import { Plugin } from "@intlayer/types/plugin";
-
 //#region src/syncJSON.d.ts
-declare const extractKeyAndLocaleFromPath: (filePath: string, maskPattern: string, locales: Locale[], defaultLocale: Locale) => {
-  key: string;
-  locale: Locale;
-} | null;
 type SyncJSONPluginOptions = {
   /**
    * The source of the plugin.
@@ -60,8 +55,36 @@ 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;
 };
+/**
+ * Two-way JSON synchronization plugin: ingests JSON message files as
+ * dictionaries and writes the merged build output back to the same files.
+ */
 declare const syncJSON: (options: SyncJSONPluginOptions) => Promise<Plugin>;
 //#endregion
-export { extractKeyAndLocaleFromPath, syncJSON };
+export { SyncJSONPluginOptions, extractKeyAndLocaleFromPath, syncJSON };
 //# sourceMappingURL=syncJSON.d.ts.map

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

@@ -1 +1 @@
-{"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;EAkMZ;;;;;;;;EAxLC,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":";;;;;KAiBY;;;;;;;;;;;EAWV,QAAQ;;;;;;;;;;;;;;;;;;;;;;;EAwBR,WAAW;;;;;;;;;EAUX;;;;;;;;EASA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;EAyBT;;;;;;cAOW,WAAQ,SACV,0BACR,QAAQ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/sync-json-plugin",
-  "version": "9.0.0-canary.2",
+  "version": "9.0.0-canary.20",
   "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": "9.0.0-canary.2",
-    "@intlayer/config": "9.0.0-canary.2",
-    "@intlayer/core": "9.0.0-canary.2",
-    "@intlayer/types": "9.0.0-canary.2",
+    "@intlayer/config": "9.0.0-canary.20",
+    "@intlayer/core": "9.0.0-canary.20",
+    "@intlayer/engine": "9.0.0-canary.20",
+    "@intlayer/types": "9.0.0-canary.20",
     "fast-glob": "3.3.3"
   },
   "devDependencies": {
-    "@types/node": "25.9.3",
+    "@types/node": "26.1.1",
     "@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.9"
+    "tsdown": "0.22.12",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
   },
   "engines": {
     "node": ">=14.18"