gt-i18n 0.8.9 → 0.8.11

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # gt-i18n
 
+## 0.8.11
+
+### Patch Changes
+
+- [#1296](https://github.com/generaltranslation/gt/pull/1296) [`b8045ad`](https://github.com/generaltranslation/gt/commit/b8045ad0a6bf58ab39a0a1f632ed7250b670e401) Thanks [@bgub](https://github.com/bgub)! - Require explicit locales for I18nManager translation/cache operations, move current-locale lookup into higher-level helpers, and keep runtime condition storage in wrapper runtimes.
+
+## 0.8.10
+
+### Patch Changes
+
+- [#1301](https://github.com/generaltranslation/gt/pull/1301) [`a5a109c`](https://github.com/generaltranslation/gt/commit/a5a109ceab5790af1dd621578cae7b597cfd26f2) Thanks [@bgub](https://github.com/bgub)! - Fix source-locale interpolation for missing translations and resolve custom locale aliases consistently in browser and TanStack Start locale detection.
+
 ## 0.8.9
 
 ### Patch Changes

package/dist/fallbacks.d.cts

@@ -1,2 +1,2 @@
-import { n as gtFallback, t as mFallback } from "./index-Bdz9PAYJ.cjs";
+import { n as gtFallback, t as mFallback } from "./index-DJVRTYiP.cjs";
 export { gtFallback, mFallback };

package/dist/fallbacks.d.mts

@@ -1,2 +1,2 @@
-import { n as gtFallback, t as mFallback } from "./index-DdPo_-bU.mjs";
+import { n as gtFallback, t as mFallback } from "./index-YDEznmyZ.mjs";
 export { gtFallback, mFallback };

package/dist/{functions-CPODsB3C.d.mts → functions-BdYU6e8M.d.mts}

@@ -1,4 +1,4 @@
-import { a as InlineTranslationOptions, n as DictionaryTranslationOptions, o as JsxTranslationOptions } from "./options-B-yFI8LM.mjs";
+import { a as InlineTranslationOptions, n as DictionaryTranslationOptions, o as JsxTranslationOptions } from "./options-gL1Zt8jG.mjs";
 import { JsxChildren } from "generaltranslation/types";
 
 //#region src/translation-functions/types/functions.d.ts
@@ -55,7 +55,7 @@ type TFunctionType = (id: string, options?: DictionaryTranslationOptions) => str
  * @param {JsxTranslationOptions} options - The options for the translation.
  * @returns {JsxChildren} The resolved translation.
  */
-type ResolveJsxTranslationFunction = (children: JsxChildren, options?: JsxTranslationOptions) => JsxChildren | undefined;
+type ResolveJsxTranslationFunction = (locale: string, children: JsxChildren, options?: JsxTranslationOptions) => JsxChildren | undefined;
 //#endregion
 export { SyncResolutionFunctionWithFallback as a, SyncResolutionFunction as i, MFunctionType as n, TFunctionType as o, ResolveJsxTranslationFunction as r, GTFunctionType as t };
-//# sourceMappingURL=functions-CPODsB3C.d.mts.map
+//# sourceMappingURL=functions-BdYU6e8M.d.mts.map

package/dist/{functions-8ooUv8Yo.d.cts → functions-BqtnSFF4.d.cts}

@@ -1,4 +1,4 @@
-import { a as InlineTranslationOptions, n as DictionaryTranslationOptions, o as JsxTranslationOptions } from "./options-BFACoMQ2.cjs";
+import { a as InlineTranslationOptions, n as DictionaryTranslationOptions, o as JsxTranslationOptions } from "./options-BOz9P0yM.cjs";
 import { JsxChildren } from "generaltranslation/types";
 
 //#region src/translation-functions/types/functions.d.ts
@@ -55,7 +55,7 @@ type TFunctionType = (id: string, options?: DictionaryTranslationOptions) => str
  * @param {JsxTranslationOptions} options - The options for the translation.
  * @returns {JsxChildren} The resolved translation.
  */
-type ResolveJsxTranslationFunction = (children: JsxChildren, options?: JsxTranslationOptions) => JsxChildren | undefined;
+type ResolveJsxTranslationFunction = (locale: string, children: JsxChildren, options?: JsxTranslationOptions) => JsxChildren | undefined;
 //#endregion
 export { SyncResolutionFunctionWithFallback as a, SyncResolutionFunction as i, MFunctionType as n, TFunctionType as o, ResolveJsxTranslationFunction as r, GTFunctionType as t };
-//# sourceMappingURL=functions-8ooUv8Yo.d.cts.map
+//# sourceMappingURL=functions-BqtnSFF4.d.cts.map

package/dist/{index-Bdz9PAYJ.d.cts → index-DJVRTYiP.d.cts}

@@ -1,4 +1,4 @@
-import { n as MFunctionType, t as GTFunctionType } from "./functions-8ooUv8Yo.cjs";
+import { n as MFunctionType, t as GTFunctionType } from "./functions-BqtnSFF4.cjs";
 
 //#region src/translation-functions/fallbacks/gtFallback.d.ts
 /**
@@ -57,4 +57,4 @@ declare const gtFallback: GTFunctionType;
 declare const mFallback: MFunctionType;
 //#endregion
 export { gtFallback as n, mFallback as t };
-//# sourceMappingURL=index-Bdz9PAYJ.d.cts.map
+//# sourceMappingURL=index-DJVRTYiP.d.cts.map

package/dist/index-DUcoQ9y0.d.mts

@@ -0,0 +1,56 @@
+import * as _$generaltranslation_types0 from "generaltranslation/types";
+
+//#region src/helpers/locale.d.ts
+/**
+ * Get the current locale
+ * @returns The current locale
+ *
+ * @example
+ * const locale = getLocale();
+ * console.log(locale); // 'en-US'
+ */
+declare function getLocale(): string;
+/**
+ * Get the configured locales
+ * @returns The configured locales
+ *
+ * @example
+ * const locales = getLocales();
+ * console.log(locales); // ['en-US', 'es-ES']
+ */
+declare function getLocales(): string[];
+/**
+ * Get the default locale
+ * @returns The default locale
+ *
+ * @example
+ * const defaultLocale = getDefaultLocale();
+ * console.log(defaultLocale); // 'en-US'
+ */
+declare function getDefaultLocale(): string;
+/**
+ * Get the locale properties
+ * @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.
+ * @returns The locale properties
+ *
+ * @example
+ * const localeProperties = getLocaleProperties();
+ *
+ * @example
+ * const localeProperties = getLocaleProperties('en-US');
+ */
+declare function getLocaleProperties(locale?: string): _$generaltranslation_types0.LocaleProperties;
+//#endregion
+//#region src/helpers/versionId.d.ts
+/**
+ * Get the version ID for the current source
+ * @returns The version ID, if set
+ *
+ * @example
+ * const versionId = getVersionId();
+ * console.log(versionId); // 'abc123'
+ */
+declare function getVersionId(): string | undefined;
+//#endregion
+export { getLocales as a, getLocaleProperties as i, getDefaultLocale as n, getLocale as r, getVersionId as t };
+//# sourceMappingURL=index-DUcoQ9y0.d.mts.map

package/dist/{index-DdPo_-bU.d.mts → index-YDEznmyZ.d.mts}

@@ -1,4 +1,4 @@
-import { n as MFunctionType, t as GTFunctionType } from "./functions-CPODsB3C.mjs";
+import { n as MFunctionType, t as GTFunctionType } from "./functions-BdYU6e8M.mjs";
 
 //#region src/translation-functions/fallbacks/gtFallback.d.ts
 /**
@@ -57,4 +57,4 @@ declare const gtFallback: GTFunctionType;
 declare const mFallback: MFunctionType;
 //#endregion
 export { gtFallback as n, mFallback as t };
-//# sourceMappingURL=index-DdPo_-bU.d.mts.map
+//# sourceMappingURL=index-YDEznmyZ.d.mts.map

package/dist/index-jpLs__jj.d.cts

@@ -0,0 +1,56 @@
+import * as _$generaltranslation_types0 from "generaltranslation/types";
+
+//#region src/helpers/locale.d.ts
+/**
+ * Get the current locale
+ * @returns The current locale
+ *
+ * @example
+ * const locale = getLocale();
+ * console.log(locale); // 'en-US'
+ */
+declare function getLocale(): string;
+/**
+ * Get the configured locales
+ * @returns The configured locales
+ *
+ * @example
+ * const locales = getLocales();
+ * console.log(locales); // ['en-US', 'es-ES']
+ */
+declare function getLocales(): string[];
+/**
+ * Get the default locale
+ * @returns The default locale
+ *
+ * @example
+ * const defaultLocale = getDefaultLocale();
+ * console.log(defaultLocale); // 'en-US'
+ */
+declare function getDefaultLocale(): string;
+/**
+ * Get the locale properties
+ * @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.
+ * @returns The locale properties
+ *
+ * @example
+ * const localeProperties = getLocaleProperties();
+ *
+ * @example
+ * const localeProperties = getLocaleProperties('en-US');
+ */
+declare function getLocaleProperties(locale?: string): _$generaltranslation_types0.LocaleProperties;
+//#endregion
+//#region src/helpers/versionId.d.ts
+/**
+ * Get the version ID for the current source
+ * @returns The version ID, if set
+ *
+ * @example
+ * const versionId = getVersionId();
+ * console.log(versionId); // 'abc123'
+ */
+declare function getVersionId(): string | undefined;
+//#endregion
+export { getLocales as a, getLocaleProperties as i, getDefaultLocale as n, getLocale as r, getVersionId as t };
+//# sourceMappingURL=index-jpLs__jj.d.cts.map

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_isEncodedTranslationOptions = require("./isEncodedTranslationOptions-D7ltjc4f.cjs");
-const require_helpers = require("./helpers-D0T1EpJa.cjs");
+const require_versionId = require("./versionId-OYIir6FW.cjs");
 const require_mFallback = require("./mFallback-CoPRtKyL.cjs");
 let generaltranslation_internal = require("generaltranslation/internal");
 let generaltranslation_core = require("generaltranslation/core");
@@ -8,15 +8,15 @@ let generaltranslation_core = require("generaltranslation/core");
 /**
 * Translate a message
 * @param {string} message - The message to translate.
-* @param {InlineTranslationOptions} options - The options for the translation.
+* @param options - The options for the translation.
 * @returns The translated message.
 */
-const t = (message, options) => {
-	return require_helpers.resolveStringContentWithFallback(message, {
+function t(message, options = {}) {
+	return require_versionId.resolveStringContentWithFallback(options.$locale ?? require_versionId.getCurrentLocale(), message, {
 		$format: "ICU",
 		...options
 	});
-};
+}
 //#endregion
 //#region src/translation-functions/msg/msg.ts
 function msg(message, options) {
@@ -43,7 +43,7 @@ function msg(message, options) {
 		return message;
 	}
 	const $_source = message;
-	const $_hash = options.$_hash || require_helpers.hashMessage(message, {
+	const $_hash = options.$_hash || require_versionId.hashMessage(message, {
 		$format: "ICU",
 		...options
 	});
@@ -56,68 +56,6 @@ function msg(message, options) {
 	return `${interpolatedString}:${optionsEncoding}`;
 }
 //#endregion
-//#region src/helpers/locale.ts
-/**
-* Get the current locale
-* @returns The current locale
-*
-* @example
-* const locale = getLocale();
-* console.log(locale); // 'en-US'
-*/
-function getLocale() {
-	return require_helpers.getI18nManager().getLocale();
-}
-/**
-* Get the current locales
-* @returns The current locales
-*
-* @example
-* const locales = getLocales();
-* console.log(locales); // ['en-US', 'es-ES']
-*/
-function getLocales() {
-	return require_helpers.getI18nManager().getLocales();
-}
-/**
-* Get the default locale
-* @returns The default locale
-*
-* @example
-* const defaultLocale = getDefaultLocale();
-* console.log(defaultLocale); // 'en-US'
-*/
-function getDefaultLocale() {
-	return require_helpers.getI18nManager().getDefaultLocale();
-}
-/**
-* Get the locale properties
-* @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.
-* @returns The locale properties
-*
-* @example
-* const localeProperties = getLocaleProperties();
-*
-* @example
-* const localeProperties = getLocaleProperties('en-US');
-*/
-function getLocaleProperties(locale) {
-	return require_helpers.getI18nManager().getGTClass().getLocaleProperties(locale);
-}
-//#endregion
-//#region src/helpers/versionId.ts
-/**
-* Get the version ID for the current source
-* @returns The version ID, if set
-*
-* @example
-* const versionId = getVersionId();
-* console.log(versionId); // 'abc123'
-*/
-function getVersionId() {
-	return require_helpers.getI18nManager().getVersionId();
-}
-//#endregion
 Object.defineProperty(exports, "declareStatic", {
 	enumerable: true,
 	get: function() {
@@ -144,11 +82,11 @@ Object.defineProperty(exports, "derive", {
 		return generaltranslation_internal.derive;
 	}
 });
-exports.getDefaultLocale = getDefaultLocale;
-exports.getLocale = getLocale;
-exports.getLocaleProperties = getLocaleProperties;
-exports.getLocales = getLocales;
-exports.getVersionId = getVersionId;
+exports.getDefaultLocale = require_versionId.getDefaultLocale;
+exports.getLocale = require_versionId.getLocale;
+exports.getLocaleProperties = require_versionId.getLocaleProperties;
+exports.getLocales = require_versionId.getLocales;
+exports.getVersionId = require_versionId.getVersionId;
 exports.gtFallback = require_mFallback.gtFallback;
 exports.mFallback = require_mFallback.mFallback;
 exports.msg = msg;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["resolveStringContentWithFallback","extractVariables","libraryDefaultLocale","VAR_IDENTIFIER","createInterpolationFailureMessage","hashMessage","getI18nManager","getI18nManager"],"sources":["../src/translation-functions/t.ts","../src/translation-functions/msg/msg.ts","../src/helpers/locale.ts","../src/helpers/versionId.ts"],"sourcesContent":["import { resolveStringContentWithFallback } from './internal/helpers';\nimport { SyncResolutionFunctionWithFallback } from './types/functions';\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 The translated message.\n */\nexport const t: SyncResolutionFunctionWithFallback = (message, options) => {\n  return resolveStringContentWithFallback(message, {\n    $format: 'ICU',\n    ...options,\n  });\n};\n","import type {\n  EncodedTranslationOptions,\n  InlineTranslationOptions,\n} from '../types/options';\nimport { formatMessage } from 'generaltranslation/core';\nimport {\n  encode,\n  libraryDefaultLocale,\n  VAR_IDENTIFIER,\n} from 'generaltranslation/internal';\nimport { createInterpolationFailureMessage } from '../utils/messages';\nimport logger from '../../logs/logger';\nimport { extractVariables } from '../../utils/extractVariables';\nimport { hashMessage } from '../../utils/hashMessage';\nimport { RegisterableMessages } from '../types/message';\n\n/**\n * Registers a message to be translated. Returns the message unchanged if no options are provided.\n * @param {string | string[]} message The message to encode.\n * @param {InlineTranslationOptions} [options] The options to encode.\n * @returns The message or array of messages.\n *\n * @note - This function registers the message before the build process. The actual translation does not\n * occur until the m() function is invoked.\n *\n * @note - Message format\n * A message is broken into two parts separated by colons:\n * - interpolated content - the content with interpolated variables\n * - hash + options - a unique identifier for the source content and options for the translation\n *\n * @example - Basic usage\n *\n * const message1 = msg('Hello, World!');\n * console.log(message1); // \"Hello, World!\"\n *\n * const message2 = msg('Hello, {name}!', { name: 'Brian' });\n * console.log(message2); // \"Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9\"\n *\n * @example - Array usage\n *\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!']);\n * console.log(messages); // [\"Hello, Alice!\", \"Hello, Bob!\"]\n *\n * @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });\n * // \"Hello, Alice!\" id: \"greetings.0\"\n * // \"Hello, Bob!\" id: \"greetings.1\"\n *\n * @important Internal note: until other packages are updated to use i18n-context practices, msg cannot use any functions that use i18nManager at all!\n */\nexport function msg<T extends RegisterableMessages = string>(message: T): T;\nexport function msg<T extends RegisterableMessages = string>(\n  message: T,\n  options?: InlineTranslationOptions\n): T extends string ? string : string[];\nexport function msg(\n  message: RegisterableMessages,\n  options?: InlineTranslationOptions\n): RegisterableMessages {\n  // Handle array\n  if (typeof message !== 'string') {\n    if (!options) return message;\n    return message.map((m, i) =>\n      msg(m, {\n        ...options,\n        // ignore if $id is an empty string or not defined\n        ...(options.$id && { $id: `${options.$id}.${i}` }),\n      })\n    );\n  }\n\n  if (!options) {\n    return message;\n  }\n\n  // Extract variables\n  const variables = extractVariables(options);\n\n  // Interpolate string\n  let interpolatedString: string = message;\n  try {\n    interpolatedString = formatMessage(message, {\n      locales: [libraryDefaultLocale], // TODO: use compiler to insert locales\n      variables: {\n        ...variables,\n        [VAR_IDENTIFIER]: 'other',\n      },\n    });\n  } catch {\n    logger.warn(createInterpolationFailureMessage(message));\n    return message;\n  }\n\n  // Encode options\n  const $_source = message;\n  const $_hash =\n    options.$_hash ||\n    hashMessage(message, {\n      $format: 'ICU',\n      ...options,\n    });\n\n  const encodedOptions: EncodedTranslationOptions = {\n    ...options,\n    $_source,\n    $_hash,\n  };\n  const optionsEncoding = encode(JSON.stringify(encodedOptions));\n\n  // Construct result\n  return `${interpolatedString}:${optionsEncoding}`;\n}\n","import { getI18nManager } from '../i18n-manager/singleton-operations';\n\n/**\n * Get the current locale\n * @returns The current locale\n *\n * @example\n * const locale = getLocale();\n * console.log(locale); // 'en-US'\n */\nexport function getLocale() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getLocale();\n}\n\n/**\n * Get the current locales\n * @returns The current locales\n *\n * @example\n * const locales = getLocales();\n * console.log(locales); // ['en-US', 'es-ES']\n */\nexport function getLocales() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getLocales();\n}\n\n/**\n * Get the default locale\n * @returns The default locale\n *\n * @example\n * const defaultLocale = getDefaultLocale();\n * console.log(defaultLocale); // 'en-US'\n */\nexport function getDefaultLocale() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getDefaultLocale();\n}\n\n/**\n * Get the locale properties\n * @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.\n * @returns The locale properties\n *\n * @example\n * const localeProperties = getLocaleProperties();\n *\n * @example\n * const localeProperties = getLocaleProperties('en-US');\n */\nexport function getLocaleProperties(locale?: string) {\n  const i18nManager = getI18nManager();\n  const gtInstance = i18nManager.getGTClass();\n  return gtInstance.getLocaleProperties(locale);\n}\n","import { getI18nManager } from '../i18n-manager/singleton-operations';\n\n/**\n * Get the version ID for the current source\n * @returns The version ID, if set\n *\n * @example\n * const versionId = getVersionId();\n * console.log(versionId); // 'abc123'\n */\nexport function getVersionId() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getVersionId();\n}\n"],"mappings":";;;;;;;;;;;;;AASA,MAAa,KAAyC,SAAS,YAAY;AACzE,QAAOA,gBAAAA,iCAAiC,SAAS;EAC/C,SAAS;EACT,GAAG;EACJ,CAAC;;;;AC0CJ,SAAgB,IACd,SACA,SACsB;AAEtB,KAAI,OAAO,YAAY,UAAU;AAC/B,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,QAAQ,KAAK,GAAG,MACrB,IAAI,GAAG;GACL,GAAG;GAEH,GAAI,QAAQ,OAAO,EAAE,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK;GAClD,CAAC,CACH;;AAGH,KAAI,CAAC,QACH,QAAO;CAIT,MAAM,YAAYC,oCAAAA,iBAAiB,QAAQ;CAG3C,IAAI,qBAA6B;AACjC,KAAI;AACF,wBAAA,GAAA,wBAAA,eAAmC,SAAS;GAC1C,SAAS,CAACC,4BAAAA,qBAAqB;GAC/B,WAAW;IACT,GAAG;KACFC,4BAAAA,iBAAiB;IACnB;GACF,CAAC;SACI;AACN,sCAAA,eAAO,KAAKC,oCAAAA,kCAAkC,QAAQ,CAAC;AACvD,SAAO;;CAIT,MAAM,WAAW;CACjB,MAAM,SACJ,QAAQ,UACRC,gBAAAA,YAAY,SAAS;EACnB,SAAS;EACT,GAAG;EACJ,CAAC;CAEJ,MAAM,iBAA4C;EAChD,GAAG;EACH;EACA;EACD;CACD,MAAM,mBAAA,GAAA,4BAAA,QAAyB,KAAK,UAAU,eAAe,CAAC;AAG9D,QAAO,GAAG,mBAAmB,GAAG;;;;;;;;;;;;ACpGlC,SAAgB,YAAY;AAE1B,QADoBC,gBAAAA,gBACF,CAAC,WAAW;;;;;;;;;;AAWhC,SAAgB,aAAa;AAE3B,QADoBA,gBAAAA,gBACF,CAAC,YAAY;;;;;;;;;;AAWjC,SAAgB,mBAAmB;AAEjC,QADoBA,gBAAAA,gBACF,CAAC,kBAAkB;;;;;;;;;;;;;AAcvC,SAAgB,oBAAoB,QAAiB;AAGnD,QAFoBA,gBAAAA,gBACU,CAAC,YACd,CAAC,oBAAoB,OAAO;;;;;;;;;;;;AC7C/C,SAAgB,eAAe;AAE7B,QADoBC,gBAAAA,gBACF,CAAC,cAAc"}
+{"version":3,"file":"index.cjs","names":["resolveStringContentWithFallback","getCurrentLocale","extractVariables","libraryDefaultLocale","VAR_IDENTIFIER","createInterpolationFailureMessage","hashMessage"],"sources":["../src/translation-functions/t.ts","../src/translation-functions/msg/msg.ts"],"sourcesContent":["import { resolveStringContentWithFallback } from './internal/helpers';\nimport { InlineTranslationOptions } from './types/options';\nimport { getCurrentLocale } from '../i18n-manager/singleton-operations';\n\n/**\n * Translate a message\n * @param {string} message - The message to translate.\n * @param options - The options for the translation.\n * @returns The translated message.\n */\nexport function t(message: string, options: InlineTranslationOptions = {}) {\n  const locale = options.$locale ?? getCurrentLocale();\n  return resolveStringContentWithFallback(locale, message, {\n    $format: 'ICU',\n    ...options,\n  });\n}\n","import type {\n  EncodedTranslationOptions,\n  InlineTranslationOptions,\n} from '../types/options';\nimport { formatMessage } from 'generaltranslation/core';\nimport {\n  encode,\n  libraryDefaultLocale,\n  VAR_IDENTIFIER,\n} from 'generaltranslation/internal';\nimport { createInterpolationFailureMessage } from '../utils/messages';\nimport logger from '../../logs/logger';\nimport { extractVariables } from '../../utils/extractVariables';\nimport { hashMessage } from '../../utils/hashMessage';\nimport { RegisterableMessages } from '../types/message';\n\n/**\n * Registers a message to be translated. Returns the message unchanged if no options are provided.\n * @param {string | string[]} message The message to encode.\n * @param {InlineTranslationOptions} [options] The options to encode.\n * @returns The message or array of messages.\n *\n * @note - This function registers the message before the build process. The actual translation does not\n * occur until the m() function is invoked.\n *\n * @note - Message format\n * A message is broken into two parts separated by colons:\n * - interpolated content - the content with interpolated variables\n * - hash + options - a unique identifier for the source content and options for the translation\n *\n * @example - Basic usage\n *\n * const message1 = msg('Hello, World!');\n * console.log(message1); // \"Hello, World!\"\n *\n * const message2 = msg('Hello, {name}!', { name: 'Brian' });\n * console.log(message2); // \"Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9\"\n *\n * @example - Array usage\n *\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!']);\n * console.log(messages); // [\"Hello, Alice!\", \"Hello, Bob!\"]\n *\n * @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });\n * // \"Hello, Alice!\" id: \"greetings.0\"\n * // \"Hello, Bob!\" id: \"greetings.1\"\n *\n * @important Internal note: until other packages are updated to use i18n-context practices, msg cannot use any functions that use i18nManager at all!\n */\nexport function msg<T extends RegisterableMessages = string>(message: T): T;\nexport function msg<T extends RegisterableMessages = string>(\n  message: T,\n  options?: InlineTranslationOptions\n): T extends string ? string : string[];\nexport function msg(\n  message: RegisterableMessages,\n  options?: InlineTranslationOptions\n): RegisterableMessages {\n  // Handle array\n  if (typeof message !== 'string') {\n    if (!options) return message;\n    return message.map((m, i) =>\n      msg(m, {\n        ...options,\n        // ignore if $id is an empty string or not defined\n        ...(options.$id && { $id: `${options.$id}.${i}` }),\n      })\n    );\n  }\n\n  if (!options) {\n    return message;\n  }\n\n  // Extract variables\n  const variables = extractVariables(options);\n\n  // Interpolate string\n  let interpolatedString: string = message;\n  try {\n    interpolatedString = formatMessage(message, {\n      locales: [libraryDefaultLocale], // TODO: use compiler to insert locales\n      variables: {\n        ...variables,\n        [VAR_IDENTIFIER]: 'other',\n      },\n    });\n  } catch {\n    logger.warn(createInterpolationFailureMessage(message));\n    return message;\n  }\n\n  // Encode options\n  const $_source = message;\n  const $_hash =\n    options.$_hash ||\n    hashMessage(message, {\n      $format: 'ICU',\n      ...options,\n    });\n\n  const encodedOptions: EncodedTranslationOptions = {\n    ...options,\n    $_source,\n    $_hash,\n  };\n  const optionsEncoding = encode(JSON.stringify(encodedOptions));\n\n  // Construct result\n  return `${interpolatedString}:${optionsEncoding}`;\n}\n"],"mappings":";;;;;;;;;;;;;AAUA,SAAgB,EAAE,SAAiB,UAAoC,EAAE,EAAE;AAEzE,QAAOA,kBAAAA,iCADQ,QAAQ,WAAWC,kBAAAA,kBAAkB,EACJ,SAAS;EACvD,SAAS;EACT,GAAG;EACJ,CAAC;;;;ACwCJ,SAAgB,IACd,SACA,SACsB;AAEtB,KAAI,OAAO,YAAY,UAAU;AAC/B,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,QAAQ,KAAK,GAAG,MACrB,IAAI,GAAG;GACL,GAAG;GAEH,GAAI,QAAQ,OAAO,EAAE,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK;GAClD,CAAC,CACH;;AAGH,KAAI,CAAC,QACH,QAAO;CAIT,MAAM,YAAYC,oCAAAA,iBAAiB,QAAQ;CAG3C,IAAI,qBAA6B;AACjC,KAAI;AACF,wBAAA,GAAA,wBAAA,eAAmC,SAAS;GAC1C,SAAS,CAACC,4BAAAA,qBAAqB;GAC/B,WAAW;IACT,GAAG;KACFC,4BAAAA,iBAAiB;IACnB;GACF,CAAC;SACI;AACN,sCAAA,eAAO,KAAKC,oCAAAA,kCAAkC,QAAQ,CAAC;AACvD,SAAO;;CAIT,MAAM,WAAW;CACjB,MAAM,SACJ,QAAQ,UACRC,kBAAAA,YAAY,SAAS;EACnB,SAAS;EACT,GAAG;EACJ,CAAC;CAEJ,MAAM,iBAA4C;EAChD,GAAG;EACH;EACA;EACD;CACD,MAAM,mBAAA,GAAA,4BAAA,QAAyB,KAAK,UAAU,eAAe,CAAC;AAG9D,QAAO,GAAG,mBAAmB,GAAG"}

package/dist/index.d.cts

@@ -1,18 +1,17 @@
-import { a as InlineTranslationOptions } from "./options-BFACoMQ2.cjs";
-import { a as SyncResolutionFunctionWithFallback } from "./functions-8ooUv8Yo.cjs";
-import { n as gtFallback, t as mFallback } from "./index-Bdz9PAYJ.cjs";
+import { a as InlineTranslationOptions } from "./options-BOz9P0yM.cjs";
+import { n as gtFallback, t as mFallback } from "./index-DJVRTYiP.cjs";
 import { t as RegisterableMessages } from "./message-C62MTLwE.cjs";
-import * as _$generaltranslation_types0 from "generaltranslation/types";
+import { a as getLocales, i as getLocaleProperties, n as getDefaultLocale, r as getLocale, t as getVersionId } from "./index-jpLs__jj.cjs";
 import { declareStatic, declareVar, decodeVars, derive } from "generaltranslation/internal";
 
 //#region src/translation-functions/t.d.ts
 /**
  * Translate a message
  * @param {string} message - The message to translate.
- * @param {InlineTranslationOptions} options - The options for the translation.
+ * @param options - The options for the translation.
  * @returns The translated message.
  */
-declare const t: SyncResolutionFunctionWithFallback;
+declare function t(message: string, options?: InlineTranslationOptions): string;
 //#endregion
 //#region src/translation-functions/msg/msg.d.ts
 /**
@@ -72,57 +71,5 @@ declare function decodeMsg<T extends string | null | undefined>(encodedMsg: T):
  */
 declare function decodeOptions(encodedMsg: string): InlineTranslationOptions | null;
 //#endregion
-//#region src/helpers/locale.d.ts
-/**
- * Get the current locale
- * @returns The current locale
- *
- * @example
- * const locale = getLocale();
- * console.log(locale); // 'en-US'
- */
-declare function getLocale(): string;
-/**
- * Get the current locales
- * @returns The current locales
- *
- * @example
- * const locales = getLocales();
- * console.log(locales); // ['en-US', 'es-ES']
- */
-declare function getLocales(): string[];
-/**
- * Get the default locale
- * @returns The default locale
- *
- * @example
- * const defaultLocale = getDefaultLocale();
- * console.log(defaultLocale); // 'en-US'
- */
-declare function getDefaultLocale(): string;
-/**
- * Get the locale properties
- * @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.
- * @returns The locale properties
- *
- * @example
- * const localeProperties = getLocaleProperties();
- *
- * @example
- * const localeProperties = getLocaleProperties('en-US');
- */
-declare function getLocaleProperties(locale?: string): _$generaltranslation_types0.LocaleProperties;
-//#endregion
-//#region src/helpers/versionId.d.ts
-/**
- * Get the version ID for the current source
- * @returns The version ID, if set
- *
- * @example
- * const versionId = getVersionId();
- * console.log(versionId); // 'abc123'
- */
-declare function getVersionId(): string | undefined;
-//#endregion
 export { declareStatic, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getLocale, getLocaleProperties, getLocales, getVersionId, gtFallback, mFallback, msg, t };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,18 +1,17 @@
-import { a as InlineTranslationOptions } from "./options-B-yFI8LM.mjs";
-import { a as SyncResolutionFunctionWithFallback } from "./functions-CPODsB3C.mjs";
-import { n as gtFallback, t as mFallback } from "./index-DdPo_-bU.mjs";
+import { a as InlineTranslationOptions } from "./options-gL1Zt8jG.mjs";
+import { n as gtFallback, t as mFallback } from "./index-YDEznmyZ.mjs";
 import { t as RegisterableMessages } from "./message-BN4DirTg.mjs";
+import { a as getLocales, i as getLocaleProperties, n as getDefaultLocale, r as getLocale, t as getVersionId } from "./index-DUcoQ9y0.mjs";
 import { declareStatic, declareVar, decodeVars, derive } from "generaltranslation/internal";
-import * as _$generaltranslation_types0 from "generaltranslation/types";
 
 //#region src/translation-functions/t.d.ts
 /**
  * Translate a message
  * @param {string} message - The message to translate.
- * @param {InlineTranslationOptions} options - The options for the translation.
+ * @param options - The options for the translation.
  * @returns The translated message.
  */
-declare const t: SyncResolutionFunctionWithFallback;
+declare function t(message: string, options?: InlineTranslationOptions): string;
 //#endregion
 //#region src/translation-functions/msg/msg.d.ts
 /**
@@ -72,57 +71,5 @@ declare function decodeMsg<T extends string | null | undefined>(encodedMsg: T):
  */
 declare function decodeOptions(encodedMsg: string): InlineTranslationOptions | null;
 //#endregion
-//#region src/helpers/locale.d.ts
-/**
- * Get the current locale
- * @returns The current locale
- *
- * @example
- * const locale = getLocale();
- * console.log(locale); // 'en-US'
- */
-declare function getLocale(): string;
-/**
- * Get the current locales
- * @returns The current locales
- *
- * @example
- * const locales = getLocales();
- * console.log(locales); // ['en-US', 'es-ES']
- */
-declare function getLocales(): string[];
-/**
- * Get the default locale
- * @returns The default locale
- *
- * @example
- * const defaultLocale = getDefaultLocale();
- * console.log(defaultLocale); // 'en-US'
- */
-declare function getDefaultLocale(): string;
-/**
- * Get the locale properties
- * @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.
- * @returns The locale properties
- *
- * @example
- * const localeProperties = getLocaleProperties();
- *
- * @example
- * const localeProperties = getLocaleProperties('en-US');
- */
-declare function getLocaleProperties(locale?: string): _$generaltranslation_types0.LocaleProperties;
-//#endregion
-//#region src/helpers/versionId.d.ts
-/**
- * Get the version ID for the current source
- * @returns The version ID, if set
- *
- * @example
- * const versionId = getVersionId();
- * console.log(versionId); // 'abc123'
- */
-declare function getVersionId(): string | undefined;
-//#endregion
 export { declareStatic, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getLocale, getLocaleProperties, getLocales, getVersionId, gtFallback, mFallback, msg, t };
 //# sourceMappingURL=index.d.mts.map

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 { a as resolveStringContentWithFallback, c as getI18nManager, d as hashMessage } from "./helpers-DB3t35tn.mjs";
+import { a as getLocales, d as resolveStringContentWithFallback, i as getLocaleProperties, m as getCurrentLocale, n as getDefaultLocale, r as getLocale, t as getVersionId, y as hashMessage } from "./versionId-ahkgeth1.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";
@@ -7,15 +7,15 @@ import { formatMessage } from "generaltranslation/core";
 /**
 * Translate a message
 * @param {string} message - The message to translate.
-* @param {InlineTranslationOptions} options - The options for the translation.
+* @param options - The options for the translation.
 * @returns The translated message.
 */
-const t = (message, options) => {
-	return resolveStringContentWithFallback(message, {
+function t(message, options = {}) {
+	return resolveStringContentWithFallback(options.$locale ?? getCurrentLocale(), message, {
 		$format: "ICU",
 		...options
 	});
-};
+}
 //#endregion
 //#region src/translation-functions/msg/msg.ts
 function msg(message, options) {
@@ -55,68 +55,6 @@ function msg(message, options) {
 	return `${interpolatedString}:${optionsEncoding}`;
 }
 //#endregion
-//#region src/helpers/locale.ts
-/**
-* Get the current locale
-* @returns The current locale
-*
-* @example
-* const locale = getLocale();
-* console.log(locale); // 'en-US'
-*/
-function getLocale() {
-	return getI18nManager().getLocale();
-}
-/**
-* Get the current locales
-* @returns The current locales
-*
-* @example
-* const locales = getLocales();
-* console.log(locales); // ['en-US', 'es-ES']
-*/
-function getLocales() {
-	return getI18nManager().getLocales();
-}
-/**
-* Get the default locale
-* @returns The default locale
-*
-* @example
-* const defaultLocale = getDefaultLocale();
-* console.log(defaultLocale); // 'en-US'
-*/
-function getDefaultLocale() {
-	return getI18nManager().getDefaultLocale();
-}
-/**
-* Get the locale properties
-* @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.
-* @returns The locale properties
-*
-* @example
-* const localeProperties = getLocaleProperties();
-*
-* @example
-* const localeProperties = getLocaleProperties('en-US');
-*/
-function getLocaleProperties(locale) {
-	return getI18nManager().getGTClass().getLocaleProperties(locale);
-}
-//#endregion
-//#region src/helpers/versionId.ts
-/**
-* Get the version ID for the current source
-* @returns The version ID, if set
-*
-* @example
-* const versionId = getVersionId();
-* console.log(versionId); // 'abc123'
-*/
-function getVersionId() {
-	return getI18nManager().getVersionId();
-}
-//#endregion
 export { declareStatic, declareVar, decodeMsg, decodeOptions, decodeVars, derive, getDefaultLocale, getLocale, getLocaleProperties, getLocales, getVersionId, gtFallback, mFallback, msg, t };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/translation-functions/t.ts","../src/translation-functions/msg/msg.ts","../src/helpers/locale.ts","../src/helpers/versionId.ts"],"sourcesContent":["import { resolveStringContentWithFallback } from './internal/helpers';\nimport { SyncResolutionFunctionWithFallback } from './types/functions';\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 The translated message.\n */\nexport const t: SyncResolutionFunctionWithFallback = (message, options) => {\n  return resolveStringContentWithFallback(message, {\n    $format: 'ICU',\n    ...options,\n  });\n};\n","import type {\n  EncodedTranslationOptions,\n  InlineTranslationOptions,\n} from '../types/options';\nimport { formatMessage } from 'generaltranslation/core';\nimport {\n  encode,\n  libraryDefaultLocale,\n  VAR_IDENTIFIER,\n} from 'generaltranslation/internal';\nimport { createInterpolationFailureMessage } from '../utils/messages';\nimport logger from '../../logs/logger';\nimport { extractVariables } from '../../utils/extractVariables';\nimport { hashMessage } from '../../utils/hashMessage';\nimport { RegisterableMessages } from '../types/message';\n\n/**\n * Registers a message to be translated. Returns the message unchanged if no options are provided.\n * @param {string | string[]} message The message to encode.\n * @param {InlineTranslationOptions} [options] The options to encode.\n * @returns The message or array of messages.\n *\n * @note - This function registers the message before the build process. The actual translation does not\n * occur until the m() function is invoked.\n *\n * @note - Message format\n * A message is broken into two parts separated by colons:\n * - interpolated content - the content with interpolated variables\n * - hash + options - a unique identifier for the source content and options for the translation\n *\n * @example - Basic usage\n *\n * const message1 = msg('Hello, World!');\n * console.log(message1); // \"Hello, World!\"\n *\n * const message2 = msg('Hello, {name}!', { name: 'Brian' });\n * console.log(message2); // \"Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9\"\n *\n * @example - Array usage\n *\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!']);\n * console.log(messages); // [\"Hello, Alice!\", \"Hello, Bob!\"]\n *\n * @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });\n * // \"Hello, Alice!\" id: \"greetings.0\"\n * // \"Hello, Bob!\" id: \"greetings.1\"\n *\n * @important Internal note: until other packages are updated to use i18n-context practices, msg cannot use any functions that use i18nManager at all!\n */\nexport function msg<T extends RegisterableMessages = string>(message: T): T;\nexport function msg<T extends RegisterableMessages = string>(\n  message: T,\n  options?: InlineTranslationOptions\n): T extends string ? string : string[];\nexport function msg(\n  message: RegisterableMessages,\n  options?: InlineTranslationOptions\n): RegisterableMessages {\n  // Handle array\n  if (typeof message !== 'string') {\n    if (!options) return message;\n    return message.map((m, i) =>\n      msg(m, {\n        ...options,\n        // ignore if $id is an empty string or not defined\n        ...(options.$id && { $id: `${options.$id}.${i}` }),\n      })\n    );\n  }\n\n  if (!options) {\n    return message;\n  }\n\n  // Extract variables\n  const variables = extractVariables(options);\n\n  // Interpolate string\n  let interpolatedString: string = message;\n  try {\n    interpolatedString = formatMessage(message, {\n      locales: [libraryDefaultLocale], // TODO: use compiler to insert locales\n      variables: {\n        ...variables,\n        [VAR_IDENTIFIER]: 'other',\n      },\n    });\n  } catch {\n    logger.warn(createInterpolationFailureMessage(message));\n    return message;\n  }\n\n  // Encode options\n  const $_source = message;\n  const $_hash =\n    options.$_hash ||\n    hashMessage(message, {\n      $format: 'ICU',\n      ...options,\n    });\n\n  const encodedOptions: EncodedTranslationOptions = {\n    ...options,\n    $_source,\n    $_hash,\n  };\n  const optionsEncoding = encode(JSON.stringify(encodedOptions));\n\n  // Construct result\n  return `${interpolatedString}:${optionsEncoding}`;\n}\n","import { getI18nManager } from '../i18n-manager/singleton-operations';\n\n/**\n * Get the current locale\n * @returns The current locale\n *\n * @example\n * const locale = getLocale();\n * console.log(locale); // 'en-US'\n */\nexport function getLocale() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getLocale();\n}\n\n/**\n * Get the current locales\n * @returns The current locales\n *\n * @example\n * const locales = getLocales();\n * console.log(locales); // ['en-US', 'es-ES']\n */\nexport function getLocales() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getLocales();\n}\n\n/**\n * Get the default locale\n * @returns The default locale\n *\n * @example\n * const defaultLocale = getDefaultLocale();\n * console.log(defaultLocale); // 'en-US'\n */\nexport function getDefaultLocale() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getDefaultLocale();\n}\n\n/**\n * Get the locale properties\n * @param {string} [locale] - The locale to get the properties for. When not provided, uses the current locale.\n * @returns The locale properties\n *\n * @example\n * const localeProperties = getLocaleProperties();\n *\n * @example\n * const localeProperties = getLocaleProperties('en-US');\n */\nexport function getLocaleProperties(locale?: string) {\n  const i18nManager = getI18nManager();\n  const gtInstance = i18nManager.getGTClass();\n  return gtInstance.getLocaleProperties(locale);\n}\n","import { getI18nManager } from '../i18n-manager/singleton-operations';\n\n/**\n * Get the version ID for the current source\n * @returns The version ID, if set\n *\n * @example\n * const versionId = getVersionId();\n * console.log(versionId); // 'abc123'\n */\nexport function getVersionId() {\n  const i18nManager = getI18nManager();\n  return i18nManager.getVersionId();\n}\n"],"mappings":";;;;;;;;;;;;AASA,MAAa,KAAyC,SAAS,YAAY;AACzE,QAAO,iCAAiC,SAAS;EAC/C,SAAS;EACT,GAAG;EACJ,CAAC;;;;AC0CJ,SAAgB,IACd,SACA,SACsB;AAEtB,KAAI,OAAO,YAAY,UAAU;AAC/B,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,QAAQ,KAAK,GAAG,MACrB,IAAI,GAAG;GACL,GAAG;GAEH,GAAI,QAAQ,OAAO,EAAE,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK;GAClD,CAAC,CACH;;AAGH,KAAI,CAAC,QACH,QAAO;CAIT,MAAM,YAAY,iBAAiB,QAAQ;CAG3C,IAAI,qBAA6B;AACjC,KAAI;AACF,uBAAqB,cAAc,SAAS;GAC1C,SAAS,CAAC,qBAAqB;GAC/B,WAAW;IACT,GAAG;KACF,iBAAiB;IACnB;GACF,CAAC;SACI;AACN,iBAAO,KAAK,kCAAkC,QAAQ,CAAC;AACvD,SAAO;;CAIT,MAAM,WAAW;CACjB,MAAM,SACJ,QAAQ,UACR,YAAY,SAAS;EACnB,SAAS;EACT,GAAG;EACJ,CAAC;CAEJ,MAAM,iBAA4C;EAChD,GAAG;EACH;EACA;EACD;CACD,MAAM,kBAAkB,OAAO,KAAK,UAAU,eAAe,CAAC;AAG9D,QAAO,GAAG,mBAAmB,GAAG;;;;;;;;;;;;ACpGlC,SAAgB,YAAY;AAE1B,QADoB,gBACF,CAAC,WAAW;;;;;;;;;;AAWhC,SAAgB,aAAa;AAE3B,QADoB,gBACF,CAAC,YAAY;;;;;;;;;;AAWjC,SAAgB,mBAAmB;AAEjC,QADoB,gBACF,CAAC,kBAAkB;;;;;;;;;;;;;AAcvC,SAAgB,oBAAoB,QAAiB;AAGnD,QAFoB,gBACU,CAAC,YACd,CAAC,oBAAoB,OAAO;;;;;;;;;;;;AC7C/C,SAAgB,eAAe;AAE7B,QADoB,gBACF,CAAC,cAAc"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/translation-functions/t.ts","../src/translation-functions/msg/msg.ts"],"sourcesContent":["import { resolveStringContentWithFallback } from './internal/helpers';\nimport { InlineTranslationOptions } from './types/options';\nimport { getCurrentLocale } from '../i18n-manager/singleton-operations';\n\n/**\n * Translate a message\n * @param {string} message - The message to translate.\n * @param options - The options for the translation.\n * @returns The translated message.\n */\nexport function t(message: string, options: InlineTranslationOptions = {}) {\n  const locale = options.$locale ?? getCurrentLocale();\n  return resolveStringContentWithFallback(locale, message, {\n    $format: 'ICU',\n    ...options,\n  });\n}\n","import type {\n  EncodedTranslationOptions,\n  InlineTranslationOptions,\n} from '../types/options';\nimport { formatMessage } from 'generaltranslation/core';\nimport {\n  encode,\n  libraryDefaultLocale,\n  VAR_IDENTIFIER,\n} from 'generaltranslation/internal';\nimport { createInterpolationFailureMessage } from '../utils/messages';\nimport logger from '../../logs/logger';\nimport { extractVariables } from '../../utils/extractVariables';\nimport { hashMessage } from '../../utils/hashMessage';\nimport { RegisterableMessages } from '../types/message';\n\n/**\n * Registers a message to be translated. Returns the message unchanged if no options are provided.\n * @param {string | string[]} message The message to encode.\n * @param {InlineTranslationOptions} [options] The options to encode.\n * @returns The message or array of messages.\n *\n * @note - This function registers the message before the build process. The actual translation does not\n * occur until the m() function is invoked.\n *\n * @note - Message format\n * A message is broken into two parts separated by colons:\n * - interpolated content - the content with interpolated variables\n * - hash + options - a unique identifier for the source content and options for the translation\n *\n * @example - Basic usage\n *\n * const message1 = msg('Hello, World!');\n * console.log(message1); // \"Hello, World!\"\n *\n * const message2 = msg('Hello, {name}!', { name: 'Brian' });\n * console.log(message2); // \"Hello, Brian:eyIkX2hhc2giOiAiMHgxMjMiLCAiJF9zb3VyY2UiOiAiSGVsbG8sIHtuYW1lfSEiLCAibmFtZSI6ICJCcmlhbiJ9\"\n *\n * @example - Array usage\n *\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!']);\n * console.log(messages); // [\"Hello, Alice!\", \"Hello, Bob!\"]\n *\n * @example - When specifying an id for an array, each message will have a unique id of `${id}.${index}`\n * const messages = msg(['Hello, Alice!', 'Hello, Bob!'], { $id: 'greetings' });\n * // \"Hello, Alice!\" id: \"greetings.0\"\n * // \"Hello, Bob!\" id: \"greetings.1\"\n *\n * @important Internal note: until other packages are updated to use i18n-context practices, msg cannot use any functions that use i18nManager at all!\n */\nexport function msg<T extends RegisterableMessages = string>(message: T): T;\nexport function msg<T extends RegisterableMessages = string>(\n  message: T,\n  options?: InlineTranslationOptions\n): T extends string ? string : string[];\nexport function msg(\n  message: RegisterableMessages,\n  options?: InlineTranslationOptions\n): RegisterableMessages {\n  // Handle array\n  if (typeof message !== 'string') {\n    if (!options) return message;\n    return message.map((m, i) =>\n      msg(m, {\n        ...options,\n        // ignore if $id is an empty string or not defined\n        ...(options.$id && { $id: `${options.$id}.${i}` }),\n      })\n    );\n  }\n\n  if (!options) {\n    return message;\n  }\n\n  // Extract variables\n  const variables = extractVariables(options);\n\n  // Interpolate string\n  let interpolatedString: string = message;\n  try {\n    interpolatedString = formatMessage(message, {\n      locales: [libraryDefaultLocale], // TODO: use compiler to insert locales\n      variables: {\n        ...variables,\n        [VAR_IDENTIFIER]: 'other',\n      },\n    });\n  } catch {\n    logger.warn(createInterpolationFailureMessage(message));\n    return message;\n  }\n\n  // Encode options\n  const $_source = message;\n  const $_hash =\n    options.$_hash ||\n    hashMessage(message, {\n      $format: 'ICU',\n      ...options,\n    });\n\n  const encodedOptions: EncodedTranslationOptions = {\n    ...options,\n    $_source,\n    $_hash,\n  };\n  const optionsEncoding = encode(JSON.stringify(encodedOptions));\n\n  // Construct result\n  return `${interpolatedString}:${optionsEncoding}`;\n}\n"],"mappings":";;;;;;;;;;;;AAUA,SAAgB,EAAE,SAAiB,UAAoC,EAAE,EAAE;AAEzE,QAAO,iCADQ,QAAQ,WAAW,kBAAkB,EACJ,SAAS;EACvD,SAAS;EACT,GAAG;EACJ,CAAC;;;;ACwCJ,SAAgB,IACd,SACA,SACsB;AAEtB,KAAI,OAAO,YAAY,UAAU;AAC/B,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,QAAQ,KAAK,GAAG,MACrB,IAAI,GAAG;GACL,GAAG;GAEH,GAAI,QAAQ,OAAO,EAAE,KAAK,GAAG,QAAQ,IAAI,GAAG,KAAK;GAClD,CAAC,CACH;;AAGH,KAAI,CAAC,QACH,QAAO;CAIT,MAAM,YAAY,iBAAiB,QAAQ;CAG3C,IAAI,qBAA6B;AACjC,KAAI;AACF,uBAAqB,cAAc,SAAS;GAC1C,SAAS,CAAC,qBAAqB;GAC/B,WAAW;IACT,GAAG;KACF,iBAAiB;IACnB;GACF,CAAC;SACI;AACN,iBAAO,KAAK,kCAAkC,QAAQ,CAAC;AACvD,SAAO;;CAIT,MAAM,WAAW;CACjB,MAAM,SACJ,QAAQ,UACR,YAAY,SAAS;EACnB,SAAS;EACT,GAAG;EACJ,CAAC;CAEJ,MAAM,iBAA4C;EAChD,GAAG;EACH;EACA;EACD;CACD,MAAM,kBAAkB,OAAO,KAAK,UAAU,eAAe,CAAC;AAG9D,QAAO,GAAG,mBAAmB,GAAG"}