@stndrds/constants 1.0.0-alpha.78 → 1.0.0-alpha.80

package/dist/index.d.mts

@@ -1009,6 +1009,31 @@ declare const isValidIso2: (code: string) => code is CountryIso2;
  * Type guard to check if a string is a valid ISO3 country code
  */
 declare const isValidIso3: (code: string) => code is CountryIso3;
+/**
+ * Get the display name of a country in the specified locale.
+ * Defaults to French with English as fallback.
+ * Uses Intl.DisplayNames for locale-aware names (e.g., "Italie" for "IT" in French).
+ * The Intl.DisplayNames instance is cached at module level to avoid repeated allocations.
+ *
+ * @param iso2 - ISO 3166-1 alpha-2 country code (e.g., "FR", "IT")
+ * @param locales - BCP 47 language tags in preference order (default: ['fr', 'en'])
+ */
+declare function getCountryDisplayName(iso2: string, locales?: string | string[]): string;
+/**
+ * Get the display name of a country by its ISO 3166-1 alpha-3 code.
+ * Defaults to French with English as fallback.
+ *
+ * @param iso3 - ISO 3166-1 alpha-3 country code (e.g., "FRA", "ITA")
+ * @param locales - BCP 47 language tags in preference order (default: ['fr', 'en'])
+ */
+declare function getCountryDisplayNameByIso3(iso3: string, locales?: string | string[]): string;
+/**
+ * Get all countries sorted alphabetically by their display name in the given locale.
+ * Sorted once — callers should store the result in a module-level constant.
+ *
+ * @param locale - BCP 47 language tag for sorting (default: 'fr')
+ */
+declare function getSortedCountries(locale?: string): Country[];
 /**
  * Strip the national trunk prefix from a phone number.
  * Pure string operation, no external dependencies.
@@ -1802,4 +1827,4 @@ declare const isCodeMimeType: (mimeType: string) => boolean;
  */
 declare const getExtensionFromMimeType: (mimeType: string) => string | null;
 
