generaltranslation 8.2.13 → 8.2.15

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { CustomMapping, FormatVariables, TranslateManyResult, TranslationError, TranslationResult, EnqueueFilesResult, CheckFileTranslationsOptions, DownloadFileBatchOptions, DownloadFileBatchResult, DownloadFileOptions, TranslateManyEntry } from './types';
-import { LocaleProperties } from './locales/getLocaleProperties';
+import { LocaleConfig } from '@generaltranslation/format';
+import type { CustomMapping, CustomRegionMapping, CutoffFormatOptions, FormatVariables, LocaleProperties, StringFormat } from '@generaltranslation/format/types';
+import { TranslateManyResult, TranslationError, TranslationResult, EnqueueFilesResult, CheckFileTranslationsOptions, DownloadFileBatchOptions, DownloadFileBatchResult, DownloadFileOptions, TranslateManyEntry } from './types';
 import { SetupProjectResult, SetupProjectOptions } from './translate/setupProject';
 import { EnqueueOptions } from './translate/enqueueFiles';
 import { CreateTagOptions, CreateTagResult } from './translate/createTag';
 import { FileQuery, FileQueryResult } from './types-dir/api/checkFileTranslations';
 import { SubmitUserEditDiffsPayload } from './translate/submitUserEditDiffs';
-import { CustomRegionMapping } from './locales/getRegionProperties';
 import { FileUpload, UploadFilesOptions, UploadFilesResponse } from './types-dir/api/uploadFiles';
 import { ProjectData } from './types-dir/api/project';
 import { DownloadFileBatchRequest } from './types-dir/api/downloadFileBatch';
@@ -19,12 +19,9 @@ import type { FileReference, FileReferenceIds } from './types-dir/api/file';
 import { type MoveMapping, type ProcessMovesResponse, type ProcessMovesOptions } from './translate/processFileMoves';
 import { type GetOrphanedFilesResult } from './translate/getOrphanedFiles';
 import { type PublishFileEntry, type PublishFilesResult } from './translate/publishFiles';
-import { CutoffFormatOptions } from './formatting/custom-formats/CutoffFormat/types';
 import { TranslateOptions } from './types-dir/api/entry';
-import { StringFormat } from './types-dir/jsx/content';
-import { LocaleConfig } from './LocaleConfig';
-export { LocaleConfig, type LocaleConfigConstructorParams, } from './LocaleConfig';
-export { formatCutoff, formatMessage, isValidLocale, resolveCanonicalLocale, standardizeLocale, } from './core';
+export { LocaleConfig, type LocaleConfigConstructorParams, } from '@generaltranslation/format';
+export { determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale, } from '@generaltranslation/format';
 /**
  * Type representing the constructor parameters for the GT class.
  * @typedef {Object} GTConstructorParams
@@ -786,234 +783,4 @@ export declare class GT {
      */
     isSupersetLocale(superLocale: string, subLocale: string): boolean;
 }
