@osimatic/helpers-js 1.5.27 → 1.5.29

package/bank.js

@@ -15,7 +15,7 @@ class BankCard {
 		return cardNumber;
 	}
 
-	static formatExpirationDate(expirationDate, locale="fr-FR") {
+	static formatExpirationDate(expirationDate, locale='fr-FR') {
 		return SqlDateTime.getMonthName(expirationDate, locale)+' '+SqlDateTime.getYear(expirationDate);
 	}
 }

package/date_time.js

@@ -100,27 +100,27 @@ class DateTime {
 		return Math.trunc(jsDate.getTime()/1000);
 	}
 
-	static getDateDigitalDisplay(jsDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateDigitalDisplay(jsDate, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTimeFormatter.getDateDigitalFormatter(locale, timeZone).format(jsDate);
 		//return jsDate.toLocaleDateString(locale, {year: 'numeric', month: 'numeric', day: 'numeric', timeZone: timeZone}); 
 	}
 
-	static getDateTextDisplay(jsDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateTextDisplay(jsDate, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTimeFormatter.getDateTextFormatter(locale, timeZone).format(jsDate);
 		//return jsDate.toLocaleDateString(locale, {weekday: 'long', year: 'numeric', month: 'long', day: 'numeric', timeZone: timeZone});  
 	}
 
-	static getTimeDisplay(jsDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplay(jsDate, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTimeFormatter.getTimeFormatter(locale, timeZone).format(jsDate);
 		//return jsDate.toLocaleTimeString(locale, {hour: 'numeric', minute: 'numeric', timeZone: timeZone}); 
 	}
 
-	static getTimeDigitalDisplay(jsDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDigitalDisplay(jsDate, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTimeFormatter.getTimeDigitalFormatter(locale, timeZone).format(jsDate);
 		//return jsDate.toLocaleTimeString(locale, {hour: '2-digit', minute: '2-digit', second: '2-digit', timeZone: timeZone}); 
 	}
 
-	static getTimeDisplayWithNbDays(jsDate, jsPreviousDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplayWithNbDays(jsDate, jsPreviousDate, locale='fr-FR', timeZone="Europe/Paris") {
 		let str = this.getTimeDisplay(jsDate, locale, timeZone);
 		if (jsPreviousDate !== 0 && jsPreviousDate != null) {
 			let nbDaysDiff = DatePeriod.getNbDayBetweenTwo(jsPreviousDate, jsDate, false);
@@ -131,7 +131,7 @@ class DateTime {
 		return str;
 	}
 
-	static getDateTimeDigitalDisplay(jsDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateTimeDigitalDisplay(jsDate, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTimeFormatter.getDateTimeFormatter(locale, timeZone).format(jsDate);
 		//return jsDate.toLocaleDateString(locale, {year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric', timeZone: timeZone}); 
 	}
@@ -142,7 +142,7 @@ class DateTime {
 	static getMonth(jsDate) {
 		return jsDate.getUTCMonth()+1;
 	}
-	static getMonthName(jsDate, locale="fr-FR", isShort=false) {
+	static getMonthName(jsDate, locale='fr-FR', isShort=false) {
 		return jsDate.toLocaleDateString(locale, {month: (isShort?'short':'long')});
 	}
 	static getDay(jsDate) {
@@ -157,7 +157,7 @@ class DateTime {
 		return jsDate.getUTCDay();
 	}
 
-	static getDayName(jsDate, locale="fr-FR", isShort=false) {
+	static getDayName(jsDate, locale='fr-FR', isShort=false) {
 		return jsDate.toLocaleDateString(locale, {weekday: (isShort?'short':'long')});
 	}
 
@@ -165,13 +165,13 @@ class DateTime {
 		return new Date(Date.UTC(year, month, 0)).getDate();
 	}
 
-	static getMonthNameByMonth(month, locale="fr-FR", isShort=false) {
+	static getMonthNameByMonth(month, locale='fr-FR', isShort=false) {
 		let d = new Date();
 		d.setDate(1);
 		d.setMonth(month-1);
 		return this.getMonthName(d, locale, isShort);
 	}
-	static getDayNameByDayOfWeek(dayOfWeek, locale="fr-FR", isShort=false) {
+	static getDayNameByDayOfWeek(dayOfWeek, locale='fr-FR', isShort=false) {
 		let d = new Date();
 		// d.setDate(d.getDate() + (1 + 7 - d.getDay()) % 7);
 		d.setDate(d.getDate() + (dayOfWeek - d.getDay()) % 7);
@@ -375,20 +375,20 @@ class TimestampUnix {
 		return parseInt(today.getTime() / 1000);
 	}
 
-	static getDateDigitalDisplay(timestamp, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateDigitalDisplay(timestamp, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getDateDigitalDisplay(this.parse(timestamp), locale, timeZone);
 	}
-	static getDateTextDisplay(timestamp, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateTextDisplay(timestamp, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getDateTextDisplay(this.parse(timestamp), locale, timeZone);
 	}
 
-	static getTimeDisplay(timestamp, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplay(timestamp, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getTimeDisplay(this.parse(timestamp), locale, timeZone);
 	}
-	static getTimeDisplayWithNbDays(timestamp, previousTimestamp, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplayWithNbDays(timestamp, previousTimestamp, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getTimeDisplayWithNbDays(this.parse(timestamp), this.parse(previousTimestamp), locale, timeZone);
 	}
-	static getTimeDigitalDisplay(timestamp, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDigitalDisplay(timestamp, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getTimeDigitalDisplay(this.parse(timestamp), locale, timeZone);
 	}
 
@@ -477,10 +477,10 @@ class SqlDate {
 		return DateTime.getSqlDate(new Date());
 	}
 
-	static getDateDigitalDisplay(sqlDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateDigitalDisplay(sqlDate, locale='fr-FR', timeZone="Europe/Paris") {
 		return SqlDateTime.getDateDigitalDisplay(sqlDate+" 00:00:00", locale, timeZone);
 	}
-	static getDateTextDisplay(sqlDate, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateTextDisplay(sqlDate, locale='fr-FR', timeZone="Europe/Paris") {
 		return SqlDateTime.getDateTextDisplay(sqlDate+" 00:00:00", locale, timeZone);
 	}
 
@@ -498,7 +498,7 @@ class SqlDate {
 	static getMonth(sqlDate) {
 		return SqlDateTime.getMonth(sqlDate+" 00:00:00");
 	}
-	static getMonthName(sqlDate, locale="fr-FR", isShort=false) {
+	static getMonthName(sqlDate, locale='fr-FR', isShort=false) {
 		return SqlDateTime.getMonthName(sqlDate+" 00:00:00", locale, isShort);
 	}
 	static getDay(sqlDate) {
@@ -539,13 +539,13 @@ class SqlTime {
 		return DateTime.getSqlTime(new Date());
 	}
 
-	static getTimeDisplay(sqlTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplay(sqlTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return SqlDateTime.getTimeDisplay('1970-01-01 '+sqlTime, locale, timeZone);
 	}
-	static getTimeDigitalDisplay(sqlTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDigitalDisplay(sqlTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return SqlDateTime.getTimeDigitalDisplay('1970-01-01 '+sqlTime, locale, timeZone);
 	}
-	static getTimeDisplayWithNbDays(sqlTime, previousSqlTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplayWithNbDays(sqlTime, previousSqlTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return SqlDateTime.getTimeDisplayWithNbDays('1970-01-01 '+sqlTime, '1970-01-01 '+previousSqlTime, locale, timeZone);
 	}
 
@@ -588,24 +588,24 @@ class SqlDateTime {
 		return new Date(Date.UTC(sqlDateTime.substring(0, 4), sqlDateTime.substring(5, 7)-1, sqlDateTime.substring(8, 10), sqlDateTime.substring(11, 13), sqlDateTime.substring(14, 16), sqlDateTime.substring(17, 19)));
 	}
 
-	static getDateDigitalDisplay(sqlDateTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateDigitalDisplay(sqlDateTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getDateDigitalDisplay(this.parse(sqlDateTime), locale, timeZone);
 	}
-	static getDateTextDisplay(sqlDateTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateTextDisplay(sqlDateTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getDateTextDisplay(this.parse(sqlDateTime), locale, timeZone);
 	}
 
-	static getTimeDisplay(sqlDateTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplay(sqlDateTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getTimeDisplay(this.parse(sqlDateTime), locale, timeZone);
 	}
-	static getTimeDisplayWithNbDays(sqlDateTime, previousSqlDateTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDisplayWithNbDays(sqlDateTime, previousSqlDateTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getTimeDisplayWithNbDays(this.parse(sqlDateTime), this.parse(previousSqlDateTime), locale, timeZone);
 	}
-	static getTimeDigitalDisplay(sqlDateTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getTimeDigitalDisplay(sqlDateTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getTimeDigitalDisplay(this.parse(sqlDateTime), locale, timeZone);
 	}
 
-	static getDateTimeDigitalDisplay(sqlDateTime, locale="fr-FR", timeZone="Europe/Paris") {
+	static getDateTimeDigitalDisplay(sqlDateTime, locale='fr-FR', timeZone="Europe/Paris") {
 		return DateTime.getDateTimeDigitalDisplay(this.parse(sqlDateTime), locale, timeZone);
 	}
 
@@ -622,7 +622,7 @@ class SqlDateTime {
 	static getMonth(sqlDateTime) {
 		return DateTime.getMonth(this.parse(sqlDateTime));
 	}
-	static getMonthName(sqlDateTime, locale="fr-FR", isShort=false) {
+	static getMonthName(sqlDateTime, locale='fr-FR', isShort=false) {
 		return DateTime.getMonthName(this.parse(sqlDateTime), locale);
 	}
 	static getDay(sqlDateTime) {

package/location.js

@@ -2,6 +2,8 @@
 const Address = require('ilib/lib/Address');
 const AddressFmt = require('ilib/lib/AddressFmt');
 const { toEl } = require('./util');
+const isoCountries = require('i18n-iso-countries');
+isoCountries.registerLocale(require('i18n-iso-countries/langs/en.json'));
 
 class Country {
 	static setFlagsPath(flagsPath) {
@@ -14,8 +16,11 @@ class Country {
 	static getFlagImg(countryCode) {
 		return '<span><img src="'+Country.getFlagPath(countryCode)+'" alt="" title="'+Country.getCountryName(countryCode)+'" class="flag" /></span>'
 	}
+	static getFlagEmoji(countryCode) {
+		return [...countryCode.toUpperCase()].map(c => String.fromCodePoint(0x1F1E6 - 65 + c.charCodeAt(0))).join('');
+	}
 
-	static fillCountrySelect(select, defaultValue=null, countriesList=null, addNoneValue=false, noneLabel='- Aucun -') {
+	static fillSelect(select, defaultValue=null, showFlags=false, countriesList=null, addNoneValue=false, noneLabel='- Aucun -', locale='fr-FR') {
 		select = toEl(select);
 		if (!select) {
 			return;
@@ -24,265 +29,45 @@ class Country {
 			if (addNoneValue) {
 				select.insertAdjacentHTML('beforeend', '<option value="">'+noneLabel+'</option>');
 			}
-			Object.entries(null != countriesList ? countriesList : Country.getCountries()).forEach(([countryCode, countryName]) => select.insertAdjacentHTML('beforeend', '<option value="' + countryCode + '">' + countryName + '</option>'));
+			const allCountries = Country.getCountries(locale);
+			const entries = countriesList != null
+				? countriesList.map(code => [code, allCountries[code] || code])
+				: Object.entries(allCountries);
+			entries.forEach(([countryCode, countryName]) => {
+				let attrs = '';
+				if (showFlags) {
+					if (typeof Country.flagsPath !== 'undefined') {
+						attrs = ' data-thumbnail="' + Country.getFlagPath(countryCode) + '"';
+					} else {
+						attrs = ' data-content="<span class=&quot;fi fi-' + countryCode.toLowerCase() + '&quot;></span> ' + countryName + '"';
+					}
+				}
+				select.insertAdjacentHTML('beforeend', '<option value="' + countryCode + '"' + attrs + '>' + countryName + '</option>');
+			});
 		}
 		if (null != defaultValue) {
 			select.value = defaultValue;
 		}
 	}
-	static getCountryName(countryCode) {
-		if (Country.getCountries().hasOwnProperty(countryCode)) {
-			return Country.getCountries()[countryCode];
-		}
-		return countryCode;
+
+	static fillSelectWithFlags(select, defaultValue=null, countriesList=null, addNoneValue=false, noneLabel='- Aucun -', locale='fr-FR') {
+		return Country.fillSelect(select, defaultValue, true, countriesList, addNoneValue, noneLabel, locale);
 	}
-	static getCountries() {
-		return {
-			AF:'Afghanistan',
-			AX:'Åland Islands',
-			AL:'Albania',
-			DZ:'Algeria',
-			AS:'American Samoa',
-			AD:'Andorra',
-			AO:'Angola',
-			AI:'Anguilla',
-			AQ:'Antarctica',
-			AG:'Antigua and Barbuda',
-			AR:'Argentina',
-			AM:'Armenia',
-			AW:'Aruba',
-			AU:'Australia',
-			AT:'Austria',
-			AZ:'Azerbaijan',
-			BS:'Bahamas',
-			BH:'Bahrain',
-			BD:'Bangladesh',
-			BB:'Barbados',
-			BY:'Belarus',
-			BE:'Belgium',
-			BZ:'Belize',
-			BJ:'Benin',
-			BM:'Bermuda',
-			BT:'Bhutan',
-			BO:'Bolivia',
-			BA:'Bosnia and Herzegovina',
-			BW:'Botswana',
-			BV:'Bouvet Island',
-			BR:'Brazil',
-			IO:'British Indian Ocean Territory',
-			BN:'Brunei Darussalam',
-			BG:'Bulgaria',
-			BF:'Burkina Faso',
-			BI:'Burundi',
-			KH:'Cambodia',
-			CM:'Cameroon',
-			CA:'Canada',
-			CV:'Cape Verde',
-			KY:'Cayman Islands',
-			CF:'Central African Republic',
-			TD:'Chad',
-			CL:'Chile',
-			CN:'China',
-			CX:'Christmas Island',
-			CC:'Cocos (Keeling) Islands',
-			CO:'Colombia',
-			KM:'Comoros',
-			CG:'Congo',
-			CD:'Congo, The Democratic Republic of The',
-			CK:'Cook Islands',
-			CR:'Costa Rica',
-			CI:'Cote d’Ivoire',
-			HR:'Croatia',
-			CU:'Cuba',
-			CY:'Cyprus',
-			CZ:'Czechia',
-			DK:'Denmark',
-			DJ:'Djibouti',
-			DM:'Dominica',
-			DO:'Dominican Republic',
-			EC:'Ecuador',
-			EG:'Egypt',
-			SV:'El Salvador',
-			GQ:'Equatorial Guinea',
-			ER:'Eritrea',
-			EE:'Estonia',
-			ET:'Ethiopia',
-			FK:'Falkland Islands (Malvinas)',
-			FO:'Faroe Islands',
-			FJ:'Fiji',
-			FI:'Finland',
-			FR:'France',
-			GF:'French Guiana',
-			PF:'French Polynesia',
-			TF:'French Southern Territories',
-			GA:'Gabon',
-			GM:'Gambia',
-			GE:'Georgia',
-			DE:'Germany',
-			GH:'Ghana',
-			GI:'Gibraltar',
-			GR:'Greece',
-			GL:'Greenland',
-			GD:'Grenada',
-			GP:'Guadeloupe',
-			GU:'Guam',
-			GT:'Guatemala',
-			GG:'Guernsey',
-			GN:'Guinea',
-			GW:'Guinea-bissau',
-			GY:'Guyana',
-			HT:'Haiti',
-			HM:'Heard Island and Mcdonald Islands',
-			VA:'Holy See (Vatican City State)',
-			HN:'Honduras',
-			HK:'Hong Kong',
-			HU:'Hungary',
-			IS:'Iceland',
-			IN:'India',
-			ID:'Indonesia',
-			IR:'Iran, Islamic Republic of',
-			IQ:'Iraq',
-			IE:'Ireland',
-			IM:'Isle of Man',
-			IL:'Israel',
-			IT:'Italy',
-			JM:'Jamaica',
-			JP:'Japan',
-			JE:'Jersey',
-			JO:'Jordan',
-			KZ:'Kazakhstan',
-			KE:'Kenya',
-			KI:'Kiribati',
-			KP:'Korea, Democratic People’s Republic of',
-			KR:'Korea, Republic of',
-			KW:'Kuwait',
-			KG:'Kyrgyzstan',
-			LA:'Lao People’s Democratic Republic',
-			LV:'Latvia',
-			LB:'Lebanon',
-			LS:'Lesotho',
-			LR:'Liberia',
-			LY:'Libyan Arab Jamahiriya',
-			LI:'Liechtenstein',
-			LT:'Lithuania',
-			LU:'Luxembourg',
-			MO:'Macao',
-			MK:'Macedonia, The Former Yugoslav Republic of',
-			MG:'Madagascar',
-			MW:'Malawi',
-			MY:'Malaysia',
-			MV:'Maldives',
-			ML:'Mali',
-			MT:'Malta',
-			MH:'Marshall Islands',
-			MQ:'Martinique',
-			MR:'Mauritania',
-			MU:'Mauritius',
-			YT:'Mayotte',
-			MX:'Mexico',
-			FM:'Micronesia, Federated States of',
-			MD:'Moldova, Republic of',
-			MC:'Monaco',
-			MN:'Mongolia',
-			ME:'Montenegro',
-			MS:'Montserrat',
-			MA:'Morocco',
-			MZ:'Mozambique',
-			MM:'Myanmar',
-			NA:'Namibia',
-			NR:'Nauru',
-			NP:'Nepal',
-			NL:'Netherlands',
-			AN:'Netherlands Antilles',
-			NC:'New Caledonia',
-			NZ:'New Zealand',
-			NI:'Nicaragua',
-			NE:'Niger',
-			NG:'Nigeria',
-			NU:'Niue',
-			NF:'Norfolk Island',
-			MP:'Northern Mariana Islands',
-			NO:'Norway',
-			OM:'Oman',
-			PK:'Pakistan',
-			PW:'Palau',
-			PS:'Palestinian Territory, Occupied',
-			PA:'Panama',
-			PG:'Papua New Guinea',
-			PY:'Paraguay',
-			PE:'Peru',
-			PH:'Philippines',
-			PN:'Pitcairn',
-			PL:'Poland',
-			PT:'Portugal',
-			PR:'Puerto Rico',
-			QA:'Qatar',
-			RE:'Reunion',
-			RO:'Romania',
-			RU:'Russian Federation',
-			RW:'Rwanda',
-			SH:'Saint Helena',
-			KN:'Saint Kitts and Nevis',
-			LC:'Saint Lucia',
-			PM:'Saint Pierre and Miquelon',
-			VC:'Saint Vincent and The Grenadines',
-			WS:'Samoa',
-			SM:'San Marino',
-			ST:'Sao Tome and Principe',
-			SA:'Saudi Arabia',
-			SN:'Senegal',
-			RS:'Serbia',
-			SC:'Seychelles',
-			SL:'Sierra Leone',
-			SG:'Singapore',
-			SK:'Slovakia',
-			SI:'Slovenia',
-			SB:'Solomon Islands',
-			SO:'Somalia',
-			ZA:'South Africa',
-			GS:'South Georgia and The South Sandwich Islands',
-			ES:'Spain',
-			LK:'Sri Lanka',
-			SD:'Sudan',
-			SR:'Suriname',
-			SJ:'Svalbard and Jan Mayen',
-			SZ:'Swaziland',
-			SE:'Sweden',
-			CH:'Switzerland',
-			SY:'Syrian Arab Republic',
-			TW:'Taiwan, Province of China',
-			TJ:'Tajikistan',
-			TZ:'Tanzania, United Republic of',
-			TH:'Thailand',
-			TL:'Timor-leste',
-			TG:'Togo',
-			TK:'Tokelau',
-			TO:'Tonga',
-			TT:'Trinidad and Tobago',
-			TN:'Tunisia',
-			TR:'Turkey',
-			TM:'Turkmenistan',
-			TC:'Turks and Caicos Islands',
-			TV:'Tuvalu',
-			UG:'Uganda',
-			UA:'Ukraine',
-			AE:'United Arab Emirates',
-			GB:'United Kingdom',
-			US:'United States',
-			UM:'United States Minor Outlying Islands',
-			UY:'Uruguay',
-			UZ:'Uzbekistan',
-			VU:'Vanuatu',
-			VE:'Venezuela',
-			VN:'Viet Nam',
-			VG:'Virgin Islands, British',
-			VI:'Virgin Islands, U.S.',
-			WF:'Wallis and Futuna',
-			EH:'Western Sahara',
-			YE:'Yemen',
-			ZM:'Zambia',
-			ZW:'Zimbabwe',
-		};
+
+	static getCountryName(countryCode, locale='fr-FR') {
+		const name = isoCountries.getName(countryCode, locale);
+		return name || countryCode;
+	}
+	static getCountries(locale = 'en') {
+		const names = isoCountries.getNames(locale);
+		if (!names || Object.keys(names).length === 0) {
+			try {
+				isoCountries.registerLocale(require('i18n-iso-countries/langs/' + locale + '.json'));
+			} catch (e) {
+				// locale not available
+			}
+		}
+		return isoCountries.getNames(locale);
 	}
 
 	static getContinents() {
@@ -297,10 +82,28 @@ class Country {
 		};
 	}
 
-	/** @deprecated **/
+	/** @deprecated Use getCountries instead **/
 	static getCountryList() {
 		return Country.getCountries();
 	}
+	/** @deprecated Use fillSelect instead **/
+	static fillCountrySelect(select, defaultValue=null, countriesList=null, addNoneValue=false, noneLabel='- Aucun -') {
+		select = toEl(select);
+		if (!select) {
+			return;
+		}
+		if (select.children.length === 0) {
+			if (addNoneValue) {
+				select.insertAdjacentHTML('beforeend', '<option value="">'+noneLabel+'</option>');
+			}
+			Object.entries(null != countriesList ? countriesList : Country.getCountries()).forEach(([countryCode, countryName]) => {
+				select.insertAdjacentHTML('beforeend', '<option value="' + countryCode + '">' + countryName + '</option>');
+			});
+		}
+		if (null != defaultValue) {
+			select.value = defaultValue;
+		}
+	}
 }
 
 class PostalAddress {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osimatic/helpers-js",
-  "version": "1.5.27",
+  "version": "1.5.29",
   "main": "main.js",
   "scripts": {
     "test": "jest",
@@ -14,12 +14,14 @@
   "description": "",
   "dependencies": {
     "deepmerge": "^4.3.1",
+    "i18n-iso-countries": "^7.14.0",
     "ilib": "^14.21",
     "libphonenumber-js": "^1.12.39",
     "ua-parser-js": "^2.0.9"
   },
   "peerDependencies": {
     "datatables.net": ">=2.0",
+    "flag-icons": ">=7.0",
     "intl-tel-input": ">=19.0",
     "leaflet": ">=1.9",
     "leaflet-draw": ">=1.0",

package/tests/location.test.js

@@ -13,7 +13,7 @@ describe('Country', () => {
 		test('should have correct country names', () => {
 			const countries = Country.getCountries();
 			expect(countries.FR).toBe('France');
-			expect(countries.US).toBe('United States');
+			expect(countries.US).toBe('United States of America');
 			expect(countries.GB).toBe('United Kingdom');
 		});
 	});
@@ -21,7 +21,7 @@ describe('Country', () => {
 	describe('getCountryName', () => {
 		test('should return country name for valid code', () => {
 			expect(Country.getCountryName('FR')).toBe('France');
-			expect(Country.getCountryName('US')).toBe('United States');
+			expect(Country.getCountryName('US')).toBe('United States of America');
 			expect(Country.getCountryName('CA')).toBe('Canada');
 		});
 
@@ -79,7 +79,7 @@ describe('Country', () => {
 
 		test('should include country name in title', () => {
 			const html = Country.getFlagImg('US');
-			expect(html).toContain('title="United States"');
+			expect(html).toContain('title="United States of America"');
 		});
 
 		test('should wrap img in span', () => {
@@ -96,6 +96,37 @@ describe('Country', () => {
 			expect(list).toEqual(countries);
 		});
 	});
+
+	describe('getFlagEmoji', () => {
+		test('should return emoji flag for country code', () => {
+			expect(Country.getFlagEmoji('FR')).toBe('🇫🇷');
+			expect(Country.getFlagEmoji('US')).toBe('🇺🇸');
+			expect(Country.getFlagEmoji('GB')).toBe('🇬🇧');
+		});
+		test('should handle lowercase country codes', () => {
+			expect(Country.getFlagEmoji('fr')).toBe('🇫🇷');
+		});
+	});
+
+	describe('getCountries with locale', () => {
+		test('should auto-register and return names for an unregistered locale', () => {
+			const countriesFr = Country.getCountries('fr');
+			expect(typeof countriesFr).toBe('object');
+			expect(countriesFr.FR).toBe('France');
+			expect(typeof countriesFr.US).toBe('string');
+		});
+
+		test('should return names for de locale', () => {
+			const countriesDe = Country.getCountries('de');
+			expect(typeof countriesDe).toBe('object');
+			expect(countriesDe.DE).toBeTruthy();
+		});
+
+		test('should return empty object for unknown locale', () => {
+			const result = Country.getCountries('xx');
+			expect(typeof result).toBe('object');
+		});
+	});
 });
 
 describe('GeographicCoordinates', () => {
@@ -717,11 +748,21 @@ describe('PostalAddress', () => {
 			expect(result.indexOf('75001')).toBeLessThan(result.indexOf('Paris'));
 		});
 
-		test('should place postalCode before locality for FR (locale parameter)', () => {
+		test('should place postalCode before locality for FR (locale parameter, no countryCode)', () => {
+			const result = PostalAddress.format({
+				streetAddress: '10 Rue de la Paix',
+				postalCode: '75001',
+				locality: 'Paris',
+			}, '\n', 'fr-FR');
+			expect(result.indexOf('75001')).toBeLessThan(result.indexOf('Paris'));
+		});
+
+		test('should place postalCode before locality for FR (locale parameter and countryCode)', () => {
 			const result = PostalAddress.format({
 				streetAddress: '10 Rue de la Paix',
 				postalCode: '75001',
 				locality: 'Paris',
+				countryCode: 'FR',
 			}, '\n', 'fr-FR');
 			expect(result.indexOf('75001')).toBeLessThan(result.indexOf('Paris'));
 		});