generaltranslation 9.4.2 → 9.5.0

package/dist/runtime-Bcp4F2ME.mjs

@@ -1,974 +0,0 @@
-import { l as defaultTimeout, r as unwrapApiResult, s as createDiagnosticMessage, t as hasDecodedError } from "./unwrapApiResult-BzGfPw75.mjs";
-import { t as ApiError } from "./ApiError-CUKcz3YS.mjs";
-import { t as hashSource } from "./id-X2zyx5Jk.mjs";
-import { createApiClient, translate } from "@generaltranslation/api";
-import { LocaleConfig, getRegionProperties, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale } from "@generaltranslation/format";
-//#region src/logging/errors.ts
-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
-/**
-* @internal
-*
-* Wraps the fetch function with a timeout.
-*
-* @param url - The URL to fetch.
-* @param options - The options to pass to the fetch function.
-* @param timeout - The timeout in milliseconds.
-* @returns The response from the fetch function.
-*/
-async function fetchWithTimeout(url, options, timeout) {
-	const controller = new AbortController();
-	const signals = [controller.signal];
-	if (options.signal) signals.push(options.signal);
-	if (url instanceof Request) signals.push(url.signal);
-	const signal = AbortSignal.any(signals);
-	timeout = timeout ? timeout : defaultTimeout;
-	const timeoutId = timeout ? setTimeout(() => controller.abort(), timeout) : null;
-	try {
-		return await fetch(url, {
-			...options,
-			signal
-		});
-	} catch (error) {
-		if (error instanceof Error && error.name === "AbortError") throw translationTimeoutError(timeout);
-		throw error;
-	} finally {
-		if (timeoutId) clearTimeout(timeoutId);
-	}
-}
-//#endregion
-//#region src/translate/utils/validateResponse.ts
-async function validateResponse(response) {
-	if (!response.ok) {
-		let errorMsg = "Unknown error";
-		try {
-			const text = await response.text();
-			try {
-				errorMsg = JSON.parse(text).error;
-			} catch {
-				errorMsg = text || "Unknown error";
-			}
-		} catch {}
-		throw new ApiError(apiError(response.status, response.statusText, errorMsg), response.status, errorMsg);
-	}
-}
-//#endregion
-//#region src/translate/translateMany.ts
-async function _translateMany(requests, globalMetadata, config, timeout) {
-	const isArray = Array.isArray(requests);
-	const hashOrder = isArray ? [] : void 0;
-	const requestsObject = {};
-	const entries = isArray ? requests.map((r) => [void 0, r]) : Object.entries(requests);
-	for (const [key, request] of entries) {
-		const { source, metadata } = typeof request === "string" ? { source: request } : request;
-		const hash = key ?? metadata?.hash ?? hashSource({
-			source,
-			...metadata?.context && { context: metadata.context },
-			...metadata?.maxChars != null && { maxChars: metadata.maxChars },
-			...metadata?.fileFormat && { fileFormat: metadata.fileFormat },
-			dataFormat: metadata?.dataFormat ?? "STRING"
-		});
-		hashOrder?.push(hash);
-		requestsObject[hash] = {
-			source,
-			metadata
-		};
-	}
-	const client = createApiClient({
-		apiKey: config.apiKey,
-		baseUrl: config.baseUrl || "https://api.gtx.dev",
-		fetch: (input, init) => fetchWithTimeout(input, init ?? {}, timeout),
-		projectId: config.projectId,
-		retryPolicy: "none",
-		timeoutMs: false
-	});
-	const result = await translate({
-		body: {
-			requests: requestsObject,
-			targetLocale: globalMetadata.targetLocale,
-			sourceLocale: globalMetadata.sourceLocale,
-			metadata: globalMetadata
-		},
-		client
-	});
-	if (result.data === void 0 && result.response && !hasDecodedError(result)) {
-		await validateResponse(result.response);
-		throw result.error;
-	}
-	const response = unwrapApiResult(result);
-	if (hashOrder) return hashOrder.map((hash) => response[hash] ?? {
-		success: false,
-		error: "No translation returned",
-		code: 500
-	});
-	return response;
-}
-//#endregion
-//#region src/runtime.ts
-/**
-* GTRuntime is the runtime core of the GT driver: locale management,
-* formatting, and runtime translation requests.
-*
-* Browser-facing SDK code constructs this class (via `generaltranslation/runtime`)
-* so production bundles do not ship the project/file management API client
-* that lives on the GT class exported from the main entry.
-*
-* @example
-* const gt = new GTRuntime({
-*   sourceLocale: 'en-US',
-*   targetLocale: 'es-ES',
-*   locales: ['en-US', 'es-ES', 'fr-FR']
-* });
-*/
-var GTRuntime = class {
-	/** Runtime-safe locale and formatting helpers */
-	get localeConfig() {
-		return this._localeConfig;
-	}
-	/**
-	* Constructs an instance of the GTRuntime class.
-	*
-	* @param {GTConstructorParams} [params] - The parameters for initializing the GTRuntime instance
-	* @throws {Error} If an invalid locale is provided
-	* @throws {Error} If any of the provided locales are invalid
-	*
-	* @example
-	* const gt = new GTRuntime({
-	*   apiKey: 'your-api-key',
-	*   sourceLocale: 'en-US',
-	*   targetLocale: 'es-ES',
-	*   locales: ['en-US', 'es-ES', 'fr-FR']
-	* });
-	*/
-	constructor(params = {}) {
-		if (typeof process !== "undefined") {
-			this.apiKey ||= process.env?.GT_API_KEY;
-			this.devApiKey ||= process.env?.GT_DEV_API_KEY;
-			this.projectId ||= process.env?.GT_PROJECT_ID;
-		}
-		this.setConfig(params);
-	}
-	setConfig({ apiKey, devApiKey, sourceLocale, targetLocale, locales, projectId, customMapping, baseUrl }) {
-		const effectiveCustomMapping = customMapping ?? this.customMapping;
-		if (apiKey) this.apiKey = apiKey;
-		if (devApiKey) this.devApiKey = devApiKey;
-		if (projectId) this.projectId = projectId;
-		if (sourceLocale) {
-			this.sourceLocale = sourceLocale;
-			if (!isValidLocale(this.sourceLocale, effectiveCustomMapping)) throw new Error(invalidLocaleError(this.sourceLocale));
-		}
-		if (targetLocale) {
-			this.targetLocale = targetLocale;
-			if (!isValidLocale(this.targetLocale, effectiveCustomMapping)) throw new Error(invalidLocaleError(this.targetLocale));
-		}
-		if (locales) {
-			const result = [];
-			const invalidLocales = [];
-			locales.forEach((locale) => {
-				if (isValidLocale(locale, effectiveCustomMapping)) result.push(locale);
-				else invalidLocales.push(locale);
-			});
-			if (invalidLocales.length > 0) throw new Error(invalidLocalesError(invalidLocales));
-			this.locales = result;
-		}
-		if (baseUrl) this.baseUrl = baseUrl;
-		if (customMapping) {
-			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({
-			defaultLocale: this.sourceLocale,
-			locales: this.locales ?? [],
-			customMapping: this.customMapping
-		});
-	}
-	/** Convert app identity only where a GT service expects a language code. */
-	resolveServiceLocale(locale) {
-		return this.standardizeLocale(this.resolveCanonicalLocale(locale));
-	}
-	/**
-	* Recover configured spelling without negotiating an unrelated dialect.
-	* When several identities use the same service code and there is no request
-	* context to disambiguate them, the first configured identity wins.
-	*/
-	resolveServiceResponseLocale(locale) {
-		const canonical = this.standardizeLocale(locale);
-		return [
-			...this.locales ?? [],
-			this.sourceLocale,
-			this.targetLocale,
-			...Object.keys(this.customMapping ?? {})
-		].find((candidate) => candidate && this.resolveServiceLocale(candidate) === canonical) ?? locale;
-	}
-	_getTranslationConfig() {
-		return {
-			baseUrl: this.baseUrl,
-			apiKey: this.apiKey || this.devApiKey,
-			projectId: this.projectId || ""
-		};
-	}
-	_validateAuth(functionName) {
-		const errors = [];
-		if (!this.apiKey && !this.devApiKey) {
-			const error = noApiKeyProvidedError(functionName);
-			errors.push(error);
-		}
-		if (!this.projectId) {
-			const error = noProjectIdProvidedError(functionName);
-			errors.push(error);
-		}
-		if (errors.length) throw new Error(errors.join("\n"));
-	}
-	/**
-	* Translates a single source string to the target locale.
-	* Routes through {@link translateMany} under the hood.
-	*
-	* @param {string} source - The source string to translate.
-	* @param {object} options - Translation options including targetLocale and optional entry metadata.
-	* @returns {Promise<TranslationResult | TranslationError>} The translated content.
-	*
-	* @example
-	* const result = await gt.translate('Hello, world!', { targetLocale: 'es' });
-	*
-	* @example
-	* const result = await gt.translate('Hello, world!', {
-	*   targetLocale: 'es',
-	*   dataFormat: 'ICU',
-	*   context: 'A formal greeting',
-	* });
-	*/
-	async translate(source, options, timeout) {
-		if (typeof options === "string") options = { targetLocale: options };
-		this._validateAuth("translate");
-		let targetLocale = options?.targetLocale || this.targetLocale;
-		if (!targetLocale) {
-			const error = noTargetLocaleProvidedError("translate");
-			gtInstanceLogger.error(error);
-			throw new Error(error);
-		}
-		targetLocale = this.resolveServiceLocale(targetLocale);
-		const sourceLocale = this.resolveServiceLocale(options?.sourceLocale || this.sourceLocale || "en");
-		return (await _translateMany([source], {
-			...options,
-			targetLocale,
-			sourceLocale
-		}, this._getTranslationConfig(), timeout))[0];
-	}
-	async translateMany(sources, options, timeout) {
-		if (typeof options === "string") options = { targetLocale: options };
-		this._validateAuth("translateMany");
-		let targetLocale = options?.targetLocale || this.targetLocale;
-		if (!targetLocale) {
-			const error = noTargetLocaleProvidedError("translateMany");
-			gtInstanceLogger.error(error);
-			throw new Error(error);
-		}
-		targetLocale = this.resolveServiceLocale(targetLocale);
-		const sourceLocale = this.resolveServiceLocale(options?.sourceLocale || this.sourceLocale || "en");
-		return await _translateMany(sources, {
-			...options,
-			targetLocale,
-			sourceLocale
-		}, this._getTranslationConfig(), timeout);
-	}
-	/**
-	* Formats a string with cutoff behavior, applying a terminator when the string exceeds the maximum character limit.
-	*
-	* This method uses the GT instance's rendering locales by default for locale-specific terminator selection,
-	* but can be overridden with custom locales in the options.
-	*
-	* @param {string} value - The string value to format with cutoff behavior.
-	* @param {Object} [options] - Configuration options for cutoff formatting.
-	* @param {string | string[]} [options.locales] - The locales to use for terminator selection. Defaults to instance's rendering locales.
-	* @param {number} [options.maxChars] - The maximum number of characters to display.
-	* - Undefined values are treated as no cutoff.
-	* - Negative values follow .slice() behavior and terminator will be added before the value.
-	* - 0 will result in an empty string.
-	* - If cutoff results in an empty string, no terminator is added.
-	* @param {CutoffFormatStyle} [options.style='ellipsis'] - The style of the terminator.
-	* @param {string} [options.terminator] - Optional override the terminator to use.
-	* @param {string} [options.separator] - Optional override the separator to use between the terminator and the value.
-	* - If no terminator is provided, then separator is ignored.
-	* @returns {string} The formatted string with terminator applied if cutoff occurs.
-	*
-	* @example
-	* const gt = new GTRuntime({ targetLocale: 'en-US' });
-	* gt.formatCutoff('Hello, world!', { maxChars: 8 });
-	* // Returns: 'Hello, w...'
-	*
-	* @example
-	* gt.formatCutoff('Hello, world!', { maxChars: -3 });
-	* // Returns: '...ld!'
-	*/
-	formatCutoff(value, options) {
-		return this.localeConfig.formatCutoff(value, this.targetLocale, options);
-	}
-	/**
-	* Formats a message according to the specified locales and options.
-	*
-	* @param {string} message - The message to format.
-	* @param {string | string[]} [locales=libraryDefaultLocale] - The locales to use for formatting.
-	* @param {FormatVariables} [variables={}] - The variables to use for formatting.
-	* @param {StringFormat} [dataFormat='ICU'] - The format of the message.
-	* @returns {string} The formatted message.
-	*
-	* @example
-	* gt.formatMessage('Hello {name}', { name: 'John' });
-	* // Returns: "Hello John"
-	*
-	* gt.formatMessage('Hello {name}', { name: 'John' }, { locales: ['fr'] });
-	* // Returns: "Bonjour John"
-	*/
-	formatMessage(message, options) {
-		return this.localeConfig.formatMessage(message, this.targetLocale, options);
-	}
-	/**
-	* Formats a number according to the specified locales and options.
-	*
-	* @param {number} number - The number to format.
-	* @param {Object} [options] - Additional options for number formatting.
-	* @param {string | string[]} [options.locales] - The locales to use for formatting.
-	* @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.
-	* @returns {string} The formatted number.
-	*
-	* @example
-	* gt.formatNum(1234.56, { style: 'currency', currency: 'USD' });
-	* // Returns: "$1,234.56"
-	*/
-	formatNum(number, options) {
-		return this.localeConfig.formatNum(number, this.targetLocale, options);
-	}
-	/**
-	* Formats a date according to the specified locales and options.
-	*
-	* @param {Date} date - The date to format.
-	* @param {Object} [options] - Additional options for date formatting.
-	* @param {string | string[]} [options.locales] - The locales to use for formatting.
-	* @param {Intl.DateTimeFormatOptions} [options] - Additional Intl.DateTimeFormat options.
-	* @returns {string} The formatted date.
-	*
-	* @example
-	* gt.formatDateTime(new Date(), { dateStyle: 'full', timeStyle: 'long' });
-	* // Returns: "Thursday, March 14, 2024 at 2:30:45 PM GMT-7"
-	*/
-	formatDateTime(date, options) {
-		return this.localeConfig.formatDateTime(date, this.targetLocale, options);
-	}
-	/**
-	* Formats a currency value according to the specified locales and options.
-	*
-	* @param {number} value - The currency value to format.
-	* @param {string} currency - The currency code (e.g., 'USD', 'EUR')
-	* @param {Object} [options] - Additional options for currency formatting.
-	* @param {string | string[]} [options.locales] - The locales to use for formatting.
-	* @param {Intl.NumberFormatOptions} [options] - Additional Intl.NumberFormat options.
-	* @returns {string} The formatted currency value.
-	*
-	* @example
-	* gt.formatCurrency(1234.56, 'USD', { style: 'currency' });
-	* // Returns: "$1,234.56"
-	*/
-	formatCurrency(value, currency, options) {
-		return this.localeConfig.formatCurrency(value, currency, this.targetLocale, options);
-	}
-	/**
-	* Formats a list of items according to the specified locales and options.
-	*
-	* @param {Array<string | number>} 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 {string} The formatted list.
-	*
-	* @example
-	* gt.formatList(['apple', 'banana', 'orange'], { type: 'conjunction' });
-	* // Returns: "apple, banana, and orange"
-	*/
-	formatList(array, options) {
-		return this.localeConfig.formatList(array, this.targetLocale, 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.
-	*
-	* @example
-	* gt.formatListToParts(['apple', 42, { foo: 'bar' }], { type: 'conjunction', style: 'short', locales: ['en'] });
-	* // Returns: ['apple', ', ', 42, ' and ', '{ foo: "bar" }']
-	*/
-	formatListToParts(array, options) {
-		return this.localeConfig.formatListToParts(array, this.targetLocale, options);
-	}
-	/**
-	* Formats a relative time value according to the specified locales and options.
-	*
-	* @param {number} value - The relative time value to format.
-	* @param {Intl.RelativeTimeFormatUnit} unit - The unit of time (e.g., 'second', 'minute', 'hour', 'day', 'week', 'month', 'year')
-	* @param {Object} options - Additional options for relative time formatting.
-	* @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.
-	*
-	* @example
-	* gt.formatRelativeTime(-1, 'day', { locales: ['en-US'], numeric: 'auto' });
-	* // Returns: "yesterday"
-	*/
-	formatRelativeTime(value, unit, options) {
-		return this.localeConfig.formatRelativeTime(value, unit, this.targetLocale, 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] - Additional options for relative time formatting.
-	* @param {string | string[]} [options.locales] - The locales to use for formatting.
-	* @returns {string} The formatted relative time string (e.g., "2 hours ago", "in 3 days")
-	*
-	* @example
-	* gt.formatRelativeTimeFromDate(new Date(Date.now() - 3600000));
-	* // Returns: "1 hour ago"
-	*/
-	formatRelativeTimeFromDate(date, options) {
-		return this.localeConfig.formatRelativeTimeFromDate(date, this.targetLocale, options);
-	}
-	/**
-	* Retrieves the display name of a locale code using Intl.DisplayNames, returning an empty string if no name is found.
-	*
-	* @param {string} [locale=this.targetLocale] - A BCP-47 locale code.
-	* @returns {string} The display name corresponding to the code.
-	* @throws {Error} If no target locale is provided.
-	*
-	* @example
-	* gt.getLocaleName('es-ES');
-	* // Returns: "Spanish (Spain)"
-	*/
-	getLocaleName(locale = this.targetLocale) {
-		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleName"));
-		return this.localeConfig.getLocaleName(locale);
-	}
-	/**
-	* Retrieves an emoji based on a given locale code.
-	* Uses the locale's region (if present) to select an emoji or falls back on default emojis.
-	*
-	* @param {string} [locale=this.targetLocale] - A BCP-47 locale code (e.g., 'en-US', 'fr-CA')
-	* @returns {string} The emoji representing the locale or its region.
-	* @throws {Error} If no target locale is provided.
-	*
-	* @example
-	* gt.getLocaleEmoji('es-ES');
-	* // Returns: "🇪🇸"
-	*/
-	getLocaleEmoji(locale = this.targetLocale) {
-		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleEmoji"));
-		return this.localeConfig.getLocaleEmoji(locale);
-	}
-	/**
-	* 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=this.targetLocale] - The locale code to get properties for (e.g., "de-AT").
-	* @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.
-	*/
-	getLocaleProperties(locale = this.targetLocale) {
-		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleProperties"));
-		return this.localeConfig.getLocaleProperties(locale);
-	}
-	/**
-	* 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"`).
-	* - Uses the instance's `targetLocale` to localize the region name for the user.
-	* - 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, falling back to `libraryDefaultLocale`.
-	* - Falls back to the region code as `name` if display name resolution fails.
-	* - Falls back to a default emoji if no emoji mapping is found in built-in data or `customMapping`.
-	*
-	* @param {string} [region=this.getLocaleProperties().regionCode] - The region code to look up (e.g., `"US"`, `"GB"`, `"DE"`).
-	* @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
-	*
-	* @throws {Error} If no target locale is available to determine region properties.
-	*
-	* @example
-	* const gt = new GTRuntime({ targetLocale: 'en-US' });
-	* gt.getRegionProperties('US');
-	* // => { code: 'US', name: 'United States', emoji: '🇺🇸' }
-	*
-	* @example
-	* const gt = new GTRuntime({ targetLocale: 'fr-FR' });
-	* gt.getRegionProperties('US');
-	* // => { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }
-	*
-	* @example
-	* gt.getRegionProperties('US', { US: { name: 'USA', emoji: '🗽' } });
-	* // => { code: 'US', name: 'USA', emoji: '🗽' }
-	*/
-	getRegionProperties(region = this.getLocaleProperties().regionCode, customMapping) {
-		if (!customMapping) {
-			if (this.customMapping && !this.customRegionMapping) {
-				const customRegionMapping = {};
-				for (const [locale, lp] of Object.entries(this.customMapping)) if (lp && typeof lp === "object" && lp.regionCode && !customRegionMapping[lp.regionCode]) {
-					const { regionName: name, emoji } = lp;
-					customRegionMapping[lp.regionCode] = {
-						locale,
-						...name && { name },
-						...emoji && { emoji }
-					};
-				}
-				this.customRegionMapping = customRegionMapping;
-			}
-			customMapping = this.customRegionMapping;
-		}
-		return getRegionProperties(region, this.targetLocale, customMapping);
-	}
-	/**
-	* Determines whether a translation is required based on the source and target locales.
-	*
-	* @param {string} [sourceLocale=this.sourceLocale] - The locale code for the original content.
-	* @param {string} [targetLocale=this.targetLocale] - The locale code to translate into.
-	* @param {string[]} [approvedLocales=this.locales] - Optional array of approved target locales.
-	* @returns {boolean} True if translation is required, false otherwise
-	* @throws {Error} If no source locale is provided.
-	* @throws {Error} If no target locale is provided.
-	*
-	* @example
-	* gt.requiresTranslation('en-US', 'es-ES');
-	* // Returns: true
-	*/
-	requiresTranslation(sourceLocale = this.sourceLocale, targetLocale = this.targetLocale, approvedLocales = this.locales, customMapping = this.customMapping) {
-		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);
-	}
-	/**
-	* Determines the best matching locale from the provided approved locales list.
-	*
-	* @param {string | string[]} locales - A single locale or array of locales in preference order.
-	* @param {string[]} [approvedLocales=this.locales] - Array of approved locales in preference order.
-	* @returns {string | undefined} The best matching locale, or undefined if no match is found.
-	*
-	* @example
-	* gt.determineLocale(['fr-CA', 'fr-FR'], ['en-US', 'fr-FR', 'es-ES']);
-	* // Returns: "fr-FR"
-	*/
-	determineLocale(locales, approvedLocales = this.locales || [], customMapping = this.customMapping) {
-		if (customMapping === this.customMapping) return this.localeConfig.determineLocale(locales, approvedLocales ?? []);
-		return new LocaleConfig({ customMapping }).determineLocale(locales, approvedLocales ?? []);
-	}
-	/**
-	* Gets the text direction for a given locale code.
-	*
-	* @param {string} [locale=this.targetLocale] - A BCP-47 locale code.
-	* @returns {'ltr' | 'rtl'} 'rtl' if the locale is right-to-left; otherwise 'ltr'.
-	* @throws {Error} If no target locale is provided.
-	*
-	* @example
-	* gt.getLocaleDirection('ar-SA');
-	* // Returns: "rtl"
-	*/
-	getLocaleDirection(locale = this.targetLocale) {
-		if (!locale) throw new Error(noTargetLocaleProvidedError("getLocaleDirection"));
-		return this.localeConfig.getLocaleDirection(locale);
-	}
-	/**
-	* Checks if a given BCP 47 locale code is valid.
-	*
-	* @param {string} [locale=this.targetLocale] - The BCP 47 locale code to validate.
-	* @param {CustomMapping} [customMapping=this.customMapping] - The custom mapping to use for validation.
-	* @returns {boolean} True if the locale code is valid, false otherwise
-	* @throws {Error} If no target locale is provided.
-	*
-	* @example
-	* gt.isValidLocale('en-US');
-	* // Returns: true
-	*/
-	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);
-	}
-	/**
-	* Resolves the canonical locale for a given locale.
-	* @param locale - The locale to resolve the canonical locale for
-	* @param customMapping - The custom mapping to use for resolving the canonical locale
-	* @returns The canonical locale, or the input locale when no canonical mapping exists.
-	*/
-	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);
-	}
-	/**
-	* Resolves the alias locale for a given locale.
-	* @param locale - The locale to resolve the alias locale for
-	* @param customMapping - The custom mapping to use for resolving the alias locale
-	* @returns The configured alias for a canonical locale, or the input locale when already an alias or no alias mapping exists.
-	*/
-	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);
-	}
-	/**
-	* Standardizes a BCP 47 locale code to ensure correct formatting.
-	*
-	* @param {string} [locale=this.targetLocale] - The BCP 47 locale code to standardize.
-	* @returns {string} The standardized locale code, or the input string if it cannot be standardized.
-	* @throws {Error} If no target locale is provided.
-	*
-	* @example
-	* gt.standardizeLocale('en_us');
-	* // Returns: "en-US"
-	*/
-	standardizeLocale(locale = this.targetLocale) {
-		if (!locale) throw new Error(noTargetLocaleProvidedError("standardizeLocale"));
-		return this.localeConfig.standardizeLocale(locale);
-	}
-	/**
-	* Checks if multiple BCP 47 locale codes represent the same dialect.
-	*
-	* @param {...(string | string[])} locales - The BCP 47 locale codes to compare.
-	* @returns {boolean} True if all codes represent the same dialect, false otherwise
-	*
-	* @example
-	* gt.isSameDialect('en-US', 'en-GB');
-	* // Returns: false
-	*
-	* gt.isSameDialect('en', 'en-US');
-	* // Returns: true
-	*/
-	isSameDialect(...locales) {
-		return this.localeConfig.isSameDialect(...locales);
-	}
-	/**
-	* Checks if multiple BCP 47 locale codes represent the same language.
-	*
-	* @param {...(string | string[])} locales - The BCP 47 locale codes to compare.
-	* @returns {boolean} True if all codes represent the same language, false otherwise
-	*
-	* @example
-	* gt.isSameLanguage('en-US', 'en-GB');
-	* // Returns: true
-	*/
-	isSameLanguage(...locales) {
-		return this.localeConfig.isSameLanguage(...locales);
-	}
-	/**
-	* Checks if a locale is a superset of another locale.
-	*
-	* @param {string} superLocale - The locale to check if it is a superset
-	* @param {string} subLocale - The locale to check if it is a subset
-	* @returns {boolean} True if superLocale is a superset of subLocale, false otherwise
-	*
-	* @example
-	* gt.isSupersetLocale('en', 'en-US');
-	* // Returns: true
-	*
-	* gt.isSupersetLocale('en-US', 'en');
-	* // Returns: false
-	*/
-	isSupersetLocale(superLocale, subLocale) {
-		return this.localeConfig.isSupersetLocale(superLocale, subLocale);
-	}
-};
-//#endregion
-export { gtInstanceLogger as a, translationRequestFailedError as c, fetchLogger as i, translationTimeoutError as l, validateResponse as n, noSourceLocaleProvidedError as o, fetchWithTimeout as r, noTargetLocaleProvidedError as s, GTRuntime as t };
-
-//# sourceMappingURL=runtime-Bcp4F2ME.mjs.map