generaltranslation 2.0.66 → 2.0.68

package/dist/codes/codes.js

@@ -3,319 +3,93 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._getLanguageCode = exports._getLanguageName = void 0;
-exports._standardizeLanguageCode = _standardizeLanguageCode;
-exports._isValidLanguageCode = _isValidLanguageCode;
-exports._getLanguageObject = _getLanguageObject;
-exports._isSameLanguage = _isSameLanguage;
-// ----- IMPORTS ----- //
-// Import modules for mapping ISO 639 codes to language names and vice versa
-var CodeToLanguage_json_1 = __importDefault(require("./639-1/CodeToLanguage.json"));
-var LanguageToCode_json_1 = __importDefault(require("./639-1/LanguageToCode.json"));
-var CodeToLanguage = CodeToLanguage_json_1.default;
-var LanguageToCode = LanguageToCode_json_1.default;
-// Import modules for mapping ISO 639-3 codes (for languages without two-letter codes)
-var CodeToLanguageTriletter_json_1 = __importDefault(require("./639-3/CodeToLanguageTriletter.json"));
-var LanguageToCodeTriletter_json_1 = __importDefault(require("./639-3/LanguageToCodeTriletter.json"));
-var CodeToLanguageTriletter = CodeToLanguageTriletter_json_1.default;
-var LanguageToCodeTriletter = LanguageToCodeTriletter_json_1.default;
-// Import module for mapping ISO 15924 script codes to script names
-var ScriptToCode_json_1 = __importDefault(require("./15924/ScriptToCode.json"));
-var CodeToScript_json_1 = __importDefault(require("./15924/CodeToScript.json"));
-var ScriptToCode = ScriptToCode_json_1.default;
-var CodeToScript = CodeToScript_json_1.default;
-// Import module for mapping ISO 3166 region codes to region names
-var RegionToCode_json_1 = __importDefault(require("./3166/RegionToCode.json"));
-var CodeToRegion_json_1 = __importDefault(require("./3166/CodeToRegion.json"));
-var RegionToCode = RegionToCode_json_1.default;
-var CodeToRegion = CodeToRegion_json_1.default;
-// Import predefined common regions
-var Predefined_json_1 = __importDefault(require("./predefined/Predefined.json"));
-var Predefined = Predefined_json_1.default;
-// ----- VALIDITY CHECKS ----- //
+exports._standardizeLanguageCode = exports._isValidLanguageCode = void 0;
+exports._getLanguageName = _getLanguageName;
+exports._getLanguageDirection = _getLanguageDirection;
+var libraryDefaultLanguage_1 = __importDefault(require("../settings/libraryDefaultLanguage"));
 /**
- * Ensures correct capitalization and formatting of a language code.
- * @param {string} code - The language-country-script code to standardize.
- * @returns {string} A BCP 47 language tag.
+ * Checks if a given BCP 47 language code is valid.
+ * @param {string} code - The BCP 47 language code to validate.
+ * @returns {boolean} True if the BCP 47 code is valid, false otherwise.
  * @internal
  */
