@intlayer/chokidar 8.9.5 → 8.9.6

package/dist/cjs/buildIntlayerDictionary/writeDynamicDictionary.cjs

@@ -6,6 +6,7 @@ const require_writeJsonIfChanged = require('../writeJsonIfChanged.cjs');
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let _intlayer_config_logger = require("@intlayer/config/logger");
+let _intlayer_config_utils = require("@intlayer/config/utils");
 let _intlayer_config_defaultValues = require("@intlayer/config/defaultValues");
 let _intlayer_core_plugins = require("@intlayer/core/plugins");
 
@@ -45,6 +46,7 @@ const writeDynamicDictionary = async (mergedDictionaries, configuration, formats
 		if (key === "undefined") return;
 		const localizedDictionariesPathsRecord = {};
 		const keyDir = (0, node_path.resolve)(dictDir, key);
+		(0, _intlayer_config_utils.assertPathWithin)(keyDir, dictDir);
 		await (0, node_fs_promises.mkdir)(keyDir, { recursive: true });
 		await require_utils_parallelize.parallelize(locales, async (locale) => {
 			const localizedDictionary = (0, _intlayer_core_plugins.getPerLocaleDictionary)(dictionaryEntry.dictionary, locale, defaultLocale);
@@ -61,8 +63,10 @@ const writeDynamicDictionary = async (mergedDictionaries, configuration, formats
 		await require_utils_parallelize.parallelize(formats, async (format) => {
 			const extension = format === "cjs" ? "cjs" : "mjs";
 			const content = generateDictionaryEntryPoint(key, locales, format);
-			await require_writeFileIfChanged.writeFileIfChanged((0, node_path.resolve)(dynamicDictionariesDir, `${key}.${extension}`), content).catch((err) => {
-				console.error(`Error creating dynamic ${(0, _intlayer_config_logger.colorizePath)((0, node_path.resolve)(dynamicDictionariesDir, `${key}.${extension}`))}:`, err);
+			const dynEntryPath = (0, node_path.resolve)(dynamicDictionariesDir, `${key}.${extension}`);
+			(0, _intlayer_config_utils.assertPathWithin)(dynEntryPath, dynamicDictionariesDir);
+			await require_writeFileIfChanged.writeFileIfChanged(dynEntryPath, content).catch((err) => {
+				console.error(`Error creating dynamic ${(0, _intlayer_config_logger.colorizePath)(dynEntryPath)}:`, err);
 			});
 		});
 	});

package/dist/cjs/buildIntlayerDictionary/writeDynamicDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeDynamicDictionary.cjs","names":["OUTPUT_FORMAT","parallelize","writeJsonIfChanged","writeFileIfChanged"],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { getPerLocaleDictionary } 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 { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { MergedDictionaryOutput } from './writeMergedDictionary';\n\nexport type DictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type LocalizedDictionaryResult = Partial<\n  Record<Locale, DictionaryResult>\n>;\n\nexport type LocalizedDictionaryOutput = Record<\n  string,\n  LocalizedDictionaryResult\n>;\n\nconst DICTIONARIES_SUBDIR = 'json'; // Necessary to add a static first dir for Turbopack\n\n/**\n * Generates the content of a dictionary entry point file.\n */\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n\n  const localeEntries = sortedLocales\n    .map((locale) =>\n      format === 'esm'\n        ? `  '${locale}': () => import('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json').then(m => m.default)`\n        : `  '${locale}': () => Promise.resolve(require('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json'))`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return `module.exports = {\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dynamic_dictionary/dictionaries/en_home.json\n * // .intlayer/dynamic_dictionary/dictionaries/fr_home.json\n * ```\n */\nexport const writeDynamicDictionary = async (\n  mergedDictionaries: MergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Merge dictionaries with the same key and write to dictionariesDir\n  await parallelize(\n    Object.entries(mergedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, dictionaryEntry]) => {\n      if (key === 'undefined') return;\n\n      const localizedDictionariesPathsRecord: LocalizedDictionaryResult = {};\n\n      const keyDir = resolve(dictDir, key);\n      await mkdir(keyDir, { recursive: true });\n\n      await parallelize(locales, async (locale) => {\n        const localizedDictionary = getPerLocaleDictionary(\n          dictionaryEntry.dictionary,\n          locale,\n          defaultLocale\n        );\n\n        // Directory structure: json/key/locale.json\n        const resultFilePath = resolve(keyDir, `${locale}.json`);\n\n        await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n          (err) => {\n            console.error(\n              `Error creating localized ${key}/${locale}.json:`,\n              err\n            );\n          }\n        );\n\n        localizedDictionariesPathsRecord[locale] = {\n          dictionaryPath: resultFilePath,\n          dictionary: localizedDictionary,\n        };\n      });\n\n      resultDictionariesPaths[key] = localizedDictionariesPathsRecord;\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateDictionaryEntryPoint(key, locales, format);\n\n        await writeFileIfChanged(\n          resolve(dynamicDictionariesDir, `${key}.${extension}`),\n          content\n        ).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(resolve(dynamicDictionariesDir, `${key}.${extension}`))}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;;;;AA2BA,MAAM,sBAAsB;;;;AAK5B,MAAa,gCACX,KACA,SACA,SAAwB,UACb;CAKX,MAAM,gBAJgB,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,MAC1C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAGD,CAChC,KAAK,WACJ,WAAW,QACP,MAAM,OAAO,qBAAqB,oBAAoB,GAAG,IAAI,GAAG,OAAO,gCACvE,MAAM,OAAO,sCAAsC,oBAAoB,GAAG,IAAI,GAAG,OAAO,UAC7F,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,sBAAsB,cAAc;CAIxC,OAAO,uBAAuB,cAAc;;;;;;;;;;;;;;;;;;AAmB9C,MAAa,yBAAyB,OACpC,oBACA,eACA,UAA6BA,iDACU;CACvC,MAAM,EAAE,SAAS,kBAAkB,cAAc;CACjD,MAAM,EAAE,2BAA2B,cAAc;CAEjD,MAAM,iCAAkB,wBAAwB,oBAAoB;CACpE,kCAAY,SAAS,EAAE,WAAW,MAAM,CAAC;CAEzC,MAAM,0BAAqD,EAAE;CAG7D,MAAMC,sCACJ,OAAO,QAAQ,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,OAC7C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CACnC,EACD,OAAO,CAAC,KAAK,qBAAqB;EAChC,IAAI,QAAQ,aAAa;EAEzB,MAAM,mCAA8D,EAAE;EAEtE,MAAM,gCAAiB,SAAS,IAAI;EACpC,kCAAY,QAAQ,EAAE,WAAW,MAAM,CAAC;EAExC,MAAMA,sCAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,yEACJ,gBAAgB,YAChB,QACA,cACD;GAGD,MAAM,wCAAyB,QAAQ,GAAG,OAAO,OAAO;GAExD,MAAMC,8CAAmB,gBAAgB,oBAAoB,CAAC,OAC3D,QAAQ;IACP,QAAQ,MACN,4BAA4B,IAAI,GAAG,OAAO,SAC1C,IACD;KAEJ;GAED,iCAAiC,UAAU;IACzC,gBAAgB;IAChB,YAAY;IACb;IACD;EAEF,wBAAwB,OAAO;EAE/B,MAAMD,sCAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BAA6B,KAAK,SAAS,OAAO;GAElE,MAAME,qEACI,wBAAwB,GAAG,IAAI,GAAG,YAAY,EACtD,QACD,CAAC,OAAO,QAAQ;IACf,QAAQ,MACN,2FAA+C,wBAAwB,GAAG,IAAI,GAAG,YAAY,CAAC,CAAC,IAC/F,IACD;KACD;IACF;GAEL;CAED,OAAO"}
+{"version":3,"file":"writeDynamicDictionary.cjs","names":["OUTPUT_FORMAT","parallelize","writeJsonIfChanged","writeFileIfChanged"],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport { getPerLocaleDictionary } 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 { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { MergedDictionaryOutput } from './writeMergedDictionary';\n\nexport type DictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type LocalizedDictionaryResult = Partial<\n  Record<Locale, DictionaryResult>\n>;\n\nexport type LocalizedDictionaryOutput = Record<\n  string,\n  LocalizedDictionaryResult\n>;\n\nconst DICTIONARIES_SUBDIR = 'json'; // Necessary to add a static first dir for Turbopack\n\n/**\n * Generates the content of a dictionary entry point file.\n */\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n\n  const localeEntries = sortedLocales\n    .map((locale) =>\n      format === 'esm'\n        ? `  '${locale}': () => import('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json').then(m => m.default)`\n        : `  '${locale}': () => Promise.resolve(require('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json'))`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return `module.exports = {\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dynamic_dictionary/dictionaries/en_home.json\n * // .intlayer/dynamic_dictionary/dictionaries/fr_home.json\n * ```\n */\nexport const writeDynamicDictionary = async (\n  mergedDictionaries: MergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Merge dictionaries with the same key and write to dictionariesDir\n  await parallelize(\n    Object.entries(mergedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, dictionaryEntry]) => {\n      if (key === 'undefined') return;\n\n      const localizedDictionariesPathsRecord: LocalizedDictionaryResult = {};\n\n      const keyDir = resolve(dictDir, key);\n      assertPathWithin(keyDir, dictDir);\n      await mkdir(keyDir, { recursive: true });\n\n      await parallelize(locales, async (locale) => {\n        const localizedDictionary = getPerLocaleDictionary(\n          dictionaryEntry.dictionary,\n          locale,\n          defaultLocale\n        );\n\n        // Directory structure: json/key/locale.json\n        const resultFilePath = resolve(keyDir, `${locale}.json`);\n\n        await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n          (err) => {\n            console.error(\n              `Error creating localized ${key}/${locale}.json:`,\n              err\n            );\n          }\n        );\n\n        localizedDictionariesPathsRecord[locale] = {\n          dictionaryPath: resultFilePath,\n          dictionary: localizedDictionary,\n        };\n      });\n\n      resultDictionariesPaths[key] = localizedDictionariesPathsRecord;\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateDictionaryEntryPoint(key, locales, format);\n\n        const dynEntryPath = resolve(\n          dynamicDictionariesDir,\n          `${key}.${extension}`\n        );\n        assertPathWithin(dynEntryPath, dynamicDictionariesDir);\n\n        await writeFileIfChanged(dynEntryPath, content).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(dynEntryPath)}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;;;;;AA4BA,MAAM,sBAAsB;;;;AAK5B,MAAa,gCACX,KACA,SACA,SAAwB,UACb;CAKX,MAAM,gBAJgB,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,MAC1C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAGD,CAChC,KAAK,WACJ,WAAW,QACP,MAAM,OAAO,qBAAqB,oBAAoB,GAAG,IAAI,GAAG,OAAO,gCACvE,MAAM,OAAO,sCAAsC,oBAAoB,GAAG,IAAI,GAAG,OAAO,UAC7F,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,sBAAsB,cAAc;CAIxC,OAAO,uBAAuB,cAAc;;;;;;;;;;;;;;;;;;AAmB9C,MAAa,yBAAyB,OACpC,oBACA,eACA,UAA6BA,iDACU;CACvC,MAAM,EAAE,SAAS,kBAAkB,cAAc;CACjD,MAAM,EAAE,2BAA2B,cAAc;CAEjD,MAAM,iCAAkB,wBAAwB,oBAAoB;CACpE,kCAAY,SAAS,EAAE,WAAW,MAAM,CAAC;CAEzC,MAAM,0BAAqD,EAAE;CAG7D,MAAMC,sCACJ,OAAO,QAAQ,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,OAC7C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CACnC,EACD,OAAO,CAAC,KAAK,qBAAqB;EAChC,IAAI,QAAQ,aAAa;EAEzB,MAAM,mCAA8D,EAAE;EAEtE,MAAM,gCAAiB,SAAS,IAAI;EACpC,6CAAiB,QAAQ,QAAQ;EACjC,kCAAY,QAAQ,EAAE,WAAW,MAAM,CAAC;EAExC,MAAMA,sCAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,yEACJ,gBAAgB,YAChB,QACA,cACD;GAGD,MAAM,wCAAyB,QAAQ,GAAG,OAAO,OAAO;GAExD,MAAMC,8CAAmB,gBAAgB,oBAAoB,CAAC,OAC3D,QAAQ;IACP,QAAQ,MACN,4BAA4B,IAAI,GAAG,OAAO,SAC1C,IACD;KAEJ;GAED,iCAAiC,UAAU;IACzC,gBAAgB;IAChB,YAAY;IACb;IACD;EAEF,wBAAwB,OAAO;EAE/B,MAAMD,sCAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BAA6B,KAAK,SAAS,OAAO;GAElE,MAAM,sCACJ,wBACA,GAAG,IAAI,GAAG,YACX;GACD,6CAAiB,cAAc,uBAAuB;GAEtD,MAAME,8CAAmB,cAAc,QAAQ,CAAC,OAAO,QAAQ;IAC7D,QAAQ,MACN,oEAAuC,aAAa,CAAC,IACrD,IACD;KACD;IACF;GAEL;CAED,OAAO"}

package/dist/cjs/buildIntlayerDictionary/writeFetchDictionary.cjs

@@ -43,8 +43,10 @@ const writeFetchDictionary = async (dynamicDictionaries, configuration, formats
 		await require_utils_parallelize.parallelize(formats, async (format) => {
 			const extension = format === "cjs" ? "cjs" : "mjs";
 			const content = generateDictionaryEntryPoint(key, locales, relativePrefix, format);
-			await require_writeFileIfChanged.writeFileIfChanged((0, node_path.resolve)(fetchDictionariesDir, `${key}.${extension}`), content).catch((err) => {
-				console.error(`Error creating fetch ${(0, _intlayer_config_logger.colorizePath)((0, node_path.resolve)(fetchDictionariesDir, `${key}.${extension}`))}:`, err);
+			const fetchEntryPath = (0, node_path.resolve)(fetchDictionariesDir, `${key}.${extension}`);
+			(0, _intlayer_config_utils.assertPathWithin)(fetchEntryPath, fetchDictionariesDir);
+			await require_writeFileIfChanged.writeFileIfChanged(fetchEntryPath, content).catch((err) => {
+				console.error(`Error creating fetch ${(0, _intlayer_config_logger.colorizePath)(fetchEntryPath)}:`, err);
 			});
 		});
 	});

package/dist/cjs/buildIntlayerDictionary/writeFetchDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeFetchDictionary.cjs","names":["OUTPUT_FORMAT","parallelize","writeFileIfChanged"],"sources":["../../../src/buildIntlayerDictionary/writeFetchDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { normalizePath } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport type { LocalizedDictionaryOutput } from './writeDynamicDictionary';\n\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  relativePrefix: string,\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const extension = format === 'cjs' ? 'cjs' : 'mjs';\n\n  const localeEntries = locales\n    .sort((a, b) => String(a).localeCompare(String(b)))\n    .map(\n      (locale) =>\n        `  '${locale}': async () => {\\n` +\n        `    try {\\n` +\n        `      const res = await fetch(\\`\\${editor.liveSyncURL}/dictionaries/${key}/${locale}\\`);\\n` +\n        `      return await res.json();\\n` +\n        `    } catch {\\n` +\n        `      return dynContent['${locale}']();\\n` +\n        `    }\\n` +\n        `  }`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `import { editor } from 'intlayer';\\n` +\n      `import dynContent from '${relativePrefix}/${key}.${extension}';\\n\\n` +\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return (\n    `const { editor } = require('intlayer');\\n` +\n    `const dynContent = require('${relativePrefix}/${key}.${extension}');\\n\\n` +\n    `module.exports = {\\n${localeEntries}\\n};\\n`\n  );\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/fetch_dictionary/home.mjs\n * // .intlayer/fetch_dictionary/home.cjs\n * ```\n */\nexport const writeFetchDictionary = async (\n  dynamicDictionaries: LocalizedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { fetchDictionariesDir, dynamicDictionariesDir } = configuration.system;\n  const { locales } = configuration.internationalization;\n\n  // Compute relative path from fetch dir to dynamic dir\n  let relativePrefix = normalizePath(\n    relative(fetchDictionariesDir, dynamicDictionariesDir)\n  );\n  if (!relativePrefix.startsWith('.')) {\n    relativePrefix = `./${relativePrefix}`;\n  }\n\n  await mkdir(resolve(fetchDictionariesDir), { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Write entry points for each dictionary in parallel\n  await parallelize(Object.entries(dynamicDictionaries), async ([key]) => {\n    if (key === 'undefined') return;\n\n    await parallelize(formats, async (format) => {\n      const extension = format === 'cjs' ? 'cjs' : 'mjs';\n      const content = generateDictionaryEntryPoint(\n        key,\n        locales,\n        relativePrefix,\n        format\n      );\n\n      await writeFileIfChanged(\n        resolve(fetchDictionariesDir, `${key}.${extension}`),\n        content\n      ).catch((err) => {\n        console.error(\n          `Error creating fetch ${colorizePath(resolve(fetchDictionariesDir, `${key}.${extension}`))}:`,\n          err\n        );\n      });\n    });\n  });\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,gCACX,KACA,SACA,gBACA,SAAwB,UACb;CACX,MAAM,YAAY,WAAW,QAAQ,QAAQ;CAE7C,MAAM,gBAAgB,QACnB,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC,CAClD,KACE,WACC,MAAM,OAAO,mGAE0D,IAAI,GAAG,OAAO,gFAGzD,OAAO,mBAGtC,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,+DAC2B,eAAe,GAAG,IAAI,GAAG,UAAU,2BACxC,cAAc;CAIxC,OACE,wEAC+B,eAAe,GAAG,IAAI,GAAG,UAAU,6BAC3C,cAAc;;;;;;;;;;;;;;;;;;AAoBzC,MAAa,uBAAuB,OAClC,qBACA,eACA,UAA6BA,iDACU;CACvC,MAAM,EAAE,sBAAsB,2BAA2B,cAAc;CACvE,MAAM,EAAE,YAAY,cAAc;CAGlC,IAAI,mFACO,sBAAsB,uBAAuB,CACvD;CACD,IAAI,CAAC,eAAe,WAAW,IAAI,EACjC,iBAAiB,KAAK;CAGxB,yDAAoB,qBAAqB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE/D,MAAM,0BAAqD,EAAE;CAG7D,MAAMC,sCAAY,OAAO,QAAQ,oBAAoB,EAAE,OAAO,CAAC,SAAS;EACtE,IAAI,QAAQ,aAAa;EAEzB,MAAMA,sCAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BACd,KACA,SACA,gBACA,OACD;GAED,MAAMC,qEACI,sBAAsB,GAAG,IAAI,GAAG,YAAY,EACpD,QACD,CAAC,OAAO,QAAQ;IACf,QAAQ,MACN,yFAA6C,sBAAsB,GAAG,IAAI,GAAG,YAAY,CAAC,CAAC,IAC3F,IACD;KACD;IACF;GACF;CAEF,OAAO"}
+{"version":3,"file":"writeFetchDictionary.cjs","names":["OUTPUT_FORMAT","parallelize","writeFileIfChanged"],"sources":["../../../src/buildIntlayerDictionary/writeFetchDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin, normalizePath } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport type { LocalizedDictionaryOutput } from './writeDynamicDictionary';\n\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  relativePrefix: string,\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const extension = format === 'cjs' ? 'cjs' : 'mjs';\n\n  const localeEntries = locales\n    .sort((a, b) => String(a).localeCompare(String(b)))\n    .map(\n      (locale) =>\n        `  '${locale}': async () => {\\n` +\n        `    try {\\n` +\n        `      const res = await fetch(\\`\\${editor.liveSyncURL}/dictionaries/${key}/${locale}\\`);\\n` +\n        `      return await res.json();\\n` +\n        `    } catch {\\n` +\n        `      return dynContent['${locale}']();\\n` +\n        `    }\\n` +\n        `  }`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `import { editor } from 'intlayer';\\n` +\n      `import dynContent from '${relativePrefix}/${key}.${extension}';\\n\\n` +\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return (\n    `const { editor } = require('intlayer');\\n` +\n    `const dynContent = require('${relativePrefix}/${key}.${extension}');\\n\\n` +\n    `module.exports = {\\n${localeEntries}\\n};\\n`\n  );\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/fetch_dictionary/home.mjs\n * // .intlayer/fetch_dictionary/home.cjs\n * ```\n */\nexport const writeFetchDictionary = async (\n  dynamicDictionaries: LocalizedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { fetchDictionariesDir, dynamicDictionariesDir } = configuration.system;\n  const { locales } = configuration.internationalization;\n\n  // Compute relative path from fetch dir to dynamic dir\n  let relativePrefix = normalizePath(\n    relative(fetchDictionariesDir, dynamicDictionariesDir)\n  );\n  if (!relativePrefix.startsWith('.')) {\n    relativePrefix = `./${relativePrefix}`;\n  }\n\n  await mkdir(resolve(fetchDictionariesDir), { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Write entry points for each dictionary in parallel\n  await parallelize(Object.entries(dynamicDictionaries), async ([key]) => {\n    if (key === 'undefined') return;\n\n    await parallelize(formats, async (format) => {\n      const extension = format === 'cjs' ? 'cjs' : 'mjs';\n      const content = generateDictionaryEntryPoint(\n        key,\n        locales,\n        relativePrefix,\n        format\n      );\n\n      const fetchEntryPath = resolve(\n        fetchDictionariesDir,\n        `${key}.${extension}`\n      );\n      assertPathWithin(fetchEntryPath, fetchDictionariesDir);\n\n      await writeFileIfChanged(fetchEntryPath, content).catch((err) => {\n        console.error(\n          `Error creating fetch ${colorizePath(fetchEntryPath)}:`,\n          err\n        );\n      });\n    });\n  });\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,gCACX,KACA,SACA,gBACA,SAAwB,UACb;CACX,MAAM,YAAY,WAAW,QAAQ,QAAQ;CAE7C,MAAM,gBAAgB,QACnB,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC,CAClD,KACE,WACC,MAAM,OAAO,mGAE0D,IAAI,GAAG,OAAO,gFAGzD,OAAO,mBAGtC,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,+DAC2B,eAAe,GAAG,IAAI,GAAG,UAAU,2BACxC,cAAc;CAIxC,OACE,wEAC+B,eAAe,GAAG,IAAI,GAAG,UAAU,6BAC3C,cAAc;;;;;;;;;;;;;;;;;;AAoBzC,MAAa,uBAAuB,OAClC,qBACA,eACA,UAA6BA,iDACU;CACvC,MAAM,EAAE,sBAAsB,2BAA2B,cAAc;CACvE,MAAM,EAAE,YAAY,cAAc;CAGlC,IAAI,mFACO,sBAAsB,uBAAuB,CACvD;CACD,IAAI,CAAC,eAAe,WAAW,IAAI,EACjC,iBAAiB,KAAK;CAGxB,yDAAoB,qBAAqB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE/D,MAAM,0BAAqD,EAAE;CAG7D,MAAMC,sCAAY,OAAO,QAAQ,oBAAoB,EAAE,OAAO,CAAC,SAAS;EACtE,IAAI,QAAQ,aAAa;EAEzB,MAAMA,sCAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BACd,KACA,SACA,gBACA,OACD;GAED,MAAM,wCACJ,sBACA,GAAG,IAAI,GAAG,YACX;GACD,6CAAiB,gBAAgB,qBAAqB;GAEtD,MAAMC,8CAAmB,gBAAgB,QAAQ,CAAC,OAAO,QAAQ;IAC/D,QAAQ,MACN,kEAAqC,eAAe,CAAC,IACrD,IACD;KACD;IACF;GACF;CAEF,OAAO"}

package/dist/cjs/buildIntlayerDictionary/writeMergedDictionary.cjs

@@ -5,6 +5,7 @@ const require_writeJsonIfChanged = require('../writeJsonIfChanged.cjs');
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let _intlayer_config_logger = require("@intlayer/config/logger");
+let _intlayer_config_utils = require("@intlayer/config/utils");
 let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/buildIntlayerDictionary/writeMergedDictionary.ts
@@ -31,6 +32,7 @@ const writeMergedDictionaries = async (groupedDictionaries, configuration) => {
 		if (key === "undefined") return;
 		const mergedDictionary = (0, _intlayer_core_dictionaryManipulator.mergeDictionaries)((0, _intlayer_core_dictionaryManipulator.normalizeDictionaries)(dictionariesEntry.dictionaries, configuration));
 		const resultFilePath = (0, node_path.resolve)(dictionariesDir, `${key}.json`);
+		(0, _intlayer_config_utils.assertPathWithin)(resultFilePath, dictionariesDir);
 		await require_writeJsonIfChanged.writeJsonIfChanged(resultFilePath, mergedDictionary).catch((err) => {
 			console.error(`Error creating merged ${(0, _intlayer_config_logger.colorizePath)(resultFilePath)}:`, err);
 		});

package/dist/cjs/buildIntlayerDictionary/writeMergedDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeMergedDictionary.cjs","names":["parallelize","writeJsonIfChanged"],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath } from '@intlayer/config/logger';\nimport {\n  mergeDictionaries,\n  normalizeDictionaries,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { UnmergedDictionaryOutput } from './writeUnmergedDictionary';\n\nexport type MergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type MergedDictionaryOutput = Record<string, MergedDictionaryResult>;\n\n/**\n * Write the merged dictionaries to the dictionariesDir\n * @param groupedDictionaries - The grouped dictionaries\n * @param configuration - The configuration\n * @returns The merged dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dictionary/home.json\n * // { key: 'home', content: { ... } },\n * ```\n */\nexport const writeMergedDictionaries = async (\n  groupedDictionaries: UnmergedDictionaryOutput,\n  configuration: IntlayerConfig\n): Promise<MergedDictionaryOutput> => {\n  const { dictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(dictionariesDir), { recursive: true });\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionariesEntry]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          MergedDictionaryResult,\n        ];\n      }\n\n      const normalizedDictionaries = normalizeDictionaries(\n        dictionariesEntry.dictionaries,\n        configuration\n      );\n\n      const mergedDictionary = mergeDictionaries(normalizedDictionaries);\n\n      const outputFileName = `${key}.json`;\n      const resultFilePath = resolve(dictionariesDir, outputFileName);\n\n      // Write the merged dictionary\n      await writeJsonIfChanged(resultFilePath, mergedDictionary).catch(\n        (err) => {\n          console.error(\n            `Error creating merged ${colorizePath(resultFilePath)}:`,\n            err\n          );\n        }\n      );\n\n      return [\n        key,\n        {\n          dictionaryPath: resultFilePath,\n          dictionary: mergedDictionary,\n        } as MergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<readonly [string, MergedDictionaryResult]>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,0BAA0B,OACrC,qBACA,kBACoC;CACpC,MAAM,EAAE,oBAAoB,cAAc;CAG1C,yDAAoB,gBAAgB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE1D,MAAM,UAAU,MAAMA,sCACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,uBAAuB;EAClC,IAAI,QAAQ,aACV;EAWF,MAAM,+IAJJ,kBAAkB,cAClB,cAG+D,CAAC;EAGlE,MAAM,wCAAyB,iBAAiB,GADtB,IAAI,OACiC;EAG/D,MAAMC,8CAAmB,gBAAgB,iBAAiB,CAAC,OACxD,QAAQ;GACP,QAAQ,MACN,mEAAsC,eAAe,CAAC,IACtD,IACD;IAEJ;EAED,OAAO,CACL,KACA;GACE,gBAAgB;GAChB,YAAY;GACb,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CACxB"}
+{"version":3,"file":"writeMergedDictionary.cjs","names":["parallelize","writeJsonIfChanged"],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport {\n  mergeDictionaries,\n  normalizeDictionaries,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { UnmergedDictionaryOutput } from './writeUnmergedDictionary';\n\nexport type MergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type MergedDictionaryOutput = Record<string, MergedDictionaryResult>;\n\n/**\n * Write the merged dictionaries to the dictionariesDir\n * @param groupedDictionaries - The grouped dictionaries\n * @param configuration - The configuration\n * @returns The merged dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dictionary/home.json\n * // { key: 'home', content: { ... } },\n * ```\n */\nexport const writeMergedDictionaries = async (\n  groupedDictionaries: UnmergedDictionaryOutput,\n  configuration: IntlayerConfig\n): Promise<MergedDictionaryOutput> => {\n  const { dictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(dictionariesDir), { recursive: true });\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionariesEntry]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          MergedDictionaryResult,\n        ];\n      }\n\n      const normalizedDictionaries = normalizeDictionaries(\n        dictionariesEntry.dictionaries,\n        configuration\n      );\n\n      const mergedDictionary = mergeDictionaries(normalizedDictionaries);\n\n      const outputFileName = `${key}.json`;\n      const resultFilePath = resolve(dictionariesDir, outputFileName);\n\n      assertPathWithin(resultFilePath, dictionariesDir);\n\n      // Write the merged dictionary\n      await writeJsonIfChanged(resultFilePath, mergedDictionary).catch(\n        (err) => {\n          console.error(\n            `Error creating merged ${colorizePath(resultFilePath)}:`,\n            err\n          );\n        }\n      );\n\n      return [\n        key,\n        {\n          dictionaryPath: resultFilePath,\n          dictionary: mergedDictionary,\n        } as MergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<readonly [string, MergedDictionaryResult]>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,0BAA0B,OACrC,qBACA,kBACoC;CACpC,MAAM,EAAE,oBAAoB,cAAc;CAG1C,yDAAoB,gBAAgB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE1D,MAAM,UAAU,MAAMA,sCACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,uBAAuB;EAClC,IAAI,QAAQ,aACV;EAWF,MAAM,+IAJJ,kBAAkB,cAClB,cAG+D,CAAC;EAGlE,MAAM,wCAAyB,iBAAiB,GADtB,IAAI,OACiC;EAE/D,6CAAiB,gBAAgB,gBAAgB;EAGjD,MAAMC,8CAAmB,gBAAgB,iBAAiB,CAAC,OACxD,QAAQ;GACP,QAAQ,MACN,mEAAsC,eAAe,CAAC,IACtD,IACD;IAEJ;EAED,OAAO,CACL,KACA;GACE,gBAAgB;GAChB,YAAY;GACb,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CACxB"}

package/dist/cjs/buildIntlayerDictionary/writeUnmergedDictionary.cjs

@@ -6,6 +6,7 @@ const require_filterInvalidDictionaries = require('../filterInvalidDictionaries.
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let _intlayer_config_logger = require("@intlayer/config/logger");
+let _intlayer_config_utils = require("@intlayer/config/utils");
 let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/buildIntlayerDictionary/writeUnmergedDictionary.ts
@@ -43,6 +44,7 @@ const writeUnmergedDictionaries = async (dictionaries, configuration, env) => {
 		if (key === "undefined") return;
 		const orderedDictionaries = (0, _intlayer_core_dictionaryManipulator.orderDictionaries)(dictionaries);
 		const unmergedFilePath = (0, node_path.resolve)(unmergedDictionariesDir, `${key}.json`);
+		(0, _intlayer_config_utils.assertPathWithin)(unmergedFilePath, unmergedDictionariesDir);
 		if (configuration.editor.enabled || env === "dev") await require_writeJsonIfChanged.writeJsonIfChanged(unmergedFilePath, orderedDictionaries).catch((err) => {
 			console.error(`${_intlayer_config_logger.x} Error creating unmerged ${(0, _intlayer_config_logger.colorizePath)(unmergedFilePath)}:`, err);
 		});

package/dist/cjs/buildIntlayerDictionary/writeUnmergedDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeUnmergedDictionary.cjs","names":["filterInvalidDictionaries","parallelize","writeJsonIfChanged","x"],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath, x } from '@intlayer/config/logger';\nimport { orderDictionaries } from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, DictionaryKey } from '@intlayer/types/dictionary';\nimport { filterInvalidDictionaries } from '../filterInvalidDictionaries';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\n\nexport const groupDictionariesByKey = (\n  dictionaries: Dictionary[]\n): Record<string, Dictionary[]> =>\n  dictionaries.reduce(\n    (acc, dictionary) => {\n      const key = dictionary.key;\n      if (!acc[key]) {\n        acc[key] = [];\n      }\n      acc[key].push(dictionary);\n      return acc;\n    },\n    {} as Record<string, Dictionary[]>\n  );\n\nexport type UnmergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionaries: Dictionary[];\n};\n\nexport type UnmergedDictionaryOutput = Record<\n  DictionaryKey,\n  UnmergedDictionaryResult\n>;\n\n/**\n * Write the unmerged dictionaries to the unmergedDictionariesDir\n * @param dictionaries - The dictionaries to write\n * @param configuration - The configuration\n * @returns The grouped dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * console.log(unmergedDictionaries);\n *\n * // .intlayer/unmerged_dictionaries/home.json\n * // {\n * //   [\n * //     { key: 'home', content: { ... } },\n * //     { key: 'home', content: { ... } },\n * //   ],\n * // }\n * ```\n */\nexport const writeUnmergedDictionaries = async (\n  dictionaries: Dictionary[],\n  configuration: IntlayerConfig,\n  env: 'prod' | 'dev'\n): Promise<UnmergedDictionaryOutput> => {\n  const { unmergedDictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(unmergedDictionariesDir), { recursive: true });\n\n  const filteredDictionaries = filterInvalidDictionaries(\n    dictionaries,\n    configuration,\n    { checkSchema: true }\n  );\n\n  //  Group dictionaries by key and write to unmergedDictionariesDir\n  const groupedDictionaries = groupDictionariesByKey(filteredDictionaries);\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionaries]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          UnmergedDictionaryResult,\n        ];\n      }\n\n      const orderedDictionaries = orderDictionaries(dictionaries);\n\n      const outputFileName = `${key}.json`;\n      const unmergedFilePath = resolve(unmergedDictionariesDir, outputFileName);\n\n      // Write the grouped dictionaries in disk if the editor is enabled\n      // To make work the visual editor on the server\n      // No need them if the editor is disabled\n      // But in local env (env: 'dev') we write them for the vscode extension\n      if (configuration.editor.enabled || env === 'dev') {\n        await writeJsonIfChanged(unmergedFilePath, orderedDictionaries).catch(\n          (err) => {\n            console.error(\n              `${x} Error creating unmerged ${colorizePath(unmergedFilePath)}:`,\n              err\n            );\n          }\n        );\n      }\n\n      return [\n        key,\n        {\n          dictionaryPath: unmergedFilePath,\n          dictionaries: dictionaries,\n        } as UnmergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<\n      readonly [string, UnmergedDictionaryResult]\n    >\n  );\n};\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,0BACX,iBAEA,aAAa,QACV,KAAK,eAAe;CACnB,MAAM,MAAM,WAAW;CACvB,IAAI,CAAC,IAAI,MACP,IAAI,OAAO,EAAE;CAEf,IAAI,KAAK,KAAK,WAAW;CACzB,OAAO;GAET,EAAE,CACH;;;;;;;;;;;;;;;;;;;;;AAgCH,MAAa,4BAA4B,OACvC,cACA,eACA,QACsC;CACtC,MAAM,EAAE,4BAA4B,cAAc;CAGlD,yDAAoB,wBAAwB,EAAE,EAAE,WAAW,MAAM,CAAC;CASlE,MAAM,sBAAsB,uBAPCA,4DAC3B,cACA,eACA,EAAE,aAAa,MAAM,CAIgD,CAAC;CAExE,MAAM,UAAU,MAAMC,sCACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,kBAAkB;EAC7B,IAAI,QAAQ,aACV;EAMF,MAAM,kFAAwC,aAAa;EAG3D,MAAM,0CAA2B,yBAAyB,GADhC,IAAI,OAC2C;EAMzE,IAAI,cAAc,OAAO,WAAW,QAAQ,OAC1C,MAAMC,8CAAmB,kBAAkB,oBAAoB,CAAC,OAC7D,QAAQ;GACP,QAAQ,MACN,GAAGC,0BAAE,qEAAwC,iBAAiB,CAAC,IAC/D,IACD;IAEJ;EAGH,OAAO,CACL,KACA;GACE,gBAAgB;GACF;GACf,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CAGxB"}
+{"version":3,"file":"writeUnmergedDictionary.cjs","names":["filterInvalidDictionaries","parallelize","writeJsonIfChanged","x"],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath, x } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport { orderDictionaries } from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, DictionaryKey } from '@intlayer/types/dictionary';\nimport { filterInvalidDictionaries } from '../filterInvalidDictionaries';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\n\nexport const groupDictionariesByKey = (\n  dictionaries: Dictionary[]\n): Record<string, Dictionary[]> =>\n  dictionaries.reduce(\n    (acc, dictionary) => {\n      const key = dictionary.key;\n      if (!acc[key]) {\n        acc[key] = [];\n      }\n      acc[key].push(dictionary);\n      return acc;\n    },\n    {} as Record<string, Dictionary[]>\n  );\n\nexport type UnmergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionaries: Dictionary[];\n};\n\nexport type UnmergedDictionaryOutput = Record<\n  DictionaryKey,\n  UnmergedDictionaryResult\n>;\n\n/**\n * Write the unmerged dictionaries to the unmergedDictionariesDir\n * @param dictionaries - The dictionaries to write\n * @param configuration - The configuration\n * @returns The grouped dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * console.log(unmergedDictionaries);\n *\n * // .intlayer/unmerged_dictionaries/home.json\n * // {\n * //   [\n * //     { key: 'home', content: { ... } },\n * //     { key: 'home', content: { ... } },\n * //   ],\n * // }\n * ```\n */\nexport const writeUnmergedDictionaries = async (\n  dictionaries: Dictionary[],\n  configuration: IntlayerConfig,\n  env: 'prod' | 'dev'\n): Promise<UnmergedDictionaryOutput> => {\n  const { unmergedDictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(unmergedDictionariesDir), { recursive: true });\n\n  const filteredDictionaries = filterInvalidDictionaries(\n    dictionaries,\n    configuration,\n    { checkSchema: true }\n  );\n\n  //  Group dictionaries by key and write to unmergedDictionariesDir\n  const groupedDictionaries = groupDictionariesByKey(filteredDictionaries);\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionaries]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          UnmergedDictionaryResult,\n        ];\n      }\n\n      const orderedDictionaries = orderDictionaries(dictionaries);\n\n      const outputFileName = `${key}.json`;\n      const unmergedFilePath = resolve(unmergedDictionariesDir, outputFileName);\n\n      assertPathWithin(unmergedFilePath, unmergedDictionariesDir);\n\n      // Write the grouped dictionaries in disk if the editor is enabled\n      // To make work the visual editor on the server\n      // No need them if the editor is disabled\n      // But in local env (env: 'dev') we write them for the vscode extension\n      if (configuration.editor.enabled || env === 'dev') {\n        await writeJsonIfChanged(unmergedFilePath, orderedDictionaries).catch(\n          (err) => {\n            console.error(\n              `${x} Error creating unmerged ${colorizePath(unmergedFilePath)}:`,\n              err\n            );\n          }\n        );\n      }\n\n      return [\n        key,\n        {\n          dictionaryPath: unmergedFilePath,\n          dictionaries: dictionaries,\n        } as UnmergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<\n      readonly [string, UnmergedDictionaryResult]\n    >\n  );\n};\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,0BACX,iBAEA,aAAa,QACV,KAAK,eAAe;CACnB,MAAM,MAAM,WAAW;CACvB,IAAI,CAAC,IAAI,MACP,IAAI,OAAO,EAAE;CAEf,IAAI,KAAK,KAAK,WAAW;CACzB,OAAO;GAET,EAAE,CACH;;;;;;;;;;;;;;;;;;;;;AAgCH,MAAa,4BAA4B,OACvC,cACA,eACA,QACsC;CACtC,MAAM,EAAE,4BAA4B,cAAc;CAGlD,yDAAoB,wBAAwB,EAAE,EAAE,WAAW,MAAM,CAAC;CASlE,MAAM,sBAAsB,uBAPCA,4DAC3B,cACA,eACA,EAAE,aAAa,MAAM,CAIgD,CAAC;CAExE,MAAM,UAAU,MAAMC,sCACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,kBAAkB;EAC7B,IAAI,QAAQ,aACV;EAMF,MAAM,kFAAwC,aAAa;EAG3D,MAAM,0CAA2B,yBAAyB,GADhC,IAAI,OAC2C;EAEzE,6CAAiB,kBAAkB,wBAAwB;EAM3D,IAAI,cAAc,OAAO,WAAW,QAAQ,OAC1C,MAAMC,8CAAmB,kBAAkB,oBAAoB,CAAC,OAC7D,QAAQ;GACP,QAAQ,MACN,GAAGC,0BAAE,qEAAwC,iBAAiB,CAAC,IAC/D,IACD;IAEJ;EAGH,OAAO,CACL,KACA;GACE,gBAAgB;GACF;GACf,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CAGxB"}

package/dist/cjs/installSkills/index.cjs

@@ -230,11 +230,14 @@ const getLicenceContent = () => {
 		return "";
 	}
 };
+const ALLOWED_FETCH_HOSTS = new Set(["intlayer.org"]);
 /**
 * Fetches the content of a URL using native fetch.
 */
 const fetchUrlContent = async (url) => {
-	const response = await fetch(url);
+	const parsed = new URL(url);
+	if (parsed.protocol !== "https:" || !ALLOWED_FETCH_HOSTS.has(parsed.hostname)) throw new Error(`Blocked fetch to disallowed host: ${parsed.hostname}`);
+	const response = await fetch(url, { redirect: "error" });
 	if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
 	return response.text();
 };
@@ -252,7 +255,7 @@ const installSkills = async (projectRoot, platform, skills) => {
 		const skillName = `intlayer-${SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill)}`;
 		const skillContent = getSkillContent(skill);
 		if (!skillContent) continue;
-		const urls = Array.from(new Set(skillContent.match(/https:\/\/intlayer\.org\/doc\/[^\s)]+\.md/g) || []));
+		const urls = Array.from(new Set(skillContent.match(/https:\/\/intlayer\.org\/[^\s)]+\.md/g) || []));
 		const skillDir = node_path.default.join(skillsBaseDir, skillName);
 		const referenceDir = node_path.default.join(skillDir, "references");
 		await node_fs.promises.mkdir(referenceDir, { recursive: true });

package/dist/cjs/installSkills/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["readAsset","path","fs","v"],"sources":["../../../src/installSkills/index.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport { v } from '@intlayer/config/logger';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\n\n/**\n * Metadata for each available documentation skill.\n */\nexport const SKILLS_METADATA = {\n  Config: 'Intlayer configuration documentation',\n  Content: 'Reference for all Intlayer content node types (t, enu, etc.)',\n  Usage: 'How to use Intlayer in your project',\n  CLI: 'Intlayer CLI commands and usage',\n  Compiler:\n    'Intlayer Compiler setup and usage for automatic content extraction without .content files',\n  RemoteContent: 'How to use Intlayer with Remote/CMS/Server-side content',\n  NextJS: 'Next.js-specific usage (Server & Client components)',\n  React: 'React-specific syntax and hooks usage',\n  Vue: 'Vue-specific composables and syntax',\n  Svelte: 'Svelte-specific stores and syntax',\n  Angular: 'Angular-specific syntax and Injectable Function usage',\n  Preact: 'Preact-specific syntax and hooks usage',\n  Solid:\n    'Integrates Intlayer internationalization with SolidJS components. Use when the user asks to \"setup SolidJS i18n\", use the \"useIntlayer\" hook in Solid, or manage locales in a SolidJS application.',\n  Astro: 'Astro-specific usage and getIntlayer',\n} as const;\n\nexport type Skill = keyof typeof SKILLS_METADATA;\n\nexport const SKILLS = Object.keys(SKILLS_METADATA) as Skill[];\n\nexport const getInitialSkills = (\n  deps: Record<string, string>\n): (keyof typeof SKILLS_METADATA)[] => {\n  const skills: (keyof typeof SKILLS_METADATA)[] = [\n    'Usage',\n    'Content',\n    'Config',\n    'CLI',\n    'Compiler',\n  ];\n\n  if (deps.next) skills.push('NextJS');\n  if (deps.react || !deps.next) skills.push('React');\n  if (deps.preact) skills.push('Preact');\n  if (deps['solid-js']) skills.push('Solid');\n  if (deps.vue || deps.nuxt) skills.push('Vue');\n  if (deps.svelte || deps['@sveltejs/kit']) skills.push('Svelte');\n  if (deps.astro) skills.push('Astro');\n\n  return skills;\n};\n\nexport interface PlatformMetadata {\n  label: string;\n  dir: string;\n  check?: () => boolean;\n}\n\n/**\n * Metadata and configuration for each supported platform.\n */\nexport const PLATFORMS_METADATA: Record<string, PlatformMetadata> = {\n  Cursor: {\n    label: 'Cursor',\n    dir: '.cursor/skills',\n    check: () =>\n      process.env.CURSOR === 'true' || process.env.TERM_PROGRAM === 'cursor',\n  },\n  Windsurf: {\n    label: 'Windsurf',\n    dir: '.windsurf/skills',\n    check: () =>\n      process.env.WINDSURF === 'true' ||\n      process.env.TERM_PROGRAM === 'windsurf',\n  },\n  Trae: {\n    label: 'Trae',\n    dir: '.trae/skills',\n    check: () =>\n      process.env.TRAE === 'true' || process.env.TERM_PROGRAM === 'trae',\n  },\n  TraeCN: {\n    label: 'Trae CN',\n    dir: '.trae/skills',\n    check: () => process.env.TRAE_CN === 'true',\n  },\n  VSCode: {\n    label: 'VS Code',\n    dir: '.vscode/skills',\n    check: () =>\n      process.env.VSCODE === 'true' || process.env.TERM_PROGRAM === 'vscode',\n  },\n  OpenCode: {\n    label: 'OpenCode',\n    dir: '.opencode/skills',\n    check: () => process.env.OPENCODE === 'true',\n  },\n  Claude: {\n    label: 'Claude Code',\n    dir: '.claude/skills',\n    check: () => process.env.CLAUDE === 'true',\n  },\n  GitHub: {\n    label: 'GitHub Copilot Workspace',\n    dir: '.github/skills',\n    check: () =>\n      process.env.GITHUB_ACTIONS === 'true' || !!process.env.GITHUB_WORKSPACE,\n  },\n  Antigravity: {\n    label: 'Antigravity',\n    dir: '.agent/skills',\n  },\n  Augment: {\n    label: 'Augment',\n    dir: '.augment/skills',\n  },\n  OpenClaw: {\n    label: 'OpenClaw',\n    dir: 'skills',\n  },\n  Cline: {\n    label: 'Cline',\n    dir: '.cline/skills',\n  },\n  CodeBuddy: {\n    label: 'CodeBuddy',\n    dir: '.codebuddy/skills',\n  },\n  CommandCode: {\n    label: 'Command Code',\n    dir: '.commandcode/skills',\n  },\n  Continue: {\n    label: 'Continue',\n    dir: '.continue/skills',\n  },\n  Crush: {\n    label: 'Crush',\n    dir: '.crush/skills',\n  },\n  Droid: {\n    label: 'Droid',\n    dir: '.factory/skills',\n  },\n  Goose: {\n    label: 'Goose',\n    dir: '.goose/skills',\n  },\n  IFlow: {\n    label: 'iFlow CLI',\n    dir: '.iflow/skills',\n  },\n  Junie: {\n    label: 'Junie',\n    dir: '.junie/skills',\n  },\n  KiloCode: {\n    label: 'Kilo Code',\n    dir: '.kilocode/skills',\n  },\n  Kiro: {\n    label: 'Kiro CLI',\n    dir: '.kiro/skills',\n  },\n  Kode: {\n    label: 'Kode',\n    dir: '.kode/skills',\n  },\n  MCPJam: {\n    label: 'MCPJam',\n    dir: '.mcpjam/skills',\n  },\n  MistralVibe: {\n    label: 'Mistral Vibe',\n    dir: '.vibe/skills',\n  },\n  Mux: {\n    label: 'Mux',\n    dir: '.mux/skills',\n  },\n  OpenHands: {\n    label: 'OpenHands',\n    dir: '.openhands/skills',\n  },\n  Pi: {\n    label: 'Pi',\n    dir: '.pi/skills',\n  },\n  Qoder: {\n    label: 'Qoder',\n    dir: '.qoder/skills',\n  },\n  Qwen: {\n    label: 'Qwen Code',\n    dir: '.qwen/skills',\n  },\n  RooCode: {\n    label: 'Roo Code',\n    dir: '.roo/skills',\n  },\n  Zencoder: {\n    label: 'Zencoder',\n    dir: '.zencoder/skills',\n  },\n  Neovate: {\n    label: 'Neovate',\n    dir: '.neovate/skills',\n  },\n  Pochi: {\n    label: 'Pochi',\n    dir: '.pochi/skills',\n  },\n  Other: {\n    label: 'Other',\n    dir: 'skills',\n  },\n} as const;\n\nexport type Platform = keyof typeof PLATFORMS_METADATA;\n\nexport const PLATFORMS = Object.keys(PLATFORMS_METADATA) as Platform[];\n\n/**\n * Maps specific skill keys to special filenames if they differ from standard snake_case.\n */\nconst SKILL_FILENAME_MAP: Partial<Record<Skill, string>> = {};\n\n/**\n * Helper to convert CamelCase to kebab-case for directory naming\n */\nconst camelToKebabCase = (str: string) =>\n  str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\n/**\n * Reads the raw markdown content for a specific skill from the assets folder.\n */\nconst getSkillContent = (skill: Skill): string => {\n  const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n  const fileName = `./skills/${baseName}.md`;\n\n  try {\n    return readAsset(fileName);\n  } catch {\n    console.warn(\n      `Warning: Could not read asset for skill: ${skill} at ${fileName}`\n    );\n    return '';\n  }\n};\n\n/**\n * Reads the licence content from the assets folder.\n */\nconst getLicenceContent = (): string => {\n  try {\n    return readAsset('./LICENCE.md');\n  } catch {\n    console.warn('Warning: Could not read LICENCE.md asset');\n    return '';\n  }\n};\n\n/**\n * Fetches the content of a URL using native fetch.\n */\nconst fetchUrlContent = async (url: string): Promise<string> => {\n  const response = await fetch(url);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.statusText}`);\n  }\n  return response.text();\n};\n\n/**\n * Installs skills using the \"Agent Skills\" directory standard.\n * Standard: <PROJECT_ROOT>/<CONFIG_DIR>/skills/<SKILL_NAME>/SKILL.md\n */\nexport const installSkills = async (\n  projectRoot: string,\n  platform: Platform,\n  skills: Skill[]\n): Promise<string> => {\n  // Determine destination directory\n  const relativeDir = PLATFORMS_METADATA[platform].dir ?? 'skills';\n  const skillsBaseDir = path.join(projectRoot, relativeDir);\n\n  // Ensure the base directory exists\n  await fs.mkdir(skillsBaseDir, { recursive: true });\n\n  const createdSkills: string[] = [];\n  const licenceContent = getLicenceContent();\n\n  for (const skill of skills) {\n    const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n    const skillName = `intlayer-${baseName}`;\n    const skillContent = getSkillContent(skill);\n\n    if (!skillContent) continue;\n\n    // Extract unique URLs\n    const urls = Array.from(\n      new Set(\n        skillContent.match(/https:\\/\\/intlayer\\.org\\/doc\\/[^\\s)]+\\.md/g) || []\n      )\n    );\n\n    // Agent Standard: .../skills/<skill-name>/SKILL.md\n    const skillDir = path.join(skillsBaseDir, skillName);\n    const referenceDir = path.join(skillDir, 'references');\n\n    // Ensure directories exist\n    await fs.mkdir(referenceDir, { recursive: true });\n\n    // Write License\n    if (licenceContent) {\n      await fs.writeFile(\n        path.join(skillDir, 'LICENCE.md'),\n        licenceContent,\n        'utf-8'\n      );\n    }\n\n    let updatedSkillContent = skillContent;\n\n    // Parallel download of references\n    const downloadPromises = urls.map(async (url) => {\n      try {\n        const content = await fetchUrlContent(url);\n        const metadata = getMarkdownMetadata<{ slugs?: string[] }>(content);\n\n        let fileName = '';\n\n        // Determine filename from slugs or URL path\n        if (Array.isArray(metadata.slugs)) {\n          fileName = metadata.slugs.filter((slug) => slug !== 'doc').join('_');\n        } else {\n          const urlPath = new URL(url).pathname;\n          fileName = urlPath\n            .split('/')\n            .filter((part) => part && part !== 'doc')\n            .map((part) => part.replace('.md', '')) // Clean extension for joining\n            .join('_');\n        }\n\n        // Ensure it ends with .md\n        fileName = fileName ? `${fileName}.md` : 'index.md';\n        const localRefPath = `references/${fileName}`;\n\n        return {\n          url,\n          localRefPath,\n          fileName,\n          content,\n          success: true,\n        };\n      } catch (error) {\n        console.warn(\n          `Warning: Failed to download ref ${url} for skill ${skill}`,\n          error\n        );\n        return { url, success: false };\n      }\n    });\n\n    const results = await Promise.all(downloadPromises);\n\n    // Process results: Write files and update content string\n    for (const res of results) {\n      if (res.success && res.fileName && res.content && res.localRefPath) {\n        // Write the reference file\n        await fs.writeFile(\n          path.join(referenceDir, res.fileName),\n          res.content,\n          'utf-8'\n        );\n\n        // Update the main content to point to local file\n        updatedSkillContent = updatedSkillContent.replaceAll(\n          res.url,\n          res.localRefPath\n        );\n      }\n    }\n\n    // Write the main SKILL.md\n    const filePath = path.join(skillDir, 'SKILL.md');\n    await fs.writeFile(filePath, updatedSkillContent, 'utf-8');\n    createdSkills.push(`${skillName}/SKILL.md`);\n  }\n\n  if (createdSkills.length === 0) {\n    return `No skill files were created. Check your asset paths.`;\n  }\n\n  return `${v} Created ${createdSkills.length} skills in ${skillsBaseDir}`;\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["readAsset","path","fs","v"],"sources":["../../../src/installSkills/index.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport { v } from '@intlayer/config/logger';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\n\n/**\n * Metadata for each available documentation skill.\n */\nexport const SKILLS_METADATA = {\n  Config: 'Intlayer configuration documentation',\n  Content: 'Reference for all Intlayer content node types (t, enu, etc.)',\n  Usage: 'How to use Intlayer in your project',\n  CLI: 'Intlayer CLI commands and usage',\n  Compiler:\n    'Intlayer Compiler setup and usage for automatic content extraction without .content files',\n  RemoteContent: 'How to use Intlayer with Remote/CMS/Server-side content',\n  NextJS: 'Next.js-specific usage (Server & Client components)',\n  React: 'React-specific syntax and hooks usage',\n  Vue: 'Vue-specific composables and syntax',\n  Svelte: 'Svelte-specific stores and syntax',\n  Angular: 'Angular-specific syntax and Injectable Function usage',\n  Preact: 'Preact-specific syntax and hooks usage',\n  Solid:\n    'Integrates Intlayer internationalization with SolidJS components. Use when the user asks to \"setup SolidJS i18n\", use the \"useIntlayer\" hook in Solid, or manage locales in a SolidJS application.',\n  Astro: 'Astro-specific usage and getIntlayer',\n} as const;\n\nexport type Skill = keyof typeof SKILLS_METADATA;\n\nexport const SKILLS = Object.keys(SKILLS_METADATA) as Skill[];\n\nexport const getInitialSkills = (\n  deps: Record<string, string>\n): (keyof typeof SKILLS_METADATA)[] => {\n  const skills: (keyof typeof SKILLS_METADATA)[] = [\n    'Usage',\n    'Content',\n    'Config',\n    'CLI',\n    'Compiler',\n  ];\n\n  if (deps.next) skills.push('NextJS');\n  if (deps.react || !deps.next) skills.push('React');\n  if (deps.preact) skills.push('Preact');\n  if (deps['solid-js']) skills.push('Solid');\n  if (deps.vue || deps.nuxt) skills.push('Vue');\n  if (deps.svelte || deps['@sveltejs/kit']) skills.push('Svelte');\n  if (deps.astro) skills.push('Astro');\n\n  return skills;\n};\n\nexport interface PlatformMetadata {\n  label: string;\n  dir: string;\n  check?: () => boolean;\n}\n\n/**\n * Metadata and configuration for each supported platform.\n */\nexport const PLATFORMS_METADATA: Record<string, PlatformMetadata> = {\n  Cursor: {\n    label: 'Cursor',\n    dir: '.cursor/skills',\n    check: () =>\n      process.env.CURSOR === 'true' || process.env.TERM_PROGRAM === 'cursor',\n  },\n  Windsurf: {\n    label: 'Windsurf',\n    dir: '.windsurf/skills',\n    check: () =>\n      process.env.WINDSURF === 'true' ||\n      process.env.TERM_PROGRAM === 'windsurf',\n  },\n  Trae: {\n    label: 'Trae',\n    dir: '.trae/skills',\n    check: () =>\n      process.env.TRAE === 'true' || process.env.TERM_PROGRAM === 'trae',\n  },\n  TraeCN: {\n    label: 'Trae CN',\n    dir: '.trae/skills',\n    check: () => process.env.TRAE_CN === 'true',\n  },\n  VSCode: {\n    label: 'VS Code',\n    dir: '.vscode/skills',\n    check: () =>\n      process.env.VSCODE === 'true' || process.env.TERM_PROGRAM === 'vscode',\n  },\n  OpenCode: {\n    label: 'OpenCode',\n    dir: '.opencode/skills',\n    check: () => process.env.OPENCODE === 'true',\n  },\n  Claude: {\n    label: 'Claude Code',\n    dir: '.claude/skills',\n    check: () => process.env.CLAUDE === 'true',\n  },\n  GitHub: {\n    label: 'GitHub Copilot Workspace',\n    dir: '.github/skills',\n    check: () =>\n      process.env.GITHUB_ACTIONS === 'true' || !!process.env.GITHUB_WORKSPACE,\n  },\n  Antigravity: {\n    label: 'Antigravity',\n    dir: '.agent/skills',\n  },\n  Augment: {\n    label: 'Augment',\n    dir: '.augment/skills',\n  },\n  OpenClaw: {\n    label: 'OpenClaw',\n    dir: 'skills',\n  },\n  Cline: {\n    label: 'Cline',\n    dir: '.cline/skills',\n  },\n  CodeBuddy: {\n    label: 'CodeBuddy',\n    dir: '.codebuddy/skills',\n  },\n  CommandCode: {\n    label: 'Command Code',\n    dir: '.commandcode/skills',\n  },\n  Continue: {\n    label: 'Continue',\n    dir: '.continue/skills',\n  },\n  Crush: {\n    label: 'Crush',\n    dir: '.crush/skills',\n  },\n  Droid: {\n    label: 'Droid',\n    dir: '.factory/skills',\n  },\n  Goose: {\n    label: 'Goose',\n    dir: '.goose/skills',\n  },\n  IFlow: {\n    label: 'iFlow CLI',\n    dir: '.iflow/skills',\n  },\n  Junie: {\n    label: 'Junie',\n    dir: '.junie/skills',\n  },\n  KiloCode: {\n    label: 'Kilo Code',\n    dir: '.kilocode/skills',\n  },\n  Kiro: {\n    label: 'Kiro CLI',\n    dir: '.kiro/skills',\n  },\n  Kode: {\n    label: 'Kode',\n    dir: '.kode/skills',\n  },\n  MCPJam: {\n    label: 'MCPJam',\n    dir: '.mcpjam/skills',\n  },\n  MistralVibe: {\n    label: 'Mistral Vibe',\n    dir: '.vibe/skills',\n  },\n  Mux: {\n    label: 'Mux',\n    dir: '.mux/skills',\n  },\n  OpenHands: {\n    label: 'OpenHands',\n    dir: '.openhands/skills',\n  },\n  Pi: {\n    label: 'Pi',\n    dir: '.pi/skills',\n  },\n  Qoder: {\n    label: 'Qoder',\n    dir: '.qoder/skills',\n  },\n  Qwen: {\n    label: 'Qwen Code',\n    dir: '.qwen/skills',\n  },\n  RooCode: {\n    label: 'Roo Code',\n    dir: '.roo/skills',\n  },\n  Zencoder: {\n    label: 'Zencoder',\n    dir: '.zencoder/skills',\n  },\n  Neovate: {\n    label: 'Neovate',\n    dir: '.neovate/skills',\n  },\n  Pochi: {\n    label: 'Pochi',\n    dir: '.pochi/skills',\n  },\n  Other: {\n    label: 'Other',\n    dir: 'skills',\n  },\n} as const;\n\nexport type Platform = keyof typeof PLATFORMS_METADATA;\n\nexport const PLATFORMS = Object.keys(PLATFORMS_METADATA) as Platform[];\n\n/**\n * Maps specific skill keys to special filenames if they differ from standard snake_case.\n */\nconst SKILL_FILENAME_MAP: Partial<Record<Skill, string>> = {};\n\n/**\n * Helper to convert CamelCase to kebab-case for directory naming\n */\nconst camelToKebabCase = (str: string) =>\n  str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\n/**\n * Reads the raw markdown content for a specific skill from the assets folder.\n */\nconst getSkillContent = (skill: Skill): string => {\n  const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n  const fileName = `./skills/${baseName}.md`;\n\n  try {\n    return readAsset(fileName);\n  } catch {\n    console.warn(\n      `Warning: Could not read asset for skill: ${skill} at ${fileName}`\n    );\n    return '';\n  }\n};\n\n/**\n * Reads the licence content from the assets folder.\n */\nconst getLicenceContent = (): string => {\n  try {\n    return readAsset('./LICENCE.md');\n  } catch {\n    console.warn('Warning: Could not read LICENCE.md asset');\n    return '';\n  }\n};\n\nconst ALLOWED_FETCH_HOSTS = new Set(['intlayer.org']);\n\n/**\n * Fetches the content of a URL using native fetch.\n */\nconst fetchUrlContent = async (url: string): Promise<string> => {\n  const parsed = new URL(url);\n  if (\n    parsed.protocol !== 'https:' ||\n    !ALLOWED_FETCH_HOSTS.has(parsed.hostname)\n  ) {\n    throw new Error(`Blocked fetch to disallowed host: ${parsed.hostname}`);\n  }\n  const response = await fetch(url, { redirect: 'error' });\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.statusText}`);\n  }\n  return response.text();\n};\n\n/**\n * Installs skills using the \"Agent Skills\" directory standard.\n * Standard: <PROJECT_ROOT>/<CONFIG_DIR>/skills/<SKILL_NAME>/SKILL.md\n */\nexport const installSkills = async (\n  projectRoot: string,\n  platform: Platform,\n  skills: Skill[]\n): Promise<string> => {\n  // Determine destination directory\n  const relativeDir = PLATFORMS_METADATA[platform].dir ?? 'skills';\n  const skillsBaseDir = path.join(projectRoot, relativeDir);\n\n  // Ensure the base directory exists\n  await fs.mkdir(skillsBaseDir, { recursive: true });\n\n  const createdSkills: string[] = [];\n  const licenceContent = getLicenceContent();\n\n  for (const skill of skills) {\n    const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n    const skillName = `intlayer-${baseName}`;\n    const skillContent = getSkillContent(skill);\n\n    if (!skillContent) continue;\n\n    // Extract unique URLs\n    const urls = Array.from(\n      new Set(skillContent.match(/https:\\/\\/intlayer\\.org\\/[^\\s)]+\\.md/g) || [])\n    );\n\n    // Agent Standard: .../skills/<skill-name>/SKILL.md\n    const skillDir = path.join(skillsBaseDir, skillName);\n    const referenceDir = path.join(skillDir, 'references');\n\n    // Ensure directories exist\n    await fs.mkdir(referenceDir, { recursive: true });\n\n    // Write License\n    if (licenceContent) {\n      await fs.writeFile(\n        path.join(skillDir, 'LICENCE.md'),\n        licenceContent,\n        'utf-8'\n      );\n    }\n\n    let updatedSkillContent = skillContent;\n\n    // Parallel download of references\n    const downloadPromises = urls.map(async (url) => {\n      try {\n        const content = await fetchUrlContent(url);\n        const metadata = getMarkdownMetadata<{ slugs?: string[] }>(content);\n\n        let fileName = '';\n\n        // Determine filename from slugs or URL path\n        if (Array.isArray(metadata.slugs)) {\n          fileName = metadata.slugs.filter((slug) => slug !== 'doc').join('_');\n        } else {\n          const urlPath = new URL(url).pathname;\n          fileName = urlPath\n            .split('/')\n            .filter((part) => part && part !== 'doc')\n            .map((part) => part.replace('.md', '')) // Clean extension for joining\n            .join('_');\n        }\n\n        // Ensure it ends with .md\n        fileName = fileName ? `${fileName}.md` : 'index.md';\n        const localRefPath = `references/${fileName}`;\n\n        return {\n          url,\n          localRefPath,\n          fileName,\n          content,\n          success: true,\n        };\n      } catch (error) {\n        console.warn(\n          `Warning: Failed to download ref ${url} for skill ${skill}`,\n          error\n        );\n        return { url, success: false };\n      }\n    });\n\n    const results = await Promise.all(downloadPromises);\n\n    // Process results: Write files and update content string\n    for (const res of results) {\n      if (res.success && res.fileName && res.content && res.localRefPath) {\n        // Write the reference file\n        await fs.writeFile(\n          path.join(referenceDir, res.fileName),\n          res.content,\n          'utf-8'\n        );\n\n        // Update the main content to point to local file\n        updatedSkillContent = updatedSkillContent.replaceAll(\n          res.url,\n          res.localRefPath\n        );\n      }\n    }\n\n    // Write the main SKILL.md\n    const filePath = path.join(skillDir, 'SKILL.md');\n    await fs.writeFile(filePath, updatedSkillContent, 'utf-8');\n    createdSkills.push(`${skillName}/SKILL.md`);\n  }\n\n  if (createdSkills.length === 0) {\n    return `No skill files were created. Check your asset paths.`;\n  }\n\n  return `${v} Created ${createdSkills.length} skills in ${skillsBaseDir}`;\n};\n"],"mappings":"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"}

package/dist/esm/buildIntlayerDictionary/writeDynamicDictionary.mjs

@@ -4,6 +4,7 @@ import { writeJsonIfChanged } from "../writeJsonIfChanged.mjs";
 import { mkdir } from "node:fs/promises";
 import { resolve } from "node:path";
 import { colorizePath } from "@intlayer/config/logger";
+import { assertPathWithin } from "@intlayer/config/utils";
 import { OUTPUT_FORMAT } from "@intlayer/config/defaultValues";
 import { getPerLocaleDictionary } from "@intlayer/core/plugins";
 
@@ -43,6 +44,7 @@ const writeDynamicDictionary = async (mergedDictionaries, configuration, formats
 		if (key === "undefined") return;
 		const localizedDictionariesPathsRecord = {};
 		const keyDir = resolve(dictDir, key);
+		assertPathWithin(keyDir, dictDir);
 		await mkdir(keyDir, { recursive: true });
 		await parallelize(locales, async (locale) => {
 			const localizedDictionary = getPerLocaleDictionary(dictionaryEntry.dictionary, locale, defaultLocale);
@@ -59,8 +61,10 @@ const writeDynamicDictionary = async (mergedDictionaries, configuration, formats
 		await parallelize(formats, async (format) => {
 			const extension = format === "cjs" ? "cjs" : "mjs";
 			const content = generateDictionaryEntryPoint(key, locales, format);
-			await writeFileIfChanged(resolve(dynamicDictionariesDir, `${key}.${extension}`), content).catch((err) => {
-				console.error(`Error creating dynamic ${colorizePath(resolve(dynamicDictionariesDir, `${key}.${extension}`))}:`, err);
+			const dynEntryPath = resolve(dynamicDictionariesDir, `${key}.${extension}`);
+			assertPathWithin(dynEntryPath, dynamicDictionariesDir);
+			await writeFileIfChanged(dynEntryPath, content).catch((err) => {
+				console.error(`Error creating dynamic ${colorizePath(dynEntryPath)}:`, err);
 			});
 		});
 	});

package/dist/esm/buildIntlayerDictionary/writeDynamicDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeDynamicDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { getPerLocaleDictionary } 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 { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { MergedDictionaryOutput } from './writeMergedDictionary';\n\nexport type DictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type LocalizedDictionaryResult = Partial<\n  Record<Locale, DictionaryResult>\n>;\n\nexport type LocalizedDictionaryOutput = Record<\n  string,\n  LocalizedDictionaryResult\n>;\n\nconst DICTIONARIES_SUBDIR = 'json'; // Necessary to add a static first dir for Turbopack\n\n/**\n * Generates the content of a dictionary entry point file.\n */\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n\n  const localeEntries = sortedLocales\n    .map((locale) =>\n      format === 'esm'\n        ? `  '${locale}': () => import('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json').then(m => m.default)`\n        : `  '${locale}': () => Promise.resolve(require('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json'))`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return `module.exports = {\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dynamic_dictionary/dictionaries/en_home.json\n * // .intlayer/dynamic_dictionary/dictionaries/fr_home.json\n * ```\n */\nexport const writeDynamicDictionary = async (\n  mergedDictionaries: MergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Merge dictionaries with the same key and write to dictionariesDir\n  await parallelize(\n    Object.entries(mergedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, dictionaryEntry]) => {\n      if (key === 'undefined') return;\n\n      const localizedDictionariesPathsRecord: LocalizedDictionaryResult = {};\n\n      const keyDir = resolve(dictDir, key);\n      await mkdir(keyDir, { recursive: true });\n\n      await parallelize(locales, async (locale) => {\n        const localizedDictionary = getPerLocaleDictionary(\n          dictionaryEntry.dictionary,\n          locale,\n          defaultLocale\n        );\n\n        // Directory structure: json/key/locale.json\n        const resultFilePath = resolve(keyDir, `${locale}.json`);\n\n        await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n          (err) => {\n            console.error(\n              `Error creating localized ${key}/${locale}.json:`,\n              err\n            );\n          }\n        );\n\n        localizedDictionariesPathsRecord[locale] = {\n          dictionaryPath: resultFilePath,\n          dictionary: localizedDictionary,\n        };\n      });\n\n      resultDictionariesPaths[key] = localizedDictionariesPathsRecord;\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateDictionaryEntryPoint(key, locales, format);\n\n        await writeFileIfChanged(\n          resolve(dynamicDictionariesDir, `${key}.${extension}`),\n          content\n        ).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(resolve(dynamicDictionariesDir, `${key}.${extension}`))}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;;AA2BA,MAAM,sBAAsB;;;;AAK5B,MAAa,gCACX,KACA,SACA,SAAwB,UACb;CAKX,MAAM,gBAJgB,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,MAC1C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAGD,CAChC,KAAK,WACJ,WAAW,QACP,MAAM,OAAO,qBAAqB,oBAAoB,GAAG,IAAI,GAAG,OAAO,gCACvE,MAAM,OAAO,sCAAsC,oBAAoB,GAAG,IAAI,GAAG,OAAO,UAC7F,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,sBAAsB,cAAc;CAIxC,OAAO,uBAAuB,cAAc;;;;;;;;;;;;;;;;;;AAmB9C,MAAa,yBAAyB,OACpC,oBACA,eACA,UAA6B,kBACU;CACvC,MAAM,EAAE,SAAS,kBAAkB,cAAc;CACjD,MAAM,EAAE,2BAA2B,cAAc;CAEjD,MAAM,UAAU,QAAQ,wBAAwB,oBAAoB;CACpE,MAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;CAEzC,MAAM,0BAAqD,EAAE;CAG7D,MAAM,YACJ,OAAO,QAAQ,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,OAC7C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CACnC,EACD,OAAO,CAAC,KAAK,qBAAqB;EAChC,IAAI,QAAQ,aAAa;EAEzB,MAAM,mCAA8D,EAAE;EAEtE,MAAM,SAAS,QAAQ,SAAS,IAAI;EACpC,MAAM,MAAM,QAAQ,EAAE,WAAW,MAAM,CAAC;EAExC,MAAM,YAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,sBAAsB,uBAC1B,gBAAgB,YAChB,QACA,cACD;GAGD,MAAM,iBAAiB,QAAQ,QAAQ,GAAG,OAAO,OAAO;GAExD,MAAM,mBAAmB,gBAAgB,oBAAoB,CAAC,OAC3D,QAAQ;IACP,QAAQ,MACN,4BAA4B,IAAI,GAAG,OAAO,SAC1C,IACD;KAEJ;GAED,iCAAiC,UAAU;IACzC,gBAAgB;IAChB,YAAY;IACb;IACD;EAEF,wBAAwB,OAAO;EAE/B,MAAM,YAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BAA6B,KAAK,SAAS,OAAO;GAElE,MAAM,mBACJ,QAAQ,wBAAwB,GAAG,IAAI,GAAG,YAAY,EACtD,QACD,CAAC,OAAO,QAAQ;IACf,QAAQ,MACN,0BAA0B,aAAa,QAAQ,wBAAwB,GAAG,IAAI,GAAG,YAAY,CAAC,CAAC,IAC/F,IACD;KACD;IACF;GAEL;CAED,OAAO"}
+{"version":3,"file":"writeDynamicDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport { getPerLocaleDictionary } 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 { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { MergedDictionaryOutput } from './writeMergedDictionary';\n\nexport type DictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type LocalizedDictionaryResult = Partial<\n  Record<Locale, DictionaryResult>\n>;\n\nexport type LocalizedDictionaryOutput = Record<\n  string,\n  LocalizedDictionaryResult\n>;\n\nconst DICTIONARIES_SUBDIR = 'json'; // Necessary to add a static first dir for Turbopack\n\n/**\n * Generates the content of a dictionary entry point file.\n */\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const sortedLocales = [...locales].sort((a, b) =>\n    String(a).localeCompare(String(b))\n  );\n\n  const localeEntries = sortedLocales\n    .map((locale) =>\n      format === 'esm'\n        ? `  '${locale}': () => import('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json').then(m => m.default)`\n        : `  '${locale}': () => Promise.resolve(require('./${DICTIONARIES_SUBDIR}/${key}/${locale}.json'))`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return `module.exports = {\\n${localeEntries}\\n};\\n`;\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dynamic_dictionary/dictionaries/en_home.json\n * // .intlayer/dynamic_dictionary/dictionaries/fr_home.json\n * ```\n */\nexport const writeDynamicDictionary = async (\n  mergedDictionaries: MergedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { locales, defaultLocale } = configuration.internationalization;\n  const { dynamicDictionariesDir } = configuration.system;\n\n  const dictDir = resolve(dynamicDictionariesDir, DICTIONARIES_SUBDIR);\n  await mkdir(dictDir, { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Merge dictionaries with the same key and write to dictionariesDir\n  await parallelize(\n    Object.entries(mergedDictionaries).sort(([a], [b]) =>\n      String(a).localeCompare(String(b))\n    ),\n    async ([key, dictionaryEntry]) => {\n      if (key === 'undefined') return;\n\n      const localizedDictionariesPathsRecord: LocalizedDictionaryResult = {};\n\n      const keyDir = resolve(dictDir, key);\n      assertPathWithin(keyDir, dictDir);\n      await mkdir(keyDir, { recursive: true });\n\n      await parallelize(locales, async (locale) => {\n        const localizedDictionary = getPerLocaleDictionary(\n          dictionaryEntry.dictionary,\n          locale,\n          defaultLocale\n        );\n\n        // Directory structure: json/key/locale.json\n        const resultFilePath = resolve(keyDir, `${locale}.json`);\n\n        await writeJsonIfChanged(resultFilePath, localizedDictionary).catch(\n          (err) => {\n            console.error(\n              `Error creating localized ${key}/${locale}.json:`,\n              err\n            );\n          }\n        );\n\n        localizedDictionariesPathsRecord[locale] = {\n          dictionaryPath: resultFilePath,\n          dictionary: localizedDictionary,\n        };\n      });\n\n      resultDictionariesPaths[key] = localizedDictionariesPathsRecord;\n\n      await parallelize(formats, async (format) => {\n        const extension = format === 'cjs' ? 'cjs' : 'mjs';\n        const content = generateDictionaryEntryPoint(key, locales, format);\n\n        const dynEntryPath = resolve(\n          dynamicDictionariesDir,\n          `${key}.${extension}`\n        );\n        assertPathWithin(dynEntryPath, dynamicDictionariesDir);\n\n        await writeFileIfChanged(dynEntryPath, content).catch((err) => {\n          console.error(\n            `Error creating dynamic ${colorizePath(dynEntryPath)}:`,\n            err\n          );\n        });\n      });\n    }\n  );\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;;;AA4BA,MAAM,sBAAsB;;;;AAK5B,MAAa,gCACX,KACA,SACA,SAAwB,UACb;CAKX,MAAM,gBAJgB,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,MAC1C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAGD,CAChC,KAAK,WACJ,WAAW,QACP,MAAM,OAAO,qBAAqB,oBAAoB,GAAG,IAAI,GAAG,OAAO,gCACvE,MAAM,OAAO,sCAAsC,oBAAoB,GAAG,IAAI,GAAG,OAAO,UAC7F,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,sBAAsB,cAAc;CAIxC,OAAO,uBAAuB,cAAc;;;;;;;;;;;;;;;;;;AAmB9C,MAAa,yBAAyB,OACpC,oBACA,eACA,UAA6B,kBACU;CACvC,MAAM,EAAE,SAAS,kBAAkB,cAAc;CACjD,MAAM,EAAE,2BAA2B,cAAc;CAEjD,MAAM,UAAU,QAAQ,wBAAwB,oBAAoB;CACpE,MAAM,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;CAEzC,MAAM,0BAAqD,EAAE;CAG7D,MAAM,YACJ,OAAO,QAAQ,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,OAC7C,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CACnC,EACD,OAAO,CAAC,KAAK,qBAAqB;EAChC,IAAI,QAAQ,aAAa;EAEzB,MAAM,mCAA8D,EAAE;EAEtE,MAAM,SAAS,QAAQ,SAAS,IAAI;EACpC,iBAAiB,QAAQ,QAAQ;EACjC,MAAM,MAAM,QAAQ,EAAE,WAAW,MAAM,CAAC;EAExC,MAAM,YAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,sBAAsB,uBAC1B,gBAAgB,YAChB,QACA,cACD;GAGD,MAAM,iBAAiB,QAAQ,QAAQ,GAAG,OAAO,OAAO;GAExD,MAAM,mBAAmB,gBAAgB,oBAAoB,CAAC,OAC3D,QAAQ;IACP,QAAQ,MACN,4BAA4B,IAAI,GAAG,OAAO,SAC1C,IACD;KAEJ;GAED,iCAAiC,UAAU;IACzC,gBAAgB;IAChB,YAAY;IACb;IACD;EAEF,wBAAwB,OAAO;EAE/B,MAAM,YAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BAA6B,KAAK,SAAS,OAAO;GAElE,MAAM,eAAe,QACnB,wBACA,GAAG,IAAI,GAAG,YACX;GACD,iBAAiB,cAAc,uBAAuB;GAEtD,MAAM,mBAAmB,cAAc,QAAQ,CAAC,OAAO,QAAQ;IAC7D,QAAQ,MACN,0BAA0B,aAAa,aAAa,CAAC,IACrD,IACD;KACD;IACF;GAEL;CAED,OAAO"}

package/dist/esm/buildIntlayerDictionary/writeFetchDictionary.mjs

@@ -3,7 +3,7 @@ import { writeFileIfChanged } from "../writeFileIfChanged.mjs";
 import { mkdir } from "node:fs/promises";
 import { relative, resolve } from "node:path";
 import { colorizePath } from "@intlayer/config/logger";
-import { normalizePath } from "@intlayer/config/utils";
+import { assertPathWithin, normalizePath } from "@intlayer/config/utils";
 import { OUTPUT_FORMAT } from "@intlayer/config/defaultValues";
 
 //#region src/buildIntlayerDictionary/writeFetchDictionary.ts
@@ -41,8 +41,10 @@ const writeFetchDictionary = async (dynamicDictionaries, configuration, formats
 		await parallelize(formats, async (format) => {
 			const extension = format === "cjs" ? "cjs" : "mjs";
 			const content = generateDictionaryEntryPoint(key, locales, relativePrefix, format);
-			await writeFileIfChanged(resolve(fetchDictionariesDir, `${key}.${extension}`), content).catch((err) => {
-				console.error(`Error creating fetch ${colorizePath(resolve(fetchDictionariesDir, `${key}.${extension}`))}:`, err);
+			const fetchEntryPath = resolve(fetchDictionariesDir, `${key}.${extension}`);
+			assertPathWithin(fetchEntryPath, fetchDictionariesDir);
+			await writeFileIfChanged(fetchEntryPath, content).catch((err) => {
+				console.error(`Error creating fetch ${colorizePath(fetchEntryPath)}:`, err);
 			});
 		});
 	});

package/dist/esm/buildIntlayerDictionary/writeFetchDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeFetchDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeFetchDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { normalizePath } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport type { LocalizedDictionaryOutput } from './writeDynamicDictionary';\n\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  relativePrefix: string,\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const extension = format === 'cjs' ? 'cjs' : 'mjs';\n\n  const localeEntries = locales\n    .sort((a, b) => String(a).localeCompare(String(b)))\n    .map(\n      (locale) =>\n        `  '${locale}': async () => {\\n` +\n        `    try {\\n` +\n        `      const res = await fetch(\\`\\${editor.liveSyncURL}/dictionaries/${key}/${locale}\\`);\\n` +\n        `      return await res.json();\\n` +\n        `    } catch {\\n` +\n        `      return dynContent['${locale}']();\\n` +\n        `    }\\n` +\n        `  }`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `import { editor } from 'intlayer';\\n` +\n      `import dynContent from '${relativePrefix}/${key}.${extension}';\\n\\n` +\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return (\n    `const { editor } = require('intlayer');\\n` +\n    `const dynContent = require('${relativePrefix}/${key}.${extension}');\\n\\n` +\n    `module.exports = {\\n${localeEntries}\\n};\\n`\n  );\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/fetch_dictionary/home.mjs\n * // .intlayer/fetch_dictionary/home.cjs\n * ```\n */\nexport const writeFetchDictionary = async (\n  dynamicDictionaries: LocalizedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { fetchDictionariesDir, dynamicDictionariesDir } = configuration.system;\n  const { locales } = configuration.internationalization;\n\n  // Compute relative path from fetch dir to dynamic dir\n  let relativePrefix = normalizePath(\n    relative(fetchDictionariesDir, dynamicDictionariesDir)\n  );\n  if (!relativePrefix.startsWith('.')) {\n    relativePrefix = `./${relativePrefix}`;\n  }\n\n  await mkdir(resolve(fetchDictionariesDir), { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Write entry points for each dictionary in parallel\n  await parallelize(Object.entries(dynamicDictionaries), async ([key]) => {\n    if (key === 'undefined') return;\n\n    await parallelize(formats, async (format) => {\n      const extension = format === 'cjs' ? 'cjs' : 'mjs';\n      const content = generateDictionaryEntryPoint(\n        key,\n        locales,\n        relativePrefix,\n        format\n      );\n\n      await writeFileIfChanged(\n        resolve(fetchDictionariesDir, `${key}.${extension}`),\n        content\n      ).catch((err) => {\n        console.error(\n          `Error creating fetch ${colorizePath(resolve(fetchDictionariesDir, `${key}.${extension}`))}:`,\n          err\n        );\n      });\n    });\n  });\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAa,gCACX,KACA,SACA,gBACA,SAAwB,UACb;CACX,MAAM,YAAY,WAAW,QAAQ,QAAQ;CAE7C,MAAM,gBAAgB,QACnB,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC,CAClD,KACE,WACC,MAAM,OAAO,mGAE0D,IAAI,GAAG,OAAO,gFAGzD,OAAO,mBAGtC,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,+DAC2B,eAAe,GAAG,IAAI,GAAG,UAAU,2BACxC,cAAc;CAIxC,OACE,wEAC+B,eAAe,GAAG,IAAI,GAAG,UAAU,6BAC3C,cAAc;;;;;;;;;;;;;;;;;;AAoBzC,MAAa,uBAAuB,OAClC,qBACA,eACA,UAA6B,kBACU;CACvC,MAAM,EAAE,sBAAsB,2BAA2B,cAAc;CACvE,MAAM,EAAE,YAAY,cAAc;CAGlC,IAAI,iBAAiB,cACnB,SAAS,sBAAsB,uBAAuB,CACvD;CACD,IAAI,CAAC,eAAe,WAAW,IAAI,EACjC,iBAAiB,KAAK;CAGxB,MAAM,MAAM,QAAQ,qBAAqB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE/D,MAAM,0BAAqD,EAAE;CAG7D,MAAM,YAAY,OAAO,QAAQ,oBAAoB,EAAE,OAAO,CAAC,SAAS;EACtE,IAAI,QAAQ,aAAa;EAEzB,MAAM,YAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BACd,KACA,SACA,gBACA,OACD;GAED,MAAM,mBACJ,QAAQ,sBAAsB,GAAG,IAAI,GAAG,YAAY,EACpD,QACD,CAAC,OAAO,QAAQ;IACf,QAAQ,MACN,wBAAwB,aAAa,QAAQ,sBAAsB,GAAG,IAAI,GAAG,YAAY,CAAC,CAAC,IAC3F,IACD;KACD;IACF;GACF;CAEF,OAAO"}
+{"version":3,"file":"writeFetchDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeFetchDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { relative, resolve } from 'node:path';\nimport { OUTPUT_FORMAT } from '@intlayer/config/defaultValues';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin, normalizePath } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { parallelize } from '../utils/parallelize';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport type { LocalizedDictionaryOutput } from './writeDynamicDictionary';\n\nexport const generateDictionaryEntryPoint = (\n  key: string,\n  locales: string[],\n  relativePrefix: string,\n  format: 'cjs' | 'esm' = 'esm'\n): string => {\n  const extension = format === 'cjs' ? 'cjs' : 'mjs';\n\n  const localeEntries = locales\n    .sort((a, b) => String(a).localeCompare(String(b)))\n    .map(\n      (locale) =>\n        `  '${locale}': async () => {\\n` +\n        `    try {\\n` +\n        `      const res = await fetch(\\`\\${editor.liveSyncURL}/dictionaries/${key}/${locale}\\`);\\n` +\n        `      return await res.json();\\n` +\n        `    } catch {\\n` +\n        `      return dynContent['${locale}']();\\n` +\n        `    }\\n` +\n        `  }`\n    )\n    .join(',\\n');\n\n  if (format === 'esm') {\n    return (\n      `import { editor } from 'intlayer';\\n` +\n      `import dynContent from '${relativePrefix}/${key}.${extension}';\\n\\n` +\n      `const content = {\\n${localeEntries}\\n};\\n\\n` +\n      `export default content;\\n`\n    );\n  }\n  return (\n    `const { editor } = require('intlayer');\\n` +\n    `const dynContent = require('${relativePrefix}/${key}.${extension}');\\n\\n` +\n    `module.exports = {\\n${localeEntries}\\n};\\n`\n  );\n};\n\n/**\n * Write the localized dictionaries to the dictionariesDir\n * @param mergedDictionaries - The merged dictionaries\n * @param configuration - The configuration\n * @returns The final dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/fetch_dictionary/home.mjs\n * // .intlayer/fetch_dictionary/home.cjs\n * ```\n */\nexport const writeFetchDictionary = async (\n  dynamicDictionaries: LocalizedDictionaryOutput,\n  configuration: IntlayerConfig,\n  formats: ('cjs' | 'esm')[] = OUTPUT_FORMAT\n): Promise<LocalizedDictionaryOutput> => {\n  const { fetchDictionariesDir, dynamicDictionariesDir } = configuration.system;\n  const { locales } = configuration.internationalization;\n\n  // Compute relative path from fetch dir to dynamic dir\n  let relativePrefix = normalizePath(\n    relative(fetchDictionariesDir, dynamicDictionariesDir)\n  );\n  if (!relativePrefix.startsWith('.')) {\n    relativePrefix = `./${relativePrefix}`;\n  }\n\n  await mkdir(resolve(fetchDictionariesDir), { recursive: true });\n\n  const resultDictionariesPaths: LocalizedDictionaryOutput = {};\n\n  // Write entry points for each dictionary in parallel\n  await parallelize(Object.entries(dynamicDictionaries), async ([key]) => {\n    if (key === 'undefined') return;\n\n    await parallelize(formats, async (format) => {\n      const extension = format === 'cjs' ? 'cjs' : 'mjs';\n      const content = generateDictionaryEntryPoint(\n        key,\n        locales,\n        relativePrefix,\n        format\n      );\n\n      const fetchEntryPath = resolve(\n        fetchDictionariesDir,\n        `${key}.${extension}`\n      );\n      assertPathWithin(fetchEntryPath, fetchDictionariesDir);\n\n      await writeFileIfChanged(fetchEntryPath, content).catch((err) => {\n        console.error(\n          `Error creating fetch ${colorizePath(fetchEntryPath)}:`,\n          err\n        );\n      });\n    });\n  });\n\n  return resultDictionariesPaths;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAa,gCACX,KACA,SACA,gBACA,SAAwB,UACb;CACX,MAAM,YAAY,WAAW,QAAQ,QAAQ;CAE7C,MAAM,gBAAgB,QACnB,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC,CAClD,KACE,WACC,MAAM,OAAO,mGAE0D,IAAI,GAAG,OAAO,gFAGzD,OAAO,mBAGtC,CACA,KAAK,MAAM;CAEd,IAAI,WAAW,OACb,OACE,+DAC2B,eAAe,GAAG,IAAI,GAAG,UAAU,2BACxC,cAAc;CAIxC,OACE,wEAC+B,eAAe,GAAG,IAAI,GAAG,UAAU,6BAC3C,cAAc;;;;;;;;;;;;;;;;;;AAoBzC,MAAa,uBAAuB,OAClC,qBACA,eACA,UAA6B,kBACU;CACvC,MAAM,EAAE,sBAAsB,2BAA2B,cAAc;CACvE,MAAM,EAAE,YAAY,cAAc;CAGlC,IAAI,iBAAiB,cACnB,SAAS,sBAAsB,uBAAuB,CACvD;CACD,IAAI,CAAC,eAAe,WAAW,IAAI,EACjC,iBAAiB,KAAK;CAGxB,MAAM,MAAM,QAAQ,qBAAqB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE/D,MAAM,0BAAqD,EAAE;CAG7D,MAAM,YAAY,OAAO,QAAQ,oBAAoB,EAAE,OAAO,CAAC,SAAS;EACtE,IAAI,QAAQ,aAAa;EAEzB,MAAM,YAAY,SAAS,OAAO,WAAW;GAC3C,MAAM,YAAY,WAAW,QAAQ,QAAQ;GAC7C,MAAM,UAAU,6BACd,KACA,SACA,gBACA,OACD;GAED,MAAM,iBAAiB,QACrB,sBACA,GAAG,IAAI,GAAG,YACX;GACD,iBAAiB,gBAAgB,qBAAqB;GAEtD,MAAM,mBAAmB,gBAAgB,QAAQ,CAAC,OAAO,QAAQ;IAC/D,QAAQ,MACN,wBAAwB,aAAa,eAAe,CAAC,IACrD,IACD;KACD;IACF;GACF;CAEF,OAAO"}

package/dist/esm/buildIntlayerDictionary/writeMergedDictionary.mjs

@@ -3,6 +3,7 @@ import { writeJsonIfChanged } from "../writeJsonIfChanged.mjs";
 import { mkdir } from "node:fs/promises";
 import { resolve } from "node:path";
 import { colorizePath } from "@intlayer/config/logger";
+import { assertPathWithin } from "@intlayer/config/utils";
 import { mergeDictionaries, normalizeDictionaries } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/buildIntlayerDictionary/writeMergedDictionary.ts
@@ -29,6 +30,7 @@ const writeMergedDictionaries = async (groupedDictionaries, configuration) => {
 		if (key === "undefined") return;
 		const mergedDictionary = mergeDictionaries(normalizeDictionaries(dictionariesEntry.dictionaries, configuration));
 		const resultFilePath = resolve(dictionariesDir, `${key}.json`);
+		assertPathWithin(resultFilePath, dictionariesDir);
 		await writeJsonIfChanged(resultFilePath, mergedDictionary).catch((err) => {
 			console.error(`Error creating merged ${colorizePath(resultFilePath)}:`, err);
 		});

package/dist/esm/buildIntlayerDictionary/writeMergedDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeMergedDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath } from '@intlayer/config/logger';\nimport {\n  mergeDictionaries,\n  normalizeDictionaries,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { UnmergedDictionaryOutput } from './writeUnmergedDictionary';\n\nexport type MergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type MergedDictionaryOutput = Record<string, MergedDictionaryResult>;\n\n/**\n * Write the merged dictionaries to the dictionariesDir\n * @param groupedDictionaries - The grouped dictionaries\n * @param configuration - The configuration\n * @returns The merged dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dictionary/home.json\n * // { key: 'home', content: { ... } },\n * ```\n */\nexport const writeMergedDictionaries = async (\n  groupedDictionaries: UnmergedDictionaryOutput,\n  configuration: IntlayerConfig\n): Promise<MergedDictionaryOutput> => {\n  const { dictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(dictionariesDir), { recursive: true });\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionariesEntry]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          MergedDictionaryResult,\n        ];\n      }\n\n      const normalizedDictionaries = normalizeDictionaries(\n        dictionariesEntry.dictionaries,\n        configuration\n      );\n\n      const mergedDictionary = mergeDictionaries(normalizedDictionaries);\n\n      const outputFileName = `${key}.json`;\n      const resultFilePath = resolve(dictionariesDir, outputFileName);\n\n      // Write the merged dictionary\n      await writeJsonIfChanged(resultFilePath, mergedDictionary).catch(\n        (err) => {\n          console.error(\n            `Error creating merged ${colorizePath(resultFilePath)}:`,\n            err\n          );\n        }\n      );\n\n      return [\n        key,\n        {\n          dictionaryPath: resultFilePath,\n          dictionary: mergedDictionary,\n        } as MergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<readonly [string, MergedDictionaryResult]>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,0BAA0B,OACrC,qBACA,kBACoC;CACpC,MAAM,EAAE,oBAAoB,cAAc;CAG1C,MAAM,MAAM,QAAQ,gBAAgB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE1D,MAAM,UAAU,MAAM,YACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,uBAAuB;EAClC,IAAI,QAAQ,aACV;EAWF,MAAM,mBAAmB,kBALM,sBAC7B,kBAAkB,cAClB,cAG+D,CAAC;EAGlE,MAAM,iBAAiB,QAAQ,iBAAiB,GADtB,IAAI,OACiC;EAG/D,MAAM,mBAAmB,gBAAgB,iBAAiB,CAAC,OACxD,QAAQ;GACP,QAAQ,MACN,yBAAyB,aAAa,eAAe,CAAC,IACtD,IACD;IAEJ;EAED,OAAO,CACL,KACA;GACE,gBAAgB;GAChB,YAAY;GACb,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CACxB"}
+{"version":3,"file":"writeMergedDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport {\n  mergeDictionaries,\n  normalizeDictionaries,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\nimport type { UnmergedDictionaryOutput } from './writeUnmergedDictionary';\n\nexport type MergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionary: Dictionary;\n};\n\nexport type MergedDictionaryOutput = Record<string, MergedDictionaryResult>;\n\n/**\n * Write the merged dictionaries to the dictionariesDir\n * @param groupedDictionaries - The grouped dictionaries\n * @param configuration - The configuration\n * @returns The merged dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * const finalDictionaries = await writeFinalDictionaries(unmergedDictionaries);\n * console.log(finalDictionaries);\n *\n * // .intlayer/dictionary/home.json\n * // { key: 'home', content: { ... } },\n * ```\n */\nexport const writeMergedDictionaries = async (\n  groupedDictionaries: UnmergedDictionaryOutput,\n  configuration: IntlayerConfig\n): Promise<MergedDictionaryOutput> => {\n  const { dictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(dictionariesDir), { recursive: true });\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionariesEntry]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          MergedDictionaryResult,\n        ];\n      }\n\n      const normalizedDictionaries = normalizeDictionaries(\n        dictionariesEntry.dictionaries,\n        configuration\n      );\n\n      const mergedDictionary = mergeDictionaries(normalizedDictionaries);\n\n      const outputFileName = `${key}.json`;\n      const resultFilePath = resolve(dictionariesDir, outputFileName);\n\n      assertPathWithin(resultFilePath, dictionariesDir);\n\n      // Write the merged dictionary\n      await writeJsonIfChanged(resultFilePath, mergedDictionary).catch(\n        (err) => {\n          console.error(\n            `Error creating merged ${colorizePath(resultFilePath)}:`,\n            err\n          );\n        }\n      );\n\n      return [\n        key,\n        {\n          dictionaryPath: resultFilePath,\n          dictionary: mergedDictionary,\n        } as MergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<readonly [string, MergedDictionaryResult]>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,0BAA0B,OACrC,qBACA,kBACoC;CACpC,MAAM,EAAE,oBAAoB,cAAc;CAG1C,MAAM,MAAM,QAAQ,gBAAgB,EAAE,EAAE,WAAW,MAAM,CAAC;CAE1D,MAAM,UAAU,MAAM,YACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,uBAAuB;EAClC,IAAI,QAAQ,aACV;EAWF,MAAM,mBAAmB,kBALM,sBAC7B,kBAAkB,cAClB,cAG+D,CAAC;EAGlE,MAAM,iBAAiB,QAAQ,iBAAiB,GADtB,IAAI,OACiC;EAE/D,iBAAiB,gBAAgB,gBAAgB;EAGjD,MAAM,mBAAmB,gBAAgB,iBAAiB,CAAC,OACxD,QAAQ;GACP,QAAQ,MACN,yBAAyB,aAAa,eAAe,CAAC,IACtD,IACD;IAEJ;EAED,OAAO,CACL,KACA;GACE,gBAAgB;GAChB,YAAY;GACb,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CACxB"}

package/dist/esm/buildIntlayerDictionary/writeUnmergedDictionary.mjs

@@ -4,6 +4,7 @@ import { filterInvalidDictionaries } from "../filterInvalidDictionaries.mjs";
 import { mkdir } from "node:fs/promises";
 import { resolve } from "node:path";
 import { colorizePath, x } from "@intlayer/config/logger";
+import { assertPathWithin } from "@intlayer/config/utils";
 import { orderDictionaries } from "@intlayer/core/dictionaryManipulator";
 
 //#region src/buildIntlayerDictionary/writeUnmergedDictionary.ts
@@ -41,6 +42,7 @@ const writeUnmergedDictionaries = async (dictionaries, configuration, env) => {
 		if (key === "undefined") return;
 		const orderedDictionaries = orderDictionaries(dictionaries);
 		const unmergedFilePath = resolve(unmergedDictionariesDir, `${key}.json`);
+		assertPathWithin(unmergedFilePath, unmergedDictionariesDir);
 		if (configuration.editor.enabled || env === "dev") await writeJsonIfChanged(unmergedFilePath, orderedDictionaries).catch((err) => {
 			console.error(`${x} Error creating unmerged ${colorizePath(unmergedFilePath)}:`, err);
 		});

package/dist/esm/buildIntlayerDictionary/writeUnmergedDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"writeUnmergedDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath, x } from '@intlayer/config/logger';\nimport { orderDictionaries } from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, DictionaryKey } from '@intlayer/types/dictionary';\nimport { filterInvalidDictionaries } from '../filterInvalidDictionaries';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\n\nexport const groupDictionariesByKey = (\n  dictionaries: Dictionary[]\n): Record<string, Dictionary[]> =>\n  dictionaries.reduce(\n    (acc, dictionary) => {\n      const key = dictionary.key;\n      if (!acc[key]) {\n        acc[key] = [];\n      }\n      acc[key].push(dictionary);\n      return acc;\n    },\n    {} as Record<string, Dictionary[]>\n  );\n\nexport type UnmergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionaries: Dictionary[];\n};\n\nexport type UnmergedDictionaryOutput = Record<\n  DictionaryKey,\n  UnmergedDictionaryResult\n>;\n\n/**\n * Write the unmerged dictionaries to the unmergedDictionariesDir\n * @param dictionaries - The dictionaries to write\n * @param configuration - The configuration\n * @returns The grouped dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * console.log(unmergedDictionaries);\n *\n * // .intlayer/unmerged_dictionaries/home.json\n * // {\n * //   [\n * //     { key: 'home', content: { ... } },\n * //     { key: 'home', content: { ... } },\n * //   ],\n * // }\n * ```\n */\nexport const writeUnmergedDictionaries = async (\n  dictionaries: Dictionary[],\n  configuration: IntlayerConfig,\n  env: 'prod' | 'dev'\n): Promise<UnmergedDictionaryOutput> => {\n  const { unmergedDictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(unmergedDictionariesDir), { recursive: true });\n\n  const filteredDictionaries = filterInvalidDictionaries(\n    dictionaries,\n    configuration,\n    { checkSchema: true }\n  );\n\n  //  Group dictionaries by key and write to unmergedDictionariesDir\n  const groupedDictionaries = groupDictionariesByKey(filteredDictionaries);\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionaries]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          UnmergedDictionaryResult,\n        ];\n      }\n\n      const orderedDictionaries = orderDictionaries(dictionaries);\n\n      const outputFileName = `${key}.json`;\n      const unmergedFilePath = resolve(unmergedDictionariesDir, outputFileName);\n\n      // Write the grouped dictionaries in disk if the editor is enabled\n      // To make work the visual editor on the server\n      // No need them if the editor is disabled\n      // But in local env (env: 'dev') we write them for the vscode extension\n      if (configuration.editor.enabled || env === 'dev') {\n        await writeJsonIfChanged(unmergedFilePath, orderedDictionaries).catch(\n          (err) => {\n            console.error(\n              `${x} Error creating unmerged ${colorizePath(unmergedFilePath)}:`,\n              err\n            );\n          }\n        );\n      }\n\n      return [\n        key,\n        {\n          dictionaryPath: unmergedFilePath,\n          dictionaries: dictionaries,\n        } as UnmergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<\n      readonly [string, UnmergedDictionaryResult]\n    >\n  );\n};\n"],"mappings":";;;;;;;;;AAUA,MAAa,0BACX,iBAEA,aAAa,QACV,KAAK,eAAe;CACnB,MAAM,MAAM,WAAW;CACvB,IAAI,CAAC,IAAI,MACP,IAAI,OAAO,EAAE;CAEf,IAAI,KAAK,KAAK,WAAW;CACzB,OAAO;GAET,EAAE,CACH;;;;;;;;;;;;;;;;;;;;;AAgCH,MAAa,4BAA4B,OACvC,cACA,eACA,QACsC;CACtC,MAAM,EAAE,4BAA4B,cAAc;CAGlD,MAAM,MAAM,QAAQ,wBAAwB,EAAE,EAAE,WAAW,MAAM,CAAC;CASlE,MAAM,sBAAsB,uBAPC,0BAC3B,cACA,eACA,EAAE,aAAa,MAAM,CAIgD,CAAC;CAExE,MAAM,UAAU,MAAM,YACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,kBAAkB;EAC7B,IAAI,QAAQ,aACV;EAMF,MAAM,sBAAsB,kBAAkB,aAAa;EAG3D,MAAM,mBAAmB,QAAQ,yBAAyB,GADhC,IAAI,OAC2C;EAMzE,IAAI,cAAc,OAAO,WAAW,QAAQ,OAC1C,MAAM,mBAAmB,kBAAkB,oBAAoB,CAAC,OAC7D,QAAQ;GACP,QAAQ,MACN,GAAG,EAAE,2BAA2B,aAAa,iBAAiB,CAAC,IAC/D,IACD;IAEJ;EAGH,OAAO,CACL,KACA;GACE,gBAAgB;GACF;GACf,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CAGxB"}
+{"version":3,"file":"writeUnmergedDictionary.mjs","names":[],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { colorizePath, x } from '@intlayer/config/logger';\nimport { assertPathWithin } from '@intlayer/config/utils';\nimport { orderDictionaries } from '@intlayer/core/dictionaryManipulator';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary, DictionaryKey } from '@intlayer/types/dictionary';\nimport { filterInvalidDictionaries } from '../filterInvalidDictionaries';\nimport { parallelize } from '../utils/parallelize';\nimport { writeJsonIfChanged } from '../writeJsonIfChanged';\n\nexport const groupDictionariesByKey = (\n  dictionaries: Dictionary[]\n): Record<string, Dictionary[]> =>\n  dictionaries.reduce(\n    (acc, dictionary) => {\n      const key = dictionary.key;\n      if (!acc[key]) {\n        acc[key] = [];\n      }\n      acc[key].push(dictionary);\n      return acc;\n    },\n    {} as Record<string, Dictionary[]>\n  );\n\nexport type UnmergedDictionaryResult = {\n  dictionaryPath: string;\n  dictionaries: Dictionary[];\n};\n\nexport type UnmergedDictionaryOutput = Record<\n  DictionaryKey,\n  UnmergedDictionaryResult\n>;\n\n/**\n * Write the unmerged dictionaries to the unmergedDictionariesDir\n * @param dictionaries - The dictionaries to write\n * @param configuration - The configuration\n * @returns The grouped dictionaries\n *\n * @example\n * ```ts\n * const unmergedDictionaries = await writeUnmergedDictionaries(dictionaries);\n * console.log(unmergedDictionaries);\n *\n * // .intlayer/unmerged_dictionaries/home.json\n * // {\n * //   [\n * //     { key: 'home', content: { ... } },\n * //     { key: 'home', content: { ... } },\n * //   ],\n * // }\n * ```\n */\nexport const writeUnmergedDictionaries = async (\n  dictionaries: Dictionary[],\n  configuration: IntlayerConfig,\n  env: 'prod' | 'dev'\n): Promise<UnmergedDictionaryOutput> => {\n  const { unmergedDictionariesDir } = configuration.system;\n\n  // Create the dictionaries folder if it doesn't exist\n  await mkdir(resolve(unmergedDictionariesDir), { recursive: true });\n\n  const filteredDictionaries = filterInvalidDictionaries(\n    dictionaries,\n    configuration,\n    { checkSchema: true }\n  );\n\n  //  Group dictionaries by key and write to unmergedDictionariesDir\n  const groupedDictionaries = groupDictionariesByKey(filteredDictionaries);\n\n  const results = await parallelize(\n    Object.entries(groupedDictionaries),\n    async ([key, dictionaries]) => {\n      if (key === 'undefined') {\n        return undefined as unknown as readonly [\n          string,\n          UnmergedDictionaryResult,\n        ];\n      }\n\n      const orderedDictionaries = orderDictionaries(dictionaries);\n\n      const outputFileName = `${key}.json`;\n      const unmergedFilePath = resolve(unmergedDictionariesDir, outputFileName);\n\n      assertPathWithin(unmergedFilePath, unmergedDictionariesDir);\n\n      // Write the grouped dictionaries in disk if the editor is enabled\n      // To make work the visual editor on the server\n      // No need them if the editor is disabled\n      // But in local env (env: 'dev') we write them for the vscode extension\n      if (configuration.editor.enabled || env === 'dev') {\n        await writeJsonIfChanged(unmergedFilePath, orderedDictionaries).catch(\n          (err) => {\n            console.error(\n              `${x} Error creating unmerged ${colorizePath(unmergedFilePath)}:`,\n              err\n            );\n          }\n        );\n      }\n\n      return [\n        key,\n        {\n          dictionaryPath: unmergedFilePath,\n          dictionaries: dictionaries,\n        } as UnmergedDictionaryResult,\n      ] as const;\n    }\n  );\n\n  return Object.fromEntries(\n    results.filter(Boolean) as Array<\n      readonly [string, UnmergedDictionaryResult]\n    >\n  );\n};\n"],"mappings":";;;;;;;;;;AAWA,MAAa,0BACX,iBAEA,aAAa,QACV,KAAK,eAAe;CACnB,MAAM,MAAM,WAAW;CACvB,IAAI,CAAC,IAAI,MACP,IAAI,OAAO,EAAE;CAEf,IAAI,KAAK,KAAK,WAAW;CACzB,OAAO;GAET,EAAE,CACH;;;;;;;;;;;;;;;;;;;;;AAgCH,MAAa,4BAA4B,OACvC,cACA,eACA,QACsC;CACtC,MAAM,EAAE,4BAA4B,cAAc;CAGlD,MAAM,MAAM,QAAQ,wBAAwB,EAAE,EAAE,WAAW,MAAM,CAAC;CASlE,MAAM,sBAAsB,uBAPC,0BAC3B,cACA,eACA,EAAE,aAAa,MAAM,CAIgD,CAAC;CAExE,MAAM,UAAU,MAAM,YACpB,OAAO,QAAQ,oBAAoB,EACnC,OAAO,CAAC,KAAK,kBAAkB;EAC7B,IAAI,QAAQ,aACV;EAMF,MAAM,sBAAsB,kBAAkB,aAAa;EAG3D,MAAM,mBAAmB,QAAQ,yBAAyB,GADhC,IAAI,OAC2C;EAEzE,iBAAiB,kBAAkB,wBAAwB;EAM3D,IAAI,cAAc,OAAO,WAAW,QAAQ,OAC1C,MAAM,mBAAmB,kBAAkB,oBAAoB,CAAC,OAC7D,QAAQ;GACP,QAAQ,MACN,GAAG,EAAE,2BAA2B,aAAa,iBAAiB,CAAC,IAC/D,IACD;IAEJ;EAGH,OAAO,CACL,KACA;GACE,gBAAgB;GACF;GACf,CACF;GAEJ;CAED,OAAO,OAAO,YACZ,QAAQ,OAAO,QAAQ,CAGxB"}

package/dist/esm/installSkills/index.mjs

@@ -227,11 +227,14 @@ const getLicenceContent = () => {
 		return "";
 	}
 };
+const ALLOWED_FETCH_HOSTS = new Set(["intlayer.org"]);
 /**
 * Fetches the content of a URL using native fetch.
 */
 const fetchUrlContent = async (url) => {
-	const response = await fetch(url);
+	const parsed = new URL(url);
+	if (parsed.protocol !== "https:" || !ALLOWED_FETCH_HOSTS.has(parsed.hostname)) throw new Error(`Blocked fetch to disallowed host: ${parsed.hostname}`);
+	const response = await fetch(url, { redirect: "error" });
 	if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
 	return response.text();
 };
@@ -249,7 +252,7 @@ const installSkills = async (projectRoot, platform, skills) => {
 		const skillName = `intlayer-${SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill)}`;
 		const skillContent = getSkillContent(skill);
 		if (!skillContent) continue;
-		const urls = Array.from(new Set(skillContent.match(/https:\/\/intlayer\.org\/doc\/[^\s)]+\.md/g) || []));
+		const urls = Array.from(new Set(skillContent.match(/https:\/\/intlayer\.org\/[^\s)]+\.md/g) || []));
 		const skillDir = path.join(skillsBaseDir, skillName);
 		const referenceDir = path.join(skillDir, "references");
 		await promises.mkdir(referenceDir, { recursive: true });

package/dist/esm/installSkills/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["fs"],"sources":["../../../src/installSkills/index.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport { v } from '@intlayer/config/logger';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\n\n/**\n * Metadata for each available documentation skill.\n */\nexport const SKILLS_METADATA = {\n  Config: 'Intlayer configuration documentation',\n  Content: 'Reference for all Intlayer content node types (t, enu, etc.)',\n  Usage: 'How to use Intlayer in your project',\n  CLI: 'Intlayer CLI commands and usage',\n  Compiler:\n    'Intlayer Compiler setup and usage for automatic content extraction without .content files',\n  RemoteContent: 'How to use Intlayer with Remote/CMS/Server-side content',\n  NextJS: 'Next.js-specific usage (Server & Client components)',\n  React: 'React-specific syntax and hooks usage',\n  Vue: 'Vue-specific composables and syntax',\n  Svelte: 'Svelte-specific stores and syntax',\n  Angular: 'Angular-specific syntax and Injectable Function usage',\n  Preact: 'Preact-specific syntax and hooks usage',\n  Solid:\n    'Integrates Intlayer internationalization with SolidJS components. Use when the user asks to \"setup SolidJS i18n\", use the \"useIntlayer\" hook in Solid, or manage locales in a SolidJS application.',\n  Astro: 'Astro-specific usage and getIntlayer',\n} as const;\n\nexport type Skill = keyof typeof SKILLS_METADATA;\n\nexport const SKILLS = Object.keys(SKILLS_METADATA) as Skill[];\n\nexport const getInitialSkills = (\n  deps: Record<string, string>\n): (keyof typeof SKILLS_METADATA)[] => {\n  const skills: (keyof typeof SKILLS_METADATA)[] = [\n    'Usage',\n    'Content',\n    'Config',\n    'CLI',\n    'Compiler',\n  ];\n\n  if (deps.next) skills.push('NextJS');\n  if (deps.react || !deps.next) skills.push('React');\n  if (deps.preact) skills.push('Preact');\n  if (deps['solid-js']) skills.push('Solid');\n  if (deps.vue || deps.nuxt) skills.push('Vue');\n  if (deps.svelte || deps['@sveltejs/kit']) skills.push('Svelte');\n  if (deps.astro) skills.push('Astro');\n\n  return skills;\n};\n\nexport interface PlatformMetadata {\n  label: string;\n  dir: string;\n  check?: () => boolean;\n}\n\n/**\n * Metadata and configuration for each supported platform.\n */\nexport const PLATFORMS_METADATA: Record<string, PlatformMetadata> = {\n  Cursor: {\n    label: 'Cursor',\n    dir: '.cursor/skills',\n    check: () =>\n      process.env.CURSOR === 'true' || process.env.TERM_PROGRAM === 'cursor',\n  },\n  Windsurf: {\n    label: 'Windsurf',\n    dir: '.windsurf/skills',\n    check: () =>\n      process.env.WINDSURF === 'true' ||\n      process.env.TERM_PROGRAM === 'windsurf',\n  },\n  Trae: {\n    label: 'Trae',\n    dir: '.trae/skills',\n    check: () =>\n      process.env.TRAE === 'true' || process.env.TERM_PROGRAM === 'trae',\n  },\n  TraeCN: {\n    label: 'Trae CN',\n    dir: '.trae/skills',\n    check: () => process.env.TRAE_CN === 'true',\n  },\n  VSCode: {\n    label: 'VS Code',\n    dir: '.vscode/skills',\n    check: () =>\n      process.env.VSCODE === 'true' || process.env.TERM_PROGRAM === 'vscode',\n  },\n  OpenCode: {\n    label: 'OpenCode',\n    dir: '.opencode/skills',\n    check: () => process.env.OPENCODE === 'true',\n  },\n  Claude: {\n    label: 'Claude Code',\n    dir: '.claude/skills',\n    check: () => process.env.CLAUDE === 'true',\n  },\n  GitHub: {\n    label: 'GitHub Copilot Workspace',\n    dir: '.github/skills',\n    check: () =>\n      process.env.GITHUB_ACTIONS === 'true' || !!process.env.GITHUB_WORKSPACE,\n  },\n  Antigravity: {\n    label: 'Antigravity',\n    dir: '.agent/skills',\n  },\n  Augment: {\n    label: 'Augment',\n    dir: '.augment/skills',\n  },\n  OpenClaw: {\n    label: 'OpenClaw',\n    dir: 'skills',\n  },\n  Cline: {\n    label: 'Cline',\n    dir: '.cline/skills',\n  },\n  CodeBuddy: {\n    label: 'CodeBuddy',\n    dir: '.codebuddy/skills',\n  },\n  CommandCode: {\n    label: 'Command Code',\n    dir: '.commandcode/skills',\n  },\n  Continue: {\n    label: 'Continue',\n    dir: '.continue/skills',\n  },\n  Crush: {\n    label: 'Crush',\n    dir: '.crush/skills',\n  },\n  Droid: {\n    label: 'Droid',\n    dir: '.factory/skills',\n  },\n  Goose: {\n    label: 'Goose',\n    dir: '.goose/skills',\n  },\n  IFlow: {\n    label: 'iFlow CLI',\n    dir: '.iflow/skills',\n  },\n  Junie: {\n    label: 'Junie',\n    dir: '.junie/skills',\n  },\n  KiloCode: {\n    label: 'Kilo Code',\n    dir: '.kilocode/skills',\n  },\n  Kiro: {\n    label: 'Kiro CLI',\n    dir: '.kiro/skills',\n  },\n  Kode: {\n    label: 'Kode',\n    dir: '.kode/skills',\n  },\n  MCPJam: {\n    label: 'MCPJam',\n    dir: '.mcpjam/skills',\n  },\n  MistralVibe: {\n    label: 'Mistral Vibe',\n    dir: '.vibe/skills',\n  },\n  Mux: {\n    label: 'Mux',\n    dir: '.mux/skills',\n  },\n  OpenHands: {\n    label: 'OpenHands',\n    dir: '.openhands/skills',\n  },\n  Pi: {\n    label: 'Pi',\n    dir: '.pi/skills',\n  },\n  Qoder: {\n    label: 'Qoder',\n    dir: '.qoder/skills',\n  },\n  Qwen: {\n    label: 'Qwen Code',\n    dir: '.qwen/skills',\n  },\n  RooCode: {\n    label: 'Roo Code',\n    dir: '.roo/skills',\n  },\n  Zencoder: {\n    label: 'Zencoder',\n    dir: '.zencoder/skills',\n  },\n  Neovate: {\n    label: 'Neovate',\n    dir: '.neovate/skills',\n  },\n  Pochi: {\n    label: 'Pochi',\n    dir: '.pochi/skills',\n  },\n  Other: {\n    label: 'Other',\n    dir: 'skills',\n  },\n} as const;\n\nexport type Platform = keyof typeof PLATFORMS_METADATA;\n\nexport const PLATFORMS = Object.keys(PLATFORMS_METADATA) as Platform[];\n\n/**\n * Maps specific skill keys to special filenames if they differ from standard snake_case.\n */\nconst SKILL_FILENAME_MAP: Partial<Record<Skill, string>> = {};\n\n/**\n * Helper to convert CamelCase to kebab-case for directory naming\n */\nconst camelToKebabCase = (str: string) =>\n  str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\n/**\n * Reads the raw markdown content for a specific skill from the assets folder.\n */\nconst getSkillContent = (skill: Skill): string => {\n  const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n  const fileName = `./skills/${baseName}.md`;\n\n  try {\n    return readAsset(fileName);\n  } catch {\n    console.warn(\n      `Warning: Could not read asset for skill: ${skill} at ${fileName}`\n    );\n    return '';\n  }\n};\n\n/**\n * Reads the licence content from the assets folder.\n */\nconst getLicenceContent = (): string => {\n  try {\n    return readAsset('./LICENCE.md');\n  } catch {\n    console.warn('Warning: Could not read LICENCE.md asset');\n    return '';\n  }\n};\n\n/**\n * Fetches the content of a URL using native fetch.\n */\nconst fetchUrlContent = async (url: string): Promise<string> => {\n  const response = await fetch(url);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.statusText}`);\n  }\n  return response.text();\n};\n\n/**\n * Installs skills using the \"Agent Skills\" directory standard.\n * Standard: <PROJECT_ROOT>/<CONFIG_DIR>/skills/<SKILL_NAME>/SKILL.md\n */\nexport const installSkills = async (\n  projectRoot: string,\n  platform: Platform,\n  skills: Skill[]\n): Promise<string> => {\n  // Determine destination directory\n  const relativeDir = PLATFORMS_METADATA[platform].dir ?? 'skills';\n  const skillsBaseDir = path.join(projectRoot, relativeDir);\n\n  // Ensure the base directory exists\n  await fs.mkdir(skillsBaseDir, { recursive: true });\n\n  const createdSkills: string[] = [];\n  const licenceContent = getLicenceContent();\n\n  for (const skill of skills) {\n    const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n    const skillName = `intlayer-${baseName}`;\n    const skillContent = getSkillContent(skill);\n\n    if (!skillContent) continue;\n\n    // Extract unique URLs\n    const urls = Array.from(\n      new Set(\n        skillContent.match(/https:\\/\\/intlayer\\.org\\/doc\\/[^\\s)]+\\.md/g) || []\n      )\n    );\n\n    // Agent Standard: .../skills/<skill-name>/SKILL.md\n    const skillDir = path.join(skillsBaseDir, skillName);\n    const referenceDir = path.join(skillDir, 'references');\n\n    // Ensure directories exist\n    await fs.mkdir(referenceDir, { recursive: true });\n\n    // Write License\n    if (licenceContent) {\n      await fs.writeFile(\n        path.join(skillDir, 'LICENCE.md'),\n        licenceContent,\n        'utf-8'\n      );\n    }\n\n    let updatedSkillContent = skillContent;\n\n    // Parallel download of references\n    const downloadPromises = urls.map(async (url) => {\n      try {\n        const content = await fetchUrlContent(url);\n        const metadata = getMarkdownMetadata<{ slugs?: string[] }>(content);\n\n        let fileName = '';\n\n        // Determine filename from slugs or URL path\n        if (Array.isArray(metadata.slugs)) {\n          fileName = metadata.slugs.filter((slug) => slug !== 'doc').join('_');\n        } else {\n          const urlPath = new URL(url).pathname;\n          fileName = urlPath\n            .split('/')\n            .filter((part) => part && part !== 'doc')\n            .map((part) => part.replace('.md', '')) // Clean extension for joining\n            .join('_');\n        }\n\n        // Ensure it ends with .md\n        fileName = fileName ? `${fileName}.md` : 'index.md';\n        const localRefPath = `references/${fileName}`;\n\n        return {\n          url,\n          localRefPath,\n          fileName,\n          content,\n          success: true,\n        };\n      } catch (error) {\n        console.warn(\n          `Warning: Failed to download ref ${url} for skill ${skill}`,\n          error\n        );\n        return { url, success: false };\n      }\n    });\n\n    const results = await Promise.all(downloadPromises);\n\n    // Process results: Write files and update content string\n    for (const res of results) {\n      if (res.success && res.fileName && res.content && res.localRefPath) {\n        // Write the reference file\n        await fs.writeFile(\n          path.join(referenceDir, res.fileName),\n          res.content,\n          'utf-8'\n        );\n\n        // Update the main content to point to local file\n        updatedSkillContent = updatedSkillContent.replaceAll(\n          res.url,\n          res.localRefPath\n        );\n      }\n    }\n\n    // Write the main SKILL.md\n    const filePath = path.join(skillDir, 'SKILL.md');\n    await fs.writeFile(filePath, updatedSkillContent, 'utf-8');\n    createdSkills.push(`${skillName}/SKILL.md`);\n  }\n\n  if (createdSkills.length === 0) {\n    return `No skill files were created. Check your asset paths.`;\n  }\n\n  return `${v} Created ${createdSkills.length} skills in ${skillsBaseDir}`;\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["fs"],"sources":["../../../src/installSkills/index.ts"],"sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { readAsset } from 'utils:asset';\nimport { v } from '@intlayer/config/logger';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\n\n/**\n * Metadata for each available documentation skill.\n */\nexport const SKILLS_METADATA = {\n  Config: 'Intlayer configuration documentation',\n  Content: 'Reference for all Intlayer content node types (t, enu, etc.)',\n  Usage: 'How to use Intlayer in your project',\n  CLI: 'Intlayer CLI commands and usage',\n  Compiler:\n    'Intlayer Compiler setup and usage for automatic content extraction without .content files',\n  RemoteContent: 'How to use Intlayer with Remote/CMS/Server-side content',\n  NextJS: 'Next.js-specific usage (Server & Client components)',\n  React: 'React-specific syntax and hooks usage',\n  Vue: 'Vue-specific composables and syntax',\n  Svelte: 'Svelte-specific stores and syntax',\n  Angular: 'Angular-specific syntax and Injectable Function usage',\n  Preact: 'Preact-specific syntax and hooks usage',\n  Solid:\n    'Integrates Intlayer internationalization with SolidJS components. Use when the user asks to \"setup SolidJS i18n\", use the \"useIntlayer\" hook in Solid, or manage locales in a SolidJS application.',\n  Astro: 'Astro-specific usage and getIntlayer',\n} as const;\n\nexport type Skill = keyof typeof SKILLS_METADATA;\n\nexport const SKILLS = Object.keys(SKILLS_METADATA) as Skill[];\n\nexport const getInitialSkills = (\n  deps: Record<string, string>\n): (keyof typeof SKILLS_METADATA)[] => {\n  const skills: (keyof typeof SKILLS_METADATA)[] = [\n    'Usage',\n    'Content',\n    'Config',\n    'CLI',\n    'Compiler',\n  ];\n\n  if (deps.next) skills.push('NextJS');\n  if (deps.react || !deps.next) skills.push('React');\n  if (deps.preact) skills.push('Preact');\n  if (deps['solid-js']) skills.push('Solid');\n  if (deps.vue || deps.nuxt) skills.push('Vue');\n  if (deps.svelte || deps['@sveltejs/kit']) skills.push('Svelte');\n  if (deps.astro) skills.push('Astro');\n\n  return skills;\n};\n\nexport interface PlatformMetadata {\n  label: string;\n  dir: string;\n  check?: () => boolean;\n}\n\n/**\n * Metadata and configuration for each supported platform.\n */\nexport const PLATFORMS_METADATA: Record<string, PlatformMetadata> = {\n  Cursor: {\n    label: 'Cursor',\n    dir: '.cursor/skills',\n    check: () =>\n      process.env.CURSOR === 'true' || process.env.TERM_PROGRAM === 'cursor',\n  },\n  Windsurf: {\n    label: 'Windsurf',\n    dir: '.windsurf/skills',\n    check: () =>\n      process.env.WINDSURF === 'true' ||\n      process.env.TERM_PROGRAM === 'windsurf',\n  },\n  Trae: {\n    label: 'Trae',\n    dir: '.trae/skills',\n    check: () =>\n      process.env.TRAE === 'true' || process.env.TERM_PROGRAM === 'trae',\n  },\n  TraeCN: {\n    label: 'Trae CN',\n    dir: '.trae/skills',\n    check: () => process.env.TRAE_CN === 'true',\n  },\n  VSCode: {\n    label: 'VS Code',\n    dir: '.vscode/skills',\n    check: () =>\n      process.env.VSCODE === 'true' || process.env.TERM_PROGRAM === 'vscode',\n  },\n  OpenCode: {\n    label: 'OpenCode',\n    dir: '.opencode/skills',\n    check: () => process.env.OPENCODE === 'true',\n  },\n  Claude: {\n    label: 'Claude Code',\n    dir: '.claude/skills',\n    check: () => process.env.CLAUDE === 'true',\n  },\n  GitHub: {\n    label: 'GitHub Copilot Workspace',\n    dir: '.github/skills',\n    check: () =>\n      process.env.GITHUB_ACTIONS === 'true' || !!process.env.GITHUB_WORKSPACE,\n  },\n  Antigravity: {\n    label: 'Antigravity',\n    dir: '.agent/skills',\n  },\n  Augment: {\n    label: 'Augment',\n    dir: '.augment/skills',\n  },\n  OpenClaw: {\n    label: 'OpenClaw',\n    dir: 'skills',\n  },\n  Cline: {\n    label: 'Cline',\n    dir: '.cline/skills',\n  },\n  CodeBuddy: {\n    label: 'CodeBuddy',\n    dir: '.codebuddy/skills',\n  },\n  CommandCode: {\n    label: 'Command Code',\n    dir: '.commandcode/skills',\n  },\n  Continue: {\n    label: 'Continue',\n    dir: '.continue/skills',\n  },\n  Crush: {\n    label: 'Crush',\n    dir: '.crush/skills',\n  },\n  Droid: {\n    label: 'Droid',\n    dir: '.factory/skills',\n  },\n  Goose: {\n    label: 'Goose',\n    dir: '.goose/skills',\n  },\n  IFlow: {\n    label: 'iFlow CLI',\n    dir: '.iflow/skills',\n  },\n  Junie: {\n    label: 'Junie',\n    dir: '.junie/skills',\n  },\n  KiloCode: {\n    label: 'Kilo Code',\n    dir: '.kilocode/skills',\n  },\n  Kiro: {\n    label: 'Kiro CLI',\n    dir: '.kiro/skills',\n  },\n  Kode: {\n    label: 'Kode',\n    dir: '.kode/skills',\n  },\n  MCPJam: {\n    label: 'MCPJam',\n    dir: '.mcpjam/skills',\n  },\n  MistralVibe: {\n    label: 'Mistral Vibe',\n    dir: '.vibe/skills',\n  },\n  Mux: {\n    label: 'Mux',\n    dir: '.mux/skills',\n  },\n  OpenHands: {\n    label: 'OpenHands',\n    dir: '.openhands/skills',\n  },\n  Pi: {\n    label: 'Pi',\n    dir: '.pi/skills',\n  },\n  Qoder: {\n    label: 'Qoder',\n    dir: '.qoder/skills',\n  },\n  Qwen: {\n    label: 'Qwen Code',\n    dir: '.qwen/skills',\n  },\n  RooCode: {\n    label: 'Roo Code',\n    dir: '.roo/skills',\n  },\n  Zencoder: {\n    label: 'Zencoder',\n    dir: '.zencoder/skills',\n  },\n  Neovate: {\n    label: 'Neovate',\n    dir: '.neovate/skills',\n  },\n  Pochi: {\n    label: 'Pochi',\n    dir: '.pochi/skills',\n  },\n  Other: {\n    label: 'Other',\n    dir: 'skills',\n  },\n} as const;\n\nexport type Platform = keyof typeof PLATFORMS_METADATA;\n\nexport const PLATFORMS = Object.keys(PLATFORMS_METADATA) as Platform[];\n\n/**\n * Maps specific skill keys to special filenames if they differ from standard snake_case.\n */\nconst SKILL_FILENAME_MAP: Partial<Record<Skill, string>> = {};\n\n/**\n * Helper to convert CamelCase to kebab-case for directory naming\n */\nconst camelToKebabCase = (str: string) =>\n  str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n\n/**\n * Reads the raw markdown content for a specific skill from the assets folder.\n */\nconst getSkillContent = (skill: Skill): string => {\n  const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n  const fileName = `./skills/${baseName}.md`;\n\n  try {\n    return readAsset(fileName);\n  } catch {\n    console.warn(\n      `Warning: Could not read asset for skill: ${skill} at ${fileName}`\n    );\n    return '';\n  }\n};\n\n/**\n * Reads the licence content from the assets folder.\n */\nconst getLicenceContent = (): string => {\n  try {\n    return readAsset('./LICENCE.md');\n  } catch {\n    console.warn('Warning: Could not read LICENCE.md asset');\n    return '';\n  }\n};\n\nconst ALLOWED_FETCH_HOSTS = new Set(['intlayer.org']);\n\n/**\n * Fetches the content of a URL using native fetch.\n */\nconst fetchUrlContent = async (url: string): Promise<string> => {\n  const parsed = new URL(url);\n  if (\n    parsed.protocol !== 'https:' ||\n    !ALLOWED_FETCH_HOSTS.has(parsed.hostname)\n  ) {\n    throw new Error(`Blocked fetch to disallowed host: ${parsed.hostname}`);\n  }\n  const response = await fetch(url, { redirect: 'error' });\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.statusText}`);\n  }\n  return response.text();\n};\n\n/**\n * Installs skills using the \"Agent Skills\" directory standard.\n * Standard: <PROJECT_ROOT>/<CONFIG_DIR>/skills/<SKILL_NAME>/SKILL.md\n */\nexport const installSkills = async (\n  projectRoot: string,\n  platform: Platform,\n  skills: Skill[]\n): Promise<string> => {\n  // Determine destination directory\n  const relativeDir = PLATFORMS_METADATA[platform].dir ?? 'skills';\n  const skillsBaseDir = path.join(projectRoot, relativeDir);\n\n  // Ensure the base directory exists\n  await fs.mkdir(skillsBaseDir, { recursive: true });\n\n  const createdSkills: string[] = [];\n  const licenceContent = getLicenceContent();\n\n  for (const skill of skills) {\n    const baseName = SKILL_FILENAME_MAP[skill] ?? camelToKebabCase(skill);\n    const skillName = `intlayer-${baseName}`;\n    const skillContent = getSkillContent(skill);\n\n    if (!skillContent) continue;\n\n    // Extract unique URLs\n    const urls = Array.from(\n      new Set(skillContent.match(/https:\\/\\/intlayer\\.org\\/[^\\s)]+\\.md/g) || [])\n    );\n\n    // Agent Standard: .../skills/<skill-name>/SKILL.md\n    const skillDir = path.join(skillsBaseDir, skillName);\n    const referenceDir = path.join(skillDir, 'references');\n\n    // Ensure directories exist\n    await fs.mkdir(referenceDir, { recursive: true });\n\n    // Write License\n    if (licenceContent) {\n      await fs.writeFile(\n        path.join(skillDir, 'LICENCE.md'),\n        licenceContent,\n        'utf-8'\n      );\n    }\n\n    let updatedSkillContent = skillContent;\n\n    // Parallel download of references\n    const downloadPromises = urls.map(async (url) => {\n      try {\n        const content = await fetchUrlContent(url);\n        const metadata = getMarkdownMetadata<{ slugs?: string[] }>(content);\n\n        let fileName = '';\n\n        // Determine filename from slugs or URL path\n        if (Array.isArray(metadata.slugs)) {\n          fileName = metadata.slugs.filter((slug) => slug !== 'doc').join('_');\n        } else {\n          const urlPath = new URL(url).pathname;\n          fileName = urlPath\n            .split('/')\n            .filter((part) => part && part !== 'doc')\n            .map((part) => part.replace('.md', '')) // Clean extension for joining\n            .join('_');\n        }\n\n        // Ensure it ends with .md\n        fileName = fileName ? `${fileName}.md` : 'index.md';\n        const localRefPath = `references/${fileName}`;\n\n        return {\n          url,\n          localRefPath,\n          fileName,\n          content,\n          success: true,\n        };\n      } catch (error) {\n        console.warn(\n          `Warning: Failed to download ref ${url} for skill ${skill}`,\n          error\n        );\n        return { url, success: false };\n      }\n    });\n\n    const results = await Promise.all(downloadPromises);\n\n    // Process results: Write files and update content string\n    for (const res of results) {\n      if (res.success && res.fileName && res.content && res.localRefPath) {\n        // Write the reference file\n        await fs.writeFile(\n          path.join(referenceDir, res.fileName),\n          res.content,\n          'utf-8'\n        );\n\n        // Update the main content to point to local file\n        updatedSkillContent = updatedSkillContent.replaceAll(\n          res.url,\n          res.localRefPath\n        );\n      }\n    }\n\n    // Write the main SKILL.md\n    const filePath = path.join(skillDir, 'SKILL.md');\n    await fs.writeFile(filePath, updatedSkillContent, 'utf-8');\n    createdSkills.push(`${skillName}/SKILL.md`);\n  }\n\n  if (createdSkills.length === 0) {\n    return `No skill files were created. Check your asset paths.`;\n  }\n\n  return `${v} Created ${createdSkills.length} skills in ${skillsBaseDir}`;\n};\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"writeDynamicDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"mappings":";;;;;;KAaY,gBAAA;EACV,cAAA;EACA,UAAA,EAAY,UAAA;AAAA;AAAA,KAGF,yBAAA,GAA4B,OAAA,CACtC,MAAA,CAAO,MAAA,EAAQ,gBAAA;AAAA,KAGL,yBAAA,GAA4B,MAAA,SAEtC,yBAAA;;;;cAQW,4BAAA,GACX,GAAA,UACA,OAAA,YACA,MAAA;;AAjBF;;;;;;;;;;;;;;;cAwDa,sBAAA,GACX,kBAAA,EAAoB,sBAAA,EACpB,aAAA,EAAe,cAAA,EACf,OAAA,yBACC,OAAA,CAAQ,yBAAA"}
+{"version":3,"file":"writeDynamicDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeDynamicDictionary.ts"],"mappings":";;;;;;KAcY,gBAAA;EACV,cAAA;EACA,UAAA,EAAY,UAAA;AAAA;AAAA,KAGF,yBAAA,GAA4B,OAAA,CACtC,MAAA,CAAO,MAAA,EAAQ,gBAAA;AAAA,KAGL,yBAAA,GAA4B,MAAA,SAEtC,yBAAA;;;;cAQW,4BAAA,GACX,GAAA,UACA,OAAA,YACA,MAAA;;AAjBF;;;;;;;;;;;;;;;cAwDa,sBAAA,GACX,kBAAA,EAAoB,sBAAA,EACpB,aAAA,EAAe,cAAA,EACf,OAAA,yBACC,OAAA,CAAQ,yBAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"writeMergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"mappings":";;;;;KAaY,sBAAA;EACV,cAAA;EACA,UAAA,EAAY,UAAA;AAAA;AAAA,KAGF,sBAAA,GAAyB,MAAA,SAAe,sBAAA;;;;;;;AAApD;;;;;AAkBA;;;;;cAAa,uBAAA,GACX,mBAAA,EAAqB,wBAAA,EACrB,aAAA,EAAe,cAAA,KACd,OAAA,CAAQ,sBAAA"}
+{"version":3,"file":"writeMergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeMergedDictionary.ts"],"mappings":";;;;;KAcY,sBAAA;EACV,cAAA;EACA,UAAA,EAAY,UAAA;AAAA;AAAA,KAGF,sBAAA,GAAyB,MAAA,SAAe,sBAAA;;;;;;;AAApD;;;;;AAkBA;;;;;cAAa,uBAAA,GACX,mBAAA,EAAqB,wBAAA,EACrB,aAAA,EAAe,cAAA,KACd,OAAA,CAAQ,sBAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"writeUnmergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"mappings":";;;;cAUa,sBAAA,GACX,YAAA,EAAc,UAAA,OACb,MAAA,SAAe,UAAA;AAAA,KAaN,wBAAA;EACV,cAAA;EACA,YAAA,EAAc,UAAA;AAAA;AAAA,KAGJ,wBAAA,GAA2B,MAAA,CACrC,aAAA,EACA,wBAAA;;;;;;;;;;;AAPF;;;;;;;;;AAKA;cAyBa,yBAAA,GACX,YAAA,EAAc,UAAA,IACd,aAAA,EAAe,cAAA,EACf,GAAA,qBACC,OAAA,CAAQ,wBAAA"}
+{"version":3,"file":"writeUnmergedDictionary.d.ts","names":[],"sources":["../../../src/buildIntlayerDictionary/writeUnmergedDictionary.ts"],"mappings":";;;;cAWa,sBAAA,GACX,YAAA,EAAc,UAAA,OACb,MAAA,SAAe,UAAA;AAAA,KAaN,wBAAA;EACV,cAAA;EACA,YAAA,EAAc,UAAA;AAAA;AAAA,KAGJ,wBAAA,GAA2B,MAAA,CACrC,aAAA,EACA,wBAAA;;;;;;;;;;;AAPF;;;;;;;;;AAKA;cAyBa,yBAAA,GACX,YAAA,EAAc,UAAA,IACd,aAAA,EAAe,cAAA,EACf,GAAA,qBACC,OAAA,CAAQ,wBAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/installSkills/index.ts"],"mappings":";;AASA;;cAAa,eAAA;EAAA;;;;;;;;;;;;;;;KAmBD,KAAA,gBAAqB,eAAA;AAAA,cAEpB,MAAA,EAAyC,KAAA;AAAA,cAEzC,gBAAA,GACX,IAAA,EAAM,MAAA,mCACS,eAAA;AAAA,UAoBA,gBAAA;EACf,KAAA;EACA,GAAA;EACA,KAAA;AAAA;;;;cAMW,kBAAA,EAAoB,MAAA,SAAe,gBAAA;AAAA,KA6JpC,QAAA,gBAAwB,kBAAA;AAAA,cAEvB,SAAA,EAA+C,QAAA;;;;;cAyD/C,aAAA,GACX,WAAA,UACA,QAAA,EAAU,QAAA,EACV,MAAA,EAAQ,KAAA,OACP,OAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/installSkills/index.ts"],"mappings":";;AASA;;cAAa,eAAA;EAAA;;;;;;;;;;;;;;;KAmBD,KAAA,gBAAqB,eAAA;AAAA,cAEpB,MAAA,EAAyC,KAAA;AAAA,cAEzC,gBAAA,GACX,IAAA,EAAM,MAAA,mCACS,eAAA;AAAA,UAoBA,gBAAA;EACf,KAAA;EACA,GAAA;EACA,KAAA;AAAA;;;;cAMW,kBAAA,EAAoB,MAAA,SAAe,gBAAA;AAAA,KA6JpC,QAAA,gBAAwB,kBAAA;AAAA,cAEvB,SAAA,EAA+C,QAAA;;;;;cAkE/C,aAAA,GACX,WAAA,UACA,QAAA,EAAU,QAAA,EACV,MAAA,EAAQ,KAAA,OACP,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/chokidar",
-  "version": "8.9.5",
+  "version": "8.9.6",
   "private": false,
   "description": "Uses chokidar to scan and build Intlayer declaration files into dictionaries based on Intlayer configuration.",
   "keywords": [
@@ -109,13 +109,13 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "8.9.5",
-    "@intlayer/config": "8.9.5",
-    "@intlayer/core": "8.9.5",
-    "@intlayer/dictionaries-entry": "8.9.5",
-    "@intlayer/remote-dictionaries-entry": "8.9.5",
-    "@intlayer/types": "8.9.5",
-    "@intlayer/unmerged-dictionaries-entry": "8.9.5",
+    "@intlayer/api": "8.9.6",
+    "@intlayer/config": "8.9.6",
+    "@intlayer/core": "8.9.6",
+    "@intlayer/dictionaries-entry": "8.9.6",
+    "@intlayer/remote-dictionaries-entry": "8.9.6",
+    "@intlayer/types": "8.9.6",
+    "@intlayer/unmerged-dictionaries-entry": "8.9.6",
     "chokidar": "5.0.0",
     "defu": "6.1.7",
     "fast-glob": "3.3.3",
@@ -124,7 +124,7 @@
     "zod-to-ts": "2.0.0"
   },
   "devDependencies": {
-    "@types/node": "25.7.0",
+    "@types/node": "25.8.0",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",