@intlayer/core/dist/esm/interpreter/getTranslation.mjs.map

Includes core Intlayer functions like translation, dictionary, and utility functions shared across multiple packages.

{"version":3,"file":"getTranslation.mjs","names":["result: Record<string, unknown>","results: Content[]"],"sources":["../../../src/interpreter/getTranslation.ts"],"sourcesContent":["import type { LocalesValues, StrictModeLocaleMap } from '@intlayer/types';\n\n/**\n * Check if a value is a plain object that can be safely processed.\n * Returns false for Promises, React elements, class instances, etc.\n */\nconst isPlainObject = (value: unknown): boolean => {\n  if (value === null || typeof value !== 'object') {\n    return false;\n  }\n\n  // Don't process Promises (e.g., Next.js 15+ params)\n  if (value instanceof Promise || typeof (value as any).then === 'function') {\n    return false;\n  }\n\n  // Don't process React elements\n  if ((value as any).$$typeof !== undefined) {\n    return false;\n  }\n\n  // Only process plain objects and arrays\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null || Array.isArray(value);\n};\n\n/**\n * Recursively merges two objects.\n * Resembles the behavior of `defu` but respects `isPlainObject` to avoid merging React elements.\n * Arrays are replaced, not merged.\n */\nconst deepMergeObjects = (target: any, source: any): any => {\n  if (target === undefined) return source;\n  if (source === undefined) return target;\n\n  if (Array.isArray(target)) return target;\n\n  if (isPlainObject(target) && isPlainObject(source)) {\n    const result = { ...target };\n    for (const key of Object.keys(source)) {\n      if (key === '__proto__' || key === 'constructor') continue;\n\n      if (Object.hasOwn(target, key)) {\n        result[key] = deepMergeObjects(target[key], source[key]);\n      } else {\n        result[key] = source[key];\n      }\n    }\n    return result;\n  }\n\n  return target;\n};\n\n/**\n * Recursively removes undefined values from an object.\n * Handles circular references by tracking visited objects.\n */\nconst removeUndefinedValues = <T>(\n  object: T,\n  visited = new WeakSet<object>()\n): T => {\n  if (typeof object !== 'object' || object === null) {\n    return object;\n  }\n\n  // Handle circular references - return original to avoid infinite recursion\n  if (visited.has(object)) {\n    return object;\n  }\n  visited.add(object);\n\n  // Don't process non-plain objects (Promises, React elements, etc.)\n  if (!isPlainObject(object)) {\n    return object;\n  }\n\n  if (Array.isArray(object)) {\n    return object.map((item) => removeUndefinedValues(item, visited)) as T;\n  }\n\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(object)) {\n    if (value !== undefined) {\n      result[key] = removeUndefinedValues(value, visited);\n    }\n  }\n  return result as T;\n};\n\n/**\n *\n * Allow to pick a content based on a locale.\n * If not locale found, it will return the content related to the default locale.\n *\n * Return either the content editor, or the content itself depending on the configuration.\n *\n * Usage:\n *\n * ```ts\n * const content = getTranslation<string>({\n * en: 'Hello',\n * fr: 'Bonjour',\n * }, 'fr');\n * // 'Bonjour'\n * ```\n *\n * Using TypeScript:\n * - this function will require each locale to be defined if defined in the project configuration.\n * - If a locale is missing, it will make each existing locale optional and raise an error if the locale is not found.\n */\nexport const getTranslation = <Content = string>(\n  languageContent: StrictModeLocaleMap<Content>,\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Content => {\n  const results: Content[] = [];\n\n  const getContent = (loc: string) =>\n    languageContent[loc as keyof typeof languageContent];\n\n  // 1. Get Target Content\n  const content = getContent(locale);\n  if (typeof content === 'string') {\n    return content;\n  } else if (content !== undefined) {\n    results.push(content);\n  }\n\n  // 2. Get Target Generic Content (e.g. 'en' from 'en-US')\n  if (locale.includes('-')) {\n    const genericLocale = locale.split('-')[0];\n    if (genericLocale in languageContent) {\n      const genericContent = getContent(genericLocale);\n\n      if (typeof genericContent === 'string') {\n        // If we haven't found specific content yet, return generic string\n        if (results.length === 0) return genericContent;\n      } else if (genericContent !== undefined) {\n        results.push(genericContent);\n      }\n    }\n  }\n\n  // 3. Get Fallback Content\n  if (fallback !== undefined && fallback !== locale) {\n    // 3a. Fallback Specific\n    if (fallback in languageContent) {\n      const fallbackContent = getContent(fallback);\n\n      if (typeof fallbackContent === 'string') {\n        if (results.length === 0) return fallbackContent;\n      } else if (fallbackContent !== undefined) {\n        results.push(fallbackContent);\n      }\n    }\n\n    // 3b. Fallback Generic (The missing piece: e.g. 'en' from 'en-GB' fallback)\n    if (fallback.includes('-')) {\n      const genericFallback = fallback.split('-')[0];\n      const genericLocale = locale.split('-')[0];\n\n      // Only add if it's different from the target generic (to avoid duplication)\n      // and exists in the dictionary\n      if (\n        genericFallback !== genericLocale &&\n        genericFallback in languageContent\n      ) {\n        const genericFallbackContent = getContent(genericFallback);\n\n        if (typeof genericFallbackContent === 'string') {\n          if (results.length === 0) return genericFallbackContent;\n        } else if (genericFallbackContent !== undefined) {\n          results.push(genericFallbackContent);\n        }\n      }\n    }\n  }\n\n  if (results.length === 0) {\n    return undefined as Content;\n  }\n\n  // Clean undefined values so they don't overwrite fallbacks\n  // Order: [Target, Generic, Fallback, FallbackGeneric]\n  // defu first argument takes precedence, so Target wins\n  const cleanResults = results.map((item) => removeUndefinedValues(item));\n\n  // If only one result, return it directly (no merging needed)\n  if (cleanResults.length === 1) {\n    return cleanResults[0];\n  }\n\n  // If the first result is an array, return it directly (arrays replace, don't merge)\n  // defu would incorrectly convert arrays to objects with numeric keys\n  if (Array.isArray(cleanResults[0])) {\n    return cleanResults[0];\n  }\n\n  // Merge objects with custom merge - first argument takes precedence\n  // Cast to object[] since by this point we've already returned early for strings, arrays, and single results\n  return (cleanResults as object[]).reduce((acc, curr) =>\n    deepMergeObjects(acc, curr)\n  ) as Content;\n};\n"],"mappings":"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"}