@intlayer/engine 9.4.3 → 9.5.0

package/dist/cjs/loadDictionaries/loadMarkdownContentDeclaration.cjs

@@ -1,21 +1,22 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils_parseContentDeclarationFileName = require('../utils/parseContentDeclarationFileName.cjs');
 let node_fs_promises = require("node:fs/promises");
-let node_path = require("node:path");
 let _intlayer_core_markdown = require("@intlayer/core/markdown");
 let _intlayer_types_nodeType = require("@intlayer/types/nodeType");
 
 //#region src/loadDictionaries/loadMarkdownContentDeclaration.ts
-const loadMarkdownContentDeclaration = async (path) => {
+const loadMarkdownContentDeclaration = async (path, configuration) => {
 	try {
 		const fileContent = await (0, node_fs_promises.readFile)(path, "utf-8");
 		const frontmatter = (0, _intlayer_core_markdown.getMarkdownMetadata)(fileContent);
-		const fileName = (0, node_path.basename)(path).replace(/\.content\.md$/, "");
-		const key = frontmatter.key ?? fileName;
+		const fileNameDeclaration = require_utils_parseContentDeclarationFileName.parseContentDeclarationFileName(path, configuration);
+		const key = frontmatter.key ?? fileNameDeclaration.key;
 		if (!key) {
 			console.error(`[intlayer] Missing key in markdown content declaration: ${path}`);
 			return;
 		}
-		const { key: _key, locale, title, description, tags, fill, importMode, location, priority, version } = frontmatter;
+		const { key: _key, locale: frontmatterLocale, title, description, tags, fill, importMode, location, priority, version } = frontmatter;
+		const locale = frontmatterLocale ?? fileNameDeclaration.locale;
 		return {
 			key,
 			...locale !== void 0 && { locale },

package/dist/cjs/loadDictionaries/loadMarkdownContentDeclaration.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadMarkdownContentDeclaration.cjs","names":["readFile","getMarkdownMetadata","basename","MARKDOWN"],"sources":["../../../src/loadDictionaries/loadMarkdownContentDeclaration.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { MARKDOWN } from '@intlayer/types/nodeType';\n\ntype MarkdownFrontmatter = {\n  key?: string;\n  locale?: string;\n  title?: string;\n  description?: string;\n  tags?: string[];\n  fill?: any;\n  importMode?: string;\n  location?: string;\n  priority?: number;\n  version?: string;\n  [key: string]: any;\n};\n\nexport const loadMarkdownContentDeclaration = async (\n  path: string\n): Promise<Dictionary | undefined> => {\n  try {\n    const fileContent = await readFile(path, 'utf-8');\n    const frontmatter = getMarkdownMetadata<MarkdownFrontmatter>(fileContent);\n\n    // Derive key from filename (e.g. \"my-doc.content.md\" → \"my-doc\") if not in frontmatter\n    const fileName = basename(path).replace(/\\.content\\.md$/, '');\n    const key = frontmatter.key ?? fileName;\n\n    if (!key) {\n      console.error(\n        `[intlayer] Missing key in markdown content declaration: ${path}`\n      );\n      return undefined;\n    }\n\n    const {\n      key: _key,\n      locale,\n      title,\n      description,\n      tags,\n      fill,\n      importMode,\n      location,\n      priority,\n      version,\n    } = frontmatter;\n\n    return {\n      key,\n      ...(locale !== undefined && { locale }),\n      ...(title !== undefined && { title }),\n      ...(description !== undefined && { description }),\n      ...(tags !== undefined && { tags }),\n      ...(fill !== undefined && { fill }),\n      ...(importMode !== undefined && { importMode }),\n      ...(location !== undefined && { location }),\n      ...(priority !== undefined && { priority }),\n      ...(version !== undefined && { version }),\n      content: {\n        nodeType: MARKDOWN,\n        [MARKDOWN]: fileContent,\n        metadata: frontmatter,\n      },\n    } as Dictionary;\n  } catch (error) {\n    console.error(\n      `Error loading markdown content declaration at ${path}:`,\n      error\n    );\n    return undefined;\n  }\n};\n"],"mappings":";;;;;;;AAoBA,MAAa,iCAAiC,OAC5C,SACoC;CACpC,IAAI;EACF,MAAM,cAAc,UAAMA,2BAAS,MAAM,OAAO;EAChD,MAAM,kBAAcC,6CAAyC,WAAW;EAGxE,MAAM,eAAWC,oBAAS,IAAI,CAAC,CAAC,QAAQ,kBAAkB,EAAE;EAC5D,MAAM,MAAM,YAAY,OAAO;EAE/B,IAAI,CAAC,KAAK;GACR,QAAQ,MACN,2DAA2D,MAC7D;GACA;EACF;EAEA,MAAM,EACJ,KAAK,MACL,QACA,OACA,aACA,MACA,MACA,YACA,UACA,UACA,YACE;EAEJ,OAAO;GACL;GACA,GAAI,WAAW,UAAa,EAAE,OAAO;GACrC,GAAI,UAAU,UAAa,EAAE,MAAM;GACnC,GAAI,gBAAgB,UAAa,EAAE,YAAY;GAC/C,GAAI,SAAS,UAAa,EAAE,KAAK;GACjC,GAAI,SAAS,UAAa,EAAE,KAAK;GACjC,GAAI,eAAe,UAAa,EAAE,WAAW;GAC7C,GAAI,aAAa,UAAa,EAAE,SAAS;GACzC,GAAI,aAAa,UAAa,EAAE,SAAS;GACzC,GAAI,YAAY,UAAa,EAAE,QAAQ;GACvC,SAAS;IACP,UAAUC;KACTA,oCAAW;IACZ,UAAU;GACZ;EACF;CACF,SAAS,OAAO;EACd,QAAQ,MACN,iDAAiD,KAAK,IACtD,KACF;EACA;CACF;AACF"}
+{"version":3,"file":"loadMarkdownContentDeclaration.cjs","names":["readFile","getMarkdownMetadata","parseContentDeclarationFileName","MARKDOWN"],"sources":["../../../src/loadDictionaries/loadMarkdownContentDeclaration.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { MARKDOWN } from '@intlayer/types/nodeType';\nimport { parseContentDeclarationFileName } from '../utils/parseContentDeclarationFileName';\n\ntype MarkdownFrontmatter = {\n  key?: string;\n  locale?: string;\n  title?: string;\n  description?: string;\n  tags?: string[];\n  fill?: any;\n  importMode?: string;\n  location?: string;\n  priority?: number;\n  version?: string;\n  [key: string]: any;\n};\n\nexport const loadMarkdownContentDeclaration = async (\n  path: string,\n  configuration: IntlayerConfig\n): Promise<Dictionary | undefined> => {\n  try {\n    const fileContent = await readFile(path, 'utf-8');\n    const frontmatter = getMarkdownMetadata<MarkdownFrontmatter>(fileContent);\n\n    // Derive key and locale from the file name (e.g. \"my-doc.fr.content.md\" →\n    // key \"my-doc\", locale \"fr\") for whatever the frontmatter does not declare\n    const fileNameDeclaration = parseContentDeclarationFileName(\n      path,\n      configuration\n    );\n    const key = frontmatter.key ?? fileNameDeclaration.key;\n\n    if (!key) {\n      console.error(\n        `[intlayer] Missing key in markdown content declaration: ${path}`\n      );\n      return undefined;\n    }\n\n    const {\n      key: _key,\n      locale: frontmatterLocale,\n      title,\n      description,\n      tags,\n      fill,\n      importMode,\n      location,\n      priority,\n      version,\n    } = frontmatter;\n\n    const locale = frontmatterLocale ?? fileNameDeclaration.locale;\n\n    return {\n      key,\n      ...(locale !== undefined && { locale }),\n      ...(title !== undefined && { title }),\n      ...(description !== undefined && { description }),\n      ...(tags !== undefined && { tags }),\n      ...(fill !== undefined && { fill }),\n      ...(importMode !== undefined && { importMode }),\n      ...(location !== undefined && { location }),\n      ...(priority !== undefined && { priority }),\n      ...(version !== undefined && { version }),\n      content: {\n        nodeType: MARKDOWN,\n        [MARKDOWN]: fileContent,\n        metadata: frontmatter,\n      },\n    } as Dictionary;\n  } catch (error) {\n    console.error(\n      `Error loading markdown content declaration at ${path}:`,\n      error\n    );\n    return undefined;\n  }\n};\n"],"mappings":";;;;;;;AAqBA,MAAa,iCAAiC,OAC5C,MACA,kBACoC;CACpC,IAAI;EACF,MAAM,cAAc,UAAMA,2BAAS,MAAM,OAAO;EAChD,MAAM,kBAAcC,6CAAyC,WAAW;EAIxE,MAAM,sBAAsBC,8EAC1B,MACA,aACF;EACA,MAAM,MAAM,YAAY,OAAO,oBAAoB;EAEnD,IAAI,CAAC,KAAK;GACR,QAAQ,MACN,2DAA2D,MAC7D;GACA;EACF;EAEA,MAAM,EACJ,KAAK,MACL,QAAQ,mBACR,OACA,aACA,MACA,MACA,YACA,UACA,UACA,YACE;EAEJ,MAAM,SAAS,qBAAqB,oBAAoB;EAExD,OAAO;GACL;GACA,GAAI,WAAW,UAAa,EAAE,OAAO;GACrC,GAAI,UAAU,UAAa,EAAE,MAAM;GACnC,GAAI,gBAAgB,UAAa,EAAE,YAAY;GAC/C,GAAI,SAAS,UAAa,EAAE,KAAK;GACjC,GAAI,SAAS,UAAa,EAAE,KAAK;GACjC,GAAI,eAAe,UAAa,EAAE,WAAW;GAC7C,GAAI,aAAa,UAAa,EAAE,SAAS;GACzC,GAAI,aAAa,UAAa,EAAE,SAAS;GACzC,GAAI,YAAY,UAAa,EAAE,QAAQ;GACvC,SAAS;IACP,UAAUC;KACTA,oCAAW;IACZ,UAAU;GACZ;EACF;CACF,SAAS,OAAO;EACd,QAAQ,MACN,iDAAiD,KAAK,IACtD,KACF;EACA;CACF;AACF"}

package/dist/cjs/syncPluginKit/createSyncPlugin.cjs

@@ -3,6 +3,51 @@ let node_path = require("node:path");
 let _intlayer_config_logger = require("@intlayer/config/logger");
 
 //#region src/syncPluginKit/createSyncPlugin.ts
+/** Separator between the dictionary segment and the key remainder of a flat id. */
+const KEY_PREFIX_SEPARATOR = ".";
+/**
+* Groups a flat map of dotted ids by their first segment.
+*
+* `{ 'footer.github': 'GitHub', 'footer.contact': 'Contact', 'banner': '!' }`
+* becomes `{ footer: { github: 'GitHub', contact: 'Contact' }, banner: '!' }`.
+*
+* An id without a separator names a dictionary whose content is the value
+* itself — the shape the optimize pass binds with an empty key remainder.
+* Nested (non-flat) values are passed through under their own key, so a
+* catalog mixing both shapes still round-trips.
+*/
+const groupByKeyPrefix = (content) => {
+	const grouped = {};
+	for (const [id, value] of Object.entries(content)) {
+		const separatorIndex = id.indexOf(KEY_PREFIX_SEPARATOR);
+		if (separatorIndex === -1) {
+			grouped[id] = value;
+			continue;
+		}
+		const prefix = id.slice(0, separatorIndex);
+		const remainder = id.slice(separatorIndex + 1);
+		const bucket = grouped[prefix];
+		if (bucket !== void 0 && typeof bucket !== "object") {
+			grouped[id] = value;
+			continue;
+		}
+		grouped[prefix] = {
+			...bucket ?? {},
+			[remainder]: value
+		};
+	}
+	return grouped;
+};
+/**
+* Inverse of {@link groupByKeyPrefix} for one dictionary: re-joins a grouped
+* bucket back into the flat dotted ids the source file stores.
+*/
+const flattenKeyPrefix = (prefix, content) => {
+	if (content === null || typeof content !== "object" || Array.isArray(content)) return { [prefix]: content };
+	const flattened = {};
+	for (const [key, value] of Object.entries(content)) flattened[`${prefix}${KEY_PREFIX_SEPARATOR}${key}`] = value;
+	return flattened;
+};
 /**
 * Content that carries nothing to persist: `undefined`, `null`, or an object
 * without any own key. Writing it back would erase the target.
@@ -59,7 +104,8 @@ const createSyncPlugin = (options) => {
 			const fill = patternFill ?? relativeFilePath;
 			const identifier = relativeFilePath ?? entry.uri;
 			if (shouldSplitByKeys) {
-				for (const [namespaceKey, namespaceContent] of Object.entries(content)) dictionaries.push({
+				const splitContent = shouldSplitByKeys === "key-prefix" ? groupByKeyPrefix(content) : content;
+				for (const [namespaceKey, namespaceContent] of Object.entries(splitContent)) dictionaries.push({
 					key: namespaceKey,
 					locale: usedLocale,
 					fill,
@@ -115,7 +161,8 @@ const createSyncPlugin = (options) => {
 			key,
 			dictionary: result.dictionary
 		})).filter(({ dictionary }) => dictionary.location === location);
-		if (await resolveSplitKeys()) {
+		const splitMode = await resolveSplitKeys();
+		if (splitMode) {
 			const mergedContentByLocale = {};
 			const writeKeyByLocale = {};
 			for (const { key, dictionary } of ownedDictionaries) for (const locale of locales) {
@@ -123,7 +170,8 @@ const createSyncPlugin = (options) => {
 				const content = toPlainContent(formattedOutput.content);
 				if (isEmptyContent(content)) continue;
 				mergedContentByLocale[locale] ??= {};
-				mergedContentByLocale[locale][key] = content;
+				if (splitMode === "key-prefix") Object.assign(mergedContentByLocale[locale], flattenKeyPrefix(key, content));
+				else mergedContentByLocale[locale][key] = content;
 				writeKeyByLocale[locale] = key;
 			}
 			await parallelize(Object.keys(mergedContentByLocale), async (locale) => {

package/dist/cjs/syncPluginKit/createSyncPlugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createSyncPlugin.cjs","names":["getAppLogger","colorizePath","relative","resolve"],"sources":["../../../src/syncPluginKit/createSyncPlugin.ts"],"sourcesContent":["import { relative, resolve } from 'node:path';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { Dictionary, LocalDictionaryId } from '@intlayer/types/dictionary';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport type {\n  CreateSyncPluginOptions,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/**\n * Content that carries nothing to persist: `undefined`, `null`, or an object\n * without any own key. Writing it back would erase the target.\n */\nconst isEmptyContent = (content: unknown): boolean =>\n  typeof content === 'undefined' ||\n  content === null ||\n  (typeof content === 'object' && Object.keys(content).length === 0);\n\n/**\n * Deep-clone formatted output into plain JSON data, stripping prototypes and\n * non-serializable values before the emptiness check and the write.\n */\nconst toPlainContent = (content: unknown): unknown =>\n  typeof content === 'undefined'\n    ? undefined\n    : JSON.parse(JSON.stringify(content));\n\n/**\n * Build an Intlayer {@link Plugin} from a transport adapter.\n *\n * The factory implements the three plugin hooks once — ingestion\n * (`loadDictionaries`), content-declaration reformatting (`formatOutput`) and\n * write-back (`afterBuild`) — so adapters only describe *where* content lives\n * (filesystem, TMS such as Crowdin, extra CMS…) and codecs only describe the\n * payload format. Write-back only processes dictionaries whose `location`\n * matches this plugin instance, so adapters never see foreign content.\n */\nexport const createSyncPlugin = (options: CreateSyncPluginOptions): Plugin => {\n  const {\n    name,\n    adapter,\n    direction = 'both',\n    location,\n    priority = 0,\n    format,\n    localeOverride,\n  } = options;\n\n  let splitKeysPromise: Promise<boolean> | undefined;\n\n  /**\n   * `splitKeys` resolution is asynchronous (adapter auto-detection may parse\n   * an async source pattern), so it is resolved lazily and memoized.\n   */\n  const resolveSplitKeys = (): Promise<boolean> => {\n    splitKeysPromise ??= (async () =>\n      options.splitKeys ?? (await adapter.detectSplitKeys?.()) ?? false)();\n\n    return splitKeysPromise;\n  };\n\n  const loadDictionaries: Plugin['loadDictionaries'] = async ({\n    configuration,\n  }) => {\n    const context: SyncPluginContext = { configuration };\n    const appLogger = getAppLogger(configuration);\n\n    const entries = await adapter.list(context);\n\n    if (entries.length === 0) {\n      const sourceDescription =\n        (await adapter.describeSource?.(context)) ?? name;\n\n      appLogger(\n        `[${name}] No dictionaries found at locations matching source pattern: ${colorizePath(sourceDescription)}`,\n        { level: 'warn' }\n      );\n    }\n\n    const shouldSplitByKeys = await resolveSplitKeys();\n    const { baseDir } = configuration.system;\n    const { defaultLocale } = configuration.internationalization;\n\n    // Sync plugins advertise the source pattern (with {{key}}/{{locale}}\n    // markers) as fill target; pull-only plugins fill each entry in place.\n    let patternFill: string | undefined;\n\n    if (direction === 'both' && adapter.getFillPattern) {\n      const fillPattern = await adapter.getFillPattern(context);\n      patternFill = relative(baseDir, resolve(baseDir, fillPattern));\n    }\n\n    const dictionaries: Dictionary[] = [];\n\n    for (const entry of entries) {\n      const content = (await adapter.read(entry, context)) ?? {};\n\n      const relativeFilePath = entry.filePath\n        ? relative(baseDir, entry.filePath)\n        : undefined;\n\n      const usedLocale = (localeOverride ?? entry.locale) as Locale;\n      const filled = usedLocale !== defaultLocale ? true : undefined;\n      const fill = patternFill ?? relativeFilePath;\n      const identifier = relativeFilePath ?? entry.uri;\n\n      // One entry groups several namespaces by its first-level keys: emit one\n      // dictionary per top-level key (e.g. `Hero`, `Nav`, …).\n      if (shouldSplitByKeys) {\n        for (const [namespaceKey, namespaceContent] of Object.entries(\n          content\n        )) {\n          dictionaries.push({\n            key: namespaceKey,\n            locale: usedLocale,\n            fill,\n            format,\n            localId:\n              `${namespaceKey}::${location}::${identifier}` as LocalDictionaryId,\n            location: location as Dictionary['location'],\n            filled,\n            content: namespaceContent as SyncContent,\n            filePath: relativeFilePath,\n            priority,\n          } as Dictionary);\n        }\n        continue;\n      }\n\n      dictionaries.push({\n        key: entry.key,\n        locale: usedLocale,\n        fill,\n        format,\n        localId:\n          `${entry.key}::${location}::${identifier}` as LocalDictionaryId,\n        location: location as Dictionary['location'],\n        filled,\n        content,\n        filePath: relativeFilePath,\n        priority,\n      } as Dictionary);\n    }\n\n    return dictionaries;\n  };\n\n  if (direction === 'pull') {\n    return { name, loadDictionaries };\n  }\n\n  const formatOutput: Plugin['formatOutput'] = async ({\n    dictionary,\n    configuration,\n  }) => {\n    if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n    // In split mode several namespaces share the same target; the target is\n    // re-assembled in `afterBuild`. Skip here to avoid overwriting the whole\n    // target with a single namespace.\n    if (await resolveSplitKeys()) return dictionary;\n\n    // Ownership check: only reformat declarations this adapter can identify\n    // as its own canonical target.\n    if (!adapter.resolveUri) return dictionary;\n\n    const canonicalUri = await adapter.resolveUri(\n      { key: dictionary.key, locale: dictionary.locale as Locale },\n      { configuration }\n    );\n\n    const { baseDir } = configuration.system;\n\n    if (\n      resolve(baseDir, canonicalUri) !== resolve(baseDir, dictionary.filePath)\n    ) {\n      return dictionary;\n    }\n\n    // Lazy import to keep the module graph light when configs are transpiled\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n\n    return formatDictionaryOutput(dictionary as Dictionary, format).content;\n  };\n\n  const afterBuild: Plugin['afterBuild'] = async ({\n    dictionaries,\n    configuration,\n  }) => {\n    // Lazy imports to keep the module graph light when configs are transpiled\n    const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n    const { parallelize } = await import('../utils/parallelize');\n\n    const context: SyncPluginContext = { configuration };\n    const { locales } = configuration.internationalization;\n\n    // Only ever hand the adapter dictionaries owned by THIS plugin instance.\n    const ownedDictionaries = Object.entries(dictionaries.mergedDictionaries)\n      .map(([key, result]) => ({\n        key,\n        dictionary: result.dictionary as Dictionary,\n      }))\n      .filter(({ dictionary }) => dictionary.location === location);\n\n    if (await resolveSplitKeys()) {\n      // Split mode: every namespace dictionary writes back into the same\n      // per-locale target. Re-assemble them under their top-level key and\n      // write each target once, instead of one write per key (which would\n      // overwrite).\n      const mergedContentByLocale = {} as Record<Locale, SyncContent>;\n      const writeKeyByLocale = {} as Record<Locale, string>;\n\n      for (const { key, dictionary } of ownedDictionaries) {\n        for (const locale of locales) {\n          const localizedDictionary = getPerLocaleDictionary(\n            dictionary,\n            locale\n          );\n\n          const formattedOutput = formatDictionaryOutput(\n            localizedDictionary,\n            format\n          );\n\n          const content = toPlainContent(formattedOutput.content);\n\n          if (isEmptyContent(content)) continue;\n\n          mergedContentByLocale[locale] ??= {};\n          mergedContentByLocale[locale][key] = content;\n          writeKeyByLocale[locale] = key;\n        }\n      }\n\n      await parallelize(\n        Object.keys(mergedContentByLocale) as Locale[],\n        async (locale) => {\n          await adapter.write(\n            { key: writeKeyByLocale[locale], locale },\n            mergedContentByLocale[locale],\n            context\n          );\n        }\n      );\n\n      return;\n    }\n\n    const writeTasks = ownedDictionaries.flatMap(({ key, dictionary }) =>\n      locales.map((locale) => ({ key, dictionary, locale }))\n    );\n\n    await parallelize(writeTasks, async ({ key, dictionary, locale }) => {\n      const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n      const formattedOutput = formatDictionaryOutput(\n        localizedDictionary,\n        format\n      );\n\n      const content = toPlainContent(formattedOutput.content);\n\n      if (isEmptyContent(content)) return;\n\n      await adapter.write({ key, locale }, content as SyncContent, context);\n    });\n  };\n\n  return { name, loadDictionaries, formatOutput, afterBuild };\n};\n"],"mappings":"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"}
+{"version":3,"file":"createSyncPlugin.cjs","names":["getAppLogger","colorizePath","relative","resolve"],"sources":["../../../src/syncPluginKit/createSyncPlugin.ts"],"sourcesContent":["import { relative, resolve } from 'node:path';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { Dictionary, LocalDictionaryId } from '@intlayer/types/dictionary';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport type {\n  CreateSyncPluginOptions,\n  SplitKeysMode,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/** Separator between the dictionary segment and the key remainder of a flat id. */\nconst KEY_PREFIX_SEPARATOR = '.';\n\n/**\n * Groups a flat map of dotted ids by their first segment.\n *\n * `{ 'footer.github': 'GitHub', 'footer.contact': 'Contact', 'banner': '!' }`\n * becomes `{ footer: { github: 'GitHub', contact: 'Contact' }, banner: '!' }`.\n *\n * An id without a separator names a dictionary whose content is the value\n * itself — the shape the optimize pass binds with an empty key remainder.\n * Nested (non-flat) values are passed through under their own key, so a\n * catalog mixing both shapes still round-trips.\n */\nconst groupByKeyPrefix = (\n  content: SyncContent\n): Record<string, SyncContent | unknown> => {\n  const grouped: Record<string, SyncContent | unknown> = {};\n\n  for (const [id, value] of Object.entries(content)) {\n    const separatorIndex = id.indexOf(KEY_PREFIX_SEPARATOR);\n\n    if (separatorIndex === -1) {\n      grouped[id] = value;\n      continue;\n    }\n\n    const prefix = id.slice(0, separatorIndex);\n    const remainder = id.slice(separatorIndex + 1);\n    const bucket = grouped[prefix];\n\n    // A scalar already sits here (`'a'` seen before `'a.b'`): keep the scalar\n    // and leave the dotted id whole, rather than silently dropping either.\n    if (bucket !== undefined && typeof bucket !== 'object') {\n      grouped[id] = value;\n      continue;\n    }\n\n    grouped[prefix] = { ...((bucket ?? {}) as object), [remainder]: value };\n  }\n\n  return grouped;\n};\n\n/**\n * Inverse of {@link groupByKeyPrefix} for one dictionary: re-joins a grouped\n * bucket back into the flat dotted ids the source file stores.\n */\nconst flattenKeyPrefix = (\n  prefix: string,\n  content: unknown\n): Record<string, unknown> => {\n  if (\n    content === null ||\n    typeof content !== 'object' ||\n    Array.isArray(content)\n  ) {\n    // Dot-less id — the dictionary content *is* the message.\n    return { [prefix]: content };\n  }\n\n  const flattened: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(content)) {\n    flattened[`${prefix}${KEY_PREFIX_SEPARATOR}${key}`] = value;\n  }\n  return flattened;\n};\n\n/**\n * Content that carries nothing to persist: `undefined`, `null`, or an object\n * without any own key. Writing it back would erase the target.\n */\nconst isEmptyContent = (content: unknown): boolean =>\n  typeof content === 'undefined' ||\n  content === null ||\n  (typeof content === 'object' && Object.keys(content).length === 0);\n\n/**\n * Deep-clone formatted output into plain JSON data, stripping prototypes and\n * non-serializable values before the emptiness check and the write.\n */\nconst toPlainContent = (content: unknown): unknown =>\n  typeof content === 'undefined'\n    ? undefined\n    : JSON.parse(JSON.stringify(content));\n\n/**\n * Build an Intlayer {@link Plugin} from a transport adapter.\n *\n * The factory implements the three plugin hooks once — ingestion\n * (`loadDictionaries`), content-declaration reformatting (`formatOutput`) and\n * write-back (`afterBuild`) — so adapters only describe *where* content lives\n * (filesystem, TMS such as Crowdin, extra CMS…) and codecs only describe the\n * payload format. Write-back only processes dictionaries whose `location`\n * matches this plugin instance, so adapters never see foreign content.\n */\nexport const createSyncPlugin = (options: CreateSyncPluginOptions): Plugin => {\n  const {\n    name,\n    adapter,\n    direction = 'both',\n    location,\n    priority = 0,\n    format,\n    localeOverride,\n  } = options;\n\n  let splitKeysPromise: Promise<SplitKeysMode> | undefined;\n\n  /**\n   * `splitKeys` resolution is asynchronous (adapter auto-detection may parse\n   * an async source pattern), so it is resolved lazily and memoized.\n   */\n  const resolveSplitKeys = (): Promise<SplitKeysMode> => {\n    splitKeysPromise ??= (async () =>\n      options.splitKeys ?? (await adapter.detectSplitKeys?.()) ?? false)();\n\n    return splitKeysPromise;\n  };\n\n  const loadDictionaries: Plugin['loadDictionaries'] = async ({\n    configuration,\n  }) => {\n    const context: SyncPluginContext = { configuration };\n    const appLogger = getAppLogger(configuration);\n\n    const entries = await adapter.list(context);\n\n    if (entries.length === 0) {\n      const sourceDescription =\n        (await adapter.describeSource?.(context)) ?? name;\n\n      appLogger(\n        `[${name}] No dictionaries found at locations matching source pattern: ${colorizePath(sourceDescription)}`,\n        { level: 'warn' }\n      );\n    }\n\n    const shouldSplitByKeys = await resolveSplitKeys();\n    const { baseDir } = configuration.system;\n    const { defaultLocale } = configuration.internationalization;\n\n    // Sync plugins advertise the source pattern (with {{key}}/{{locale}}\n    // markers) as fill target; pull-only plugins fill each entry in place.\n    let patternFill: string | undefined;\n\n    if (direction === 'both' && adapter.getFillPattern) {\n      const fillPattern = await adapter.getFillPattern(context);\n      patternFill = relative(baseDir, resolve(baseDir, fillPattern));\n    }\n\n    const dictionaries: Dictionary[] = [];\n\n    for (const entry of entries) {\n      const content = (await adapter.read(entry, context)) ?? {};\n\n      const relativeFilePath = entry.filePath\n        ? relative(baseDir, entry.filePath)\n        : undefined;\n\n      const usedLocale = (localeOverride ?? entry.locale) as Locale;\n      const filled = usedLocale !== defaultLocale ? true : undefined;\n      const fill = patternFill ?? relativeFilePath;\n      const identifier = relativeFilePath ?? entry.uri;\n\n      // One entry groups several namespaces: emit one dictionary per\n      // namespace. `true` reads them from the first-level keys (`Hero`,\n      // `Nav`, …); `'key-prefix'` derives them from the first dot-segment of\n      // a flat catalog's dotted ids (`footer.github` → `footer`).\n      if (shouldSplitByKeys) {\n        const splitContent =\n          shouldSplitByKeys === 'key-prefix'\n            ? groupByKeyPrefix(content)\n            : content;\n\n        for (const [namespaceKey, namespaceContent] of Object.entries(\n          splitContent\n        )) {\n          dictionaries.push({\n            key: namespaceKey,\n            locale: usedLocale,\n            fill,\n            format,\n            localId:\n              `${namespaceKey}::${location}::${identifier}` as LocalDictionaryId,\n            location: location as Dictionary['location'],\n            filled,\n            content: namespaceContent as SyncContent,\n            filePath: relativeFilePath,\n            priority,\n          } as Dictionary);\n        }\n        continue;\n      }\n\n      dictionaries.push({\n        key: entry.key,\n        locale: usedLocale,\n        fill,\n        format,\n        localId:\n          `${entry.key}::${location}::${identifier}` as LocalDictionaryId,\n        location: location as Dictionary['location'],\n        filled,\n        content,\n        filePath: relativeFilePath,\n        priority,\n      } as Dictionary);\n    }\n\n    return dictionaries;\n  };\n\n  if (direction === 'pull') {\n    return { name, loadDictionaries };\n  }\n\n  const formatOutput: Plugin['formatOutput'] = async ({\n    dictionary,\n    configuration,\n  }) => {\n    if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n    // In split mode several namespaces share the same target; the target is\n    // re-assembled in `afterBuild`. Skip here to avoid overwriting the whole\n    // target with a single namespace.\n    if (await resolveSplitKeys()) return dictionary;\n\n    // Ownership check: only reformat declarations this adapter can identify\n    // as its own canonical target.\n    if (!adapter.resolveUri) return dictionary;\n\n    const canonicalUri = await adapter.resolveUri(\n      { key: dictionary.key, locale: dictionary.locale as Locale },\n      { configuration }\n    );\n\n    const { baseDir } = configuration.system;\n\n    if (\n      resolve(baseDir, canonicalUri) !== resolve(baseDir, dictionary.filePath)\n    ) {\n      return dictionary;\n    }\n\n    // Lazy import to keep the module graph light when configs are transpiled\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n\n    return formatDictionaryOutput(dictionary as Dictionary, format).content;\n  };\n\n  const afterBuild: Plugin['afterBuild'] = async ({\n    dictionaries,\n    configuration,\n  }) => {\n    // Lazy imports to keep the module graph light when configs are transpiled\n    const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n    const { parallelize } = await import('../utils/parallelize');\n\n    const context: SyncPluginContext = { configuration };\n    const { locales } = configuration.internationalization;\n\n    // Only ever hand the adapter dictionaries owned by THIS plugin instance.\n    const ownedDictionaries = Object.entries(dictionaries.mergedDictionaries)\n      .map(([key, result]) => ({\n        key,\n        dictionary: result.dictionary as Dictionary,\n      }))\n      .filter(({ dictionary }) => dictionary.location === location);\n\n    const splitMode = await resolveSplitKeys();\n\n    if (splitMode) {\n      // Split mode: every namespace dictionary writes back into the same\n      // per-locale target. Re-assemble them under their top-level key and\n      // write each target once, instead of one write per key (which would\n      // overwrite).\n      const mergedContentByLocale = {} as Record<Locale, SyncContent>;\n      const writeKeyByLocale = {} as Record<Locale, string>;\n\n      for (const { key, dictionary } of ownedDictionaries) {\n        for (const locale of locales) {\n          const localizedDictionary = getPerLocaleDictionary(\n            dictionary,\n            locale\n          );\n\n          const formattedOutput = formatDictionaryOutput(\n            localizedDictionary,\n            format\n          );\n\n          const content = toPlainContent(formattedOutput.content);\n\n          if (isEmptyContent(content)) continue;\n\n          mergedContentByLocale[locale] ??= {};\n\n          // `'key-prefix'` split the flat dotted ids apart on read; restore\n          // them so the source file keeps the shape its library expects,\n          // instead of gaining a nested object per prefix.\n          if (splitMode === 'key-prefix') {\n            Object.assign(\n              mergedContentByLocale[locale],\n              flattenKeyPrefix(key, content)\n            );\n          } else {\n            mergedContentByLocale[locale][key] = content;\n          }\n\n          writeKeyByLocale[locale] = key;\n        }\n      }\n\n      await parallelize(\n        Object.keys(mergedContentByLocale) as Locale[],\n        async (locale) => {\n          await adapter.write(\n            { key: writeKeyByLocale[locale], locale },\n            mergedContentByLocale[locale],\n            context\n          );\n        }\n      );\n\n      return;\n    }\n\n    const writeTasks = ownedDictionaries.flatMap(({ key, dictionary }) =>\n      locales.map((locale) => ({ key, dictionary, locale }))\n    );\n\n    await parallelize(writeTasks, async ({ key, dictionary, locale }) => {\n      const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n      const formattedOutput = formatDictionaryOutput(\n        localizedDictionary,\n        format\n      );\n\n      const content = toPlainContent(formattedOutput.content);\n\n      if (isEmptyContent(content)) return;\n\n      await adapter.write({ key, locale }, content as SyncContent, context);\n    });\n  };\n\n  return { name, loadDictionaries, formatOutput, afterBuild };\n};\n"],"mappings":"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"}

package/dist/cjs/utils/contentWatcherLock.cjs

@@ -0,0 +1,173 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+let _intlayer_config_logger = require("@intlayer/config/logger");
+let node_fs = require("node:fs");
+let _intlayer_config_colors = require("@intlayer/config/colors");
+_intlayer_config_colors = require_runtime.__toESM(_intlayer_config_colors);
+
+//#region src/utils/contentWatcherLock.ts
+/**
+* Set on every process spawned by `intlayer watch --with` (and
+* `intlayer build --watch --with`), so a bundler plugin running as that child
+* knows a CLI watcher is already covering the project — without having to
+* depend on the two processes reaching the lock file in a given order.
+*
+* Holds the label of the command that set it.
+*/
+const CLI_CONTENT_WATCHER_ENV_VAR = "INTLAYER_CLI_CONTENT_WATCHER";
+/** Name of the file materialising the ownership of the content watcher. */
+const CONTENT_WATCHER_LOCK_FILE_NAME = "intlayer-content-watcher.lock";
+/** How many times taking the lock may follow up on a reclaimed stale one. */
+const ACQUIRE_ATTEMPTS = 3;
+/** Lock owned by this process, released on exit. */
+let ownedLockFilePath;
+process.on("exit", () => {
+	if (!ownedLockFilePath) return;
+	try {
+		(0, node_fs.rmSync)(ownedLockFilePath, { force: true });
+	} catch {}
+});
+/**
+* Path of the lock coordinating every content watcher of one project.
+*
+* Deliberately at the root of `.intlayer` rather than in its `cache`
+* subdirectory: `cleanOutputDir` wipes every subdirectory of `.intlayer`, so a
+* lock kept in `cache` would be erased by any `prepareIntlayer` that cleans —
+* after which a bundler plugin would see no owner and start a second watcher
+* next to the `intlayer watch` still running. The root itself is never removed.
+*
+* @param configuration - The resolved Intlayer configuration.
+*/
+const getContentWatcherLockFilePath = (configuration) => (0, node_path.join)(configuration.system.tempDir, CONTENT_WATCHER_LOCK_FILE_NAME);
+/**
+* Whether a PID belongs to a process that is still running.
+*/
+const getIsProcessAlive = (pid) => {
+	if (pid === process.pid) return true;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error.code === "EPERM";
+	}
+};
+/**
+* Reads the lock, removing it when it describes a process that has since died.
+*
+* An unreadable or malformed lock is treated as abandoned: a corrupted file
+* must never block the watcher for a whole dev session.
+*
+* @returns The live owner, or `null` when nothing is watching.
+*/
+const getContentWatcherOwner = async (configuration) => {
+	const lockFilePath = getContentWatcherLockFilePath(configuration);
+	let owner;
+	try {
+		owner = JSON.parse(await (0, node_fs_promises.readFile)(lockFilePath, "utf8"));
+	} catch {
+		return null;
+	}
+	if (owner.pid && getIsProcessAlive(owner.pid)) return {
+		pid: owner.pid,
+		source: owner.source ?? "bundler",
+		label: owner.label ?? "Intlayer",
+		since: owner.since
+	};
+	try {
+		await (0, node_fs_promises.rm)(lockFilePath, { force: true });
+	} catch {}
+	return null;
+};
+/**
+* Tries to become the process that watches this project's content
+* declarations.
+*
+* Creating the file with `wx` is atomic, so exactly one process wins even when
+* several try at the same moment — which is the normal case on Next.js, where
+* `next.config.*` is evaluated in more than one process.
+*
+* @param configuration - The resolved Intlayer configuration.
+* @param owner - How this process should describe itself to the others.
+* @returns `true` when this process now owns the watcher.
+*/
+const acquireContentWatcherLock = async (configuration, owner) => {
+	const lockFilePath = getContentWatcherLockFilePath(configuration);
+	const data = JSON.stringify({
+		pid: process.pid,
+		...owner
+	});
+	for (let attempt = 0; attempt < ACQUIRE_ATTEMPTS; attempt++) try {
+		await (0, node_fs_promises.mkdir)((0, node_path.dirname)(lockFilePath), { recursive: true });
+		await (0, node_fs_promises.writeFile)(lockFilePath, data, { flag: "wx" });
+		ownedLockFilePath = lockFilePath;
+		return true;
+	} catch (error) {
+		if (error.code !== "EEXIST") return false;
+		if (await getContentWatcherOwner(configuration)) return false;
+	}
+	return false;
+};
+/**
+* The CLI watcher command this process was spawned by, or `null` when it was
+* not started through `intlayer watch --with`.
+*/
+const getCliContentWatcherLabel = () => process.env["INTLAYER_CLI_CONTENT_WATCHER"] || null;
+/**
+* Registers a CLI command as the content watcher of this project.
+*
+* Call it *before* spawning a `--with` child: taking the lock first means the
+* bundler plugin inside that child never races the command for it, and the
+* environment marker makes the child's decision independent of the filesystem
+* altogether.
+*
+* @param configuration - The resolved Intlayer configuration.
+* @param label - How the command should be named in a message.
+* @returns The bundler already watching this project, or `null` when the
+* command took the watcher for itself. A CLI watcher never stands down on that
+* answer — watching is what it was asked to do — but reporting it lets the user
+* know the parallel command has become redundant.
+*/
+const claimCliContentWatcher = async (configuration, label) => {
+	process.env[CLI_CONTENT_WATCHER_ENV_VAR] = label;
+	if (await acquireContentWatcherLock(configuration, {
+		source: "cli",
+		label
+	})) return null;
+	const owner = await getContentWatcherOwner(configuration);
+	return owner?.source === "bundler" ? owner : null;
+};
+/** Keeps the redundant-watcher notice to one per process. */
+let hasReportedRedundantWatcher = false;
+/**
+* Reports a CLI watcher running alongside a bundler integration that watches
+* on its own, and points at the parallel command as the part to drop.
+*
+* Emitted at most once per process: a bundler config is evaluated several times
+* per command, and callers may re-enter this on a retry loop.
+*
+* @param configuration - The resolved Intlayer configuration.
+* @param report - Who is watching, and from which release it became redundant.
+*/
+const reportRedundantContentWatcher = (configuration, { cliLabel, bundlerLabel, since }) => {
+	if (hasReportedRedundantWatcher) return;
+	hasReportedRedundantWatcher = true;
+	(0, _intlayer_config_logger.getAppLogger)(configuration)([
+		(0, _intlayer_config_logger.colorize)(cliLabel, _intlayer_config_colors.BLUE, _intlayer_config_colors.BEIGE),
+		"is watching your content declarations in parallel with",
+		`${(0, _intlayer_config_logger.colorize)(bundlerLabel, _intlayer_config_colors.BLUE, _intlayer_config_colors.BEIGE)},`,
+		since ? `which watches them on its own since ${(0, _intlayer_config_logger.colorize)(`${bundlerLabel}@${since}`, _intlayer_config_colors.GREY_LIGHT, _intlayer_config_colors.BEIGE)}.` : "which watches them on its own.",
+		"The parallel watch command is no longer needed — running your dev server on its own is enough."
+	], { level: "warn" });
+};
+
+//#endregion
+exports.CLI_CONTENT_WATCHER_ENV_VAR = CLI_CONTENT_WATCHER_ENV_VAR;
+exports.acquireContentWatcherLock = acquireContentWatcherLock;
+exports.claimCliContentWatcher = claimCliContentWatcher;
+exports.getCliContentWatcherLabel = getCliContentWatcherLabel;
+exports.getContentWatcherLockFilePath = getContentWatcherLockFilePath;
+exports.getContentWatcherOwner = getContentWatcherOwner;
+exports.reportRedundantContentWatcher = reportRedundantContentWatcher;
+//# sourceMappingURL=contentWatcherLock.cjs.map

package/dist/cjs/utils/contentWatcherLock.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentWatcherLock.cjs","names":["join","readFile","rm","mkdir","dirname","writeFile","colorize","ANSIColors"],"sources":["../../../src/utils/contentWatcherLock.ts"],"sourcesContent":["import { rmSync } from 'node:fs';\nimport { mkdir, readFile, rm, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * What kind of process is watching the content declarations.\n *\n * - `cli` — the `intlayer watch` / `intlayer build --watch` command.\n * - `bundler` — an Intlayer bundler plugin (e.g. `withIntlayer` on Next.js).\n */\nexport type ContentWatcherSource = 'cli' | 'bundler';\n\nexport type ContentWatcherOwner = {\n  /** PID of the process holding the watcher. */\n  pid: number;\n  source: ContentWatcherSource;\n  /**\n   * How the owner should be named in a message, e.g. `intlayer watch` or\n   * `next-intlayer`.\n   */\n  label: string;\n  /**\n   * Release from which a `bundler` owner watches the content declarations on\n   * its own, so a CLI watcher finding it can name the version that made the\n   * parallel command redundant without keeping a table of its own.\n   */\n  since?: string;\n};\n\n/**\n * Set on every process spawned by `intlayer watch --with` (and\n * `intlayer build --watch --with`), so a bundler plugin running as that child\n * knows a CLI watcher is already covering the project — without having to\n * depend on the two processes reaching the lock file in a given order.\n *\n * Holds the label of the command that set it.\n */\nexport const CLI_CONTENT_WATCHER_ENV_VAR = 'INTLAYER_CLI_CONTENT_WATCHER';\n\n/** Name of the file materialising the ownership of the content watcher. */\nconst CONTENT_WATCHER_LOCK_FILE_NAME = 'intlayer-content-watcher.lock';\n\n/** How many times taking the lock may follow up on a reclaimed stale one. */\nconst ACQUIRE_ATTEMPTS = 3;\n\n/** Lock owned by this process, released on exit. */\nlet ownedLockFilePath: string | undefined;\n\n// The one place that has to stay synchronous: Node runs `exit` listeners to\n// completion without an event loop turn, so a promise scheduled here would\n// never settle and the lock would outlive the process — stalling the next dev\n// session until its PID check reclaims it.\nprocess.on('exit', () => {\n  if (!ownedLockFilePath) return;\n\n  try {\n    rmSync(ownedLockFilePath, { force: true });\n  } catch {}\n});\n\n/**\n * Path of the lock coordinating every content watcher of one project.\n *\n * Deliberately at the root of `.intlayer` rather than in its `cache`\n * subdirectory: `cleanOutputDir` wipes every subdirectory of `.intlayer`, so a\n * lock kept in `cache` would be erased by any `prepareIntlayer` that cleans —\n * after which a bundler plugin would see no owner and start a second watcher\n * next to the `intlayer watch` still running. The root itself is never removed.\n *\n * @param configuration - The resolved Intlayer configuration.\n */\nexport const getContentWatcherLockFilePath = (\n  configuration: IntlayerConfig\n): string => join(configuration.system.tempDir, CONTENT_WATCHER_LOCK_FILE_NAME);\n\n/**\n * Whether a PID belongs to a process that is still running.\n */\nconst getIsProcessAlive = (pid: number): boolean => {\n  if (pid === process.pid) return true;\n\n  try {\n    // Signal 0 checks for existence without delivering a signal.\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    // EPERM means the process exists but belongs to another user.\n    return (error as NodeJS.ErrnoException).code === 'EPERM';\n  }\n};\n\n/**\n * Reads the lock, removing it when it describes a process that has since died.\n *\n * An unreadable or malformed lock is treated as abandoned: a corrupted file\n * must never block the watcher for a whole dev session.\n *\n * @returns The live owner, or `null` when nothing is watching.\n */\nexport const getContentWatcherOwner = async (\n  configuration: IntlayerConfig\n): Promise<ContentWatcherOwner | null> => {\n  const lockFilePath = getContentWatcherLockFilePath(configuration);\n\n  let owner: Partial<ContentWatcherOwner>;\n\n  try {\n    owner = JSON.parse(await readFile(lockFilePath, 'utf8'));\n  } catch {\n    return null;\n  }\n\n  if (owner.pid && getIsProcessAlive(owner.pid)) {\n    return {\n      pid: owner.pid,\n      source: owner.source ?? 'bundler',\n      label: owner.label ?? 'Intlayer',\n      since: owner.since,\n    };\n  }\n\n  try {\n    await rm(lockFilePath, { force: true });\n  } catch {}\n\n  return null;\n};\n\n/**\n * Tries to become the process that watches this project's content\n * declarations.\n *\n * Creating the file with `wx` is atomic, so exactly one process wins even when\n * several try at the same moment — which is the normal case on Next.js, where\n * `next.config.*` is evaluated in more than one process.\n *\n * @param configuration - The resolved Intlayer configuration.\n * @param owner - How this process should describe itself to the others.\n * @returns `true` when this process now owns the watcher.\n */\nexport const acquireContentWatcherLock = async (\n  configuration: IntlayerConfig,\n  owner: Omit<ContentWatcherOwner, 'pid'>\n): Promise<boolean> => {\n  const lockFilePath = getContentWatcherLockFilePath(configuration);\n  const data = JSON.stringify({\n    pid: process.pid,\n    ...owner,\n  } satisfies ContentWatcherOwner);\n\n  // Bounded rather than recursive: the retry only exists to follow up on a lock\n  // `getContentWatcherOwner` has just reclaimed, and two processes reclaiming\n  // and re-taking it in turn must not spin forever.\n  for (let attempt = 0; attempt < ACQUIRE_ATTEMPTS; attempt++) {\n    try {\n      await mkdir(dirname(lockFilePath), { recursive: true });\n      await writeFile(lockFilePath, data, { flag: 'wx' });\n\n      ownedLockFilePath = lockFilePath;\n\n      return true;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'EEXIST') return false;\n\n      // A lock left behind by a dead process is reclaimed by\n      // `getContentWatcherOwner`, leaving the next attempt free to take it.\n      if (await getContentWatcherOwner(configuration)) return false;\n    }\n  }\n\n  return false;\n};\n\n/**\n * The CLI watcher command this process was spawned by, or `null` when it was\n * not started through `intlayer watch --with`.\n */\nexport const getCliContentWatcherLabel = (): string | null =>\n  process.env[CLI_CONTENT_WATCHER_ENV_VAR] || null;\n\n/**\n * Registers a CLI command as the content watcher of this project.\n *\n * Call it *before* spawning a `--with` child: taking the lock first means the\n * bundler plugin inside that child never races the command for it, and the\n * environment marker makes the child's decision independent of the filesystem\n * altogether.\n *\n * @param configuration - The resolved Intlayer configuration.\n * @param label - How the command should be named in a message.\n * @returns The bundler already watching this project, or `null` when the\n * command took the watcher for itself. A CLI watcher never stands down on that\n * answer — watching is what it was asked to do — but reporting it lets the user\n * know the parallel command has become redundant.\n */\nexport const claimCliContentWatcher = async (\n  configuration: IntlayerConfig,\n  label: string\n): Promise<ContentWatcherOwner | null> => {\n  // Set before the first `await`: a `--with` child spawned while the lock is\n  // still being written must already see the marker in its environment.\n  process.env[CLI_CONTENT_WATCHER_ENV_VAR] = label;\n\n  const hasAcquiredLock = await acquireContentWatcherLock(configuration, {\n    source: 'cli',\n    label,\n  });\n\n  if (hasAcquiredLock) return null;\n\n  const owner = await getContentWatcherOwner(configuration);\n\n  return owner?.source === 'bundler' ? owner : null;\n};\n\n/** Keeps the redundant-watcher notice to one per process. */\nlet hasReportedRedundantWatcher = false;\n\ntype RedundantWatcherReport = {\n  /** Name of the CLI command watching, e.g. `intlayer watch`. */\n  cliLabel: string;\n  /** Name of the bundler integration watching, e.g. `next-intlayer`. */\n  bundlerLabel: string;\n  /**\n   * Release from which the bundler integration watches on its own. Omitted when\n   * the integration did not report one.\n   */\n  since?: string;\n};\n\n/**\n * Reports a CLI watcher running alongside a bundler integration that watches\n * on its own, and points at the parallel command as the part to drop.\n *\n * Emitted at most once per process: a bundler config is evaluated several times\n * per command, and callers may re-enter this on a retry loop.\n *\n * @param configuration - The resolved Intlayer configuration.\n * @param report - Who is watching, and from which release it became redundant.\n */\nexport const reportRedundantContentWatcher = (\n  configuration: IntlayerConfig,\n  { cliLabel, bundlerLabel, since }: RedundantWatcherReport\n): void => {\n  if (hasReportedRedundantWatcher) return;\n  hasReportedRedundantWatcher = true;\n\n  getAppLogger(configuration)(\n    [\n      colorize(cliLabel, ANSIColors.BLUE, ANSIColors.BEIGE),\n      'is watching your content declarations in parallel with',\n      `${colorize(bundlerLabel, ANSIColors.BLUE, ANSIColors.BEIGE)},`,\n      since\n        ? `which watches them on its own since ${colorize(`${bundlerLabel}@${since}`, ANSIColors.GREY_LIGHT, ANSIColors.BEIGE)}.`\n        : 'which watches them on its own.',\n      'The parallel watch command is no longer needed — running your dev server on its own is enough.',\n    ],\n    { level: 'warn' }\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwCA,MAAa,8BAA8B;;AAG3C,MAAM,iCAAiC;;AAGvC,MAAM,mBAAmB;;AAGzB,IAAI;AAMJ,QAAQ,GAAG,cAAc;CACvB,IAAI,CAAC,mBAAmB;CAExB,IAAI;EACF,oBAAO,mBAAmB,EAAE,OAAO,KAAK,CAAC;CAC3C,QAAQ,CAAC;AACX,CAAC;;;;;;;;;;;;AAaD,MAAa,iCACX,sBACWA,gBAAK,cAAc,OAAO,SAAS,8BAA8B;;;;AAK9E,MAAM,qBAAqB,QAAyB;CAClD,IAAI,QAAQ,QAAQ,KAAK,OAAO;CAEhC,IAAI;EAEF,QAAQ,KAAK,KAAK,CAAC;EACnB,OAAO;CACT,SAAS,OAAO;EAEd,OAAQ,MAAgC,SAAS;CACnD;AACF;;;;;;;;;AAUA,MAAa,yBAAyB,OACpC,kBACwC;CACxC,MAAM,eAAe,8BAA8B,aAAa;CAEhE,IAAI;CAEJ,IAAI;EACF,QAAQ,KAAK,MAAM,UAAMC,2BAAS,cAAc,MAAM,CAAC;CACzD,QAAQ;EACN,OAAO;CACT;CAEA,IAAI,MAAM,OAAO,kBAAkB,MAAM,GAAG,GAC1C,OAAO;EACL,KAAK,MAAM;EACX,QAAQ,MAAM,UAAU;EACxB,OAAO,MAAM,SAAS;EACtB,OAAO,MAAM;CACf;CAGF,IAAI;EACF,UAAMC,qBAAG,cAAc,EAAE,OAAO,KAAK,CAAC;CACxC,QAAQ,CAAC;CAET,OAAO;AACT;;;;;;;;;;;;;AAcA,MAAa,4BAA4B,OACvC,eACA,UACqB;CACrB,MAAM,eAAe,8BAA8B,aAAa;CAChE,MAAM,OAAO,KAAK,UAAU;EAC1B,KAAK,QAAQ;EACb,GAAG;CACL,CAA+B;CAK/B,KAAK,IAAI,UAAU,GAAG,UAAU,kBAAkB,WAChD,IAAI;EACF,UAAMC,4BAAMC,mBAAQ,YAAY,GAAG,EAAE,WAAW,KAAK,CAAC;EACtD,UAAMC,4BAAU,cAAc,MAAM,EAAE,MAAM,KAAK,CAAC;EAElD,oBAAoB;EAEpB,OAAO;CACT,SAAS,OAAO;EACd,IAAK,MAAgC,SAAS,UAAU,OAAO;EAI/D,IAAI,MAAM,uBAAuB,aAAa,GAAG,OAAO;CAC1D;CAGF,OAAO;AACT;;;;;AAMA,MAAa,kCACX,QAAQ,uCAAoC;;;;;;;;;;;;;;;;AAiB9C,MAAa,yBAAyB,OACpC,eACA,UACwC;CAGxC,QAAQ,IAAI,+BAA+B;CAO3C,IAAI,MAL0B,0BAA0B,eAAe;EACrE,QAAQ;EACR;CACF,CAAC,GAEoB,OAAO;CAE5B,MAAM,QAAQ,MAAM,uBAAuB,aAAa;CAExD,OAAO,OAAO,WAAW,YAAY,QAAQ;AAC/C;;AAGA,IAAI,8BAA8B;;;;;;;;;;;AAwBlC,MAAa,iCACX,eACA,EAAE,UAAU,cAAc,YACjB;CACT,IAAI,6BAA6B;CACjC,8BAA8B;CAE9B,0CAAa,aAAa,CAAC,CACzB;MACEC,kCAAS,UAAUC,wBAAW,MAAMA,wBAAW,KAAK;EACpD;EACA,OAAGD,kCAAS,cAAcC,wBAAW,MAAMA,wBAAW,KAAK,EAAE;EAC7D,QACI,2CAAuCD,kCAAS,GAAG,aAAa,GAAG,SAASC,wBAAW,YAAYA,wBAAW,KAAK,EAAE,KACrH;EACJ;CACF,GACA,EAAE,OAAO,OAAO,CAClB;AACF"}

package/dist/cjs/utils/index.cjs

@@ -9,10 +9,12 @@ const require_utils_chunkArray = require('./chunkArray.cjs');
 const require_utils_splitTextByLine = require('./splitTextByLine.cjs');
 const require_utils_getChunk = require('./getChunk.cjs');
 const require_utils_chunkJSON = require('./chunkJSON.cjs');
+const require_utils_contentWatcherLock = require('./contentWatcherLock.cjs');
 const require_utils_getContentExtension = require('./getContentExtension.cjs');
 const require_utils_getFormatFromExtension = require('./getFormatFromExtension.cjs');
 const require_utils_mergeChunks = require('./mergeChunks.cjs');
 const require_utils_parallelizeGlobal = require('./parallelizeGlobal.cjs');
+const require_utils_parseContentDeclarationFileName = require('./parseContentDeclarationFileName.cjs');
 const require_utils_reduceObjectFormat = require('./reduceObjectFormat.cjs');
 const require_utils_resolveObjectPromises = require('./resolveObjectPromises.cjs');
 const require_utils_resolveRelativePath = require('./resolveRelativePath.cjs');
@@ -20,18 +22,25 @@ const require_utils_runOnce = require('./runOnce.cjs');
 const require_utils_runParallel_index = require('./runParallel/index.cjs');
 const require_utils_sortAlphabetically = require('./sortAlphabetically.cjs');
 const require_utils_verifyIdenticObjectFormat = require('./verifyIdenticObjectFormat.cjs');
+const require_utils_withFileLock = require('./withFileLock.cjs');
 
+exports.CLI_CONTENT_WATCHER_ENV_VAR = require_utils_contentWatcherLock.CLI_CONTENT_WATCHER_ENV_VAR;
 exports.Queue = require_utils_pLimit.Queue;
+exports.acquireContentWatcherLock = require_utils_contentWatcherLock.acquireContentWatcherLock;
 exports.assembleJSON = require_utils_chunkJSON.assembleJSON;
 exports.autoDecorateContent = require_utils_autoDecorateContent.autoDecorateContent;
 exports.buildComponentFilesList = require_utils_buildComponentFilesList.buildComponentFilesList;
 exports.chunkArray = require_utils_chunkArray.chunkArray;
 exports.chunkJSON = require_utils_chunkJSON.chunkJSON;
+exports.claimCliContentWatcher = require_utils_contentWatcherLock.claimCliContentWatcher;
 exports.excludeObjectFormat = require_utils_reduceObjectFormat.excludeObjectFormat;
 exports.formatLocale = require_utils_formatter.formatLocale;
 exports.formatPath = require_utils_formatter.formatPath;
 exports.getChunk = require_utils_getChunk.getChunk;
+exports.getCliContentWatcherLabel = require_utils_contentWatcherLock.getCliContentWatcherLabel;
 exports.getContentExtension = require_utils_getContentExtension.getContentExtension;
+exports.getContentWatcherLockFilePath = require_utils_contentWatcherLock.getContentWatcherLockFilePath;
+exports.getContentWatcherOwner = require_utils_contentWatcherLock.getContentWatcherOwner;
 exports.getExtensionFromFormat = require_utils_getFormatFromExtension.getExtensionFromFormat;
 exports.getFormatFromExtension = require_utils_getFormatFromExtension.getFormatFromExtension;
 exports.getGlobalLimiter = require_utils_parallelizeGlobal.getGlobalLimiter;
@@ -41,12 +50,15 @@ exports.mergeChunks = require_utils_mergeChunks.mergeChunks;
 exports.pLimit = require_utils_pLimit.pLimit;
 exports.parallelize = require_utils_parallelize.parallelize;
 exports.parallelizeGlobal = require_utils_parallelizeGlobal.parallelizeGlobal;
+exports.parseContentDeclarationFileName = require_utils_parseContentDeclarationFileName.parseContentDeclarationFileName;
 exports.reconstructFromSingleChunk = require_utils_chunkJSON.reconstructFromSingleChunk;
 exports.reduceObjectFormat = require_utils_reduceObjectFormat.reduceObjectFormat;
+exports.reportRedundantContentWatcher = require_utils_contentWatcherLock.reportRedundantContentWatcher;
 exports.resolveObjectPromises = require_utils_resolveObjectPromises.resolveObjectPromises;
 exports.resolveRelativePath = require_utils_resolveRelativePath.resolveRelativePath;
 exports.runOnce = require_utils_runOnce.runOnce;
 exports.runParallel = require_utils_runParallel_index.runParallel;
 exports.sortAlphabetically = require_utils_sortAlphabetically.sortAlphabetically;
 exports.splitTextByLines = require_utils_splitTextByLine.splitTextByLines;
-exports.verifyIdenticObjectFormat = require_utils_verifyIdenticObjectFormat.verifyIdenticObjectFormat;
+exports.verifyIdenticObjectFormat = require_utils_verifyIdenticObjectFormat.verifyIdenticObjectFormat;
+exports.withFileLock = require_utils_withFileLock.withFileLock;

package/dist/cjs/utils/parseContentDeclarationFileName.cjs

@@ -0,0 +1,35 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let node_path = require("node:path");
+
+//#region src/utils/parseContentDeclarationFileName.ts
+/** Fallback used when the file name matches no configured content extension */
+const CONTENT_EXTENSION_PATTERN = /\.content\.[^.]+$/;
+/**
+* Splits a content declaration file name into its dictionary key and its
+* optional locale suffix.
+*
+* @example
+* parseContentDeclarationFileName('src/about.content.ts', configuration)
+* // { key: 'about' }
+*
+* parseContentDeclarationFileName('src/about.fr.content.md', configuration)
+* // { key: 'about', locale: 'fr' }
+*/
+const parseContentDeclarationFileName = (filePath, configuration) => {
+	const fileName = (0, node_path.basename)(filePath);
+	const matchedExtension = configuration.content.fileExtensions.filter((extension) => fileName.endsWith(extension)).sort((a, b) => b.length - a.length)[0];
+	const nameWithoutExtension = matchedExtension ? fileName.slice(0, -matchedExtension.length) : fileName.replace(CONTENT_EXTENSION_PATTERN, "");
+	const lastSegmentIndex = nameWithoutExtension.lastIndexOf(".");
+	if (lastSegmentIndex <= 0) return { key: nameWithoutExtension };
+	const lastSegment = nameWithoutExtension.slice(lastSegmentIndex + 1);
+	const matchedLocale = configuration.internationalization.locales.find((locale) => locale.toLowerCase() === lastSegment.toLowerCase());
+	if (!matchedLocale) return { key: nameWithoutExtension };
+	return {
+		key: nameWithoutExtension.slice(0, lastSegmentIndex),
+		locale: matchedLocale
+	};
+};
+
+//#endregion
+exports.parseContentDeclarationFileName = parseContentDeclarationFileName;
+//# sourceMappingURL=parseContentDeclarationFileName.cjs.map

package/dist/cjs/utils/parseContentDeclarationFileName.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseContentDeclarationFileName.cjs","names":["basename"],"sources":["../../../src/utils/parseContentDeclarationFileName.ts"],"sourcesContent":["import { basename } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport type ContentDeclarationFileName = {\n  /** Dictionary key derived from the file name, locale suffix excluded */\n  key: string;\n  /** Locale declared as a file name suffix, e.g. `about.fr.content.md` -> `fr` */\n  locale?: LocalesValues;\n};\n\n/** Fallback used when the file name matches no configured content extension */\nconst CONTENT_EXTENSION_PATTERN = /\\.content\\.[^.]+$/;\n\n/**\n * Splits a content declaration file name into its dictionary key and its\n * optional locale suffix.\n *\n * @example\n * parseContentDeclarationFileName('src/about.content.ts', configuration)\n * // { key: 'about' }\n *\n * parseContentDeclarationFileName('src/about.fr.content.md', configuration)\n * // { key: 'about', locale: 'fr' }\n */\nexport const parseContentDeclarationFileName = (\n  filePath: string,\n  configuration: IntlayerConfig\n): ContentDeclarationFileName => {\n  const fileName = basename(filePath);\n\n  // Longest match first so `.content.mdx` wins over a hypothetical `.mdx`\n  const matchedExtension = configuration.content.fileExtensions\n    .filter((extension) => fileName.endsWith(extension))\n    .sort((a, b) => b.length - a.length)[0];\n\n  const nameWithoutExtension = matchedExtension\n    ? fileName.slice(0, -matchedExtension.length)\n    : fileName.replace(CONTENT_EXTENSION_PATTERN, '');\n\n  const lastSegmentIndex = nameWithoutExtension.lastIndexOf('.');\n\n  // A name made of a single segment is the key itself, never a locale\n  if (lastSegmentIndex <= 0) return { key: nameWithoutExtension };\n\n  const lastSegment = nameWithoutExtension.slice(lastSegmentIndex + 1);\n  const matchedLocale = configuration.internationalization.locales.find(\n    (locale) => locale.toLowerCase() === lastSegment.toLowerCase()\n  );\n\n  if (!matchedLocale) return { key: nameWithoutExtension };\n\n  return {\n    key: nameWithoutExtension.slice(0, lastSegmentIndex),\n    locale: matchedLocale,\n  };\n};\n"],"mappings":";;;;;AAYA,MAAM,4BAA4B;;;;;;;;;;;;AAalC,MAAa,mCACX,UACA,kBAC+B;CAC/B,MAAM,eAAWA,oBAAS,QAAQ;CAGlC,MAAM,mBAAmB,cAAc,QAAQ,eAC5C,QAAQ,cAAc,SAAS,SAAS,SAAS,CAAC,CAAC,CACnD,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;CAEvC,MAAM,uBAAuB,mBACzB,SAAS,MAAM,GAAG,CAAC,iBAAiB,MAAM,IAC1C,SAAS,QAAQ,2BAA2B,EAAE;CAElD,MAAM,mBAAmB,qBAAqB,YAAY,GAAG;CAG7D,IAAI,oBAAoB,GAAG,OAAO,EAAE,KAAK,qBAAqB;CAE9D,MAAM,cAAc,qBAAqB,MAAM,mBAAmB,CAAC;CACnE,MAAM,gBAAgB,cAAc,qBAAqB,QAAQ,MAC9D,WAAW,OAAO,YAAY,MAAM,YAAY,YAAY,CAC/D;CAEA,IAAI,CAAC,eAAe,OAAO,EAAE,KAAK,qBAAqB;CAEvD,OAAO;EACL,KAAK,qBAAqB,MAAM,GAAG,gBAAgB;EACnD,QAAQ;CACV;AACF"}

package/dist/cjs/utils/withFileLock.cjs

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