generaltranslation 8.2.13 → 8.2.15

package/dist/index.mjs

@@ -1,20 +1,269 @@
-import { n as defaultTimeout, t as intlCache } from "./IntlCache-WZk0rKvj.mjs";
-import { A as _standardizeLocale, C as _getLocaleEmoji, D as _isSameLanguage, E as _requiresTranslation, O as _isSameDialect, S as _getLocaleProperties, T as getRegionEmoji, _ as _formatRelativeTime, a as standardizeLocale, b as gtInstanceLogger, c as _resolveAliasLocale, d as _getLocaleName, f as _formatCurrency, g as _formatNum, h as _formatListToParts, i as resolveCanonicalLocale, k as _isValidLocale, l as _isSupersetLocale, m as _formatList, n as formatMessage, o as LocaleConfig, p as _formatDateTime, r as isValidLocale, s as _resolveCanonicalLocale, t as formatCutoff, u as _getLocaleDirection, v as _formatRelativeTimeFromDate, w as defaultEmoji, x as _determineLocale, y as fetchLogger } from "./core-isLphYAZ.mjs";
-import { n as encode, r as validateFileFormatTransforms, t as decode } from "./base64-DH0STixb.mjs";
-import { t as ApiError } from "./ApiError-IYfaOR30.mjs";
-import { n as hashSource } from "./id-DbD7K-HL.mjs";
+import { c as createDiagnosticMessage, n as encode, r as validateFileFormatTransforms, t as decode, u as defaultTimeout } from "./base64-r7YWJYWt.mjs";
+import { t as ApiError } from "./ApiError-0DxxIHLp.mjs";
+import { n as hashSource } from "./id-DEaFhGqX.mjs";
+import { LocaleConfig, LocaleConfig as LocaleConfig$1, determineLocale, determineLocale as determineLocale$1, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, getRegionProperties as getRegionProperties$1, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, isValidLocale as isValidLocale$1, requiresTranslation, requiresTranslation as requiresTranslation$1, resolveAliasLocale, resolveAliasLocale as resolveAliasLocale$1, resolveCanonicalLocale, resolveCanonicalLocale as resolveCanonicalLocale$1, standardizeLocale, standardizeLocale as standardizeLocale$1 } from "@generaltranslation/format";
 //#region src/logging/errors.ts
