@trackunit/shared-utils 1.15.57 → 1.15.59

package/index.cjs.js

@@ -426,6 +426,28 @@ searchTerm) => {
         .every(term => filterableProps(asset).some(value => value.toLowerCase().includes(term.toLowerCase()))));
 };
 
+/**
+ * Resolve a country code to its localized, user-friendly country name.
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code, e.g. "DK". Matching is case-insensitive: the code is normalized to upper-case before lookup.
+ * @param languages - Preferred display languages, typically `i18n.languages` (may be undefined before i18next is ready).
+ * @returns {string} The localized country name, or the original code when it cannot be resolved.
+ */
+const getCountryName = (countryCode, languages) => {
+    if (!countryCode) {
+        return countryCode;
+    }
+    try {
+        const locales = languages && languages.length > 0 ? [...languages] : undefined;
+        const regionNames = new Intl.DisplayNames(locales, { type: "region", fallback: "none" });
+        return regionNames.of(countryCode.toUpperCase()) ?? countryCode;
+    }
+    catch {
+        // `of` throws a RangeError for structurally invalid codes — keep the raw value.
+        return countryCode;
+    }
+};
+
 /**
  * Group an array of items by a key.
  *
@@ -1603,6 +1625,7 @@ exports.formatSiDistance = formatSiDistance;
 exports.formatUsCustomaryDistance = formatUsCustomaryDistance;
 exports.fuzzySearch = fuzzySearch;
 exports.getAllColors = getAllColors;
+exports.getCountryName = getCountryName;
 exports.getDifferenceBetweenDates = getDifferenceBetweenDates;
 exports.getEndOfDay = getEndOfDay;
 exports.getFirstLevelObjectPropertyDifferences = getFirstLevelObjectPropertyDifferences;

package/index.esm.js

@@ -424,6 +424,28 @@ searchTerm) => {
         .every(term => filterableProps(asset).some(value => value.toLowerCase().includes(term.toLowerCase()))));
 };
 
+/**
+ * Resolve a country code to its localized, user-friendly country name.
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code, e.g. "DK". Matching is case-insensitive: the code is normalized to upper-case before lookup.
+ * @param languages - Preferred display languages, typically `i18n.languages` (may be undefined before i18next is ready).
+ * @returns {string} The localized country name, or the original code when it cannot be resolved.
+ */
+const getCountryName = (countryCode, languages) => {
+    if (!countryCode) {
+        return countryCode;
+    }
+    try {
+        const locales = languages && languages.length > 0 ? [...languages] : undefined;
+        const regionNames = new Intl.DisplayNames(locales, { type: "region", fallback: "none" });
+        return regionNames.of(countryCode.toUpperCase()) ?? countryCode;
+    }
+    catch {
+        // `of` throws a RangeError for structurally invalid codes — keep the raw value.
+        return countryCode;
+    }
+};
+
 /**
  * Group an array of items by a key.
  *
@@ -1567,4 +1589,4 @@ const formatUsCustomaryDistance = (value) => {
     }
 };
 
-export { DateTimeFormat, HoursAndMinutesFormat, UnitsOfMeasurementSI, UnitsOfMeasurementUSCustomary, VISIBLE_ONLY_COLUMN_VISIBILITY_KEY, align, alphabeticallySort, arrayLengthCompare, arrayNotEmpty, booleanCompare, calculateImageScaleRatio, capitalize, colorsFromStyleDeclaration, convertBlobToBase64, convertMetersToKilometers, convertMetersToYards, convertYardsToMeters, convertYardsToMiles, dateCompare, deleteUndefinedKeys, difference, doNothing, enumFromValue, enumFromValueTypesafe, enumOrUndefinedFromValue, exhaustiveCheck, fetchImageAsBase64, filterByMultiple, formatAddress, formatCoordinates, formatSiDistance, formatUsCustomaryDistance, fuzzySearch, getAllColors, getDifferenceBetweenDates, getEndOfDay, getFirstLevelObjectPropertyDifferences, getISOStringFromDate, getLoremIpsum, getMimeTypeFromDataURL, getResizedDimensions, getStartOfDay, groupBy, groupTinyDataToOthers, hourIntervals, intersection, isArrayEqual, isSortByProperty, isSorted, isUUID, isValidImage, loadSVGDimensions, nonNullable, numberCompare, numberCompareUnknownAfterHighest, objNotEmpty, objectEntries, objectFromEntries, objectKeys, objectValues, parseTailwindArbitraryValue, pick, preload, removeLeftPadding, removeProperties, removeProperty, replaceNullableNumbersWithZero, resizeBlob, resizeImage, rgb2hex, size, stringCompare, stringCompareFromKey, stringNaturalCompare, stripHiddenCharacters, svgToPNG, titleCase, toID, toIDs, toPNG, toUUID, trimIds, trimPath, truthy, unionArraysByKey, uuidv3, uuidv4, uuidv5 };
+export { DateTimeFormat, HoursAndMinutesFormat, UnitsOfMeasurementSI, UnitsOfMeasurementUSCustomary, VISIBLE_ONLY_COLUMN_VISIBILITY_KEY, align, alphabeticallySort, arrayLengthCompare, arrayNotEmpty, booleanCompare, calculateImageScaleRatio, capitalize, colorsFromStyleDeclaration, convertBlobToBase64, convertMetersToKilometers, convertMetersToYards, convertYardsToMeters, convertYardsToMiles, dateCompare, deleteUndefinedKeys, difference, doNothing, enumFromValue, enumFromValueTypesafe, enumOrUndefinedFromValue, exhaustiveCheck, fetchImageAsBase64, filterByMultiple, formatAddress, formatCoordinates, formatSiDistance, formatUsCustomaryDistance, fuzzySearch, getAllColors, getCountryName, getDifferenceBetweenDates, getEndOfDay, getFirstLevelObjectPropertyDifferences, getISOStringFromDate, getLoremIpsum, getMimeTypeFromDataURL, getResizedDimensions, getStartOfDay, groupBy, groupTinyDataToOthers, hourIntervals, intersection, isArrayEqual, isSortByProperty, isSorted, isUUID, isValidImage, loadSVGDimensions, nonNullable, numberCompare, numberCompareUnknownAfterHighest, objNotEmpty, objectEntries, objectFromEntries, objectKeys, objectValues, parseTailwindArbitraryValue, pick, preload, removeLeftPadding, removeProperties, removeProperty, replaceNullableNumbersWithZero, resizeBlob, resizeImage, rgb2hex, size, stringCompare, stringCompareFromKey, stringNaturalCompare, stripHiddenCharacters, svgToPNG, titleCase, toID, toIDs, toPNG, toUUID, trimIds, trimPath, truthy, unionArraysByKey, uuidv3, uuidv4, uuidv5 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/shared-utils",
-  "version": "1.15.57",
+  "version": "1.15.59",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
     "node": ">=24.x"

package/src/getCountryName.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve a country code to its localized, user-friendly country name.
+ *
+ * @param countryCode - ISO 3166-1 alpha-2 country code, e.g. "DK". Matching is case-insensitive: the code is normalized to upper-case before lookup.
+ * @param languages - Preferred display languages, typically `i18n.languages` (may be undefined before i18next is ready).
+ * @returns {string} The localized country name, or the original code when it cannot be resolved.
+ */
+export declare const getCountryName: (countryCode: string, languages: ReadonlyArray<string> | undefined) => string;

package/src/index.d.ts

@@ -12,6 +12,7 @@ export * from "./enumUtils";
 export * from "./exhaustiveCheck";
 export * from "./fastArrayOperations";
 export * from "./filter";
+export * from "./getCountryName";
 export * from "./groupBy/groupBy";
 export * from "./GroupingUtility";
 export * from "./idUtils";