import { SplitKeysMode, 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
export type SyncJSONPluginOptions = {
  /**
   * The source of the plugin.
   * Is a function to build the source from the key and locale.
   *
   * ```ts
   * syncJSON({
   * source: ({ key, locale }) => `./messages/${locale}/${key}.json`
   * })
   * ```
   */
  source: FilePathPattern;
  /**
   * Because Intlayer transform the JSON files into Dictionary, we need to identify the plugin in the dictionary.
   * Used to identify the plugin in the dictionary.
   *
   * In the case you have multiple plugins, you can use this to identify the plugin in the dictionary.
   *
   * ```ts
   * // Example usage:
   * const config = {
   *   plugins: [
   *     syncJSON({
   *       source: ({ key, locale }) => `./resources/${locale}/${key}.json`,
   *       location: 'plugin-i18next',
   *     }),
   *     syncJSON({
   *       source: ({ key, locale }) => `./messages/${locale}/${key}.json`,
   *       location: 'plugin-next-intl',
   *     }),
   *   ]
   * }
   * ```
   */
  location?: DictionaryLocation | (string & {});
  /**
   * The priority of the dictionaries created by the plugin.
   *
   * In the case of conflicts with remote dictionaries, or .content files, the dictionary with the highest priority will override the other dictionaries.
   *
   * Default is -1. (.content file priority is 0)
   *
   */
  priority?: number;
  /**
   * The format of the dictionaries created by the plugin.
   *
   * Default: 'intlayer'
   *
   * 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`).
   *
   * Pass `'key-prefix'` for *flat* catalogs whose keys are dotted ids rather
   * than nested objects — the single-catalog model of `lingui` and of
   * i18next's default `translation` namespace. Each id's first dot-segment
   * becomes a dictionary and the remainder becomes the key inside it, so
   * `'footer.github'` is addressed as dictionary `footer`, key `github`.
   * Write-back restores the flat dotted ids, leaving the source file in the
   * shape its library expects.
   *
   * 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,
   * })
   *
   * // locales/en/messages.json → { 'footer.github': …, 'hero.title': … }
   * //   → dictionaries: footer, hero, …
   * syncJSON({
   *   source: ({ locale }) => `./locales/${locale}/messages.json`,
   *   splitKeys: 'key-prefix',
   * })
   * ```
   */
  splitKeys?: SplitKeysMode;
};
/**
 * Two-way JSON synchronization plugin: ingests JSON message files as
 * dictionaries and writes the merged build output back to the same files.
 */
export declare const syncJSON: (options: SyncJSONPluginOptions) => Promise<Plugin>;
//#endregion
export { extractKeyAndLocaleFromPath };
//# sourceMappingURL=syncJSON.d.ts.map