-export { AI_CHAT_ACCEPTED_TYPES, AI_CHAT_MAX_FILES, AI_CHAT_MAX_FILE_SIZE, AI_CHAT_SUPPORTED_DOCUMENTS, AI_CHAT_SUPPORTED_IMAGES, AI_CHAT_SUPPORTED_MIME_TYPES, ALL_MIME_TYPES, ARCHIVES, ARCHIVE_MIME_TYPES, ARCHIVE_MIME_TYPES_ARRAY, AUDIO, AUDIO_MIME_TYPES, AUDIO_MIME_TYPES_ARRAY, type ArchiveMimeType, type AudioMimeType, BYTES, CODE, CODE_MIME_TYPES, CODE_MIME_TYPES_ARRAY, COLORS, COLOR_GROUPS, COUNTRIES, CURRENCIES, type CodeMimeType, type Color, type ColorBackground, type ColorBorder, type ColorGroup, type ColorGroupColors, type ColorIcon, type ColorId, type ColorText, type Country, type CountryIso2, type CountryIso3, type CountryName, type CountryNumericCode, type CountryPhoneCode, type Currency, type CurrencyCode, type CurrencyName, type CurrencySymbol, DEFAULT_ATTRIBUTE_ICONS, DOCUMENTS, DOCUMENT_MIME_TYPES, DOCUMENT_MIME_TYPES_ARRAY, type DocumentMimeType, FILE_SIZE, FONTS, FONT_MIME_TYPES, FONT_MIME_TYPES_ARRAY, type FontMimeType, GIGABYTES, ICONS, IMAGES, IMAGE_MIME_TYPES, IMAGE_MIME_TYPES_ARRAY, type IconName, type ImageMimeType, KILOBYTES, MEDIA, MEGABYTES, type MimeType, OFFICE_DOCUMENTS, OTHER_MIME_TYPES, RECOMMENDED_MAX_SIZES, STATUS_COLORS, type StatusColorGroup, VIDEO, VIDEO_MIME_TYPES, VIDEO_MIME_TYPES_ARRAY, type VideoMimeType, WEB_IMAGES, bytesToGb, bytesToMb, formatBytes, gbToBytes, getAllColors, getAllCountries, getAllCurrencies, getColor, getColorIds, getColorsByGroup, getCountryByIso2, getCountryByIso3, getCountryPhoneCode, getCurrency, getCurrencySymbol, getDefaultAttributeIcon, getExtensionFromMimeType, getPhoneMaxDigits, getPhoneTrunkPrefix, isAIChatSupportedMimeType, isArchiveMimeType, isAudioMimeType, isCodeMimeType, isDocumentMimeType, isImageMimeType, isValidColorId, isValidCurrencyCode, isValidIso2, isValidIso3, isVideoMimeType, isWithinSizeLimit, mbToBytes, stripTrunkPrefix };
+export { AI_CHAT_ACCEPTED_TYPES, AI_CHAT_MAX_FILES, AI_CHAT_MAX_FILE_SIZE, AI_CHAT_SUPPORTED_DOCUMENTS, AI_CHAT_SUPPORTED_IMAGES, AI_CHAT_SUPPORTED_MIME_TYPES, ALL_MIME_TYPES, ARCHIVES, ARCHIVE_MIME_TYPES, ARCHIVE_MIME_TYPES_ARRAY, AUDIO, AUDIO_MIME_TYPES, AUDIO_MIME_TYPES_ARRAY, type ArchiveMimeType, type AudioMimeType, BYTES, CODE, CODE_MIME_TYPES, CODE_MIME_TYPES_ARRAY, COLORS, COLOR_GROUPS, COUNTRIES, CURRENCIES, type CodeMimeType, type Color, type ColorBackground, type ColorBorder, type ColorGroup, type ColorGroupColors, type ColorIcon, type ColorId, type ColorText, type Country, type CountryIso2, type CountryIso3, type CountryName, type CountryNumericCode, type CountryPhoneCode, type Currency, type CurrencyCode, type CurrencyName, type CurrencySymbol, DEFAULT_ATTRIBUTE_ICONS, DOCUMENTS, DOCUMENT_MIME_TYPES, DOCUMENT_MIME_TYPES_ARRAY, type DocumentMimeType, FILE_SIZE, FONTS, FONT_MIME_TYPES, FONT_MIME_TYPES_ARRAY, type FontMimeType, GIGABYTES, ICONS, IMAGES, IMAGE_MIME_TYPES, IMAGE_MIME_TYPES_ARRAY, type IconName, type ImageMimeType, KILOBYTES, MEDIA, MEGABYTES, type MimeType, OFFICE_DOCUMENTS, OTHER_MIME_TYPES, RECOMMENDED_MAX_SIZES, STATUS_COLORS, type StatusColorGroup, VIDEO, VIDEO_MIME_TYPES, VIDEO_MIME_TYPES_ARRAY, type VideoMimeType, WEB_IMAGES, bytesToGb, bytesToMb, formatBytes, gbToBytes, getAllColors, getAllCountries, getAllCurrencies, getColor, getColorIds, getColorsByGroup, getCountryByIso2, getCountryByIso3, getCountryDisplayName, getCountryDisplayNameByIso3, getCountryPhoneCode, getCurrency, getCurrencySymbol, getDefaultAttributeIcon, getExtensionFromMimeType, getPhoneMaxDigits, getPhoneTrunkPrefix, getSortedCountries, isAIChatSupportedMimeType, isArchiveMimeType, isAudioMimeType, isCodeMimeType, isDocumentMimeType, isImageMimeType, isValidColorId, isValidCurrencyCode, isValidIso2, isValidIso3, isVideoMimeType, isWithinSizeLimit, mbToBytes, stripTrunkPrefix };

package/dist/index.d.ts

@@ -1009,6 +1009,31 @@ declare const isValidIso2: (code: string) => code is CountryIso2;
  * Type guard to check if a string is a valid ISO3 country code
  */
 declare const isValidIso3: (code: string) => code is CountryIso3;
