@koshmoney/countries 1.0.1-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# @koshmoney/countries
+
+[![npm version](https://img.shields.io/npm/v/@koshmoney/countries.svg)](https://www.npmjs.com/package/@koshmoney/countries)
+[![npm downloads](https://img.shields.io/npm/dm/@koshmoney/countries.svg)](https://www.npmjs.com/package/@koshmoney/countries)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Complete ISO 3166-1 (countries) and ISO 3166-2 (subdivisions) lookup library with full TypeScript support.
+
+## Features
+
+- **Full ISO 3166-1 support**: alpha-2, alpha-3, numeric codes, and country names
+- **Full ISO 3166-2 support**: 5000+ subdivisions (states, provinces, regions, etc.)
+- **Code conversion utilities**: Convert between alpha-2, alpha-3, and numeric formats
+- **Validation functions**: Validate any country or subdivision code
+- **True tree-shaking**: Import only the countries you need
+- **Zero dependencies**: Lightweight and self-contained
+- **Full TypeScript support**: Complete type definitions included
+- **Dual module format**: ESM and CommonJS exports
+
+## Installation
+
+```bash
+npm install @koshmoney/countries
+```
+
+```bash
+yarn add @koshmoney/countries
+```
+
+```bash
+pnpm add @koshmoney/countries
+```
+
+## Quick Start
+
+```typescript
+import { country, subdivision } from '@koshmoney/countries';
+
+// Country lookups
+country.whereAlpha2('US');
+// { name: 'United States', alpha2: 'US', alpha3: 'USA', numeric: '840' }
+
+country.whereAlpha3('GBR');
+// { name: 'United Kingdom', alpha2: 'GB', alpha3: 'GBR', numeric: '826' }
+
+country.whereNumeric(276);
+// { name: 'Germany', alpha2: 'DE', alpha3: 'DEU', numeric: '276' }
+
+// Subdivision lookups
+subdivision.whereCode('US-CA');
+// { code: 'US-CA', name: 'California', type: 'State', countryCode: 'US', countryName: 'United States', regionCode: 'CA' }
+
+subdivision.where('GB', 'ENG');
+// { code: 'GB-ENG', name: 'England', type: 'Country', ... }
+
+subdivision.whereName('DE', 'Berlin');
+// { code: 'DE-BE', name: 'Berlin', ... }
+```
+
+## Usage
+
+### Country Functions
+
+```typescript
+import { country } from '@koshmoney/countries';
+
+// Lookups
+country.whereAlpha2('US');           // By alpha-2 code
+country.whereAlpha3('USA');          // By alpha-3 code
+country.whereNumeric(840);           // By numeric code
+country.whereName('United States');  // By name
+country.all();                       // Get all countries
+country.withSubdivisions('US');      // Country with all subdivisions
+
+// Conversions
+country.alpha2ToAlpha3('US');        // 'USA'
+country.alpha3ToAlpha2('USA');       // 'US'
+country.alpha2ToNumeric('US');       // '840'
+country.numericToAlpha2(840);        // 'US'
+country.toName('USA');               // 'United States'
+
+// Validation
+country.isAlpha2('US');              // true
+country.isAlpha3('USA');             // true
+country.isNumeric(840);              // true
+country.isValid('US');               // true (any format)
+country.detectFormat('USA');         // 'alpha3'
+```
+
+### Subdivision Functions
+
+```typescript
+import { subdivision } from '@koshmoney/countries';
+
+// Lookups
+subdivision.whereCode('US-CA');              // By full code
+subdivision.where('US', 'CA');               // By country + region code
+subdivision.whereName('US', 'California');   // By country + name
+subdivision.forCountry('US');                // All subdivisions for a country
+subdivision.all();                           // All subdivisions
+
+// Conversions
+subdivision.toRegionCode('US-CA');           // 'CA'
+subdivision.toFullCode('US', 'CA');          // 'US-CA'
+subdivision.toName('US-CA');                 // 'California'
+subdivision.toCountryCode('US-CA');          // 'US'
+
+// Validation
+subdivision.isValidCode('US-CA');            // true
+subdivision.isValidRegion('US', 'CA');       // true
+subdivision.isValidName('US', 'California'); // true
+subdivision.hasSubdivisions('US');           // true
+```
+
+### Direct Imports (Tree-Shakeable)
+
+```typescript
+// Country functions
+import {
+  whereAlpha2,
+  whereAlpha3,
+  whereNumeric,
+  alpha2ToAlpha3,
+  alpha3ToAlpha2,
+  isAlpha2,
+  isAlpha3,
+  isValid,
+} from '@koshmoney/countries/country';
+
+// Subdivision functions
+import {
+  whereCode,
+  where,
+  whereName,
+  forCountry,
+  isValidCode,
+  hasSubdivisions,
+} from '@koshmoney/countries/subdivision';
+```
+
+## Tree-Shaking
+
+This library supports true tree-shaking via subpath exports:
+
+### Full Library
+
+```typescript
+import { country, subdivision } from '@koshmoney/countries';
+```
+
+### Country Only
+
+```typescript
+import { whereAlpha2, alpha2ToAlpha3 } from '@koshmoney/countries/country';
+```
+
+### Specific Countries Only
+
+```typescript
+import { whereAlpha2 } from '@koshmoney/countries/country';
+import '@koshmoney/countries/subdivision/US';  // Only US subdivisions
+import '@koshmoney/countries/subdivision/CA';  // Only Canada subdivisions
+import { whereCode } from '@koshmoney/countries/subdivision';
+
+whereCode('US-CA');  // Works
+whereCode('GB-ENG'); // Returns null (GB not imported)
+```
+
+See [Tree-Shaking Guide](./docs/TREE_SHAKING.md) for more details.
+
+## Handling Invalid Inputs
+
+All lookup functions return `null` for invalid inputs:
+
+```typescript
+import { country, subdivision } from '@koshmoney/countries';
+
+// Invalid country codes
+country.whereAlpha2('XX');        // null
+country.whereAlpha3('ZZZ');       // null
+country.whereNumeric(999);        // null
+country.whereName('Narnia');      // null
+
+// Invalid subdivisions
+subdivision.whereCode('XX-YY');   // null
+subdivision.whereCode('US-XX');   // null
+subdivision.where('XX', 'CA');    // null
+
+// Check if country has subdivisions
+subdivision.hasSubdivisions('US');  // true
+subdivision.hasSubdivisions('XX');  // false
+
+// Validation
+country.isValid('XX');              // false
+subdivision.isValidCode('XX-YY');   // false
+```
+
+## Supported Countries
+
+Examples of supported countries and their subdivisions:
+
+| Country | Code | Subdivisions |
+|---------|------|--------------|
+| United States | US | 50 states + territories (US-CA, US-NY, US-TX, ...) |
+| United Kingdom | GB | 4 countries + regions (GB-ENG, GB-SCT, GB-WLS, GB-NIR, ...) |
+| Germany | DE | 16 federal states (DE-BY, DE-BE, DE-HH, ...) |
+| Japan | JP | 47 prefectures (JP-13, JP-27, JP-01, ...) |
+| India | IN | 28 states + 8 territories (IN-MH, IN-DL, IN-KA, ...) |
+| Canada | CA | 13 provinces/territories (CA-ON, CA-BC, CA-QC, ...) |
+| Australia | AU | 8 states/territories (AU-NSW, AU-VIC, AU-QLD, ...) |
+| France | FR | 18 regions (FR-IDF, FR-PAC, FR-ARA, ...) |
+| ... | ... | 5000+ total subdivisions |
+
+## Types
+
+```typescript
+interface Country {
+  name: string;      // "United States"
+  alpha2: string;    // "US"
+  alpha3: string;    // "USA"
+  numeric: string;   // "840"
+}
+
+interface Subdivision {
+  code: string;        // "US-CA"
+  name: string;        // "California"
+  type: string;        // "State"
+  countryCode: string; // "US"
+  countryName: string; // "United States"
+  regionCode: string;  // "CA"
+}
+
+interface CountryWithSubdivisions extends Country {
+  subdivisions: Subdivision[];
+}
+```
+
+## API Reference
+
+See [API Documentation](./docs/API.md) for complete API reference.
+
+## Migration
+
+Migrating from `iso-3166-1` or `iso-3166-2`? See [Migration Guide](./docs/MIGRATION.md).
+
+## Data Sources
+
+- [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1): Country codes (alpha-2, alpha-3, numeric)
+- [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2): Subdivision codes
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT

package/dist/country/index.cjs

@@ -0,0 +1 @@
+'use strict';var i={AD:{name:"Andorra",alpha3:"AND",numeric:"020"},AE:{name:"United Arab Emirates",alpha3:"ARE",numeric:"784"},AF:{name:"Afghanistan",alpha3:"AFG",numeric:"004"},AG:{name:"Antigua and Barbuda",alpha3:"ATG",numeric:"028"},AI:{name:"Anguilla",alpha3:"AIA",numeric:"660"},AL:{name:"Albania",alpha3:"ALB",numeric:"008"},AM:{name:"Armenia",alpha3:"ARM",numeric:"051"},AO:{name:"Angola",alpha3:"AGO",numeric:"024"},AQ:{name:"Antarctica",alpha3:"ATA",numeric:"010"},AR:{name:"Argentina",alpha3:"ARG",numeric:"032"},AS:{name:"American Samoa",alpha3:"ASM",numeric:"016"},AT:{name:"Austria",alpha3:"AUT",numeric:"040"},AU:{name:"Australia",alpha3:"AUS",numeric:"036"},AW:{name:"Aruba",alpha3:"ABW",numeric:"533"},AX:{name:"\xC5land Islands",alpha3:"ALA",numeric:"248"},AZ:{name:"Azerbaijan",alpha3:"AZE",numeric:"031"},BA:{name:"Bosnia and Herzegovina",alpha3:"BIH",numeric:"070"},BB:{name:"Barbados",alpha3:"BRB",numeric:"052"},BD:{name:"Bangladesh",alpha3:"BGD",numeric:"050"},BE:{name:"Belgium",alpha3:"BEL",numeric:"056"},BF:{name:"Burkina Faso",alpha3:"BFA",numeric:"854"},BG:{name:"Bulgaria",alpha3:"BGR",numeric:"100"},BH:{name:"Bahrain",alpha3:"BHR",numeric:"048"},BI:{name:"Burundi",alpha3:"BDI",numeric:"108"},BJ:{name:"Benin",alpha3:"BEN",numeric:"204"},BL:{name:"St. Barth\xE9lemy",alpha3:"BLM",numeric:"652"},BM:{name:"Bermuda",alpha3:"BMU",numeric:"060"},BN:{name:"Brunei Darussalam",alpha3:"BRN",numeric:"096"},BO:{name:"Bolivia",alpha3:"BOL",numeric:"068"},BQ:{name:"Bonaire, Sint Eustatius and Saba",alpha3:"BES",numeric:"535"},BR:{name:"Brazil",alpha3:"BRA",numeric:"076"},BS:{name:"Bahamas",alpha3:"BHS",numeric:"044"},BT:{name:"Bhutan",alpha3:"BTN",numeric:"064"},BV:{name:"Bouvet Island",alpha3:"BVT",numeric:"074"},BW:{name:"Botswana",alpha3:"BWA",numeric:"072"},BY:{name:"Belarus",alpha3:"BLR",numeric:"112"},BZ:{name:"Belize",alpha3:"BLZ",numeric:"084"},CA:{name:"Canada",alpha3:"CAN",numeric:"124"},CC:{name:"Cocos  Islands",alpha3:"CCK",numeric:"166"},CD:{name:"Congo, The Democratic Republic Of The",alpha3:"COD",numeric:"180"},CF:{name:"Central African Republic",alpha3:"CAF",numeric:"140"},CG:{name:"Congo",alpha3:"COG",numeric:"178"},CH:{name:"Switzerland",alpha3:"CHE",numeric:"756"},CI:{name:"C\xF4te D'Ivoire",alpha3:"CIV",numeric:"384"},CK:{name:"Cook Islands",alpha3:"COK",numeric:"184"},CL:{name:"Chile",alpha3:"CHL",numeric:"152"},CM:{name:"Cameroon",alpha3:"CMR",numeric:"120"},CN:{name:"China",alpha3:"CHN",numeric:"156"},CO:{name:"Colombia",alpha3:"COL",numeric:"170"},CR:{name:"Costa Rica",alpha3:"CRI",numeric:"188"},CU:{name:"Cuba",alpha3:"CUB",numeric:"192"},CV:{name:"Cape Verde",alpha3:"CPV",numeric:"132"},CW:{name:"Cura\xE7ao",alpha3:"CUW",numeric:"531"},CX:{name:"Christmas Island",alpha3:"CXR",numeric:"162"},CY:{name:"Cyprus",alpha3:"CYP",numeric:"196"},CZ:{name:"Czech Republic",alpha3:"CZE",numeric:"203"},DE:{name:"Germany",alpha3:"DEU",numeric:"276"},DJ:{name:"Djibouti",alpha3:"DJI",numeric:"262"},DK:{name:"Denmark",alpha3:"DNK",numeric:"208"},DM:{name:"Dominica",alpha3:"DMA",numeric:"212"},DO:{name:"Dominican Republic",alpha3:"DOM",numeric:"214"},DZ:{name:"Algeria",alpha3:"DZA",numeric:"012"},EC:{name:"Ecuador",alpha3:"ECU",numeric:"218"},EE:{name:"Estonia",alpha3:"EST",numeric:"233"},EG:{name:"Egypt",alpha3:"EGY",numeric:"818"},EH:{name:"Western Sahara",alpha3:"ESH",numeric:"732"},ER:{name:"Eritrea",alpha3:"ERI",numeric:"232"},ES:{name:"Spain",alpha3:"ESP",numeric:"724"},ET:{name:"Ethiopia",alpha3:"ETH",numeric:"231"},FI:{name:"Finland",alpha3:"FIN",numeric:"246"},FJ:{name:"Fiji",alpha3:"FJI",numeric:"242"},FK:{name:"Falkland Islands",alpha3:"FLK",numeric:"238"},FM:{name:"Micronesia, Federated States Of",alpha3:"FSM",numeric:"583"},FO:{name:"Faroe Islands",alpha3:"FRO",numeric:"234"},FR:{name:"France",alpha3:"FRA",numeric:"250"},GA:{name:"Gabon",alpha3:"GAB",numeric:"266"},GB:{name:"United Kingdom",alpha3:"GBR",numeric:"826"},GD:{name:"Grenada",alpha3:"GRD",numeric:"308"},GE:{name:"Georgia",alpha3:"GEO",numeric:"268"},GF:{name:"French Guiana",alpha3:"GUF",numeric:"254"},GG:{name:"Guernsey",alpha3:"GGY",numeric:"831"},GH:{name:"Ghana",alpha3:"GHA",numeric:"288"},GI:{name:"Gibraltar",alpha3:"GIB",numeric:"292"},GL:{name:"Greenland",alpha3:"GRL",numeric:"304"},GM:{name:"Gambia",alpha3:"GMB",numeric:"270"},GN:{name:"Guinea",alpha3:"GIN",numeric:"324"},GP:{name:"Guadeloupe",alpha3:"GLP",numeric:"312"},GQ:{name:"Equatorial Guinea",alpha3:"GNQ",numeric:"226"},GR:{name:"Greece",alpha3:"GRC",numeric:"300"},GS:{name:"S.Georgia & S.Sandwich Islands",alpha3:"SGS",numeric:"239"},GT:{name:"Guatemala",alpha3:"GTM",numeric:"320"},GU:{name:"Guam",alpha3:"GUM",numeric:"316"},GW:{name:"Guinea-Bissau",alpha3:"GNB",numeric:"624"},GY:{name:"Guyana",alpha3:"GUY",numeric:"328"},HK:{name:"Hong Kong",alpha3:"HKG",numeric:"344"},HM:{name:"Heard & McDonald Islands",alpha3:"HMD",numeric:"334"},HN:{name:"Honduras",alpha3:"HND",numeric:"340"},HR:{name:"Croatia",alpha3:"HRV",numeric:"191"},HT:{name:"Haiti",alpha3:"HTI",numeric:"332"},HU:{name:"Hungary",alpha3:"HUN",numeric:"348"},ID:{name:"Indonesia",alpha3:"IDN",numeric:"360"},IE:{name:"Ireland",alpha3:"IRL",numeric:"372"},IL:{name:"Israel",alpha3:"ISR",numeric:"376"},IM:{name:"Isle of Man",alpha3:"IMN",numeric:"833"},IN:{name:"India",alpha3:"IND",numeric:"356"},IO:{name:"British Indian Ocean Territory",alpha3:"IOT",numeric:"086"},IQ:{name:"Iraq",alpha3:"IRQ",numeric:"368"},IR:{name:"Iran",alpha3:"IRN",numeric:"364"},IS:{name:"Iceland",alpha3:"ISL",numeric:"352"},IT:{name:"Italy",alpha3:"ITA",numeric:"380"},JE:{name:"Jersey",alpha3:"JEY",numeric:"832"},JM:{name:"Jamaica",alpha3:"JAM",numeric:"388"},JO:{name:"Jordan",alpha3:"JOR",numeric:"400"},JP:{name:"Japan",alpha3:"JPN",numeric:"392"},KE:{name:"Kenya",alpha3:"KEN",numeric:"404"},KG:{name:"Kyrgyzstan",alpha3:"KGZ",numeric:"417"},KH:{name:"Cambodia",alpha3:"KHM",numeric:"116"},KI:{name:"Kiribati",alpha3:"KIR",numeric:"296"},KM:{name:"Comoros",alpha3:"COM",numeric:"174"},KN:{name:"Saint Kitts And Nevis",alpha3:"KNA",numeric:"659"},KP:{name:"Korea, Democratic People's Republic Of",alpha3:"PRK",numeric:"408"},KR:{name:"Korea, Republic of",alpha3:"KOR",numeric:"410"},KW:{name:"Kuwait",alpha3:"KWT",numeric:"414"},KY:{name:"Cayman Islands",alpha3:"CYM",numeric:"136"},KZ:{name:"Kazakhstan",alpha3:"KAZ",numeric:"398"},LA:{name:"Laos",alpha3:"LAO",numeric:"418"},LB:{name:"Lebanon",alpha3:"LBN",numeric:"422"},LC:{name:"Saint Lucia",alpha3:"LCA",numeric:"662"},LI:{name:"Liechtenstein",alpha3:"LIE",numeric:"438"},LK:{name:"Sri Lanka",alpha3:"LKA",numeric:"144"},LR:{name:"Liberia",alpha3:"LBR",numeric:"430"},LS:{name:"Lesotho",alpha3:"LSO",numeric:"426"},LT:{name:"Lithuania",alpha3:"LTU",numeric:"440"},LU:{name:"Luxembourg",alpha3:"LUX",numeric:"442"},LV:{name:"Latvia",alpha3:"LVA",numeric:"428"},LY:{name:"Libya",alpha3:"LBY",numeric:"434"},MA:{name:"Morocco",alpha3:"MAR",numeric:"504"},MC:{name:"Monaco",alpha3:"MCO",numeric:"492"},MD:{name:"Moldova",alpha3:"MDA",numeric:"498"},ME:{name:"Montenegro",alpha3:"MNE",numeric:"499"},MF:{name:"St. Martin",alpha3:"MAF",numeric:"663"},MG:{name:"Madagascar",alpha3:"MDG",numeric:"450"},MH:{name:"Marshall Islands",alpha3:"MHL",numeric:"584"},MK:{name:"Macedonia, the Former Yugoslav Republic Of",alpha3:"MKD",numeric:"807"},ML:{name:"Mali",alpha3:"MLI",numeric:"466"},MM:{name:"Myanmar",alpha3:"MMR",numeric:"104"},MN:{name:"Mongolia",alpha3:"MNG",numeric:"496"},MO:{name:"Macau",alpha3:"MAC",numeric:"446"},MP:{name:"Northern Mariana Islands",alpha3:"MNP",numeric:"580"},MQ:{name:"Martinique",alpha3:"MTQ",numeric:"474"},MR:{name:"Mauritania",alpha3:"MRT",numeric:"478"},MS:{name:"Montserrat",alpha3:"MSR",numeric:"500"},MT:{name:"Malta",alpha3:"MLT",numeric:"470"},MU:{name:"Mauritius",alpha3:"MUS",numeric:"480"},MV:{name:"Maldives",alpha3:"MDV",numeric:"462"},MW:{name:"Malawi",alpha3:"MWI",numeric:"454"},MX:{name:"Mexico",alpha3:"MEX",numeric:"484"},MY:{name:"Malaysia",alpha3:"MYS",numeric:"458"},MZ:{name:"Mozambique",alpha3:"MOZ",numeric:"508"},NA:{name:"Namibia",alpha3:"NAM",numeric:"516"},NC:{name:"New Caledonia",alpha3:"NCL",numeric:"540"},NE:{name:"Niger",alpha3:"NER",numeric:"562"},NF:{name:"Norfolk Island",alpha3:"NFK",numeric:"574"},NG:{name:"Nigeria",alpha3:"NGA",numeric:"566"},NI:{name:"Nicaragua",alpha3:"NIC",numeric:"558"},NL:{name:"Netherlands",alpha3:"NLD",numeric:"528"},NO:{name:"Norway",alpha3:"NOR",numeric:"578"},NP:{name:"Nepal",alpha3:"NPL",numeric:"524"},NR:{name:"Nauru",alpha3:"NRU",numeric:"520"},NU:{name:"Niue",alpha3:"NIU",numeric:"570"},NZ:{name:"New Zealand",alpha3:"NZL",numeric:"554"},OM:{name:"Oman",alpha3:"OMN",numeric:"512"},PA:{name:"Panama",alpha3:"PAN",numeric:"591"},PE:{name:"Peru",alpha3:"PER",numeric:"604"},PF:{name:"French Polynesia",alpha3:"PYF",numeric:"258"},PG:{name:"Papua New Guinea",alpha3:"PNG",numeric:"598"},PH:{name:"Philippines",alpha3:"PHL",numeric:"608"},PK:{name:"Pakistan",alpha3:"PAK",numeric:"586"},PL:{name:"Poland",alpha3:"POL",numeric:"616"},PM:{name:"St. Pierre & Miquelon",alpha3:"SPM",numeric:"666"},PN:{name:"Pitcairn",alpha3:"PCN",numeric:"612"},PR:{name:"Puerto Rico",alpha3:"PRI",numeric:"630"},PS:{name:"Palestine",alpha3:"PSE",numeric:"275"},PT:{name:"Portugal",alpha3:"PRT",numeric:"620"},PW:{name:"Palau",alpha3:"PLW",numeric:"585"},PY:{name:"Paraguay",alpha3:"PRY",numeric:"600"},QA:{name:"Qatar",alpha3:"QAT",numeric:"634"},RE:{name:"Reunion",alpha3:"REU",numeric:"638"},RO:{name:"Romania",alpha3:"ROU",numeric:"642"},RS:{name:"Serbia",alpha3:"SRB",numeric:"688"},RU:{name:"Russia",alpha3:"RUS",numeric:"643"},RW:{name:"Rwanda",alpha3:"RWA",numeric:"646"},SA:{name:"Saudi Arabia",alpha3:"SAU",numeric:"682"},SB:{name:"Solomon Islands",alpha3:"SLB",numeric:"090"},SC:{name:"Seychelles",alpha3:"SYC",numeric:"690"},SD:{name:"Sudan",alpha3:"SDN",numeric:"729"},SE:{name:"Sweden",alpha3:"SWE",numeric:"752"},SG:{name:"Singapore",alpha3:"SGP",numeric:"702"},SH:{name:"Saint Helena, Ascension and Tristan Da Cunha",alpha3:"SHN",numeric:"654"},SI:{name:"Slovenia",alpha3:"SVN",numeric:"705"},SJ:{name:"Svalbard & Jan Mayen Islands",alpha3:"SJM",numeric:"744"},SK:{name:"Slovakia",alpha3:"SVK",numeric:"703"},SL:{name:"Sierra Leone",alpha3:"SLE",numeric:"694"},SM:{name:"San Marino",alpha3:"SMR",numeric:"674"},SN:{name:"Senegal",alpha3:"SEN",numeric:"686"},SO:{name:"Somalia",alpha3:"SOM",numeric:"706"},SR:{name:"Suriname",alpha3:"SUR",numeric:"740"},SS:{name:"South Sudan",alpha3:"SSD",numeric:"728"},ST:{name:"Sao Tome and Principe",alpha3:"STP",numeric:"678"},SV:{name:"El Salvador",alpha3:"SLV",numeric:"222"},SX:{name:"St. Maarten",alpha3:"SXM",numeric:"534"},SY:{name:"Syria",alpha3:"SYR",numeric:"760"},SZ:{name:"Swaziland",alpha3:"SWZ",numeric:"748"},TC:{name:"Turks & Caicos Islands",alpha3:"TCA",numeric:"796"},TD:{name:"Chad",alpha3:"TCD",numeric:"148"},TF:{name:"French Southern Territories",alpha3:"ATF",numeric:"260"},TG:{name:"Togo",alpha3:"TGO",numeric:"768"},TH:{name:"Thailand",alpha3:"THA",numeric:"764"},TJ:{name:"Tajikistan",alpha3:"TJK",numeric:"762"},TK:{name:"Tokelau",alpha3:"TKL",numeric:"772"},TL:{name:"East Timor",alpha3:"TLS",numeric:"626"},TM:{name:"Turkmenistan",alpha3:"TKM",numeric:"795"},TN:{name:"Tunisia",alpha3:"TUN",numeric:"788"},TO:{name:"Tonga",alpha3:"TON",numeric:"776"},TR:{name:"Turkey",alpha3:"TUR",numeric:"792"},TT:{name:"Trinidad and Tobago",alpha3:"TTO",numeric:"780"},TV:{name:"Tuvalu",alpha3:"TUV",numeric:"798"},TW:{name:"Taiwan",alpha3:"TWN",numeric:"158"},TZ:{name:"Tanzania",alpha3:"TZA",numeric:"834"},UA:{name:"Ukraine",alpha3:"UKR",numeric:"804"},UG:{name:"Uganda",alpha3:"UGA",numeric:"800"},UM:{name:"United States Minor Outlying Islands",alpha3:"UMI",numeric:"581"},US:{name:"United States",alpha3:"USA",numeric:"840"},UY:{name:"Uruguay",alpha3:"URY",numeric:"858"},UZ:{name:"Uzbekistan",alpha3:"UZB",numeric:"860"},VA:{name:"Vatican City",alpha3:"VAT",numeric:"336"},VC:{name:"Saint Vincent And The Grenadines",alpha3:"VCT",numeric:"670"},VE:{name:"Venezuela",alpha3:"VEN",numeric:"862"},VG:{name:"Virgin Islands",alpha3:"VGB",numeric:"092"},VI:{name:"Virgin Islands",alpha3:"VIR",numeric:"850"},VN:{name:"Viet Nam",alpha3:"VNM",numeric:"704"},VU:{name:"Vanuatu",alpha3:"VUT",numeric:"548"},WF:{name:"Wallis & Futuna Islands",alpha3:"WLF",numeric:"876"},WS:{name:"Samoa",alpha3:"WSM",numeric:"882"},YE:{name:"Yemen",alpha3:"YEM",numeric:"887"},YT:{name:"Mayotte",alpha3:"MYT",numeric:"175"},ZA:{name:"South Africa",alpha3:"ZAF",numeric:"710"},ZM:{name:"Zambia",alpha3:"ZMB",numeric:"894"},ZW:{name:"Zimbabwe",alpha3:"ZWE",numeric:"716"}},A={AND:"AD",ARE:"AE",AFG:"AF",ATG:"AG",AIA:"AI",ALB:"AL",ARM:"AM",AGO:"AO",ATA:"AQ",ARG:"AR",ASM:"AS",AUT:"AT",AUS:"AU",ABW:"AW",ALA:"AX",AZE:"AZ",BIH:"BA",BRB:"BB",BGD:"BD",BEL:"BE",BFA:"BF",BGR:"BG",BHR:"BH",BDI:"BI",BEN:"BJ",BLM:"BL",BMU:"BM",BRN:"BN",BOL:"BO",BES:"BQ",BRA:"BR",BHS:"BS",BTN:"BT",BVT:"BV",BWA:"BW",BLR:"BY",BLZ:"BZ",CAN:"CA",CCK:"CC",COD:"CD",CAF:"CF",COG:"CG",CHE:"CH",CIV:"CI",COK:"CK",CHL:"CL",CMR:"CM",CHN:"CN",COL:"CO",CRI:"CR",CUB:"CU",CPV:"CV",CUW:"CW",CXR:"CX",CYP:"CY",CZE:"CZ",DEU:"DE",DJI:"DJ",DNK:"DK",DMA:"DM",DOM:"DO",DZA:"DZ",ECU:"EC",EST:"EE",EGY:"EG",ESH:"EH",ERI:"ER",ESP:"ES",ETH:"ET",FIN:"FI",FJI:"FJ",FLK:"FK",FSM:"FM",FRO:"FO",FRA:"FR",GAB:"GA",GBR:"GB",GRD:"GD",GEO:"GE",GUF:"GF",GGY:"GG",GHA:"GH",GIB:"GI",GRL:"GL",GMB:"GM",GIN:"GN",GLP:"GP",GNQ:"GQ",GRC:"GR",SGS:"GS",GTM:"GT",GUM:"GU",GNB:"GW",GUY:"GY",HKG:"HK",HMD:"HM",HND:"HN",HRV:"HR",HTI:"HT",HUN:"HU",IDN:"ID",IRL:"IE",ISR:"IL",IMN:"IM",IND:"IN",IOT:"IO",IRQ:"IQ",IRN:"IR",ISL:"IS",ITA:"IT",JEY:"JE",JAM:"JM",JOR:"JO",JPN:"JP",KEN:"KE",KGZ:"KG",KHM:"KH",KIR:"KI",COM:"KM",KNA:"KN",PRK:"KP",KOR:"KR",KWT:"KW",CYM:"KY",KAZ:"KZ",LAO:"LA",LBN:"LB",LCA:"LC",LIE:"LI",LKA:"LK",LBR:"LR",LSO:"LS",LTU:"LT",LUX:"LU",LVA:"LV",LBY:"LY",MAR:"MA",MCO:"MC",MDA:"MD",MNE:"ME",MAF:"MF",MDG:"MG",MHL:"MH",MKD:"MK",MLI:"ML",MMR:"MM",MNG:"MN",MAC:"MO",MNP:"MP",MTQ:"MQ",MRT:"MR",MSR:"MS",MLT:"MT",MUS:"MU",MDV:"MV",MWI:"MW",MEX:"MX",MYS:"MY",MOZ:"MZ",NAM:"NA",NCL:"NC",NER:"NE",NFK:"NF",NGA:"NG",NIC:"NI",NLD:"NL",NOR:"NO",NPL:"NP",NRU:"NR",NIU:"NU",NZL:"NZ",OMN:"OM",PAN:"PA",PER:"PE",PYF:"PF",PNG:"PG",PHL:"PH",PAK:"PK",POL:"PL",SPM:"PM",PCN:"PN",PRI:"PR",PSE:"PS",PRT:"PT",PLW:"PW",PRY:"PY",QAT:"QA",REU:"RE",ROU:"RO",SRB:"RS",RUS:"RU",RWA:"RW",SAU:"SA",SLB:"SB",SYC:"SC",SDN:"SD",SWE:"SE",SGP:"SG",SHN:"SH",SVN:"SI",SJM:"SJ",SVK:"SK",SLE:"SL",SMR:"SM",SEN:"SN",SOM:"SO",SUR:"SR",SSD:"SS",STP:"ST",SLV:"SV",SXM:"SX",SYR:"SY",SWZ:"SZ",TCA:"TC",TCD:"TD",ATF:"TF",TGO:"TG",THA:"TH",TJK:"TJ",TKL:"TK",TLS:"TL",TKM:"TM",TUN:"TN",TON:"TO",TUR:"TR",TTO:"TT",TUV:"TV",TWN:"TW",TZA:"TZ",UKR:"UA",UGA:"UG",UMI:"UM",USA:"US",URY:"UY",UZB:"UZ",VAT:"VA",VCT:"VC",VEN:"VE",VGB:"VG",VIR:"VI",VNM:"VN",VUT:"VU",WLF:"WF",WSM:"WS",YEM:"YE",MYT:"YT",ZAF:"ZA",ZMB:"ZM",ZWE:"ZW"},u={"020":"AD",784:"AE","004":"AF","028":"AG",660:"AI","008":"AL","051":"AM","024":"AO","010":"AQ","032":"AR","016":"AS","040":"AT","036":"AU",533:"AW",248:"AX","031":"AZ","070":"BA","052":"BB","050":"BD","056":"BE",854:"BF",100:"BG","048":"BH",108:"BI",204:"BJ",652:"BL","060":"BM","096":"BN","068":"BO",535:"BQ","076":"BR","044":"BS","064":"BT","074":"BV","072":"BW",112:"BY","084":"BZ",124:"CA",166:"CC",180:"CD",140:"CF",178:"CG",756:"CH",384:"CI",184:"CK",152:"CL",120:"CM",156:"CN",170:"CO",188:"CR",192:"CU",132:"CV",531:"CW",162:"CX",196:"CY",203:"CZ",276:"DE",262:"DJ",208:"DK",212:"DM",214:"DO","012":"DZ",218:"EC",233:"EE",818:"EG",732:"EH",232:"ER",724:"ES",231:"ET",246:"FI",242:"FJ",238:"FK",583:"FM",234:"FO",250:"FR",266:"GA",826:"GB",308:"GD",268:"GE",254:"GF",831:"GG",288:"GH",292:"GI",304:"GL",270:"GM",324:"GN",312:"GP",226:"GQ",300:"GR",239:"GS",320:"GT",316:"GU",624:"GW",328:"GY",344:"HK",334:"HM",340:"HN",191:"HR",332:"HT",348:"HU",360:"ID",372:"IE",376:"IL",833:"IM",356:"IN","086":"IO",368:"IQ",364:"IR",352:"IS",380:"IT",832:"JE",388:"JM",400:"JO",392:"JP",404:"KE",417:"KG",116:"KH",296:"KI",174:"KM",659:"KN",408:"KP",410:"KR",414:"KW",136:"KY",398:"KZ",418:"LA",422:"LB",662:"LC",438:"LI",144:"LK",430:"LR",426:"LS",440:"LT",442:"LU",428:"LV",434:"LY",504:"MA",492:"MC",498:"MD",499:"ME",663:"MF",450:"MG",584:"MH",807:"MK",466:"ML",104:"MM",496:"MN",446:"MO",580:"MP",474:"MQ",478:"MR",500:"MS",470:"MT",480:"MU",462:"MV",454:"MW",484:"MX",458:"MY",508:"MZ",516:"NA",540:"NC",562:"NE",574:"NF",566:"NG",558:"NI",528:"NL",578:"NO",524:"NP",520:"NR",570:"NU",554:"NZ",512:"OM",591:"PA",604:"PE",258:"PF",598:"PG",608:"PH",586:"PK",616:"PL",666:"PM",612:"PN",630:"PR",275:"PS",620:"PT",585:"PW",600:"PY",634:"QA",638:"RE",642:"RO",688:"RS",643:"RU",646:"RW",682:"SA","090":"SB",690:"SC",729:"SD",752:"SE",702:"SG",654:"SH",705:"SI",744:"SJ",703:"SK",694:"SL",674:"SM",686:"SN",706:"SO",740:"SR",728:"SS",678:"ST",222:"SV",534:"SX",760:"SY",748:"SZ",796:"TC",148:"TD",260:"TF",768:"TG",764:"TH",762:"TJ",772:"TK",626:"TL",795:"TM",788:"TN",776:"TO",792:"TR",780:"TT",798:"TV",158:"TW",834:"TZ",804:"UA",800:"UG",581:"UM",840:"US",858:"UY",860:"UZ",336:"VA",670:"VC",862:"VE","092":"VG",850:"VI",704:"VN",548:"VU",876:"WF",882:"WS",887:"YE",175:"YT",710:"ZA",894:"ZM",716:"ZW"},l={ANDORRA:"AD","UNITED ARAB EMIRATES":"AE",AFGHANISTAN:"AF","ANTIGUA AND BARBUDA":"AG",ANGUILLA:"AI",ALBANIA:"AL",ARMENIA:"AM",ANGOLA:"AO",ANTARCTICA:"AQ",ARGENTINA:"AR","AMERICAN SAMOA":"AS",AUSTRIA:"AT",AUSTRALIA:"AU",ARUBA:"AW","\xC5LAND ISLANDS":"AX",AZERBAIJAN:"AZ","BOSNIA AND HERZEGOVINA":"BA",BARBADOS:"BB",BANGLADESH:"BD",BELGIUM:"BE","BURKINA FASO":"BF",BULGARIA:"BG",BAHRAIN:"BH",BURUNDI:"BI",BENIN:"BJ","ST. BARTH\xC9LEMY":"BL",BERMUDA:"BM","BRUNEI DARUSSALAM":"BN",BOLIVIA:"BO","BONAIRE, SINT EUSTATIUS AND SABA":"BQ",BRAZIL:"BR",BAHAMAS:"BS",BHUTAN:"BT","BOUVET ISLAND":"BV",BOTSWANA:"BW",BELARUS:"BY",BELIZE:"BZ",CANADA:"CA","COCOS  ISLANDS":"CC","CONGO, THE DEMOCRATIC REPUBLIC OF THE":"CD","CENTRAL AFRICAN REPUBLIC":"CF",CONGO:"CG",SWITZERLAND:"CH","C\xD4TE D'IVOIRE":"CI","COOK ISLANDS":"CK",CHILE:"CL",CAMEROON:"CM",CHINA:"CN",COLOMBIA:"CO","COSTA RICA":"CR",CUBA:"CU","CAPE VERDE":"CV",CURA\u00C7AO:"CW","CHRISTMAS ISLAND":"CX",CYPRUS:"CY","CZECH REPUBLIC":"CZ",GERMANY:"DE",DJIBOUTI:"DJ",DENMARK:"DK",DOMINICA:"DM","DOMINICAN REPUBLIC":"DO",ALGERIA:"DZ",ECUADOR:"EC",ESTONIA:"EE",EGYPT:"EG","WESTERN SAHARA":"EH",ERITREA:"ER",SPAIN:"ES",ETHIOPIA:"ET",FINLAND:"FI",FIJI:"FJ","FALKLAND ISLANDS":"FK","MICRONESIA, FEDERATED STATES OF":"FM","FAROE ISLANDS":"FO",FRANCE:"FR",GABON:"GA","UNITED KINGDOM":"GB",GRENADA:"GD",GEORGIA:"GE","FRENCH GUIANA":"GF",GUERNSEY:"GG",GHANA:"GH",GIBRALTAR:"GI",GREENLAND:"GL",GAMBIA:"GM",GUINEA:"GN",GUADELOUPE:"GP","EQUATORIAL GUINEA":"GQ",GREECE:"GR","S.GEORGIA & S.SANDWICH ISLANDS":"GS",GUATEMALA:"GT",GUAM:"GU","GUINEA-BISSAU":"GW",GUYANA:"GY","HONG KONG":"HK","HEARD & MCDONALD ISLANDS":"HM",HONDURAS:"HN",CROATIA:"HR",HAITI:"HT",HUNGARY:"HU",INDONESIA:"ID",IRELAND:"IE",ISRAEL:"IL","ISLE OF MAN":"IM",INDIA:"IN","BRITISH INDIAN OCEAN TERRITORY":"IO",IRAQ:"IQ",IRAN:"IR",ICELAND:"IS",ITALY:"IT",JERSEY:"JE",JAMAICA:"JM",JORDAN:"JO",JAPAN:"JP",KENYA:"KE",KYRGYZSTAN:"KG",CAMBODIA:"KH",KIRIBATI:"KI",COMOROS:"KM","SAINT KITTS AND NEVIS":"KN","KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF":"KP","KOREA, REPUBLIC OF":"KR",KUWAIT:"KW","CAYMAN ISLANDS":"KY",KAZAKHSTAN:"KZ",LAOS:"LA",LEBANON:"LB","SAINT LUCIA":"LC",LIECHTENSTEIN:"LI","SRI LANKA":"LK",LIBERIA:"LR",LESOTHO:"LS",LITHUANIA:"LT",LUXEMBOURG:"LU",LATVIA:"LV",LIBYA:"LY",MOROCCO:"MA",MONACO:"MC",MOLDOVA:"MD",MONTENEGRO:"ME","ST. MARTIN":"MF",MADAGASCAR:"MG","MARSHALL ISLANDS":"MH","MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF":"MK",MALI:"ML",MYANMAR:"MM",MONGOLIA:"MN",MACAU:"MO","NORTHERN MARIANA ISLANDS":"MP",MARTINIQUE:"MQ",MAURITANIA:"MR",MONTSERRAT:"MS",MALTA:"MT",MAURITIUS:"MU",MALDIVES:"MV",MALAWI:"MW",MEXICO:"MX",MALAYSIA:"MY",MOZAMBIQUE:"MZ",NAMIBIA:"NA","NEW CALEDONIA":"NC",NIGER:"NE","NORFOLK ISLAND":"NF",NIGERIA:"NG",NICARAGUA:"NI",NETHERLANDS:"NL",NORWAY:"NO",NEPAL:"NP",NAURU:"NR",NIUE:"NU","NEW ZEALAND":"NZ",OMAN:"OM",PANAMA:"PA",PERU:"PE","FRENCH POLYNESIA":"PF","PAPUA NEW GUINEA":"PG",PHILIPPINES:"PH",PAKISTAN:"PK",POLAND:"PL","ST. PIERRE & MIQUELON":"PM",PITCAIRN:"PN","PUERTO RICO":"PR",PALESTINE:"PS",PORTUGAL:"PT",PALAU:"PW",PARAGUAY:"PY",QATAR:"QA",REUNION:"RE",ROMANIA:"RO",SERBIA:"RS",RUSSIA:"RU",RWANDA:"RW","SAUDI ARABIA":"SA","SOLOMON ISLANDS":"SB",SEYCHELLES:"SC",SUDAN:"SD",SWEDEN:"SE",SINGAPORE:"SG","SAINT HELENA, ASCENSION AND TRISTAN DA CUNHA":"SH",SLOVENIA:"SI","SVALBARD & JAN MAYEN ISLANDS":"SJ",SLOVAKIA:"SK","SIERRA LEONE":"SL","SAN MARINO":"SM",SENEGAL:"SN",SOMALIA:"SO",SURINAME:"SR","SOUTH SUDAN":"SS","SAO TOME AND PRINCIPE":"ST","EL SALVADOR":"SV","ST. MAARTEN":"SX",SYRIA:"SY",SWAZILAND:"SZ","TURKS & CAICOS ISLANDS":"TC",CHAD:"TD","FRENCH SOUTHERN TERRITORIES":"TF",TOGO:"TG",THAILAND:"TH",TAJIKISTAN:"TJ",TOKELAU:"TK","EAST TIMOR":"TL",TURKMENISTAN:"TM",TUNISIA:"TN",TONGA:"TO",TURKEY:"TR","TRINIDAD AND TOBAGO":"TT",TUVALU:"TV",TAIWAN:"TW",TANZANIA:"TZ",UKRAINE:"UA",UGANDA:"UG","UNITED STATES MINOR OUTLYING ISLANDS":"UM","UNITED STATES":"US",URUGUAY:"UY",UZBEKISTAN:"UZ","VATICAN CITY":"VA","SAINT VINCENT AND THE GRENADINES":"VC",VENEZUELA:"VE","VIRGIN ISLANDS":"VG","VIET NAM":"VN",VANUATU:"VU","WALLIS & FUTUNA ISLANDS":"WF",SAMOA:"WS",YEMEN:"YE",MAYOTTE:"YT","SOUTH AFRICA":"ZA",ZAMBIA:"ZM",ZIMBABWE:"ZW"};function r(n){return n==null?"":String(n).trim().toUpperCase()}var p={};function I(n){return p[n]}function t(n){let a=i[n];return a?{name:a.name,alpha2:n,alpha3:a.alpha3,numeric:a.numeric}:null}function M(n){let a=r(n);return t(a)}function R(n){let a=r(n),e=A[a];return e?t(e):null}function h(n){let e=r(n).padStart(3,"0"),m=u[e];return m?t(m):null}function T(n){let a=r(n),e=l[a];return e?t(e):null}function E(){return Object.keys(i).sort().map(n=>t(n))}function C(n){let a=r(n),e=a;if(e in i||(e=A[a]),!e||!(e in i))return null;let m=t(e);if(!m)return null;let o=I(e)||{};return {...m,subdivisions:o}}function N(n){let a=r(n);if(!a)return null;if(a in i)return a;if(a in A)return A[a];let e=a.padStart(3,"0");return e in u?u[e]:null}function s(n){let a=r(n);return i[a]?.alpha3||null}function S(n){let a=r(n);return A[a]||null}function L(n){let a=r(n);return i[a]?.numeric||null}function G(n){let a=S(n);return a&&i[a]?.numeric||null}function c(n){let e=r(n).padStart(3,"0");return u[e]||null}function B(n){let a=c(n);return a&&i[a]?.alpha3||null}function O(n){let a=N(n);return a&&i[a]?.name||null}function U(n,a,e){let m=null;switch(a){case "alpha2":m=r(n)in i?r(n):null;break;case "alpha3":m=S(String(n));break;case "numeric":m=c(n);break}if(!m)return null;switch(e){case "alpha2":return m;case "alpha3":return i[m]?.alpha3||null;case "numeric":return i[m]?.numeric||null}}function D(n){return !n||n.length!==2?false:r(n)in i}function d(n){return !n||n.length!==3?false:r(n)in A}function P(n){let a=r(n);return !a||!/^\d+$/.test(a)?false:a.padStart(3,"0")in u}function K(n){return n?r(n)in l:false}function H(n){let a=r(n);return a?!!(a in i||a in A||/^\d+$/.test(a)&&a.padStart(3,"0")in u||a in l):false}function F(n){let a=r(n);return a?a.length===2&&/^[A-Z]+$/.test(a)&&a in i?"alpha2":a.length===3&&/^[A-Z]+$/.test(a)&&a in A?"alpha3":/^\d+$/.test(a)&&a.padStart(3,"0")in u?"numeric":a in l?"name":null:null}exports.all=E;exports.alpha2ToAlpha3=s;exports.alpha2ToNumeric=L;exports.alpha3Index=A;exports.alpha3ToAlpha2=S;exports.alpha3ToNumeric=G;exports.convert=U;exports.countries=i;exports.detectFormat=F;exports.isAlpha2=D;exports.isAlpha3=d;exports.isCountryName=K;exports.isNumeric=P;exports.isValid=H;exports.nameIndex=l;exports.numericIndex=u;exports.numericToAlpha2=c;exports.numericToAlpha3=B;exports.resolveAlpha2=N;exports.toName=O;exports.whereAlpha2=M;exports.whereAlpha3=R;exports.whereName=T;exports.whereNumeric=h;exports.withSubdivisions=C;

package/dist/country/index.d.cts

@@ -0,0 +1,270 @@
+import { C as Country, b as CountryWithSubdivisions, c as CountryCodeFormat, d as CountryRecord } from '../types-hSi1rgb5.cjs';
+
+/**
+ * Lookup country by ISO 3166-1 alpha-2 code
+ *
+ * @param code - 2-letter country code (case-insensitive)
+ * @returns Country object or null if not found
+ *
+ * @example
+ * whereAlpha2('US') // { name: 'United States', alpha2: 'US', alpha3: 'USA', numeric: '840' }
+ * whereAlpha2('us') // { name: 'United States', ... } (case-insensitive)
+ * whereAlpha2('XX') // null
+ */
+declare function whereAlpha2(code: string): Country | null;
+/**
+ * Lookup country by ISO 3166-1 alpha-3 code
+ *
+ * @param code - 3-letter country code (case-insensitive)
+ * @returns Country object or null if not found
+ *
+ * @example
+ * whereAlpha3('USA') // { name: 'United States', alpha2: 'US', alpha3: 'USA', numeric: '840' }
+ * whereAlpha3('XXX') // null
+ */
+declare function whereAlpha3(code: string): Country | null;
+/**
+ * Lookup country by ISO 3166-1 numeric code
+ *
+ * @param code - Numeric country code (string or number)
+ * @returns Country object or null if not found
+ *
+ * @example
+ * whereNumeric('840') // { name: 'United States', ... }
+ * whereNumeric(840)   // { name: 'United States', ... }
+ * whereNumeric('999') // null
+ */
+declare function whereNumeric(code: string | number): Country | null;
+/**
+ * Lookup country by name (case-insensitive)
+ *
+ * @param name - Country name
+ * @returns Country object or null if not found
+ *
+ * @example
+ * whereName('United States') // { name: 'United States', ... }
+ * whereName('united states') // { name: 'United States', ... } (case-insensitive)
+ * whereName('Narnia')        // null
+ */
+declare function whereName(name: string): Country | null;
+/**
+ * Get all countries
+ *
+ * @returns Array of all Country objects
+ *
+ * @example
+ * all() // [{ name: 'Afghanistan', alpha2: 'AF', ... }, ...]
+ */
+declare function all(): Country[];
+/**
+ * Get country with all its subdivisions
+ * Note: Requires subdivision data to be imported/registered
+ *
+ * @param code - Country code (alpha-2 or alpha-3)
+ * @returns Country with subdivisions or null if not found
+ *
+ * @example
+ * withSubdivisions('US') // { name: 'United States', ..., subdivisions: { 'US-CA': {...}, ... } }
+ */
+declare function withSubdivisions(code: string): CountryWithSubdivisions | null;
+/**
+ * Resolve any country code format to alpha-2
+ * Internal helper used by other modules
+ *
+ * @param code - Country code in any format (alpha-2, alpha-3, or numeric)
+ * @returns Alpha-2 code or null if not found
+ */
+declare function resolveAlpha2(code: string | number): string | null;
+
+/**
+ * Convert alpha-2 code to alpha-3
+ *
+ * @param code - Alpha-2 country code
+ * @returns Alpha-3 code or null if not found
+ *
+ * @example
+ * alpha2ToAlpha3('US') // 'USA'
+ * alpha2ToAlpha3('XX') // null
+ */
+declare function alpha2ToAlpha3(code: string): string | null;
+/**
+ * Convert alpha-3 code to alpha-2
+ *
+ * @param code - Alpha-3 country code
+ * @returns Alpha-2 code or null if not found
+ *
+ * @example
+ * alpha3ToAlpha2('USA') // 'US'
+ * alpha3ToAlpha2('XXX') // null
+ */
+declare function alpha3ToAlpha2(code: string): string | null;
+/**
+ * Convert alpha-2 code to numeric
+ *
+ * @param code - Alpha-2 country code
+ * @returns Numeric code or null if not found
+ *
+ * @example
+ * alpha2ToNumeric('US') // '840'
+ * alpha2ToNumeric('XX') // null
+ */
+declare function alpha2ToNumeric(code: string): string | null;
+/**
+ * Convert alpha-3 code to numeric
+ *
+ * @param code - Alpha-3 country code
+ * @returns Numeric code or null if not found
+ *
+ * @example
+ * alpha3ToNumeric('USA') // '840'
+ * alpha3ToNumeric('XXX') // null
+ */
+declare function alpha3ToNumeric(code: string): string | null;
+/**
+ * Convert numeric code to alpha-2
+ *
+ * @param code - Numeric country code
+ * @returns Alpha-2 code or null if not found
+ *
+ * @example
+ * numericToAlpha2('840') // 'US'
+ * numericToAlpha2(840)   // 'US'
+ * numericToAlpha2('999') // null
+ */
+declare function numericToAlpha2(code: string | number): string | null;
+/**
+ * Convert numeric code to alpha-3
+ *
+ * @param code - Numeric country code
+ * @returns Alpha-3 code or null if not found
+ *
+ * @example
+ * numericToAlpha3('840') // 'USA'
+ * numericToAlpha3(840)   // 'USA'
+ * numericToAlpha3('999') // null
+ */
+declare function numericToAlpha3(code: string | number): string | null;
+/**
+ * Get country name from any code format
+ *
+ * @param code - Country code (alpha-2, alpha-3, or numeric)
+ * @returns Country name or null if not found
+ *
+ * @example
+ * toName('US')  // 'United States'
+ * toName('USA') // 'United States'
+ * toName(840)   // 'United States'
+ * toName('XX')  // null
+ */
+declare function toName(code: string | number): string | null;
+/**
+ * Convert between any two country code formats
+ *
+ * @param code - Source country code
+ * @param from - Source format
+ * @param to - Target format
+ * @returns Converted code or null if not found
+ *
+ * @example
+ * convert('US', 'alpha2', 'alpha3')    // 'USA'
+ * convert('USA', 'alpha3', 'numeric')  // '840'
+ * convert('840', 'numeric', 'alpha2')  // 'US'
+ */
+declare function convert(code: string | number, from: CountryCodeFormat, to: CountryCodeFormat): string | null;
+
+/**
+ * Check if string is a valid ISO 3166-1 alpha-2 code
+ *
+ * @param code - Code to validate
+ * @returns true if valid alpha-2 code
+ *
+ * @example
+ * isAlpha2('US')  // true
+ * isAlpha2('USA') // false (this is alpha-3)
+ * isAlpha2('XX')  // false
+ */
+declare function isAlpha2(code: string): boolean;
+/**
+ * Check if string is a valid ISO 3166-1 alpha-3 code
+ *
+ * @param code - Code to validate
+ * @returns true if valid alpha-3 code
+ *
+ * @example
+ * isAlpha3('USA') // true
+ * isAlpha3('US')  // false (this is alpha-2)
+ * isAlpha3('XXX') // false
+ */
+declare function isAlpha3(code: string): boolean;
+/**
+ * Check if value is a valid ISO 3166-1 numeric code
+ *
+ * @param code - Code to validate (string or number)
+ * @returns true if valid numeric code
+ *
+ * @example
+ * isNumeric('840') // true
+ * isNumeric(840)   // true
+ * isNumeric('999') // false
+ */
+declare function isNumeric(code: string | number): boolean;
+/**
+ * Check if string is a valid country name
+ *
+ * @param name - Name to validate
+ * @returns true if valid country name
+ *
+ * @example
+ * isCountryName('United States') // true
+ * isCountryName('united states') // true (case-insensitive)
+ * isCountryName('Narnia')        // false
+ */
+declare function isCountryName(name: string): boolean;
+/**
+ * Check if value is any valid country identifier
+ * (alpha-2, alpha-3, numeric, or name)
+ *
+ * @param value - Value to validate
+ * @returns true if valid country identifier
+ *
+ * @example
+ * isValid('US')            // true
+ * isValid('USA')           // true
+ * isValid(840)             // true
+ * isValid('United States') // true
+ * isValid('XX')            // false
+ */
+declare function isValid(value: string | number): boolean;
+/**
+ * Detect the format of a country code
+ *
+ * @param code - Code to detect format of
+ * @returns Detected format or null if invalid
+ *
+ * @example
+ * detectFormat('US')            // 'alpha2'
+ * detectFormat('USA')           // 'alpha3'
+ * detectFormat('840')           // 'numeric'
+ * detectFormat('United States') // 'name'
+ * detectFormat('XX')            // null
+ */
+declare function detectFormat(code: string | number): CountryCodeFormat | 'name' | null;
+
+/**
+ * Country data indexed by alpha-2 code
+ */
+declare const countries: Record<string, CountryRecord>;
+/**
+ * Alpha-3 to alpha-2 lookup index
+ */
+declare const alpha3Index: Record<string, string>;
+/**
+ * Numeric to alpha-2 lookup index
+ */
+declare const numericIndex: Record<string, string>;
+/**
+ * Country name (uppercase) to alpha-2 lookup index
+ */
+declare const nameIndex: Record<string, string>;
+
+export { all, alpha2ToAlpha3, alpha2ToNumeric, alpha3Index, alpha3ToAlpha2, alpha3ToNumeric, convert, countries, detectFormat, isAlpha2, isAlpha3, isCountryName, isNumeric, isValid, nameIndex, numericIndex, numericToAlpha2, numericToAlpha3, resolveAlpha2, toName, whereAlpha2, whereAlpha3, whereName, whereNumeric, withSubdivisions };