-/**
- * 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.
- */
-export declare function formatNum(number: number, options: {
-    locales: string | string[];
-} & Intl.NumberFormatOptions): string;
-/**
- * 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.
- */
-export declare function formatDateTime(date: Date, options?: {
-    locales?: string | string[];
-} & Intl.DateTimeFormatOptions): string;
-/**
- * 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.
- */
-export declare function formatCurrency(value: number, currency: string, options: {
-    locales: string | string[];
-} & Intl.NumberFormatOptions): string;
-/**
- * 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.
- */
-export declare function formatList(array: Array<string | number>, options: {
-    locales: string | string[];
-} & Intl.ListFormatOptions): string;
-/**
- * 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.
- */
-export declare function formatListToParts<T>(array: Array<T>, options?: {
-    locales?: string | string[];
-} & Intl.ListFormatOptions): Array<T | string>;
-/**
- * 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.
- */
-export declare function formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options: {
-    locales: string | string[];
-} & Omit<Intl.RelativeTimeFormatOptions, 'locales'>): string;
-/**
- * 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").
- */
-export declare function formatRelativeTimeFromDate(date: Date, options: {
-    locales: string | string[];
-    baseDate?: Date;
-} & Omit<Intl.RelativeTimeFormatOptions, 'locales'>): string;
-/**
- * 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.
- */
-export declare function getLocaleName(locale: string, defaultLocale?: string, customMapping?: CustomMapping): string;
-/**
- * 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.
- */
-export declare function getLocaleEmoji(locale: string, customMapping?: CustomMapping): string;
-/**
- * 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.
- */
-export declare function getLocaleProperties(locale: string, defaultLocale?: string, customMapping?: CustomMapping): LocaleProperties;
-/**
- * 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: '🗽' }
- */
-export declare function getRegionProperties(region: string, defaultLocale?: string, customMapping?: CustomRegionMapping): {
-    code: string;
-    name: string;
-    emoji: string;
-};
-/**
- * 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`.
- */
-export declare function requiresTranslation(sourceLocale: string, targetLocale: string, approvedLocales?: string[], customMapping?: CustomMapping): boolean;
-/**
- * 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.
- */
-export declare function determineLocale(locales: string | string[], approvedLocales?: string[] | undefined, customMapping?: CustomMapping | undefined): string | undefined;
-/**
- * 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'.
- */
-export declare function getLocaleDirection(locale: string): 'ltr' | 'rtl';
-/**
- * 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
- */
-export declare function resolveAliasLocale(locale: string, customMapping?: CustomMapping): string;
-/**
- * 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.
- */
-export declare function isSameDialect(...locales: (string | string[])[]): boolean;
-/**
- * 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.
- */
-export declare function isSameLanguage(...locales: (string | string[])[]): boolean;
-/**
- * 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.
- */
-export declare function isSupersetLocale(superLocale: string, subLocale: string): boolean;
 export declare const API_VERSION = "2026-03-06.v1";

package/dist/index.js

@@ -47,30 +47,9 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
 // ----- IMPORTS ----- //
-import _requiresTranslation from './locales/requiresTranslation';
-import _determineLocale from './locales/determineLocale';
-import { _formatNum, _formatCurrency, _formatList, _formatRelativeTime, _formatRelativeTimeFromDate, _formatDateTime, _formatListToParts, } from './formatting/format';
-import _isSameLanguage from './locales/isSameLanguage';
-import _getLocaleProperties from './locales/getLocaleProperties';
-import _getLocaleEmoji from './locales/getLocaleEmoji';
-import { _isValidLocale, _standardizeLocale } from './locales/isValidLocale';
-import { _getLocaleName } from './locales/getLocaleName';
-import { _getLocaleDirection } from './locales/getLocaleDirection';
+import { LocaleConfig, determineLocale as _determineLocale, getRegionProperties as _getRegionProperties, isValidLocale as _isValidLocale, requiresTranslation as _requiresTranslation, resolveAliasLocale as _resolveAliasLocale, resolveCanonicalLocale as _resolveCanonicalLocale, standardizeLocale as _standardizeLocale, } from '@generaltranslation/format';
 import { libraryDefaultLocale } from './settings/settings';
-import _isSameDialect from './locales/isSameDialect';
-import _isSupersetLocale from './locales/isSupersetLocale';
 import { noSourceLocaleProvidedError, noTargetLocaleProvidedError, invalidLocaleError, invalidLocalesError, noProjectIdProvidedError, noApiKeyProvidedError, } from './logging/errors';
 import { gtInstanceLogger } from './logging/logger';
 import _translateMany from './translate/translateMany';
@@ -79,9 +58,6 @@ import _enqueueFiles from './translate/enqueueFiles';
 import _createTag from './translate/createTag';
 import _downloadFileBatch from './translate/downloadFileBatch';
 import _submitUserEditDiffs from './translate/submitUserEditDiffs';
-import { _getRegionProperties, } from './locales/getRegionProperties';
-import { _resolveAliasLocale } from './locales/resolveAliasLocale';
-import { _resolveCanonicalLocale } from './locales/resolveCanonicalLocale';
 import _uploadSourceFiles from './translate/uploadSourceFiles';
 import _uploadTranslations from './translate/uploadTranslations';
 import _querySourceFile from './translate/querySourceFile';
