hanzio 2.2.0 → 3.1.0

package/src/iso/countries.ts

@@ -0,0 +1,272 @@
+/** ISO 3166-1 alpha-2 codes with English short names. */
+export const countryNames = {
+	AD: 'Andorra',
+	AE: 'United Arab Emirates',
+	AF: 'Afghanistan',
+	AG: 'Antigua and Barbuda',
+	AI: 'Anguilla',
+	AL: 'Albania',
+	AM: 'Armenia',
+	AO: 'Angola',
+	AQ: 'Antarctica',
+	AR: 'Argentina',
+	AS: 'American Samoa',
+	AT: 'Austria',
+	AU: 'Australia',
+	AW: 'Aruba',
+	AX: 'Aland Islands',
+	AZ: 'Azerbaijan',
+	BA: 'Bosnia and Herzegovina',
+	BB: 'Barbados',
+	BD: 'Bangladesh',
+	BE: 'Belgium',
+	BF: 'Burkina Faso',
+	BG: 'Bulgaria',
+	BH: 'Bahrain',
+	BI: 'Burundi',
+	BJ: 'Benin',
+	BL: 'Saint Barthelemy',
+	BM: 'Bermuda',
+	BN: 'Brunei Darussalam',
+	BO: 'Bolivia',
+	BQ: 'Bonaire, Sint Eustatius and Saba',
+	BR: 'Brazil',
+	BS: 'Bahamas',
+	BT: 'Bhutan',
+	BV: 'Bouvet Island',
+	BW: 'Botswana',
+	BY: 'Belarus',
+	BZ: 'Belize',
+	CA: 'Canada',
+	CC: 'Cocos (Keeling) Islands',
+	CD: 'Congo, (Kinshasa)',
+	CF: 'Central African Republic',
+	CG: 'Congo (Brazzaville)',
+	CH: 'Switzerland',
+	CI: 'Ivory Coast',
+	CK: 'Cook Islands',
+	CL: 'Chile',
+	CM: 'Cameroon',
+	CN: 'China',
+	CO: 'Colombia',
+	CR: 'Costa Rica',
+	CU: 'Cuba',
+	CV: 'Cape Verde',
+	CW: 'Curaçao',
+	CX: 'Christmas Island',
+	CY: 'Cyprus',
+	CZ: 'Czech Republic',
+	DE: 'Germany',
+	DJ: 'Djibouti',
+	DK: 'Denmark',
+	DM: 'Dominica',
+	DO: 'Dominican Republic',
+	DZ: 'Algeria',
+	EC: 'Ecuador',
+	EE: 'Estonia',
+	EG: 'Egypt',
+	EH: 'Western Sahara',
+	ER: 'Eritrea',
+	ES: 'Spain',
+	ET: 'Ethiopia',
+	FI: 'Finland',
+	FJ: 'Fiji',
+	FK: 'Falkland Islands (Malvinas)',
+	FM: 'Micronesia, Federated States of',
+	FO: 'Faroe Islands',
+	FR: 'France',
+	GA: 'Gabon',
+	GB: 'United Kingdom',
+	GD: 'Grenada',
+	GE: 'Georgia',
+	GF: 'French Guiana',
+	GG: 'Guernsey',
+	GH: 'Ghana',
+	GI: 'Gibraltar',
+	GL: 'Greenland',
+	GM: 'Gambia',
+	GN: 'Guinea',
+	GP: 'Guadeloupe',
+	GQ: 'Equatorial Guinea',
+	GR: 'Greece',
+	GS: 'South Georgia and the South Sandwich Islands',
+	GT: 'Guatemala',
+	GU: 'Guam',
+	GW: 'Guinea-Bissau',
+	GY: 'Guyana',
+	HK: 'Hong Kong, SAR China',
+	HM: 'Heard and Mcdonald Islands',
+	HN: 'Honduras',
+	HR: 'Croatia',
+	HT: 'Haiti',
+	HU: 'Hungary',
+	ID: 'Indonesia',
+	IE: 'Ireland',
+	IL: 'Israel',
+	IM: 'Isle of Man',
+	IN: 'India',
+	IO: 'British Indian Ocean Territory',
+	IQ: 'Iraq',
+	IR: 'Iran, Islamic Republic of',
+	IS: 'Iceland',
+	IT: 'Italy',
+	JE: 'Jersey',
+	JM: 'Jamaica',
+	JO: 'Jordan',
+	JP: 'Japan',
+	KE: 'Kenya',
+	KG: 'Kyrgyzstan',
+	KH: 'Cambodia',
+	KI: 'Kiribati',
+	KM: 'Comoros',
+	KN: 'Saint Kitts and Nevis',
+	KP: 'North Korea',
+	KR: 'South Korea',
+	KW: 'Kuwait',
+	KY: 'Cayman Islands',
+	KZ: 'Kazakhstan',
+	LA: 'Lao PDR',
+	LB: 'Lebanon',
+	LC: 'Saint Lucia',
+	LI: 'Liechtenstein',
+	LK: 'Sri Lanka',
+	LR: 'Liberia',
+	LS: 'Lesotho',
+	LT: 'Lithuania',
+	LU: 'Luxembourg',
+	LV: 'Latvia',
+	LY: 'Libya',
+	MA: 'Morocco',
+	MC: 'Monaco',
+	MD: 'Moldova',
+	ME: 'Montenegro',
+	MF: 'Saint-Martin (French part)',
+	MG: 'Madagascar',
+	MH: 'Marshall Islands',
+	MK: 'Macedonia, Republic of',
+	ML: 'Mali',
+	MM: 'Myanmar',
+	MN: 'Mongolia',
+	MO: 'Macao, SAR China',
+	MP: 'Northern Mariana Islands',
+	MQ: 'Martinique',
+	MR: 'Mauritania',
+	MS: 'Montserrat',
+	MT: 'Malta',
+	MU: 'Mauritius',
+	MV: 'Maldives',
+	MW: 'Malawi',
+	MX: 'Mexico',
+	MY: 'Malaysia',
+	MZ: 'Mozambique',
+	NA: 'Namibia',
+	NC: 'New Caledonia',
+	NE: 'Niger',
+	NF: 'Norfolk Island',
+	NG: 'Nigeria',
+	NI: 'Nicaragua',
+	NL: 'Netherlands',
+	NO: 'Norway',
+	NP: 'Nepal',
+	NR: 'Nauru',
+	NU: 'Niue',
+	NZ: 'New Zealand',
+	OM: 'Oman',
+	PA: 'Panama',
+	PE: 'Peru',
+	PF: 'French Polynesia',
+	PG: 'Papua New Guinea',
+	PH: 'Philippines',
+	PK: 'Pakistan',
+	PL: 'Poland',
+	PM: 'Saint Pierre and Miquelon',
+	PN: 'Pitcairn',
+	PR: 'Puerto Rico',
+	PS: 'Palestinian Territory',
+	PT: 'Portugal',
+	PW: 'Palau',
+	PY: 'Paraguay',
+	QA: 'Qatar',
+	RE: 'Reunion',
+	RO: 'Romania',
+	RS: 'Serbia',
+	RU: 'Russian Federation',
+	RW: 'Rwanda',
+	SA: 'Saudi Arabia',
+	SB: 'Solomon Islands',
+	SC: 'Seychelles',
+	SD: 'Sudan',
+	SE: 'Sweden',
+	SG: 'Singapore',
+	SH: 'Saint Helena',
+	SI: 'Slovenia',
+	SJ: 'Svalbard and Jan Mayen Islands',
+	SK: 'Slovakia',
+	SL: 'Sierra Leone',
+	SM: 'San Marino',
+	SN: 'Senegal',
+	SO: 'Somalia',
+	SR: 'Suriname',
+	SS: 'South Sudan',
+	ST: 'Sao Tome and Principe',
+	SV: 'El Salvador',
+	SX: 'Sint Maarten (Dutch part)',
+	SY: 'Syria',
+	SZ: 'Swaziland',
+	TC: 'Turks and Caicos Islands',
+	TD: 'Chad',
+	TF: 'French Southern Territories',
+	TG: 'Togo',
+	TH: 'Thailand',
+	TJ: 'Tajikistan',
+	TK: 'Tokelau',
+	TL: 'Timor-Leste',
+	TM: 'Turkmenistan',
+	TN: 'Tunisia',
+	TO: 'Tonga',
+	TR: 'Turkey',
+	TT: 'Trinidad and Tobago',
+	TV: 'Tuvalu',
+	TW: 'Taiwan, Republic of China',
+	TZ: 'Tanzania, United Republic of',
+	UA: 'Ukraine',
+	UG: 'Uganda',
+	UM: 'US Minor Outlying Islands',
+	US: 'United States of America',
+	UY: 'Uruguay',
+	UZ: 'Uzbekistan',
+	VA: 'Holy See (Vatican City State)',
+	VC: 'Saint Vincent and Grenadines',
+	VE: 'Venezuela',
+	VG: 'British Virgin Islands',
+	VI: 'Virgin Islands, US',
+	VN: 'Viet Nam',
+	VU: 'Vanuatu',
+	WF: 'Wallis and Futuna Islands',
+	WS: 'Samoa',
+	YE: 'Yemen',
+	YT: 'Mayotte',
+	ZA: 'South Africa',
+	ZM: 'Zambia',
+	ZW: 'Zimbabwe'
+} as const
+
+export type CountryCode = keyof typeof countryNames
+
+/** All 249 ISO 3166-1 alpha-2 codes, sorted. */
+export const countryCodes = Object.keys(countryNames) as readonly CountryCode[]
+
+export function isCountryCode(value: unknown): value is CountryCode {
+	return typeof value === 'string' && Object.hasOwn(countryNames, value)
+}
+
+/**
+ * The flag emoji for a country code: `countryFlag('DK')` is `'🇩🇰'`. Built
+ * from regional-indicator letters, so platforms without a flag glyph show
+ * the two letters.
+ */
+export function countryFlag(code: CountryCode): string {
+	return String.fromCodePoint(
+		...[...code].map((letter) => 0x1f1a5 + letter.charCodeAt(0))
+	)
+}

