@intlayer/core 6.1.6-canary.0 → 7.0.0-canary.0

package/dist/esm/deepTransformPlugins/getFilterMissingTranslationsContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilterMissingTranslationsContent.mjs","names":["deepTransformNode","tCore","result: Record<string, any>","arrayKeysIncluded: string[]","primitiveSiblingsToAppend: any[]","plugins: Plugins[]"],"sources":["../../../src/deepTransformPlugins/getFilterMissingTranslationsContent.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type {\n  DeclaredLocales,\n  Dictionary,\n  LocalesValues,\n} from '@intlayer/types';\nimport { type ContentNode, type KeyPath, NodeType } from '@intlayer/types';\nimport {\n  type DeepTransformContent,\n  getTranslation,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport { type TranslationContent, t as tCore } from '../transpiler';\n\n/**\n * Helper function to check if a node or its children contain translation nodes\n */\nconst hasTranslationNodes = (node: any): boolean => {\n  if (typeof node !== 'object' || node === null) {\n    return false;\n  }\n\n  if (node?.nodeType === NodeType.Translation) {\n    return true;\n  }\n\n  if (Array.isArray(node)) {\n    return node.some(hasTranslationNodes);\n  }\n\n  return Object.values(node).some(hasTranslationNodes);\n};\n\n/**\n * Get all keys from an object, recursively\n */\nconst getObjectKeys = (obj: any): Set<string> => {\n  const keys = new Set<string>();\n\n  if (typeof obj !== 'object' || obj === null) {\n    return keys;\n  }\n\n  for (const key in obj) {\n    keys.add(key);\n  }\n\n  return keys;\n};\n\n/**\n * Check if two objects have the same structure (same keys)\n */\nconst hasSameStructure = (obj1: any, obj2: any): boolean => {\n  if (typeof obj1 !== 'object' || typeof obj2 !== 'object') {\n    return typeof obj1 === typeof obj2;\n  }\n\n  if (obj1 === null || obj2 === null) {\n    return obj1 === obj2;\n  }\n\n  if (Array.isArray(obj1) !== Array.isArray(obj2)) {\n    return false;\n  }\n\n  const keys1 = getObjectKeys(obj1);\n  const keys2 = getObjectKeys(obj2);\n\n  if (keys1.size !== keys2.size) {\n    return false;\n  }\n\n  for (const key of keys1) {\n    if (!keys2.has(key)) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/**\n * Check if all locales in a translation node have the same structure (recursively)\n * Returns an object with locales that have missing keys\n */\nconst checkTranslationStructureConsistency = (\n  translationNode: Record<string, any>\n): { hasInconsistency: boolean; localesWithMissingKeys: Set<string> } => {\n  const locales = Object.keys(translationNode);\n  const localesWithMissingKeys = new Set<string>();\n\n  if (locales.length <= 1) {\n    return { hasInconsistency: false, localesWithMissingKeys };\n  }\n\n  // Helper function to check structure recursively\n  const checkStructureRecursive = (\n    path: string,\n    localeValues: Map<string, any>\n  ): Set<string> => {\n    const localesWithIssues = new Set<string>();\n\n    // Get all unique keys across all locale values at this path\n    const allKeys = new Set<string>();\n    const objectLocales = new Map<string, any>();\n\n    for (const [locale, value] of localeValues.entries()) {\n      if (\n        typeof value === 'object' &&\n        value !== null &&\n        !Array.isArray(value)\n      ) {\n        objectLocales.set(locale, value);\n        const keys = getObjectKeys(value);\n        for (const key of keys) {\n          allKeys.add(key);\n        }\n      }\n    }\n\n    // If no objects at this level, no inconsistency\n    if (objectLocales.size === 0) {\n      return localesWithIssues;\n    }\n\n    // Check if each locale has all the keys at this level\n    for (const [locale, value] of objectLocales.entries()) {\n      const keys = getObjectKeys(value);\n      if (keys.size !== allKeys.size) {\n        localesWithIssues.add(locale);\n      }\n    }\n\n    // Recursively check nested objects\n    for (const key of allKeys) {\n      const nestedValues = new Map<string, any>();\n      for (const [locale, value] of objectLocales.entries()) {\n        if (value[key] !== undefined) {\n          nestedValues.set(locale, value[key]);\n        }\n      }\n\n      if (nestedValues.size > 1) {\n        const nestedIssues = checkStructureRecursive(\n          path ? `${path}.${key}` : key,\n          nestedValues\n        );\n        for (const locale of nestedIssues) {\n          localesWithIssues.add(locale);\n        }\n      }\n    }\n\n    return localesWithIssues;\n  };\n\n  // Start recursive check from root\n  const rootValues = new Map<string, any>();\n  for (const locale of locales) {\n    rootValues.set(locale, translationNode[locale]);\n  }\n\n  const issuesFound = checkStructureRecursive('', rootValues);\n  const hasInconsistency = issuesFound.size > 0;\n\n  for (const locale of issuesFound) {\n    localesWithMissingKeys.add(locale);\n  }\n\n  return { hasInconsistency, localesWithMissingKeys };\n};\n\n/**\n * Check if array elements have consistent structures\n */\nconst checkArrayStructureConsistency = (arr: any[]): boolean => {\n  if (arr.length <= 1) {\n    return true;\n  }\n\n  const firstElement = arr[0];\n\n  for (let i = 1; i < arr.length; i++) {\n    if (!hasSameStructure(firstElement, arr[i])) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const filterMissingTranslationsOnlyPlugin = (\n  localeToCheck: LocalesValues\n): Plugins => ({\n  id: 'filter-missing-translations-only-plugin',\n  canHandle: (node: ContentNode) => {\n    // Only handle objects and arrays, not primitives\n    return typeof node === 'object' && node !== null;\n  },\n  transform: (node: ContentNode, props, deepTransformNode) => {\n    if (typeof node === 'object' && node?.nodeType === NodeType.Translation) {\n      const result = structuredClone(\n        (node as TranslationContent)[NodeType.Translation]\n      );\n\n      const hasLocaleTranslation = Object.keys(result).includes(localeToCheck);\n\n      // Check for structural inconsistencies across locales\n      const { hasInconsistency, localesWithMissingKeys } =\n        checkTranslationStructureConsistency(result);\n\n      // If there's a structural inconsistency and the locale being checked\n      // has missing keys, treat it as a missing translation\n      const hasStructuralIssue =\n        hasInconsistency && localesWithMissingKeys.has(localeToCheck);\n\n      if (hasLocaleTranslation && !hasStructuralIssue) {\n        return undefined; // Return undefined to remove the node\n      }\n\n      // Transform nested content\n      for (const key in result) {\n        const childProps = {\n          ...props,\n          children: result[key as unknown as keyof typeof result],\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeType.Translation, key } as KeyPath,\n          ],\n        };\n        result[key as unknown as keyof typeof result] = deepTransformNode(\n          result[key as unknown as keyof typeof result],\n          {\n            ...childProps,\n            plugins: [\n              ...(props.plugins ?? ([] as Plugins[])).filter(\n                (plugin) =>\n                  plugin.id !== 'filter-missing-translations-only-plugin'\n              ),\n            ],\n          }\n        );\n      }\n\n      // Return the base locale content as a translation node\n      // If base locale is missing, use any available locale as fallback\n      const baseLocale = configuration?.internationalization?.defaultLocale;\n      const availableLocales = Object.keys(result);\n\n      if (availableLocales.length === 0) {\n        return undefined; // No translations available\n      }\n\n      // Try to get the base locale first, then any available locale as fallback\n      const fallbackLocale = availableLocales.includes(baseLocale)\n        ? baseLocale\n        : availableLocales[0];\n\n      const fallbackValue = getTranslation(result, baseLocale, fallbackLocale);\n\n      // Return the translation node structure with only the fallback locale\n      return tCore({ [fallbackLocale]: fallbackValue });\n    } else if (\n      typeof node === 'object' &&\n      node !== null &&\n      !Array.isArray(node) &&\n      !node?.nodeType\n    ) {\n      // For regular objects, include only children that are related to translations\n      // - Keep children that contain translation nodes (directly or nested)\n      // - Keep arrays (they may mix translated and non-translated values)\n      // - Exclude primitive values (string/number/boolean/null/undefined) at object level\n      const result: Record<string, any> = {};\n      let hasMissingTranslations = false;\n      const arrayKeysIncluded: string[] = [];\n      const primitiveSiblingsToAppend: any[] = [];\n\n      for (const key in node as any) {\n        const originalChild = (node as any)[key];\n        const childProps = {\n          ...props,\n          children: originalChild,\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeType.Object, key } as KeyPath,\n          ],\n        };\n        const transformedChild = deepTransformNode(originalChild, childProps);\n\n        const isPrimitiveSibling =\n          originalChild === null ||\n          (typeof originalChild !== 'object' &&\n            typeof originalChild !== 'function');\n\n        if (isPrimitiveSibling) {\n          // Defer primitives; they may be appended to an array sibling later\n          if (originalChild !== undefined) {\n            primitiveSiblingsToAppend.push(originalChild);\n          }\n          continue;\n        }\n\n        const includeChild =\n          transformedChild !== undefined &&\n          (hasTranslationNodes(originalChild) || Array.isArray(originalChild));\n\n        if (includeChild) {\n          result[key] = transformedChild;\n          hasMissingTranslations = true;\n          if (Array.isArray(transformedChild)) {\n            arrayKeysIncluded.push(key);\n          }\n        }\n      }\n\n      // If any array child is present, append primitive siblings into the first array\n      if (\n        arrayKeysIncluded.length > 0 &&\n        primitiveSiblingsToAppend.length > 0\n      ) {\n        const targetArrayKey = arrayKeysIncluded[0];\n        // Ensure array exists in result (it should, but be defensive)\n        if (Array.isArray(result[targetArrayKey])) {\n          result[targetArrayKey] = [\n            ...result[targetArrayKey],\n            ...primitiveSiblingsToAppend,\n          ];\n          hasMissingTranslations = true;\n        }\n      }\n\n      // Only return the object if it has missing translations-related content\n      return hasMissingTranslations ? result : undefined;\n    } else if (Array.isArray(node)) {\n      // Check if array elements have consistent structures\n      const hasConsistentStructure = checkArrayStructureConsistency(node);\n\n      // For arrays, only include items that have missing translations\n      const result = node\n        .map((child, index) => {\n          const childProps = {\n            ...props,\n            children: child,\n            keyPath: [\n              ...props.keyPath,\n              { type: NodeType.Array, key: index } as KeyPath,\n            ],\n          };\n          return deepTransformNode(child, childProps);\n        })\n        .filter((item) => item !== null && item !== undefined);\n\n      // If there's structural inconsistency in the array, include it\n      // even if it has no missing translations, to flag the issue\n      if (!hasConsistentStructure && result.length === 0) {\n        // Return a marker to indicate structural inconsistency\n        return node; // Return original array to show the issue\n      }\n\n      // Only return the array if it has items with missing translations\n      return result.length > 0 ? result : undefined;\n    }\n\n    return node; // Return non-translation content as is\n  },\n});\n\n/**\n * For each translation node, it compare is both localeToCheck and baseLocale are present.\n *\n * If yes, it should remove the node from the content.\n * If no, it should keep the node\n *\n * In complete mode, for large dictionaries, we want to filter all content that is already translated\n *\n * locale: fr\n *\n * { test1: t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' } }) -> {}\n * { test2: t({ ar: 'Hello', en: 'Hello' }) } -> { test2: t({ ar: 'Hello', en: 'Hello' }) }\n *\n */\nexport const getFilterMissingTranslationsContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  localeToCheck: L,\n  nodeProps: NodeProps\n) => {\n  const plugins: Plugins[] = [\n    filterMissingTranslationsOnlyPlugin(localeToCheck),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  const result = deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n\n  // Stringify the result to remove the undefined values\n  if (result === undefined) {\n    // No missing translations found\n    return {} as DeepTransformContent<T>;\n  }\n  return JSON.parse(JSON.stringify(result));\n};\n\nexport const getFilterMissingTranslationsDictionary = (\n  dictionary: Dictionary,\n  localeToCheck: LocalesValues\n) => ({\n  ...dictionary,\n  content: getFilterMissingTranslationsContent(\n    dictionary.content,\n    localeToCheck,\n    {\n      dictionaryKey: dictionary.key,\n      keyPath: [],\n      plugins: [],\n    }\n  ),\n});\n"],"mappings":"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"}

package/dist/esm/deepTransformPlugins/getFilterTranslationsOnlyContent.mjs

@@ -0,0 +1,90 @@
+import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
+import { getTranslation } from "../interpreter/getTranslation.mjs";
+import { NodeType } from "@intlayer/types";
+import configuration from "@intlayer/config/built";
+
+//#region src/deepTransformPlugins/getFilterTranslationsOnlyContent.ts
+/**
+* Helper function to check if a node or its children contain translation nodes
+*/
+const hasTranslationNodes = (node) => {
+	if (typeof node !== "object" || node === null) return false;
+	if (node?.nodeType === NodeType.Translation) return true;
+	if (Array.isArray(node)) return node.some(hasTranslationNodes);
+	return Object.values(node).some(hasTranslationNodes);
+};
+/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
+const filterTranslationsOnlyPlugin = (locale, fallback) => ({
+	id: "filter-translations-only-plugin",
+	canHandle: (node) => {
+		return typeof node === "object" && node !== null;
+	},
+	transform: (node, props, deepTransformNode$1) => {
+		if (typeof node === "object" && node?.nodeType === NodeType.Translation) {
+			const result = structuredClone(node[NodeType.Translation]);
+			for (const key in result) {
+				const childProps = {
+					...props,
+					children: result[key],
+					keyPath: [...props.keyPath, {
+						type: NodeType.Translation,
+						key
+					}]
+				};
+				result[key] = deepTransformNode$1(result[key], {
+					...childProps,
+					plugins: [...(props.plugins ?? []).filter((plugin) => plugin.id !== "filter-translations-only-plugin")]
+				});
+			}
+			return getTranslation(result, locale, fallback);
+		} else if (typeof node === "object" && node !== null && !Array.isArray(node) && !node?.nodeType) {
+			const result = {};
+			for (const key in node) if (hasTranslationNodes(node[key])) {
+				const childProps = {
+					...props,
+					children: node[key],
+					keyPath: [...props.keyPath, {
+						type: NodeType.Object,
+						key
+					}]
+				};
+				result[key] = deepTransformNode$1(node[key], childProps);
+			}
+			return result;
+		} else if (Array.isArray(node)) return node.map((child, index) => {
+			return deepTransformNode$1(child, {
+				...props,
+				children: child,
+				keyPath: [...props.keyPath, {
+					type: NodeType.Array,
+					key: index
+				}]
+			});
+		});
+		return "to remove from the object";
+	}
+});
+/**
+* Return the content of a node with only the translation plugin.
+*
+* @param node The node to transform.
+* @param locale The locale to use if your transformers need it (e.g. for translations).
+*/
+const getFilterTranslationsOnlyContent = (node, locale = configuration?.internationalization?.defaultLocale, nodeProps, fallback) => {
+	const plugins = [filterTranslationsOnlyPlugin(locale, fallback), ...nodeProps.plugins ?? []];
+	return deepTransformNode(node, {
+		...nodeProps,
+		plugins
+	});
+};
+const getFilterTranslationsOnlyDictionary = (dictionary, locale = configuration?.internationalization?.defaultLocale, fallback) => ({
+	...dictionary,
+	content: getFilterTranslationsOnlyContent(dictionary.content, locale, {
+		dictionaryKey: dictionary.key,
+		keyPath: []
+	}, fallback)
+});
+
+//#endregion
+export { filterTranslationsOnlyPlugin, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary };
+//# sourceMappingURL=getFilterTranslationsOnlyContent.mjs.map

package/dist/esm/deepTransformPlugins/getFilterTranslationsOnlyContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilterTranslationsOnlyContent.mjs","names":["deepTransformNode","result: Record<string, any>","plugins: Plugins[]"],"sources":["../../../src/deepTransformPlugins/getFilterTranslationsOnlyContent.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type {\n  DeclaredLocales,\n  Dictionary,\n  LocalesValues,\n} from '@intlayer/types';\nimport { type ContentNode, type KeyPath, NodeType } from '@intlayer/types';\nimport {\n  type DeepTransformContent,\n  getTranslation,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport type { TranslationContent } from '../transpiler';\n\n/**\n * Helper function to check if a node or its children contain translation nodes\n */\nconst hasTranslationNodes = (node: any): boolean => {\n  if (typeof node !== 'object' || node === null) {\n    return false;\n  }\n\n  if (node?.nodeType === NodeType.Translation) {\n    return true;\n  }\n\n  if (Array.isArray(node)) {\n    return node.some(hasTranslationNodes);\n  }\n\n  return Object.values(node).some(hasTranslationNodes);\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const filterTranslationsOnlyPlugin = (\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Plugins => ({\n  id: 'filter-translations-only-plugin',\n  canHandle: (node: ContentNode) => {\n    // Only handle objects and arrays, not primitives\n    return typeof node === 'object' && node !== null;\n  },\n  transform: (node: ContentNode, props, deepTransformNode) => {\n    if (typeof node === 'object' && node?.nodeType === NodeType.Translation) {\n      const result = structuredClone(\n        (node as TranslationContent)[NodeType.Translation]\n      );\n\n      for (const key in result) {\n        const childProps = {\n          ...props,\n          children: result[key as unknown as keyof typeof result],\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeType.Translation, key } as KeyPath,\n          ],\n        };\n        result[key as unknown as keyof typeof result] = deepTransformNode(\n          result[key as unknown as keyof typeof result],\n          {\n            ...childProps,\n            plugins: [\n              ...(props.plugins ?? ([] as Plugins[])).filter(\n                (plugin) => plugin.id !== 'filter-translations-only-plugin'\n              ),\n            ],\n          }\n        );\n      }\n      return getTranslation(result, locale, fallback);\n    } else if (\n      typeof node === 'object' &&\n      node !== null &&\n      !Array.isArray(node) &&\n      !node?.nodeType\n    ) {\n      // For regular objects, filter out properties that don't contain translations\n      const result: Record<string, any> = {};\n      for (const key in node as any) {\n        if (hasTranslationNodes(node[key as unknown as keyof typeof node])) {\n          const childProps = {\n            ...props,\n            children: node[key as unknown as keyof typeof node],\n            keyPath: [\n              ...props.keyPath,\n              { type: NodeType.Object, key } as KeyPath,\n            ],\n          };\n          result[key] = deepTransformNode(\n            node[key as unknown as keyof typeof node],\n            childProps\n          );\n        }\n      }\n      return result;\n    } else if (Array.isArray(node)) {\n      // For arrays, keep all items but transform them\n      return node.map((child, index) => {\n        const childProps = {\n          ...props,\n          children: child,\n          keyPath: [\n            ...props.keyPath,\n            { type: NodeType.Array, key: index } as KeyPath,\n          ],\n        };\n        return deepTransformNode(child, childProps);\n      });\n    }\n\n    return 'to remove from the object';\n  },\n});\n\n/**\n * Return the content of a node with only the translation plugin.\n *\n * @param node The node to transform.\n * @param locale The locale to use if your transformers need it (e.g. for translations).\n */\nexport const getFilterTranslationsOnlyContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  locale: L = configuration?.internationalization?.defaultLocale as L,\n  nodeProps: NodeProps,\n  fallback?: LocalesValues\n) => {\n  const plugins: Plugins[] = [\n    filterTranslationsOnlyPlugin(locale, fallback),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  return deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n};\n\nexport const getFilterTranslationsOnlyDictionary = (\n  dictionary: Dictionary,\n  locale: LocalesValues = configuration?.internationalization\n    ?.defaultLocale as LocalesValues,\n  fallback?: LocalesValues\n) => ({\n  ...dictionary,\n  content: getFilterTranslationsOnlyContent(\n    dictionary.content,\n    locale,\n    { dictionaryKey: dictionary.key, keyPath: [] },\n    fallback\n  ),\n});\n"],"mappings":";;;;;;;;;AAmBA,MAAM,uBAAuB,SAAuB;AAClD,KAAI,OAAO,SAAS,YAAY,SAAS,KACvC,QAAO;AAGT,KAAI,MAAM,aAAa,SAAS,YAC9B,QAAO;AAGT,KAAI,MAAM,QAAQ,KAAK,CACrB,QAAO,KAAK,KAAK,oBAAoB;AAGvC,QAAO,OAAO,OAAO,KAAK,CAAC,KAAK,oBAAoB;;;AAItD,MAAa,gCACX,QACA,cACa;CACb,IAAI;CACJ,YAAY,SAAsB;AAEhC,SAAO,OAAO,SAAS,YAAY,SAAS;;CAE9C,YAAY,MAAmB,OAAO,wBAAsB;AAC1D,MAAI,OAAO,SAAS,YAAY,MAAM,aAAa,SAAS,aAAa;GACvE,MAAM,SAAS,gBACZ,KAA4B,SAAS,aACvC;AAED,QAAK,MAAM,OAAO,QAAQ;IACxB,MAAM,aAAa;KACjB,GAAG;KACH,UAAU,OAAO;KACjB,SAAS,CACP,GAAG,MAAM,SACT;MAAE,MAAM,SAAS;MAAa;MAAK,CACpC;KACF;AACD,WAAO,OAAyCA,oBAC9C,OAAO,MACP;KACE,GAAG;KACH,SAAS,CACP,IAAI,MAAM,WAAY,EAAE,EAAgB,QACrC,WAAW,OAAO,OAAO,kCAC3B,CACF;KACF,CACF;;AAEH,UAAO,eAAe,QAAQ,QAAQ,SAAS;aAE/C,OAAO,SAAS,YAChB,SAAS,QACT,CAAC,MAAM,QAAQ,KAAK,IACpB,CAAC,MAAM,UACP;GAEA,MAAMC,SAA8B,EAAE;AACtC,QAAK,MAAM,OAAO,KAChB,KAAI,oBAAoB,KAAK,KAAqC,EAAE;IAClE,MAAM,aAAa;KACjB,GAAG;KACH,UAAU,KAAK;KACf,SAAS,CACP,GAAG,MAAM,SACT;MAAE,MAAM,SAAS;MAAQ;MAAK,CAC/B;KACF;AACD,WAAO,OAAOD,oBACZ,KAAK,MACL,WACD;;AAGL,UAAO;aACE,MAAM,QAAQ,KAAK,CAE5B,QAAO,KAAK,KAAK,OAAO,UAAU;AAShC,UAAOA,oBAAkB,OARN;IACjB,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,SAAS;KAAO,KAAK;KAAO,CACrC;IACF,CAC0C;IAC3C;AAGJ,SAAO;;CAEV;;;;;;;AAQD,MAAa,oCAIX,MACA,SAAY,eAAe,sBAAsB,eACjD,WACA,aACG;CACH,MAAME,UAAqB,CACzB,6BAA6B,QAAQ,SAAS,EAC9C,GAAI,UAAU,WAAW,EAAE,CAC5B;AAED,QAAO,kBAAkB,MAAM;EAC7B,GAAG;EACH;EACD,CAAC;;AAGJ,MAAa,uCACX,YACA,SAAwB,eAAe,sBACnC,eACJ,cACI;CACJ,GAAG;CACH,SAAS,iCACP,WAAW,SACX,QACA;EAAE,eAAe,WAAW;EAAK,SAAS,EAAE;EAAE,EAC9C,SACD;CACF"}

package/dist/esm/deepTransformPlugins/getFilteredLocalesContent.mjs

@@ -0,0 +1,43 @@
+import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
+import { NodeType } from "@intlayer/types";
+
+//#region src/deepTransformPlugins/getFilteredLocalesContent.ts
+const filterTranslationsPlugin = (locales) => ({
+	id: "filter-translations-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeType.Translation,
+	transform: (node, props, deepTransformNode$1) => {
+		const translationMap = node.translation;
+		const filteredTranslationMap = Object.fromEntries(Object.entries(translationMap).filter(([key]) => locales.includes(key)));
+		return {
+			...node,
+			translation: deepTransformNode$1(filteredTranslationMap, {
+				...props,
+				keyPath: [...props.keyPath, {
+					type: NodeType.Object,
+					key: NodeType.Translation
+				}]
+			})
+		};
+	}
+});
+const getFilteredLocalesContent = (node, locales, nodeProps) => {
+	const plugins = [filterTranslationsPlugin(Array.isArray(locales) ? locales : [locales]), ...nodeProps.plugins ?? []];
+	return deepTransformNode(node, {
+		...nodeProps,
+		plugins
+	});
+};
+const getFilteredLocalesDictionary = (dictionary, locale) => {
+	const localesArray = Array.isArray(locale) ? locale : [locale];
+	return {
+		...dictionary,
+		content: getFilteredLocalesContent(dictionary.content, localesArray, {
+			dictionaryKey: dictionary.key,
+			keyPath: []
+		})
+	};
+};
+
+//#endregion
+export { getFilteredLocalesContent, getFilteredLocalesDictionary };
+//# sourceMappingURL=getFilteredLocalesContent.mjs.map

package/dist/esm/deepTransformPlugins/getFilteredLocalesContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilteredLocalesContent.mjs","names":["deepTransformNode","plugins: Plugins[]"],"sources":["../../../src/deepTransformPlugins/getFilteredLocalesContent.ts"],"sourcesContent":["import {\n  type ContentNode,\n  type Dictionary,\n  type LocalesValues,\n  NodeType,\n} from '@intlayer/types';\nimport {\n  deepTransformNode,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\n\nconst filterTranslationsPlugin = (locales: LocalesValues[]): Plugins => ({\n  id: 'filter-translations-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeType.Translation,\n  transform: (node, props, deepTransformNode) => {\n    const translationMap = node.translation as Record<LocalesValues, string>;\n\n    const filteredTranslationMap = Object.fromEntries(\n      Object.entries(translationMap).filter(([key]) =>\n        locales.includes(key as LocalesValues)\n      )\n    );\n\n    return {\n      ...node,\n      translation: deepTransformNode(filteredTranslationMap, {\n        ...props,\n        keyPath: [\n          ...props.keyPath,\n          { type: NodeType.Object, key: NodeType.Translation },\n        ],\n      }),\n    };\n  },\n});\n\nexport const getFilteredLocalesContent = (\n  node: ContentNode,\n  locales: LocalesValues | LocalesValues[],\n  nodeProps: NodeProps\n) => {\n  const localesArray = Array.isArray(locales) ? locales : [locales];\n\n  const plugins: Plugins[] = [\n    filterTranslationsPlugin(localesArray),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  return deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  });\n};\n\n/*\n * Remove all unneeded translation from translation node\n *\n * locale: fr\n * t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' }) -> t({ fr: 'Bonjour' })\n *\n * locales: [fr, en]\n * t({ ar: 'Hello', en: 'Hello', fr: 'Bonjour' }) -> t({ en: 'Hello', fr: 'Bonjour' })\n */\nexport const getFilteredLocalesDictionary = (\n  dictionary: Dictionary,\n  locale: LocalesValues | LocalesValues[]\n) => {\n  const localesArray = Array.isArray(locale) ? locale : [locale];\n\n  return {\n    ...dictionary,\n    content: getFilteredLocalesContent(dictionary.content, localesArray, {\n      dictionaryKey: dictionary.key,\n      keyPath: [],\n    }),\n  };\n};\n"],"mappings":";;;;AAYA,MAAM,4BAA4B,aAAuC;CACvE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,SAAS;CAC1D,YAAY,MAAM,OAAO,wBAAsB;EAC7C,MAAM,iBAAiB,KAAK;EAE5B,MAAM,yBAAyB,OAAO,YACpC,OAAO,QAAQ,eAAe,CAAC,QAAQ,CAAC,SACtC,QAAQ,SAAS,IAAqB,CACvC,CACF;AAED,SAAO;GACL,GAAG;GACH,aAAaA,oBAAkB,wBAAwB;IACrD,GAAG;IACH,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,SAAS;KAAQ,KAAK,SAAS;KAAa,CACrD;IACF,CAAC;GACH;;CAEJ;AAED,MAAa,6BACX,MACA,SACA,cACG;CAGH,MAAMC,UAAqB,CACzB,yBAHmB,MAAM,QAAQ,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAGzB,EACtC,GAAI,UAAU,WAAW,EAAE,CAC5B;AAED,QAAO,kBAAkB,MAAM;EAC7B,GAAG;EACH;EACD,CAAC;;AAYJ,MAAa,gCACX,YACA,WACG;CACH,MAAM,eAAe,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO;AAE9D,QAAO;EACL,GAAG;EACH,SAAS,0BAA0B,WAAW,SAAS,cAAc;GACnE,eAAe,WAAW;GAC1B,SAAS,EAAE;GACZ,CAAC;EACH"}

package/dist/esm/deepTransformPlugins/getLocalizedContent.mjs

@@ -0,0 +1,32 @@
+import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
+import { translationPlugin } from "../interpreter/getContent/plugins.mjs";
+
+//#region src/deepTransformPlugins/getLocalizedContent.ts
+/**
+* Transforms a node in a single pass, applying each plugin as needed.
+* In comparison to `getContent`, this function will only apply the translation plugin.
+* It will not transform enumerations, insertions, or other content types.
+*
+* @param node The node to transform.
+* @param locale The locale to use if your transformers need it (e.g. for translations).
+*/
+const getLocalizedContent = (node, locale, nodeProps, fallback) => {
+	const plugins = [translationPlugin(locale, fallback), ...nodeProps.plugins ?? []];
+	return deepTransformNode(node, {
+		...nodeProps,
+		plugins
+	});
+};
+const getPerLocaleDictionary = (dictionary, locale, fallback) => ({
+	...dictionary,
+	locale,
+	content: getLocalizedContent(dictionary.content, locale, {
+		dictionaryKey: dictionary.key,
+		keyPath: [],
+		plugins: []
+	}, fallback)
+});
+
+//#endregion
+export { getLocalizedContent, getPerLocaleDictionary };
+//# sourceMappingURL=getLocalizedContent.mjs.map

package/dist/esm/deepTransformPlugins/getLocalizedContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLocalizedContent.mjs","names":["plugins: Plugins[]"],"sources":["../../../src/deepTransformPlugins/getLocalizedContent.ts"],"sourcesContent":["import type {\n  ContentNode,\n  DeclaredLocales,\n  Dictionary,\n  LocalesValues,\n} from '@intlayer/types';\nimport {\n  type DeepTransformContent,\n  type NodeProps,\n  type Plugins,\n  translationPlugin,\n} from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\n\n/**\n * Transforms a node in a single pass, applying each plugin as needed.\n * In comparison to `getContent`, this function will only apply the translation plugin.\n * It will not transform enumerations, insertions, or other content types.\n *\n * @param node The node to transform.\n * @param locale The locale to use if your transformers need it (e.g. for translations).\n */\nexport const getLocalizedContent = <\n  T extends ContentNode,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  node: T,\n  locale: L,\n  nodeProps: NodeProps,\n  fallback?: LocalesValues // fallback mean that if field is not translated, it will use the default locale\n) => {\n  const plugins: Plugins[] = [\n    translationPlugin(locale, fallback),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  return deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n};\n\nexport const getPerLocaleDictionary = <\n  T extends Dictionary,\n  L extends LocalesValues,\n>(\n  dictionary: T,\n  locale: L,\n  fallback?: LocalesValues\n): Dictionary => ({\n  ...dictionary,\n  locale,\n  content: getLocalizedContent(\n    dictionary.content,\n    locale,\n    {\n      dictionaryKey: dictionary.key,\n      keyPath: [],\n      plugins: [],\n    },\n    fallback\n  ),\n});\n"],"mappings":";;;;;;;;;;;;AAsBA,MAAa,uBAIX,MACA,QACA,WACA,aACG;CACH,MAAMA,UAAqB,CACzB,kBAAkB,QAAQ,SAAS,EACnC,GAAI,UAAU,WAAW,EAAE,CAC5B;AAED,QAAO,kBAAkB,MAAM;EAC7B,GAAG;EACH;EACD,CAAC;;AAGJ,MAAa,0BAIX,YACA,QACA,cACgB;CAChB,GAAG;CACH;CACA,SAAS,oBACP,WAAW,SACX,QACA;EACE,eAAe,WAAW;EAC1B,SAAS,EAAE;EACX,SAAS,EAAE;EACZ,EACD,SACD;CACF"}

package/dist/esm/deepTransformPlugins/getMaskContent.mjs

@@ -0,0 +1,26 @@
+import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
+
+//#region src/deepTransformPlugins/getMaskContent.ts
+const passTypedNodePlugin = {
+	id: "pass-typed-node-plugin",
+	canHandle: (node) => typeof node === "object" && typeof node?.nodeType === "string",
+	transform: (node, props, deepTransformNode$1) => deepTransformNode$1(node[node.nodeType], props)
+};
+/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
+const buildMaskPlugin = {
+	id: "build-mask-plugin",
+	canHandle: (node) => typeof node === "string" || typeof node === "number",
+	transform: () => true
+};
+const getMaskContent = (source) => ({
+	...source,
+	content: deepTransformNode(source.content, {
+		dictionaryKey: source.key,
+		keyPath: [],
+		plugins: [passTypedNodePlugin, buildMaskPlugin]
+	})
+});
+
+//#endregion
+export { buildMaskPlugin, getMaskContent };
+//# sourceMappingURL=getMaskContent.mjs.map

package/dist/esm/deepTransformPlugins/getMaskContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMaskContent.mjs","names":["passTypedNodePlugin: Plugins","deepTransformNode","buildMaskPlugin: Plugins"],"sources":["../../../src/deepTransformPlugins/getMaskContent.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types';\nimport { deepTransformNode, type Plugins } from '../interpreter';\n\nconst passTypedNodePlugin: Plugins = {\n  id: 'pass-typed-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && typeof node?.nodeType === 'string',\n  transform: (node, props, deepTransformNode) =>\n    deepTransformNode(node[node.nodeType], props),\n};\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const buildMaskPlugin: Plugins = {\n  id: 'build-mask-plugin',\n  canHandle: (node) => typeof node === 'string' || typeof node === 'number',\n  transform: () => true,\n};\n\nexport const getMaskContent = (source: Dictionary): any => ({\n  ...source,\n  content: deepTransformNode(source.content, {\n    dictionaryKey: source.key,\n    keyPath: [],\n    plugins: [passTypedNodePlugin, buildMaskPlugin],\n  }),\n});\n"],"mappings":";;;AAGA,MAAMA,sBAA+B;CACnC,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,OAAO,MAAM,aAAa;CACxD,YAAY,MAAM,OAAO,wBACvBC,oBAAkB,KAAK,KAAK,WAAW,MAAM;CAChD;;AAGD,MAAaC,kBAA2B;CACtC,IAAI;CACJ,YAAY,SAAS,OAAO,SAAS,YAAY,OAAO,SAAS;CACjE,iBAAiB;CAClB;AAED,MAAa,kBAAkB,YAA6B;CAC1D,GAAG;CACH,SAAS,kBAAkB,OAAO,SAAS;EACzC,eAAe,OAAO;EACtB,SAAS,EAAE;EACX,SAAS,CAAC,qBAAqB,gBAAgB;EAChD,CAAC;CACH"}

package/dist/esm/deepTransformPlugins/getMissingLocalesContent.mjs

@@ -0,0 +1,41 @@
+import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
+import { NodeType } from "@intlayer/types";
+import configuration from "@intlayer/config/built";
+
+//#region src/deepTransformPlugins/getMissingLocalesContent.ts
+/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
+const checkMissingLocalesPlugin = (locales, onMissingLocale) => ({
+	id: "check-missing-locales-plugin",
+	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeType.Translation,
+	transform: (node, props, deepTransformNode$1) => {
+		for (const locale of locales) if (!node[NodeType.Translation][locale]) onMissingLocale(locale);
+		const translations = node[NodeType.Translation];
+		for (const key in translations) {
+			const child = translations[key];
+			deepTransformNode$1(child, {
+				...props,
+				children: child
+			});
+		}
+		return node;
+	}
+});
+/**
+* Return the content of a node with only the translation plugin.
+*
+* @param node The node to transform.
+* @param locales The locales to check for missing translations.
+*/
+const getMissingLocalesContent = (node, locales = configuration?.internationalization?.locales, nodeProps) => {
+	const missingLocales = /* @__PURE__ */ new Set();
+	const plugins = [checkMissingLocalesPlugin(locales, (locale) => missingLocales.add(locale)), ...nodeProps.plugins ?? []];
+	deepTransformNode(node, {
+		...nodeProps,
+		plugins
+	});
+	return Array.from(missingLocales);
+};
+
+//#endregion
+export { checkMissingLocalesPlugin, getMissingLocalesContent };
+//# sourceMappingURL=getMissingLocalesContent.mjs.map

package/dist/esm/deepTransformPlugins/getMissingLocalesContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMissingLocalesContent.mjs","names":["plugins: Plugins[]"],"sources":["../../../src/deepTransformPlugins/getMissingLocalesContent.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport {\n  type ContentNode,\n  type Locale,\n  type LocalesValues,\n  NodeType,\n} from '@intlayer/types';\nimport type { DeepTransformContent, NodeProps, Plugins } from '../interpreter';\nimport { deepTransformNode } from '../interpreter/getContent/deepTransform';\nimport type { TranslationContent } from '../transpiler';\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const checkMissingLocalesPlugin = (\n  locales: Locale[],\n  onMissingLocale: (locale: Locale) => void\n): Plugins => ({\n  id: 'check-missing-locales-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && node?.nodeType === NodeType.Translation,\n  transform: (node: TranslationContent, props, deepTransformNode) => {\n    for (const locale of locales) {\n      if (\n        !node[NodeType.Translation][\n          locale as keyof (typeof node)[NodeType.Translation]\n        ]\n      ) {\n        onMissingLocale(locale);\n      }\n    }\n\n    // Continue traversal inside the translation values, but avoid re-applying this plugin on the same node\n    const translations = node[NodeType.Translation] as Record<string, any>;\n    for (const key in translations) {\n      const child = translations[key];\n      deepTransformNode(child, {\n        ...props,\n        children: child,\n      });\n    }\n\n    // Return the original node; the return value is ignored by the caller\n    return node;\n  },\n});\n\n/**\n * Return the content of a node with only the translation plugin.\n *\n * @param node The node to transform.\n * @param locales The locales to check for missing translations.\n */\nexport const getMissingLocalesContent = <T extends ContentNode>(\n  node: T,\n  locales: LocalesValues[] = configuration?.internationalization?.locales,\n  nodeProps: NodeProps\n): Locale[] => {\n  const missingLocales = new Set<Locale>();\n\n  const plugins: Plugins[] = [\n    checkMissingLocalesPlugin(locales as Locale[], (locale) =>\n      missingLocales.add(locale)\n    ),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  deepTransformNode(node, {\n    ...nodeProps,\n    plugins,\n  }) as DeepTransformContent<T>;\n\n  return Array.from(missingLocales);\n};\n"],"mappings":";;;;;;AAYA,MAAa,6BACX,SACA,qBACa;CACb,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,SAAS;CAC1D,YAAY,MAA0B,OAAO,wBAAsB;AACjE,OAAK,MAAM,UAAU,QACnB,KACE,CAAC,KAAK,SAAS,aACb,QAGF,iBAAgB,OAAO;EAK3B,MAAM,eAAe,KAAK,SAAS;AACnC,OAAK,MAAM,OAAO,cAAc;GAC9B,MAAM,QAAQ,aAAa;AAC3B,uBAAkB,OAAO;IACvB,GAAG;IACH,UAAU;IACX,CAAC;;AAIJ,SAAO;;CAEV;;;;;;;AAQD,MAAa,4BACX,MACA,UAA2B,eAAe,sBAAsB,SAChE,cACa;CACb,MAAM,iCAAiB,IAAI,KAAa;CAExC,MAAMA,UAAqB,CACzB,0BAA0B,UAAsB,WAC9C,eAAe,IAAI,OAAO,CAC3B,EACD,GAAI,UAAU,WAAW,EAAE,CAC5B;AAED,mBAAkB,MAAM;EACtB,GAAG;EACH;EACD,CAAC;AAEF,QAAO,MAAM,KAAK,eAAe"}

package/dist/esm/deepTransformPlugins/getReplacedValuesContent.mjs

@@ -0,0 +1,60 @@
+import { deepTransformNode } from "../interpreter/getContent/deepTransform.mjs";
+
+//#region src/deepTransformPlugins/getReplacedValuesContent.ts
+const replaceValuesPlugin = (value) => ({
+	id: "replace-values-plugin",
+	canHandle: (node) => typeof node === "string" || typeof node === "number" || typeof node === "boolean",
+	transform: () => value
+});
+const skipTypedNodePlugin = {
+	id: "skip-typed-node-plugin",
+	canHandle: (node) => typeof node === "object" && typeof node?.nodeType === "string",
+	transform: (node, props, deepTransformNode$1) => {
+		const nodeType = node.nodeType;
+		const result = structuredClone(node[nodeType]);
+		if (typeof result !== "object" || result === null) {
+			const transformedResult = deepTransformNode$1(result, {
+				...props,
+				children: result,
+				keyPath: [...props.keyPath, {
+					type: nodeType,
+					key: nodeType
+				}]
+			});
+			return {
+				...node,
+				[nodeType]: transformedResult
+			};
+		}
+		for (const key in result) {
+			const childProps = {
+				...props,
+				children: result[key],
+				keyPath: [...props.keyPath, {
+					type: nodeType,
+					key
+				}]
+			};
+			result[key] = deepTransformNode$1(result[key], childProps);
+		}
+		return {
+			...node,
+			[nodeType]: result
+		};
+	}
+};
+const getReplacedValuesContent = (node, value, nodeProps) => {
+	const plugins = [
+		skipTypedNodePlugin,
+		replaceValuesPlugin(value),
+		...nodeProps.plugins ?? []
+	];
+	return deepTransformNode(JSON.parse(JSON.stringify(node)), {
+		...nodeProps,
+		plugins
+	});
+};
+
+//#endregion
+export { getReplacedValuesContent };
+//# sourceMappingURL=getReplacedValuesContent.mjs.map

package/dist/esm/deepTransformPlugins/getReplacedValuesContent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getReplacedValuesContent.mjs","names":["skipTypedNodePlugin: Plugins","deepTransformNode","plugins: Plugins[]"],"sources":["../../../src/deepTransformPlugins/getReplacedValuesContent.ts"],"sourcesContent":["import type {\n  ContentNode,\n  KeyPath,\n  NodeType,\n  TypedNode,\n} from '@intlayer/types';\nimport {\n  deepTransformNode,\n  type NodeProps,\n  type Plugins,\n} from '../interpreter';\n\nconst replaceValuesPlugin = (value: string | number | boolean): Plugins => ({\n  id: 'replace-values-plugin',\n  canHandle: (node) =>\n    typeof node === 'string' ||\n    typeof node === 'number' ||\n    typeof node === 'boolean',\n  transform: () => value,\n});\n\nconst skipTypedNodePlugin: Plugins = {\n  id: 'skip-typed-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'object' && typeof node?.nodeType === 'string',\n  transform: (node: TypedNode, props, deepTransformNode) => {\n    const nodeType = node.nodeType as NodeType;\n    const result = structuredClone(\n      node[nodeType as unknown as keyof TypedNode] as any\n    );\n\n    // If the result is a primitive value (string, number, boolean),\n    // we need to transform it directly instead of iterating over its properties\n    if (typeof result !== 'object' || result === null) {\n      const transformedResult = deepTransformNode(result, {\n        ...props,\n        children: result,\n        keyPath: [\n          ...props.keyPath,\n          { type: nodeType, key: nodeType } as KeyPath,\n        ],\n      });\n      return {\n        ...node,\n        [nodeType as unknown as keyof TypedNode]: transformedResult,\n      };\n    }\n\n    // For objects and arrays, iterate over their properties\n    for (const key in result) {\n      const childProps = {\n        ...props,\n        children: result[key as unknown as keyof typeof result],\n        keyPath: [...props.keyPath, { type: nodeType, key } as KeyPath],\n      };\n      result[key as unknown as keyof typeof result] = deepTransformNode(\n        result[key as unknown as keyof typeof result],\n        childProps\n      );\n    }\n\n    return { ...node, [nodeType as unknown as keyof TypedNode]: result };\n  },\n};\n\nexport const getReplacedValuesContent = (\n  node: ContentNode,\n  value: string | number | boolean,\n  nodeProps: NodeProps\n) => {\n  const plugins: Plugins[] = [\n    skipTypedNodePlugin,\n    replaceValuesPlugin(value),\n    ...(nodeProps.plugins ?? []),\n  ];\n\n  const JSONNode = JSON.parse(JSON.stringify(node));\n\n  return deepTransformNode(JSONNode, {\n    ...nodeProps,\n    plugins,\n  });\n};\n"],"mappings":";;;AAYA,MAAM,uBAAuB,WAA+C;CAC1E,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAChB,OAAO,SAAS,YAChB,OAAO,SAAS;CAClB,iBAAiB;CAClB;AAED,MAAMA,sBAA+B;CACnC,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,OAAO,MAAM,aAAa;CACxD,YAAY,MAAiB,OAAO,wBAAsB;EACxD,MAAM,WAAW,KAAK;EACtB,MAAM,SAAS,gBACb,KAAK,UACN;AAID,MAAI,OAAO,WAAW,YAAY,WAAW,MAAM;GACjD,MAAM,oBAAoBC,oBAAkB,QAAQ;IAClD,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM;KAAU,KAAK;KAAU,CAClC;IACF,CAAC;AACF,UAAO;IACL,GAAG;KACF,WAAyC;IAC3C;;AAIH,OAAK,MAAM,OAAO,QAAQ;GACxB,MAAM,aAAa;IACjB,GAAG;IACH,UAAU,OAAO;IACjB,SAAS,CAAC,GAAG,MAAM,SAAS;KAAE,MAAM;KAAU;KAAK,CAAY;IAChE;AACD,UAAO,OAAyCA,oBAC9C,OAAO,MACP,WACD;;AAGH,SAAO;GAAE,GAAG;IAAO,WAAyC;GAAQ;;CAEvE;AAED,MAAa,4BACX,MACA,OACA,cACG;CACH,MAAMC,UAAqB;EACzB;EACA,oBAAoB,MAAM;EAC1B,GAAI,UAAU,WAAW,EAAE;EAC5B;AAID,QAAO,kBAFU,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC,EAEd;EACjC,GAAG;EACH;EACD,CAAC"}

package/dist/esm/deepTransformPlugins/index.mjs

@@ -0,0 +1,10 @@
+import { getFilteredLocalesContent, getFilteredLocalesDictionary } from "./getFilteredLocalesContent.mjs";
+import { filterMissingTranslationsOnlyPlugin, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary } from "./getFilterMissingTranslationsContent.mjs";
+import { filterTranslationsOnlyPlugin, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary } from "./getFilterTranslationsOnlyContent.mjs";
+import { getLocalizedContent, getPerLocaleDictionary } from "./getLocalizedContent.mjs";
+import { buildMaskPlugin, getMaskContent } from "./getMaskContent.mjs";
+import { checkMissingLocalesPlugin, getMissingLocalesContent } from "./getMissingLocalesContent.mjs";
+import { getReplacedValuesContent } from "./getReplacedValuesContent.mjs";
+import { insertContentInDictionary } from "./insertContentInDictionary.mjs";
+
+export { buildMaskPlugin, checkMissingLocalesPlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getLocalizedContent, getMaskContent, getMissingLocalesContent, getPerLocaleDictionary, getReplacedValuesContent, insertContentInDictionary };

package/dist/esm/deepTransformPlugins/insertContentInDictionary.mjs

@@ -0,0 +1,105 @@
+import { NodeType } from "@intlayer/types";
+
+//#region src/deepTransformPlugins/insertContentInDictionary.ts
+/**
+* Deep merge helper that handles translation blocks
+* @param target - The target object (dictionary content)
+* @param source - The source object (new content to merge)
+* @param locale - Optional locale to target specific translation
+* @returns Merged content
+*/
+const deepMergeContent = (target, source, locale) => {
+	if (source === null || source === void 0) return target;
+	if (target === null || target === void 0) if (Array.isArray(source)) target = [];
+	else if (typeof source === "object") target = {};
+	else return source;
+	if (target && typeof target === "object" && target.nodeType === NodeType.Translation) if (locale) {
+		const existingLocaleContent = target.translation[locale];
+		let newLocaleContent;
+		if (typeof source === "object" && !Array.isArray(source)) newLocaleContent = deepMergeContent(existingLocaleContent, source, void 0);
+		else if (Array.isArray(source)) newLocaleContent = source;
+		else newLocaleContent = source;
+		return {
+			...target,
+			translation: {
+				...target.translation,
+				[locale]: newLocaleContent
+			}
+		};
+	} else if (typeof source === "object" && !Array.isArray(source) && source.nodeType === NodeType.Translation) return {
+		...target,
+		translation: {
+			...target.translation,
+			...source.translation
+		}
+	};
+	else return processNewContent(source, locale);
+	if (Array.isArray(source)) if (locale && Array.isArray(target)) {
+		const result = [];
+		const maxLength = Math.max(source.length, target.length);
+		for (let i = 0; i < maxLength; i++) if (i < source.length) if (i < target.length && target[i] !== void 0) result[i] = deepMergeContent(target[i], source[i], locale);
+		else result[i] = processNewContent(source[i], locale);
+		else result[i] = target[i];
+		return result;
+	} else return source.map((item) => {
+		if (item && typeof item === "object" && item.nodeType === NodeType.Translation) return item;
+		return processNewContent(item, locale);
+	});
+	if (typeof source === "object" && !Array.isArray(source)) {
+		if (typeof target !== "object" || Array.isArray(target)) target = {};
+		const result = { ...target };
+		for (const key in source) if (Object.hasOwn(source, key)) if (target[key] !== void 0) result[key] = deepMergeContent(target[key], source[key], locale);
+		else result[key] = processNewContent(source[key], locale);
+		return result;
+	}
+	return source;
+};
+/**
+* Process new content that doesn't exist in target
+* @param content - New content to process
+* @param locale - Optional locale
+* @returns Processed content
+*/
+const processNewContent = (content, locale) => {
+	if (content === null || content === void 0) return content;
+	if (content && typeof content === "object" && content.nodeType === NodeType.Translation) return content;
+	if (Array.isArray(content)) return content.map((item) => processNewContent(item, locale));
+	if (content && typeof content === "object") {
+		const result = {};
+		for (const key in content) if (Object.hasOwn(content, key)) result[key] = processNewContent(content[key], locale);
+		return result;
+	}
+	if (locale) return {
+		nodeType: NodeType.Translation,
+		translation: { [locale]: content }
+	};
+	else return content;
+};
+/**
+* Insert content into a dictionary with deep merge support
+* Handles translation blocks and nested structures
+*
+* @param dictionary - The dictionary to insert content into
+* @param content - The content to insert
+* @param locale - Optional locale to target specific translation
+* @returns Updated dictionary
+*
+* @example
+* // Without locale - deep merge all content
+* insertContentInDictionary(dictionary, { title: 'New Title' })
+*
+* @example
+* // With locale - insert content for specific locale
+* insertContentInDictionary(dictionary, { title: 'このページ' }, 'ja')
+*/
+const insertContentInDictionary = (dictionary, content, locale) => {
+	const mergedContent = deepMergeContent(Array.isArray(dictionary.content) ? [...dictionary.content] : { ...dictionary.content }, content, locale);
+	return {
+		...dictionary,
+		content: mergedContent
+	};
+};
+
+//#endregion
+export { insertContentInDictionary };
+//# sourceMappingURL=insertContentInDictionary.mjs.map

package/dist/esm/deepTransformPlugins/insertContentInDictionary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"insertContentInDictionary.mjs","names":["newLocaleContent: any","result: any"],"sources":["../../../src/deepTransformPlugins/insertContentInDictionary.ts"],"sourcesContent":["import { type Dictionary, type LocalesValues, NodeType } from '@intlayer/types';\n\n// {\n//     {\n//       title: 'このページ',\n//       linkLabel: 'セクションへ移動',\n//       collapseButton: { label: '折りたたむ' }\n//     },\n//   }\n//   {\n//     dictionary: {\n//       key: 'aside-navigation',\n//       content: {\n//         title: {\n//           nodeType: 'translation',\n//           translation: {\n//             ar: 'في هذه الصفحة',\n//             de: 'Auf dieser Seite',\n//             en: 'In this page',\n//             'en-GB': 'On this page',\n//             es: 'En esta página',\n//             fr: 'Dans cette page',\n//             hi: 'इस पृष्ठ में',\n//             it: 'In questa pagina',\n//             ko: '이 페이지에서',\n//             pt: 'Nesta página',\n//             ru: 'На этой странице',\n//             tr: 'Bu sayfada',\n//             zh: '在此页面'\n//           }\n//         },\n//         linkLabel: {\n//           nodeType: 'translation',\n//           translation: {\n//             ar: 'اذهب إلى القسم',\n//             de: 'Gehe zur Sektion',\n//             en: 'Go to section',\n//             'en-GB': 'Go to section',\n//             es: 'Ir a la sección',\n//             fr: 'Aller à la section',\n//             hi: 'सेक्शन पर जाएं',\n//             it: 'Vai alla sezione',\n//             ja: 'セクションへ行く',\n//             ko: '섹션으로 이동',\n//             pt: 'Ir para a seção',\n//             ru: 'Перейти к разделу',\n//             tr: 'Bölüme git',\n//             zh: '转到节'\n//           }\n//         },\n//         collapseButton: {\n//           label: {\n//             nodeType: 'translation',\n//             translation: {\n//               en: 'Collapse',\n//               fr: 'Réduire',\n//               es: 'Colapsar',\n//               'en-GB': 'Collapse',\n//               de: 'Zuklappen',\n//               ja: '折りたたむ',\n//               ko: '접기',\n//               zh: '折叠',\n//               it: 'Comprimi',\n//               pt: 'Recolher',\n//               hi: 'संकुचित करें',\n//               ar: 'اطوي التوسيع',\n//               ru: 'Свернуть',\n//               tr: 'Daralt'\n//             }\n//           }\n//         }\n//       },\n//       localId: 'aside-navigation::local::src/components/AsideNavigation/asideNavigation.content.ts',\n//       location: 'local',\n//       filePath: 'src/components/AsideNavigation/asideNavigation.content.ts'\n//     }\n//   }\n\n/**\n * Deep merge helper that handles translation blocks\n * @param target - The target object (dictionary content)\n * @param source - The source object (new content to merge)\n * @param locale - Optional locale to target specific translation\n * @returns Merged content\n */\nconst deepMergeContent = (\n  target: any,\n  source: any,\n  locale?: LocalesValues\n): any => {\n  // If source is null or undefined, return target\n  if (source === null || source === undefined) return target;\n\n  // If target is null or undefined, initialize based on source type\n  if (target === null || target === undefined) {\n    if (Array.isArray(source)) {\n      target = [];\n    } else if (typeof source === 'object') {\n      target = {};\n    } else {\n      return source;\n    }\n  }\n\n  // Handle translation nodes FIRST (before arrays) to support arrays within translations\n  if (\n    target &&\n    typeof target === 'object' &&\n    target.nodeType === NodeType.Translation\n  ) {\n    // Target is a translation block\n    if (locale) {\n      // Update only the specific locale - create new object to preserve order\n      const existingLocaleContent = target.translation[locale];\n      let newLocaleContent: any;\n\n      if (typeof source === 'object' && !Array.isArray(source)) {\n        // Source is an object, need to deep merge for this locale\n        newLocaleContent = deepMergeContent(\n          existingLocaleContent,\n          source,\n          undefined // Don't pass locale down for nested content\n        );\n      } else if (Array.isArray(source)) {\n        // Source is an array, set it directly for this locale\n        newLocaleContent = source;\n      } else {\n        // Source is a primitive, directly set it\n        newLocaleContent = source;\n      }\n\n      // Return new object with locale appended at the end (preserve insertion order)\n      return {\n        ...target,\n        translation: {\n          ...target.translation,\n          [locale]: newLocaleContent,\n        },\n      };\n    } else {\n      // No locale specified, replace/merge the entire translation\n      if (\n        typeof source === 'object' &&\n        !Array.isArray(source) &&\n        source.nodeType === NodeType.Translation\n      ) {\n        // Source is also a translation node, merge translations\n        return {\n          ...target,\n          translation: {\n            ...target.translation,\n            ...source.translation,\n          },\n        };\n      } else {\n        // Source is not a translation node, wrap it\n        return processNewContent(source, locale);\n      }\n    }\n  }\n\n  // Handle arrays\n  if (Array.isArray(source)) {\n    if (locale && Array.isArray(target)) {\n      // When locale is specified and target is also an array, merge element by element\n      const result = [];\n      const maxLength = Math.max(source.length, target.length);\n\n      for (let i = 0; i < maxLength; i++) {\n        if (i < source.length) {\n          if (i < target.length && target[i] !== undefined) {\n            // Both source and target have element at this index - merge them\n            result[i] = deepMergeContent(target[i], source[i], locale);\n          } else {\n            // Only source has element at this index - process new content\n            result[i] = processNewContent(source[i], locale);\n          }\n        } else {\n          // Only target has element at this index - keep it\n          result[i] = target[i];\n        }\n      }\n\n      return result;\n    } else {\n      // No locale or target is not an array - replace entirely\n      return source.map((item) => {\n        // Process each item in case it needs locale wrapping\n        if (\n          item &&\n          typeof item === 'object' &&\n          item.nodeType === NodeType.Translation\n        ) {\n          return item;\n        }\n        return processNewContent(item, locale);\n      });\n    }\n  }\n\n  // Handle objects\n  if (typeof source === 'object' && !Array.isArray(source)) {\n    if (typeof target !== 'object' || Array.isArray(target)) {\n      target = {};\n    }\n\n    // Create new object to preserve key order and avoid mutation\n    const result: any = { ...target };\n\n    for (const key in source) {\n      if (Object.hasOwn(source, key)) {\n        if (target[key] !== undefined) {\n          result[key] = deepMergeContent(target[key], source[key], locale);\n        } else {\n          result[key] = processNewContent(source[key], locale);\n        }\n      }\n    }\n\n    return result;\n  }\n\n  // For primitives, just return the source\n  return source;\n};\n\n/**\n * Process new content that doesn't exist in target\n * @param content - New content to process\n * @param locale - Optional locale\n * @returns Processed content\n */\nconst processNewContent = (content: any, locale?: LocalesValues): any => {\n  // Handle null and undefined\n  if (content === null || content === undefined) {\n    return content;\n  }\n\n  // If content is already a translation node, return as-is\n  if (\n    content &&\n    typeof content === 'object' &&\n    content.nodeType === NodeType.Translation\n  ) {\n    return content;\n  }\n\n  // Handle arrays\n  if (Array.isArray(content)) {\n    return content.map((item) => processNewContent(item, locale));\n  }\n\n  // Handle objects\n  if (content && typeof content === 'object') {\n    const result: any = {};\n\n    for (const key in content) {\n      if (Object.hasOwn(content, key)) {\n        result[key] = processNewContent(content[key], locale);\n      }\n    }\n    return result;\n  }\n\n  // Handle primitives\n  if (locale) {\n    // Wrap in translation node with the specific locale\n    return {\n      nodeType: NodeType.Translation,\n      translation: {\n        [locale]: content,\n      },\n    };\n  } else {\n    // If no locale, just return the content as-is (don't wrap)\n    return content;\n  }\n};\n\n/**\n * Insert content into a dictionary with deep merge support\n * Handles translation blocks and nested structures\n *\n * @param dictionary - The dictionary to insert content into\n * @param content - The content to insert\n * @param locale - Optional locale to target specific translation\n * @returns Updated dictionary\n *\n * @example\n * // Without locale - deep merge all content\n * insertContentInDictionary(dictionary, { title: 'New Title' })\n *\n * @example\n * // With locale - insert content for specific locale\n * insertContentInDictionary(dictionary, { title: 'このページ' }, 'ja')\n */\nexport const insertContentInDictionary = (\n  dictionary: Dictionary,\n  content: Dictionary['content'],\n  locale?: LocalesValues\n): Dictionary => {\n  const mergedContent = deepMergeContent(\n    Array.isArray(dictionary.content)\n      ? [...dictionary.content]\n      : { ...dictionary.content },\n    content,\n    locale\n  );\n\n  return {\n    ...dictionary,\n    content: mergedContent,\n  };\n};\n"],"mappings":";;;;;;;;;;AAqFA,MAAM,oBACJ,QACA,QACA,WACQ;AAER,KAAI,WAAW,QAAQ,WAAW,OAAW,QAAO;AAGpD,KAAI,WAAW,QAAQ,WAAW,OAChC,KAAI,MAAM,QAAQ,OAAO,CACvB,UAAS,EAAE;UACF,OAAO,WAAW,SAC3B,UAAS,EAAE;KAEX,QAAO;AAKX,KACE,UACA,OAAO,WAAW,YAClB,OAAO,aAAa,SAAS,YAG7B,KAAI,QAAQ;EAEV,MAAM,wBAAwB,OAAO,YAAY;EACjD,IAAIA;AAEJ,MAAI,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,CAEtD,oBAAmB,iBACjB,uBACA,QACA,OACD;WACQ,MAAM,QAAQ,OAAO,CAE9B,oBAAmB;MAGnB,oBAAmB;AAIrB,SAAO;GACL,GAAG;GACH,aAAa;IACX,GAAG,OAAO;KACT,SAAS;IACX;GACF;YAIC,OAAO,WAAW,YAClB,CAAC,MAAM,QAAQ,OAAO,IACtB,OAAO,aAAa,SAAS,YAG7B,QAAO;EACL,GAAG;EACH,aAAa;GACX,GAAG,OAAO;GACV,GAAG,OAAO;GACX;EACF;KAGD,QAAO,kBAAkB,QAAQ,OAAO;AAM9C,KAAI,MAAM,QAAQ,OAAO,CACvB,KAAI,UAAU,MAAM,QAAQ,OAAO,EAAE;EAEnC,MAAM,SAAS,EAAE;EACjB,MAAM,YAAY,KAAK,IAAI,OAAO,QAAQ,OAAO,OAAO;AAExD,OAAK,IAAI,IAAI,GAAG,IAAI,WAAW,IAC7B,KAAI,IAAI,OAAO,OACb,KAAI,IAAI,OAAO,UAAU,OAAO,OAAO,OAErC,QAAO,KAAK,iBAAiB,OAAO,IAAI,OAAO,IAAI,OAAO;MAG1D,QAAO,KAAK,kBAAkB,OAAO,IAAI,OAAO;MAIlD,QAAO,KAAK,OAAO;AAIvB,SAAO;OAGP,QAAO,OAAO,KAAK,SAAS;AAE1B,MACE,QACA,OAAO,SAAS,YAChB,KAAK,aAAa,SAAS,YAE3B,QAAO;AAET,SAAO,kBAAkB,MAAM,OAAO;GACtC;AAKN,KAAI,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,OAAO,EAAE;AACxD,MAAI,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CACrD,UAAS,EAAE;EAIb,MAAMC,SAAc,EAAE,GAAG,QAAQ;AAEjC,OAAK,MAAM,OAAO,OAChB,KAAI,OAAO,OAAO,QAAQ,IAAI,CAC5B,KAAI,OAAO,SAAS,OAClB,QAAO,OAAO,iBAAiB,OAAO,MAAM,OAAO,MAAM,OAAO;MAEhE,QAAO,OAAO,kBAAkB,OAAO,MAAM,OAAO;AAK1D,SAAO;;AAIT,QAAO;;;;;;;;AAST,MAAM,qBAAqB,SAAc,WAAgC;AAEvE,KAAI,YAAY,QAAQ,YAAY,OAClC,QAAO;AAIT,KACE,WACA,OAAO,YAAY,YACnB,QAAQ,aAAa,SAAS,YAE9B,QAAO;AAIT,KAAI,MAAM,QAAQ,QAAQ,CACxB,QAAO,QAAQ,KAAK,SAAS,kBAAkB,MAAM,OAAO,CAAC;AAI/D,KAAI,WAAW,OAAO,YAAY,UAAU;EAC1C,MAAMA,SAAc,EAAE;AAEtB,OAAK,MAAM,OAAO,QAChB,KAAI,OAAO,OAAO,SAAS,IAAI,CAC7B,QAAO,OAAO,kBAAkB,QAAQ,MAAM,OAAO;AAGzD,SAAO;;AAIT,KAAI,OAEF,QAAO;EACL,UAAU,SAAS;EACnB,aAAa,GACV,SAAS,SACX;EACF;KAGD,QAAO;;;;;;;;;;;;;;;;;;;AAqBX,MAAa,6BACX,YACA,SACA,WACe;CACf,MAAM,gBAAgB,iBACpB,MAAM,QAAQ,WAAW,QAAQ,GAC7B,CAAC,GAAG,WAAW,QAAQ,GACvB,EAAE,GAAG,WAAW,SAAS,EAC7B,SACA,OACD;AAED,QAAO;EACL,GAAG;EACH,SAAS;EACV"}