# Changelog

All notable changes to country-kit are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [2.0.0] - 2026-08-29

### Added

- `commonName`, `numeric`, `callingCodes`, `dialCode`, `region`, `subregion`, `independent`, `tld`, `capital`, `currencies`, and `nanpAreaCodes` on `Country`
- `getCountry`, `getCountryByAlpha3`, `getCountryByNumeric`, `getCountryByTld`, `getDialCode`, `getCountryCommonName`, `getNumericCode`, `getCountryTld`, `getCountryCapital`, `getCountryCurrencies`
- `getIndependentCountries`, `getCountrySelectOptions`, `getCountriesByCurrency`, `getCountriesBySubregion`, `listRegions`, `listSubregions`, `listCurrencies`
- `getFlagSvgUrl` (jsDelivr, flag-icons 7.5.0) and the optional `country-kit/flags` entry for inline SVG
- `getCountriesByRegion(region)` overload; the no-argument form still returns `{ [region]: Country[] }`

### Changed

- Dataset is generated from ISO 3166-1 and UN M49. Names, calling codes, and coverage follow those sources. Kosovo (`XK`) is not an assigned ISO 3166-1 code and is not included.
- `getCallingCode` returns the ITU-T E.164 country calling code only (1-3 digits). NANP territories that previously returned a concatenated NPA now return `+1`. Anguilla is `+1`, not `+1264`. Use `getDialCode` or `nanpAreaCodes` for a phone-input prefix.
- `isValidCallingCode` accepts `+` plus 1-3 digits. `isValidCallingCode('+1264')` is `false`. `+1` is `true`.
- Invalid lookups return `undefined`. They no longer call `console.error`.

```ts
import { getCallingCode, getDialCode, isValidCallingCode } from 'country-kit';

getCallingCode('AI');        // was '+1264' in 1.x; now '+1'
getDialCode('AI');           // '+1264'
isValidCallingCode('+1264'); // false
isValidCallingCode('+1');    // true
```

## [1.1.0] - 2024-12-28

### Added

- `searchCountries`, `isValidCountryCode`, `isValidCallingCode`, `getCountriesByCallingCode`, `getCountriesByRegion()`
- Type exports: `Country`, `CountryCode`, `CountryData`, `CountrySearchOptions`

### Changed

- Unknown alpha-2 lookups log with `console.error`
- `homepage` field in package.json

## [1.0.3] - 2024-12-27

### Changed

- NANP calling codes stored as `+1264` (no hyphen), not `+1-264`

### Fixed

- `getCountryFlag` returns `undefined` for unknown codes instead of calling `getFlag` on a missing code

## [1.0.2] - 2024-12-27

### Changed

- Version bump only

## [1.0.1] - 2024-12-27

### Changed

- README license badge and Node / browser note
- package.json metadata

## [1.0.0] - 2024-12-27

### Added

- ISO 3166-1 alpha-2/3 codes, English short names, calling codes, Unicode flag emoji
- `getCountryByCode`, `getCountryName`, `getCallingCode`, `getAlpha3Code`, `getCountryFlag`, `getAllCountries`, `getFlag`