country-code-kit 1.0.0 → 1.0.1

package/dist/cjs/index.js

@@ -6,6 +6,8 @@ exports.getCountryByName = getCountryByName;
 exports.getCountryByFlag = getCountryByFlag;
 exports.getFlag = getFlag;
 exports.getName = getName;
+exports.getDialCode = getDialCode;
+exports.getCountriesByDialCode = getCountriesByDialCode;
 exports.isValidCode = isValidCode;
 exports.searchCountries = searchCountries;
 exports.codeToFlag = codeToFlag;
@@ -14,6 +16,14 @@ const data_js_1 = require("./data.js");
 Object.defineProperty(exports, "countries", { enumerable: true, get: function () { return data_js_1.countries; } });
 const byCode = new Map(data_js_1.countries.map((c) => [c.code, c]));
 const byName = new Map(data_js_1.countries.map((c) => [c.name.toLowerCase(), c]));
+const byDialCode = new Map();
+for (const c of data_js_1.countries) {
+    if (c.dialCode) {
+        const list = byDialCode.get(c.dialCode) ?? [];
+        list.push(c);
+        byDialCode.set(c.dialCode, list);
+    }
+}
 /** Get a country by its ISO 3166-1 alpha-2 code (case-insensitive). */
 function getCountryByCode(code) {
     return byCode.get(code.trim().toUpperCase());
@@ -35,6 +45,17 @@ function getFlag(code) {
 function getName(code) {
     return getCountryByCode(code)?.name;
 }
+/** Get the dial code (e.g. "+880") for an alpha-2 code. Returns null for territories with no dial code, undefined for unknown codes. */
+function getDialCode(code) {
+    return getCountryByCode(code)?.dialCode;
+}
+/**
+ * Get all countries that share a given dial code (e.g. "+1" → US, CA, and many Caribbean territories).
+ * The dialCode argument must include the leading "+".
+ */
+function getCountriesByDialCode(dialCode) {
+    return byDialCode.get(dialCode.trim()) ?? [];
+}
 /** Check whether a string is a valid ISO 3166-1 alpha-2 code. */
 function isValidCode(code) {
     return byCode.has(code.trim().toUpperCase());

package/dist/cjs/types.d.ts

@@ -6,4 +6,6 @@ export interface Country {
     name: string;
     /** Flag emoji, e.g. "🇮🇳" */
     flag: string;
+    /** ITU calling code including +, e.g. "+880". Null for territories with no assigned dial code. */
+    dialCode: string | null;
 }

package/dist/esm/data.js

@@ -1,251 +1,251 @@
 export const countries = [
-    { code: "AD", name: "Andorra", flag: "🇦🇩" },
-    { code: "AE", name: "United Arab Emirates", flag: "🇦🇪" },
-    { code: "AF", name: "Afghanistan", flag: "🇦🇫" },
-    { code: "AG", name: "Antigua & Barbuda", flag: "🇦🇬" },
-    { code: "AI", name: "Anguilla", flag: "🇦🇮" },
-    { code: "AL", name: "Albania", flag: "🇦🇱" },
-    { code: "AM", name: "Armenia", flag: "🇦🇲" },
-    { code: "AO", name: "Angola", flag: "🇦🇴" },
-    { code: "AQ", name: "Antarctica", flag: "🇦🇶" },
-    { code: "AR", name: "Argentina", flag: "🇦🇷" },
-    { code: "AS", name: "American Samoa", flag: "🇦🇸" },
-    { code: "AT", name: "Austria", flag: "🇦🇹" },
-    { code: "AU", name: "Australia", flag: "🇦🇺" },
-    { code: "AW", name: "Aruba", flag: "🇦🇼" },
-    { code: "AX", name: "Åland Islands", flag: "🇦🇽" },
-    { code: "AZ", name: "Azerbaijan", flag: "🇦🇿" },
-    { code: "BA", name: "Bosnia & Herzegovina", flag: "🇧🇦" },
-    { code: "BB", name: "Barbados", flag: "🇧🇧" },
-    { code: "BD", name: "Bangladesh", flag: "🇧🇩" },
-    { code: "BE", name: "Belgium", flag: "🇧🇪" },
-    { code: "BF", name: "Burkina Faso", flag: "🇧🇫" },
-    { code: "BG", name: "Bulgaria", flag: "🇧🇬" },
-    { code: "BH", name: "Bahrain", flag: "🇧🇭" },
-    { code: "BI", name: "Burundi", flag: "🇧🇮" },
-    { code: "BJ", name: "Benin", flag: "🇧🇯" },
-    { code: "BL", name: "St. Barthélemy", flag: "🇧🇱" },
-    { code: "BM", name: "Bermuda", flag: "🇧🇲" },
-    { code: "BN", name: "Brunei", flag: "🇧🇳" },
-    { code: "BO", name: "Bolivia", flag: "🇧🇴" },
-    { code: "BQ", name: "Caribbean Netherlands", flag: "🇧🇶" },
-    { code: "BR", name: "Brazil", flag: "🇧🇷" },
-    { code: "BS", name: "Bahamas", flag: "🇧🇸" },
-    { code: "BT", name: "Bhutan", flag: "🇧🇹" },
-    { code: "BV", name: "Bouvet Island", flag: "🇧🇻" },
-    { code: "BW", name: "Botswana", flag: "🇧🇼" },
-    { code: "BY", name: "Belarus", flag: "🇧🇾" },
-    { code: "BZ", name: "Belize", flag: "🇧🇿" },
-    { code: "CA", name: "Canada", flag: "🇨🇦" },
-    { code: "CC", name: "Cocos (Keeling) Islands", flag: "🇨🇨" },
-    { code: "CD", name: "Congo - Kinshasa", flag: "🇨🇩" },
-    { code: "CF", name: "Central African Republic", flag: "🇨🇫" },
-    { code: "CG", name: "Congo - Brazzaville", flag: "🇨🇬" },
-    { code: "CH", name: "Switzerland", flag: "🇨🇭" },
-    { code: "CI", name: "Côte d’Ivoire", flag: "🇨🇮" },
-    { code: "CK", name: "Cook Islands", flag: "🇨🇰" },
-    { code: "CL", name: "Chile", flag: "🇨🇱" },
-    { code: "CM", name: "Cameroon", flag: "🇨🇲" },
-    { code: "CN", name: "China", flag: "🇨🇳" },
-    { code: "CO", name: "Colombia", flag: "🇨🇴" },
-    { code: "CR", name: "Costa Rica", flag: "🇨🇷" },
-    { code: "CU", name: "Cuba", flag: "🇨🇺" },
-    { code: "CV", name: "Cape Verde", flag: "🇨🇻" },
-    { code: "CW", name: "Curaçao", flag: "🇨🇼" },
-    { code: "CX", name: "Christmas Island", flag: "🇨🇽" },
-    { code: "CY", name: "Cyprus", flag: "🇨🇾" },
-    { code: "CZ", name: "Czechia", flag: "🇨🇿" },
-    { code: "DE", name: "Germany", flag: "🇩🇪" },
-    { code: "DJ", name: "Djibouti", flag: "🇩🇯" },
-    { code: "DK", name: "Denmark", flag: "🇩🇰" },
-    { code: "DM", name: "Dominica", flag: "🇩🇲" },
-    { code: "DO", name: "Dominican Republic", flag: "🇩🇴" },
-    { code: "DZ", name: "Algeria", flag: "🇩🇿" },
-    { code: "EC", name: "Ecuador", flag: "🇪🇨" },
-    { code: "EE", name: "Estonia", flag: "🇪🇪" },
-    { code: "EG", name: "Egypt", flag: "🇪🇬" },
-    { code: "EH", name: "Western Sahara", flag: "🇪🇭" },
-    { code: "ER", name: "Eritrea", flag: "🇪🇷" },
-    { code: "ES", name: "Spain", flag: "🇪🇸" },
-    { code: "ET", name: "Ethiopia", flag: "🇪🇹" },
-    { code: "FI", name: "Finland", flag: "🇫🇮" },
-    { code: "FJ", name: "Fiji", flag: "🇫🇯" },
-    { code: "FK", name: "Falkland Islands", flag: "🇫🇰" },
-    { code: "FM", name: "Micronesia", flag: "🇫🇲" },
-    { code: "FO", name: "Faroe Islands", flag: "🇫🇴" },
-    { code: "FR", name: "France", flag: "🇫🇷" },
-    { code: "GA", name: "Gabon", flag: "🇬🇦" },
-    { code: "GB", name: "United Kingdom", flag: "🇬🇧" },
-    { code: "GD", name: "Grenada", flag: "🇬🇩" },
-    { code: "GE", name: "Georgia", flag: "🇬🇪" },
-    { code: "GF", name: "French Guiana", flag: "🇬🇫" },
-    { code: "GG", name: "Guernsey", flag: "🇬🇬" },
-    { code: "GH", name: "Ghana", flag: "🇬🇭" },
-    { code: "GI", name: "Gibraltar", flag: "🇬🇮" },
-    { code: "GL", name: "Greenland", flag: "🇬🇱" },
-    { code: "GM", name: "Gambia", flag: "🇬🇲" },
-    { code: "GN", name: "Guinea", flag: "🇬🇳" },
-    { code: "GP", name: "Guadeloupe", flag: "🇬🇵" },
-    { code: "GQ", name: "Equatorial Guinea", flag: "🇬🇶" },
-    { code: "GR", name: "Greece", flag: "🇬🇷" },
-    { code: "GS", name: "South Georgia & South Sandwich Islands", flag: "🇬🇸" },
-    { code: "GT", name: "Guatemala", flag: "🇬🇹" },
-    { code: "GU", name: "Guam", flag: "🇬🇺" },
-    { code: "GW", name: "Guinea-Bissau", flag: "🇬🇼" },
-    { code: "GY", name: "Guyana", flag: "🇬🇾" },
-    { code: "HK", name: "Hong Kong SAR China", flag: "🇭🇰" },
-    { code: "HM", name: "Heard & McDonald Islands", flag: "🇭🇲" },
-    { code: "HN", name: "Honduras", flag: "🇭🇳" },
-    { code: "HR", name: "Croatia", flag: "🇭🇷" },
-    { code: "HT", name: "Haiti", flag: "🇭🇹" },
-    { code: "HU", name: "Hungary", flag: "🇭🇺" },
-    { code: "ID", name: "Indonesia", flag: "🇮🇩" },
-    { code: "IE", name: "Ireland", flag: "🇮🇪" },
-    { code: "IL", name: "Israel", flag: "🇮🇱" },
-    { code: "IM", name: "Isle of Man", flag: "🇮🇲" },
-    { code: "IN", name: "India", flag: "🇮🇳" },
-    { code: "IO", name: "British Indian Ocean Territory", flag: "🇮🇴" },
-    { code: "IQ", name: "Iraq", flag: "🇮🇶" },
-    { code: "IR", name: "Iran", flag: "🇮🇷" },
-    { code: "IS", name: "Iceland", flag: "🇮🇸" },
-    { code: "IT", name: "Italy", flag: "🇮🇹" },
-    { code: "JE", name: "Jersey", flag: "🇯🇪" },
-    { code: "JM", name: "Jamaica", flag: "🇯🇲" },
-    { code: "JO", name: "Jordan", flag: "🇯🇴" },
-    { code: "JP", name: "Japan", flag: "🇯🇵" },
-    { code: "KE", name: "Kenya", flag: "🇰🇪" },
-    { code: "KG", name: "Kyrgyzstan", flag: "🇰🇬" },
-    { code: "KH", name: "Cambodia", flag: "🇰🇭" },
-    { code: "KI", name: "Kiribati", flag: "🇰🇮" },
-    { code: "KM", name: "Comoros", flag: "🇰🇲" },
-    { code: "KN", name: "St. Kitts & Nevis", flag: "🇰🇳" },
-    { code: "KP", name: "North Korea", flag: "🇰🇵" },
-    { code: "KR", name: "South Korea", flag: "🇰🇷" },
-    { code: "KW", name: "Kuwait", flag: "🇰🇼" },
-    { code: "KY", name: "Cayman Islands", flag: "🇰🇾" },
-    { code: "KZ", name: "Kazakhstan", flag: "🇰🇿" },
-    { code: "LA", name: "Laos", flag: "🇱🇦" },
-    { code: "LB", name: "Lebanon", flag: "🇱🇧" },
-    { code: "LC", name: "St. Lucia", flag: "🇱🇨" },
-    { code: "LI", name: "Liechtenstein", flag: "🇱🇮" },
-    { code: "LK", name: "Sri Lanka", flag: "🇱🇰" },
-    { code: "LR", name: "Liberia", flag: "🇱🇷" },
-    { code: "LS", name: "Lesotho", flag: "🇱🇸" },
-    { code: "LT", name: "Lithuania", flag: "🇱🇹" },
-    { code: "LU", name: "Luxembourg", flag: "🇱🇺" },
-    { code: "LV", name: "Latvia", flag: "🇱🇻" },
-    { code: "LY", name: "Libya", flag: "🇱🇾" },
-    { code: "MA", name: "Morocco", flag: "🇲🇦" },
-    { code: "MC", name: "Monaco", flag: "🇲🇨" },
-    { code: "MD", name: "Moldova", flag: "🇲🇩" },
-    { code: "ME", name: "Montenegro", flag: "🇲🇪" },
-    { code: "MF", name: "St. Martin", flag: "🇲🇫" },
-    { code: "MG", name: "Madagascar", flag: "🇲🇬" },
-    { code: "MH", name: "Marshall Islands", flag: "🇲🇭" },
-    { code: "MK", name: "North Macedonia", flag: "🇲🇰" },
-    { code: "ML", name: "Mali", flag: "🇲🇱" },
-    { code: "MM", name: "Myanmar (Burma)", flag: "🇲🇲" },
-    { code: "MN", name: "Mongolia", flag: "🇲🇳" },
-    { code: "MO", name: "Macao SAR China", flag: "🇲🇴" },
-    { code: "MP", name: "Northern Mariana Islands", flag: "🇲🇵" },
-    { code: "MQ", name: "Martinique", flag: "🇲🇶" },
-    { code: "MR", name: "Mauritania", flag: "🇲🇷" },
-    { code: "MS", name: "Montserrat", flag: "🇲🇸" },
-    { code: "MT", name: "Malta", flag: "🇲🇹" },
-    { code: "MU", name: "Mauritius", flag: "🇲🇺" },
-    { code: "MV", name: "Maldives", flag: "🇲🇻" },
-    { code: "MW", name: "Malawi", flag: "🇲🇼" },
-    { code: "MX", name: "Mexico", flag: "🇲🇽" },
-    { code: "MY", name: "Malaysia", flag: "🇲🇾" },
-    { code: "MZ", name: "Mozambique", flag: "🇲🇿" },
-    { code: "NA", name: "Namibia", flag: "🇳🇦" },
-    { code: "NC", name: "New Caledonia", flag: "🇳🇨" },
-    { code: "NE", name: "Niger", flag: "🇳🇪" },
-    { code: "NF", name: "Norfolk Island", flag: "🇳🇫" },
-    { code: "NG", name: "Nigeria", flag: "🇳🇬" },
-    { code: "NI", name: "Nicaragua", flag: "🇳🇮" },
-    { code: "NL", name: "Netherlands", flag: "🇳🇱" },
-    { code: "NO", name: "Norway", flag: "🇳🇴" },
-    { code: "NP", name: "Nepal", flag: "🇳🇵" },
-    { code: "NR", name: "Nauru", flag: "🇳🇷" },
-    { code: "NU", name: "Niue", flag: "🇳🇺" },
-    { code: "NZ", name: "New Zealand", flag: "🇳🇿" },
-    { code: "OM", name: "Oman", flag: "🇴🇲" },
-    { code: "PA", name: "Panama", flag: "🇵🇦" },
-    { code: "PE", name: "Peru", flag: "🇵🇪" },
-    { code: "PF", name: "French Polynesia", flag: "🇵🇫" },
-    { code: "PG", name: "Papua New Guinea", flag: "🇵🇬" },
-    { code: "PH", name: "Philippines", flag: "🇵🇭" },
-    { code: "PK", name: "Pakistan", flag: "🇵🇰" },
-    { code: "PL", name: "Poland", flag: "🇵🇱" },
-    { code: "PM", name: "St. Pierre & Miquelon", flag: "🇵🇲" },
-    { code: "PN", name: "Pitcairn Islands", flag: "🇵🇳" },
-    { code: "PR", name: "Puerto Rico", flag: "🇵🇷" },
-    { code: "PS", name: "Palestinian Territories", flag: "🇵🇸" },
-    { code: "PT", name: "Portugal", flag: "🇵🇹" },
-    { code: "PW", name: "Palau", flag: "🇵🇼" },
-    { code: "PY", name: "Paraguay", flag: "🇵🇾" },
-    { code: "QA", name: "Qatar", flag: "🇶🇦" },
-    { code: "RE", name: "Réunion", flag: "🇷🇪" },
-    { code: "RO", name: "Romania", flag: "🇷🇴" },
-    { code: "RS", name: "Serbia", flag: "🇷🇸" },
-    { code: "RU", name: "Russia", flag: "🇷🇺" },
-    { code: "RW", name: "Rwanda", flag: "🇷🇼" },
-    { code: "SA", name: "Saudi Arabia", flag: "🇸🇦" },
-    { code: "SB", name: "Solomon Islands", flag: "🇸🇧" },
-    { code: "SC", name: "Seychelles", flag: "🇸🇨" },
-    { code: "SD", name: "Sudan", flag: "🇸🇩" },
-    { code: "SE", name: "Sweden", flag: "🇸🇪" },
-    { code: "SG", name: "Singapore", flag: "🇸🇬" },
-    { code: "SH", name: "St. Helena", flag: "🇸🇭" },
-    { code: "SI", name: "Slovenia", flag: "🇸🇮" },
-    { code: "SJ", name: "Svalbard & Jan Mayen", flag: "🇸🇯" },
-    { code: "SK", name: "Slovakia", flag: "🇸🇰" },
-    { code: "SL", name: "Sierra Leone", flag: "🇸🇱" },
-    { code: "SM", name: "San Marino", flag: "🇸🇲" },
-    { code: "SN", name: "Senegal", flag: "🇸🇳" },
-    { code: "SO", name: "Somalia", flag: "🇸🇴" },
-    { code: "SR", name: "Suriname", flag: "🇸🇷" },
-    { code: "SS", name: "South Sudan", flag: "🇸🇸" },
-    { code: "ST", name: "São Tomé & Príncipe", flag: "🇸🇹" },
-    { code: "SV", name: "El Salvador", flag: "🇸🇻" },
-    { code: "SX", name: "Sint Maarten", flag: "🇸🇽" },
-    { code: "SY", name: "Syria", flag: "🇸🇾" },
-    { code: "SZ", name: "Eswatini", flag: "🇸🇿" },
-    { code: "TC", name: "Turks & Caicos Islands", flag: "🇹🇨" },
-    { code: "TD", name: "Chad", flag: "🇹🇩" },
-    { code: "TF", name: "French Southern Territories", flag: "🇹🇫" },
-    { code: "TG", name: "Togo", flag: "🇹🇬" },
-    { code: "TH", name: "Thailand", flag: "🇹🇭" },
-    { code: "TJ", name: "Tajikistan", flag: "🇹🇯" },
-    { code: "TK", name: "Tokelau", flag: "🇹🇰" },
-    { code: "TL", name: "Timor-Leste", flag: "🇹🇱" },
-    { code: "TM", name: "Turkmenistan", flag: "🇹🇲" },
-    { code: "TN", name: "Tunisia", flag: "🇹🇳" },
-    { code: "TO", name: "Tonga", flag: "🇹🇴" },
-    { code: "TR", name: "Türkiye", flag: "🇹🇷" },
-    { code: "TT", name: "Trinidad & Tobago", flag: "🇹🇹" },
-    { code: "TV", name: "Tuvalu", flag: "🇹🇻" },
-    { code: "TW", name: "Taiwan", flag: "🇹🇼" },
-    { code: "TZ", name: "Tanzania", flag: "🇹🇿" },
-    { code: "UA", name: "Ukraine", flag: "🇺🇦" },
-    { code: "UG", name: "Uganda", flag: "🇺🇬" },
-    { code: "UM", name: "U.S. Outlying Islands", flag: "🇺🇲" },
-    { code: "US", name: "United States", flag: "🇺🇸" },
-    { code: "UY", name: "Uruguay", flag: "🇺🇾" },
-    { code: "UZ", name: "Uzbekistan", flag: "🇺🇿" },
-    { code: "VA", name: "Vatican City", flag: "🇻🇦" },
-    { code: "VC", name: "St. Vincent & Grenadines", flag: "🇻🇨" },
-    { code: "VE", name: "Venezuela", flag: "🇻🇪" },
-    { code: "VG", name: "British Virgin Islands", flag: "🇻🇬" },
-    { code: "VI", name: "U.S. Virgin Islands", flag: "🇻🇮" },
-    { code: "VN", name: "Vietnam", flag: "🇻🇳" },
-    { code: "VU", name: "Vanuatu", flag: "🇻🇺" },
-    { code: "WF", name: "Wallis & Futuna", flag: "🇼🇫" },
-    { code: "WS", name: "Samoa", flag: "🇼🇸" },
-    { code: "YE", name: "Yemen", flag: "🇾🇪" },
-    { code: "YT", name: "Mayotte", flag: "🇾🇹" },
-    { code: "ZA", name: "South Africa", flag: "🇿🇦" },
-    { code: "ZM", name: "Zambia", flag: "🇿🇲" },
-    { code: "ZW", name: "Zimbabwe", flag: "🇿🇼" },
+    { code: "AD", name: "Andorra", flag: "🇦🇩", dialCode: "+376" },
+    { code: "AE", name: "United Arab Emirates", flag: "🇦🇪", dialCode: "+971" },
+    { code: "AF", name: "Afghanistan", flag: "🇦🇫", dialCode: "+93" },
+    { code: "AG", name: "Antigua & Barbuda", flag: "🇦🇬", dialCode: "+1268" },
+    { code: "AI", name: "Anguilla", flag: "🇦🇮", dialCode: "+1264" },
+    { code: "AL", name: "Albania", flag: "🇦🇱", dialCode: "+355" },
+    { code: "AM", name: "Armenia", flag: "🇦🇲", dialCode: "+374" },
+    { code: "AO", name: "Angola", flag: "🇦🇴", dialCode: "+244" },
+    { code: "AQ", name: "Antarctica", flag: "🇦🇶", dialCode: null },
+    { code: "AR", name: "Argentina", flag: "🇦🇷", dialCode: "+54" },
+    { code: "AS", name: "American Samoa", flag: "🇦🇸", dialCode: "+1684" },
+    { code: "AT", name: "Austria", flag: "🇦🇹", dialCode: "+43" },
+    { code: "AU", name: "Australia", flag: "🇦🇺", dialCode: "+61" },
+    { code: "AW", name: "Aruba", flag: "🇦🇼", dialCode: "+297" },
+    { code: "AX", name: "Åland Islands", flag: "🇦🇽", dialCode: "+358" },
+    { code: "AZ", name: "Azerbaijan", flag: "🇦🇿", dialCode: "+994" },
+    { code: "BA", name: "Bosnia & Herzegovina", flag: "🇧🇦", dialCode: "+387" },
+    { code: "BB", name: "Barbados", flag: "🇧🇧", dialCode: "+1246" },
+    { code: "BD", name: "Bangladesh", flag: "🇧🇩", dialCode: "+880" },
+    { code: "BE", name: "Belgium", flag: "🇧🇪", dialCode: "+32" },
+    { code: "BF", name: "Burkina Faso", flag: "🇧🇫", dialCode: "+226" },
+    { code: "BG", name: "Bulgaria", flag: "🇧🇬", dialCode: "+359" },
+    { code: "BH", name: "Bahrain", flag: "🇧🇭", dialCode: "+973" },
+    { code: "BI", name: "Burundi", flag: "🇧🇮", dialCode: "+257" },
+    { code: "BJ", name: "Benin", flag: "🇧🇯", dialCode: "+229" },
+    { code: "BL", name: "St. Barthélemy", flag: "🇧🇱", dialCode: "+590" },
+    { code: "BM", name: "Bermuda", flag: "🇧🇲", dialCode: "+1441" },
+    { code: "BN", name: "Brunei", flag: "🇧🇳", dialCode: "+673" },
+    { code: "BO", name: "Bolivia", flag: "🇧🇴", dialCode: "+591" },
+    { code: "BQ", name: "Caribbean Netherlands", flag: "🇧🇶", dialCode: "+599" },
+    { code: "BR", name: "Brazil", flag: "🇧🇷", dialCode: "+55" },
+    { code: "BS", name: "Bahamas", flag: "🇧🇸", dialCode: "+1242" },
+    { code: "BT", name: "Bhutan", flag: "🇧🇹", dialCode: "+975" },
+    { code: "BV", name: "Bouvet Island", flag: "🇧🇻", dialCode: null },
+    { code: "BW", name: "Botswana", flag: "🇧🇼", dialCode: "+267" },
+    { code: "BY", name: "Belarus", flag: "🇧🇾", dialCode: "+375" },
+    { code: "BZ", name: "Belize", flag: "🇧🇿", dialCode: "+501" },
+    { code: "CA", name: "Canada", flag: "🇨🇦", dialCode: "+1" },
+    { code: "CC", name: "Cocos (Keeling) Islands", flag: "🇨🇨", dialCode: "+61" },
+    { code: "CD", name: "Congo - Kinshasa", flag: "🇨🇩", dialCode: "+243" },
+    { code: "CF", name: "Central African Republic", flag: "🇨🇫", dialCode: "+236" },
+    { code: "CG", name: "Congo - Brazzaville", flag: "🇨🇬", dialCode: "+242" },
+    { code: "CH", name: "Switzerland", flag: "🇨🇭", dialCode: "+41" },
+    { code: "CI", name: "Côte d'Ivoire", flag: "🇨🇮", dialCode: "+225" },
+    { code: "CK", name: "Cook Islands", flag: "🇨🇰", dialCode: "+682" },
+    { code: "CL", name: "Chile", flag: "🇨🇱", dialCode: "+56" },
+    { code: "CM", name: "Cameroon", flag: "🇨🇲", dialCode: "+237" },
+    { code: "CN", name: "China", flag: "🇨🇳", dialCode: "+86" },
+    { code: "CO", name: "Colombia", flag: "🇨🇴", dialCode: "+57" },
+    { code: "CR", name: "Costa Rica", flag: "🇨🇷", dialCode: "+506" },
+    { code: "CU", name: "Cuba", flag: "🇨🇺", dialCode: "+53" },
+    { code: "CV", name: "Cape Verde", flag: "🇨🇻", dialCode: "+238" },
+    { code: "CW", name: "Curaçao", flag: "🇨🇼", dialCode: "+599" },
+    { code: "CX", name: "Christmas Island", flag: "🇨🇽", dialCode: "+61" },
+    { code: "CY", name: "Cyprus", flag: "🇨🇾", dialCode: "+357" },
+    { code: "CZ", name: "Czechia", flag: "🇨🇿", dialCode: "+420" },
+    { code: "DE", name: "Germany", flag: "🇩🇪", dialCode: "+49" },
+    { code: "DJ", name: "Djibouti", flag: "🇩🇯", dialCode: "+253" },
+    { code: "DK", name: "Denmark", flag: "🇩🇰", dialCode: "+45" },
+    { code: "DM", name: "Dominica", flag: "🇩🇲", dialCode: "+1767" },
+    { code: "DO", name: "Dominican Republic", flag: "🇩🇴", dialCode: "+1809" },
+    { code: "DZ", name: "Algeria", flag: "🇩🇿", dialCode: "+213" },
+    { code: "EC", name: "Ecuador", flag: "🇪🇨", dialCode: "+593" },
+    { code: "EE", name: "Estonia", flag: "🇪🇪", dialCode: "+372" },
+    { code: "EG", name: "Egypt", flag: "🇪🇬", dialCode: "+20" },
+    { code: "EH", name: "Western Sahara", flag: "🇪🇭", dialCode: "+212" },
+    { code: "ER", name: "Eritrea", flag: "🇪🇷", dialCode: "+291" },
+    { code: "ES", name: "Spain", flag: "🇪🇸", dialCode: "+34" },
+    { code: "ET", name: "Ethiopia", flag: "🇪🇹", dialCode: "+251" },
+    { code: "FI", name: "Finland", flag: "🇫🇮", dialCode: "+358" },
+    { code: "FJ", name: "Fiji", flag: "🇫🇯", dialCode: "+679" },
+    { code: "FK", name: "Falkland Islands", flag: "🇫🇰", dialCode: "+500" },
+    { code: "FM", name: "Micronesia", flag: "🇫🇲", dialCode: "+691" },
+    { code: "FO", name: "Faroe Islands", flag: "🇫🇴", dialCode: "+298" },
+    { code: "FR", name: "France", flag: "🇫🇷", dialCode: "+33" },
+    { code: "GA", name: "Gabon", flag: "🇬🇦", dialCode: "+241" },
+    { code: "GB", name: "United Kingdom", flag: "🇬🇧", dialCode: "+44" },
+    { code: "GD", name: "Grenada", flag: "🇬🇩", dialCode: "+1473" },
+    { code: "GE", name: "Georgia", flag: "🇬🇪", dialCode: "+995" },
+    { code: "GF", name: "French Guiana", flag: "🇬🇫", dialCode: "+594" },
+    { code: "GG", name: "Guernsey", flag: "🇬🇬", dialCode: "+44" },
+    { code: "GH", name: "Ghana", flag: "🇬🇭", dialCode: "+233" },
+    { code: "GI", name: "Gibraltar", flag: "🇬🇮", dialCode: "+350" },
+    { code: "GL", name: "Greenland", flag: "🇬🇱", dialCode: "+299" },
+    { code: "GM", name: "Gambia", flag: "🇬🇲", dialCode: "+220" },
+    { code: "GN", name: "Guinea", flag: "🇬🇳", dialCode: "+224" },
+    { code: "GP", name: "Guadeloupe", flag: "🇬🇵", dialCode: "+590" },
+    { code: "GQ", name: "Equatorial Guinea", flag: "🇬🇶", dialCode: "+240" },
+    { code: "GR", name: "Greece", flag: "🇬🇷", dialCode: "+30" },
+    { code: "GS", name: "South Georgia & South Sandwich Islands", flag: "🇬🇸", dialCode: null },
+    { code: "GT", name: "Guatemala", flag: "🇬🇹", dialCode: "+502" },
+    { code: "GU", name: "Guam", flag: "🇬🇺", dialCode: "+1671" },
+    { code: "GW", name: "Guinea-Bissau", flag: "🇬🇼", dialCode: "+245" },
+    { code: "GY", name: "Guyana", flag: "🇬🇾", dialCode: "+592" },
+    { code: "HK", name: "Hong Kong SAR China", flag: "🇭🇰", dialCode: "+852" },
+    { code: "HM", name: "Heard & McDonald Islands", flag: "🇭🇲", dialCode: null },
+    { code: "HN", name: "Honduras", flag: "🇭🇳", dialCode: "+504" },
+    { code: "HR", name: "Croatia", flag: "🇭🇷", dialCode: "+385" },
+    { code: "HT", name: "Haiti", flag: "🇭🇹", dialCode: "+509" },
+    { code: "HU", name: "Hungary", flag: "🇭🇺", dialCode: "+36" },
+    { code: "ID", name: "Indonesia", flag: "🇮🇩", dialCode: "+62" },
+    { code: "IE", name: "Ireland", flag: "🇮🇪", dialCode: "+353" },
+    { code: "IL", name: "Israel", flag: "🇮🇱", dialCode: "+972" },
+    { code: "IM", name: "Isle of Man", flag: "🇮🇲", dialCode: "+44" },
+    { code: "IN", name: "India", flag: "🇮🇳", dialCode: "+91" },
+    { code: "IO", name: "British Indian Ocean Territory", flag: "🇮🇴", dialCode: "+246" },
+    { code: "IQ", name: "Iraq", flag: "🇮🇶", dialCode: "+964" },
+    { code: "IR", name: "Iran", flag: "🇮🇷", dialCode: "+98" },
+    { code: "IS", name: "Iceland", flag: "🇮🇸", dialCode: "+354" },
+    { code: "IT", name: "Italy", flag: "🇮🇹", dialCode: "+39" },
+    { code: "JE", name: "Jersey", flag: "🇯🇪", dialCode: "+44" },
+    { code: "JM", name: "Jamaica", flag: "🇯🇲", dialCode: "+1876" },
+    { code: "JO", name: "Jordan", flag: "🇯🇴", dialCode: "+962" },
+    { code: "JP", name: "Japan", flag: "🇯🇵", dialCode: "+81" },
+    { code: "KE", name: "Kenya", flag: "🇰🇪", dialCode: "+254" },
+    { code: "KG", name: "Kyrgyzstan", flag: "🇰🇬", dialCode: "+996" },
+    { code: "KH", name: "Cambodia", flag: "🇰🇭", dialCode: "+855" },
+    { code: "KI", name: "Kiribati", flag: "🇰🇮", dialCode: "+686" },
+    { code: "KM", name: "Comoros", flag: "🇰🇲", dialCode: "+269" },
+    { code: "KN", name: "St. Kitts & Nevis", flag: "🇰🇳", dialCode: "+1869" },
+    { code: "KP", name: "North Korea", flag: "🇰🇵", dialCode: "+850" },
+    { code: "KR", name: "South Korea", flag: "🇰🇷", dialCode: "+82" },
+    { code: "KW", name: "Kuwait", flag: "🇰🇼", dialCode: "+965" },
+    { code: "KY", name: "Cayman Islands", flag: "🇰🇾", dialCode: "+1345" },
+    { code: "KZ", name: "Kazakhstan", flag: "🇰🇿", dialCode: "+7" },
+    { code: "LA", name: "Laos", flag: "🇱🇦", dialCode: "+856" },
+    { code: "LB", name: "Lebanon", flag: "🇱🇧", dialCode: "+961" },
+    { code: "LC", name: "St. Lucia", flag: "🇱🇨", dialCode: "+1758" },
+    { code: "LI", name: "Liechtenstein", flag: "🇱🇮", dialCode: "+423" },
+    { code: "LK", name: "Sri Lanka", flag: "🇱🇰", dialCode: "+94" },
+    { code: "LR", name: "Liberia", flag: "🇱🇷", dialCode: "+231" },
+    { code: "LS", name: "Lesotho", flag: "🇱🇸", dialCode: "+266" },
+    { code: "LT", name: "Lithuania", flag: "🇱🇹", dialCode: "+370" },
+    { code: "LU", name: "Luxembourg", flag: "🇱🇺", dialCode: "+352" },
+    { code: "LV", name: "Latvia", flag: "🇱🇻", dialCode: "+371" },
+    { code: "LY", name: "Libya", flag: "🇱🇾", dialCode: "+218" },
+    { code: "MA", name: "Morocco", flag: "🇲🇦", dialCode: "+212" },
+    { code: "MC", name: "Monaco", flag: "🇲🇨", dialCode: "+377" },
+    { code: "MD", name: "Moldova", flag: "🇲🇩", dialCode: "+373" },
+    { code: "ME", name: "Montenegro", flag: "🇲🇪", dialCode: "+382" },
+    { code: "MF", name: "St. Martin", flag: "🇲🇫", dialCode: "+590" },
+    { code: "MG", name: "Madagascar", flag: "🇲🇬", dialCode: "+261" },
+    { code: "MH", name: "Marshall Islands", flag: "🇲🇭", dialCode: "+692" },
+    { code: "MK", name: "North Macedonia", flag: "🇲🇰", dialCode: "+389" },
+    { code: "ML", name: "Mali", flag: "🇲🇱", dialCode: "+223" },
+    { code: "MM", name: "Myanmar (Burma)", flag: "🇲🇲", dialCode: "+95" },
+    { code: "MN", name: "Mongolia", flag: "🇲🇳", dialCode: "+976" },
+    { code: "MO", name: "Macao SAR China", flag: "🇲🇴", dialCode: "+853" },
+    { code: "MP", name: "Northern Mariana Islands", flag: "🇲🇵", dialCode: "+1670" },
+    { code: "MQ", name: "Martinique", flag: "🇲🇶", dialCode: "+596" },
+    { code: "MR", name: "Mauritania", flag: "🇲🇷", dialCode: "+222" },
+    { code: "MS", name: "Montserrat", flag: "🇲🇸", dialCode: "+1664" },
+    { code: "MT", name: "Malta", flag: "🇲🇹", dialCode: "+356" },
+    { code: "MU", name: "Mauritius", flag: "🇲🇺", dialCode: "+230" },
+    { code: "MV", name: "Maldives", flag: "🇲🇻", dialCode: "+960" },
+    { code: "MW", name: "Malawi", flag: "🇲🇼", dialCode: "+265" },
+    { code: "MX", name: "Mexico", flag: "🇲🇽", dialCode: "+52" },
+    { code: "MY", name: "Malaysia", flag: "🇲🇾", dialCode: "+60" },
+    { code: "MZ", name: "Mozambique", flag: "🇲🇿", dialCode: "+258" },
+    { code: "NA", name: "Namibia", flag: "🇳🇦", dialCode: "+264" },
+    { code: "NC", name: "New Caledonia", flag: "🇳🇨", dialCode: "+687" },
+    { code: "NE", name: "Niger", flag: "🇳🇪", dialCode: "+227" },
+    { code: "NF", name: "Norfolk Island", flag: "🇳🇫", dialCode: "+672" },
+    { code: "NG", name: "Nigeria", flag: "🇳🇬", dialCode: "+234" },
+    { code: "NI", name: "Nicaragua", flag: "🇳🇮", dialCode: "+505" },
+    { code: "NL", name: "Netherlands", flag: "🇳🇱", dialCode: "+31" },
+    { code: "NO", name: "Norway", flag: "🇳🇴", dialCode: "+47" },
+    { code: "NP", name: "Nepal", flag: "🇳🇵", dialCode: "+977" },
+    { code: "NR", name: "Nauru", flag: "🇳🇷", dialCode: "+674" },
+    { code: "NU", name: "Niue", flag: "🇳🇺", dialCode: "+683" },
+    { code: "NZ", name: "New Zealand", flag: "🇳🇿", dialCode: "+64" },
+    { code: "OM", name: "Oman", flag: "🇴🇲", dialCode: "+968" },
+    { code: "PA", name: "Panama", flag: "🇵🇦", dialCode: "+507" },
+    { code: "PE", name: "Peru", flag: "🇵🇪", dialCode: "+51" },
+    { code: "PF", name: "French Polynesia", flag: "🇵🇫", dialCode: "+689" },
+    { code: "PG", name: "Papua New Guinea", flag: "🇵🇬", dialCode: "+675" },
+    { code: "PH", name: "Philippines", flag: "🇵🇭", dialCode: "+63" },
+    { code: "PK", name: "Pakistan", flag: "🇵🇰", dialCode: "+92" },
+    { code: "PL", name: "Poland", flag: "🇵🇱", dialCode: "+48" },
+    { code: "PM", name: "St. Pierre & Miquelon", flag: "🇵🇲", dialCode: "+508" },
+    { code: "PN", name: "Pitcairn Islands", flag: "🇵🇳", dialCode: "+64" },
+    { code: "PR", name: "Puerto Rico", flag: "🇵🇷", dialCode: "+1787" },
+    { code: "PS", name: "Palestinian Territories", flag: "🇵🇸", dialCode: "+970" },
+    { code: "PT", name: "Portugal", flag: "🇵🇹", dialCode: "+351" },
+    { code: "PW", name: "Palau", flag: "🇵🇼", dialCode: "+680" },
+    { code: "PY", name: "Paraguay", flag: "🇵🇾", dialCode: "+595" },
+    { code: "QA", name: "Qatar", flag: "🇶🇦", dialCode: "+974" },
+    { code: "RE", name: "Réunion", flag: "🇷🇪", dialCode: "+262" },
+    { code: "RO", name: "Romania", flag: "🇷🇴", dialCode: "+40" },
+    { code: "RS", name: "Serbia", flag: "🇷🇸", dialCode: "+381" },
+    { code: "RU", name: "Russia", flag: "🇷🇺", dialCode: "+7" },
+    { code: "RW", name: "Rwanda", flag: "🇷🇼", dialCode: "+250" },
+    { code: "SA", name: "Saudi Arabia", flag: "🇸🇦", dialCode: "+966" },
+    { code: "SB", name: "Solomon Islands", flag: "🇸🇧", dialCode: "+677" },
+    { code: "SC", name: "Seychelles", flag: "🇸🇨", dialCode: "+248" },
+    { code: "SD", name: "Sudan", flag: "🇸🇩", dialCode: "+249" },
+    { code: "SE", name: "Sweden", flag: "🇸🇪", dialCode: "+46" },
+    { code: "SG", name: "Singapore", flag: "🇸🇬", dialCode: "+65" },
+    { code: "SH", name: "St. Helena", flag: "🇸🇭", dialCode: "+290" },
+    { code: "SI", name: "Slovenia", flag: "🇸🇮", dialCode: "+386" },
+    { code: "SJ", name: "Svalbard & Jan Mayen", flag: "🇸🇯", dialCode: "+47" },
+    { code: "SK", name: "Slovakia", flag: "🇸🇰", dialCode: "+421" },
+    { code: "SL", name: "Sierra Leone", flag: "🇸🇱", dialCode: "+232" },
+    { code: "SM", name: "San Marino", flag: "🇸🇲", dialCode: "+378" },
+    { code: "SN", name: "Senegal", flag: "🇸🇳", dialCode: "+221" },
+    { code: "SO", name: "Somalia", flag: "🇸🇴", dialCode: "+252" },
+    { code: "SR", name: "Suriname", flag: "🇸🇷", dialCode: "+597" },
+    { code: "SS", name: "South Sudan", flag: "🇸🇸", dialCode: "+211" },
+    { code: "ST", name: "São Tomé & Príncipe", flag: "🇸🇹", dialCode: "+239" },
+    { code: "SV", name: "El Salvador", flag: "🇸🇻", dialCode: "+503" },
+    { code: "SX", name: "Sint Maarten", flag: "🇸🇽", dialCode: "+1721" },
+    { code: "SY", name: "Syria", flag: "🇸🇾", dialCode: "+963" },
+    { code: "SZ", name: "Eswatini", flag: "🇸🇿", dialCode: "+268" },
+    { code: "TC", name: "Turks & Caicos Islands", flag: "🇹🇨", dialCode: "+1649" },
+    { code: "TD", name: "Chad", flag: "🇹🇩", dialCode: "+235" },
+    { code: "TF", name: "French Southern Territories", flag: "🇹🇫", dialCode: null },
+    { code: "TG", name: "Togo", flag: "🇹🇬", dialCode: "+228" },
+    { code: "TH", name: "Thailand", flag: "🇹🇭", dialCode: "+66" },
+    { code: "TJ", name: "Tajikistan", flag: "🇹🇯", dialCode: "+992" },
+    { code: "TK", name: "Tokelau", flag: "🇹🇰", dialCode: "+690" },
+    { code: "TL", name: "Timor-Leste", flag: "🇹🇱", dialCode: "+670" },
+    { code: "TM", name: "Turkmenistan", flag: "🇹🇲", dialCode: "+993" },
+    { code: "TN", name: "Tunisia", flag: "🇹🇳", dialCode: "+216" },
+    { code: "TO", name: "Tonga", flag: "🇹🇴", dialCode: "+676" },
+    { code: "TR", name: "Türkiye", flag: "🇹🇷", dialCode: "+90" },
+    { code: "TT", name: "Trinidad & Tobago", flag: "🇹🇹", dialCode: "+1868" },
+    { code: "TV", name: "Tuvalu", flag: "🇹🇻", dialCode: "+688" },
+    { code: "TW", name: "Taiwan", flag: "🇹🇼", dialCode: "+886" },
+    { code: "TZ", name: "Tanzania", flag: "🇹🇿", dialCode: "+255" },
+    { code: "UA", name: "Ukraine", flag: "🇺🇦", dialCode: "+380" },
+    { code: "UG", name: "Uganda", flag: "🇺🇬", dialCode: "+256" },
+    { code: "UM", name: "U.S. Outlying Islands", flag: "🇺🇲", dialCode: null },
+    { code: "US", name: "United States", flag: "🇺🇸", dialCode: "+1" },
+    { code: "UY", name: "Uruguay", flag: "🇺🇾", dialCode: "+598" },
+    { code: "UZ", name: "Uzbekistan", flag: "🇺🇿", dialCode: "+998" },
+    { code: "VA", name: "Vatican City", flag: "🇻🇦", dialCode: "+379" },
+    { code: "VC", name: "St. Vincent & Grenadines", flag: "🇻🇨", dialCode: "+1784" },
+    { code: "VE", name: "Venezuela", flag: "🇻🇪", dialCode: "+58" },
+    { code: "VG", name: "British Virgin Islands", flag: "🇻🇬", dialCode: "+1284" },
+    { code: "VI", name: "U.S. Virgin Islands", flag: "🇻🇮", dialCode: "+1340" },
+    { code: "VN", name: "Vietnam", flag: "🇻🇳", dialCode: "+84" },
+    { code: "VU", name: "Vanuatu", flag: "🇻🇺", dialCode: "+678" },
+    { code: "WF", name: "Wallis & Futuna", flag: "🇼🇫", dialCode: "+681" },
+    { code: "WS", name: "Samoa", flag: "🇼🇸", dialCode: "+685" },
+    { code: "YE", name: "Yemen", flag: "🇾🇪", dialCode: "+967" },
+    { code: "YT", name: "Mayotte", flag: "🇾🇹", dialCode: "+262" },
+    { code: "ZA", name: "South Africa", flag: "🇿🇦", dialCode: "+27" },
+    { code: "ZM", name: "Zambia", flag: "🇿🇲", dialCode: "+260" },
+    { code: "ZW", name: "Zimbabwe", flag: "🇿🇼", dialCode: "+263" },
 ];

package/dist/esm/index.d.ts

@@ -12,6 +12,13 @@ export declare function getCountryByFlag(flag: string): Country | undefined;
 export declare function getFlag(code: string): string | undefined;
 /** Get just the English name for a code. Returns undefined for unknown codes. */
 export declare function getName(code: string): string | undefined;
+/** Get the dial code (e.g. "+880") for an alpha-2 code. Returns null for territories with no dial code, undefined for unknown codes. */
+export declare function getDialCode(code: string): string | null | undefined;
+/**
+ * Get all countries that share a given dial code (e.g. "+1" → US, CA, and many Caribbean territories).
+ * The dialCode argument must include the leading "+".
+ */
+export declare function getCountriesByDialCode(dialCode: string): Country[];
 /** Check whether a string is a valid ISO 3166-1 alpha-2 code. */
 export declare function isValidCode(code: string): boolean;
 /**