@intlayer/engine 9.3.0 → 9.3.2

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

@@ -1 +1 @@
-{"version":3,"file":"transformJSONFile.mjs","names":[],"sources":["../../../src/writeContentDeclaration/transformJSONFile.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types/dictionary';\nimport * as recast from 'recast';\n\nconst b = recast.types.builders;\nconst n = recast.types.namedTypes;\n\n/**\n * Checks if a value is a plain object (and not null/array)\n */\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n};\n\n/**\n * Checks if a recast AST node value matches the incoming primitive value.\n */\nconst isPrimitiveEqual = (astNode: any, val: unknown): boolean => {\n  if (val === null) {\n    return n.Literal.check(astNode) && astNode.value === null;\n  }\n  if (\n    typeof val === 'string' ||\n    typeof val === 'number' ||\n    typeof val === 'boolean'\n  ) {\n    return (\n      (n.Literal.check(astNode) ||\n        n.StringLiteral.check(astNode) ||\n        n.NumericLiteral.check(astNode) ||\n        n.BooleanLiteral.check(astNode)) &&\n      astNode.value === val\n    );\n  }\n  return false;\n};\n\n/**\n * Robustly finds a property in a recast ObjectExpression.\n * Handles quoted (\"key\") or unquoted (key) properties.\n */\nconst getMatchingProperty = (node: any, key: string) => {\n  return node.properties.find((prop: any) => {\n    if (n.Property.check(prop) || n.ObjectProperty.check(prop)) {\n      if (n.Identifier.check(prop.key) && prop.key.name === key) return true;\n      if (n.StringLiteral.check(prop.key) && prop.key.value === key)\n        return true;\n      if (n.Literal.check(prop.key) && prop.key.value === key) return true;\n    }\n    return false;\n  });\n};\n\n/**\n * Recursively builds a clean recast AST node from a plain JS value.\n * Because these nodes lack `loc` tracking, recast is forced to pretty-print them.\n */\nconst buildASTNode = (val: unknown): any => {\n  if (val === null) return b.literal(null);\n\n  if (\n    typeof val === 'string' ||\n    typeof val === 'number' ||\n    typeof val === 'boolean'\n  ) {\n    return b.literal(val);\n  }\n\n  if (Array.isArray(val)) {\n    return b.arrayExpression(val.map((item) => buildASTNode(item)));\n  }\n\n  if (isPlainObject(val)) {\n    return b.objectExpression(\n      Object.entries(val)\n        .filter(([, v]) => v !== undefined)\n        .map(([k, v]) =>\n          b.property('init', b.stringLiteral(k), buildASTNode(v))\n        )\n    );\n  }\n\n  return b.literal(null); // Fallback\n};\n\n/**\n * Recursively updates the AST object literal with new data.\n */\nconst updateObjectLiteral = (node: any, data: Record<string, any>) => {\n  for (const [key, val] of Object.entries(data)) {\n    if (val === undefined) {\n      continue;\n    }\n\n    const existingProp = getMatchingProperty(node, key);\n\n    if (existingProp?.comments) {\n      existingProp.comments.forEach((c: any) => {\n        if ((c.type === 'Line' || c.type === 'CommentLine') && c.trailing) {\n          // Convert to block comment and tag it to force Recast to print it inline\n          c.type = c.type === 'Line' ? 'Block' : 'CommentBlock';\n          c.value = `__INLINE_LINE__${c.value}`;\n          c.leading = false;\n          c.trailing = true;\n        }\n      });\n    }\n\n    if (isPlainObject(val)) {\n      if (existingProp && n.ObjectExpression.check(existingProp.value)) {\n        updateObjectLiteral(existingProp.value, val);\n      } else {\n        if (existingProp) {\n          // Prevent AST invalidation if the primitive value is identical\n          const isIdentical =\n            n.Literal.check(existingProp.value) &&\n            existingProp.value.value === val;\n\n          if (!isIdentical) {\n            existingProp.value = buildASTNode(val);\n          }\n        } else {\n          node.properties.push(\n            b.property('init', b.stringLiteral(key), buildASTNode(val))\n          );\n        }\n      }\n    } else {\n      // Handle primitives and arrays\n      if (existingProp) {\n        // Skip assignment if the primitive value is identical\n        if (!isPrimitiveEqual(existingProp.value, val)) {\n          existingProp.value = buildASTNode(val);\n        }\n      } else {\n        node.properties.push(\n          b.property('init', b.stringLiteral(key), buildASTNode(val))\n        );\n      }\n    }\n  }\n};\n\nexport const transformJSONFile = (\n  fileContent: string,\n  dictionary: Dictionary,\n  noMetadata?: boolean\n): string => {\n  // Wrap content to create valid syntax for the parser\n  const wrappedContent = `const _config = ${fileContent.trim() || '{}'};`;\n\n  let ast: ReturnType<typeof recast.parse>;\n  try {\n    ast = recast.parse(wrappedContent);\n  } catch {\n    // Fallback if parsing failed\n    return JSON.stringify(\n      noMetadata ? dictionary.content : dictionary,\n      null,\n      2\n    );\n  }\n\n  // Navigate the AST to locate the object literal initialized to `_config`\n  const declaration = ast.program.body[0];\n  let objectLiteral: any;\n\n  if (\n    n.VariableDeclaration.check(declaration) &&\n    declaration.declarations.length > 0 &&\n    n.VariableDeclarator.check(declaration.declarations[0]) &&\n    n.ObjectExpression.check(declaration.declarations[0].init)\n  ) {\n    objectLiteral = declaration.declarations[0].init;\n  }\n\n  if (noMetadata) {\n    const metadataProperties = [\n      'id',\n      'locale',\n      'filled',\n      'fill',\n      'title',\n      'description',\n      'tags',\n      'version',\n      'priority',\n      'contentAutoTransformation',\n      '$schema',\n    ];\n\n    // Mutate the array backwards instead of using .filter() to prevent layout invalidation\n    for (let i = objectLiteral.properties.length - 1; i >= 0; i--) {\n      const prop = objectLiteral.properties[i];\n      if (n.Property.check(prop) || n.ObjectProperty.check(prop)) {\n        let propName = '';\n        if (n.Identifier.check(prop.key)) propName = prop.key.name;\n        else if (n.StringLiteral.check(prop.key)) propName = prop.key.value;\n        else if (n.Literal.check(prop.key)) propName = String(prop.key.value);\n\n        if (['key', 'content', ...metadataProperties].includes(propName)) {\n          objectLiteral.properties.splice(i, 1);\n        }\n      }\n    }\n  }\n\n  // Update the AST in place\n  updateObjectLiteral(\n    objectLiteral,\n    noMetadata ? (dictionary.content as Record<string, any>) : dictionary\n  );\n\n  // Print the full AST to utilize the global token stream for inline comments\n  const printedCode = recast.print(ast, {\n    tabWidth: 2,\n    quote: 'double',\n    trailingComma: false,\n  }).code;\n\n  // Extract the target object literal cleanly\n  const startIndex = printedCode.indexOf('{');\n  const endIndex = printedCode.lastIndexOf('}');\n  let finalOutput = printedCode.substring(startIndex, endIndex + 1);\n\n  // Revert the tagged block comment back to an inline line comment and fix comma placement\n  finalOutput = finalOutput.replace(\n    /\\s*\\/\\*__INLINE_LINE__(.*?)\\*\\/(\\s*,?)/g,\n    '$2 //$1'\n  );\n\n  // Collapse empty lines injected by Recast around commented properties\n  finalOutput = finalOutput.replace(/\\n[ \\t]*\\n/g, '\\n');\n\n  return finalOutput;\n};\n"],"mappings":"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"}
+{"version":3,"file":"transformJSONFile.mjs","names":[],"sources":["../../../src/writeContentDeclaration/transformJSONFile.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types/dictionary';\nimport * as recast from 'recast';\n\nconst b = recast.types.builders;\nconst n = recast.types.namedTypes;\n\n/**\n * Checks if a value is a plain object (and not null/array)\n */\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n};\n\n/**\n * Checks if a recast AST node value matches the incoming primitive value.\n */\nconst isPrimitiveEqual = (astNode: any, val: unknown): boolean => {\n  if (val === null) {\n    return n.Literal.check(astNode) && astNode.value === null;\n  }\n  if (\n    typeof val === 'string' ||\n    typeof val === 'number' ||\n    typeof val === 'boolean'\n  ) {\n    return (\n      (n.Literal.check(astNode) ||\n        n.StringLiteral.check(astNode) ||\n        n.NumericLiteral.check(astNode) ||\n        n.BooleanLiteral.check(astNode)) &&\n      astNode.value === val\n    );\n  }\n  return false;\n};\n\n/**\n * Robustly finds a property in a recast ObjectExpression.\n * Handles quoted (\"key\") or unquoted (key) properties.\n */\nconst getMatchingProperty = (node: any, key: string) => {\n  return node.properties.find((prop: any) => {\n    if (n.Property.check(prop) || n.ObjectProperty.check(prop)) {\n      if (n.Identifier.check(prop.key) && prop.key.name === key) return true;\n      if (n.StringLiteral.check(prop.key) && prop.key.value === key)\n        return true;\n      if (n.Literal.check(prop.key) && prop.key.value === key) return true;\n    }\n    return false;\n  });\n};\n\n/**\n * Recursively builds a clean recast AST node from a plain JS value.\n * Because these nodes lack `loc` tracking, recast is forced to pretty-print them.\n */\nconst buildASTNode = (val: unknown): any => {\n  if (val === null) return b.literal(null);\n\n  if (\n    typeof val === 'string' ||\n    typeof val === 'number' ||\n    typeof val === 'boolean'\n  ) {\n    return b.literal(val);\n  }\n\n  if (Array.isArray(val)) {\n    return b.arrayExpression(val.map((item) => buildASTNode(item)));\n  }\n\n  if (isPlainObject(val)) {\n    return b.objectExpression(\n      Object.entries(val)\n        .filter(([, v]) => v !== undefined)\n        .map(([k, v]) =>\n          b.property('init', b.stringLiteral(k), buildASTNode(v))\n        )\n    );\n  }\n\n  return b.literal(null); // Fallback\n};\n\n/**\n * Recursively updates the AST object literal with new data.\n */\nconst updateObjectLiteral = (node: any, data: Record<string, any>) => {\n  for (const [key, val] of Object.entries(data)) {\n    if (val === undefined) {\n      continue;\n    }\n\n    const existingProp = getMatchingProperty(node, key);\n\n    if (existingProp?.comments) {\n      existingProp.comments.forEach((c: any) => {\n        if ((c.type === 'Line' || c.type === 'CommentLine') && c.trailing) {\n          // Convert to block comment and tag it to force Recast to print it inline\n          c.type = c.type === 'Line' ? 'Block' : 'CommentBlock';\n          c.value = `__INLINE_LINE__${c.value}`;\n          c.leading = false;\n          c.trailing = true;\n        }\n      });\n    }\n\n    if (isPlainObject(val)) {\n      if (existingProp && n.ObjectExpression.check(existingProp.value)) {\n        updateObjectLiteral(existingProp.value, val);\n      } else {\n        if (existingProp) {\n          // Prevent AST invalidation if the primitive value is identical\n          const isIdentical =\n            n.Literal.check(existingProp.value) &&\n            existingProp.value.value === val;\n\n          if (!isIdentical) {\n            existingProp.value = buildASTNode(val);\n          }\n        } else {\n          node.properties.push(\n            b.property('init', b.stringLiteral(key), buildASTNode(val))\n          );\n        }\n      }\n    } else {\n      // Handle primitives and arrays\n      if (existingProp) {\n        // Skip assignment if the primitive value is identical\n        if (!isPrimitiveEqual(existingProp.value, val)) {\n          existingProp.value = buildASTNode(val);\n        }\n      } else {\n        node.properties.push(\n          b.property('init', b.stringLiteral(key), buildASTNode(val))\n        );\n      }\n    }\n  }\n};\n\nexport const transformJSONFile = (\n  fileContent: string,\n  dictionary: Dictionary,\n  noMetadata?: boolean\n): string => {\n  // Wrap content to create valid syntax for the parser\n  const wrappedContent = `const _config = ${fileContent.trim() || '{}'};`;\n\n  let ast: ReturnType<typeof recast.parse>;\n  try {\n    ast = recast.parse(wrappedContent);\n  } catch {\n    // Fallback if parsing failed\n    return JSON.stringify(\n      noMetadata ? dictionary.content : dictionary,\n      null,\n      2\n    );\n  }\n\n  // Navigate the AST to locate the object literal initialized to `_config`\n  const declaration = ast.program.body[0];\n  let objectLiteral: any;\n\n  if (\n    n.VariableDeclaration.check(declaration) &&\n    declaration.declarations.length > 0 &&\n    n.VariableDeclarator.check(declaration.declarations[0]) &&\n    n.ObjectExpression.check(declaration.declarations[0].init)\n  ) {\n    objectLiteral = declaration.declarations[0].init;\n  }\n\n  if (noMetadata) {\n    const metadataProperties = [\n      'id',\n      'locale',\n      'filled',\n      'fill',\n      'title',\n      'description',\n      'tags',\n      'version',\n      'priority',\n      'contentAutoTransformation',\n      '$schema',\n    ];\n\n    // Mutate the array backwards instead of using .filter() to prevent layout invalidation\n    for (let i = objectLiteral.properties.length - 1; i >= 0; i--) {\n      const prop = objectLiteral.properties[i];\n      if (n.Property.check(prop) || n.ObjectProperty.check(prop)) {\n        let propName = '';\n        if (n.Identifier.check(prop.key)) propName = prop.key.name;\n        else if (n.StringLiteral.check(prop.key)) propName = prop.key.value;\n        else if (n.Literal.check(prop.key)) propName = String(prop.key.value);\n\n        if (['key', 'content', ...metadataProperties].includes(propName)) {\n          objectLiteral.properties.splice(i, 1);\n        }\n      }\n    }\n  }\n\n  // Update the AST in place\n  updateObjectLiteral(\n    objectLiteral,\n    noMetadata ? (dictionary.content as Record<string, any>) : dictionary\n  );\n\n  // Print the full AST to utilize the global token stream for inline comments\n  const printedCode = recast.print(ast, {\n    tabWidth: 2,\n    quote: 'double',\n    trailingComma: false,\n  }).code;\n\n  // Extract the target object literal cleanly\n  const startIndex = printedCode.indexOf('{');\n  const endIndex = printedCode.lastIndexOf('}');\n  let finalOutput = printedCode.substring(startIndex, endIndex + 1);\n\n  // Revert the tagged block comment back to an inline line comment and fix comma placement\n  finalOutput = finalOutput.replace(\n    /\\s*\\/\\*__INLINE_LINE__(.*?)\\*\\/(\\s*,?)/g,\n    '$2 //$1'\n  );\n\n  // Collapse empty lines injected by Recast around commented properties\n  finalOutput = finalOutput.replace(/\\n[ \\t]*\\n/g, '\\n');\n\n  return finalOutput;\n};\n"],"mappings":"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"}