-const GT_ERROR_PREFIX = "GT Error:";
-const translationTimeoutError = (timeout) => `${GT_ERROR_PREFIX} Translation request timed out after ${timeout}ms.`;
-const translationRequestFailedError = (error) => `${GT_ERROR_PREFIX} Translation request failed. Error: ${error}`;
-const apiError = (status, statusText, error) => `${GT_ERROR_PREFIX} API returned error status. Status: ${status}, Status Text: ${statusText}, Error: ${error}`;
-`${GT_ERROR_PREFIX}`;
-const noTargetLocaleProvidedError = (functionName) => `${GT_ERROR_PREFIX} Cannot call \`${functionName}\` without a specified locale. Either pass a locale to the \`${functionName}\` function or specify a targetLocale in the GT constructor.`;
-const noSourceLocaleProvidedError = (functionName) => `${GT_ERROR_PREFIX} Cannot call \`${functionName}\` without a specified locale. Either pass a locale to the \`${functionName}\` function or specify a sourceLocale in the GT constructor.`;
-const noProjectIdProvidedError = (functionName) => `${GT_ERROR_PREFIX} Cannot call \`${functionName}\` without a specified project ID. Either pass a project ID to the \`${functionName}\` function or specify a projectId in the GT constructor.`;
-const noApiKeyProvidedError = (functionName) => `${GT_ERROR_PREFIX} Cannot call \`${functionName}\` without a specified API key. Either pass an API key to the \`${functionName}\` function or specify an apiKey in the GT constructor.`;
-const invalidLocaleError = (locale) => `${GT_ERROR_PREFIX} Invalid locale: ${locale}.`;
-const invalidLocalesError = (locales) => `${GT_ERROR_PREFIX} Invalid locales: ${locales.join(", ")}.`;
+const GT_SOURCE = "GT";
+const translationTimeoutError = (timeout) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Translation request timed out after ${timeout}ms`,
+	fix: "Try again, or increase the request timeout if the source content is large"
+});
+const translationRequestFailedError = (error) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: "Translation request could not be completed",
+	fix: "Check your network connection and translation credentials, then try again",
+	details: error
+});
+const apiError = (status, statusText, error) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `The translation API returned ${status} ${statusText}`,
+	fix: "Check the request configuration and try again",
+	details: error
+});
+createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: "Authentication failed",
+	fix: "Check that your API key and project ID are correct"
+});
+const noTargetLocaleProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified locale`,
+	fix: `Pass a locale to \`${functionName}\` or specify targetLocale in the GT constructor`
+});
+const noSourceLocaleProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified locale`,
+	fix: `Pass a locale to \`${functionName}\` or specify sourceLocale in the GT constructor`
+});
+const noProjectIdProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified project ID`,
+	fix: `Pass a project ID to \`${functionName}\` or specify projectId in the GT constructor`
+});
+const noApiKeyProvidedError = (functionName) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Cannot call \`${functionName}\` without a specified API key`,
+	fix: `Pass an API key to \`${functionName}\` or specify apiKey in the GT constructor`
+});
+const invalidLocaleError = (locale) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `Locale "${locale}" is not valid`,
+	fix: "Use a valid BCP 47 locale code or add a custom mapping"
+});
+const invalidLocalesError = (locales) => createDiagnosticMessage({
+	source: GT_SOURCE,
+	severity: "Error",
+	whatHappened: `These locales are not valid: ${locales.join(", ")}`,
+	fix: "Use valid BCP 47 locale codes or add custom mappings"
+});
+//#endregion
+//#region src/logging/logger.ts
+const LOG_LEVELS = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3,
+	off: 4
+};
+const LOG_COLORS = {
+	debug: "\x1B[36m",
+	info: "\x1B[32m",
+	warn: "\x1B[33m",
+	error: "\x1B[31m",
+	off: ""
+};
+const RESET_COLOR = "\x1B[0m";
+/**
+* Get the configured log level from environment variable or default to 'warn'
+*/
+function getConfiguredLogLevel() {
+	if (typeof process !== "undefined" && process.env?._GT_LOG_LEVEL) {
+		const envLevel = process.env._GT_LOG_LEVEL.toLowerCase();
+		if (envLevel in LOG_LEVELS) return envLevel;
+	}
+	return "warn";
+}
+/**
+* Console log handler that outputs formatted messages to console
+*/
+var ConsoleLogHandler = class {
+	constructor(config) {
+		this.config = config;
+	}
+	handle(entry) {
+		const parts = [];
+		if (this.config.includeTimestamp) parts.push(`[${entry.timestamp.toISOString()}]`);
+		const colorCode = LOG_COLORS[entry.level];
+		const levelText = `[${entry.level.toUpperCase()}]`;
+		parts.push(`${colorCode}${levelText}${RESET_COLOR}`);
+		if (this.config.prefix) parts.push(`[${this.config.prefix}]`);
+		if (this.config.includeContext && entry.context) parts.push(`[${entry.context}]`);
+		parts.push(entry.message);
+		if (entry.metadata && Object.keys(entry.metadata).length > 0) parts.push(`\n  Metadata: ${JSON.stringify(entry.metadata, null, 2)}`);
+		const formattedMessage = parts.join(" ");
+		switch (entry.level) {
+			case "debug":
+				console.debug(formattedMessage);
+				break;
+			case "info":
+				console.info(formattedMessage);
+				break;
+			case "warn":
+				console.warn(formattedMessage);
+				break;
+			case "error":
+				console.error(formattedMessage);
+				break;
+		}
+	}
+};
+/**
+* Main Logger class providing structured logging capabilities.
+*/
+var Logger = class {
+	constructor(config = {}) {
+		this.config = {
+			level: getConfiguredLogLevel(),
+			includeTimestamp: true,
+			includeContext: true,
+			enableConsole: true,
+			handlers: [],
+			...config
+		};
+		this.handlers = [...this.config.handlers || []];
+		if (this.config.enableConsole) this.handlers.push(new ConsoleLogHandler(this.config));
+	}
+	/**
+	* Add a custom log handler
+	*/
+	addHandler(handler) {
+		this.handlers.push(handler);
+	}
+	/**
+	* Remove a log handler
+	*/
+	removeHandler(handler) {
+		const index = this.handlers.indexOf(handler);
+		if (index > -1) this.handlers.splice(index, 1);
+	}
+	/**
+	* Update logger configuration
+	*/
+	configure(config) {
+		this.config = {
+			...this.config,
+			...config
+		};
+	}
+	/**
+	* Check if a log level should be output based on current configuration
+	*/
+	shouldLog(level) {
+		return LOG_LEVELS[level] >= LOG_LEVELS[this.config.level];
+	}
+	/**
+	* Internal logging method that creates log entries and passes them to handlers
+	*/
+	log(level, message, context, metadata) {
+		if (!this.shouldLog(level)) return;
+		const entry = {
+			level,
+			message,
+			timestamp: /* @__PURE__ */ new Date(),
+			context,
+			metadata
+		};
+		this.handlers.forEach((handler) => {
+			try {
+				handler.handle(entry);
+			} catch (error) {
+				console.error("Error in log handler:", error);
+			}
+		});
+	}
+	/**
+	* Log a debug message
+	* Used for detailed diagnostic information, typically of interest only when diagnosing problems
+	*/
+	debug(message, context, metadata) {
+		this.log("debug", message, context, metadata);
+	}
+	/**
+	* Log an info message
+	* Used for general information about application operation.
+	*/
+	info(message, context, metadata) {
+		this.log("info", message, context, metadata);
+	}
+	/**
+	* Log a warning message
+	* Used for potentially problematic situations that don't prevent operation
+	*/
+	warn(message, context, metadata) {
+		this.log("warn", message, context, metadata);
+	}
+	/**
+	* Log an error message
+	* Used for error events that might still allow the application to continue.
+	*/
+	error(message, context, metadata) {
+		this.log("error", message, context, metadata);
+	}
+	/**
+	* Create a child logger with a specific context
+	*/
+	child(context) {
+		return new ContextLogger(this, context);
+	}
+	/**
+	* Get current logger configuration
+	*/
+	getConfig() {
+		return { ...this.config };
+	}
+};
+/**
+* Context logger that automatically includes context information.
+*/
+var ContextLogger = class ContextLogger {
+	constructor(logger, context) {
+		this.logger = logger;
+		this.context = context;
+	}
+	debug(message, metadata) {
+		this.logger.debug(message, this.context, metadata);
+	}
+	info(message, metadata) {
+		this.logger.info(message, this.context, metadata);
+	}
+	warn(message, metadata) {
+		this.logger.warn(message, this.context, metadata);
+	}
+	error(message, metadata) {
+		this.logger.error(message, this.context, metadata);
+	}
+	child(childContext) {
+		return new ContextLogger(this.logger, `${this.context}:${childContext}`);
+	}
+};
+const defaultLogger = new Logger({
+	level: getConfiguredLogLevel(),
+	includeTimestamp: true,
+	includeContext: true,
+	prefix: "GT"
+});
+const fetchLogger = defaultLogger.child("fetch");
+const gtInstanceLogger = defaultLogger.child("GT instance");
 //#endregion
 //#region src/translate/utils/fetchWithTimeout.ts
 /**
@@ -360,61 +609,6 @@ async function _submitUserEditDiffs(payload, config, options = {}) {
 	return { success: true };
 }
 //#endregion
-//#region src/locales/getRegionProperties.ts
-/**
-* Retrieves multiple properties for a given region code, including:
-* - `code`: the original region code
-* - `name`: the localized display name
-* - `emoji`: the associated flag or symbol
-*
-* Behavior:
-* - Accepts ISO 3166-1 alpha-2 or UN M.49 region codes (e.g., `"US"`, `"FR"`, `"419"`).
-* - If `customMapping` contains a `name` or `emoji` for the region, those override the default values.
-* - Otherwise, uses `Intl.DisplayNames` to get the localized region name in the given `defaultLocale`,
-*   falling back to `libraryDefaultLocale`.
-* - Falls back to the region code as `name` if display name resolution fails.
-* - Falls back to `defaultEmoji` if no emoji can be computed or found in `customMapping`.
-*
-* @param {string} region - The region code to look up (e.g., `"US"`, `"GB"`, `"DE"`).
-* @param {string} [defaultLocale=libraryDefaultLocale] - The locale to use when localizing the region name.
-* @param {CustomRegionMapping} [customMapping] - Optional mapping of region codes to custom names and/or emojis.
-* @returns {{ code: string, name: string, emoji: string }} An object containing:
-*  - `code`: the input region code
-*  - `name`: the localized or custom region name
-*  - `emoji`: the matching emoji flag or symbol
-* @internal
-*
-* @example
-* _getRegionProperties('US', 'en');
-* // => { code: 'US', name: 'United States', emoji: '🇺🇸' }
-*
-* @example
-* _getRegionProperties('US', 'fr');
-* // => { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }
-*
-* @example
-* _getRegionProperties('US', 'en', { US: { name: 'USA', emoji: '🗽' } });
-* // => { code: 'US', name: 'USA', emoji: '🗽' }
-*/
-function _getRegionProperties(region, defaultLocale = "en", customMapping) {
-	defaultLocale ||= "en";
-	try {
-		return {
-			code: region,
-			name: intlCache.get("DisplayNames", [defaultLocale, "en"], { type: "region" }).of(region) || region,
-			emoji: getRegionEmoji(region),
-			...customMapping?.[region]
-		};
-	} catch {
-		return {
-			code: region,
-			name: region,
-			emoji: defaultEmoji,
-			...customMapping?.[region]
-		};
-	}
-}
-//#endregion
 //#region src/translate/uploadSourceFiles.ts
 /**
 * @internal
@@ -790,19 +984,19 @@ var GT = class {
 		if (devApiKey) this.devApiKey = devApiKey;
 		if (projectId) this.projectId = projectId;
 		if (sourceLocale) {
-			this.sourceLocale = _standardizeLocale(sourceLocale);
-			if (!_isValidLocale(this.sourceLocale, customMapping)) throw new Error(invalidLocaleError(this.sourceLocale));
+			this.sourceLocale = standardizeLocale$1(sourceLocale);
+			if (!isValidLocale$1(this.sourceLocale, customMapping)) throw new Error(invalidLocaleError(this.sourceLocale));
 		}
 		if (targetLocale) {
-			this.targetLocale = _standardizeLocale(targetLocale);
-			if (!_isValidLocale(this.targetLocale, customMapping)) throw new Error(invalidLocaleError(this.targetLocale));
+			this.targetLocale = standardizeLocale$1(targetLocale);
+			if (!isValidLocale$1(this.targetLocale, customMapping)) throw new Error(invalidLocaleError(this.targetLocale));
 		}
 		if (locales) {
 			const result = [];
 			const invalidLocales = [];
 			locales.forEach((locale) => {
-				const standardizedLocale = _standardizeLocale(locale);
-				if (_isValidLocale(standardizedLocale)) result.push(standardizedLocale);
+				const standardizedLocale = standardizeLocale$1(locale);
+				if (isValidLocale$1(standardizedLocale)) result.push(standardizedLocale);
 				else invalidLocales.push(locale);
 			});
 			if (invalidLocales.length > 0) throw new Error(invalidLocalesError(invalidLocales));
@@ -813,7 +1007,7 @@ var GT = class {
 			this.customMapping = customMapping;
 			this.reverseCustomMapping = Object.fromEntries(Object.entries(customMapping).filter(([, value]) => value && typeof value === "object" && "code" in value).map(([key, value]) => [value.code, key]));
 		}
-		this._localeConfig = new LocaleConfig({
+		this._localeConfig = new LocaleConfig$1({
 			defaultLocale: this.sourceLocale,
 			locales: this.locales ?? [],
 			customMapping: this.customMapping
@@ -1567,7 +1761,7 @@ var GT = class {
 			}
 			customMapping = this.customRegionMapping;
 		}
-		return _getRegionProperties(region, this.targetLocale, customMapping);
+		return getRegionProperties$1(region, this.targetLocale, customMapping);
 	}
 	/**
 	* Determines whether a translation is required based on the source and target locales.
@@ -1587,7 +1781,7 @@ var GT = class {
 		if (!sourceLocale) throw new Error(noSourceLocaleProvidedError("requiresTranslation"));
 		if (!targetLocale) throw new Error(noTargetLocaleProvidedError("requiresTranslation"));
 		if (customMapping === this.customMapping) return this.localeConfig.requiresTranslation(targetLocale, sourceLocale, approvedLocales);
-		return _requiresTranslation(sourceLocale, targetLocale, approvedLocales, customMapping);
+		return requiresTranslation$1(sourceLocale, targetLocale, approvedLocales, customMapping);
 	}
 	/**
 	* Determines the best matching locale from the provided approved locales list.
@@ -1602,7 +1796,7 @@ var GT = class {
 	*/
 	determineLocale(locales, approvedLocales = this.locales || [], customMapping = this.customMapping) {
 		if (customMapping === this.customMapping) return this.localeConfig.determineLocale(locales, approvedLocales ?? []);
-		return _determineLocale(locales, approvedLocales, customMapping);
+		return determineLocale$1(locales, approvedLocales, customMapping);
 	}
 	/**
 	* Gets the text direction for a given locale code.
@@ -1634,7 +1828,7 @@ var GT = class {
 	isValidLocale(locale = this.targetLocale, customMapping = this.customMapping) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("isValidLocale"));
 		if (customMapping === this.customMapping) return this.localeConfig.isValidLocale(locale);
-		return _isValidLocale(locale, customMapping);
+		return isValidLocale$1(locale, customMapping);
 	}
 	/**
 	* Resolves the canonical locale for a given locale.
@@ -1645,7 +1839,7 @@ var GT = class {
 	resolveCanonicalLocale(locale = this.targetLocale, customMapping = this.customMapping) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("resolveCanonicalLocale"));
 		if (customMapping === this.customMapping) return this.localeConfig.resolveCanonicalLocale(locale);
-		return _resolveCanonicalLocale(locale, customMapping);
+		return resolveCanonicalLocale$1(locale, customMapping);
 	}
 	/**
 	* Resolves the alias locale for a given locale.
@@ -1656,7 +1850,7 @@ var GT = class {
 	resolveAliasLocale(locale, customMapping = this.customMapping) {
 		if (!locale) throw new Error(noTargetLocaleProvidedError("resolveAliasLocale"));
 		if (customMapping === this.customMapping) return this.localeConfig.resolveAliasLocale(locale);
-		return _resolveAliasLocale(locale, customMapping);
+		return resolveAliasLocale$1(locale, customMapping);
 	}
 	/**
 	* Standardizes a BCP 47 locale code to ensure correct formatting.
@@ -1720,285 +1914,6 @@ var GT = class {
 		return this.localeConfig.isSupersetLocale(superLocale, subLocale);
 	}
 };
-/**
-* Formats a number according to the specified locales and options.
-* @param {Object} params - The parameters for the number formatting.
-* @param {number} params.value - The number to format.
-* @param {Intl.NumberFormatOptions} [params.options] - Additional options for number formatting.
-* @param {string | string[]} [params.options.locales] - The locales to use for formatting.
-* @returns {string} The formatted number.
-*/
-function formatNum(number, options) {
-	return _formatNum({
-		value: number,
-		locales: options.locales,
-		options
-	});
-}
-/**
-* Formats a date according to the specified languages and options.
-* @param {Object} params - The parameters for the date formatting.
-* @param {Date} params.value - The date to format.
-* @param {Intl.DateTimeFormatOptions} [params.options] - Additional options for date formatting.
-* @param {string | string[]} [params.options.locales] - The languages to use for formatting.
-* @returns {string} The formatted date.
-*/
-function formatDateTime(date, options) {
-	return _formatDateTime({
-		value: date,
-		locales: options?.locales,
-		options
-	});
-}
-/**
-* Formats a currency value according to the specified languages, currency, and options.
-* @param {Object} params - The parameters for the currency formatting.
-* @param {number} params.value - The currency value to format.
-* @param {string} params.currency - The currency code (e.g., 'USD').
-* @param {Intl.NumberFormatOptions} [params.options={}] - Additional options for currency formatting.
-* @param {string | string[]} [params.options.locales] - The locale codes to use for formatting.
-* @returns {string} The formatted currency value.
-*/
-function formatCurrency(value, currency, options) {
-	return _formatCurrency({
-		value,
-		currency,
-		locales: options.locales,
-		options
-	});
-}
-/**
-* Formats a list of items according to the specified locales and options.
-* @param {Object} params - The parameters for the list formatting.
-* @param {Array<string | number>} params.value - The list of items to format.
-* @param {Intl.ListFormatOptions} [params.options={}] - Additional options for list formatting.
-* @param {string | string[]} [params.options.locales] - The locales to use for formatting.
-* @returns {string} The formatted list.
-*/
-function formatList(array, options) {
-	return _formatList({
-		value: array,
-		locales: options.locales,
-		options
-	});
-}
-/**
-* Formats a list of items according to the specified locales and options.
-* @param {Array<T>} array - The list of items to format.
-* @param {Object} [options] - Additional options for list formatting.
-* @param {string | string[]} [options.locales] - The locales to use for formatting.
-* @param {Intl.ListFormatOptions} [options] - Additional Intl.ListFormat options.
-* @returns {Array<T | string>} The formatted list parts.
-*/
-function formatListToParts(array, options) {
-	return _formatListToParts({
-		value: array,
-		locales: options?.locales,
-		options
-	});
-}
-/**
-* Formats a relative time value according to the specified locales and options.
-* @param {Object} params - The parameters for the relative time formatting.
-* @param {number} params.value - The relative time value to format.
-* @param {Intl.RelativeTimeFormatUnit} params.unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year').
-* @param {Intl.RelativeTimeFormatOptions} [params.options={}] - Additional options for relative time formatting.
-* @param {string | string[]} [params.options.locales] - The locales to use for formatting.
-* @returns {string} The formatted relative time string.
-*/
-function formatRelativeTime(value, unit, options) {
-	return _formatRelativeTime({
-		value,
-		unit,
-		locales: options.locales,
-		options
-	});
-}
-/**
-* Formats a relative time string from a Date, automatically selecting the best unit.
-* @param {Date} date - The date to format relative to now.
-* @param {Object} options - Formatting options.
-* @param {string | string[]} options.locales - The locales to use for formatting.
-* @param {Intl.RelativeTimeFormatOptions} [options] - Additional Intl.RelativeTimeFormat options.
-* @returns {string} The formatted relative time string (e.g., "2 hours ago", "in 3 days").
-*/
-function formatRelativeTimeFromDate(date, options) {
-	const { locales, baseDate, ...intlOptions } = options;
-	return _formatRelativeTimeFromDate({
-		date,
-		baseDate: baseDate ?? /* @__PURE__ */ new Date(),
-		locales,
-		options: intlOptions
-	});
-}
-/**
-* Retrieves the display name of locale code using Intl.DisplayNames.
-*
-* @param {string} locale - A BCP-47 locale code.
-* @param {string} [defaultLocale] - The default locale to use for formatting.
-* @param {CustomMapping} [customMapping] - A custom mapping of locale codes to their names.
-* @returns {string} The display name corresponding to the code.
-*/
-function getLocaleName(locale, defaultLocale, customMapping) {
-	return _getLocaleName(locale, defaultLocale, customMapping);
-}
-/**
-* Retrieves an emoji based on a given locale code, taking into account region, language, and specific exceptions.
-*
-* This function uses the locale's region (if present) to select an emoji or falls back on default emojis for certain languages.
-*
-* @param locale - A string representing the locale code (e.g., 'en-US', 'fr-CA').
-* @param {CustomMapping} [customMapping] - A custom mapping of locale codes to their names.
-* @returns The emoji representing the locale or its region, or a default emoji if no specific match is found.
-*/
-function getLocaleEmoji(locale, customMapping) {
-	return _getLocaleEmoji(locale, customMapping);
-}
-/**
-* Generates linguistic details for a given locale code.
-*
-* This function returns information about the locale,
-* script, and region of a given language code both in a standard form and in a maximized form (with likely script and region).
-* The function provides these names in both your default language and native forms, and an associated emoji.
-*
-* @param {string} locale - The locale code to get properties for (e.g., "de-AT").
-* @param {string} [defaultLocale] - The default locale to use for formatting.
-* @param {CustomMapping} [customMapping] - A custom mapping of locale codes to their names.
-* @returns {LocaleProperties} - An object containing detailed information about the locale.
-*
-* @property {string} code - The full locale code, e.g., "de-AT".
-* @property {string} name - Language name in the default display language, e.g., "Austrian German".
-* @property {string} nativeName - Language name in the locale's native language, e.g., "Österreichisches Deutsch".
-* @property {string} languageCode - The base language code, e.g., "de".
-* @property {string} languageName - The language name in the default display language, e.g., "German".
-* @property {string} nativeLanguageName - The language name in the native language, e.g., "Deutsch".
-* @property {string} nameWithRegionCode - Language name with region in the default language, e.g., "German (AT)".
-* @property {string} nativeNameWithRegionCode - Language name with region in the native language, e.g., "Deutsch (AT)".
-* @property {string} regionCode - The region code from maximization, e.g., "AT".
-* @property {string} regionName - The region name in the default display language, e.g., "Austria".
-* @property {string} nativeRegionName - The region name in the native language, e.g., "Österreich".
-* @property {string} scriptCode - The script code from maximization, e.g., "Latn".
-* @property {string} scriptName - The script name in the default display language, e.g., "Latin".
-* @property {string} nativeScriptName - The script name in the native language, e.g., "Lateinisch".
-* @property {string} maximizedCode - The maximized locale code, e.g., "de-Latn-AT".
-* @property {string} maximizedName - Maximized locale name with likely script in the default language, e.g., "Austrian German (Latin)".
-* @property {string} nativeMaximizedName - Maximized locale name in the native language, e.g., "Österreichisches Deutsch (Lateinisch)".
-* @property {string} minimizedCode - Minimized locale code, e.g., "de-AT" (or "de" for "de-DE").
-* @property {string} minimizedName - Minimized language name in the default language, e.g., "Austrian German".
-* @property {string} nativeMinimizedName - Minimized language name in the native language, e.g., "Österreichisches Deutsch".
-* @property {string} emoji - The emoji associated with the locale's region, if applicable.
-*/
-function getLocaleProperties(locale, defaultLocale, customMapping) {
-	return _getLocaleProperties(locale, defaultLocale, customMapping);
-}
-/**
-* Retrieves multiple properties for a given region code, including:
-* - `code`: the original region code
-* - `name`: the localized display name
-* - `emoji`: the associated flag or symbol
-*
-* Behavior:
-* - Accepts ISO 3166-1 alpha-2 or UN M.49 region codes (e.g., `"US"`, `"FR"`, `"419"`).
-* - If `customMapping` contains a `name` or `emoji` for the region, those override the default values.
-* - Otherwise, uses `Intl.DisplayNames` to get the localized region name in the given `defaultLocale`,
-*   falling back to `libraryDefaultLocale`.
-* - Falls back to the region code as `name` if display name resolution fails.
-* - Falls back to `defaultEmoji` if no emoji mapping is found in `emojis` or `customMapping`.
-*
-* @param {string} region - The region code to look up (e.g., `"US"`, `"GB"`, `"DE"`).
-* @param {string} [defaultLocale=libraryDefaultLocale] - The locale to use when localizing the region name.
-* @param {CustomRegionMapping} [customMapping] - Optional mapping of region codes to custom names and/or emojis.
-* @returns {{ code: string, name: string, emoji: string }} An object containing:
-*  - `code`: the input region code
-*  - `name`: the localized or custom region name
-*  - `emoji`: the matching emoji flag or symbol
-*
-* @example
-* getRegionProperties('US', 'en');
-* // => { code: 'US', name: 'United States', emoji: '🇺🇸' }
-*
-* @example
-* getRegionProperties('US', 'fr');
-* // => { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }
-*
-* @example
-* getRegionProperties('US', 'en', { US: { name: 'USA', emoji: '🗽' } });
-* // => { code: 'US', name: 'USA', emoji: '🗽' }
-*/
-function getRegionProperties(region, defaultLocale, customMapping) {
-	return _getRegionProperties(region, defaultLocale, customMapping);
-}
-/**
-* Determines whether a translation is required based on the source and target locales.
-*
-* - If the target locale is not specified, the function returns `false`, as translation is not needed.
-* - If the source and target locale are the same, returns `false`, indicating that no translation is necessary.
-* - If the `approvedLocales` array is provided, and the target locale is not within that array, the function also returns `false`.
-* - Otherwise, it returns `true`, meaning that a translation is required.
-*
-* @param {string} sourceLocale - The locale code for the original content (BCP 47 locale code).
-* @param {string} targetLocale - The locale code of the language to translate the content into (BCP 47 locale code).
-* @param {string[]} [approvedLocale] - An optional array of approved target locales.
-*
-* @returns {boolean} - Returns `true` if translation is required, otherwise `false`.
-*/
-function requiresTranslation(sourceLocale, targetLocale, approvedLocales, customMapping) {
-	return _requiresTranslation(sourceLocale, targetLocale, approvedLocales, customMapping);
-}
-/**
-* Determines the best matching locale from the provided approved locales list.
-* @param {string | string[]} locales - A single locale or an array of locales sorted in preference order.
-* @param {string[]} [approvedLocales=this.locales] - An array of approved locales, also sorted by preference.
-* @returns {string | undefined} - The best matching locale from the approvedLocales list, or undefined if no match is found.
-*/
-function determineLocale(locales, approvedLocales = [], customMapping = void 0) {
-	return _determineLocale(locales, approvedLocales, customMapping);
-}
-/**
-* Get the text direction for a given locale code using the Intl.Locale API.
-*
-* @param {string} locale - A BCP-47 locale code.
-* @returns {string} 'rtl' if the locale is right-to-left; otherwise 'ltr'.
-*/
-function getLocaleDirection(locale) {
-	return _getLocaleDirection(locale);
-}
-/**
-* Resolves the alias locale for a given locale.
-* @param {string} locale - The locale to resolve the alias locale for
-* @param {CustomMapping} [customMapping] - The custom mapping to use for resolving the alias locale
-* @returns {string} The alias locale
-*/
-function resolveAliasLocale(locale, customMapping) {
-	return _resolveAliasLocale(locale, customMapping);
-}
-/**
-* Checks if multiple BCP 47 locale codes represent the same dialect.
-* @param {string[]} locales - The BCP 47 locale codes to compare.
-* @returns {boolean} True if all BCP 47 codes represent the same dialect, false otherwise.
-*/
-function isSameDialect(...locales) {
-	return _isSameDialect(...locales);
-}
-/**
-* Checks if multiple BCP 47 locale codes represent the same language.
-* @param {string[]} locales - The BCP 47 locale codes to compare.
-* @returns {boolean} True if all BCP 47 codes represent the same language, false otherwise.
-*/
-function isSameLanguage(...locales) {
-	return _isSameLanguage(...locales);
-}
-/**
-* Checks if a locale is a superset of another locale.
-* A subLocale is a subset of superLocale if it is an extension of superLocale or are otherwise identical.
-*
-* @param {string} superLocale - The locale to check if it is a superset of the other locale.
-* @param {string} subLocale - The locale to check if it is a subset of the other locale.
-* @returns {boolean} True if the first locale is a superset of the second locale, false otherwise.
-*/
-function isSupersetLocale(superLocale, subLocale) {
-	return _isSupersetLocale(superLocale, subLocale);
-}
 const API_VERSION = API_VERSION$1;
 //#endregion
 export { API_VERSION, GT, LocaleConfig, determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale };