generaltranslation 2.0.65 → 2.0.66

package/dist/codes/determineLanguage.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/codes/determineLanguage.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = _determineLanguage;
+var codes_1 = require("./codes");
+/**
+ * Given a list of language and a list of approved language, sorted in preference order
+ * Determines which language of the given languages is the best match in the approvedLanguages, prioritizing exact matches and falling back to dialects of the same language
+* @internal
+*/
+function _determineLanguage(languages, approvedLanguages) {
+    if (typeof languages === 'string')
+        languages = [languages];
+    if (!approvedLanguages)
+        return languages[0];
+    var _loop_1 = function (language) {
+        var exactMatch = approvedLanguages.find(function (approvedLanguage) { return approvedLanguage === language; });
+        if (exactMatch)
+            return { value: exactMatch };
+        var sameLanguage = approvedLanguages.find(function (approvedLanguage) { return (0, codes_1._isSameLanguage)(approvedLanguage, language); });
+        if (sameLanguage)
+            return { value: sameLanguage };
+    };
+    for (var _i = 0, languages_1 = languages; _i < languages_1.length; _i++) {
+        var language = languages_1[_i];
+        var state_1 = _loop_1(language);
+        if (typeof state_1 === "object")
+            return state_1.value;
+    }
+    return undefined;
+}

package/dist/index.d.ts

@@ -200,3 +200,22 @@ export declare function splitStringToContent(string: string): Content;
 export declare function renderContentToString<V extends Record<string, any>>(content: Content, languages?: string | string[], variables?: V, variableOptions?: {
     [key in keyof V]?: Intl.NumberFormatOptions | Intl.DateTimeFormatOptions;
 }): string;
+/**
+ * Determines the best matching language from the approved languages list based on a provided
+ * list of preferred languages. The function prioritizes exact matches, but will also consider
+ * dialects of the same language if an exact match is not available.
+ *
+ * It also respects the order of preference in both the provided languages list and the
+ * approved languages list. A dialect match of a higher-preference language is considered better
+ * than an exact match of a lower-preference language.
+ *
+ * For example, if the `languages` list is ['en', 'fr'], and the `approvedLanguages` list is
+ * ['fr', 'en-GB'], it will prefer 'en-GB' over 'fr', even though 'fr' has an exact
+ * dialect match, because 'en' appears earlier in the `languages` list.
+ *
+ * @param {string | string[]} languages - A single language or an array of languages sorted in preference order.
+ * @param {string[]} approvedLanguages - An array of approved languages, also sorted by preference.
+ *
+ * @returns {string | undefined} - The best matching language from the approvedLanguages list, or undefined if no match is found.
+ */
+export declare function determineLanguage(languages: string | string[], approvedLanguages: string[]): string | undefined;

package/dist/index.js

@@ -62,6 +62,7 @@ exports.formatDateTime = formatDateTime;
 exports.formatCurrency = formatCurrency;
 exports.splitStringToContent = splitStringToContent;
 exports.renderContentToString = renderContentToString;
+exports.determineLanguage = determineLanguage;
 // ----- IMPORTS ----- //
 var codes_1 = require("./codes/codes");
 var getLanguageDirection_1 = __importDefault(require("./codes/getLanguageDirection"));
@@ -71,6 +72,7 @@ var _translateReact_1 = __importDefault(require("./translation/react/_translateR
 var _updateProjectDictionary_1 = __importDefault(require("./translation/dictionaries/_updateProjectDictionary"));
 var _format_1 = require("./formatting/_format");
 var _string_content_1 = require("./formatting/_string_content");
+var determineLanguage_1 = __importDefault(require("./codes/determineLanguage"));
 // ----- CORE CLASS ----- // 
 var getDefaultFromEnv = function (VARIABLE) {
     if (typeof process !== 'undefined' && process.env) {
@@ -278,3 +280,24 @@ function splitStringToContent(string) {
 function renderContentToString(content, languages, variables, variableOptions) {
     return (0, _string_content_1._renderContentToString)(content, languages, variables, variableOptions);
 }
+/**
+ * Determines the best matching language from the approved languages list based on a provided
+ * list of preferred languages. The function prioritizes exact matches, but will also consider
+ * dialects of the same language if an exact match is not available.
+ *
+ * It also respects the order of preference in both the provided languages list and the
+ * approved languages list. A dialect match of a higher-preference language is considered better
+ * than an exact match of a lower-preference language.
+ *
+ * For example, if the `languages` list is ['en', 'fr'], and the `approvedLanguages` list is
+ * ['fr', 'en-GB'], it will prefer 'en-GB' over 'fr', even though 'fr' has an exact
+ * dialect match, because 'en' appears earlier in the `languages` list.
+ *
+ * @param {string | string[]} languages - A single language or an array of languages sorted in preference order.
+ * @param {string[]} approvedLanguages - An array of approved languages, also sorted by preference.
+ *
+ * @returns {string | undefined} - The best matching language from the approvedLanguages list, or undefined if no match is found.
+ */
+function determineLanguage(languages, approvedLanguages) {
+    return (0, determineLanguage_1.default)(languages, approvedLanguages);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generaltranslation",
-  "version": "2.0.65",
+  "version": "2.0.66",
   "description": "A language toolkit for AI developers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",