+/**
+ * Get the display name of a country in the specified locale.
+ * Defaults to French with English as fallback.
+ * Uses Intl.DisplayNames for locale-aware names (e.g., "Italie" for "IT" in French).
+ * The Intl.DisplayNames instance is cached at module level to avoid repeated allocations.
+ *
+ * @param iso2 - ISO 3166-1 alpha-2 country code (e.g., "FR", "IT")
+ * @param locales - BCP 47 language tags in preference order (default: ['fr', 'en'])
+ */
+declare function getCountryDisplayName(iso2: string, locales?: string | string[]): string;
+/**
+ * Get the display name of a country by its ISO 3166-1 alpha-3 code.
+ * Defaults to French with English as fallback.
+ *
+ * @param iso3 - ISO 3166-1 alpha-3 country code (e.g., "FRA", "ITA")
+ * @param locales - BCP 47 language tags in preference order (default: ['fr', 'en'])
+ */
+declare function getCountryDisplayNameByIso3(iso3: string, locales?: string | string[]): string;
+/**
+ * Get all countries sorted alphabetically by their display name in the given locale.
+ * Sorted once — callers should store the result in a module-level constant.
+ *
+ * @param locale - BCP 47 language tag for sorting (default: 'fr')
+ */
+declare function getSortedCountries(locale?: string): Country[];
 /**
  * Strip the national trunk prefix from a phone number.
  * Pure string operation, no external dependencies.
@@ -1802,4 +1827,4 @@ declare const isCodeMimeType: (mimeType: string) => boolean;
  */
 declare const getExtensionFromMimeType: (mimeType: string) => string | null;
 
-export { AI_CHAT_ACCEPTED_TYPES, AI_CHAT_MAX_FILES, AI_CHAT_MAX_FILE_SIZE, AI_CHAT_SUPPORTED_DOCUMENTS, AI_CHAT_SUPPORTED_IMAGES, AI_CHAT_SUPPORTED_MIME_TYPES, ALL_MIME_TYPES, ARCHIVES, ARCHIVE_MIME_TYPES, ARCHIVE_MIME_TYPES_ARRAY, AUDIO, AUDIO_MIME_TYPES, AUDIO_MIME_TYPES_ARRAY, type ArchiveMimeType, type AudioMimeType, BYTES, CODE, CODE_MIME_TYPES, CODE_MIME_TYPES_ARRAY, COLORS, COLOR_GROUPS, COUNTRIES, CURRENCIES, type CodeMimeType, type Color, type ColorBackground, type ColorBorder, type ColorGroup, type ColorGroupColors, type ColorIcon, type ColorId, type ColorText, type Country, type CountryIso2, type CountryIso3, type CountryName, type CountryNumericCode, type CountryPhoneCode, type Currency, type CurrencyCode, type CurrencyName, type CurrencySymbol, DEFAULT_ATTRIBUTE_ICONS, DOCUMENTS, DOCUMENT_MIME_TYPES, DOCUMENT_MIME_TYPES_ARRAY, type DocumentMimeType, FILE_SIZE, FONTS, FONT_MIME_TYPES, FONT_MIME_TYPES_ARRAY, type FontMimeType, GIGABYTES, ICONS, IMAGES, IMAGE_MIME_TYPES, IMAGE_MIME_TYPES_ARRAY, type IconName, type ImageMimeType, KILOBYTES, MEDIA, MEGABYTES, type MimeType, OFFICE_DOCUMENTS, OTHER_MIME_TYPES, RECOMMENDED_MAX_SIZES, STATUS_COLORS, type StatusColorGroup, VIDEO, VIDEO_MIME_TYPES, VIDEO_MIME_TYPES_ARRAY, type VideoMimeType, WEB_IMAGES, bytesToGb, bytesToMb, formatBytes, gbToBytes, getAllColors, getAllCountries, getAllCurrencies, getColor, getColorIds, getColorsByGroup, getCountryByIso2, getCountryByIso3, getCountryPhoneCode, getCurrency, getCurrencySymbol, getDefaultAttributeIcon, getExtensionFromMimeType, getPhoneMaxDigits, getPhoneTrunkPrefix, isAIChatSupportedMimeType, isArchiveMimeType, isAudioMimeType, isCodeMimeType, isDocumentMimeType, isImageMimeType, isValidColorId, isValidCurrencyCode, isValidIso2, isValidIso3, isVideoMimeType, isWithinSizeLimit, mbToBytes, stripTrunkPrefix };
+export { AI_CHAT_ACCEPTED_TYPES, AI_CHAT_MAX_FILES, AI_CHAT_MAX_FILE_SIZE, AI_CHAT_SUPPORTED_DOCUMENTS, AI_CHAT_SUPPORTED_IMAGES, AI_CHAT_SUPPORTED_MIME_TYPES, ALL_MIME_TYPES, ARCHIVES, ARCHIVE_MIME_TYPES, ARCHIVE_MIME_TYPES_ARRAY, AUDIO, AUDIO_MIME_TYPES, AUDIO_MIME_TYPES_ARRAY, type ArchiveMimeType, type AudioMimeType, BYTES, CODE, CODE_MIME_TYPES, CODE_MIME_TYPES_ARRAY, COLORS, COLOR_GROUPS, COUNTRIES, CURRENCIES, type CodeMimeType, type Color, type ColorBackground, type ColorBorder, type ColorGroup, type ColorGroupColors, type ColorIcon, type ColorId, type ColorText, type Country, type CountryIso2, type CountryIso3, type CountryName, type CountryNumericCode, type CountryPhoneCode, type Currency, type CurrencyCode, type CurrencyName, type CurrencySymbol, DEFAULT_ATTRIBUTE_ICONS, DOCUMENTS, DOCUMENT_MIME_TYPES, DOCUMENT_MIME_TYPES_ARRAY, type DocumentMimeType, FILE_SIZE, FONTS, FONT_MIME_TYPES, FONT_MIME_TYPES_ARRAY, type FontMimeType, GIGABYTES, ICONS, IMAGES, IMAGE_MIME_TYPES, IMAGE_MIME_TYPES_ARRAY, type IconName, type ImageMimeType, KILOBYTES, MEDIA, MEGABYTES, type MimeType, OFFICE_DOCUMENTS, OTHER_MIME_TYPES, RECOMMENDED_MAX_SIZES, STATUS_COLORS, type StatusColorGroup, VIDEO, VIDEO_MIME_TYPES, VIDEO_MIME_TYPES_ARRAY, type VideoMimeType, WEB_IMAGES, bytesToGb, bytesToMb, formatBytes, gbToBytes, getAllColors, getAllCountries, getAllCurrencies, getColor, getColorIds, getColorsByGroup, getCountryByIso2, getCountryByIso3, getCountryDisplayName, getCountryDisplayNameByIso3, getCountryPhoneCode, getCurrency, getCurrencySymbol, getDefaultAttributeIcon, getExtensionFromMimeType, getPhoneMaxDigits, getPhoneTrunkPrefix, getSortedCountries, isAIChatSupportedMimeType, isArchiveMimeType, isAudioMimeType, isCodeMimeType, isDocumentMimeType, isImageMimeType, isValidColorId, isValidCurrencyCode, isValidIso2, isValidIso3, isVideoMimeType, isWithinSizeLimit, mbToBytes, stripTrunkPrefix };