-function _standardizeLanguageCode(code) {
-    if (!_isValidLanguageCode(code))
-        return '';
-    var codeParts = code.split('-');
-    var result = "".concat(codeParts[0].toLowerCase());
-    if (codeParts[1]) {
-        if (codeParts[1].length === 4) {
-            result += "-".concat(_capitalize(codeParts[1]));
-            if (codeParts[2] && codeParts[2].length === 2) {
-                result += "-".concat(codeParts[2].toUpperCase());
-            }
-        }
-        else if (codeParts[1].length === 2) {
-            result += "-".concat(codeParts[1].toUpperCase());
-        }
+var _isValidLanguageCode = function (code) {
+    try {
+        var displayNames = new Intl.DisplayNames([libraryDefaultLanguage_1.default], { type: 'language' });
+        return displayNames.of(code) !== code;
     }
-    return result;
-}
-/**
- * Check if a given language-country-script code is valid.
- * @param {string} code - The language-country-script code to validate.
- * @returns {boolean} - Returns true if valid, false otherwise.
- * @internal
- */
-function _isValidLanguageCode(code) {
-    if (!code || typeof code !== 'string')
-        return false;
-    var codeParts = code.split('-');
-    if (!_mapCodeToLanguage(codeParts[0]))
+    catch (_a) {
         return false;
-    if (codeParts[1]) {
-        if (codeParts[1].length === 4) {
-            if (!_mapCodeToScript(codeParts[1]))
-                return false;
-            if (codeParts[2] && codeParts[2].length === 2) {
-                if (!_mapCodeToRegion(codeParts[2]))
-                    return false;
-            }
-        }
-        else if (codeParts[1].length === 2) {
-            if (!_mapCodeToRegion(codeParts[1]))
-                return false;
-        }
-    }
-    return true;
-}
-// ----- FORMATTING HELPER FUNCTIONS ----- //
-/**
- * Capitalizes the first letter of a code and converts the rest to lowercase.
- * @param {string} code - The code to capitalize.
- * @returns {string} The capitalized code.
- */
-var _capitalize = function (code) {
-    if (code.length === 0)
-        return code;
-    return code.charAt(0).toUpperCase() + code.slice(1).toLowerCase();
-};
-// ----- MAPPING FUNCTIONS ----- //
-/**
- * Returns the name of a language from an ISO 639 code.
- * @param {string} code - The ISO 639 code.
- * @returns {string} The language name.
- */
-var _mapCodeToLanguage = function (code) {
-    code = code === null || code === void 0 ? void 0 : code.toLowerCase();
-    if ((code === null || code === void 0 ? void 0 : code.length) === 2) {
-        return CodeToLanguage[code];
-    }
-    if ((code === null || code === void 0 ? void 0 : code.length) === 3) {
-        return CodeToLanguageTriletter[code];
     }
-    return '';
-};
-/**
- * Returns a BCP 47 language tag from a language name.
- * Preferentially returns two-letter codes.
- * @param {string} language - The language name.
- * @returns {string} BCP 47 language tag.
- */
-var _mapLanguageToCode = function (language) {
-    language = language === null || language === void 0 ? void 0 : language.toLowerCase();
-    return LanguageToCode[language] || LanguageToCodeTriletter[language] || '';
-};
-/**
- * Returns the name of a script from an ISO 15924 code.
- * @param {string} code - The ISO 15924 code.
- * @returns {string} The script name.
- */
-var _mapCodeToScript = function (code) {
-    code = _capitalize(code);
-    return CodeToScript[code] || '';
-};
-/**
- * Returns an ISO 15924 code from a script name.
- * @param {string} script - The script name.
- * @returns {string} The ISO 15924 code.
- */
-var _mapScriptToCode = function (script) {
-    script = script === null || script === void 0 ? void 0 : script.toLowerCase();
-    return ScriptToCode[script] || '';
-};
-/**
- * Returns the name of a region from an ISO 3166 code.
- * @param {string} code - The ISO 3166 code.
- * @returns {string} The region name.
- */
-var _mapCodeToRegion = function (code) {
-    code = code === null || code === void 0 ? void 0 : code.toUpperCase();
-    return CodeToRegion[code] || '';
-};
-/**
- * Returns an ISO 3166 code from a region name.
- * @param {string} region - The region name.
- * @returns {string} The ISO 3166 code.
- */
-var _mapRegionToCode = function (region) {
-    region = region === null || region === void 0 ? void 0 : region.toLowerCase();
-    return RegionToCode[region] || '';
 };
+exports._isValidLanguageCode = _isValidLanguageCode;
 /**
+ * Standardizes a BCP 47 language code to ensure correct formatting.
+ * @param {string} code - The BCP 47 language code to standardize.
+ * @returns {string} The standardized BCP 47 language code, or an empty string if invalid.
  * @internal
  */
-function _getLanguageObject(codes) {
-    return Array.isArray(codes) ? codes.map(_handleGetLanguageObject) : _handleGetLanguageObject(codes);
-}
-/**
- * Helper function to create a language object from a code.
- * @param {string} code - The language code.
- * @returns {LanguageObject|null} The language object.
- */
-var _handleGetLanguageObject = function (code) {
-    if (!_isValidLanguageCode(code))
-        return null;
-    var codeParts = code.split('-');
-    var languageObject = {
-        language: _mapCodeToLanguage(codeParts[0]),
-    };
-    if (codeParts[1]) {
-        if (codeParts[1].length === 4) {
-            languageObject.script = _mapCodeToScript(codeParts[1]);
-            if (codeParts[2] && codeParts[2].length === 2) {
-                languageObject.region = _mapCodeToRegion(codeParts[2]);
-            }
-        }
-        else if (codeParts[1].length === 2) {
-            languageObject.region = _mapCodeToRegion(codeParts[1]);
-        }
+var _standardizeLanguageCode = function (code) {
+    try {
+        return new Intl.Locale(code).toString();
     }
-    return languageObject;
-};
-// ----- LANGUAGE NAMES FROM CODES ----- //
-/**
- * Returns the language name(s) from an array of codes or a single code.
- * @param {string|string[]} codes - The code or array of codes.
- * @returns {string|string[]} The language name(s).
- * @internal
- */
-var _getLanguageName = function (codes) {
-    return Array.isArray(codes) ? codes.map(_handleGetLanguageName) : _handleGetLanguageName(codes);
-};
-exports._getLanguageName = _getLanguageName;
-/**
- * Helper function to get the language name from a code.
- * @param {string} code - The language code.
- * @returns {string} The language name.
- */
-var _handleGetLanguageName = function (code) {
-    if (!_isValidLanguageCode(code))
+    catch (_a) {
+        // Return empty string instead of throwing an error
         return '';
-    if (Predefined[code])
-        return Predefined[code];
-    var languageObject = _handleGetLanguageObject(code);
-    if (!languageObject)
-        return '';
-    var result = languageObject.language;
-    if (languageObject.script) {
-        result += ", ".concat(languageObject.script);
-    }
-    if (languageObject.region) {
-        result += ", ".concat(languageObject.region);
     }
-    return result;
 };
-// ----- LANGUAGE CODES FROM NAMES ----- //
+exports._standardizeLanguageCode = _standardizeLanguageCode;
 /**
- * Returns the language code(s) from an array of language names or a single name.
- * @param {string|string[]} languages - The language name or array of language names.
- * @returns {string|string[]} The language code(s).
+ * Retrieves the display name(s) of language code(s) using Intl.DisplayNames.
+ *
+ * @param {string | string[]} code - A language code or an array of codes.
+ * @param {string} [defaultLanguage=libraryDefaultLanguage] - The language for display names.
+ * @returns {string | string[]} The display name(s) corresponding to the code(s), or empty string(s) if invalid.
  * @internal
  */
-var _getLanguageCode = function (languages) {
-    return Array.isArray(languages) ? languages.map(_handleGetLanguageCode) : _handleGetLanguageCode(languages);
-};
-exports._getLanguageCode = _getLanguageCode;
-/**
- * Helper function to get the language code from a language name.
- * @param {string|LanguageObject} language - The language name or object.
- * @returns {string} The language code.
- */
-var _handleGetLanguageCode = function (language) {
-    if (typeof language === 'string')
-        return _handleGetLanguageCodeFromString(language);
-    return _handleGetLanguageCodeFromObject(language);
-};
-/**
- * Helper function to get the language code from a language name string.
- * @param {string} language - The language name.
- * @returns {string} The language code.
- */
-var _handleGetLanguageCodeFromString = function (language) {
-    var subtagStrings = language.split(',').map(function (string) { return string.trim(); });
-    var code = _mapLanguageToCode(subtagStrings[0]);
-    if (code) {
-        if (subtagStrings.length === 3) {
-            code += "-".concat(_mapScriptToCode(subtagStrings[1]));
-            code += "-".concat(_mapRegionToCode(subtagStrings[2]));
+function _getLanguageName(code, defaultLanguage) {
+    if (defaultLanguage === void 0) { defaultLanguage = libraryDefaultLanguage_1.default; }
+    try {
+        var displayNames_1 = new Intl.DisplayNames([defaultLanguage], { type: 'language' });
+        if (typeof code === 'string') {
+            // Handle the case where it's a single language code
+            var name = displayNames_1.of(code);
+            return name || '';
         }
-        else if (subtagStrings.length === 2) {
-            var tag = _mapScriptToCode(subtagStrings[1]);
-            if (!tag)
-                tag = _mapRegionToCode(subtagStrings[1]);
-            if (tag)
-                code += "-".concat(tag);
+        else if (Array.isArray(code)) {
+            // Handle the case where it's an array of language codes
+            return code.map(function (c) { return displayNames_1.of(c) || ''; });
         }
+        // If code is neither string nor array, return empty string
+        return '';
     }
-    if (!code) {
-        for (var key in Predefined) {
-            if (Predefined[key] === language) {
-                return key;
-            }
+    catch (_a) {
+        // In case Intl.DisplayNames construction fails, return empty string(s)
+        if (typeof code === 'string') {
+            return '';
+        }
+        else if (Array.isArray(code)) {
+            return code.map(function () { return ''; });
         }
-    }
-    return code;
-};
-/**
- * Helper function to get the language code from a language object.
- * @param {LanguageObject} languageObject - The language object.
- * @returns {string} The language code.
- */
-var _handleGetLanguageCodeFromObject = function (languageObject) {
-    if (!(languageObject === null || languageObject === void 0 ? void 0 : languageObject.language))
         return '';
-    var code = languageObject.language.toLowerCase();
-    if (languageObject.script) {
-        code += "-".concat(_capitalize(languageObject.script));
-    }
-    if (languageObject.region) {
-        code += "-".concat(languageObject.region.toUpperCase());
     }
-    return _isValidLanguageCode(code) ? code : '';
-};
+}
 /**
+ * Get the text direction for a given language code using the Intl.Locale API.
+ *
+ * @param {string} code - The language code to check.
+ * @returns {string} - 'rtl' if the language is right-to-left, otherwise 'ltr'.
  * @internal
  */
-function _isSameLanguage() {
-    var codes = [];
-    for (var _i = 0; _i < arguments.length; _i++) {
-        codes[_i] = arguments[_i];
+function _getLanguageDirection(code) {
+    var _a;
+    try {
+        var locale = new Intl.Locale(code);
+        // Return 'rtl' if the text direction of the language is right-to-left, otherwise 'ltr'
+        return ((_a = locale === null || locale === void 0 ? void 0 : locale.textInfo) === null || _a === void 0 ? void 0 : _a.direction) === 'rtl' ? 'rtl' : 'ltr';
     }
-    // Flatten the array in case the codes are provided as an array
-    if (codes.length === 1 && Array.isArray(codes[0])) {
-        codes = codes[0];
-    }
-    if (codes.length < 2)
-        return false;
-    var language = null;
-    for (var i = 0; i < codes.length; i++) {
-        if (typeof codes[i] !== 'string')
-            return false;
-        var languageCode = codes[i].split('-')[0];
-        var currentLanguage = _mapCodeToLanguage(languageCode);
-        if (language === null) {
-            language = currentLanguage;
-        }
-        else if (language !== currentLanguage) {
-            return false;
-        }
+    catch (_b) {
+        // If the code is invalid or causes an error, fallback to 'ltr'
+        return 'ltr';
     }
-    return true;
 }

package/dist/formatting/{_format.js → format.js}

@@ -10,10 +10,16 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._formatNum = _formatNum;
 exports._formatDateTime = _formatDateTime;
 exports._formatCurrency = _formatCurrency;
+exports._formatList = _formatList;
+exports._formatRelativeTime = _formatRelativeTime;
+var libraryDefaultLanguage_1 = __importDefault(require("../settings/libraryDefaultLanguage"));
 /**
  * Formats a number according to the specified languages and options.
  *
@@ -26,7 +32,7 @@ exports._formatCurrency = _formatCurrency;
  * @internal
  */
 function _formatNum(_a) {
-    var value = _a.value, _b = _a.languages, languages = _b === void 0 ? ['en'] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
+    var value = _a.value, _b = _a.languages, languages = _b === void 0 ? [libraryDefaultLanguage_1.default] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
     return new Intl.NumberFormat(languages, __assign({ numberingSystem: 'latn' }, options)).format(value);
 }
 /**
@@ -41,7 +47,7 @@ function _formatNum(_a) {
  * @internal
  */
 function _formatDateTime(_a) {
-    var value = _a.value, _b = _a.languages, languages = _b === void 0 ? ['en'] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
+    var value = _a.value, _b = _a.languages, languages = _b === void 0 ? [libraryDefaultLanguage_1.default] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
     return new Intl.DateTimeFormat(languages, __assign({ calendar: "gregory", numberingSystem: "latn" }, options)).format(value);
 }
 /**
@@ -57,6 +63,37 @@ function _formatDateTime(_a) {
  * @internal
  */
 function _formatCurrency(_a) {
-    var value = _a.value, _b = _a.languages, languages = _b === void 0 ? ['en'] : _b, _c = _a.currency, currency = _c === void 0 ? 'USD' : _c, _d = _a.options, options = _d === void 0 ? {} : _d;
+    var value = _a.value, _b = _a.languages, languages = _b === void 0 ? [libraryDefaultLanguage_1.default] : _b, _c = _a.currency, currency = _c === void 0 ? 'USD' : _c, _d = _a.options, options = _d === void 0 ? {} : _d;
     return new Intl.NumberFormat(languages, __assign({ style: 'currency', currency: currency, numberingSystem: 'latn' }, options)).format(value);
 }
+/**
+ * Formats a list of items according to the specified languages and options.
+ *
+ * @param {Object} params - The parameters for the list formatting.
+ * @param {Array<string | number>} params.value - The list of items to format.
+ * @param {string | string[]} [params.languages=['en']] - The languages to use for formatting.
+ * @param {Intl.ListFormatOptions} [params.options={}] - Additional options for list formatting.
+ *
+ * @returns {string} The formatted list.
+ * @internal
+ */
+function _formatList(_a) {
+    var value = _a.value, _b = _a.languages, languages = _b === void 0 ? [libraryDefaultLanguage_1.default] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
+    return new Intl.ListFormat(languages, __assign({ type: 'conjunction', style: 'long' }, options)).format(value);
+}
+/**
+ * Formats a relative time value according to the specified languages 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 {string | string[]} [params.languages=['en']] - The languages to use for formatting.
+ * @param {Intl.RelativeTimeFormatOptions} [params.options={}] - Additional options for relative time formatting.
+ *
+ * @returns {string} The formatted relative time string.
+ * @internal
+ */
+function _formatRelativeTime(_a) {
+    var value = _a.value, unit = _a.unit, _b = _a.languages, languages = _b === void 0 ? [libraryDefaultLanguage_1.default] : _b, _c = _a.options, options = _c === void 0 ? {} : _c;
+    return new Intl.RelativeTimeFormat(languages, __assign({ style: "long", numeric: 'auto' }, options)).format(value, unit);
+}

package/dist/formatting/{_string_content.js → string_content.js}

@@ -10,10 +10,14 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._splitStringToContent = _splitStringToContent;
 exports._renderContentToString = _renderContentToString;
-var _format_1 = require("./_format");
+var libraryDefaultLanguage_1 = __importDefault(require("../settings/libraryDefaultLanguage"));
+var format_1 = require("./format");
 // Variable types mapping
 var variableTypeMap = {
     var: "variable",
@@ -28,6 +32,8 @@ var variableTypeMap = {
  * @internal
  */
 function _splitStringToContent(string) {
+    if (typeof string !== 'string')
+        throw new Error("splitStringToContent: ".concat(string, " is not a string!"));
     var result = [];
     var regex = /{([^}]+)}/g;
     var lastIndex = 0;
@@ -68,15 +74,15 @@ function _splitStringToContent(string) {
 * @internal
 */
 function _renderContentToString(content, languages, variables, variableOptions) {
-    if (languages === void 0) { languages = 'en'; }
+    if (languages === void 0) { languages = libraryDefaultLanguage_1.default; }
     if (variables === void 0) { variables = {}; }
     if (variableOptions === void 0) { variableOptions = {}; }
-    if (typeof content === 'string') {
+    if (typeof content === 'string')
         content = _splitStringToContent(content);
-    }
-    if (typeof content === 'string') {
+    if (typeof content === 'string')
         return content;
-    }
+    if (!Array.isArray(content))
+        throw new Error("renderContentToString: content ".concat(content, " is invalid"));
     return content.map(function (item) {
         var _a;
         if (typeof item === 'string')
@@ -85,18 +91,21 @@ function _renderContentToString(content, languages, variables, variableOptions)
             var value = variables[item.key];
             if (!item.variable)
                 return value;
-            if (item.variable === "number") {
-                return (0, _format_1._formatNum)({
+            else if (item.variable === "number") {
+                return (0, format_1._formatNum)({
                     value: value,
                     languages: languages,
                     options: variableOptions[item.key]
                 });
             }
-            if (item.variable === "currency") {
-                return (0, _format_1._formatCurrency)(__assign(__assign({ value: value, languages: languages }, (variableOptions[item.key] && { options: variableOptions[item.key] })), (((_a = variableOptions[item.key]) === null || _a === void 0 ? void 0 : _a.currency) && { currency: variableOptions[item.key].currency })));
+            else if (item.variable === "currency") {
+                return (0, format_1._formatCurrency)(__assign(__assign({ value: value, languages: languages }, (variableOptions[item.key] && { options: variableOptions[item.key] })), (((_a = variableOptions[item.key]) === null || _a === void 0 ? void 0 : _a.currency) && { currency: variableOptions[item.key].currency })));
+            }
+            else if (item.variable === "datetime") {
+                return (0, format_1._formatDateTime)(__assign({ value: value, languages: languages }, (variableOptions[item.key] && { options: variableOptions[item.key] })));
             }
-            if (item.variable === "datetime") {
-                return (0, _format_1._formatDateTime)(__assign({ value: value, languages: languages }, (variableOptions[item.key] && { options: variableOptions[item.key] })));
+            else if (item.variable === "list") {
+                return (0, format_1._formatList)(__assign({ value: value, languages: languages }, (variableOptions[item.key] && { options: variableOptions[item.key] })));
             }
             return value;
         }