@osimatic/helpers-js 1.5.28 → 1.5.30

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

@@ -1,6 +1,7 @@
 
 const Address = require('ilib/lib/Address');
 const AddressFmt = require('ilib/lib/AddressFmt');
+const { HTTPClient } = require('./http_client');
 const { toEl } = require('./util');
 const isoCountries = require('i18n-iso-countries');
 isoCountries.registerLocale(require('i18n-iso-countries/langs/en.json'));
@@ -11,16 +12,19 @@ class Country {
 	}
 
 	static getFlagPath(countryCode) {
-		return (typeof Country.flagsPath != 'undefined' ? Country.flagsPath : '/')+countryCode.toLowerCase()+'.png';
+		return typeof Country.flagsPath !== 'undefined' ? Country.flagsPath + countryCode.toLowerCase() + '.png' : null;
 	}
-	static getFlagImg(countryCode) {
-		return '<span><img src="'+Country.getFlagPath(countryCode)+'" alt="" title="'+Country.getCountryName(countryCode)+'" class="flag" /></span>'
+	static getFlagImg(countryCode, locale='fr-FR') {
+		if (typeof Country.flagsPath !== 'undefined') {
+			return '<span><img src="'+Country.getFlagPath(countryCode)+'" alt="" title="'+Country.getCountryName(countryCode, locale)+'" class="flag" /></span>';
+		}
+		return '<span class="fi fi-' + countryCode.toLowerCase() + '"></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 -', showFlags=false) {
+	static fillSelect(select, defaultValue=null, showFlags=false, countriesList=null, addNoneValue=false, noneLabel='- Aucun -', locale='fr-FR') {
 		select = toEl(select);
 		if (!select) {
 			return;
@@ -29,21 +33,49 @@ class Country {
 			if (addNoneValue) {
 				select.insertAdjacentHTML('beforeend', '<option value="">'+noneLabel+'</option>');
 			}
-			Object.entries(null != countriesList ? countriesList : Country.getCountries()).forEach(([countryCode, countryName]) => {
-				const flag = showFlags ? Country.getFlagEmoji(countryCode) + ' ' : '';
-				select.insertAdjacentHTML('beforeend', '<option value="' + countryCode + '">' + flag + 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, locale = 'en') {
-		const name = isoCountries.getName(countryCode, locale);
+
+	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 getCountryName(countryCode, locale='fr-FR') {
+		const baseLang = Locale.getBaseLang(locale);
+		Country.getCountries(locale); // ensure locale is registered
+		const name = isoCountries.getName(countryCode, baseLang);
 		return name || countryCode;
 	}
 	static getCountries(locale = 'en') {
-		return isoCountries.getNames(locale);
+		const baseLang = Locale.getBaseLang(locale);
+		let names = isoCountries.getNames(baseLang);
+		if (!names || Object.keys(names).length === 0) {
+			try {
+				isoCountries.registerLocale(require('i18n-iso-countries/langs/' + baseLang + '.json'));
+				names = isoCountries.getNames(baseLang);
+			} catch (e) {
+				// locale not available
+			}
+		}
+		return names || {};
 	}
 
 	static getContinents() {
@@ -58,10 +90,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 {
@@ -487,4 +537,35 @@ class GeographicCoordinates {
 
 }
 
-module.exports = { Country, PostalAddress, GeographicCoordinates, Polygon };
+class Locale {
+	static getBaseLang(locale) {
+		return Locale.normalize(locale).split('-')[0];
+	}
+
+	static getRegion(locale) {
+		const parts = Locale.normalize(locale).split('-');
+		return parts.length > 1 ? parts[1] : null;
+	}
+
+	static normalize(locale) {
+		// Accept both 'fr_FR' and 'fr-fr', output 'fr-FR'
+		const parts = locale.replace('_', '-').split('-');
+		const lang = parts[0].toLowerCase();
+		const region = parts[1] ? parts[1].toUpperCase() : null;
+		return region ? lang + '-' + region : lang;
+	}
+
+	static isValid(locale) {
+		return /^[a-zA-Z]{2,3}(-[a-zA-Z]{2,3})?$/.test(locale);
+	}
+
+	static toPOSIX(locale) {
+		return Locale.normalize(locale).replace('-', '_');
+	}
+
+	static update(locale) {
+		HTTPClient.setHeader('Accept-Language', Locale.normalize(locale));
+	}
+}
+
+module.exports = { Country, Locale, PostalAddress, GeographicCoordinates, Polygon };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osimatic/helpers-js",
-  "version": "1.5.28",
+  "version": "1.5.30",
   "main": "main.js",
   "scripts": {
     "test": "jest",
@@ -21,6 +21,7 @@
   },
   "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

@@ -1,4 +1,4 @@
-const { Country, PostalAddress, GeographicCoordinates, Polygon } = require('../location');
+const { Country, Locale, PostalAddress, GeographicCoordinates, Polygon } = require('../location');
 
 describe('Country', () => {
 	describe('getCountries', () => {
@@ -19,12 +19,17 @@ describe('Country', () => {
 	});
 
 	describe('getCountryName', () => {
-		test('should return country name for valid code', () => {
+		test('should return country name for valid code (default fr-FR locale)', () => {
 			expect(Country.getCountryName('FR')).toBe('France');
-			expect(Country.getCountryName('US')).toBe('United States of America');
+			expect(Country.getCountryName('US')).toBe("États-Unis d'Amérique");
 			expect(Country.getCountryName('CA')).toBe('Canada');
 		});
 
+		test('should return country name in specified locale', () => {
+			expect(Country.getCountryName('US', 'en')).toBe('United States of America');
+			expect(Country.getCountryName('DE', 'de')).toBeTruthy();
+		});
+
 		test('should return the code itself if country not found', () => {
 			expect(Country.getCountryName('XX')).toBe('XX');
 			expect(Country.getCountryName('ZZZ')).toBe('ZZZ');
@@ -42,50 +47,35 @@ describe('Country', () => {
 	});
 
 	describe('getFlagPath', () => {
-		test('should return correct flag path', () => {
-			const path = Country.getFlagPath('FR');
-			expect(path).toContain('fr.png');
-		});
-
-		test('should lowercase the country code', () => {
-			const path = Country.getFlagPath('US');
-			expect(path).toContain('us.png');
+		test('should return null when no flagsPath set', () => {
+			Country.flagsPath = undefined;
+			expect(Country.getFlagPath('FR')).toBeNull();
 		});
 
-		test('should use custom flags path when set', () => {
+		test('should return image path when flagsPath set', () => {
 			Country.setFlagsPath('/custom/flags/');
-			const path = Country.getFlagPath('FR');
-			expect(path).toBe('/custom/flags/fr.png');
-
-			// Reset for other tests
+			expect(Country.getFlagPath('FR')).toBe('/custom/flags/fr.png');
+			expect(Country.getFlagPath('US')).toBe('/custom/flags/us.png');
 			Country.flagsPath = undefined;
 		});
+	});
 
-		test('should use default path when not set', () => {
+	describe('getFlagImg', () => {
+		test('should return flag-icons span when no flagsPath set', () => {
 			Country.flagsPath = undefined;
-			const path = Country.getFlagPath('DE');
-			expect(path).toBe('/de.png');
+			const html = Country.getFlagImg('FR');
+			expect(html).toContain('<span');
+			expect(html).toContain('fi fi-fr');
 		});
-	});
 
-	describe('getFlagImg', () => {
-		test('should return HTML img tag', () => {
+		test('should return img tag when flagsPath set', () => {
+			Country.setFlagsPath('/flags/');
 			const html = Country.getFlagImg('FR');
 			expect(html).toContain('<img');
-			expect(html).toContain('src=');
 			expect(html).toContain('fr.png');
 			expect(html).toContain('class="flag"');
-		});
-
-		test('should include country name in title', () => {
-			const html = Country.getFlagImg('US');
-			expect(html).toContain('title="United States of America"');
-		});
-
-		test('should wrap img in span', () => {
-			const html = Country.getFlagImg('GB');
-			expect(html).toMatch(/^<span>/);
-			expect(html).toMatch(/<\/span>$/);
+			expect(html).toContain("title=\"France\"");
+			Country.flagsPath = undefined;
 		});
 	});
 
@@ -109,13 +99,91 @@ describe('Country', () => {
 	});
 
 	describe('getCountries with locale', () => {
-		test('should support locale parameter', () => {
-			const isoCountries = require('i18n-iso-countries');
-			isoCountries.registerLocale(require('i18n-iso-countries/langs/fr.json'));
+		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('Locale', () => {
+	describe('normalize', () => {
+		test('should canonicalize to lang-REGION format', () => {
+			expect(Locale.normalize('fr-FR')).toBe('fr-FR');
+			expect(Locale.normalize('fr-fr')).toBe('fr-FR');
+			expect(Locale.normalize('FR-fr')).toBe('fr-FR');
+			expect(Locale.normalize('fr_FR')).toBe('fr-FR');
+		});
+
+		test('should handle lang-only locales', () => {
+			expect(Locale.normalize('fr')).toBe('fr');
+			expect(Locale.normalize('EN')).toBe('en');
+		});
+	});
+
+	describe('getBaseLang', () => {
+		test('should extract base language', () => {
+			expect(Locale.getBaseLang('fr-FR')).toBe('fr');
+			expect(Locale.getBaseLang('en-US')).toBe('en');
+			expect(Locale.getBaseLang('fr_FR')).toBe('fr');
+		});
+
+		test('should return lang as-is when no region', () => {
+			expect(Locale.getBaseLang('fr')).toBe('fr');
+		});
+	});
+
+	describe('getRegion', () => {
+		test('should extract region code', () => {
+			expect(Locale.getRegion('fr-FR')).toBe('FR');
+			expect(Locale.getRegion('en-US')).toBe('US');
+			expect(Locale.getRegion('fr_FR')).toBe('FR');
+		});
+
+		test('should return null when no region', () => {
+			expect(Locale.getRegion('fr')).toBeNull();
+		});
+	});
+
+	describe('isValid', () => {
+		test('should accept valid locales', () => {
+			expect(Locale.isValid('fr')).toBe(true);
+			expect(Locale.isValid('fr-FR')).toBe(true);
+			expect(Locale.isValid('en-US')).toBe(true);
+			expect(Locale.isValid('zh-CN')).toBe(true);
+		});
+
+		test('should reject invalid locales', () => {
+			expect(Locale.isValid('foobar')).toBe(false);
+			expect(Locale.isValid('fr_FR')).toBe(false);
+			expect(Locale.isValid('')).toBe(false);
+			expect(Locale.isValid('1234')).toBe(false);
+		});
+	});
+
+	describe('toPOSIX', () => {
+		test('should convert to POSIX format', () => {
+			expect(Locale.toPOSIX('fr-FR')).toBe('fr_FR');
+			expect(Locale.toPOSIX('en-US')).toBe('en_US');
+			expect(Locale.toPOSIX('fr_FR')).toBe('fr_FR');
+		});
+
+		test('should handle lang-only locales', () => {
+			expect(Locale.toPOSIX('fr')).toBe('fr');
+		});
 	});
 });