package/dist/index.js

@@ -77,6 +77,8 @@ __export(index_exports, {
   getColorsByGroup: () => getColorsByGroup,
   getCountryByIso2: () => getCountryByIso2,
   getCountryByIso3: () => getCountryByIso3,
+  getCountryDisplayName: () => getCountryDisplayName,
+  getCountryDisplayNameByIso3: () => getCountryDisplayNameByIso3,
   getCountryPhoneCode: () => getCountryPhoneCode,
   getCurrency: () => getCurrency,
   getCurrencySymbol: () => getCurrencySymbol,
@@ -84,6 +86,7 @@ __export(index_exports, {
   getExtensionFromMimeType: () => getExtensionFromMimeType,
   getPhoneMaxDigits: () => getPhoneMaxDigits,
   getPhoneTrunkPrefix: () => getPhoneTrunkPrefix,
+  getSortedCountries: () => getSortedCountries,
   isAIChatSupportedMimeType: () => isAIChatSupportedMimeType,
   isArchiveMimeType: () => isArchiveMimeType,
   isAudioMimeType: () => isAudioMimeType,
@@ -1277,6 +1280,46 @@ var isValidIso3 = (code) => {
     (country) => country.iso3.toUpperCase() === code.toUpperCase()
   );
 };
+var _displayNamesCache = /* @__PURE__ */ new Map();
+function _getDisplayNames(locales) {
+  const key = locales.join("\0");
+  const cached = _displayNamesCache.get(key);
+  if (cached !== void 0) return cached;
+  try {
+    const dn = new Intl.DisplayNames(locales, { type: "region" });
+    _displayNamesCache.set(key, dn);
+    return dn;
+  } catch {
+    _displayNamesCache.set(key, null);
+    return null;
+  }
+}
+function getCountryDisplayName(iso2, locales = ["fr", "en"]) {
+  const code = iso2.toUpperCase();
+  const localeList = Array.isArray(locales) ? locales : [locales];
+  const displayNames = _getDisplayNames(localeList);
+  if (displayNames) {
+    try {
+      const name = displayNames.of(code);
+      if (name) return name;
+    } catch {
+    }
+  }
+  return COUNTRIES[code]?.name ?? code;
+}
+function getCountryDisplayNameByIso3(iso3, locales) {
+  const country = getCountryByIso3(iso3);
+  if (!country) return iso3;
+  return getCountryDisplayName(country.iso2, locales);
+}
+function getSortedCountries(locale = "fr") {
+  return getAllCountries().sort(
+    (a, b) => getCountryDisplayName(a.iso2, locale).localeCompare(
+      getCountryDisplayName(b.iso2, locale),
+      locale
+    )
+  );
+}
 function stripTrunkPrefix(phoneNumber, trunkPrefix) {
   if (!trunkPrefix) return phoneNumber;
   return phoneNumber.startsWith(trunkPrefix) ? phoneNumber.slice(trunkPrefix.length) : phoneNumber;
@@ -2802,6 +2845,8 @@ var ICONS = [
   getColorsByGroup,
   getCountryByIso2,
   getCountryByIso3,
+  getCountryDisplayName,
+  getCountryDisplayNameByIso3,
   getCountryPhoneCode,
   getCurrency,
   getCurrencySymbol,
@@ -2809,6 +2854,7 @@ var ICONS = [
   getExtensionFromMimeType,
   getPhoneMaxDigits,
   getPhoneTrunkPrefix,
+  getSortedCountries,
   isAIChatSupportedMimeType,
   isArchiveMimeType,
   isAudioMimeType,

package/dist/index.mjs

@@ -1174,6 +1174,46 @@ var isValidIso3 = (code) => {
     (country) => country.iso3.toUpperCase() === code.toUpperCase()
   );
 };
+var _displayNamesCache = /* @__PURE__ */ new Map();
+function _getDisplayNames(locales) {
+  const key = locales.join("\0");
+  const cached = _displayNamesCache.get(key);
+  if (cached !== void 0) return cached;
+  try {
+    const dn = new Intl.DisplayNames(locales, { type: "region" });
+    _displayNamesCache.set(key, dn);
+    return dn;
+  } catch {
+    _displayNamesCache.set(key, null);
+    return null;
+  }
+}
+function getCountryDisplayName(iso2, locales = ["fr", "en"]) {
+  const code = iso2.toUpperCase();
+  const localeList = Array.isArray(locales) ? locales : [locales];
+  const displayNames = _getDisplayNames(localeList);
+  if (displayNames) {
+    try {
+      const name = displayNames.of(code);
+      if (name) return name;
+    } catch {
+    }
+  }
+  return COUNTRIES[code]?.name ?? code;
+}
+function getCountryDisplayNameByIso3(iso3, locales) {
+  const country = getCountryByIso3(iso3);
+  if (!country) return iso3;
+  return getCountryDisplayName(country.iso2, locales);
+}
+function getSortedCountries(locale = "fr") {
+  return getAllCountries().sort(
+    (a, b) => getCountryDisplayName(a.iso2, locale).localeCompare(
+      getCountryDisplayName(b.iso2, locale),
+      locale
+    )
+  );
+}
 function stripTrunkPrefix(phoneNumber, trunkPrefix) {
   if (!trunkPrefix) return phoneNumber;
   return phoneNumber.startsWith(trunkPrefix) ? phoneNumber.slice(trunkPrefix.length) : phoneNumber;
@@ -2698,6 +2738,8 @@ export {
   getColorsByGroup,
   getCountryByIso2,
   getCountryByIso3,
+  getCountryDisplayName,
+  getCountryDisplayNameByIso3,
   getCountryPhoneCode,
   getCurrency,
   getCurrencySymbol,
@@ -2705,6 +2747,7 @@ export {
   getExtensionFromMimeType,
   getPhoneMaxDigits,
   getPhoneTrunkPrefix,
+  getSortedCountries,
   isAIChatSupportedMimeType,
   isArchiveMimeType,
   isAudioMimeType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/constants",
-  "version": "1.0.0-alpha.78",
+  "version": "1.0.0-alpha.80",
   "description": "Currency and country data with ISO codes",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",