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

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

{"version":3,"file":"getIntlayer.mjs","names":[],"sources":["../../../src/interpreter/getIntlayer.ts"],"sourcesContent":["// packages/@intlayer/core/src/interpreter/getIntlayer.ts\n\nimport configuration from '@intlayer/config/built';\nimport { getAppLogger } from '@intlayer/config/client';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  DictionaryRegistryElement,\n  LocalesValues,\n} from '@intlayer/types';\nimport type {\n  DeepTransformContent,\n  IInterpreterPluginState,\n  Plugins,\n} from './getContent';\nimport { getDictionary } from './getDictionary';\n\n/**\n * Creates a Recursive Proxy that returns the path of the accessed key\n * stringified. This prevents the app from crashing on undefined access.\n */\nconst createSafeFallback = (path = ''): any => {\n  return new Proxy(\n    // Target is a function so it can be called if the dictionary expects a function\n    () => path,\n    {\n      get: (_target, prop) => {\n        // Handle common object methods to prevent infinite recursion or weird behavior\n        if (\n          prop === 'toJSON' ||\n          prop === Symbol.toPrimitive ||\n          prop === 'toString'\n        ) {\n          return () => path;\n        }\n        if (prop === 'then') {\n          return undefined; // Prevent it from being treated as a Promise\n        }\n\n        // Recursively build the path (e.g., \"myDictionary.home.title\")\n        const nextPath = path ? `${path}.${String(prop)}` : String(prop);\n        return createSafeFallback(nextPath);\n      },\n      // If the code tries to execute the missing key as a function: t.title()\n      apply: () => {\n        return path;\n      },\n    }\n  );\n};\n\nexport const getIntlayer = <\n  T extends DictionaryKeys,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L,\n  plugins?: Plugins[]\n): DeepTransformContent<\n  DictionaryRegistryContent<T>,\n  IInterpreterPluginState,\n  L\n> => {\n  const dictionaries = getDictionaries();\n  const dictionary = dictionaries[key as T] as DictionaryRegistryElement<T>;\n\n  if (!dictionary) {\n    // Log a warning instead of throwing (so developers know it's missing)\n    const logger = getAppLogger(configuration);\n    logger(\n      `Dictionary \"${key as string}\" was not found. Using fallback proxy.`,\n      {\n        level: 'warn',\n        isVerbose: true,\n      }\n    );\n\n    if (process.env.NODE_ENV === 'development') {\n      // Return the Safe Proxy\n      // We initialize it with the dictionary key name so the UI shows \"my-dictionary.someKey\"\n      return createSafeFallback(key as string);\n    }\n  }\n\n  return getDictionary<DictionaryRegistryElement<T>, L>(\n    dictionary,\n    locale,\n    plugins\n  );\n};\n"],"mappings":";;;;;;;;;;AAuBA,MAAM,sBAAsB,OAAO,OAAY;AAC7C,QAAO,IAAI,YAEH,MACN;EACE,MAAM,SAAS,SAAS;AAEtB,OACE,SAAS,YACT,SAAS,OAAO,eAChB,SAAS,WAET,cAAa;AAEf,OAAI,SAAS,OACX;AAKF,UAAO,mBADU,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,KAAK,OAAO,KAAK,CAC7B;;EAGrC,aAAa;AACX,UAAO;;EAEV,CACF;;AAGH,MAAa,eAIX,KACA,QACA,YAKG;CAEH,MAAM,aADe,iBAAiB,CACN;AAEhC,KAAI,CAAC,YAAY;AAGf,EADe,aAAa,cAAc,CAExC,eAAe,IAAc,yCAC7B;GACE,OAAO;GACP,WAAW;GACZ,CACF;AAKC,SAAO,mBAAmB,IAAc;;AAI5C,QAAO,cACL,YACA,QACA,QACD"}