package/src/iso/currencies.ts

@@ -0,0 +1,172 @@
+/**
+ * ISO 4217 codes of circulating currencies (plus the CFA and CFP francs and
+ * the East Caribbean dollars), with English names. Historic codes, funds and
+ * precious metals are left out.
+ */
+export const currencyNames = {
+	AED: 'United Arab Emirates Dirham',
+	AFN: 'Afghan Afghani',
+	ALL: 'Albanian Lek',
+	AMD: 'Armenian Dram',
+	AOA: 'Angolan Kwanza',
+	ARS: 'Argentine Peso',
+	AUD: 'Australian Dollar',
+	AWG: 'Aruban Florin',
+	AZN: 'Azerbaijani Manat',
+	BAM: 'Bosnia-Herzegovina Convertible Mark',
+	BBD: 'Barbadian Dollar',
+	BDT: 'Bangladeshi Taka',
+	BHD: 'Bahraini Dinar',
+	BIF: 'Burundian Franc',
+	BMD: 'Bermudan Dollar',
+	BND: 'Brunei Dollar',
+	BOB: 'Bolivian Boliviano',
+	BRL: 'Brazilian Real',
+	BSD: 'Bahamian Dollar',
+	BTN: 'Bhutanese Ngultrum',
+	BWP: 'Botswanan Pula',
+	BYN: 'Belarusian Ruble',
+	BZD: 'Belize Dollar',
+	CAD: 'Canadian Dollar',
+	CDF: 'Congolese Franc',
+	CHF: 'Swiss Franc',
+	CLP: 'Chilean Peso',
+	CNY: 'Chinese Yuan',
+	COP: 'Colombian Peso',
+	CRC: 'Costa Rican Colón',
+	CUP: 'Cuban Peso',
+	CVE: 'Cape Verdean Escudo',
+	CZK: 'Czech Koruna',
+	DJF: 'Djiboutian Franc',
+	DKK: 'Danish Krone',
+	DOP: 'Dominican Peso',
+	DZD: 'Algerian Dinar',
+	EGP: 'Egyptian Pound',
+	ERN: 'Eritrean Nakfa',
+	ETB: 'Ethiopian Birr',
+	EUR: 'Euro',
+	FJD: 'Fijian Dollar',
+	FKP: 'Falkland Islands Pound',
+	GBP: 'British Pound',
+	GEL: 'Georgian Lari',
+	GHS: 'Ghanaian Cedi',
+	GIP: 'Gibraltar Pound',
+	GMD: 'Gambian Dalasi',
+	GNF: 'Guinean Franc',
+	GTQ: 'Guatemalan Quetzal',
+	GYD: 'Guyanese Dollar',
+	HKD: 'Hong Kong Dollar',
+	HNL: 'Honduran Lempira',
+	HTG: 'Haitian Gourde',
+	HUF: 'Hungarian Forint',
+	IDR: 'Indonesian Rupiah',
+	ILS: 'Israeli New Shekel',
+	INR: 'Indian Rupee',
+	IQD: 'Iraqi Dinar',
+	IRR: 'Iranian Rial',
+	ISK: 'Icelandic Króna',
+	JMD: 'Jamaican Dollar',
+	JOD: 'Jordanian Dinar',
+	JPY: 'Japanese Yen',
+	KES: 'Kenyan Shilling',
+	KGS: 'Kyrgyz Som',
+	KHR: 'Cambodian Riel',
+	KMF: 'Comorian Franc',
+	KPW: 'North Korean Won',
+	KRW: 'South Korean Won',
+	KWD: 'Kuwaiti Dinar',
+	KYD: 'Cayman Islands Dollar',
+	KZT: 'Kazakhstani Tenge',
+	LAK: 'Laotian Kip',
+	LBP: 'Lebanese Pound',
+	LKR: 'Sri Lankan Rupee',
+	LRD: 'Liberian Dollar',
+	LSL: 'Lesotho Loti',
+	LYD: 'Libyan Dinar',
+	MAD: 'Moroccan Dirham',
+	MDL: 'Moldovan Leu',
+	MGA: 'Malagasy Ariary',
+	MKD: 'Macedonian Denar',
+	MMK: 'Myanmar Kyat',
+	MNT: 'Mongolian Tugrik',
+	MOP: 'Macanese Pataca',
+	MRU: 'Mauritanian Ouguiya',
+	MUR: 'Mauritian Rupee',
+	MVR: 'Maldivian Rufiyaa',
+	MWK: 'Malawian Kwacha',
+	MXN: 'Mexican Peso',
+	MYR: 'Malaysian Ringgit',
+	MZN: 'Mozambican Metical',
+	NAD: 'Namibian Dollar',
+	NGN: 'Nigerian Naira',
+	NIO: 'Nicaraguan Córdoba',
+	NOK: 'Norwegian Krone',
+	NPR: 'Nepalese Rupee',
+	NZD: 'New Zealand Dollar',
+	OMR: 'Omani Rial',
+	PAB: 'Panamanian Balboa',
+	PEN: 'Peruvian Sol',
+	PGK: 'Papua New Guinean Kina',
+	PHP: 'Philippine Peso',
+	PKR: 'Pakistani Rupee',
+	PLN: 'Polish Zloty',
+	PYG: 'Paraguayan Guarani',
+	QAR: 'Qatari Riyal',
+	RON: 'Romanian Leu',
+	RSD: 'Serbian Dinar',
+	RUB: 'Russian Ruble',
+	RWF: 'Rwandan Franc',
+	SAR: 'Saudi Riyal',
+	SBD: 'Solomon Islands Dollar',
+	SCR: 'Seychellois Rupee',
+	SDG: 'Sudanese Pound',
+	SEK: 'Swedish Krona',
+	SGD: 'Singapore Dollar',
+	SHP: 'St. Helena Pound',
+	SLE: 'Sierra Leonean Leone',
+	SOS: 'Somali Shilling',
+	SRD: 'Surinamese Dollar',
+	SSP: 'South Sudanese Pound',
+	STN: 'São Tomé & Príncipe Dobra',
+	SVC: 'Salvadoran Colón',
+	SYP: 'Syrian Pound',
+	SZL: 'Swazi Lilangeni',
+	THB: 'Thai Baht',
+	TJS: 'Tajikistani Somoni',
+	TMT: 'Turkmenistani Manat',
+	TND: 'Tunisian Dinar',
+	TOP: 'Tongan Paʻanga',
+	TRY: 'Turkish Lira',
+	TTD: 'Trinidad & Tobago Dollar',
+	TWD: 'New Taiwan Dollar',
+	TZS: 'Tanzanian Shilling',
+	UAH: 'Ukrainian Hryvnia',
+	UGX: 'Ugandan Shilling',
+	USD: 'US Dollar',
+	UYU: 'Uruguayan Peso',
+	UZS: 'Uzbekistani Som',
+	VED: 'Bolívar Soberano',
+	VES: 'Venezuelan Bolívar',
+	VND: 'Vietnamese Dong',
+	VUV: 'Vanuatu Vatu',
+	WST: 'Samoan Tala',
+	XAF: 'Central African CFA Franc',
+	XCD: 'East Caribbean Dollar',
+	XCG: 'Caribbean guilder',
+	XOF: 'West African CFA Franc',
+	XPF: 'CFP Franc',
+	YER: 'Yemeni Rial',
+	ZAR: 'South African Rand',
+	ZMW: 'Zambian Kwacha',
+	ZWG: 'Zimbabwean Gold'
+} as const
+
+export type CurrencyCode = keyof typeof currencyNames
+
+export const currencyCodes = Object.keys(
+	currencyNames
+) as readonly CurrencyCode[]
+
+export function isCurrencyCode(value: unknown): value is CurrencyCode {
+	return typeof value === 'string' && Object.hasOwn(currencyNames, value)
+}

