gt-i18n 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # gt-i18n
 
+## 0.9.1
+
+### Patch Changes
+
+- [#1374](https://github.com/generaltranslation/gt/pull/1374) [`4d77edf`](https://github.com/generaltranslation/gt/commit/4d77edf7cb2bca5c20911c20c58f702803c9acc9) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - chore(gt-i18n): add comment documentation for t.obj()
+
+- [#1380](https://github.com/generaltranslation/gt/pull/1380) [`feffb35`](https://github.com/generaltranslation/gt/commit/feffb35f75b3deee12e29878792461b8d32fad3e) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Export i18n manager cache-miss event-name constants from `gt-i18n/internal` so downstream packages such as `@generaltranslation/react-core` can consume one shared source of truth.
+
+- [#1375](https://github.com/generaltranslation/gt/pull/1375) [`86263b3`](https://github.com/generaltranslation/gt/commit/86263b3aa8f2d283200515d609d69f570b97a84f) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Fix dictionary getTranslations fallback to use loaded translations when a target dictionary entry is missing.
+
+- Updated dependencies [[`e88fd39`](https://github.com/generaltranslation/gt/commit/e88fd399683868d5af1fe2b0ba2974fe5b17d7a7), [`95f852a`](https://github.com/generaltranslation/gt/commit/95f852ae086ac79d2c446f4d3072d8fd18688796)]:
+  - generaltranslation@8.2.13
+  - @generaltranslation/supported-locales@2.0.71
+
 ## 0.9.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_isEncodedTranslationOptions = require("./isEncodedTranslationOptions-D7ltjc4f.cjs");
-const require_versionId = require("./versionId-qtCCdgKr.cjs");
+const require_versionId = require("./versionId-Bh53lhdJ.cjs");
 const require_mFallback = require("./mFallback-CoPRtKyL.cjs");
 let generaltranslation_internal = require("generaltranslation/internal");
 let generaltranslation_core = require("generaltranslation/core");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as extractVariables, i as createInterpolationFailureMessage, n as decodeOptions, o as logger_default } from "./isEncodedTranslationOptions-DdHEzDDM.mjs";
-import { S as hashMessage, a as getLocales, d as resolveStringContentWithFallback, i as getLocaleProperties, m as getCurrentLocale, n as getDefaultLocale, r as getLocale, t as getVersionId } from "./versionId-D0t6HuUM.mjs";
+import { E as hashMessage, a as getLocales, d as resolveStringContentWithFallback, i as getLocaleProperties, m as getCurrentLocale, n as getDefaultLocale, r as getLocale, t as getVersionId } from "./versionId-CB81YFd9.mjs";
 import { n as gtFallback, r as decodeMsg, t as mFallback } from "./mFallback-BQX_yiE-.mjs";
 import { VAR_IDENTIFIER, declareStatic, declareVar, decodeVars, derive, encode, libraryDefaultLocale } from "generaltranslation/internal";
 import { formatMessage } from "generaltranslation/core";

package/dist/internal.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_isEncodedTranslationOptions = require("./isEncodedTranslationOptions-D7ltjc4f.cjs");
-const require_versionId = require("./versionId-qtCCdgKr.cjs");
+const require_versionId = require("./versionId-Bh53lhdJ.cjs");
 let generaltranslation_internal = require("generaltranslation/internal");
 let generaltranslation_core = require("generaltranslation/core");
 //#region src/translation-functions/internal/getGT.ts
@@ -98,7 +98,7 @@ async function getMessages() {
 async function getTranslations() {
 	const i18nManager = require_versionId.getI18nManager();
 	const locale = require_versionId.getCurrentLocale();
-	await i18nManager.loadDictionary(locale);
+	await Promise.all([i18nManager.loadDictionary(locale), i18nManager.loadTranslations(locale)]);
 	const sourceLocale = i18nManager.getDefaultLocale();
 	/**
 	* Dictionary resolution
@@ -119,14 +119,28 @@ async function getTranslations() {
 	const t = ((id, options = {}) => {
 		const sourceEntry = i18nManager.lookupDictionary(sourceLocale, id);
 		if (sourceEntry === void 0) throw new Error(`Dictionary entry ${id} cannot be found`);
+		const targetEntry = i18nManager.lookupDictionary(locale, id);
+		const dictionaryOptions = require_versionId.resolveDictionaryLookupOptions(sourceEntry.options);
 		return renderEntry({
 			sourceLocale,
 			targetLocale: locale,
 			sourceEntry,
-			targetEntry: i18nManager.lookupDictionary(locale, id),
+			target: targetEntry?.entry ?? i18nManager.lookupTranslation(locale, sourceEntry.entry, dictionaryOptions),
+			dictionaryOptions,
 			options
 		});
 	});
+	/**
+	* Returns a subtree of the dictionary object translation based on its id.
+	* @param {string} id - The id of the translation to translate.
+	* @returns The translated object.
+	*
+	* @example
+	* const t = await getTranslations();
+	* const greetings = t.obj('greetings');
+	* console.log(greetings);
+	* // { greeting1: 'Hello', greeting2: 'Hi' }
+	*/
 	t.obj = (id) => {
 		const sourceObject = i18nManager.lookupDictionaryObj(sourceLocale, id);
 		if (sourceObject === void 0) throw new Error(`Dictionary entry ${id} cannot be found`);
@@ -135,10 +149,51 @@ async function getTranslations() {
 			targetObject: i18nManager.lookupDictionaryObj(locale, id)
 		});
 	};
+	function renderObject({ sourceObject, targetObject }) {
+		const targetEntry = require_versionId.getDictionaryEntry(targetObject);
+		if (targetEntry !== void 0) return targetEntry.entry;
+		if (require_versionId.isDictionaryValue(targetObject)) {
+			if (!require_versionId.isDictionaryValue(sourceObject)) return renderObject({
+				sourceObject: targetObject,
+				targetObject: void 0
+			});
+			return renderDictionaryObject({
+				sourceObject,
+				targetObject
+			});
+		}
+		const sourceEntry = require_versionId.getDictionaryEntry(sourceObject);
+		if (sourceEntry !== void 0) {
+			const dictionaryOptions = require_versionId.resolveDictionaryLookupOptions(sourceEntry.options);
+			const target = i18nManager.lookupTranslation(locale, sourceEntry.entry, dictionaryOptions);
+			if (target !== void 0) return target;
+			return sourceEntry.entry;
+		}
+		if (require_versionId.isDictionaryValue(sourceObject)) return renderDictionaryObject({
+			sourceObject,
+			targetObject: void 0
+		});
+		throw new Error("Dictionary object cannot be rendered");
+	}
+	function renderDictionaryObject({ sourceObject, targetObject }) {
+		if (!require_versionId.isDictionaryValue(sourceObject)) return renderObject({
+			sourceObject,
+			targetObject
+		});
+		const result = {};
+		const keys = new Set([...Object.keys(sourceObject), ...require_versionId.isDictionaryValue(targetObject) ? Object.keys(targetObject) : []]);
+		for (const key of Array.from(keys)) {
+			const renderedChild = renderObject({
+				sourceObject: sourceObject[key],
+				targetObject: require_versionId.isDictionaryValue(targetObject) ? targetObject[key] : void 0
+			});
+			if (renderedChild !== void 0) result[key] = renderedChild;
+		}
+		return result;
+	}
 	return t;
 }
-function renderEntry({ sourceLocale, targetLocale, sourceEntry, targetEntry, options = {} }) {
-	const dictionaryOptions = require_versionId.resolveDictionaryLookupOptions(sourceEntry.options);
+function renderEntry({ sourceLocale, targetLocale, sourceEntry, target, dictionaryOptions, options = {} }) {
 	const interpolationOptions = require_isEncodedTranslationOptions.extractVariables(options);
 	const lookupOptions = require_versionId.createLookupOptions(targetLocale, {
 		...dictionaryOptions,
@@ -146,48 +201,11 @@ function renderEntry({ sourceLocale, targetLocale, sourceEntry, targetEntry, opt
 	}, dictionaryOptions.$format ?? "ICU");
 	return require_versionId.interpolateMessage({
 		source: sourceEntry.entry,
-		target: targetEntry?.entry,
+		target,
 		options: lookupOptions,
 		sourceLocale
 	});
 }
-function renderObject({ sourceObject, targetObject }) {
-	const targetEntry = require_versionId.getDictionaryEntry(targetObject);
-	if (targetEntry !== void 0) return targetEntry.entry;
-	if (require_versionId.isDictionaryValue(targetObject)) {
-		if (!require_versionId.isDictionaryValue(sourceObject)) return renderObject({
-			sourceObject: targetObject,
-			targetObject: void 0
-		});
-		return renderDictionaryObject({
-			sourceObject,
-			targetObject
-		});
-	}
-	const sourceEntry = require_versionId.getDictionaryEntry(sourceObject);
-	if (sourceEntry !== void 0) return sourceEntry.entry;
-	if (require_versionId.isDictionaryValue(sourceObject)) return renderDictionaryObject({
-		sourceObject,
-		targetObject: void 0
-	});
-	throw new Error("Dictionary object cannot be rendered");
-}
-function renderDictionaryObject({ sourceObject, targetObject }) {
-	if (!require_versionId.isDictionaryValue(sourceObject)) return renderObject({
-		sourceObject,
-		targetObject
-	});
-	const result = {};
-	const keys = new Set([...Object.keys(sourceObject), ...require_versionId.isDictionaryValue(targetObject) ? Object.keys(targetObject) : []]);
-	for (const key of keys) {
-		const renderedChild = renderObject({
-			sourceObject: sourceObject[key],
-			targetObject: require_versionId.isDictionaryValue(targetObject) ? targetObject[key] : void 0
-		});
-		if (renderedChild !== void 0) result[key] = renderedChild;
-	}
-	return result;
-}
 //#endregion
 //#region src/translation-functions/internal/tx.ts
 /**
@@ -296,7 +314,11 @@ function createLocaleResolver(config = {}) {
 	return (candidates) => determineSupportedLocaleWithConfig(candidates, normalizedConfig) || normalizedConfig.defaultLocale;
 }
 //#endregion
+exports.DICTIONARY_CACHE_MISS_EVENT_NAME = require_versionId.DICTIONARY_CACHE_MISS_EVENT_NAME;
 exports.I18nManager = require_versionId.I18nManager;
+exports.LOCALES_CACHE_MISS_EVENT_NAME = require_versionId.LOCALES_CACHE_MISS_EVENT_NAME;
+exports.LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME = require_versionId.LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME;
+exports.TRANSLATIONS_CACHE_MISS_EVENT_NAME = require_versionId.TRANSLATIONS_CACHE_MISS_EVENT_NAME;
 exports.createConditionStoreSingleton = createConditionStoreSingleton;
 exports.createLocaleResolver = createLocaleResolver;
 exports.createLookupOptions = require_versionId.createLookupOptions;

package/dist/internal.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.cjs","names":["getI18nManager","getCurrentLocale","createLookupOptions","interpolateMessage","decodeOptions","isEncodedTranslationOptions","getI18nManager","getCurrentLocale","resolveDictionaryLookupOptions","extractVariables","createLookupOptions","interpolateMessage","getDictionaryEntry","isDictionaryValue","resolveStringContentWithRuntimeFallback","getCurrentLocale","resolveStringContent","resolveStringContentWithFallback","resolveJsx","setConditionStore","libraryDefaultLocale","LocaleConfig"],"sources":["../src/translation-functions/internal/getGT.ts","../src/translation-functions/internal/getMessages.ts","../src/translation-functions/internal/getTranslations.ts","../src/translation-functions/internal/tx.ts","../src/translation-functions/internal/sync-translation-resolution.ts","../src/translation-functions/internal/jsx-resolution.ts","../src/i18n-manager/condition-store/createConditionStoreSingleton.ts","../src/i18n-manager/condition-store/localeResolver.ts"],"sourcesContent":["import {\n  getCurrentLocale,\n  getI18nManager,\n} from '../../i18n-manager/singleton-operations';\nimport { InlineTranslationOptions } from '../types/options';\nimport { GTFunctionType } from '../types/functions';\nimport { interpolateMessage } from '../utils/interpolation/interpolateMessage';\nimport { createLookupOptions } from './helpers';\nimport type { StringFormat } from 'generaltranslation/types';\n\n/**\n * Returns the gt function that registers a string at build time and resolves its translation at runtime.\n * @returns A promise of the gt function\n *\n * @example\n * const gt = await getGT();\n * const greeting = gt('Hello, world!');\n */\nexport async function getGT(): Promise<GTFunctionType> {\n  // Get the translation resolver\n  const i18nManager = getI18nManager();\n  const locale = getCurrentLocale();\n  await i18nManager.loadTranslations(locale);\n  const sourceLocale = i18nManager.getDefaultLocale();\n\n  /**\n   * Registers a message at build time and resolves its translation at runtime.\n   * @param {string} message - The message to translate\n   * @param {InlineTranslationOptions} options - The options for the translation\n   * @returns The translated message\n   *\n   * @example\n   * // Simple translation without interpolation\n   * const gt = await getGT();\n   * const greeting = gt('Hello, world!');\n   *\n   * @example\n   * // Translation with interpolation\n   * const gt = await getGT();\n   * const welcome = gt('Hello, {name}!', { name: 'Alice' });\n   */\n  const gt: GTFunctionType = (\n    message: string,\n    options: InlineTranslationOptions = {}\n  ) => {\n    const targetLocale = options.$locale ?? locale;\n    const lookupOptions = createLookupOptions<StringFormat>(\n      targetLocale,\n      options,\n      'ICU'\n    );\n\n    // Lookup translation\n    const translation = i18nManager.lookupTranslation(\n      lookupOptions.$locale,\n      message,\n      lookupOptions\n    );\n\n    // Format result\n    return interpolateMessage({\n      source: message,\n      target: translation,\n      options: lookupOptions,\n      sourceLocale,\n    });\n  };\n\n  return gt;\n}\n","import { InlineResolveOptions } from '../types/options';\nimport { decodeOptions } from '../msg/decodeOptions';\nimport { isEncodedTranslationOptions } from '../utils/isEncodedTranslationOptions';\nimport { getGT } from './getGT';\nimport { MFunctionType } from '../types/functions';\n\n/**\n * Returns the m function that resolves a registered message to its translation.\n * @returns A promise of the m function\n *\n * @example\n * // Registration\n * const registeredMessage = msg('Hello, world!');\n *\n * // Resolution\n * const m = await getMessages();\n * const greeting = m(registeredMessage);\n */\nexport async function getMessages(): Promise<MFunctionType> {\n  // Get the gt function\n  const gt = await getGT();\n\n  /**\n   * Resolves a registered message to its translation.\n   * @param {string | null | undefined} encodedMsg - The encoded message to decode and interpolate.\n   * @param {InlineTranslationOptions} options - The options to interpolate.\n   * @returns - The decoded and interpolated message.\n   *\n   * @example\n   * // Simple message without interpolation\n   * const m = await getMessages();\n   * const greeting = m(msg('Hello, world!'));\n   *\n   * @example\n   * // Message with interpolation\n   * const m = await getMessages();\n   * const welcome = m(msg('Welcome, {user}!'), { user: 'Alice' });\n   */\n  const m: MFunctionType = <T extends string | null | undefined>(\n    encodedMsg: T,\n    options: InlineResolveOptions = {}\n  ): T extends string ? string : T => {\n    // Return if the encoded message is null or undefined\n    if (encodedMsg == null) return encodedMsg as T extends string ? string : T;\n\n    // Get any encoded options\n    const decodedOptions = decodeOptions(encodedMsg) ?? {};\n\n    // Return early if string already interpolated eg: mFallback(msg('Hello, {name}!', { name: 'Brian' }))\n    if (isEncodedTranslationOptions(decodedOptions)) {\n      return gt(decodedOptions.$_source, decodedOptions) as T extends string\n        ? string\n        : T;\n    }\n\n    // Use gt to interpolate\n    // Separate from decoded options to match behavior in @gt/react-core\n    return gt(encodedMsg, options) as T extends string ? string : T;\n  };\n\n  return m;\n}\n","import {\n  getCurrentLocale,\n  getI18nManager,\n} from '../../i18n-manager/singleton-operations';\nimport { DictionaryTranslationOptions } from '../types/options';\nimport { TFunctionType } from '../types/functions';\nimport { interpolateMessage } from '../utils/interpolation/interpolateMessage';\nimport { createLookupOptions } from './helpers';\nimport { extractVariables } from '../../utils/extractVariables';\nimport type { StringFormat } from 'generaltranslation/types';\nimport type {\n  DictionaryEntry,\n  DictionaryValue,\n} from '../../i18n-manager/translations-manager/DictionaryCache';\nimport {\n  getDictionaryEntry,\n  isDictionaryValue,\n  resolveDictionaryLookupOptions,\n} from '../../i18n-manager/translations-manager/utils/dictionary-helpers';\nimport type { DictionaryObjectTranslation } from '../types/functions';\n\n/**\n * Returns the t function that translates a dictionary entry based on its id and options.\n * @returns A promise of the t function\n * @important Must be used inside of a request context\n *\n * @example\n * const t = await getTranslations();\n * const title = await t('page.title');\n */\nexport async function getTranslations(): Promise<TFunctionType> {\n  const i18nManager = getI18nManager();\n  const locale = getCurrentLocale();\n  await i18nManager.loadDictionary(locale);\n  const sourceLocale = i18nManager.getDefaultLocale();\n\n  /**\n   * Dictionary resolution\n   * @param {string} id - The id of the translation to translate.\n   * @param {DictionaryTranslationOptions} options - The options for interpolation.\n   * @returns {string} The translated message.\n   *\n   * @example\n   * // Simple dictionary lookup without interpolation\n   * const t = await getTranslations();\n   * const title = t('page.title');\n   *\n   * @example\n   * // Dictionary lookup with interpolation\n   * const t = await getTranslations();\n   * const greeting = t('user.greeting', { name: 'Bob' });\n   */\n  const t = ((\n    id: string,\n    options: DictionaryTranslationOptions = {}\n  ): string => {\n    const sourceEntry = i18nManager.lookupDictionary(sourceLocale, id);\n    if (sourceEntry === undefined) {\n      throw new Error(`Dictionary entry ${id} cannot be found`);\n    }\n    const targetEntry = i18nManager.lookupDictionary(locale, id);\n    return renderEntry({\n      sourceLocale,\n      targetLocale: locale,\n      sourceEntry,\n      targetEntry,\n      options,\n    });\n  }) as TFunctionType;\n\n  t.obj = (id: string): DictionaryObjectTranslation => {\n    const sourceObject = i18nManager.lookupDictionaryObj(sourceLocale, id);\n    if (sourceObject === undefined) {\n      throw new Error(`Dictionary entry ${id} cannot be found`);\n    }\n    const targetObject = i18nManager.lookupDictionaryObj(locale, id);\n    return renderObject({ sourceObject, targetObject });\n  };\n\n  return t;\n}\n\nfunction renderEntry({\n  sourceLocale,\n  targetLocale,\n  sourceEntry,\n  targetEntry,\n  options = {},\n}: {\n  sourceLocale: string;\n  targetLocale: string;\n  sourceEntry: DictionaryEntry;\n  targetEntry: DictionaryEntry | undefined;\n  options?: DictionaryTranslationOptions;\n}): string {\n  const dictionaryOptions = resolveDictionaryLookupOptions(sourceEntry.options);\n  const interpolationOptions = extractVariables(options);\n  const lookupOptions = createLookupOptions<StringFormat>(\n    targetLocale,\n    {\n      ...dictionaryOptions,\n      ...interpolationOptions,\n    },\n    dictionaryOptions.$format ?? 'ICU'\n  );\n\n  return interpolateMessage({\n    source: sourceEntry.entry,\n    target: targetEntry?.entry,\n    options: lookupOptions,\n    sourceLocale,\n  });\n}\n\nfunction renderObject({\n  sourceObject,\n  targetObject,\n}: {\n  sourceObject: DictionaryValue | undefined;\n  targetObject: DictionaryValue | undefined;\n}): DictionaryObjectTranslation {\n  const targetEntry = getDictionaryEntry(targetObject);\n  if (targetEntry !== undefined) {\n    return targetEntry.entry;\n  }\n\n  if (isDictionaryValue(targetObject)) {\n    if (!isDictionaryValue(sourceObject)) {\n      return renderObject({\n        sourceObject: targetObject,\n        targetObject: undefined,\n      });\n    }\n\n    return renderDictionaryObject({\n      sourceObject,\n      targetObject,\n    });\n  }\n\n  const sourceEntry = getDictionaryEntry(sourceObject);\n  if (sourceEntry !== undefined) {\n    return sourceEntry.entry;\n  }\n\n  if (isDictionaryValue(sourceObject)) {\n    return renderDictionaryObject({\n      sourceObject,\n      targetObject: undefined,\n    });\n  }\n\n  throw new Error('Dictionary object cannot be rendered');\n}\n\nfunction renderDictionaryObject({\n  sourceObject,\n  targetObject,\n}: {\n  sourceObject: DictionaryValue;\n  targetObject: DictionaryValue | undefined;\n}): DictionaryObjectTranslation {\n  if (!isDictionaryValue(sourceObject)) {\n    return renderObject({ sourceObject, targetObject });\n  }\n  const result: Record<string, DictionaryObjectTranslation> = {};\n  const keys = new Set([\n    ...Object.keys(sourceObject),\n    ...(isDictionaryValue(targetObject) ? Object.keys(targetObject) : []),\n  ]);\n\n  for (const key of keys) {\n    const renderedChild = renderObject({\n      sourceObject: sourceObject[key],\n      targetObject: isDictionaryValue(targetObject)\n        ? targetObject[key]\n        : undefined,\n    });\n    if (renderedChild !== undefined) {\n      result[key] = renderedChild;\n    }\n  }\n\n  return result;\n}\n","import { RuntimeTranslationOptions } from '../types/options';\nimport type { StringFormat } from 'generaltranslation/types';\nimport { resolveStringContentWithRuntimeFallback } from './helpers';\nimport { getCurrentLocale } from '../../i18n-manager/singleton-operations';\n\ntype RuntimeTranslationOptionsWithFormat = Omit<\n  RuntimeTranslationOptions,\n  '$format'\n> & {\n  $format?: StringFormat;\n};\n\n/**\n * Translates a message at runtime.\n * @param {string} message - The message to translate.\n * @param {RuntimeTranslationOptions} options - The options for the translation.\n * @returns {Promise<string>} The translated message.\n *\n * @example\n * // Simple runtime translation without interpolation\n * const status = await tx('Processing complete', { $locale: 'es-MX' });\n *\n * @example\n * // Runtime translation with interpolation\n * const progress = await tx(`Processing ${status}`, { $locale: 'es-MX' });\n */\nexport async function tx(\n  content: string,\n  options: RuntimeTranslationOptionsWithFormat = {}\n): Promise<string> {\n  const locale = options.$locale ?? getCurrentLocale();\n  return resolveStringContentWithRuntimeFallback(locale, content, {\n    $format: 'STRING',\n    ...options,\n  });\n}\n","import { InlineTranslationOptions } from '../types/options';\nimport {\n  resolveStringContent,\n  resolveStringContentWithFallback,\n} from './helpers';\n\n/**\n * Synchronously resolve a translation for a given message and options\n * @param {string} message - The message to translate.\n * @param {InlineTranslationOptions} [options] - The options for the translation.\n * @returns {string | undefined} The translated message or undefined if the message is not found.\n * @deprecated use resolveTranslation instead\n */\nexport function resolveTranslationSync(\n  locale: string,\n  message: string,\n  options: InlineTranslationOptions = {}\n) {\n  return resolveStringContent(locale, message, { $format: 'ICU', ...options });\n}\n\n/**\n * Translate a message\n * @param {string} message - The message to translate.\n * @param {InlineTranslationOptions} [options] - The options for the translation.\n * @returns {string} The translated message or the original message interpolated if the translation is not found.\n * @deprecated use resolveTranslationWithFallback instead\n */\nexport function resolveTranslationSyncWithFallback(\n  locale: string,\n  message: string,\n  options: InlineTranslationOptions = {}\n) {\n  return resolveStringContentWithFallback(locale, message, {\n    $format: 'ICU',\n    ...options,\n  });\n}\n","import { JsxChildren } from 'generaltranslation/types';\nimport { JsxTranslationOptions } from '../types/options';\nimport { resolveJsx } from './helpers';\n\n/**\n * Given a JsxChildren and any associated metadata needed for a hash calculation, resolve the associated translation.\n * @deprecated use resolveJsx instead\n */\nexport function resolveJsxTranslation(\n  locale: string,\n  children: JsxChildren,\n  options: JsxTranslationOptions = {}\n) {\n  return resolveJsx(locale, children, options);\n}\n","import type { ConditionStore } from '../types';\nimport { setConditionStore as setCurrentConditionStore } from '../singleton-operations';\n\nexport function createConditionStoreSingleton<T extends ConditionStore>(\n  notInitializedMessage: string\n) {\n  let conditionStore: T | undefined;\n\n  function getConditionStore(): T {\n    if (!conditionStore) {\n      throw new Error(notInitializedMessage);\n    }\n    return conditionStore;\n  }\n\n  function setConditionStore(nextConditionStore: T): void {\n    conditionStore = nextConditionStore;\n    setCurrentConditionStore(nextConditionStore);\n  }\n\n  return {\n    getConditionStore,\n    setConditionStore,\n  };\n}\n","import { LocaleConfig } from 'generaltranslation/core';\nimport { libraryDefaultLocale } from 'generaltranslation/internal';\nimport type { ConditionStoreConfig } from '../types';\n\nexport type LocaleCandidates = string | string[] | undefined;\n\nfunction normalizeConditionStoreConfig({\n  defaultLocale,\n  locales,\n  customMapping,\n}: ConditionStoreConfig = {}) {\n  const fallbackLocale = defaultLocale || libraryDefaultLocale;\n  return {\n    defaultLocale: fallbackLocale,\n    locales: locales?.length ? locales : [fallbackLocale],\n    customMapping,\n  };\n}\n\ntype NormalizedConditionStoreConfig = ReturnType<\n  typeof normalizeConditionStoreConfig\n>;\n\n/**\n * Return the best supported locale for the candidates, or undefined when none match.\n */\nexport function determineSupportedLocale(\n  candidates: LocaleCandidates,\n  config: ConditionStoreConfig = {}\n): string | undefined {\n  return determineSupportedLocaleWithConfig(\n    candidates,\n    normalizeConditionStoreConfig(config)\n  );\n}\n\nfunction determineSupportedLocaleWithConfig(\n  candidates: LocaleCandidates,\n  config: NormalizedConditionStoreConfig\n): string | undefined {\n  if (\n    candidates == null ||\n    (Array.isArray(candidates) && candidates.length === 0)\n  ) {\n    return undefined;\n  }\n\n  const localeConfig = new LocaleConfig(config);\n  return localeConfig.determineLocale(candidates) || undefined;\n}\n\n/**\n * Return the best supported locale for the candidates, falling back to the default locale.\n */\nexport function resolveSupportedLocale(\n  candidates: LocaleCandidates,\n  config: ConditionStoreConfig = {}\n): string {\n  const normalizedConfig = normalizeConditionStoreConfig(config);\n  return (\n    determineSupportedLocaleWithConfig(candidates, normalizedConfig) ||\n    normalizedConfig.defaultLocale\n  );\n}\n\nexport function createLocaleResolver(config: ConditionStoreConfig = {}) {\n  const normalizedConfig = normalizeConditionStoreConfig(config);\n  return (candidates?: LocaleCandidates): string =>\n    determineSupportedLocaleWithConfig(candidates, normalizedConfig) ||\n    normalizedConfig.defaultLocale;\n}\n"],"mappings":"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"}
+{"version":3,"file":"internal.cjs","names":["getI18nManager","getCurrentLocale","createLookupOptions","interpolateMessage","decodeOptions","isEncodedTranslationOptions","getI18nManager","getCurrentLocale","resolveDictionaryLookupOptions","getDictionaryEntry","isDictionaryValue","extractVariables","createLookupOptions","interpolateMessage","resolveStringContentWithRuntimeFallback","getCurrentLocale","resolveStringContent","resolveStringContentWithFallback","resolveJsx","setConditionStore","libraryDefaultLocale","LocaleConfig"],"sources":["../src/translation-functions/internal/getGT.ts","../src/translation-functions/internal/getMessages.ts","../src/translation-functions/internal/getTranslations.ts","../src/translation-functions/internal/tx.ts","../src/translation-functions/internal/sync-translation-resolution.ts","../src/translation-functions/internal/jsx-resolution.ts","../src/i18n-manager/condition-store/createConditionStoreSingleton.ts","../src/i18n-manager/condition-store/localeResolver.ts"],"sourcesContent":["import {\n  getCurrentLocale,\n  getI18nManager,\n} from '../../i18n-manager/singleton-operations';\nimport { InlineTranslationOptions } from '../types/options';\nimport { GTFunctionType } from '../types/functions';\nimport { interpolateMessage } from '../utils/interpolation/interpolateMessage';\nimport { createLookupOptions } from './helpers';\nimport type { StringFormat } from 'generaltranslation/types';\n\n/**\n * Returns the gt function that registers a string at build time and resolves its translation at runtime.\n * @returns A promise of the gt function\n *\n * @example\n * const gt = await getGT();\n * const greeting = gt('Hello, world!');\n */\nexport async function getGT(): Promise<GTFunctionType> {\n  // Get the translation resolver\n  const i18nManager = getI18nManager();\n  const locale = getCurrentLocale();\n  await i18nManager.loadTranslations(locale);\n  const sourceLocale = i18nManager.getDefaultLocale();\n\n  /**\n   * Registers a message at build time and resolves its translation at runtime.\n   * @param {string} message - The message to translate\n   * @param {InlineTranslationOptions} options - The options for the translation\n   * @returns The translated message\n   *\n   * @example\n   * // Simple translation without interpolation\n   * const gt = await getGT();\n   * const greeting = gt('Hello, world!');\n   *\n   * @example\n   * // Translation with interpolation\n   * const gt = await getGT();\n   * const welcome = gt('Hello, {name}!', { name: 'Alice' });\n   */\n  const gt: GTFunctionType = (\n    message: string,\n    options: InlineTranslationOptions = {}\n  ) => {\n    const targetLocale = options.$locale ?? locale;\n    const lookupOptions = createLookupOptions<StringFormat>(\n      targetLocale,\n      options,\n      'ICU'\n    );\n\n    // Lookup translation\n    const translation = i18nManager.lookupTranslation(\n      lookupOptions.$locale,\n      message,\n      lookupOptions\n    );\n\n    // Format result\n    return interpolateMessage({\n      source: message,\n      target: translation,\n      options: lookupOptions,\n      sourceLocale,\n    });\n  };\n\n  return gt;\n}\n","import { InlineResolveOptions } from '../types/options';\nimport { decodeOptions } from '../msg/decodeOptions';\nimport { isEncodedTranslationOptions } from '../utils/isEncodedTranslationOptions';\nimport { getGT } from './getGT';\nimport { MFunctionType } from '../types/functions';\n\n/**\n * Returns the m function that resolves a registered message to its translation.\n * @returns A promise of the m function\n *\n * @example\n * // Registration\n * const registeredMessage = msg('Hello, world!');\n *\n * // Resolution\n * const m = await getMessages();\n * const greeting = m(registeredMessage);\n */\nexport async function getMessages(): Promise<MFunctionType> {\n  // Get the gt function\n  const gt = await getGT();\n\n  /**\n   * Resolves a registered message to its translation.\n   * @param {string | null | undefined} encodedMsg - The encoded message to decode and interpolate.\n   * @param {InlineTranslationOptions} options - The options to interpolate.\n   * @returns - The decoded and interpolated message.\n   *\n   * @example\n   * // Simple message without interpolation\n   * const m = await getMessages();\n   * const greeting = m(msg('Hello, world!'));\n   *\n   * @example\n   * // Message with interpolation\n   * const m = await getMessages();\n   * const welcome = m(msg('Welcome, {user}!'), { user: 'Alice' });\n   */\n  const m: MFunctionType = <T extends string | null | undefined>(\n    encodedMsg: T,\n    options: InlineResolveOptions = {}\n  ): T extends string ? string : T => {\n    // Return if the encoded message is null or undefined\n    if (encodedMsg == null) return encodedMsg as T extends string ? string : T;\n\n    // Get any encoded options\n    const decodedOptions = decodeOptions(encodedMsg) ?? {};\n\n    // Return early if string already interpolated eg: mFallback(msg('Hello, {name}!', { name: 'Brian' }))\n    if (isEncodedTranslationOptions(decodedOptions)) {\n      return gt(decodedOptions.$_source, decodedOptions) as T extends string\n        ? string\n        : T;\n    }\n\n    // Use gt to interpolate\n    // Separate from decoded options to match behavior in @gt/react-core\n    return gt(encodedMsg, options) as T extends string ? string : T;\n  };\n\n  return m;\n}\n","import {\n  getCurrentLocale,\n  getI18nManager,\n} from '../../i18n-manager/singleton-operations';\nimport { DictionaryTranslationOptions } from '../types/options';\nimport { TFunctionType } from '../types/functions';\nimport { interpolateMessage } from '../utils/interpolation/interpolateMessage';\nimport { createLookupOptions } from './helpers';\nimport { extractVariables } from '../../utils/extractVariables';\nimport type { StringFormat } from 'generaltranslation/types';\nimport type {\n  DictionaryEntry,\n  DictionaryValue,\n} from '../../i18n-manager/translations-manager/DictionaryCache';\nimport {\n  getDictionaryEntry,\n  isDictionaryValue,\n  resolveDictionaryLookupOptions,\n} from '../../i18n-manager/translations-manager/utils/dictionary-helpers';\nimport type { DictionaryObjectTranslation } from '../types/functions';\n\n/**\n * Returns the t function that translates a dictionary entry based on its id and options.\n * @returns A promise of the t function\n * @important Must be used inside of a request context\n *\n * @example\n * const t = await getTranslations();\n * const title = await t('page.title');\n */\nexport async function getTranslations(): Promise<TFunctionType> {\n  const i18nManager = getI18nManager();\n  const locale = getCurrentLocale();\n  await Promise.all([\n    i18nManager.loadDictionary(locale),\n    i18nManager.loadTranslations(locale),\n  ]);\n  const sourceLocale = i18nManager.getDefaultLocale();\n\n  /**\n   * Dictionary resolution\n   * @param {string} id - The id of the translation to translate.\n   * @param {DictionaryTranslationOptions} options - The options for interpolation.\n   * @returns {string} The translated message.\n   *\n   * @example\n   * // Simple dictionary lookup without interpolation\n   * const t = await getTranslations();\n   * const title = t('page.title');\n   *\n   * @example\n   * // Dictionary lookup with interpolation\n   * const t = await getTranslations();\n   * const greeting = t('user.greeting', { name: 'Bob' });\n   */\n  const t = ((\n    id: string,\n    options: DictionaryTranslationOptions = {}\n  ): string => {\n    const sourceEntry = i18nManager.lookupDictionary(sourceLocale, id);\n    if (sourceEntry === undefined) {\n      throw new Error(`Dictionary entry ${id} cannot be found`);\n    }\n    const targetEntry = i18nManager.lookupDictionary(locale, id);\n    const dictionaryOptions = resolveDictionaryLookupOptions(\n      sourceEntry.options\n    );\n    const target =\n      targetEntry?.entry ??\n      i18nManager.lookupTranslation(\n        locale,\n        sourceEntry.entry,\n        dictionaryOptions\n      );\n    return renderEntry({\n      sourceLocale,\n      targetLocale: locale,\n      sourceEntry,\n      target,\n      dictionaryOptions,\n      options,\n    });\n  }) as TFunctionType;\n\n  /**\n   * Returns a subtree of the dictionary object translation based on its id.\n   * @param {string} id - The id of the translation to translate.\n   * @returns The translated object.\n   *\n   * @example\n   * const t = await getTranslations();\n   * const greetings = t.obj('greetings');\n   * console.log(greetings);\n   * // { greeting1: 'Hello', greeting2: 'Hi' }\n   */\n  t.obj = (id: string): DictionaryObjectTranslation => {\n    const sourceObject = i18nManager.lookupDictionaryObj(sourceLocale, id);\n    if (sourceObject === undefined) {\n      throw new Error(`Dictionary entry ${id} cannot be found`);\n    }\n    const targetObject = i18nManager.lookupDictionaryObj(locale, id);\n    return renderObject({ sourceObject, targetObject });\n  };\n\n  function renderObject({\n    sourceObject,\n    targetObject,\n  }: {\n    sourceObject: DictionaryValue | undefined;\n    targetObject: DictionaryValue | undefined;\n  }): DictionaryObjectTranslation {\n    const targetEntry = getDictionaryEntry(targetObject);\n    if (targetEntry !== undefined) {\n      return targetEntry.entry;\n    }\n\n    if (isDictionaryValue(targetObject)) {\n      if (!isDictionaryValue(sourceObject)) {\n        return renderObject({\n          sourceObject: targetObject,\n          targetObject: undefined,\n        });\n      }\n\n      return renderDictionaryObject({\n        sourceObject,\n        targetObject,\n      });\n    }\n\n    const sourceEntry = getDictionaryEntry(sourceObject);\n    if (sourceEntry !== undefined) {\n      // Fallback to translations cache\n      const dictionaryOptions = resolveDictionaryLookupOptions(\n        sourceEntry.options\n      );\n\n      const target = i18nManager.lookupTranslation(\n        locale,\n        sourceEntry.entry,\n        dictionaryOptions\n      );\n      if (target !== undefined) {\n        return target;\n      }\n\n      // Fallback to source entry\n      return sourceEntry.entry;\n    }\n\n    if (isDictionaryValue(sourceObject)) {\n      return renderDictionaryObject({\n        sourceObject,\n        targetObject: undefined,\n      });\n    }\n\n    throw new Error('Dictionary object cannot be rendered');\n  }\n\n  function renderDictionaryObject({\n    sourceObject,\n    targetObject,\n  }: {\n    sourceObject: DictionaryValue;\n    targetObject: DictionaryValue | undefined;\n  }): DictionaryObjectTranslation {\n    if (!isDictionaryValue(sourceObject)) {\n      return renderObject({ sourceObject, targetObject });\n    }\n    const result: Record<string, DictionaryObjectTranslation> = {};\n    const keys = new Set([\n      ...Object.keys(sourceObject),\n      ...(isDictionaryValue(targetObject) ? Object.keys(targetObject) : []),\n    ]);\n\n    for (const key of Array.from(keys)) {\n      const renderedChild = renderObject({\n        sourceObject: sourceObject[key],\n        targetObject: isDictionaryValue(targetObject)\n          ? targetObject[key]\n          : undefined,\n      });\n      if (renderedChild !== undefined) {\n        result[key] = renderedChild;\n      }\n    }\n\n    return result;\n  }\n\n  return t;\n}\n\nfunction renderEntry({\n  sourceLocale,\n  targetLocale,\n  sourceEntry,\n  target,\n  dictionaryOptions,\n  options = {},\n}: {\n  sourceLocale: string;\n  targetLocale: string;\n  sourceEntry: DictionaryEntry;\n  target: string | undefined;\n  dictionaryOptions: ReturnType<typeof resolveDictionaryLookupOptions>;\n  options?: DictionaryTranslationOptions;\n}): string {\n  const interpolationOptions = extractVariables(options);\n  const lookupOptions = createLookupOptions<StringFormat>(\n    targetLocale,\n    {\n      ...dictionaryOptions,\n      ...interpolationOptions,\n    },\n    dictionaryOptions.$format ?? 'ICU'\n  );\n\n  return interpolateMessage({\n    source: sourceEntry.entry,\n    target,\n    options: lookupOptions,\n    sourceLocale,\n  });\n}\n","import { RuntimeTranslationOptions } from '../types/options';\nimport type { StringFormat } from 'generaltranslation/types';\nimport { resolveStringContentWithRuntimeFallback } from './helpers';\nimport { getCurrentLocale } from '../../i18n-manager/singleton-operations';\n\ntype RuntimeTranslationOptionsWithFormat = Omit<\n  RuntimeTranslationOptions,\n  '$format'\n> & {\n  $format?: StringFormat;\n};\n\n/**\n * Translates a message at runtime.\n * @param {string} message - The message to translate.\n * @param {RuntimeTranslationOptions} options - The options for the translation.\n * @returns {Promise<string>} The translated message.\n *\n * @example\n * // Simple runtime translation without interpolation\n * const status = await tx('Processing complete', { $locale: 'es-MX' });\n *\n * @example\n * // Runtime translation with interpolation\n * const progress = await tx(`Processing ${status}`, { $locale: 'es-MX' });\n */\nexport async function tx(\n  content: string,\n  options: RuntimeTranslationOptionsWithFormat = {}\n): Promise<string> {\n  const locale = options.$locale ?? getCurrentLocale();\n  return resolveStringContentWithRuntimeFallback(locale, content, {\n    $format: 'STRING',\n    ...options,\n  });\n}\n","import { InlineTranslationOptions } from '../types/options';\nimport {\n  resolveStringContent,\n  resolveStringContentWithFallback,\n} from './helpers';\n\n/**\n * Synchronously resolve a translation for a given message and options\n * @param {string} message - The message to translate.\n * @param {InlineTranslationOptions} [options] - The options for the translation.\n * @returns {string | undefined} The translated message or undefined if the message is not found.\n * @deprecated use resolveTranslation instead\n */\nexport function resolveTranslationSync(\n  locale: string,\n  message: string,\n  options: InlineTranslationOptions = {}\n) {\n  return resolveStringContent(locale, message, { $format: 'ICU', ...options });\n}\n\n/**\n * Translate a message\n * @param {string} message - The message to translate.\n * @param {InlineTranslationOptions} [options] - The options for the translation.\n * @returns {string} The translated message or the original message interpolated if the translation is not found.\n * @deprecated use resolveTranslationWithFallback instead\n */\nexport function resolveTranslationSyncWithFallback(\n  locale: string,\n  message: string,\n  options: InlineTranslationOptions = {}\n) {\n  return resolveStringContentWithFallback(locale, message, {\n    $format: 'ICU',\n    ...options,\n  });\n}\n","import { JsxChildren } from 'generaltranslation/types';\nimport { JsxTranslationOptions } from '../types/options';\nimport { resolveJsx } from './helpers';\n\n/**\n * Given a JsxChildren and any associated metadata needed for a hash calculation, resolve the associated translation.\n * @deprecated use resolveJsx instead\n */\nexport function resolveJsxTranslation(\n  locale: string,\n  children: JsxChildren,\n  options: JsxTranslationOptions = {}\n) {\n  return resolveJsx(locale, children, options);\n}\n","import type { ConditionStore } from '../types';\nimport { setConditionStore as setCurrentConditionStore } from '../singleton-operations';\n\nexport function createConditionStoreSingleton<T extends ConditionStore>(\n  notInitializedMessage: string\n) {\n  let conditionStore: T | undefined;\n\n  function getConditionStore(): T {\n    if (!conditionStore) {\n      throw new Error(notInitializedMessage);\n    }\n    return conditionStore;\n  }\n\n  function setConditionStore(nextConditionStore: T): void {\n    conditionStore = nextConditionStore;\n    setCurrentConditionStore(nextConditionStore);\n  }\n\n  return {\n    getConditionStore,\n    setConditionStore,\n  };\n}\n","import { LocaleConfig } from 'generaltranslation/core';\nimport { libraryDefaultLocale } from 'generaltranslation/internal';\nimport type { ConditionStoreConfig } from '../types';\n\nexport type LocaleCandidates = string | string[] | undefined;\n\nfunction normalizeConditionStoreConfig({\n  defaultLocale,\n  locales,\n  customMapping,\n}: ConditionStoreConfig = {}) {\n  const fallbackLocale = defaultLocale || libraryDefaultLocale;\n  return {\n    defaultLocale: fallbackLocale,\n    locales: locales?.length ? locales : [fallbackLocale],\n    customMapping,\n  };\n}\n\ntype NormalizedConditionStoreConfig = ReturnType<\n  typeof normalizeConditionStoreConfig\n>;\n\n/**\n * Return the best supported locale for the candidates, or undefined when none match.\n */\nexport function determineSupportedLocale(\n  candidates: LocaleCandidates,\n  config: ConditionStoreConfig = {}\n): string | undefined {\n  return determineSupportedLocaleWithConfig(\n    candidates,\n    normalizeConditionStoreConfig(config)\n  );\n}\n\nfunction determineSupportedLocaleWithConfig(\n  candidates: LocaleCandidates,\n  config: NormalizedConditionStoreConfig\n): string | undefined {\n  if (\n    candidates == null ||\n    (Array.isArray(candidates) && candidates.length === 0)\n  ) {\n    return undefined;\n  }\n\n  const localeConfig = new LocaleConfig(config);\n  return localeConfig.determineLocale(candidates) || undefined;\n}\n\n/**\n * Return the best supported locale for the candidates, falling back to the default locale.\n */\nexport function resolveSupportedLocale(\n  candidates: LocaleCandidates,\n  config: ConditionStoreConfig = {}\n): string {\n  const normalizedConfig = normalizeConditionStoreConfig(config);\n  return (\n    determineSupportedLocaleWithConfig(candidates, normalizedConfig) ||\n    normalizedConfig.defaultLocale\n  );\n}\n\nexport function createLocaleResolver(config: ConditionStoreConfig = {}) {\n  const normalizedConfig = normalizeConditionStoreConfig(config);\n  return (candidates?: LocaleCandidates): string =>\n    determineSupportedLocaleWithConfig(candidates, normalizedConfig) ||\n    normalizedConfig.defaultLocale;\n}\n"],"mappings":"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"}

package/dist/internal.d.cts

@@ -129,6 +129,10 @@ type EventName = string;
 type BaseEvent = Record<EventName, unknown>;
 type Listener<Events extends BaseEvent, EventName extends keyof Events = keyof Events> = (event: Events[EventName]) => void;
 type ListenerStore<Events extends BaseEvent> = Partial<{ [EventName in keyof Events]: Set<Listener<Events, EventName>> }>;
+declare const LOCALES_CACHE_MISS_EVENT_NAME = "locales-cache-miss";
+declare const TRANSLATIONS_CACHE_MISS_EVENT_NAME = "translations-cache-miss";
+declare const LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME = "locales-dictionary-cache-miss";
+declare const DICTIONARY_CACHE_MISS_EVENT_NAME = "dictionary-cache-miss";
 /**
  * A base event for the I18nManagers
  * @prop {locales-cache-hit} - Emitted when a locale cache hit occurs
@@ -146,7 +150,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     locale: Locale;
     translations: Record<Hash, TranslationValue>;
   };
-  'locales-cache-miss': {
+  [LOCALES_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     translations: Record<Hash, TranslationValue>;
   };
@@ -155,7 +159,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     hash: Hash;
     translation: TranslationValue;
   };
-  'translations-cache-miss': {
+  [TRANSLATIONS_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     hash: Hash;
     translation: TranslationValue;
@@ -164,7 +168,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     locale: Locale;
     dictionary: Dictionary;
   };
-  'locales-dictionary-cache-miss': {
+  [LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     dictionary: Dictionary;
   };
@@ -173,7 +177,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     id: DictionaryPath;
     dictionaryEntry: DictionaryEntry;
   };
-  'dictionary-cache-miss': {
+  [DICTIONARY_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     id: DictionaryPath;
     dictionaryEntry: DictionaryEntry;
@@ -248,7 +252,7 @@ declare class I18nManager<TranslationValue extends Translation = Translation> ex
    *
    * Pair this with {@link lookupTranslation} to get the translation entry
    */
-  subscribeToTranslationsCacheMiss(listener: (event: I18nEvents<TranslationValue>['translations-cache-miss']) => void, locale: Locale, hash: Hash): () => void;
+  subscribeToTranslationsCacheMiss(listener: (event: I18nEvents<TranslationValue>[typeof TRANSLATIONS_CACHE_MISS_EVENT_NAME]) => void, locale: Locale, hash: Hash): () => void;
   /**
    * Get the default locale
    */
@@ -430,5 +434,5 @@ declare function setI18nManager<TranslationValue extends Translation>(i18nManage
  */
 declare function interpolateIcuMessage<T extends string | null | undefined>(encodedMsg: T, options: InlineTranslationOptions): T extends string ? string : T;
 //#endregion
-export { I18nManager, type LocaleCandidates, createConditionStoreSingleton, createLocaleResolver, createLookupOptions, determineSupportedLocale, getCurrentLocale, getDefaultLocale, getGT, getI18nManager, getLocale, getLocaleProperties, getLocales, getMessages, getTranslations, getVersionId, interpolateIcuMessage, resolveJsx, resolveJsxTranslation, resolveJsxWithFallback, resolveJsxWithRuntimeFallback, resolveStringContent, resolveStringContentWithFallback, resolveStringContentWithRuntimeFallback, resolveSupportedLocale, resolveTranslationSync, resolveTranslationSyncWithFallback, setConditionStore, setI18nManager, tx };
+export { DICTIONARY_CACHE_MISS_EVENT_NAME, I18nManager, LOCALES_CACHE_MISS_EVENT_NAME, LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME, type LocaleCandidates, TRANSLATIONS_CACHE_MISS_EVENT_NAME, createConditionStoreSingleton, createLocaleResolver, createLookupOptions, determineSupportedLocale, getCurrentLocale, getDefaultLocale, getGT, getI18nManager, getLocale, getLocaleProperties, getLocales, getMessages, getTranslations, getVersionId, interpolateIcuMessage, resolveJsx, resolveJsxTranslation, resolveJsxWithFallback, resolveJsxWithRuntimeFallback, resolveStringContent, resolveStringContentWithFallback, resolveStringContentWithRuntimeFallback, resolveSupportedLocale, resolveTranslationSync, resolveTranslationSyncWithFallback, setConditionStore, setI18nManager, tx };
 //# sourceMappingURL=internal.d.cts.map

package/dist/internal.d.mts

@@ -129,6 +129,10 @@ type EventName = string;
 type BaseEvent = Record<EventName, unknown>;
 type Listener<Events extends BaseEvent, EventName extends keyof Events = keyof Events> = (event: Events[EventName]) => void;
 type ListenerStore<Events extends BaseEvent> = Partial<{ [EventName in keyof Events]: Set<Listener<Events, EventName>> }>;
+declare const LOCALES_CACHE_MISS_EVENT_NAME = "locales-cache-miss";
+declare const TRANSLATIONS_CACHE_MISS_EVENT_NAME = "translations-cache-miss";
+declare const LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME = "locales-dictionary-cache-miss";
+declare const DICTIONARY_CACHE_MISS_EVENT_NAME = "dictionary-cache-miss";
 /**
  * A base event for the I18nManagers
  * @prop {locales-cache-hit} - Emitted when a locale cache hit occurs
@@ -146,7 +150,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     locale: Locale;
     translations: Record<Hash, TranslationValue>;
   };
-  'locales-cache-miss': {
+  [LOCALES_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     translations: Record<Hash, TranslationValue>;
   };
@@ -155,7 +159,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     hash: Hash;
     translation: TranslationValue;
   };
-  'translations-cache-miss': {
+  [TRANSLATIONS_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     hash: Hash;
     translation: TranslationValue;
@@ -164,7 +168,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     locale: Locale;
     dictionary: Dictionary;
   };
-  'locales-dictionary-cache-miss': {
+  [LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     dictionary: Dictionary;
   };
@@ -173,7 +177,7 @@ type I18nEvents<TranslationValue extends Translation> = BaseEvent & {
     id: DictionaryPath;
     dictionaryEntry: DictionaryEntry;
   };
-  'dictionary-cache-miss': {
+  [DICTIONARY_CACHE_MISS_EVENT_NAME]: {
     locale: Locale;
     id: DictionaryPath;
     dictionaryEntry: DictionaryEntry;
@@ -248,7 +252,7 @@ declare class I18nManager<TranslationValue extends Translation = Translation> ex
    *
    * Pair this with {@link lookupTranslation} to get the translation entry
    */
-  subscribeToTranslationsCacheMiss(listener: (event: I18nEvents<TranslationValue>['translations-cache-miss']) => void, locale: Locale, hash: Hash): () => void;
+  subscribeToTranslationsCacheMiss(listener: (event: I18nEvents<TranslationValue>[typeof TRANSLATIONS_CACHE_MISS_EVENT_NAME]) => void, locale: Locale, hash: Hash): () => void;
   /**
    * Get the default locale
    */
@@ -430,5 +434,5 @@ declare function setI18nManager<TranslationValue extends Translation>(i18nManage
  */
 declare function interpolateIcuMessage<T extends string | null | undefined>(encodedMsg: T, options: InlineTranslationOptions): T extends string ? string : T;
 //#endregion
-export { I18nManager, type LocaleCandidates, createConditionStoreSingleton, createLocaleResolver, createLookupOptions, determineSupportedLocale, getCurrentLocale, getDefaultLocale, getGT, getI18nManager, getLocale, getLocaleProperties, getLocales, getMessages, getTranslations, getVersionId, interpolateIcuMessage, resolveJsx, resolveJsxTranslation, resolveJsxWithFallback, resolveJsxWithRuntimeFallback, resolveStringContent, resolveStringContentWithFallback, resolveStringContentWithRuntimeFallback, resolveSupportedLocale, resolveTranslationSync, resolveTranslationSyncWithFallback, setConditionStore, setI18nManager, tx };
+export { DICTIONARY_CACHE_MISS_EVENT_NAME, I18nManager, LOCALES_CACHE_MISS_EVENT_NAME, LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME, type LocaleCandidates, TRANSLATIONS_CACHE_MISS_EVENT_NAME, createConditionStoreSingleton, createLocaleResolver, createLookupOptions, determineSupportedLocale, getCurrentLocale, getDefaultLocale, getGT, getI18nManager, getLocale, getLocaleProperties, getLocales, getMessages, getTranslations, getVersionId, interpolateIcuMessage, resolveJsx, resolveJsxTranslation, resolveJsxWithFallback, resolveJsxWithRuntimeFallback, resolveStringContent, resolveStringContentWithFallback, resolveStringContentWithRuntimeFallback, resolveSupportedLocale, resolveTranslationSync, resolveTranslationSyncWithFallback, setConditionStore, setI18nManager, tx };
 //# sourceMappingURL=internal.d.mts.map

package/dist/internal.mjs

@@ -1,5 +1,5 @@
 import { a as extractVariables, n as decodeOptions, r as interpolateIcuMessage, t as isEncodedTranslationOptions } from "./isEncodedTranslationOptions-DdHEzDDM.mjs";
-import { _ as setI18nManager, a as getLocales, b as isDictionaryValue, c as resolveJsxWithFallback, d as resolveStringContentWithFallback, f as resolveStringContentWithRuntimeFallback, g as setConditionStore, h as getI18nManager, i as getLocaleProperties, l as resolveJsxWithRuntimeFallback, m as getCurrentLocale, n as getDefaultLocale, o as createLookupOptions, p as interpolateMessage, r as getLocale, s as resolveJsx, t as getVersionId, u as resolveStringContent, v as I18nManager, x as resolveDictionaryLookupOptions, y as getDictionaryEntry } from "./versionId-D0t6HuUM.mjs";
+import { C as getDictionaryEntry, S as TRANSLATIONS_CACHE_MISS_EVENT_NAME, T as resolveDictionaryLookupOptions, _ as setI18nManager, a as getLocales, b as LOCALES_CACHE_MISS_EVENT_NAME, c as resolveJsxWithFallback, d as resolveStringContentWithFallback, f as resolveStringContentWithRuntimeFallback, g as setConditionStore, h as getI18nManager, i as getLocaleProperties, l as resolveJsxWithRuntimeFallback, m as getCurrentLocale, n as getDefaultLocale, o as createLookupOptions, p as interpolateMessage, r as getLocale, s as resolveJsx, t as getVersionId, u as resolveStringContent, v as I18nManager, w as isDictionaryValue, x as LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME, y as DICTIONARY_CACHE_MISS_EVENT_NAME } from "./versionId-CB81YFd9.mjs";
 import { libraryDefaultLocale } from "generaltranslation/internal";
 import { LocaleConfig } from "generaltranslation/core";
 //#region src/translation-functions/internal/getGT.ts
@@ -97,7 +97,7 @@ async function getMessages() {
 async function getTranslations() {
 	const i18nManager = getI18nManager();
 	const locale = getCurrentLocale();
-	await i18nManager.loadDictionary(locale);
+	await Promise.all([i18nManager.loadDictionary(locale), i18nManager.loadTranslations(locale)]);
 	const sourceLocale = i18nManager.getDefaultLocale();
 	/**
 	* Dictionary resolution
@@ -118,14 +118,28 @@ async function getTranslations() {
 	const t = ((id, options = {}) => {
 		const sourceEntry = i18nManager.lookupDictionary(sourceLocale, id);
 		if (sourceEntry === void 0) throw new Error(`Dictionary entry ${id} cannot be found`);
+		const targetEntry = i18nManager.lookupDictionary(locale, id);
+		const dictionaryOptions = resolveDictionaryLookupOptions(sourceEntry.options);
 		return renderEntry({
 			sourceLocale,
 			targetLocale: locale,
 			sourceEntry,
-			targetEntry: i18nManager.lookupDictionary(locale, id),
+			target: targetEntry?.entry ?? i18nManager.lookupTranslation(locale, sourceEntry.entry, dictionaryOptions),
+			dictionaryOptions,
 			options
 		});
 	});
+	/**
+	* Returns a subtree of the dictionary object translation based on its id.
+	* @param {string} id - The id of the translation to translate.
+	* @returns The translated object.
+	*
+	* @example
+	* const t = await getTranslations();
+	* const greetings = t.obj('greetings');
+	* console.log(greetings);
+	* // { greeting1: 'Hello', greeting2: 'Hi' }
+	*/
 	t.obj = (id) => {
 		const sourceObject = i18nManager.lookupDictionaryObj(sourceLocale, id);
 		if (sourceObject === void 0) throw new Error(`Dictionary entry ${id} cannot be found`);
@@ -134,10 +148,51 @@ async function getTranslations() {
 			targetObject: i18nManager.lookupDictionaryObj(locale, id)
 		});
 	};
+	function renderObject({ sourceObject, targetObject }) {
+		const targetEntry = getDictionaryEntry(targetObject);
+		if (targetEntry !== void 0) return targetEntry.entry;
+		if (isDictionaryValue(targetObject)) {
+			if (!isDictionaryValue(sourceObject)) return renderObject({
+				sourceObject: targetObject,
+				targetObject: void 0
+			});
+			return renderDictionaryObject({
+				sourceObject,
+				targetObject
+			});
+		}
+		const sourceEntry = getDictionaryEntry(sourceObject);
+		if (sourceEntry !== void 0) {
+			const dictionaryOptions = resolveDictionaryLookupOptions(sourceEntry.options);
+			const target = i18nManager.lookupTranslation(locale, sourceEntry.entry, dictionaryOptions);
+			if (target !== void 0) return target;
+			return sourceEntry.entry;
+		}
+		if (isDictionaryValue(sourceObject)) return renderDictionaryObject({
+			sourceObject,
+			targetObject: void 0
+		});
+		throw new Error("Dictionary object cannot be rendered");
+	}
+	function renderDictionaryObject({ sourceObject, targetObject }) {
+		if (!isDictionaryValue(sourceObject)) return renderObject({
+			sourceObject,
+			targetObject
+		});
+		const result = {};
+		const keys = new Set([...Object.keys(sourceObject), ...isDictionaryValue(targetObject) ? Object.keys(targetObject) : []]);
+		for (const key of Array.from(keys)) {
+			const renderedChild = renderObject({
+				sourceObject: sourceObject[key],
+				targetObject: isDictionaryValue(targetObject) ? targetObject[key] : void 0
+			});
+			if (renderedChild !== void 0) result[key] = renderedChild;
+		}
+		return result;
+	}
 	return t;
 }
-function renderEntry({ sourceLocale, targetLocale, sourceEntry, targetEntry, options = {} }) {
-	const dictionaryOptions = resolveDictionaryLookupOptions(sourceEntry.options);
+function renderEntry({ sourceLocale, targetLocale, sourceEntry, target, dictionaryOptions, options = {} }) {
 	const interpolationOptions = extractVariables(options);
 	const lookupOptions = createLookupOptions(targetLocale, {
 		...dictionaryOptions,
@@ -145,48 +200,11 @@ function renderEntry({ sourceLocale, targetLocale, sourceEntry, targetEntry, opt
 	}, dictionaryOptions.$format ?? "ICU");
 	return interpolateMessage({
 		source: sourceEntry.entry,
-		target: targetEntry?.entry,
+		target,
 		options: lookupOptions,
 		sourceLocale
 	});
 }
-function renderObject({ sourceObject, targetObject }) {
-	const targetEntry = getDictionaryEntry(targetObject);
-	if (targetEntry !== void 0) return targetEntry.entry;
-	if (isDictionaryValue(targetObject)) {
-		if (!isDictionaryValue(sourceObject)) return renderObject({
-			sourceObject: targetObject,
-			targetObject: void 0
-		});
-		return renderDictionaryObject({
-			sourceObject,
-			targetObject
-		});
-	}
-	const sourceEntry = getDictionaryEntry(sourceObject);
-	if (sourceEntry !== void 0) return sourceEntry.entry;
-	if (isDictionaryValue(sourceObject)) return renderDictionaryObject({
-		sourceObject,
-		targetObject: void 0
-	});
-	throw new Error("Dictionary object cannot be rendered");
-}
-function renderDictionaryObject({ sourceObject, targetObject }) {
-	if (!isDictionaryValue(sourceObject)) return renderObject({
-		sourceObject,
-		targetObject
-	});
-	const result = {};
-	const keys = new Set([...Object.keys(sourceObject), ...isDictionaryValue(targetObject) ? Object.keys(targetObject) : []]);
-	for (const key of keys) {
-		const renderedChild = renderObject({
-			sourceObject: sourceObject[key],
-			targetObject: isDictionaryValue(targetObject) ? targetObject[key] : void 0
-		});
-		if (renderedChild !== void 0) result[key] = renderedChild;
-	}
-	return result;
-}
 //#endregion
 //#region src/translation-functions/internal/tx.ts
 /**
@@ -295,6 +313,6 @@ function createLocaleResolver(config = {}) {
 	return (candidates) => determineSupportedLocaleWithConfig(candidates, normalizedConfig) || normalizedConfig.defaultLocale;
 }
 //#endregion
-export { I18nManager, createConditionStoreSingleton, createLocaleResolver, createLookupOptions, determineSupportedLocale, getCurrentLocale, getDefaultLocale, getGT, getI18nManager, getLocale, getLocaleProperties, getLocales, getMessages, getTranslations, getVersionId, interpolateIcuMessage, resolveJsx, resolveJsxTranslation, resolveJsxWithFallback, resolveJsxWithRuntimeFallback, resolveStringContent, resolveStringContentWithFallback, resolveStringContentWithRuntimeFallback, resolveSupportedLocale, resolveTranslationSync, resolveTranslationSyncWithFallback, setConditionStore, setI18nManager, tx };
+export { DICTIONARY_CACHE_MISS_EVENT_NAME, I18nManager, LOCALES_CACHE_MISS_EVENT_NAME, LOCALES_DICTIONARY_CACHE_MISS_EVENT_NAME, TRANSLATIONS_CACHE_MISS_EVENT_NAME, createConditionStoreSingleton, createLocaleResolver, createLookupOptions, determineSupportedLocale, getCurrentLocale, getDefaultLocale, getGT, getI18nManager, getLocale, getLocaleProperties, getLocales, getMessages, getTranslations, getVersionId, interpolateIcuMessage, resolveJsx, resolveJsxTranslation, resolveJsxWithFallback, resolveJsxWithRuntimeFallback, resolveStringContent, resolveStringContentWithFallback, resolveStringContentWithRuntimeFallback, resolveSupportedLocale, resolveTranslationSync, resolveTranslationSyncWithFallback, setConditionStore, setI18nManager, tx };
 
 //# sourceMappingURL=internal.mjs.map