@@ -95,9 +71,8 @@ import _processFileMoves from './translate/processFileMoves';
 import _getOrphanedFiles from './translate/getOrphanedFiles';
 import _publishFiles from './translate/publishFiles';
 import { API_VERSION as _API_VERSION } from './translate/api';
-import { LocaleConfig } from './LocaleConfig';
-export { LocaleConfig, } from './LocaleConfig';
-export { formatCutoff, formatMessage, isValidLocale, resolveCanonicalLocale, standardizeLocale, } from './core';
+export { LocaleConfig, } from '@generaltranslation/format';
+export { determineLocale, formatCurrency, formatCutoff, formatDateTime, formatList, formatListToParts, formatMessage, formatNum, formatRelativeTime, formatRelativeTimeFromDate, getLocaleDirection, getLocaleEmoji, getLocaleName, getLocaleProperties, getRegionProperties, isSameDialect, isSameLanguage, isSupersetLocale, isValidLocale, requiresTranslation, resolveAliasLocale, resolveCanonicalLocale, standardizeLocale, } from '@generaltranslation/format';
 /**
  * GT is the core driver for the General Translation library.
  * This class provides functionality for locale management, formatting, and translation operations.
@@ -1367,298 +1342,4 @@ var GT = /** @class */ (function () {
     return GT;
 }());
 export { GT };
-// ============================================================ //
-//                    Utility methods                           //
-// ============================================================ //
-// -------------- Formatting -------------- //
-/**
- * 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.
- */
-export function formatNum(number, options) {
-    return _formatNum({
-        value: number,
-        locales: options.locales,
-        options: 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.
- */
-export function formatDateTime(date, options) {
-    return _formatDateTime({
-        value: date,
-        locales: options === null || options === void 0 ? void 0 : options.locales,
-        options: 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.
- */
-export function formatCurrency(value, currency, options) {
-    return _formatCurrency({
-        value: value,
-        currency: currency,
-        locales: options.locales,
-        options: 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.
- */
-export function formatList(array, options) {
-    return _formatList({
-        value: array,
-        locales: options.locales,
-        options: 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.
- */
-export function formatListToParts(array, options) {
-    return _formatListToParts({
-        value: array,
-        locales: options === null || options === void 0 ? void 0 : options.locales,
-        options: 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.
- */
-export function formatRelativeTime(value, unit, options) {
-    return _formatRelativeTime({
-        value: value,
-        unit: unit,
-        locales: options.locales,
-        options: 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").
- */
-export function formatRelativeTimeFromDate(date, options) {
-    var locales = options.locales, baseDate = options.baseDate, intlOptions = __rest(options, ["locales", "baseDate"]);
-    return _formatRelativeTimeFromDate({
-        date: date,
-        baseDate: baseDate !== null && baseDate !== void 0 ? baseDate : new Date(),
-        locales: locales,
-        options: intlOptions,
-    });
-}
-// -------------- Locale Properties -------------- //
-/**
- * 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.
- */
-export 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.
- */
-export 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.
- */
-export 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: '🗽' }
- */
-export 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`.
- */
-export 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.
- */
-export function determineLocale(locales, approvedLocales, customMapping) {
-    if (approvedLocales === void 0) { approvedLocales = []; }
-    if (customMapping === void 0) { customMapping = undefined; }
-    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'.
- */
-export 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
- */
-export 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.
- */
-export function isSameDialect() {
-    var locales = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        locales[_i] = arguments[_i];
-    }
-    return _isSameDialect.apply(void 0, 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.
- */
-export function isSameLanguage() {
-    var locales = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        locales[_i] = arguments[_i];
-    }
-    return _isSameLanguage.apply(void 0, 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.
- */
-export function isSupersetLocale(superLocale, subLocale) {
-    return _isSupersetLocale(superLocale, subLocale);
-}
 export var API_VERSION = _API_VERSION;