package/src/iso/index.ts

@@ -0,0 +1,8 @@
+// ISO country, currency and language codes as literal unions, with English
+// names. Static data with no dependencies; no `Intl.DisplayNames` needed (it is
+// missing on Hermes). For names in other languages, use `Intl.DisplayNames`.
+
+export * from './countries'
+export * from './currencies'
+export * from './languages'
+export * from './phone-language'

package/src/iso/languages.ts

@@ -0,0 +1,208 @@
+/** ISO 639-1 two-letter language codes (lowercase) with English names. */
+export const languageNames = {
+	aa: 'Afar',
+	ab: 'Abkhazian',
+	ae: 'Avestan',
+	af: 'Afrikaans',
+	ak: 'Akan',
+	am: 'Amharic',
+	an: 'Aragonese',
+	ar: 'Arabic',
+	as: 'Assamese',
+	av: 'Avaric',
+	ay: 'Aymara',
+	az: 'Azerbaijani',
+	ba: 'Bashkir',
+	be: 'Belarusian',
+	bg: 'Bulgarian',
+	bi: 'Bislama',
+	bm: 'Bambara',
+	bn: 'Bangla',
+	bo: 'Tibetan',
+	br: 'Breton',
+	bs: 'Bosnian',
+	ca: 'Catalan',
+	ce: 'Chechen',
+	ch: 'Chamorro',
+	co: 'Corsican',
+	cr: 'Cree',
+	cs: 'Czech',
+	cu: 'Church Slavic',
+	cv: 'Chuvash',
+	cy: 'Welsh',
+	da: 'Danish',
+	de: 'German',
+	dv: 'Dhivehi',
+	dz: 'Dzongkha',
+	ee: 'Ewe',
+	el: 'Greek',
+	en: 'English',
+	eo: 'Esperanto',
+	es: 'Spanish',
+	et: 'Estonian',
+	eu: 'Basque',
+	fa: 'Persian',
+	ff: 'Fula',
+	fi: 'Finnish',
+	fj: 'Fijian',
+	fo: 'Faroese',
+	fr: 'French',
+	fy: 'Western Frisian',
+	ga: 'Irish',
+	gd: 'Scottish Gaelic',
+	gl: 'Galician',
+	gn: 'Guarani',
+	gu: 'Gujarati',
+	gv: 'Manx',
+	ha: 'Hausa',
+	he: 'Hebrew',
+	hi: 'Hindi',
+	ho: 'Hiri Motu',
+	hr: 'Croatian',
+	ht: 'Haitian Creole',
+	hu: 'Hungarian',
+	hy: 'Armenian',
+	hz: 'Herero',
+	ia: 'Interlingua',
+	id: 'Indonesian',
+	ie: 'Interlingue',
+	ig: 'Igbo',
+	ii: 'Liangshan Yi',
+	ik: 'Inupiaq',
+	io: 'Ido',
+	is: 'Icelandic',
+	it: 'Italian',
+	iu: 'Inuktitut',
+	ja: 'Japanese',
+	jv: 'Javanese',
+	ka: 'Georgian',
+	kg: 'Kongo',
+	ki: 'Kikuyu',
+	kj: 'Kuanyama',
+	kk: 'Kazakh',
+	kl: 'Kalaallisut',
+	km: 'Khmer',
+	kn: 'Kannada',
+	ko: 'Korean',
+	kr: 'Kanuri',
+	ks: 'Kashmiri',
+	ku: 'Kurdish',
+	kv: 'Komi',
+	kw: 'Cornish',
+	ky: 'Kyrgyz',
+	la: 'Latin',
+	lb: 'Luxembourgish',
+	lg: 'Ganda',
+	li: 'Limburgish',
+	ln: 'Lingala',
+	lo: 'Lao',
+	lt: 'Lithuanian',
+	lu: 'Luba-Katanga',
+	lv: 'Latvian',
+	mg: 'Malagasy',
+	mh: 'Marshallese',
+	mi: 'Māori',
+	mk: 'Macedonian',
+	ml: 'Malayalam',
+	mn: 'Mongolian',
+	mr: 'Marathi',
+	ms: 'Malay',
+	mt: 'Maltese',
+	my: 'Burmese',
+	na: 'Nauru',
+	nb: 'Norwegian Bokmål',
+	nd: 'North Ndebele',
+	ne: 'Nepali',
+	ng: 'Ndonga',
+	nl: 'Dutch',
+	nn: 'Norwegian Nynorsk',
+	no: 'Norwegian',
+	nr: 'South Ndebele',
+	nv: 'Navajo',
+	ny: 'Nyanja',
+	oc: 'Occitan',
+	oj: 'Ojibwa',
+	om: 'Oromo',
+	or: 'Odia',
+	os: 'Ossetic',
+	pa: 'Punjabi',
+	pi: 'Pali',
+	pl: 'Polish',
+	ps: 'Pashto',
+	pt: 'Portuguese',
+	qu: 'Quechua',
+	rm: 'Romansh',
+	rn: 'Rundi',
+	ro: 'Romanian',
+	ru: 'Russian',
+	rw: 'Kinyarwanda',
+	sa: 'Sanskrit',
+	sc: 'Sardinian',
+	sd: 'Sindhi',
+	se: 'North Sámi',
+	sg: 'Sango',
+	si: 'Sinhala',
+	sk: 'Slovak',
+	sl: 'Slovenian',
+	sm: 'Samoan',
+	sn: 'Shona',
+	so: 'Somali',
+	sq: 'Albanian',
+	sr: 'Serbian',
+	ss: 'Swati',
+	st: 'Southern Sotho',
+	su: 'Sundanese',
+	sv: 'Swedish',
+	sw: 'Swahili',
+	ta: 'Tamil',
+	te: 'Telugu',
+	tg: 'Tajik',
+	th: 'Thai',
+	ti: 'Tigrinya',
+	tk: 'Turkmen',
+	tl: 'Tagalog',
+	tn: 'Tswana',
+	to: 'Tongan',
+	tr: 'Turkish',
+	ts: 'Tsonga',
+	tt: 'Tatar',
+	tw: 'Twi',
+	ty: 'Tahitian',
+	ug: 'Uyghur',
+	uk: 'Ukrainian',
+	ur: 'Urdu',
+	uz: 'Uzbek',
+	ve: 'Venda',
+	vi: 'Vietnamese',
+	vo: 'Volapük',
+	wa: 'Walloon',
+	wo: 'Wolof',
+	xh: 'Xhosa',
+	yi: 'Yiddish',
+	yo: 'Yoruba',
+	za: 'Zhuang',
+	zh: 'Chinese',
+	zu: 'Zulu'
+} as const
+
+export type LanguageCode = keyof typeof languageNames
+
+export const languageCodes = Object.keys(
+	languageNames
+) as readonly LanguageCode[]
+
+export function isLanguageCode(value: unknown): value is LanguageCode {
+	return typeof value === 'string' && Object.hasOwn(languageNames, value)
+}
+
+/**
+ * The ISO 639-1 language of a BCP-47-ish tag (`'en-GB'`, `'da_DK'`), or
+ * `null` when it has none. Map tags your app treats as one language (`'no'`
+ * and `'nn'` to `'nb'`, say) before or after.
+ */
+export function matchLanguageCode(
+	tag: string | null | undefined
+): LanguageCode | null {
+	const language = tag?.trim().replaceAll('_', '-').split('-')[0]?.toLowerCase()
+	return isLanguageCode(language) ? language : null
+}

