flags

src/flags.ts

@@ -0,0 +1,21 @@
+import { Locale } from './types'
+
+function toEmoji(name: string) {
+	return String.fromCodePoint(...Array.from(name).map((k) => k.charCodeAt(0) + 127365))
+}
+
+/**
+ * Some language codes do not have a clear country code and should be indicated here
+ *
+ * https://emojipedia.org/flags
+ */
+export const flagCodeExceptions: Record<string, string> = { en: '🇬🇧' }
+
+export function localeFlags(locale: Locale) {
+	const parts = locale
+		.toLowerCase()
+		.split('-', 3)
+		.slice(0, 2)
+		.map((code) => flagCodeExceptions[code] || toEmoji(code))
+	return parts[0] === parts[1] ? [parts[0]] : parts
+}

src/index.ts

@@ -34,6 +34,7 @@ export {
 	url2specs
 } from './server/index'
 export { FileDB, MemDB, type MemDBDictionary, type MemDBDictionaryEntry } from './db/index'
+export { localeFlags, flagCodeExceptions } from './flags'
 
 declare global {
 	interface Set<T> {

test/specifics.test.ts

@@ -8,7 +8,9 @@ import {
 	Translator,
 	bulkDictionary,
 	bulkObject,
-	reports
+	reports,
+	localeFlags,
+	flagCodeExceptions
 } from '../src/index'
 import { localStack } from './utils'
 
@@ -18,6 +20,17 @@ reports.missing = ({ key }: TContext, fallback?: string) => {
 	return fallback ?? '[no]'
 }
 
+test('flags', async () => {
+	expect(localeFlags('en')).toEqual(['🇬🇧'])
+	expect(localeFlags('en-GB')).toEqual(['🇬🇧'])
+	expect(localeFlags('en-US-gb')).toEqual(['🇬🇧', '🇺🇸'])
+	flagCodeExceptions.en = '🏴󠁧󠁢󠁥󠁮󠁧󠁿'
+	expect(localeFlags('en-GB')).toEqual(['🏴󠁧󠁢󠁥󠁮󠁧󠁿', '🇬🇧'])
+	expect(localeFlags('fr')).toEqual(['🇫🇷'])
+	expect(localeFlags('fr-FR')).toEqual(['🇫🇷'])
+	expect(localeFlags('fr-BE')).toEqual(['🇫🇷', '🇧🇪'])
+})
+
 describe('bulk', () => {
 	let T: Translator, client: I18nClient
 	const expected = {