package/dist/esm/writeContentDeclaration/writeContentDeclaration.mjs

@@ -52,7 +52,11 @@ const formatContentDeclaration = async (dictionary, configuration, localeList) =
 		...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 = {
+	/**
+	* Add $schema to JSON dictionaries
+	*/
+	const extension = dictionary.filePath ? extname(dictionary.filePath) : ".json";
+	if (getFormatFromExtension(extension) === "json" && pluginFormatResult.content && pluginFormatResult.key) result = {
 		$schema: "https://intlayer.org/schema.json",
 		...result
 	};
@@ -99,7 +103,8 @@ const writeContentDeclaration = async (dictionary, configuration, options) => {
 	};
 };
 const writeFileWithDirectories = async (absoluteFilePath, dictionary, configuration, noMetadata) => {
-	await mkdir(dirname(absoluteFilePath), { recursive: true });
+	const dir = dirname(absoluteFilePath);
+	await mkdir(dir, { recursive: true });
 	const extension = extname(absoluteFilePath);
 	if (extension === ".md" || extension === ".mdx") {
 		await writeMarkdownFile(absoluteFilePath, dictionary, configuration);
@@ -153,7 +158,8 @@ const writeFileWithDirectories = async (absoluteFilePath, dictionary, configurat
 	])).has(extension)) return;
 	await writeJSFile(absoluteFilePath, dictionary, configuration, noMetadata);
 	try {
-		await rm(join(configuration.system.cacheDir, "intlayer-prepared.lock"), { recursive: true });
+		const sentinelPath = join(configuration.system.cacheDir, "intlayer-prepared.lock");
+		await rm(sentinelPath, { recursive: true });
 	} catch {}
 };
 

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