package/src/iso/phone-language.ts

@@ -0,0 +1,46 @@
+import type { LanguageCode } from './languages'
+
+/**
+ * Country calling code (digits, no `+`) → the language a support conversation
+ * with that number most likely wants. Only codes with one clear default are
+ * listed; multilingual countries get their most common language.
+ */
+const CALLING_CODE_LANGUAGE = {
+	'1': 'en', // NANP
+	'31': 'nl',
+	'32': 'nl', // Belgium: Dutch and French
+	'33': 'fr',
+	'34': 'es',
+	'39': 'it',
+	'41': 'de', // Switzerland: German, French and Italian
+	'43': 'de',
+	'44': 'en',
+	'45': 'da',
+	'46': 'sv',
+	'47': 'nb',
+	'49': 'de',
+	'351': 'pt',
+	'353': 'en'
+} as const satisfies Record<string, LanguageCode>
+
+type CallingCode = keyof typeof CALLING_CODE_LANGUAGE
+
+// Longest first, so `351` wins over a shorter prefix.
+const CALLING_CODES = (
+	Object.keys(CALLING_CODE_LANGUAGE) as CallingCode[]
+).sort((a, b) => b.length - a.length)
+
+/**
+ * A default language from an E.164 number's calling code (`+45…` → `'da'`),
+ * or `null` when the number is missing, too short, or its code is unmapped.
+ */
+export function languageFromE164PhoneNumber(
+	phoneNumber: string | null | undefined
+) {
+	const digits = phoneNumber?.trim().replace(/^\+/, '').replace(/\D/g, '')
+	if (!digits) return null
+	const code = CALLING_CODES.find(
+		(code) => digits.startsWith(code) && digits.length > code.length
+	)
+	return code ? CALLING_CODE_LANGUAGE[code] : null
+}