@intlayer/engine 9.0.0-canary.12

package/dist/esm/writeContentDeclaration/writeContentDeclaration.mjs

@@ -0,0 +1,162 @@
+import { readDictionariesFromDisk } from "../utils/readDictionariesFromDisk.mjs";
+import { getFormatFromExtension } from "../utils/getFormatFromExtension.mjs";
+import { detectFormatCommand } from "../detectFormatCommand.mjs";
+import { processContentDeclarationContent } from "./processContentDeclarationContent.mjs";
+import { transformJSONFile } from "./transformJSONFile.mjs";
+import { writeJSFile } from "./writeJSFile.mjs";
+import { writeMarkdownFile } from "./writeMarkdownFile.mjs";
+import { writeYamlFile } from "./writeYamlFile.mjs";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { COMPILER_NO_METADATA } from "@intlayer/config/defaultValues";
+import { getFilteredLocalesDictionary, getPerLocaleDictionary } from "@intlayer/core/plugins";
+import { execSync } from "node:child_process";
+import { isDeepStrictEqual } from "node:util";
+
+//#region src/writeContentDeclaration/writeContentDeclaration.ts
+const formatContentDeclaration = async (dictionary, configuration, localeList) => {
+	/**
+	* Clean Markdown, Insertion, File, etc. node metadata
+	*/
+	const processedDictionary = await processContentDeclarationContent(dictionary);
+	let content = processedDictionary.content;
+	/**
+	* Filter locales content
+	*/
+	if (dictionary.locale) content = getPerLocaleDictionary(processedDictionary, dictionary.locale).content;
+	else if (localeList) content = getFilteredLocalesDictionary(processedDictionary, localeList).content;
+	let pluginFormatResult = {
+		...dictionary,
+		content
+	};
+	/**
+	* Format the dictionary with the plugins
+	*/
+	for await (const plugin of configuration.plugins ?? []) if (plugin.formatOutput) {
+		const formattedResult = await plugin.formatOutput?.({
+			dictionary: pluginFormatResult,
+			configuration
+		});
+		if (formattedResult) pluginFormatResult = formattedResult;
+	}
+	if (!(pluginFormatResult.content && pluginFormatResult.key)) return pluginFormatResult;
+	const INTERNAL_FIELDS = new Set([
+		"$schema",
+		"filePath",
+		"localId",
+		"localIds",
+		"projectIds"
+	]);
+	let result = {
+		...Object.fromEntries(Object.entries(dictionary).filter(([k]) => !INTERNAL_FIELDS.has(k))),
+		content
+	};
+	if (getFormatFromExtension(dictionary.filePath ? extname(dictionary.filePath) : ".json") === "json" && pluginFormatResult.content && pluginFormatResult.key) result = {
+		$schema: "https://intlayer.org/schema.json",
+		...result
+	};
+	return result;
+};
+const defaultOptions = { newDictionariesPath: "intlayer-dictionaries" };
+const writeContentDeclaration = async (dictionary, configuration, options) => {
+	const { system, compiler } = configuration;
+	const { baseDir } = system;
+	const noMetadata = compiler?.noMetadata ?? COMPILER_NO_METADATA;
+	const { newDictionariesPath, localeList } = {
+		...defaultOptions,
+		...options
+	};
+	const newDictionaryLocationPath = join(baseDir, newDictionariesPath);
+	const existingDictionary = readDictionariesFromDisk(configuration.system.unmergedDictionariesDir)[dictionary.key]?.find((el) => el.localId === dictionary.localId);
+	const formattedContentDeclaration = await formatContentDeclaration(dictionary, configuration, localeList);
+	if (existingDictionary?.filePath) {
+		const isSameContent = isDeepStrictEqual(existingDictionary, dictionary);
+		const filePath = resolve(configuration.system.baseDir, existingDictionary.filePath);
+		if (isSameContent) return {
+			status: "up-to-date",
+			path: filePath
+		};
+		await writeFileWithDirectories(filePath, formattedContentDeclaration, configuration, noMetadata);
+		return {
+			status: "updated",
+			path: filePath
+		};
+	}
+	if (dictionary.filePath) {
+		const filePath = resolve(configuration.system.baseDir, dictionary.filePath);
+		await writeFileWithDirectories(filePath, formattedContentDeclaration, configuration, noMetadata);
+		return {
+			status: "created",
+			path: filePath
+		};
+	}
+	const contentDeclarationPath = join(newDictionaryLocationPath, `${dictionary.key}.content.json`);
+	await writeFileWithDirectories(contentDeclarationPath, formattedContentDeclaration, configuration, noMetadata);
+	return {
+		status: "imported",
+		path: contentDeclarationPath
+	};
+};
+const writeFileWithDirectories = async (absoluteFilePath, dictionary, configuration, noMetadata) => {
+	await mkdir(dirname(absoluteFilePath), { recursive: true });
+	const extension = extname(absoluteFilePath);
+	if (extension === ".md" || extension === ".mdx") {
+		await writeMarkdownFile(absoluteFilePath, dictionary, configuration);
+		return;
+	}
+	if (extension === ".yaml" || extension === ".yml") {
+		await writeYamlFile(absoluteFilePath, dictionary, configuration);
+		return;
+	}
+	if ([
+		".json",
+		".jsonc",
+		".json5"
+	].includes(extension)) {
+		let fileContent = "{}";
+		if (existsSync(absoluteFilePath)) try {
+			fileContent = await readFile(absoluteFilePath, "utf-8");
+		} catch {}
+		const transformedContent = transformJSONFile(fileContent, dictionary, noMetadata);
+		const tempDir = configuration.system?.tempDir;
+		if (tempDir) await mkdir(tempDir, { recursive: true });
+		const tempFileName = `${basename(absoluteFilePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;
+		const tempPath = tempDir ? join(tempDir, tempFileName) : `${absoluteFilePath}.${tempFileName}`;
+		try {
+			await writeFile(tempPath, transformedContent, "utf-8");
+			await rename(tempPath, absoluteFilePath);
+		} catch (error) {
+			try {
+				await rm(tempPath, { force: true });
+			} catch {}
+			throw error;
+		}
+		const formatCommand = detectFormatCommand(configuration);
+		if (formatCommand) try {
+			execSync(formatCommand.replace("{{file}}", absoluteFilePath), {
+				stdio: "inherit",
+				cwd: configuration.system.baseDir
+			});
+		} catch (error) {
+			console.error(error);
+		}
+		return;
+	}
+	if (!new Set([
+		".ts",
+		".tsx",
+		".js",
+		".jsx",
+		".mjs",
+		".cjs"
+	]).has(extension)) return;
+	await writeJSFile(absoluteFilePath, dictionary, configuration, noMetadata);
+	try {
+		await rm(join(configuration.system.cacheDir, "intlayer-prepared.lock"), { recursive: true });
+	} catch {}
+};
+
+//#endregion
+export { writeContentDeclaration };
+//# sourceMappingURL=writeContentDeclaration.mjs.map

package/dist/esm/writeContentDeclaration/writeContentDeclaration.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeContentDeclaration.mjs","names":[],"sources":["../../../src/writeContentDeclaration/writeContentDeclaration.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';\nimport { basename, dirname, extname, join, resolve } from 'node:path';\nimport { isDeepStrictEqual } from 'node:util';\nimport { COMPILER_NO_METADATA } from '@intlayer/config/defaultValues';\nimport {\n  getFilteredLocalesDictionary,\n  getPerLocaleDictionary,\n} from '@intlayer/core/plugins';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { detectFormatCommand } from '../detectFormatCommand';\nimport {\n  type Extension,\n  getFormatFromExtension,\n} from '../utils/getFormatFromExtension';\nimport { readDictionariesFromDisk } from '../utils/readDictionariesFromDisk';\nimport type { DictionaryStatus } from './dictionaryStatus';\nimport { processContentDeclarationContent } from './processContentDeclarationContent';\nimport { transformJSONFile } from './transformJSONFile';\nimport { writeJSFile } from './writeJSFile';\nimport { writeMarkdownFile } from './writeMarkdownFile';\nimport { writeYamlFile } from './writeYamlFile';\n\nconst formatContentDeclaration = async (\n  dictionary: Dictionary,\n  configuration: IntlayerConfig,\n  localeList?: LocalesValues[]\n) => {\n  /**\n   * Clean Markdown, Insertion, File, etc. node metadata\n   */\n  const processedDictionary =\n    await processContentDeclarationContent(dictionary);\n\n  let content = processedDictionary.content;\n\n  /**\n   * Filter locales content\n   */\n\n  if (dictionary.locale) {\n    content = getPerLocaleDictionary(\n      processedDictionary,\n      dictionary.locale\n    ).content;\n  } else if (localeList) {\n    content = getFilteredLocalesDictionary(\n      processedDictionary,\n      localeList\n    ).content;\n  }\n\n  let pluginFormatResult: any = {\n    ...dictionary,\n    content,\n  } satisfies Dictionary;\n\n  /**\n   * Format the dictionary with the plugins\n   */\n\n  for await (const plugin of configuration.plugins ?? []) {\n    if (plugin.formatOutput) {\n      const formattedResult = await plugin.formatOutput?.({\n        dictionary: pluginFormatResult,\n        configuration,\n      });\n\n      if (formattedResult) {\n        pluginFormatResult = formattedResult;\n      }\n    }\n  }\n\n  const isDictionaryFormat =\n    pluginFormatResult.content && pluginFormatResult.key;\n\n  if (!isDictionaryFormat) return pluginFormatResult;\n\n  // Build result from the original dictionary so that extra user-defined fields\n  // (e.g. custom frontmatter in markdown files) are preserved.\n  // Strip internal-only fields that must never appear in persisted output.\n  const INTERNAL_FIELDS = new Set([\n    '$schema',\n    'filePath',\n    'localId',\n    'localIds',\n    'projectIds',\n  ]);\n\n  const preservedFields = Object.fromEntries(\n    Object.entries(dictionary as Record<string, unknown>).filter(\n      ([k]) => !INTERNAL_FIELDS.has(k)\n    )\n  );\n\n  let result: Dictionary = {\n    ...preservedFields,\n    content,\n  } as Dictionary;\n\n  /**\n   * Add $schema to JSON dictionaries\n   */\n  const extension = (\n    dictionary.filePath ? extname(dictionary.filePath) : '.json'\n  ) as Extension;\n  const format = getFormatFromExtension(extension);\n\n  if (\n    format === 'json' &&\n    pluginFormatResult.content &&\n    pluginFormatResult.key\n  ) {\n    result = {\n      $schema: 'https://intlayer.org/schema.json',\n      ...result,\n    };\n  }\n\n  return result;\n};\n\ntype WriteContentDeclarationOptions = {\n  newDictionariesPath?: string;\n  localeList?: LocalesValues[];\n  fallbackLocale?: Locale;\n};\n\nconst defaultOptions = {\n  newDictionariesPath: 'intlayer-dictionaries',\n} satisfies WriteContentDeclarationOptions;\n\nexport const writeContentDeclaration = async (\n  dictionary: Dictionary,\n  configuration: IntlayerConfig,\n  options?: WriteContentDeclarationOptions\n): Promise<{ status: DictionaryStatus; path: string }> => {\n  const { system, compiler } = configuration;\n  const { baseDir } = system;\n\n  const noMetadata = compiler?.noMetadata ?? COMPILER_NO_METADATA;\n  const { newDictionariesPath, localeList } = {\n    ...defaultOptions,\n    ...options,\n  };\n\n  const newDictionaryLocationPath = join(baseDir, newDictionariesPath);\n\n  const unmergedDictionariesRecord = readDictionariesFromDisk<\n    Record<string, Dictionary[]>\n  >(configuration.system.unmergedDictionariesDir);\n  const unmergedDictionaries = unmergedDictionariesRecord[\n    dictionary.key\n  ] as Dictionary[];\n\n  const existingDictionary = unmergedDictionaries?.find(\n    (el) => el.localId === dictionary.localId\n  );\n\n  const formattedContentDeclaration = await formatContentDeclaration(\n    dictionary,\n    configuration,\n    localeList\n  );\n\n  if (existingDictionary?.filePath) {\n    // Compare existing dictionary content with new dictionary content\n    const isSameContent = isDeepStrictEqual(existingDictionary, dictionary);\n\n    const filePath = resolve(\n      configuration.system.baseDir,\n      existingDictionary.filePath\n    );\n\n    // Up to date, nothing to do\n    if (isSameContent) {\n      return {\n        status: 'up-to-date',\n        path: filePath,\n      };\n    }\n\n    await writeFileWithDirectories(\n      filePath,\n      formattedContentDeclaration,\n      configuration,\n      noMetadata\n    );\n\n    return { status: 'updated', path: filePath };\n  }\n\n  if (dictionary.filePath) {\n    const filePath = resolve(configuration.system.baseDir, dictionary.filePath);\n\n    await writeFileWithDirectories(\n      filePath,\n      formattedContentDeclaration,\n      configuration,\n      noMetadata\n    );\n\n    return { status: 'created', path: filePath };\n  }\n\n  // No existing dictionary, write to new location\n  const contentDeclarationPath = join(\n    newDictionaryLocationPath,\n    `${dictionary.key}.content.json`\n  );\n\n  await writeFileWithDirectories(\n    contentDeclarationPath,\n    formattedContentDeclaration,\n    configuration,\n    noMetadata\n  );\n\n  return {\n    status: 'imported',\n    path: contentDeclarationPath,\n  };\n};\n\nconst writeFileWithDirectories = async (\n  absoluteFilePath: string,\n  dictionary: Dictionary,\n  configuration: IntlayerConfig,\n  noMetadata?: boolean\n): Promise<void> => {\n  // Extract the directory from the file path\n  const dir = dirname(absoluteFilePath);\n\n  // Create the directory recursively\n  await mkdir(dir, { recursive: true });\n\n  const extension = extname(absoluteFilePath);\n\n  if (extension === '.md' || extension === '.mdx') {\n    await writeMarkdownFile(absoluteFilePath, dictionary, configuration);\n    return;\n  }\n\n  if (extension === '.yaml' || extension === '.yml') {\n    await writeYamlFile(absoluteFilePath, dictionary, configuration);\n    return;\n  }\n\n  // Handle JSON, JSONC, and JSON5 via the AST transformer\n  if (['.json', '.jsonc', '.json5'].includes(extension)) {\n    let fileContent = '{}';\n\n    if (existsSync(absoluteFilePath)) {\n      try {\n        fileContent = await readFile(absoluteFilePath, 'utf-8');\n      } catch {\n        // ignore read errors, start with empty object\n      }\n    }\n\n    const transformedContent = transformJSONFile(\n      fileContent,\n      dictionary,\n      noMetadata\n    );\n\n    // We use standard writeFile because transformedContent is already a string\n    const tempDir = configuration.system?.tempDir;\n    if (tempDir) {\n      await mkdir(tempDir, { recursive: true });\n    }\n\n    const tempFileName = `${basename(absoluteFilePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;\n    const tempPath = tempDir\n      ? join(tempDir, tempFileName)\n      : `${absoluteFilePath}.${tempFileName}`;\n    try {\n      await writeFile(tempPath, transformedContent, 'utf-8');\n      await rename(tempPath, absoluteFilePath);\n    } catch (error) {\n      try {\n        await rm(tempPath, { force: true });\n      } catch {\n        // Ignore\n      }\n      throw error;\n    }\n\n    const formatCommand = detectFormatCommand(configuration);\n\n    if (formatCommand) {\n      try {\n        execSync(formatCommand.replace('{{file}}', absoluteFilePath), {\n          stdio: 'inherit',\n          cwd: configuration.system.baseDir,\n        });\n      } catch (error) {\n        console.error(error);\n      }\n    }\n\n    return;\n  }\n\n  const knownJsExtensions = new Set([\n    '.ts',\n    '.tsx',\n    '.js',\n    '.jsx',\n    '.mjs',\n    '.cjs',\n  ]);\n\n  if (!knownJsExtensions.has(extension)) {\n    // Unknown extension (e.g. .po managed by a plugin) — skip; the plugin\n    // owns this file format and writeJSFile / prettier would corrupt it.\n    return;\n  }\n\n  await writeJSFile(absoluteFilePath, dictionary, configuration, noMetadata);\n\n  // remove the cache as content has changed\n  // Will force a new preparation of the intlayer on next build\n  try {\n    const sentinelPath = join(\n      configuration.system.cacheDir,\n      'intlayer-prepared.lock'\n    );\n    await rm(sentinelPath, { recursive: true });\n  } catch {}\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,MAAM,2BAA2B,OAC/B,YACA,eACA,eACG;;;;CAIH,MAAM,sBACJ,MAAM,iCAAiC,WAAW;CAEpD,IAAI,UAAU,oBAAoB;;;;AAMlC,KAAI,WAAW,OACb,WAAU,uBACR,qBACA,WAAW,OACZ,CAAC;UACO,WACT,WAAU,6BACR,qBACA,WACD,CAAC;CAGJ,IAAI,qBAA0B;EAC5B,GAAG;EACH;EACD;;;;AAMD,YAAW,MAAM,UAAU,cAAc,WAAW,EAAE,CACpD,KAAI,OAAO,cAAc;EACvB,MAAM,kBAAkB,MAAM,OAAO,eAAe;GAClD,YAAY;GACZ;GACD,CAAC;AAEF,MAAI,gBACF,sBAAqB;;AAQ3B,KAAI,EAFF,mBAAmB,WAAW,mBAAmB,KAE1B,QAAO;CAKhC,MAAM,kBAAkB,IAAI,IAAI;EAC9B;EACA;EACA;EACA;EACA;EACD,CAAC;CAQF,IAAI,SAAqB;EACvB,GAPsB,OAAO,YAC7B,OAAO,QAAQ,WAAsC,CAAC,QACnD,CAAC,OAAO,CAAC,gBAAgB,IAAI,EAAE,CACjC,CAIiB;EAClB;EACD;AAUD,KAFe,uBAFb,WAAW,WAAW,QAAQ,WAAW,SAAS,GAAG,QAK/C,KAAK,UACX,mBAAmB,WACnB,mBAAmB,IAEnB,UAAS;EACP,SAAS;EACT,GAAG;EACJ;AAGH,QAAO;;AAST,MAAM,iBAAiB,EACrB,qBAAqB,yBACtB;AAED,MAAa,0BAA0B,OACrC,YACA,eACA,YACwD;CACxD,MAAM,EAAE,QAAQ,aAAa;CAC7B,MAAM,EAAE,YAAY;CAEpB,MAAM,aAAa,UAAU,cAAc;CAC3C,MAAM,EAAE,qBAAqB,eAAe;EAC1C,GAAG;EACH,GAAG;EACJ;CAED,MAAM,4BAA4B,KAAK,SAAS,oBAAoB;CASpE,MAAM,qBAP6B,yBAEjC,cAAc,OAAO,wBACgC,CACrD,WAAW,MAGoC,MAC9C,OAAO,GAAG,YAAY,WAAW,QACnC;CAED,MAAM,8BAA8B,MAAM,yBACxC,YACA,eACA,WACD;AAED,KAAI,oBAAoB,UAAU;EAEhC,MAAM,gBAAgB,kBAAkB,oBAAoB,WAAW;EAEvE,MAAM,WAAW,QACf,cAAc,OAAO,SACrB,mBAAmB,SACpB;AAGD,MAAI,cACF,QAAO;GACL,QAAQ;GACR,MAAM;GACP;AAGH,QAAM,yBACJ,UACA,6BACA,eACA,WACD;AAED,SAAO;GAAE,QAAQ;GAAW,MAAM;GAAU;;AAG9C,KAAI,WAAW,UAAU;EACvB,MAAM,WAAW,QAAQ,cAAc,OAAO,SAAS,WAAW,SAAS;AAE3E,QAAM,yBACJ,UACA,6BACA,eACA,WACD;AAED,SAAO;GAAE,QAAQ;GAAW,MAAM;GAAU;;CAI9C,MAAM,yBAAyB,KAC7B,2BACA,GAAG,WAAW,IAAI,eACnB;AAED,OAAM,yBACJ,wBACA,6BACA,eACA,WACD;AAED,QAAO;EACL,QAAQ;EACR,MAAM;EACP;;AAGH,MAAM,2BAA2B,OAC/B,kBACA,YACA,eACA,eACkB;AAKlB,OAAM,MAHM,QAAQ,iBAGL,EAAE,EAAE,WAAW,MAAM,CAAC;CAErC,MAAM,YAAY,QAAQ,iBAAiB;AAE3C,KAAI,cAAc,SAAS,cAAc,QAAQ;AAC/C,QAAM,kBAAkB,kBAAkB,YAAY,cAAc;AACpE;;AAGF,KAAI,cAAc,WAAW,cAAc,QAAQ;AACjD,QAAM,cAAc,kBAAkB,YAAY,cAAc;AAChE;;AAIF,KAAI;EAAC;EAAS;EAAU;EAAS,CAAC,SAAS,UAAU,EAAE;EACrD,IAAI,cAAc;AAElB,MAAI,WAAW,iBAAiB,CAC9B,KAAI;AACF,iBAAc,MAAM,SAAS,kBAAkB,QAAQ;UACjD;EAKV,MAAM,qBAAqB,kBACzB,aACA,YACA,WACD;EAGD,MAAM,UAAU,cAAc,QAAQ;AACtC,MAAI,QACF,OAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;EAG3C,MAAM,eAAe,GAAG,SAAS,iBAAiB,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC;EACxG,MAAM,WAAW,UACb,KAAK,SAAS,aAAa,GAC3B,GAAG,iBAAiB,GAAG;AAC3B,MAAI;AACF,SAAM,UAAU,UAAU,oBAAoB,QAAQ;AACtD,SAAM,OAAO,UAAU,iBAAiB;WACjC,OAAO;AACd,OAAI;AACF,UAAM,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC;WAC7B;AAGR,SAAM;;EAGR,MAAM,gBAAgB,oBAAoB,cAAc;AAExD,MAAI,cACF,KAAI;AACF,YAAS,cAAc,QAAQ,YAAY,iBAAiB,EAAE;IAC5D,OAAO;IACP,KAAK,cAAc,OAAO;IAC3B,CAAC;WACK,OAAO;AACd,WAAQ,MAAM,MAAM;;AAIxB;;AAYF,KAAI,CAAC,IATyB,IAAI;EAChC;EACA;EACA;EACA;EACA;EACA;EACD,CAEqB,CAAC,IAAI,UAAU,CAGnC;AAGF,OAAM,YAAY,kBAAkB,YAAY,eAAe,WAAW;AAI1E,KAAI;AAKF,QAAM,GAJe,KACnB,cAAc,OAAO,UACrB,yBAEmB,EAAE,EAAE,WAAW,MAAM,CAAC;SACrC"}

package/dist/esm/writeContentDeclaration/writeJSFile.mjs

@@ -0,0 +1,91 @@
+import { getFormatFromExtension } from "../utils/getFormatFromExtension.mjs";
+import { transformJSFile } from "./transformJSFile.mjs";
+import { detectFormatCommand } from "../detectFormatCommand.mjs";
+import { getContentDeclarationFileTemplate } from "../getContentDeclarationFileTemplate/getContentDeclarationFileTemplate.mjs";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { basename, extname, join } from "node:path";
+import { getAppLogger, logger } from "@intlayer/config/logger";
+import { existsSync } from "node:fs";
+import { execSync } from "node:child_process";
+
+//#region src/writeContentDeclaration/writeJSFile.ts
+/**
+* Updates a JavaScript/TypeScript file based on the provided JSON instructions.
+* It targets a specific dictionary object within the file (identified by its 'key' property)
+* and updates its 'content' entries. Currently, it focuses on modifying arguments
+* of 't' (translation) function calls.
+*/
+const writeJSFile = async (filePath, dictionary, configuration, noMetadata) => {
+	const mergedDictionary = {
+		...configuration.dictionary,
+		...dictionary
+	};
+	const appLogger = getAppLogger(configuration);
+	if (!existsSync(filePath)) {
+		const format = getFormatFromExtension(extname(filePath));
+		appLogger("File does not exist, creating it", { isVerbose: true });
+		const template = await getContentDeclarationFileTemplate(mergedDictionary.key, format, Object.fromEntries(Object.entries({
+			id: noMetadata ? void 0 : mergedDictionary.id,
+			locale: noMetadata ? void 0 : mergedDictionary.locale,
+			filled: noMetadata ? void 0 : mergedDictionary.filled,
+			fill: noMetadata ? void 0 : mergedDictionary.fill,
+			description: noMetadata ? void 0 : mergedDictionary.description,
+			title: noMetadata ? void 0 : mergedDictionary.title,
+			tags: noMetadata ? void 0 : mergedDictionary.tags,
+			version: noMetadata ? void 0 : mergedDictionary.version,
+			priority: noMetadata ? void 0 : mergedDictionary.priority,
+			importMode: noMetadata ? void 0 : mergedDictionary.importMode
+		}).filter(([, value]) => value !== void 0)), noMetadata);
+		const tempDir = configuration.system?.tempDir;
+		if (tempDir) await mkdir(tempDir, { recursive: true });
+		const tempFileName = `${basename(filePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;
+		const tempPath = tempDir ? join(tempDir, tempFileName) : `${filePath}.${tempFileName}`;
+		try {
+			await writeFile(tempPath, template, "utf-8");
+			await rename(tempPath, filePath);
+		} catch (error) {
+			try {
+				await rm(tempPath, { force: true });
+			} catch {}
+			throw error;
+		}
+	}
+	let fileContent = await readFile(filePath, "utf-8");
+	if (fileContent === "") {
+		const format = getFormatFromExtension(extname(filePath));
+		fileContent = await getContentDeclarationFileTemplate(mergedDictionary.key, format, {}, noMetadata);
+	}
+	const finalCode = await transformJSFile(fileContent, dictionary, dictionary.locale, noMetadata);
+	const tempDir = configuration.system?.tempDir;
+	if (tempDir) await mkdir(tempDir, { recursive: true });
+	const tempFileName = `${basename(filePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;
+	const tempPath = tempDir ? join(tempDir, tempFileName) : `${filePath}.${tempFileName}`;
+	try {
+		await writeFile(tempPath, finalCode, "utf-8");
+		await rename(tempPath, filePath);
+		logger(`Successfully updated ${filePath}`, {
+			level: "info",
+			isVerbose: true
+		});
+	} catch (error) {
+		try {
+			await rm(tempPath, { force: true });
+		} catch {}
+		const err = error;
+		logger(`Failed to write updated file: ${filePath}`, { level: "error" });
+		throw new Error(`Failed to write updated file ${filePath}: ${err.message}`);
+	}
+	const formatCommand = detectFormatCommand(configuration);
+	if (formatCommand) try {
+		execSync(formatCommand.replace("{{file}}", filePath), {
+			stdio: "inherit",
+			cwd: configuration.system.baseDir
+		});
+	} catch (error) {
+		console.error(error);
+	}
+};
+
+//#endregion
+export { writeJSFile };
+//# sourceMappingURL=writeJSFile.mjs.map

package/dist/esm/writeContentDeclaration/writeJSFile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeJSFile.mjs","names":[],"sources":["../../../src/writeContentDeclaration/writeJSFile.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';\nimport { basename, extname, join } from 'node:path';\nimport { getAppLogger, logger } from '@intlayer/config/logger';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { detectFormatCommand } from '../detectFormatCommand';\nimport { getContentDeclarationFileTemplate } from '../getContentDeclarationFileTemplate/getContentDeclarationFileTemplate';\nimport {\n  type Extension,\n  getFormatFromExtension,\n} from '../utils/getFormatFromExtension';\nimport { transformJSFile } from './transformJSFile';\n\n/**\n * Updates a JavaScript/TypeScript file based on the provided JSON instructions.\n * It targets a specific dictionary object within the file (identified by its 'key' property)\n * and updates its 'content' entries. Currently, it focuses on modifying arguments\n * of 't' (translation) function calls.\n */\nexport const writeJSFile = async (\n  filePath: string,\n  dictionary: Dictionary,\n  configuration: IntlayerConfig,\n  noMetadata?: boolean\n): Promise<void> => {\n  const mergedDictionary = {\n    ...configuration.dictionary,\n    ...dictionary,\n  };\n\n  const appLogger = getAppLogger(configuration);\n\n  // Check if the file exist\n  if (!existsSync(filePath)) {\n    const fileExtension = extname(filePath) as Extension;\n\n    const format = getFormatFromExtension(fileExtension);\n\n    appLogger('File does not exist, creating it', {\n      isVerbose: true,\n    });\n    const template = await getContentDeclarationFileTemplate(\n      mergedDictionary.key,\n      format,\n      // Filter out undefined values\n      Object.fromEntries(\n        Object.entries({\n          id: noMetadata ? undefined : mergedDictionary.id,\n          locale: noMetadata ? undefined : mergedDictionary.locale,\n          filled: noMetadata ? undefined : mergedDictionary.filled,\n          fill: noMetadata ? undefined : mergedDictionary.fill,\n          description: noMetadata ? undefined : mergedDictionary.description,\n          title: noMetadata ? undefined : mergedDictionary.title,\n          tags: noMetadata ? undefined : mergedDictionary.tags,\n          version: noMetadata ? undefined : mergedDictionary.version,\n          priority: noMetadata ? undefined : mergedDictionary.priority,\n          importMode: noMetadata ? undefined : mergedDictionary.importMode,\n        }).filter(([, value]) => value !== undefined)\n      ),\n      noMetadata\n    );\n\n    const tempDir = configuration.system?.tempDir;\n    if (tempDir) {\n      await mkdir(tempDir, { recursive: true });\n    }\n\n    const tempFileName = `${basename(filePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;\n    const tempPath = tempDir\n      ? join(tempDir, tempFileName)\n      : `${filePath}.${tempFileName}`;\n    try {\n      await writeFile(tempPath, template, 'utf-8');\n      await rename(tempPath, filePath);\n    } catch (error) {\n      try {\n        await rm(tempPath, { force: true });\n      } catch {\n        // Ignore\n      }\n      throw error;\n    }\n  }\n\n  let fileContent = await readFile(filePath, 'utf-8');\n\n  if (fileContent === '') {\n    const format = getFormatFromExtension(extname(filePath) as Extension);\n\n    fileContent = await getContentDeclarationFileTemplate(\n      mergedDictionary.key,\n      format,\n      {},\n      noMetadata\n    );\n  }\n\n  const finalCode = await transformJSFile(\n    fileContent,\n    dictionary,\n    dictionary.locale as any,\n    noMetadata\n  );\n\n  // Write the modified code back to the file\n  const tempDir = configuration.system?.tempDir;\n  if (tempDir) {\n    await mkdir(tempDir, { recursive: true });\n  }\n\n  const tempFileName = `${basename(filePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;\n  const tempPath = tempDir\n    ? join(tempDir, tempFileName)\n    : `${filePath}.${tempFileName}`;\n  try {\n    await writeFile(tempPath, finalCode, 'utf-8');\n    await rename(tempPath, filePath);\n    logger(`Successfully updated ${filePath}`, {\n      level: 'info',\n      isVerbose: true,\n    });\n  } catch (error) {\n    try {\n      await rm(tempPath, { force: true });\n    } catch {\n      // Ignore\n    }\n    const err = error as Error;\n    logger(`Failed to write updated file: ${filePath}`, {\n      level: 'error',\n    });\n    throw new Error(`Failed to write updated file ${filePath}: ${err.message}`);\n  }\n\n  const formatCommand = detectFormatCommand(configuration);\n\n  if (formatCommand) {\n    try {\n      execSync(formatCommand.replace('{{file}}', filePath), {\n        stdio: 'inherit',\n        cwd: configuration.system.baseDir,\n      });\n    } catch (error) {\n      console.error(error);\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAqBA,MAAa,cAAc,OACzB,UACA,YACA,eACA,eACkB;CAClB,MAAM,mBAAmB;EACvB,GAAG,cAAc;EACjB,GAAG;EACJ;CAED,MAAM,YAAY,aAAa,cAAc;AAG7C,KAAI,CAAC,WAAW,SAAS,EAAE;EAGzB,MAAM,SAAS,uBAFO,QAAQ,SAEqB,CAAC;AAEpD,YAAU,oCAAoC,EAC5C,WAAW,MACZ,CAAC;EACF,MAAM,WAAW,MAAM,kCACrB,iBAAiB,KACjB,QAEA,OAAO,YACL,OAAO,QAAQ;GACb,IAAI,aAAa,SAAY,iBAAiB;GAC9C,QAAQ,aAAa,SAAY,iBAAiB;GAClD,QAAQ,aAAa,SAAY,iBAAiB;GAClD,MAAM,aAAa,SAAY,iBAAiB;GAChD,aAAa,aAAa,SAAY,iBAAiB;GACvD,OAAO,aAAa,SAAY,iBAAiB;GACjD,MAAM,aAAa,SAAY,iBAAiB;GAChD,SAAS,aAAa,SAAY,iBAAiB;GACnD,UAAU,aAAa,SAAY,iBAAiB;GACpD,YAAY,aAAa,SAAY,iBAAiB;GACvD,CAAC,CAAC,QAAQ,GAAG,WAAW,UAAU,OAAU,CAC9C,EACD,WACD;EAED,MAAM,UAAU,cAAc,QAAQ;AACtC,MAAI,QACF,OAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;EAG3C,MAAM,eAAe,GAAG,SAAS,SAAS,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC;EAChG,MAAM,WAAW,UACb,KAAK,SAAS,aAAa,GAC3B,GAAG,SAAS,GAAG;AACnB,MAAI;AACF,SAAM,UAAU,UAAU,UAAU,QAAQ;AAC5C,SAAM,OAAO,UAAU,SAAS;WACzB,OAAO;AACd,OAAI;AACF,UAAM,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC;WAC7B;AAGR,SAAM;;;CAIV,IAAI,cAAc,MAAM,SAAS,UAAU,QAAQ;AAEnD,KAAI,gBAAgB,IAAI;EACtB,MAAM,SAAS,uBAAuB,QAAQ,SAAS,CAAc;AAErE,gBAAc,MAAM,kCAClB,iBAAiB,KACjB,QACA,EAAE,EACF,WACD;;CAGH,MAAM,YAAY,MAAM,gBACtB,aACA,YACA,WAAW,QACX,WACD;CAGD,MAAM,UAAU,cAAc,QAAQ;AACtC,KAAI,QACF,OAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;CAG3C,MAAM,eAAe,GAAG,SAAS,SAAS,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC;CAChG,MAAM,WAAW,UACb,KAAK,SAAS,aAAa,GAC3B,GAAG,SAAS,GAAG;AACnB,KAAI;AACF,QAAM,UAAU,UAAU,WAAW,QAAQ;AAC7C,QAAM,OAAO,UAAU,SAAS;AAChC,SAAO,wBAAwB,YAAY;GACzC,OAAO;GACP,WAAW;GACZ,CAAC;UACK,OAAO;AACd,MAAI;AACF,SAAM,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC;UAC7B;EAGR,MAAM,MAAM;AACZ,SAAO,iCAAiC,YAAY,EAClD,OAAO,SACR,CAAC;AACF,QAAM,IAAI,MAAM,gCAAgC,SAAS,IAAI,IAAI,UAAU;;CAG7E,MAAM,gBAAgB,oBAAoB,cAAc;AAExD,KAAI,cACF,KAAI;AACF,WAAS,cAAc,QAAQ,YAAY,SAAS,EAAE;GACpD,OAAO;GACP,KAAK,cAAc,OAAO;GAC3B,CAAC;UACK,OAAO;AACd,UAAQ,MAAM,MAAM"}

package/dist/esm/writeContentDeclaration/writeMarkdownFile.mjs

@@ -0,0 +1,64 @@
+import { detectFormatCommand } from "../detectFormatCommand.mjs";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { MARKDOWN } from "@intlayer/types/nodeType";
+import { execSync } from "node:child_process";
+
+//#region src/writeContentDeclaration/writeMarkdownFile.ts
+const stringifyYamlFrontmatter = (fields) => Object.entries(fields).filter(([, value]) => value !== void 0 && value !== null).map(([key, value]) => {
+	if (Array.isArray(value)) return `${key}:\n${value.map((item) => `  - ${JSON.stringify(item)}`).join("\n")}`;
+	if (typeof value === "string" && (value.includes(":") || value.includes("\n") || value.includes("#"))) return `${key}: ${JSON.stringify(value)}`;
+	return `${key}: ${value}`;
+}).join("\n");
+const getMarkdownBody = (content) => {
+	const lines = content.split(/\r?\n/);
+	const firstNonEmptyIndex = lines.findIndex((line) => line.trim() !== "");
+	if (firstNonEmptyIndex === -1 || lines[firstNonEmptyIndex].trim() !== "---") return content;
+	let endIndex = -1;
+	for (let i = firstNonEmptyIndex + 1; i < lines.length; i++) if (lines[i].trim() === "---") {
+		endIndex = i;
+		break;
+	}
+	if (endIndex === -1) return content;
+	return lines.slice(endIndex + 1).join("\n").trimStart();
+};
+const EXCLUDED_FRONTMATTER_KEYS = new Set([
+	"content",
+	"$schema",
+	"filePath",
+	"localId",
+	"localIds",
+	"projectIds"
+]);
+const writeMarkdownFile = async (absoluteFilePath, dictionary, configuration) => {
+	const content = dictionary.content;
+	const markdownBody = getMarkdownBody(typeof content === "object" && content?.nodeType === MARKDOWN ? content[MARKDOWN] ?? "" : "");
+	const fileContent = `---\n${stringifyYamlFrontmatter(Object.fromEntries(Object.entries(dictionary).filter(([k, v]) => !EXCLUDED_FRONTMATTER_KEYS.has(k) && v !== void 0)))}\n---\n\n${markdownBody}`;
+	await mkdir(dirname(absoluteFilePath), { recursive: true });
+	const tempDir = configuration.system?.tempDir;
+	if (tempDir) await mkdir(tempDir, { recursive: true });
+	const tempFileName = `${basename(absoluteFilePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;
+	const tempPath = tempDir ? join(tempDir, tempFileName) : `${absoluteFilePath}.${tempFileName}`;
+	try {
+		await writeFile(tempPath, fileContent, "utf-8");
+		await rename(tempPath, absoluteFilePath);
+	} catch (error) {
+		try {
+			await rm(tempPath, { force: true });
+		} catch {}
+		throw error;
+	}
+	const formatCommand = detectFormatCommand(configuration);
+	if (formatCommand) try {
+		execSync(formatCommand.replace("{{file}}", absoluteFilePath), {
+			stdio: "inherit",
+			cwd: configuration.system.baseDir
+		});
+	} catch (error) {
+		console.error(error);
+	}
+};
+
+//#endregion
+export { writeMarkdownFile };
+//# sourceMappingURL=writeMarkdownFile.mjs.map

package/dist/esm/writeContentDeclaration/writeMarkdownFile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeMarkdownFile.mjs","names":[],"sources":["../../../src/writeContentDeclaration/writeMarkdownFile.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { mkdir, rename, rm, writeFile } from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { MARKDOWN } from '@intlayer/types/nodeType';\nimport { detectFormatCommand } from '../detectFormatCommand';\n\nconst stringifyYamlFrontmatter = (fields: Record<string, any>): string =>\n  Object.entries(fields)\n    .filter(([, value]) => value !== undefined && value !== null)\n    .map(([key, value]) => {\n      if (Array.isArray(value)) {\n        return `${key}:\\n${value.map((item) => `  - ${JSON.stringify(item)}`).join('\\n')}`;\n      }\n      if (\n        typeof value === 'string' &&\n        (value.includes(':') || value.includes('\\n') || value.includes('#'))\n      ) {\n        return `${key}: ${JSON.stringify(value)}`;\n      }\n      return `${key}: ${value}`;\n    })\n    .join('\\n');\n\n// Strips YAML frontmatter from a markdown string, returning only the body\nconst getMarkdownBody = (content: string): string => {\n  const lines = content.split(/\\r?\\n/);\n  const firstNonEmptyIndex = lines.findIndex((line) => line.trim() !== '');\n\n  if (firstNonEmptyIndex === -1 || lines[firstNonEmptyIndex].trim() !== '---') {\n    return content;\n  }\n\n  let endIndex = -1;\n  for (let i = firstNonEmptyIndex + 1; i < lines.length; i++) {\n    if (lines[i].trim() === '---') {\n      endIndex = i;\n      break;\n    }\n  }\n\n  if (endIndex === -1) return content;\n\n  return lines\n    .slice(endIndex + 1)\n    .join('\\n')\n    .trimStart();\n};\n\n// Fields that are auto-generated / internal and must not appear in frontmatter\nconst EXCLUDED_FRONTMATTER_KEYS = new Set<string>([\n  'content',\n  '$schema',\n  'filePath',\n  'localId',\n  'localIds',\n  'projectIds',\n]);\n\nexport const writeMarkdownFile = async (\n  absoluteFilePath: string,\n  dictionary: Dictionary,\n  configuration: IntlayerConfig\n): Promise<void> => {\n  const content = dictionary.content as any;\n  const markdownRaw =\n    typeof content === 'object' && content?.nodeType === MARKDOWN\n      ? (content[MARKDOWN] ?? '')\n      : '';\n  // content.markdown now stores the full file (frontmatter + body); extract only the body\n  const markdownBody = getMarkdownBody(markdownRaw);\n\n  const frontmatterFields = Object.fromEntries(\n    Object.entries(dictionary).filter(\n      ([k, v]) => !EXCLUDED_FRONTMATTER_KEYS.has(k) && v !== undefined\n    )\n  );\n\n  const frontmatterStr = stringifyYamlFrontmatter(frontmatterFields);\n  const fileContent = `---\\n${frontmatterStr}\\n---\\n\\n${markdownBody}`;\n\n  const dir = dirname(absoluteFilePath);\n  await mkdir(dir, { recursive: true });\n\n  const tempDir = configuration.system?.tempDir;\n  if (tempDir) await mkdir(tempDir, { recursive: true });\n\n  const tempFileName = `${basename(absoluteFilePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;\n  const tempPath = tempDir\n    ? join(tempDir, tempFileName)\n    : `${absoluteFilePath}.${tempFileName}`;\n\n  try {\n    await writeFile(tempPath, fileContent, 'utf-8');\n    await rename(tempPath, absoluteFilePath);\n  } catch (error) {\n    try {\n      await rm(tempPath, { force: true });\n    } catch {\n      // ignore\n    }\n    throw error;\n  }\n\n  const formatCommand = detectFormatCommand(configuration);\n  if (formatCommand) {\n    try {\n      execSync(formatCommand.replace('{{file}}', absoluteFilePath), {\n        stdio: 'inherit',\n        cwd: configuration.system.baseDir,\n      });\n    } catch (error) {\n      console.error(error);\n    }\n  }\n};\n"],"mappings":";;;;;;;AAQA,MAAM,4BAA4B,WAChC,OAAO,QAAQ,OAAO,CACnB,QAAQ,GAAG,WAAW,UAAU,UAAa,UAAU,KAAK,CAC5D,KAAK,CAAC,KAAK,WAAW;AACrB,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,GAAG,IAAI,KAAK,MAAM,KAAK,SAAS,OAAO,KAAK,UAAU,KAAK,GAAG,CAAC,KAAK,KAAK;AAElF,KACE,OAAO,UAAU,aAChB,MAAM,SAAS,IAAI,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,IAAI,EAEnE,QAAO,GAAG,IAAI,IAAI,KAAK,UAAU,MAAM;AAEzC,QAAO,GAAG,IAAI,IAAI;EAClB,CACD,KAAK,KAAK;AAGf,MAAM,mBAAmB,YAA4B;CACnD,MAAM,QAAQ,QAAQ,MAAM,QAAQ;CACpC,MAAM,qBAAqB,MAAM,WAAW,SAAS,KAAK,MAAM,KAAK,GAAG;AAExE,KAAI,uBAAuB,MAAM,MAAM,oBAAoB,MAAM,KAAK,MACpE,QAAO;CAGT,IAAI,WAAW;AACf,MAAK,IAAI,IAAI,qBAAqB,GAAG,IAAI,MAAM,QAAQ,IACrD,KAAI,MAAM,GAAG,MAAM,KAAK,OAAO;AAC7B,aAAW;AACX;;AAIJ,KAAI,aAAa,GAAI,QAAO;AAE5B,QAAO,MACJ,MAAM,WAAW,EAAE,CACnB,KAAK,KAAK,CACV,WAAW;;AAIhB,MAAM,4BAA4B,IAAI,IAAY;CAChD;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,MAAa,oBAAoB,OAC/B,kBACA,YACA,kBACkB;CAClB,MAAM,UAAU,WAAW;CAM3B,MAAM,eAAe,gBAJnB,OAAO,YAAY,YAAY,SAAS,aAAa,WAChD,QAAQ,aAAa,KACtB,GAE2C;CASjD,MAAM,cAAc,QADG,yBANG,OAAO,YAC/B,OAAO,QAAQ,WAAW,CAAC,QACxB,CAAC,GAAG,OAAO,CAAC,0BAA0B,IAAI,EAAE,IAAI,MAAM,OACxD,CAG8D,CACvB,CAAC,WAAW;AAGtD,OAAM,MADM,QAAQ,iBACL,EAAE,EAAE,WAAW,MAAM,CAAC;CAErC,MAAM,UAAU,cAAc,QAAQ;AACtC,KAAI,QAAS,OAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;CAEtD,MAAM,eAAe,GAAG,SAAS,iBAAiB,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC;CACxG,MAAM,WAAW,UACb,KAAK,SAAS,aAAa,GAC3B,GAAG,iBAAiB,GAAG;AAE3B,KAAI;AACF,QAAM,UAAU,UAAU,aAAa,QAAQ;AAC/C,QAAM,OAAO,UAAU,iBAAiB;UACjC,OAAO;AACd,MAAI;AACF,SAAM,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC;UAC7B;AAGR,QAAM;;CAGR,MAAM,gBAAgB,oBAAoB,cAAc;AACxD,KAAI,cACF,KAAI;AACF,WAAS,cAAc,QAAQ,YAAY,iBAAiB,EAAE;GAC5D,OAAO;GACP,KAAK,cAAc,OAAO;GAC3B,CAAC;UACK,OAAO;AACd,UAAQ,MAAM,MAAM"}

package/dist/esm/writeContentDeclaration/writeYamlFile.mjs

@@ -0,0 +1,42 @@
+import { detectFormatCommand } from "../detectFormatCommand.mjs";
+import { mkdir, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+import { execSync } from "node:child_process";
+import { stringifyYaml } from "@intlayer/core/utils";
+
+//#region src/writeContentDeclaration/writeYamlFile.ts
+const EXCLUDED_YAML_KEYS = new Set([
+	"$schema",
+	"id",
+	"filePath"
+]);
+const writeYamlFile = async (absoluteFilePath, dictionary, configuration) => {
+	const fileContent = stringifyYaml(Object.fromEntries(Object.entries(dictionary).filter(([k, v]) => !EXCLUDED_YAML_KEYS.has(k) && v !== void 0)));
+	await mkdir(dirname(absoluteFilePath), { recursive: true });
+	const tempDir = configuration.system?.tempDir;
+	if (tempDir) await mkdir(tempDir, { recursive: true });
+	const tempFileName = `${basename(absoluteFilePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;
+	const tempPath = tempDir ? join(tempDir, tempFileName) : `${absoluteFilePath}.${tempFileName}`;
+	try {
+		await writeFile(tempPath, fileContent, "utf-8");
+		await rename(tempPath, absoluteFilePath);
+	} catch (error) {
+		try {
+			await rm(tempPath, { force: true });
+		} catch {}
+		throw error;
+	}
+	const formatCommand = detectFormatCommand(configuration);
+	if (formatCommand) try {
+		execSync(formatCommand.replace("{{file}}", absoluteFilePath), {
+			stdio: "inherit",
+			cwd: configuration.system.baseDir
+		});
+	} catch (error) {
+		console.error(error);
+	}
+};
+
+//#endregion
+export { writeYamlFile };
+//# sourceMappingURL=writeYamlFile.mjs.map

package/dist/esm/writeContentDeclaration/writeYamlFile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeYamlFile.mjs","names":[],"sources":["../../../src/writeContentDeclaration/writeYamlFile.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { mkdir, rename, rm, writeFile } from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { stringifyYaml } from '@intlayer/core/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { detectFormatCommand } from '../detectFormatCommand';\n\n// Fields that are auto-generated or runtime-only, not persisted in the file\nconst EXCLUDED_YAML_KEYS = new Set<string>(['$schema', 'id', 'filePath']);\n\nexport const writeYamlFile = async (\n  absoluteFilePath: string,\n  dictionary: Dictionary,\n  configuration: IntlayerConfig\n): Promise<void> => {\n  const filtered = Object.fromEntries(\n    Object.entries(dictionary).filter(\n      ([k, v]) => !EXCLUDED_YAML_KEYS.has(k) && v !== undefined\n    )\n  );\n\n  const fileContent = stringifyYaml(filtered);\n\n  const dir = dirname(absoluteFilePath);\n  await mkdir(dir, { recursive: true });\n\n  const tempDir = configuration.system?.tempDir;\n  if (tempDir) await mkdir(tempDir, { recursive: true });\n\n  const tempFileName = `${basename(absoluteFilePath)}.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`;\n  const tempPath = tempDir\n    ? join(tempDir, tempFileName)\n    : `${absoluteFilePath}.${tempFileName}`;\n\n  try {\n    await writeFile(tempPath, fileContent, 'utf-8');\n    await rename(tempPath, absoluteFilePath);\n  } catch (error) {\n    try {\n      await rm(tempPath, { force: true });\n    } catch {\n      // ignore\n    }\n    throw error;\n  }\n\n  const formatCommand = detectFormatCommand(configuration);\n  if (formatCommand) {\n    try {\n      execSync(formatCommand.replace('{{file}}', absoluteFilePath), {\n        stdio: 'inherit',\n        cwd: configuration.system.baseDir,\n      });\n    } catch (error) {\n      console.error(error);\n    }\n  }\n};\n"],"mappings":";;;;;;;AASA,MAAM,qBAAqB,IAAI,IAAY;CAAC;CAAW;CAAM;CAAW,CAAC;AAEzE,MAAa,gBAAgB,OAC3B,kBACA,YACA,kBACkB;CAOlB,MAAM,cAAc,cANH,OAAO,YACtB,OAAO,QAAQ,WAAW,CAAC,QACxB,CAAC,GAAG,OAAO,CAAC,mBAAmB,IAAI,EAAE,IAAI,MAAM,OACjD,CAGuC,CAAC;AAG3C,OAAM,MADM,QAAQ,iBACL,EAAE,EAAE,WAAW,MAAM,CAAC;CAErC,MAAM,UAAU,cAAc,QAAQ;AACtC,KAAI,QAAS,OAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;CAEtD,MAAM,eAAe,GAAG,SAAS,iBAAiB,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,CAAC;CACxG,MAAM,WAAW,UACb,KAAK,SAAS,aAAa,GAC3B,GAAG,iBAAiB,GAAG;AAE3B,KAAI;AACF,QAAM,UAAU,UAAU,aAAa,QAAQ;AAC/C,QAAM,OAAO,UAAU,iBAAiB;UACjC,OAAO;AACd,MAAI;AACF,SAAM,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC;UAC7B;AAGR,QAAM;;CAGR,MAAM,gBAAgB,oBAAoB,cAAc;AACxD,KAAI,cACF,KAAI;AACF,WAAS,cAAc,QAAQ,YAAY,iBAAiB,EAAE;GAC5D,OAAO;GACP,KAAK,cAAc,OAAO;GAC3B,CAAC;UACK,OAAO;AACd,UAAQ,MAAM,MAAM"}

package/dist/esm/writeFileIfChanged.mjs

@@ -0,0 +1,49 @@
+import { chmod, mkdir, rename, rm, stat, writeFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { createHash, randomBytes } from "node:crypto";
+import { createReadStream, rmSync } from "node:fs";
+
+//#region src/writeFileIfChanged.ts
+const activeTempFiles = /* @__PURE__ */ new Set();
+process.on("exit", () => {
+	for (const file of activeTempFiles) try {
+		rmSync(file, { force: true });
+	} catch {}
+});
+const getFileHash = (path) => {
+	return new Promise((resolve) => {
+		const hash = createHash("sha256");
+		const stream = createReadStream(path);
+		stream.on("data", (chunk) => hash.update(chunk));
+		stream.on("end", () => resolve(hash.digest("hex")));
+		stream.on("error", () => resolve(null));
+	});
+};
+const writeFileIfChanged = async (path, data, { encoding = "utf8", tempDir } = {}) => {
+	if (createHash("sha256").update(data, encoding).digest("hex") === await getFileHash(path)) return false;
+	if (tempDir) await mkdir(tempDir, { recursive: true });
+	const tempFileName = `${basename(path)}.${Date.now()}-${randomBytes(4).toString("hex")}.tmp`;
+	const tempPath = tempDir ? join(tempDir, tempFileName) : `${path}.${tempFileName}`;
+	activeTempFiles.add(tempPath);
+	try {
+		let mode;
+		try {
+			mode = (await stat(path)).mode;
+		} catch {}
+		await writeFile(tempPath, data, { encoding });
+		if (mode !== void 0) await chmod(tempPath, mode);
+		await rename(tempPath, path);
+	} catch (error) {
+		try {
+			await rm(tempPath, { force: true });
+		} catch {}
+		throw error;
+	} finally {
+		activeTempFiles.delete(tempPath);
+	}
+	return true;
+};
+
+//#endregion
+export { writeFileIfChanged };
+//# sourceMappingURL=writeFileIfChanged.mjs.map

package/dist/esm/writeFileIfChanged.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFileIfChanged.mjs","names":[],"sources":["../../src/writeFileIfChanged.ts"],"sourcesContent":["import { createHash, randomBytes } from 'node:crypto';\nimport { createReadStream, rmSync } from 'node:fs';\nimport { chmod, mkdir, rename, rm, stat, writeFile } from 'node:fs/promises';\nimport { basename, join } from 'node:path';\n\nconst activeTempFiles = new Set<string>();\n\n// Synchronous cleanup on process exit\nprocess.on('exit', () => {\n  for (const file of activeTempFiles) {\n    try {\n      rmSync(file, { force: true });\n    } catch {}\n  }\n});\n\n// Helper to hash existing file via stream\nconst getFileHash = (path: string): Promise<string | null> => {\n  return new Promise((resolve) => {\n    const hash = createHash('sha256');\n    const stream = createReadStream(path);\n    stream.on('data', (chunk) => hash.update(chunk));\n    stream.on('end', () => resolve(hash.digest('hex')));\n    stream.on('error', () => resolve(null));\n  });\n};\n\nexport const writeFileIfChanged = async (\n  path: string,\n  data: string,\n  {\n    encoding = 'utf8',\n    tempDir,\n  }: { encoding?: BufferEncoding; tempDir?: string } = {}\n): Promise<boolean> => {\n  const newDataHash = createHash('sha256').update(data, encoding).digest('hex');\n  const existingHash = await getFileHash(path);\n\n  if (newDataHash === existingHash) {\n    return false;\n  }\n\n  if (tempDir) {\n    await mkdir(tempDir, { recursive: true });\n  }\n\n  const tempFileName = `${basename(path)}.${Date.now()}-${randomBytes(4).toString('hex')}.tmp`;\n  const tempPath = tempDir\n    ? join(tempDir, tempFileName)\n    : `${path}.${tempFileName}`;\n  activeTempFiles.add(tempPath);\n\n  try {\n    let mode: number | undefined;\n    try {\n      mode = (await stat(path)).mode;\n    } catch {}\n\n    await writeFile(tempPath, data, { encoding });\n\n    if (mode !== undefined) {\n      await chmod(tempPath, mode);\n    }\n\n    await rename(tempPath, path);\n  } catch (error) {\n    try {\n      await rm(tempPath, { force: true });\n    } catch {}\n    throw error;\n  } finally {\n    activeTempFiles.delete(tempPath);\n  }\n\n  return true;\n};\n"],"mappings":";;;;;;AAKA,MAAM,kCAAkB,IAAI,KAAa;AAGzC,QAAQ,GAAG,cAAc;AACvB,MAAK,MAAM,QAAQ,gBACjB,KAAI;AACF,SAAO,MAAM,EAAE,OAAO,MAAM,CAAC;SACvB;EAEV;AAGF,MAAM,eAAe,SAAyC;AAC5D,QAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,OAAO,WAAW,SAAS;EACjC,MAAM,SAAS,iBAAiB,KAAK;AACrC,SAAO,GAAG,SAAS,UAAU,KAAK,OAAO,MAAM,CAAC;AAChD,SAAO,GAAG,aAAa,QAAQ,KAAK,OAAO,MAAM,CAAC,CAAC;AACnD,SAAO,GAAG,eAAe,QAAQ,KAAK,CAAC;GACvC;;AAGJ,MAAa,qBAAqB,OAChC,MACA,MACA,EACE,WAAW,QACX,YACmD,EAAE,KAClC;AAIrB,KAHoB,WAAW,SAAS,CAAC,OAAO,MAAM,SAAS,CAAC,OAAO,MAGxD,KAAK,MAFO,YAAY,KAAK,CAG1C,QAAO;AAGT,KAAI,QACF,OAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;CAG3C,MAAM,eAAe,GAAG,SAAS,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,YAAY,EAAE,CAAC,SAAS,MAAM,CAAC;CACvF,MAAM,WAAW,UACb,KAAK,SAAS,aAAa,GAC3B,GAAG,KAAK,GAAG;AACf,iBAAgB,IAAI,SAAS;AAE7B,KAAI;EACF,IAAI;AACJ,MAAI;AACF,WAAQ,MAAM,KAAK,KAAK,EAAE;UACpB;AAER,QAAM,UAAU,UAAU,MAAM,EAAE,UAAU,CAAC;AAE7C,MAAI,SAAS,OACX,OAAM,MAAM,UAAU,KAAK;AAG7B,QAAM,OAAO,UAAU,KAAK;UACrB,OAAO;AACd,MAAI;AACF,SAAM,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC;UAC7B;AACR,QAAM;WACE;AACR,kBAAgB,OAAO,SAAS;;AAGlC,QAAO"}

package/dist/esm/writeJsonIfChanged.mjs

@@ -0,0 +1,17 @@
+import { writeFileIfChanged } from "./writeFileIfChanged.mjs";
+
+//#region src/writeJsonIfChanged.ts
+const writeJsonIfChanged = async (path, data, { pretty = true } = {}) => {
+	const space = pretty ? 2 : void 0;
+	let json = "{}";
+	try {
+		json = JSON.stringify(data, null, space);
+	} catch (error) {
+		console.error(`Error while parsing data to JSON for ${path}:`, error);
+	}
+	return await writeFileIfChanged(path, json);
+};
+
+//#endregion
+export { writeJsonIfChanged };
+//# sourceMappingURL=writeJsonIfChanged.mjs.map

package/dist/esm/writeJsonIfChanged.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeJsonIfChanged.mjs","names":[],"sources":["../../src/writeJsonIfChanged.ts"],"sourcesContent":["import { writeFileIfChanged } from './writeFileIfChanged';\n\nexport const writeJsonIfChanged = async <T>(\n  path: string,\n  data: T,\n  { pretty = process.env.NODE_ENV === 'development' } = {}\n): Promise<boolean> => {\n  const space = pretty ? 2 : undefined;\n\n  let json = '{}';\n\n  try {\n    json = JSON.stringify(data, null, space);\n  } catch (error) {\n    console.error(`Error while parsing data to JSON for ${path}:`, error);\n  }\n\n  return await writeFileIfChanged(path, json);\n};\n"],"mappings":";;;AAEA,MAAa,qBAAqB,OAChC,MACA,MACA,EAAE,SAAS,SAA2C,EAAE,KACnC;CACrB,MAAM,QAAQ,SAAS,IAAI;CAE3B,IAAI,OAAO;AAEX,KAAI;AACF,SAAO,KAAK,UAAU,MAAM,MAAM,MAAM;UACjC,OAAO;AACd,UAAQ,MAAM,wCAAwC,KAAK,IAAI,MAAM;;AAGvE,QAAO,MAAM,mBAAmB,MAAM,KAAK"}

package/dist/types/build.d.ts

@@ -0,0 +1,26 @@
+import { BuildDictionariesOptions, buildDictionary } from "./buildIntlayerDictionary/buildIntlayerDictionary.js";
+import { processContentDeclaration } from "./buildIntlayerDictionary/processContentDeclaration.js";
+import { cleanOutputDir } from "./cleanOutputDir.js";
+import { CreateDictionaryEntryPointOptions, createDictionaryEntryPoint } from "./createDictionaryEntryPoint/createDictionaryEntryPoint.js";
+import { generateDictionaryListContent } from "./createDictionaryEntryPoint/generateDictionaryListContent.js";
+import { getBuiltDictionariesPath } from "./createDictionaryEntryPoint/getBuiltDictionariesPath.js";
+import { getBuiltDynamicDictionariesPath } from "./createDictionaryEntryPoint/getBuiltDynamicDictionariesPath.js";
+import { getBuiltFetchDictionariesPath } from "./createDictionaryEntryPoint/getBuiltFetchDictionariesPath.js";
+import { getBuiltRemoteDictionariesPath } from "./createDictionaryEntryPoint/getBuiltRemoteDictionariesPath.js";
+import { getBuiltUnmergedDictionariesPath } from "./createDictionaryEntryPoint/getBuiltUnmergedDictionariesPath.js";
+import { createModuleAugmentation, getTypeName } from "./createType/createModuleAugmentation.js";
+import { createTypes, generateTypeScriptType } from "./createType/createType.js";
+import { formatDictionaries, formatDictionariesOutput, formatDictionary, formatDictionaryOutput } from "./formatDictionary.js";
+import { DictionariesStatus, loadDictionaries } from "./loadDictionaries/loadDictionaries.js";
+import { ensureIntlayerBundle, formatLocalDictionaries, loadContentDeclaration, loadContentDeclarations } from "./loadDictionaries/loadContentDeclaration.js";
+import { loadLocalDictionaries } from "./loadDictionaries/loadLocalDictionaries.js";
+import { formatDistantDictionaries, loadRemoteDictionaries } from "./loadDictionaries/loadRemoteDictionaries.js";
+import { prepareIntlayer } from "./prepareIntlayer.js";
+import { readDictionariesFromDisk } from "./utils/readDictionariesFromDisk.js";
+import { isCachedConfigurationUpToDate, writeConfiguration } from "./writeConfiguration/index.js";
+import { detectExportedComponentName } from "./writeContentDeclaration/detectExportedComponentName.js";
+import { DictionaryStatus } from "./writeContentDeclaration/dictionaryStatus.js";
+import { transformJSFile } from "./writeContentDeclaration/transformJSFile.js";
+import { writeContentDeclaration } from "./writeContentDeclaration/writeContentDeclaration.js";
+import { writeJSFile } from "./writeContentDeclaration/writeJSFile.js";
+export { BuildDictionariesOptions, CreateDictionaryEntryPointOptions, DictionariesStatus, DictionaryStatus, buildDictionary, cleanOutputDir, createDictionaryEntryPoint, createModuleAugmentation, createTypes, detectExportedComponentName, ensureIntlayerBundle, formatDictionaries, formatDictionariesOutput, formatDictionary, formatDictionaryOutput, formatDistantDictionaries, formatLocalDictionaries, generateDictionaryListContent, generateTypeScriptType, getBuiltDictionariesPath, getBuiltDynamicDictionariesPath, getBuiltFetchDictionariesPath, getBuiltRemoteDictionariesPath, getBuiltUnmergedDictionariesPath, getTypeName, isCachedConfigurationUpToDate, loadContentDeclaration, loadContentDeclarations, loadDictionaries, loadLocalDictionaries, loadRemoteDictionaries, prepareIntlayer, processContentDeclaration, readDictionariesFromDisk, transformJSFile, writeConfiguration, writeContentDeclaration, writeJSFile };

package/dist/types/buildIntlayerDictionary/buildIntlayerDictionary.d.ts

@@ -0,0 +1,25 @@
+import { UnmergedDictionaryOutput } from "./writeUnmergedDictionary.js";
+import { MergedDictionaryOutput } from "./writeMergedDictionary.js";
+import { LocalizedDictionaryOutput } from "./writeDynamicDictionary.js";
+import { IntlayerConfig } from "@intlayer/types/config";
+import { Dictionary } from "@intlayer/types/dictionary";
+import { OUTPUT_FORMAT } from "@intlayer/config/defaultValues";
+
+//#region src/buildIntlayerDictionary/buildIntlayerDictionary.d.ts
+type BuildDictionariesOptions = Partial<{
+  formats: typeof OUTPUT_FORMAT;
+  importOtherDictionaries: boolean;
+  env: 'prod' | 'dev';
+}>;
+/**
+ * This function transpile the bundled code to to make dictionaries as JSON files
+ */
+declare const buildDictionary: (localDictionariesEntries: Dictionary[], configuration: IntlayerConfig, options?: BuildDictionariesOptions) => Promise<{
+  unmergedDictionaries: UnmergedDictionaryOutput;
+  mergedDictionaries: MergedDictionaryOutput;
+  dynamicDictionaries: LocalizedDictionaryOutput;
+  fetchDictionaries: LocalizedDictionaryOutput;
+}>;
+//#endregion
+export { BuildDictionariesOptions, buildDictionary };
+//# sourceMappingURL=buildIntlayerDictionary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildIntlayerDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/buildIntlayerDictionary.ts"],"mappings":";;;;;;;;KAmBY,wBAAA,GAA2B,OAAA;EACrC,OAAA,SAAgB,aAAA;EAChB,uBAAA;EACA,GAAA;AAAA;;;;cAYW,eAAA,GACX,wBAAA,EAA0B,UAAA,IAC1B,aAAA,EAAe,cAAA,EACf,OAAA,GAAU,wBAAA,KAAwB,OAAA;wBAAA,wBAAA"}

package/dist/types/buildIntlayerDictionary/index.d.ts

@@ -0,0 +1,3 @@
+import { BuildDictionariesOptions, buildDictionary } from "./buildIntlayerDictionary.js";
+import { processContentDeclaration } from "./processContentDeclaration.js";
+export { BuildDictionariesOptions, buildDictionary, processContentDeclaration };

package/dist/types/buildIntlayerDictionary/processContentDeclaration.d.ts

@@ -0,0 +1,11 @@
+import { IntlayerConfig } from "@intlayer/types/config";
+import { Dictionary } from "@intlayer/types/dictionary";
+
+//#region src/buildIntlayerDictionary/processContentDeclaration.d.ts
+/**
+ * Function to load, process the module and return the Intlayer Dictionary from the module file
+ */
+declare const processContentDeclaration: (contentDeclaration: Dictionary, configuration: IntlayerConfig) => Promise<Dictionary | undefined>;
+//#endregion
+export { processContentDeclaration };
+//# sourceMappingURL=processContentDeclaration.d.ts.map

package/dist/types/buildIntlayerDictionary/processContentDeclaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processContentDeclaration.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/processContentDeclaration.ts"],"mappings":";;;;;;AASA;cAAa,yBAAA,GACX,kBAAA,EAAoB,UAAA,EACpB,aAAA,EAAe,cAAA,KACd,OAAA,CAAQ,UAAA"}