@@ -1 +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":"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"}
+{"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":"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"}

package/dist/esm/writeContentDeclaration/writeJSFile.mjs

@@ -22,7 +22,8 @@ const writeJSFile = async (filePath, dictionary, configuration, noMetadata) => {
 	};
 	const appLogger = getAppLogger(configuration);
 	if (!existsSync(filePath)) {
-		const format = getFormatFromExtension(extname(filePath));
+		const fileExtension = extname(filePath);
+		const format = getFormatFromExtension(fileExtension);
 		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,

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

@@ -1 +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":"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"}
+{"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":"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"}

package/dist/esm/writeContentDeclaration/writeMarkdownFile.mjs

@@ -36,7 +36,8 @@ const writeMarkdownFile = async (absoluteFilePath, dictionary, configuration) =>
 	const markdownBody = getMarkdownBody(markdownRaw);
 	const frontmatterFields = Object.fromEntries(Object.entries(dictionary).filter(([k, v]) => !EXCLUDED_FRONTMATTER_KEYS.has(k) && v !== void 0));
 	const fileContent = `---\n${stringifyYamlFrontmatter(frontmatterFields)}\n---\n\n${markdownBody}`;
-	await mkdir(dirname(absoluteFilePath), { recursive: true });
+	const dir = dirname(absoluteFilePath);
+	await mkdir(dir, { 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`;

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

@@ -1 +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,MAAM,CAAC,CACnB,QAAQ,GAAG,WAAW,UAAU,UAAa,UAAU,IAAI,CAAC,CAC5D,KAAK,CAAC,KAAK,WAAW;CACrB,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,GAAG,IAAI,KAAK,MAAM,KAAK,SAAS,OAAO,KAAK,UAAU,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI;CAEjF,IACE,OAAO,UAAU,aAChB,MAAM,SAAS,GAAG,KAAK,MAAM,SAAS,IAAI,KAAK,MAAM,SAAS,GAAG,IAElE,OAAO,GAAG,IAAI,IAAI,KAAK,UAAU,KAAK;CAExC,OAAO,GAAG,IAAI,IAAI;AACpB,CAAC,CAAC,CACD,KAAK,IAAI;AAGd,MAAM,mBAAmB,YAA4B;CACnD,MAAM,QAAQ,QAAQ,MAAM,OAAO;CACnC,MAAM,qBAAqB,MAAM,WAAW,SAAS,KAAK,KAAK,MAAM,EAAE;CAEvE,IAAI,uBAAuB,MAAM,MAAM,mBAAmB,CAAC,KAAK,MAAM,OACpE,OAAO;CAGT,IAAI,WAAW;CACf,KAAK,IAAI,IAAI,qBAAqB,GAAG,IAAI,MAAM,QAAQ,KACrD,IAAI,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO;EAC7B,WAAW;EACX;CACF;CAGF,IAAI,aAAa,IAAI,OAAO;CAE5B,OAAO,MACJ,MAAM,WAAW,CAAC,CAAC,CACnB,KAAK,IAAI,CAAC,CACV,UAAU;AACf;AAGA,MAAM,4CAA4B,IAAI,IAAY;CAChD;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAa,oBAAoB,OAC/B,kBACA,YACA,kBACkB;CAClB,MAAM,UAAU,WAAW;CAC3B,MAAM,cACJ,OAAO,YAAY,YAAY,SAAS,aAAa,WAChD,QAAQ,aAAa,KACtB;CAEN,MAAM,eAAe,gBAAgB,WAAW;CAEhD,MAAM,oBAAoB,OAAO,YAC/B,OAAO,QAAQ,UAAU,CAAC,CAAC,QACxB,CAAC,GAAG,OAAO,CAAC,0BAA0B,IAAI,CAAC,KAAK,MAAM,MACzD,CACF;CAGA,MAAM,cAAc,QADG,yBAAyB,iBACP,EAAE,WAAW;CAGtD,MAAM,MADM,QAAQ,gBACN,GAAG,EAAE,WAAW,KAAK,CAAC;CAEpC,MAAM,UAAU,cAAc,QAAQ;CACtC,IAAI,SAAS,MAAM,MAAM,SAAS,EAAE,WAAW,KAAK,CAAC;CAErD,MAAM,eAAe,GAAG,SAAS,gBAAgB,EAAE,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;CACxG,MAAM,WAAW,UACb,KAAK,SAAS,YAAY,IAC1B,GAAG,iBAAiB,GAAG;CAE3B,IAAI;EACF,MAAM,UAAU,UAAU,aAAa,OAAO;EAC9C,MAAM,OAAO,UAAU,gBAAgB;CACzC,SAAS,OAAO;EACd,IAAI;GACF,MAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;EACpC,QAAQ,CAER;EACA,MAAM;CACR;CAEA,MAAM,gBAAgB,oBAAoB,aAAa;CACvD,IAAI,eACF,IAAI;EACF,SAAS,cAAc,QAAQ,YAAY,gBAAgB,GAAG;GAC5D,OAAO;GACP,KAAK,cAAc,OAAO;EAC5B,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;CACrB;AAEJ"}
+{"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,MAAM,CAAC,CACnB,QAAQ,GAAG,WAAW,UAAU,UAAa,UAAU,IAAI,CAAC,CAC5D,KAAK,CAAC,KAAK,WAAW;CACrB,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,GAAG,IAAI,KAAK,MAAM,KAAK,SAAS,OAAO,KAAK,UAAU,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI;CAEjF,IACE,OAAO,UAAU,aAChB,MAAM,SAAS,GAAG,KAAK,MAAM,SAAS,IAAI,KAAK,MAAM,SAAS,GAAG,IAElE,OAAO,GAAG,IAAI,IAAI,KAAK,UAAU,KAAK;CAExC,OAAO,GAAG,IAAI,IAAI;AACpB,CAAC,CAAC,CACD,KAAK,IAAI;AAGd,MAAM,mBAAmB,YAA4B;CACnD,MAAM,QAAQ,QAAQ,MAAM,OAAO;CACnC,MAAM,qBAAqB,MAAM,WAAW,SAAS,KAAK,KAAK,MAAM,EAAE;CAEvE,IAAI,uBAAuB,MAAM,MAAM,mBAAmB,CAAC,KAAK,MAAM,OACpE,OAAO;CAGT,IAAI,WAAW;CACf,KAAK,IAAI,IAAI,qBAAqB,GAAG,IAAI,MAAM,QAAQ,KACrD,IAAI,MAAM,EAAE,CAAC,KAAK,MAAM,OAAO;EAC7B,WAAW;EACX;CACF;CAGF,IAAI,aAAa,IAAI,OAAO;CAE5B,OAAO,MACJ,MAAM,WAAW,CAAC,CAAC,CACnB,KAAK,IAAI,CAAC,CACV,UAAU;AACf;AAGA,MAAM,4CAA4B,IAAI,IAAY;CAChD;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,MAAa,oBAAoB,OAC/B,kBACA,YACA,kBACkB;CAClB,MAAM,UAAU,WAAW;CAC3B,MAAM,cACJ,OAAO,YAAY,YAAY,SAAS,aAAa,WAChD,QAAQ,aAAa,KACtB;CAEN,MAAM,eAAe,gBAAgB,WAAW;CAEhD,MAAM,oBAAoB,OAAO,YAC/B,OAAO,QAAQ,UAAU,CAAC,CAAC,QACxB,CAAC,GAAG,OAAO,CAAC,0BAA0B,IAAI,CAAC,KAAK,MAAM,MACzD,CACF;CAGA,MAAM,cAAc,QADG,yBAAyB,iBACP,EAAE,WAAW;CAEtD,MAAM,MAAM,QAAQ,gBAAgB;CACpC,MAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;CAEpC,MAAM,UAAU,cAAc,QAAQ;CACtC,IAAI,SAAS,MAAM,MAAM,SAAS,EAAE,WAAW,KAAK,CAAC;CAErD,MAAM,eAAe,GAAG,SAAS,gBAAgB,EAAE,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;CACxG,MAAM,WAAW,UACb,KAAK,SAAS,YAAY,IAC1B,GAAG,iBAAiB,GAAG;CAE3B,IAAI;EACF,MAAM,UAAU,UAAU,aAAa,OAAO;EAC9C,MAAM,OAAO,UAAU,gBAAgB;CACzC,SAAS,OAAO;EACd,IAAI;GACF,MAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;EACpC,QAAQ,CAER;EACA,MAAM;CACR;CAEA,MAAM,gBAAgB,oBAAoB,aAAa;CACvD,IAAI,eACF,IAAI;EACF,SAAS,cAAc,QAAQ,YAAY,gBAAgB,GAAG;GAC5D,OAAO;GACP,KAAK,cAAc,OAAO;EAC5B,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;CACrB;AAEJ"}

package/dist/esm/writeContentDeclaration/writeYamlFile.mjs

@@ -11,8 +11,10 @@ const EXCLUDED_YAML_KEYS = /* @__PURE__ */ new Set([
 	"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 filtered = Object.fromEntries(Object.entries(dictionary).filter(([k, v]) => !EXCLUDED_YAML_KEYS.has(k) && v !== void 0));
+	const fileContent = stringifyYaml(filtered);
+	const dir = dirname(absoluteFilePath);
+	await mkdir(dir, { 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`;

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

@@ -1 +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,qCAAqB,IAAI,IAAY;CAAC;CAAW;CAAM;AAAU,CAAC;AAExE,MAAa,gBAAgB,OAC3B,kBACA,YACA,kBACkB;CAOlB,MAAM,cAAc,cANH,OAAO,YACtB,OAAO,QAAQ,UAAU,CAAC,CAAC,QACxB,CAAC,GAAG,OAAO,CAAC,mBAAmB,IAAI,CAAC,KAAK,MAAM,MAClD,CAGuC,CAAC;CAG1C,MAAM,MADM,QAAQ,gBACN,GAAG,EAAE,WAAW,KAAK,CAAC;CAEpC,MAAM,UAAU,cAAc,QAAQ;CACtC,IAAI,SAAS,MAAM,MAAM,SAAS,EAAE,WAAW,KAAK,CAAC;CAErD,MAAM,eAAe,GAAG,SAAS,gBAAgB,EAAE,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;CACxG,MAAM,WAAW,UACb,KAAK,SAAS,YAAY,IAC1B,GAAG,iBAAiB,GAAG;CAE3B,IAAI;EACF,MAAM,UAAU,UAAU,aAAa,OAAO;EAC9C,MAAM,OAAO,UAAU,gBAAgB;CACzC,SAAS,OAAO;EACd,IAAI;GACF,MAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;EACpC,QAAQ,CAER;EACA,MAAM;CACR;CAEA,MAAM,gBAAgB,oBAAoB,aAAa;CACvD,IAAI,eACF,IAAI;EACF,SAAS,cAAc,QAAQ,YAAY,gBAAgB,GAAG;GAC5D,OAAO;GACP,KAAK,cAAc,OAAO;EAC5B,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;CACrB;AAEJ"}
+{"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,qCAAqB,IAAI,IAAY;CAAC;CAAW;CAAM;AAAU,CAAC;AAExE,MAAa,gBAAgB,OAC3B,kBACA,YACA,kBACkB;CAClB,MAAM,WAAW,OAAO,YACtB,OAAO,QAAQ,UAAU,CAAC,CAAC,QACxB,CAAC,GAAG,OAAO,CAAC,mBAAmB,IAAI,CAAC,KAAK,MAAM,MAClD,CACF;CAEA,MAAM,cAAc,cAAc,QAAQ;CAE1C,MAAM,MAAM,QAAQ,gBAAgB;CACpC,MAAM,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;CAEpC,MAAM,UAAU,cAAc,QAAQ;CACtC,IAAI,SAAS,MAAM,MAAM,SAAS,EAAE,WAAW,KAAK,CAAC;CAErD,MAAM,eAAe,GAAG,SAAS,gBAAgB,EAAE,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;CACxG,MAAM,WAAW,UACb,KAAK,SAAS,YAAY,IAC1B,GAAG,iBAAiB,GAAG;CAE3B,IAAI;EACF,MAAM,UAAU,UAAU,aAAa,OAAO;EAC9C,MAAM,OAAO,UAAU,gBAAgB;CACzC,SAAS,OAAO;EACd,IAAI;GACF,MAAM,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;EACpC,QAAQ,CAER;EACA,MAAM;CACR;CAEA,MAAM,gBAAgB,oBAAoB,aAAa;CACvD,IAAI,eACF,IAAI;EACF,SAAS,cAAc,QAAQ,YAAY,gBAAgB,GAAG;GAC5D,OAAO;GACP,KAAK,cAAc,OAAO;EAC5B,CAAC;CACH,SAAS,OAAO;EACd,QAAQ,MAAM,KAAK;CACrB;AAEJ"}

package/dist/types/cli.d.ts

@@ -7,7 +7,7 @@ import { writeJSFile } from "./writeContentDeclaration/writeJSFile.js";
 import "./writeContentDeclaration/index.js";
 import { detectFormatCommand } from "./detectFormatCommand.js";
 import { getContentDeclarationFileTemplate } from "./getContentDeclarationFileTemplate/getContentDeclarationFileTemplate.js";
-import { PackageManager, detectPackageManager, installPackages } from "./init/utils/packageManager.js";
+import { COMPAT_I18N_LIBRARIES, CompatI18nLibrary, PackageManager, detectCompatI18nLibraries, detectPackageManager, installPackages } from "./init/utils/packageManager.js";
 import { RoutingMode } from "./init/utils/configManipulation.js";
 import { CmsCredentials, enableEditorInConfig, setupCmsCredentials, writeCmsCredentialsToEnv } from "./init/cms.js";
 import { NEXT_INTLAYER_BABEL_CONFIG_CONTENT } from "./init/utils/nextCompilerBabel.js";
@@ -20,4 +20,4 @@ import { listDictionaries, listDictionariesWithStats } from "./listDictionariesP
 import { DiffMode, ListGitFilesOptions, ListGitLinesOptions, listGitFiles, listGitLines } from "./listGitFiles.js";
 import { ListProjectsOptions, getGitRootDir, listProjects } from "./listProjects.js";
 import { logConfigDetails } from "./logConfigDetails.js";
-export { type CmsCredentials, ContentStrategy, DictionaryStatus, DiffMode, InitOptions, ListGitFilesOptions, ListGitLinesOptions, ListProjectsOptions, MCPTransport, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, PLATFORMS, PLATFORMS_METADATA, type PackageManager, Platform, PlatformMetadata, type RoutingMode, SKILLS, SKILLS_METADATA, Skill, detectExportedComponentName, detectFormatCommand, detectPackageManager, enableEditorInConfig, getContentDeclarationFileTemplate, getDefaultApplicationURL, getGitRootDir, getInitialSkills, initIntlayer, installLSP, installMCP, installPackages, installSkills, listDictionaries, listDictionariesWithStats, listGitFiles, listGitLines, listProjects, logConfigDetails, prepareIntlayer, setupCmsCredentials, transformJSFile, writeCmsCredentialsToEnv, writeContentDeclaration, writeJSFile };
+export { COMPAT_I18N_LIBRARIES, type CmsCredentials, type CompatI18nLibrary, ContentStrategy, DictionaryStatus, DiffMode, InitOptions, ListGitFilesOptions, ListGitLinesOptions, ListProjectsOptions, MCPTransport, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, PLATFORMS, PLATFORMS_METADATA, type PackageManager, Platform, PlatformMetadata, type RoutingMode, SKILLS, SKILLS_METADATA, Skill, detectCompatI18nLibraries, detectExportedComponentName, detectFormatCommand, detectPackageManager, enableEditorInConfig, getContentDeclarationFileTemplate, getDefaultApplicationURL, getGitRootDir, getInitialSkills, initIntlayer, installLSP, installMCP, installPackages, installSkills, listDictionaries, listDictionariesWithStats, listGitFiles, listGitLines, listProjects, logConfigDetails, prepareIntlayer, setupCmsCredentials, transformJSFile, writeCmsCredentialsToEnv, writeContentDeclaration, writeJSFile };

package/dist/types/init/frameworkSetup/tanstackStart/templates.d.ts

@@ -13,10 +13,15 @@
 declare const buildLocaleRouteTemplate: (localeSegment: string) => string;
 /**
  * Root route document (`routes/__root.tsx`) providing `<html>` + the Intlayer
- * provider, with the locale read from the `{-$locale}` route param.
+ * provider, with the locale read from the locale segment route params.
+ *
+ * The route is reached through `getRouteApi(<route id>)` rather than by
+ * importing `<segment>/route`, so the root never imports a child route module —
+ * the recommended way to consume another route's typed hooks.
  */
-declare const ROOT_TEMPLATE_TS = "import {\n  createRootRoute,\n  HeadContent,\n  Scripts,\n  useParams,\n} from \"@tanstack/react-router\";\nimport { defaultLocale, getHTMLTextDir } from \"intlayer\";\nimport type { ReactNode } from \"react\";\nimport { IntlayerProvider } from \"react-intlayer\";\n\nexport const Route = createRootRoute({\n  shellComponent: RootDocument,\n});\n\nfunction RootDocument({ children }: { children: ReactNode }) {\n  const params = useParams({ strict: false });\n  const locale = params.locale ?? defaultLocale;\n\n  return (\n    <html dir={getHTMLTextDir(locale)} lang={locale}>\n      <head>\n        <HeadContent />\n      </head>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n        <Scripts />\n      </body>\n    </html>\n  );\n}\n";
-declare const ROOT_TEMPLATE_JS = "import {\n  createRootRoute,\n  HeadContent,\n  Scripts,\n  useParams,\n} from \"@tanstack/react-router\";\nimport { defaultLocale, getHTMLTextDir } from \"intlayer\";\nimport { IntlayerProvider } from \"react-intlayer\";\n\nexport const Route = createRootRoute({\n  shellComponent: RootDocument,\n});\n\nfunction RootDocument({ children }) {\n  const params = useParams({ strict: false });\n  const locale = params.locale ?? defaultLocale;\n\n  return (\n    <html dir={getHTMLTextDir(locale)} lang={locale}>\n      <head>\n        <HeadContent />\n      </head>\n      <body>\n        <IntlayerProvider locale={locale}>{children}</IntlayerProvider>\n        <Scripts />\n      </body>\n    </html>\n  );\n}\n";
+declare const buildRootTemplateTs: (localeSegment: string) => string;
+/** JavaScript counterpart of {@link buildRootTemplateTs}. */
+declare const buildRootTemplateJs: (localeSegment: string) => string;
 //#endregion
-export { ROOT_TEMPLATE_JS, ROOT_TEMPLATE_TS, buildLocaleRouteTemplate };
+export { buildLocaleRouteTemplate, buildRootTemplateJs, buildRootTemplateTs };
 //# sourceMappingURL=templates.d.ts.map

package/dist/types/init/frameworkSetup/tanstackStart/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/templates.ts"],"mappings":";;;;;;;;;;;;cAYa,2BAAwB;;;;;cA4BxB;cAgCA"}
+{"version":3,"file":"templates.d.ts","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/templates.ts"],"mappings":";;;;;;;;;;;;cAYa,2BAAwB;;;;;;;;;cAgCxB,sBAAmB;;cAkCnB,sBAAmB"}

package/dist/types/init/frameworkSetup/tanstackStart/transforms.d.ts

@@ -6,12 +6,16 @@ type TransformResult = {
 };
 /**
  * Wraps the `{children}` of a TanStack Start root document with
- * `IntlayerProvider`, deriving the locale from the `{-$locale}` route param.
+ * `IntlayerProvider`, deriving the locale from the locale segment route params.
  * Safe and idempotent: bails (returns the original code) when the provider is
  * already present, when no `<html>` document function is found, or when there is
  * no `{children}` placeholder to wrap.
+ *
+ * @param code Source of the project's `__root` document.
+ * @param localeSegment Locale segment directory in use — `{-$locale}` for every
+ * routing mode but `prefix-all`, which uses the required `$locale`.
  */
-declare const wrapRootWithProvider: (code: string) => TransformResult;
+declare const wrapRootWithProvider: (code: string, localeSegment: string) => TransformResult;
 //#endregion
 export { TransformResult, wrapRootWithProvider };
 //# sourceMappingURL=transforms.d.ts.map

package/dist/types/init/frameworkSetup/tanstackStart/transforms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transforms.d.ts","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/transforms.ts"],"mappings":";;KAWY;EACV;EACA;;;;;;;;;cAqJW,uBAAoB,iBAAmB"}
+{"version":3,"file":"transforms.d.ts","names":[],"sources":["../../../../../src/init/frameworkSetup/tanstackStart/transforms.ts"],"mappings":";;KAkBY;EACV;EACA;;;;;;;;;;;;;cAoMW,uBAAoB,cACnB,0BAEX"}

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

@@ -33,6 +33,8 @@ type InitOptions = {
   noVscodeExtension?: boolean;
   /** Skip writing the Intlayer LSP configuration to `.vscode/settings.json`. */
   noLsp?: boolean;
+  /** Skip enabling the Intlayer lint rules (ESLint / oxlint). */
+  noEslint?: boolean;
   /**
    * Skip framework-specific scaffolding (middleware/proxy, providers in
    * layout/page, example content). Defaults to enabled.
@@ -50,13 +52,6 @@ type InitOptions = {
    * (`prefix-no-default`) is kept.
    */
   routingMode?: RoutingMode;
-  /**
-   * Extra packages hinted by the interactive init prompt (compat i18n library
-   * selections made before those libraries are actually installed). These are
-   * merged into the dependency map used by {@link detectMissingIntlayerPackages}
-   * so the correct sync plugin and compat adapter are always scheduled.
-   */
-  hintDependencies?: Record<string, string>;
   /**
    * Content organization strategy chosen by the interactive init prompt. Drives
    * the `compiler.output` template (`centralized`) or the injection of the

package/dist/types/init/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/init/index.ts"],"mappings":";;;;;;;;;cA6La,2BAAwB,cACrB;;;;;;;;;;KAsBJ;;;;KAQA;EACV;;EAEA;;;;EAIA;;EAEA;;EAEA;;;;;EAKA;;;;;;EAMA;;;;;;EAMA,cAAc;;;;;;;EAOd,mBAAmB;;;;;;;EAOnB,kBAAkB;;;;;cAMP,eAAY,iBAAyB,UAAY,gBAAW"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/init/index.ts"],"mappings":";;;;;;;;;cAwNa,2BAAwB,cACrB;;;;;;;;;;KAsBJ;;;;KAQA;EACV;;EAEA;;;;EAIA;;EAEA;;EAEA;;EAEA;;;;;EAKA;;;;;;EAMA;;;;;;EAMA,cAAc;;;;;;;EAOd,kBAAkB;;;;;cAMP,eAAY,iBAAyB,UAAY,gBAAW"}

package/dist/types/init/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, IntlayerPackageAnalysis, PackageManager, detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages } from "./packageManager.js";
+import { COMPAT_I18N_LIBRARIES, CompatI18nLibrary, CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, IntlayerPackageAnalysis, PackageManager, detectCompatI18nLibraries, detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, hasLintTooling, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages } from "./packageManager.js";
 import { RoutingMode, enableIntlayerEditorConfig, getMetroConfigTemplate, hasIntlayerVitePlugin, replaceViteConfigPluginImportSource, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n } from "./configManipulation.js";
 import { ensureNamedImport, firstInsertIndex, isModuleScopeBinding } from "./astImports.js";
 import { JsonLocalePattern, JsonLocalePatternType, LinguiCatalogPattern, NextIntlMessagesPattern, detectJsonLocalePattern, detectLinguiCatalogPattern, detectNextIntlMessagesPattern, ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "./fileSystem.js";
@@ -7,4 +7,4 @@ import { parseJSONWithComments } from "./jsonParser.js";
 import { NEXT_INTLAYER_BABEL_CONFIG_CONTENT, setupNextCompilerBabelConfig } from "./nextCompilerBabel.js";
 import { findTsConfigFiles } from "./tsConfig.js";
 import { isVersionAtLeast } from "./version.js";
-export { CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, GithubWorkflowFile, GithubWorkflowsContext, GithubWorkflowsOptions, IntlayerPackageAnalysis, JsonLocalePattern, JsonLocalePatternType, LinguiCatalogPattern, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, NextIntlMessagesPattern, PackageManager, RoutingMode, detectJsonLocalePattern, detectLinguiCatalogPattern, detectMissingIntlayerPackages, detectNextIntlMessagesPattern, detectOutdatedIntlayerPackages, detectPackageManager, enableIntlayerEditorConfig, ensureDirectory, ensureNamedImport, exists, findTsConfigFiles, firstInsertIndex, getGithubWorkflows, getInstalledPackageVersion, getMetroConfigTemplate, hasIntlayerVitePlugin, installPackages, isIntlayerPackageName, isModuleScopeBinding, isVersionAtLeast, normalizeVersion, parseJSONWithComments, readFileFromRoot, replaceViteConfigPluginImportSource, resolveGithubWorkflowsContext, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, setupNextCompilerBabelConfig, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n, upgradePackages, writeFileToRoot };
+export { COMPAT_I18N_LIBRARIES, CompatI18nLibrary, CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, GithubWorkflowFile, GithubWorkflowsContext, GithubWorkflowsOptions, IntlayerPackageAnalysis, JsonLocalePattern, JsonLocalePatternType, LinguiCatalogPattern, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, NextIntlMessagesPattern, PackageManager, RoutingMode, detectCompatI18nLibraries, detectJsonLocalePattern, detectLinguiCatalogPattern, detectMissingIntlayerPackages, detectNextIntlMessagesPattern, detectOutdatedIntlayerPackages, detectPackageManager, enableIntlayerEditorConfig, ensureDirectory, ensureNamedImport, exists, findTsConfigFiles, firstInsertIndex, getGithubWorkflows, getInstalledPackageVersion, getMetroConfigTemplate, hasIntlayerVitePlugin, hasLintTooling, installPackages, isIntlayerPackageName, isModuleScopeBinding, isVersionAtLeast, normalizeVersion, parseJSONWithComments, readFileFromRoot, replaceViteConfigPluginImportSource, resolveGithubWorkflowsContext, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, setupNextCompilerBabelConfig, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n, upgradePackages, writeFileToRoot };

package/dist/types/init/utils/packageManager.d.ts

@@ -100,14 +100,47 @@ type DetectMissingPackagesOptions = {
    * dependency the lingui compat setup uses.
    */
   linguiCatalogFormat?: 'po' | 'json' | null;
+};
+/** An existing i18n library Intlayer ships a compat adapter for. */
+type CompatI18nLibrary = {
+  /** Human-readable name, used to report the detection back to the user. */
+  label: string;
   /**
-   * Extra package names injected by the interactive init prompt when the user
-   * selects a compat i18n library that is not yet in `package.json`.
-   * These are merged with the real dependency map before running detection so
-   * the correct sync plugin and compat adapter are scheduled for installation.
+   * Dependency names that reveal the library — both the upstream packages and
+   * the Intlayer adapters, so a project that already ran `init` is still
+   * recognized.
    */
-  hintDependencies?: Record<string, string>;
+  packages: readonly string[];
 };
+/**
+ * Existing i18n libraries Intlayer can adapt, keyed by the dependencies that
+ * reveal them. Mirrors the compat branches of
+ * {@link detectMissingIntlayerPackages}: a library listed here is one that
+ * detection will wire up on its own once its package is in `package.json`.
+ */
+declare const COMPAT_I18N_LIBRARIES: readonly CompatI18nLibrary[];
+/**
+ * Returns the labels of the compat i18n libraries present in `dependencies`.
+ *
+ * Lets the init flow report (and branch on) the libraries it found without
+ * asking the user, since {@link detectMissingIntlayerPackages} already derives
+ * the adapters, sync plugin and config from the very same dependency map.
+ *
+ * @param dependencies - Merged dependencies of the target project.
+ */
+declare const detectCompatI18nLibraries: (dependencies: Record<string, string>) => string[];
+/**
+ * True when the project already lints, and so has something to plug the
+ * Intlayer lint rules into.
+ *
+ * `eslint-plugin-intlayer` loads in both ESLint and oxlint, so either linter is
+ * enough. Shared with the init flow so that installing the plugin and wiring up
+ * its configuration are gated on exactly the same condition — a project that
+ * does not lint is left alone entirely.
+ *
+ * @param dependencies - Merged dependencies of the target project.
+ */
+declare const hasLintTooling: (dependencies: Record<string, string>) => boolean;
 declare const detectMissingIntlayerPackages: (allDependencies: Record<string, string>, options?: DetectMissingPackagesOptions) => IntlayerPackageAnalysis;
 /**
  * Runs the package install command synchronously.
@@ -151,5 +184,5 @@ declare const detectOutdatedIntlayerPackages: (rootDir: string, dependencies: Re
  */
 declare const upgradePackages: (rootDir: string, packages: string[], packageManager: PackageManager, targetVersion: string, isDev?: boolean) => void;
 //#endregion
-export { CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, IntlayerPackageAnalysis, PackageManager, detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages };
+export { COMPAT_I18N_LIBRARIES, CompatI18nLibrary, CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, IntlayerPackageAnalysis, PackageManager, detectCompatI18nLibraries, detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, hasLintTooling, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages };
 //# sourceMappingURL=packageManager.d.ts.map

package/dist/types/init/utils/packageManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packageManager.d.ts","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"mappings":";;KAMY;;;;;KAMA;;;;;;;EAOV;;;;;EAKA;;;;;EAKA;;;;;;;;;;;;;;;EAeA;;;;;;;KAQU;;EAEV;;EAEA;;;;;;;;EAQA;;IAEE;;IAEA;;;;KAKQ;;EAEV;;EAEA;;;;;;EAMA,kBAAkB;;;;;;EAMlB,wBAAwB;;;;;;cAOb,uBAAoB,oBAAsB;;;;;;;KA2C3C;;;;;;EAMV;;;;;;;EAOA,mBAAmB;;cAGR,gCAA6B,iBACvB,wBAAsB,UAC9B,iCACR;;;;;cAqVU,kBAAe,iBACX,oBACG,gBACF,gBAAc;;;;;;;;;cAenB,wBAAqB;;;;;;;;cAYrB,mBAAgB;;;;;;cAWhB,6BAA0B,iBACtB;;;;;;;cAwBJ,iCAA8B,iBAC1B,cACD,wBAAsB;;;;;;cAuBzB,kBAAe,iBACX,oBACG,gBACF,gBAAc,uBACT"}
+{"version":3,"file":"packageManager.d.ts","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"mappings":";;KAMY;;;;;KAMA;;;;;;;EAOV;;;;;EAKA;;;;;EAKA;;;;;;;;;;;;;;;EAeA;;;;;;;KAQU;;EAEV;;EAEA;;;;;;;;EAQA;;IAEE;;IAEA;;;;KAKQ;;EAEV;;EAEA;;;;;;EAMA,kBAAkB;;;;;;EAMlB,wBAAwB;;;;;;cAOb,uBAAoB,oBAAsB;;;;;;;KA2C3C;;;;;;EAMV;;;KAIU;;EAEV;;;;;;EAMA;;;;;;;;cASW,gCAAgC;;;;;;;;;;cA0EhC,4BAAyB,cACtB;;;;;;;;;;;;cAiBH,iBAAc,cAAkB;cAGhC,gCAA6B,iBACvB,wBAAsB,UAC9B,iCACR;;;;;cAkVU,kBAAe,iBACX,oBACG,gBACF,gBAAc;;;;;;;;;cAenB,wBAAqB;;;;;;;;cAYrB,mBAAgB;;;;;;cAWhB,6BAA0B,iBACtB;;;;;;;cAwBJ,iCAA8B,iBAC1B,cACD,wBAAsB;;;;;;cAuBzB,kBAAe,iBACX,oBACG,gBACF,gBAAc,uBACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/engine",
-  "version": "9.3.0",
+  "version": "9.3.2",
   "private": false,
   "description": "Scans and builds Intlayer declaration files into dictionaries based on Intlayer configuration.",
   "keywords": [
@@ -141,17 +141,17 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "9.3.0",
-    "@intlayer/config": "9.3.0",
-    "@intlayer/core": "9.3.0",
-    "@intlayer/dictionaries-entry": "9.3.0",
-    "@intlayer/remote-dictionaries-entry": "9.3.0",
-    "@intlayer/types": "9.3.0",
-    "@intlayer/unmerged-dictionaries-entry": "9.3.0",
+    "@intlayer/api": "9.3.2",
+    "@intlayer/config": "9.3.2",
+    "@intlayer/core": "9.3.2",
+    "@intlayer/dictionaries-entry": "9.3.2",
+    "@intlayer/remote-dictionaries-entry": "9.3.2",
+    "@intlayer/types": "9.3.2",
+    "@intlayer/unmerged-dictionaries-entry": "9.3.2",
     "@parcel/watcher": "2.6.0",
     "defu": "6.1.7",
     "fast-glob": "3.3.3",
-    "recast": "0.23.19",
+    "recast": "0.24.0",
     "simple-git": "3.36.0",
     "zod-to-ts": "2.1.0"
   },
@@ -167,7 +167,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "@intlayer/babel": "9.3.0"
+    "@intlayer/babel": "9.3.2"
   },
   "peerDependenciesMeta": {
     "@intlayer/babel": {