# @mirawision/infopedia

Ready‑to‑use lists and helpers for everyday application data: countries, languages, locales, time zones, currencies, and more — with zero dependencies.

## Contents

- Countries and flags
- Country phone codes
- Continents
- Languages
- Locales
- Time zones
- Currencies
- Months and weekdays (English)
- US states and codes

## Installation

```bash
npm install @mirawision/infopedia
```

## Quick Start

```ts
// CommonJS
const { getCountryByISO2, getCurrency } = require('@mirawision/infopedia');

console.log(getCountryByISO2('PL')?.name.en); // "Poland"
console.log(getCurrency('USD')?.symbol);      // "$"
```

## Focused Imports

```ts
// Countries
const { countries, findCountriesByName } = require('@mirawision/infopedia/countries');

// Locales
const { getLocalesByLanguage } = require('@mirawision/infopedia/locales');

// Time zones
const { getTimeZone } = require('@mirawision/infopedia/timezones');
```

## Common Operations

- Find a country by code: `getCountryByISO2('US')`
- Search countries by name: `findCountriesByName('king')`
- Get countries by dial code: `getCountriesByDialCode('+44')`
- Get a language by code: `getLanguageBy639_1('en')`
- List locales for a language: `getLocalesByLanguage('es')`
- Look up a time zone: `getTimeZone('Europe/Warsaw')`
- Look up a currency: `getCurrency('EUR')`
- Find a US state: `getUSState('CA')`

## Notes

- Data is read‑only (arrays are frozen)
- No runtime dependencies

## Contributing

Contributions are always welcome! Feel free to open issues or submit pull requests.

## License

This project is licensed under the MIT License.