@koshmoney/countries 1.0.1-beta.2 → 1.0.1-beta.3

package/README.md

@@ -11,10 +11,14 @@ Complete ISO 3166-1 (countries) and ISO 3166-2 (subdivisions) lookup library wit
 - **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.)
 - **Postal code validation**: Validate ZIP codes, PIN codes, postcodes for 150+ countries
+- **Currency data**: Get currency code, symbol, and name for any country
+- **Phone dial codes**: Get international dialing codes (powered by libphonenumber-js)
+- **Geography data**: Continent and region classification (UN M49 standard)
+- **Membership checks**: EU, SEPA, EEA, Eurozone, and Schengen membership
 - **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
+- **True tree-shaking**: Import only the modules you need
+- **Minimal dependencies**: Core modules are dependency-free; dial codes use libphonenumber-js
 - **Full TypeScript support**: Complete type definitions included
 - **Dual module format**: ESM and CommonJS exports
 
@@ -62,6 +66,27 @@ postalCode.isValid('US', '90210');     // true
 postalCode.isValid('GB', 'SW1A 1AA');  // true
 postalCode.getName('US');              // 'ZIP Code'
 postalCode.getName('IN');              // 'PIN Code'
+
+// Currency data
+import { currency } from '@koshmoney/countries/currency';
+currency.getCurrency('US');
+// { code: 'USD', symbol: '$', name: 'US Dollar' }
+
+// Phone dial codes
+import { dialCode } from '@koshmoney/countries/dialCode';
+dialCode.getDialCode('US');            // '+1'
+dialCode.getDialCode('GB');            // '+44'
+
+// Geography (continent/region)
+import { geography } from '@koshmoney/countries/geography';
+geography.getContinent('US');          // 'North America'
+geography.getRegion('JP');             // 'Eastern Asia'
+
+// EU/SEPA membership
+import { membership } from '@koshmoney/countries/membership';
+membership.isEU('FR');                 // true
+membership.isSEPA('CH');               // true
+membership.isEurozone('DE');           // true
 ```
 
 ## Usage
@@ -167,6 +192,137 @@ country.hasPostalCode('US');
 country.getPostalCodeName('US');
 ```
 
+### Currency Functions
+
+Get currency information for any country.
+
+```typescript
+import { currency } from '@koshmoney/countries/currency';
+
+// Get full currency info
+currency.getCurrency('US');
+// { code: 'USD', symbol: '$', name: 'US Dollar' }
+
+currency.getCurrency('JP');
+// { code: 'JPY', symbol: '¥', name: 'Japanese Yen' }
+
+currency.getCurrency('GB');
+// { code: 'GBP', symbol: '£', name: 'British Pound' }
+
+// Individual lookups
+currency.getCurrencyCode('DE');        // 'EUR'
+currency.getCurrencySymbol('IN');      // '₹'
+currency.getCurrencyName('BR');        // 'Brazilian Real'
+
+// Reverse lookup
+currency.getCountriesByCurrency('EUR');
+// ['AD', 'AT', 'BE', 'CY', 'DE', 'EE', 'ES', 'FI', 'FR', ...]
+```
+
+### Dial Code Functions
+
+Get international dialing codes (powered by libphonenumber-js).
+
+```typescript
+import { dialCode } from '@koshmoney/countries/dialCode';
+
+// Get dial code
+dialCode.getDialCode('US');            // '+1'
+dialCode.getDialCode('GB');            // '+44'
+dialCode.getDialCode('FR');            // '+33'
+dialCode.getDialCode('JP');            // '+81'
+
+// Get full dial code info
+dialCode.getDialCodeInfo('US');
+// { dialCode: '+1', countryCode: 'US' }
+
+// Validation
+dialCode.isValidPhoneCountry('US');    // true
+dialCode.isValidPhoneCountry('XX');    // false
+
+// Get all supported countries
+dialCode.getSupportedCountries();      // ['AC', 'AD', 'AE', ...]
+```
+
+### Geography Functions
+
+Get continent and region data (UN M49 classification).
+
+```typescript
+import { geography } from '@koshmoney/countries/geography';
+
+// Get continent
+geography.getContinent('US');          // 'North America'
+geography.getContinent('JP');          // 'Asia'
+geography.getContinent('DE');          // 'Europe'
+geography.getContinent('AU');          // 'Oceania'
+
+// Get region (UN M49 subregion)
+geography.getRegion('US');             // 'Northern America'
+geography.getRegion('JP');             // 'Eastern Asia'
+geography.getRegion('DE');             // 'Western Europe'
+geography.getRegion('BR');             // 'South America'
+
+// Get full geography info
+geography.getGeography('FR');
+// { continent: 'Europe', region: 'Western Europe' }
+
+// Reverse lookups
+geography.getCountriesByContinent('Europe');
+// ['AD', 'AL', 'AT', 'AX', 'BA', 'BE', ...]
+
+geography.getCountriesByRegion('Eastern Asia');
+// ['CN', 'HK', 'JP', 'KP', 'KR', 'MO', 'MN', 'TW']
+
+// Get all continents/regions
+geography.getContinents();
+// ['Africa', 'Antarctica', 'Asia', 'Europe', 'North America', 'Oceania', 'South America']
+
+geography.getRegions();
+// ['Northern Africa', 'Sub-Saharan Africa', 'Northern America', ...]
+```
+
+### Membership Functions
+
+Check EU, SEPA, EEA, Eurozone, and Schengen membership.
+
+```typescript
+import { membership } from '@koshmoney/countries/membership';
+
+// EU membership (27 countries)
+membership.isEU('FR');                 // true
+membership.isEU('CH');                 // false (Switzerland)
+membership.isEU('GB');                 // false (post-Brexit)
+
+// SEPA membership (36 countries)
+membership.isSEPA('FR');               // true
+membership.isSEPA('CH');               // true (Switzerland is SEPA)
+membership.isSEPA('GB');               // true (UK remains in SEPA)
+
+// EEA membership (30 countries)
+membership.isEEA('NO');                // true (Norway)
+membership.isEEA('CH');                // false (Switzerland not in EEA)
+
+// Eurozone membership (20 countries)
+membership.isEurozone('DE');           // true
+membership.isEurozone('SE');           // false (Sweden uses SEK)
+
+// Schengen membership (27 countries)
+membership.isSchengen('FR');           // true
+membership.isSchengen('IE');           // false (Ireland not in Schengen)
+
+// Get all memberships at once
+membership.getMemberships('FR');
+// { EU: true, SEPA: true, EEA: true, Eurozone: true, Schengen: true }
+
+membership.getMemberships('CH');
+// { EU: false, SEPA: true, EEA: false, Eurozone: false, Schengen: true }
+
+// Get all members of a group
+membership.getMembers('EU');           // ['AT', 'BE', 'BG', ...] (27 countries)
+membership.getMembers('Eurozone');     // ['AT', 'BE', 'CY', ...] (20 countries)
+```
+
 ### Direct Imports (Tree-Shakeable)
 
 ```typescript
@@ -201,6 +357,46 @@ import {
   getPattern,
   getInfo,
 } from '@koshmoney/countries/postalCode';
+
+// Currency functions
+import {
+  getCurrency,
+  getCurrencyCode,
+  getCurrencySymbol,
+  getCurrencyName,
+  getCountriesByCurrency,
+} from '@koshmoney/countries/currency';
+
+// Dial code functions
+import {
+  getDialCode,
+  getDialCodes,
+  getDialCodeInfo,
+  isValidPhoneCountry,
+  getSupportedCountries,
+} from '@koshmoney/countries/dialCode';
+
+// Geography functions
+import {
+  getContinent,
+  getRegion,
+  getGeography,
+  getCountriesByContinent,
+  getCountriesByRegion,
+  getContinents,
+  getRegions,
+} from '@koshmoney/countries/geography';
+
+// Membership functions
+import {
+  isEU,
+  isSEPA,
+  isEEA,
+  isEurozone,
+  isSchengen,
+  getMemberships,
+  getMembers,
+} from '@koshmoney/countries/membership';
 ```
 
 ## Tree-Shaking
@@ -304,6 +500,44 @@ interface PostalCodeInfo {
   format: string;    // "NNNNN" or "A1A 1A1"
   name: string;      // "ZIP Code", "PIN Code", "Postcode", etc.
 }
+
+interface CurrencyInfo {
+  code: string;      // "USD"
+  symbol: string;    // "$"
+  name: string;      // "US Dollar"
+}
+
+interface DialCodeInfo {
+  dialCode: string;    // "+1"
+  countryCode: string; // "US"
+}
+
+interface GeographyInfo {
+  continent: Continent; // "North America"
+  region: Region;       // "Northern America"
+}
+
+type Continent =
+  | 'Africa' | 'Antarctica' | 'Asia'
+  | 'Europe' | 'North America' | 'Oceania' | 'South America';
+
+type Region =
+  | 'Northern Africa' | 'Sub-Saharan Africa' | 'Antarctica'
+  | 'Central Asia' | 'Eastern Asia' | 'South-eastern Asia'
+  | 'Southern Asia' | 'Western Asia' | 'Eastern Europe'
+  | 'Northern Europe' | 'Southern Europe' | 'Western Europe'
+  | 'Caribbean' | 'Central America' | 'Northern America' | 'South America'
+  | 'Australia and New Zealand' | 'Melanesia' | 'Micronesia' | 'Polynesia';
+
+interface MembershipInfo {
+  EU: boolean;
+  SEPA: boolean;
+  EEA: boolean;
+  Eurozone: boolean;
+  Schengen: boolean;
+}
+
+type MembershipType = 'EU' | 'SEPA' | 'EEA' | 'Eurozone' | 'Schengen';
 ```
 
 ## API Reference
@@ -320,6 +554,9 @@ Migrating from `iso-3166-1` or `iso-3166-2`? See [Migration Guide](./docs/MIGRAT
 - [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2): Subdivision codes
 - [postcode-validator](https://github.com/melwynfurtado/postcode-validator): Postal code validation patterns
 - [Universal Postal Union (UPU)](https://www.upu.int): Postal code standards
+- [libphonenumber-js](https://www.npmjs.com/package/libphonenumber-js): Phone dial codes
+- [UN M49](https://unstats.un.org/unsd/methodology/m49/): Geographic regions classification
+- [European Commission](https://european-union.europa.eu/): EU/EEA/Eurozone/Schengen membership data
 
 ## Contributing
 

package/dist/country/index.d.cts

@@ -1,4 +1,5 @@
-import { C as Country, b as CountryWithSubdivisions, c as CountryCodeFormat, d as CountryRecord, P as PostalCodeInfo } from '../types-BK2zT8WM.cjs';
+import { C as Country, b as CountryWithSubdivisions, c as CountryCodeFormat, d as CountryRecord } from '../types-BPZJeVlW.cjs';
+export { a as getPostalCodeFormat, c as getPostalCodeInfo, b as getPostalCodeName, g as getPostalCodePattern, h as hasPostalCode, i as isValidPostalCode } from '../lookup-Dvpwuul8.cjs';
 
 /**
  * Lookup country by ISO 3166-1 alpha-2 code
@@ -234,7 +235,7 @@ declare function isCountryName(name: string): boolean;
  * isValid('United States') // true
  * isValid('XX')            // false
  */
-declare function isValid$1(value: string | number): boolean;
+declare function isValid(value: string | number): boolean;
 /**
  * Detect the format of a country code
  *
@@ -267,98 +268,4 @@ declare const numericIndex: Record<string, string>;
  */
 declare const nameIndex: Record<string, string>;
 
-/**
- * Postal code validation functions
- */
-/**
- * Validate postal code for a country (lenient mode)
- *
- * Lenient validation:
- * - Case-insensitive for alpha codes
- * - Trims leading/trailing whitespace
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @param postalCode - Postal code to validate
- * @returns true if valid, false otherwise
- *
- * @example
- * isValid('US', '90210');           // true
- * isValid('US', '90210-1234');      // true
- * isValid('GB', 'SW1A 1AA');        // true
- * isValid('GB', 'sw1a 1aa');        // true (case-insensitive)
- * isValid('IN', '110001');          // true
- * isValid('HK', '999077');          // false (HK has no postal codes)
- */
-declare function isValid(countryCode: string | number, postalCode: string): boolean;
-
-/**
- * Postal code lookup functions
- */
-
-/**
- * Check if a country uses a postal code system
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns true if the country uses postal codes, false otherwise
- *
- * @example
- * hasPostalCode('US');  // true
- * hasPostalCode('GB');  // true
- * hasPostalCode('HK');  // false (Hong Kong has no postal codes)
- * hasPostalCode('AE');  // false (UAE has no postal codes)
- */
-declare function hasPostalCode(countryCode: string | number): boolean;
-/**
- * Get the regex pattern for a country's postal code
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns RegExp pattern or null if country has no postal code system
- *
- * @example
- * getPattern('US');  // /^\d{5}(-\d{4})?$/
- * getPattern('GB');  // /^[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2}$/i
- * getPattern('HK');  // null
- */
-declare function getPattern(countryCode: string | number): RegExp | null;
-/**
- * Get human-readable format string for a country's postal code
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns Format string or null if country has no postal code system
- *
- * @example
- * getFormat('US');  // 'NNNNN or NNNNN-NNNN'
- * getFormat('GB');  // 'AA9A 9AA'
- * getFormat('CA');  // 'A1A 1A1'
- * getFormat('HK');  // null
- */
-declare function getFormat(countryCode: string | number): string | null;
-/**
- * Get local terminology for a country's postal code
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns Local name or null if country has no postal code system
- *
- * @example
- * getName('US');  // 'ZIP Code'
- * getName('IN');  // 'PIN Code'
- * getName('GB');  // 'Postcode'
- * getName('DE');  // 'PLZ'
- * getName('BR');  // 'CEP'
- * getName('JP');  // '郵便番号'
- * getName('HK');  // null
- */
-declare function getName(countryCode: string | number): string | null;
-/**
- * Get full postal code info for a country
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns PostalCodeInfo object or null if country has no postal code system
- *
- * @example
- * getInfo('US');
- * // { regex: /^\d{5}(-\d{4})?$/, format: 'NNNNN or NNNNN-NNNN', name: 'ZIP Code' }
- */
-declare function getInfo(countryCode: string | number): PostalCodeInfo | null;
-
-export { all, alpha2ToAlpha3, alpha2ToNumeric, alpha3Index, alpha3ToAlpha2, alpha3ToNumeric, convert, countries, detectFormat, getFormat as getPostalCodeFormat, getInfo as getPostalCodeInfo, getName as getPostalCodeName, getPattern as getPostalCodePattern, hasPostalCode, isAlpha2, isAlpha3, isCountryName, isNumeric, isValid$1 as isValid, isValid as isValidPostalCode, nameIndex, numericIndex, numericToAlpha2, numericToAlpha3, resolveAlpha2, toName, whereAlpha2, whereAlpha3, whereName, whereNumeric, withSubdivisions };
+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 };

package/dist/country/index.d.ts

@@ -1,4 +1,5 @@
-import { C as Country, b as CountryWithSubdivisions, c as CountryCodeFormat, d as CountryRecord, P as PostalCodeInfo } from '../types-BK2zT8WM.js';
+import { C as Country, b as CountryWithSubdivisions, c as CountryCodeFormat, d as CountryRecord } from '../types-BPZJeVlW.js';
+export { a as getPostalCodeFormat, c as getPostalCodeInfo, b as getPostalCodeName, g as getPostalCodePattern, h as hasPostalCode, i as isValidPostalCode } from '../lookup-DcQsEnXu.js';
 
 /**
  * Lookup country by ISO 3166-1 alpha-2 code
@@ -234,7 +235,7 @@ declare function isCountryName(name: string): boolean;
  * isValid('United States') // true
  * isValid('XX')            // false
  */
-declare function isValid$1(value: string | number): boolean;
+declare function isValid(value: string | number): boolean;
 /**
  * Detect the format of a country code
  *
@@ -267,98 +268,4 @@ declare const numericIndex: Record<string, string>;
  */
 declare const nameIndex: Record<string, string>;
 
-/**
- * Postal code validation functions
- */
-/**
- * Validate postal code for a country (lenient mode)
- *
- * Lenient validation:
- * - Case-insensitive for alpha codes
- * - Trims leading/trailing whitespace
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @param postalCode - Postal code to validate
- * @returns true if valid, false otherwise
- *
- * @example
- * isValid('US', '90210');           // true
- * isValid('US', '90210-1234');      // true
- * isValid('GB', 'SW1A 1AA');        // true
- * isValid('GB', 'sw1a 1aa');        // true (case-insensitive)
- * isValid('IN', '110001');          // true
- * isValid('HK', '999077');          // false (HK has no postal codes)
- */
-declare function isValid(countryCode: string | number, postalCode: string): boolean;
-
-/**
- * Postal code lookup functions
- */
-
-/**
- * Check if a country uses a postal code system
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns true if the country uses postal codes, false otherwise
- *
- * @example
- * hasPostalCode('US');  // true
- * hasPostalCode('GB');  // true
- * hasPostalCode('HK');  // false (Hong Kong has no postal codes)
- * hasPostalCode('AE');  // false (UAE has no postal codes)
- */
-declare function hasPostalCode(countryCode: string | number): boolean;
-/**
- * Get the regex pattern for a country's postal code
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns RegExp pattern or null if country has no postal code system
- *
- * @example
- * getPattern('US');  // /^\d{5}(-\d{4})?$/
- * getPattern('GB');  // /^[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2}$/i
- * getPattern('HK');  // null
- */
-declare function getPattern(countryCode: string | number): RegExp | null;
-/**
- * Get human-readable format string for a country's postal code
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns Format string or null if country has no postal code system
- *
- * @example
- * getFormat('US');  // 'NNNNN or NNNNN-NNNN'
- * getFormat('GB');  // 'AA9A 9AA'
- * getFormat('CA');  // 'A1A 1A1'
- * getFormat('HK');  // null
- */
-declare function getFormat(countryCode: string | number): string | null;
-/**
- * Get local terminology for a country's postal code
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns Local name or null if country has no postal code system
- *
- * @example
- * getName('US');  // 'ZIP Code'
- * getName('IN');  // 'PIN Code'
- * getName('GB');  // 'Postcode'
- * getName('DE');  // 'PLZ'
- * getName('BR');  // 'CEP'
- * getName('JP');  // '郵便番号'
- * getName('HK');  // null
- */
-declare function getName(countryCode: string | number): string | null;
-/**
- * Get full postal code info for a country
- *
- * @param countryCode - Country code (alpha-2, alpha-3, or numeric)
- * @returns PostalCodeInfo object or null if country has no postal code system
- *
- * @example
- * getInfo('US');
- * // { regex: /^\d{5}(-\d{4})?$/, format: 'NNNNN or NNNNN-NNNN', name: 'ZIP Code' }
- */
-declare function getInfo(countryCode: string | number): PostalCodeInfo | null;
-
-export { all, alpha2ToAlpha3, alpha2ToNumeric, alpha3Index, alpha3ToAlpha2, alpha3ToNumeric, convert, countries, detectFormat, getFormat as getPostalCodeFormat, getInfo as getPostalCodeInfo, getName as getPostalCodeName, getPattern as getPostalCodePattern, hasPostalCode, isAlpha2, isAlpha3, isCountryName, isNumeric, isValid$1 as isValid, isValid as isValidPostalCode, nameIndex, numericIndex, numericToAlpha2, numericToAlpha3, resolveAlpha2, toName, whereAlpha2, whereAlpha3, whereName, whereNumeric, withSubdivisions };
+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 };

package/dist/currency/index.cjs

@@ -0,0 +1 @@
+'use strict';function a(e){return e==null?"":String(e).trim().toUpperCase()}var n={AD:{code:"EUR",symbol:"\u20AC",name:"Euro"},AE:{code:"AED",symbol:"\u062F.\u0625",name:"UAE Dirham"},AF:{code:"AFN",symbol:"\u060B",name:"Afghan Afghani"},AG:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},AI:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},AL:{code:"ALL",symbol:"L",name:"Albanian Lek"},AM:{code:"AMD",symbol:"\u058F",name:"Armenian Dram"},AO:{code:"AOA",symbol:"Kz",name:"Angolan Kwanza"},AQ:{code:"USD",symbol:"$",name:"US Dollar"},AR:{code:"ARS",symbol:"$",name:"Argentine Peso"},AS:{code:"USD",symbol:"$",name:"US Dollar"},AT:{code:"EUR",symbol:"\u20AC",name:"Euro"},AU:{code:"AUD",symbol:"$",name:"Australian Dollar"},AW:{code:"AWG",symbol:"\u0192",name:"Aruban Florin"},AX:{code:"EUR",symbol:"\u20AC",name:"Euro"},AZ:{code:"AZN",symbol:"\u20BC",name:"Azerbaijani Manat"},BA:{code:"BAM",symbol:"KM",name:"Bosnia-Herzegovina Convertible Mark"},BB:{code:"BBD",symbol:"$",name:"Barbadian Dollar"},BD:{code:"BDT",symbol:"\u09F3",name:"Bangladeshi Taka"},BE:{code:"EUR",symbol:"\u20AC",name:"Euro"},BF:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},BG:{code:"BGN",symbol:"\u043B\u0432",name:"Bulgarian Lev"},BH:{code:"BHD",symbol:".\u062F.\u0628",name:"Bahraini Dinar"},BI:{code:"BIF",symbol:"FBu",name:"Burundian Franc"},BJ:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},BL:{code:"EUR",symbol:"\u20AC",name:"Euro"},BM:{code:"BMD",symbol:"$",name:"Bermudian Dollar"},BN:{code:"BND",symbol:"$",name:"Brunei Dollar"},BO:{code:"BOB",symbol:"Bs.",name:"Bolivian Boliviano"},BQ:{code:"USD",symbol:"$",name:"US Dollar"},BR:{code:"BRL",symbol:"R$",name:"Brazilian Real"},BS:{code:"BSD",symbol:"$",name:"Bahamian Dollar"},BT:{code:"BTN",symbol:"Nu.",name:"Bhutanese Ngultrum"},BV:{code:"NOK",symbol:"kr",name:"Norwegian Krone"},BW:{code:"BWP",symbol:"P",name:"Botswanan Pula"},BY:{code:"BYN",symbol:"Br",name:"Belarusian Ruble"},BZ:{code:"BZD",symbol:"$",name:"Belize Dollar"},CA:{code:"CAD",symbol:"$",name:"Canadian Dollar"},CC:{code:"AUD",symbol:"$",name:"Australian Dollar"},CD:{code:"CDF",symbol:"FC",name:"Congolese Franc"},CF:{code:"XAF",symbol:"FCFA",name:"Central African CFA Franc"},CG:{code:"XAF",symbol:"FCFA",name:"Central African CFA Franc"},CH:{code:"CHF",symbol:"CHF",name:"Swiss Franc"},CI:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},CK:{code:"NZD",symbol:"$",name:"New Zealand Dollar"},CL:{code:"CLP",symbol:"$",name:"Chilean Peso"},CM:{code:"XAF",symbol:"FCFA",name:"Central African CFA Franc"},CN:{code:"CNY",symbol:"\xA5",name:"Chinese Yuan"},CO:{code:"COP",symbol:"$",name:"Colombian Peso"},CR:{code:"CRC",symbol:"\u20A1",name:"Costa Rican Col\xF3n"},CU:{code:"CUP",symbol:"$",name:"Cuban Peso"},CV:{code:"CVE",symbol:"$",name:"Cape Verdean Escudo"},CW:{code:"ANG",symbol:"\u0192",name:"Netherlands Antillean Guilder"},CX:{code:"AUD",symbol:"$",name:"Australian Dollar"},CY:{code:"EUR",symbol:"\u20AC",name:"Euro"},CZ:{code:"CZK",symbol:"K\u010D",name:"Czech Koruna"},DE:{code:"EUR",symbol:"\u20AC",name:"Euro"},DJ:{code:"DJF",symbol:"Fdj",name:"Djiboutian Franc"},DK:{code:"DKK",symbol:"kr",name:"Danish Krone"},DM:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},DO:{code:"DOP",symbol:"$",name:"Dominican Peso"},DZ:{code:"DZD",symbol:"\u062F.\u062C",name:"Algerian Dinar"},EC:{code:"USD",symbol:"$",name:"US Dollar"},EE:{code:"EUR",symbol:"\u20AC",name:"Euro"},EG:{code:"EGP",symbol:"\xA3",name:"Egyptian Pound"},EH:{code:"MAD",symbol:"\u062F.\u0645.",name:"Moroccan Dirham"},ER:{code:"ERN",symbol:"Nfk",name:"Eritrean Nakfa"},ES:{code:"EUR",symbol:"\u20AC",name:"Euro"},ET:{code:"ETB",symbol:"Br",name:"Ethiopian Birr"},FI:{code:"EUR",symbol:"\u20AC",name:"Euro"},FJ:{code:"FJD",symbol:"$",name:"Fijian Dollar"},FK:{code:"FKP",symbol:"\xA3",name:"Falkland Islands Pound"},FM:{code:"USD",symbol:"$",name:"US Dollar"},FO:{code:"DKK",symbol:"kr",name:"Danish Krone"},FR:{code:"EUR",symbol:"\u20AC",name:"Euro"},GA:{code:"XAF",symbol:"FCFA",name:"Central African CFA Franc"},GB:{code:"GBP",symbol:"\xA3",name:"British Pound"},GD:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},GE:{code:"GEL",symbol:"\u20BE",name:"Georgian Lari"},GF:{code:"EUR",symbol:"\u20AC",name:"Euro"},GG:{code:"GBP",symbol:"\xA3",name:"British Pound"},GH:{code:"GHS",symbol:"\u20B5",name:"Ghanaian Cedi"},GI:{code:"GIP",symbol:"\xA3",name:"Gibraltar Pound"},GL:{code:"DKK",symbol:"kr",name:"Danish Krone"},GM:{code:"GMD",symbol:"D",name:"Gambian Dalasi"},GN:{code:"GNF",symbol:"FG",name:"Guinean Franc"},GP:{code:"EUR",symbol:"\u20AC",name:"Euro"},GQ:{code:"XAF",symbol:"FCFA",name:"Central African CFA Franc"},GR:{code:"EUR",symbol:"\u20AC",name:"Euro"},GS:{code:"GBP",symbol:"\xA3",name:"British Pound"},GT:{code:"GTQ",symbol:"Q",name:"Guatemalan Quetzal"},GU:{code:"USD",symbol:"$",name:"US Dollar"},GW:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},GY:{code:"GYD",symbol:"$",name:"Guyanese Dollar"},HK:{code:"HKD",symbol:"$",name:"Hong Kong Dollar"},HM:{code:"AUD",symbol:"$",name:"Australian Dollar"},HN:{code:"HNL",symbol:"L",name:"Honduran Lempira"},HR:{code:"EUR",symbol:"\u20AC",name:"Euro"},HT:{code:"HTG",symbol:"G",name:"Haitian Gourde"},HU:{code:"HUF",symbol:"Ft",name:"Hungarian Forint"},ID:{code:"IDR",symbol:"Rp",name:"Indonesian Rupiah"},IE:{code:"EUR",symbol:"\u20AC",name:"Euro"},IL:{code:"ILS",symbol:"\u20AA",name:"Israeli New Shekel"},IM:{code:"GBP",symbol:"\xA3",name:"British Pound"},IN:{code:"INR",symbol:"\u20B9",name:"Indian Rupee"},IO:{code:"USD",symbol:"$",name:"US Dollar"},IQ:{code:"IQD",symbol:"\u0639.\u062F",name:"Iraqi Dinar"},IR:{code:"IRR",symbol:"\uFDFC",name:"Iranian Rial"},IS:{code:"ISK",symbol:"kr",name:"Icelandic Kr\xF3na"},IT:{code:"EUR",symbol:"\u20AC",name:"Euro"},JE:{code:"GBP",symbol:"\xA3",name:"British Pound"},JM:{code:"JMD",symbol:"$",name:"Jamaican Dollar"},JO:{code:"JOD",symbol:"\u062F.\u0627",name:"Jordanian Dinar"},JP:{code:"JPY",symbol:"\xA5",name:"Japanese Yen"},KE:{code:"KES",symbol:"KSh",name:"Kenyan Shilling"},KG:{code:"KGS",symbol:"\u0441",name:"Kyrgyzstani Som"},KH:{code:"KHR",symbol:"\u17DB",name:"Cambodian Riel"},KI:{code:"AUD",symbol:"$",name:"Australian Dollar"},KM:{code:"KMF",symbol:"CF",name:"Comorian Franc"},KN:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},KP:{code:"KPW",symbol:"\u20A9",name:"North Korean Won"},KR:{code:"KRW",symbol:"\u20A9",name:"South Korean Won"},KW:{code:"KWD",symbol:"\u062F.\u0643",name:"Kuwaiti Dinar"},KY:{code:"KYD",symbol:"$",name:"Cayman Islands Dollar"},KZ:{code:"KZT",symbol:"\u20B8",name:"Kazakhstani Tenge"},LA:{code:"LAK",symbol:"\u20AD",name:"Laotian Kip"},LB:{code:"LBP",symbol:"\u0644.\u0644",name:"Lebanese Pound"},LC:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},LI:{code:"CHF",symbol:"CHF",name:"Swiss Franc"},LK:{code:"LKR",symbol:"Rs",name:"Sri Lankan Rupee"},LR:{code:"LRD",symbol:"$",name:"Liberian Dollar"},LS:{code:"LSL",symbol:"L",name:"Lesotho Loti"},LT:{code:"EUR",symbol:"\u20AC",name:"Euro"},LU:{code:"EUR",symbol:"\u20AC",name:"Euro"},LV:{code:"EUR",symbol:"\u20AC",name:"Euro"},LY:{code:"LYD",symbol:"\u0644.\u062F",name:"Libyan Dinar"},MA:{code:"MAD",symbol:"\u062F.\u0645.",name:"Moroccan Dirham"},MC:{code:"EUR",symbol:"\u20AC",name:"Euro"},MD:{code:"MDL",symbol:"L",name:"Moldovan Leu"},ME:{code:"EUR",symbol:"\u20AC",name:"Euro"},MF:{code:"EUR",symbol:"\u20AC",name:"Euro"},MG:{code:"MGA",symbol:"Ar",name:"Malagasy Ariary"},MH:{code:"USD",symbol:"$",name:"US Dollar"},MK:{code:"MKD",symbol:"\u0434\u0435\u043D",name:"Macedonian Denar"},ML:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},MM:{code:"MMK",symbol:"K",name:"Myanmar Kyat"},MN:{code:"MNT",symbol:"\u20AE",name:"Mongolian Tugrik"},MO:{code:"MOP",symbol:"MOP$",name:"Macanese Pataca"},MP:{code:"USD",symbol:"$",name:"US Dollar"},MQ:{code:"EUR",symbol:"\u20AC",name:"Euro"},MR:{code:"MRU",symbol:"UM",name:"Mauritanian Ouguiya"},MS:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},MT:{code:"EUR",symbol:"\u20AC",name:"Euro"},MU:{code:"MUR",symbol:"\u20A8",name:"Mauritian Rupee"},MV:{code:"MVR",symbol:"Rf",name:"Maldivian Rufiyaa"},MW:{code:"MWK",symbol:"MK",name:"Malawian Kwacha"},MX:{code:"MXN",symbol:"$",name:"Mexican Peso"},MY:{code:"MYR",symbol:"RM",name:"Malaysian Ringgit"},MZ:{code:"MZN",symbol:"MT",name:"Mozambican Metical"},NA:{code:"NAD",symbol:"$",name:"Namibian Dollar"},NC:{code:"XPF",symbol:"\u20A3",name:"CFP Franc"},NE:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},NF:{code:"AUD",symbol:"$",name:"Australian Dollar"},NG:{code:"NGN",symbol:"\u20A6",name:"Nigerian Naira"},NI:{code:"NIO",symbol:"C$",name:"Nicaraguan C\xF3rdoba"},NL:{code:"EUR",symbol:"\u20AC",name:"Euro"},NO:{code:"NOK",symbol:"kr",name:"Norwegian Krone"},NP:{code:"NPR",symbol:"\u20A8",name:"Nepalese Rupee"},NR:{code:"AUD",symbol:"$",name:"Australian Dollar"},NU:{code:"NZD",symbol:"$",name:"New Zealand Dollar"},NZ:{code:"NZD",symbol:"$",name:"New Zealand Dollar"},OM:{code:"OMR",symbol:"\u0631.\u0639.",name:"Omani Rial"},PA:{code:"PAB",symbol:"B/.",name:"Panamanian Balboa"},PE:{code:"PEN",symbol:"S/",name:"Peruvian Sol"},PF:{code:"XPF",symbol:"\u20A3",name:"CFP Franc"},PG:{code:"PGK",symbol:"K",name:"Papua New Guinean Kina"},PH:{code:"PHP",symbol:"\u20B1",name:"Philippine Peso"},PK:{code:"PKR",symbol:"\u20A8",name:"Pakistani Rupee"},PL:{code:"PLN",symbol:"z\u0142",name:"Polish Zloty"},PM:{code:"EUR",symbol:"\u20AC",name:"Euro"},PN:{code:"NZD",symbol:"$",name:"New Zealand Dollar"},PR:{code:"USD",symbol:"$",name:"US Dollar"},PS:{code:"ILS",symbol:"\u20AA",name:"Israeli New Shekel"},PT:{code:"EUR",symbol:"\u20AC",name:"Euro"},PW:{code:"USD",symbol:"$",name:"US Dollar"},PY:{code:"PYG",symbol:"\u20B2",name:"Paraguayan Guarani"},QA:{code:"QAR",symbol:"\u0631.\u0642",name:"Qatari Riyal"},RE:{code:"EUR",symbol:"\u20AC",name:"Euro"},RO:{code:"RON",symbol:"lei",name:"Romanian Leu"},RS:{code:"RSD",symbol:"\u0434\u0438\u043D.",name:"Serbian Dinar"},RU:{code:"RUB",symbol:"\u20BD",name:"Russian Ruble"},RW:{code:"RWF",symbol:"FRw",name:"Rwandan Franc"},SA:{code:"SAR",symbol:"\u0631.\u0633",name:"Saudi Riyal"},SB:{code:"SBD",symbol:"$",name:"Solomon Islands Dollar"},SC:{code:"SCR",symbol:"\u20A8",name:"Seychellois Rupee"},SD:{code:"SDG",symbol:"\u062C.\u0633.",name:"Sudanese Pound"},SE:{code:"SEK",symbol:"kr",name:"Swedish Krona"},SG:{code:"SGD",symbol:"$",name:"Singapore Dollar"},SH:{code:"SHP",symbol:"\xA3",name:"Saint Helena Pound"},SI:{code:"EUR",symbol:"\u20AC",name:"Euro"},SJ:{code:"NOK",symbol:"kr",name:"Norwegian Krone"},SK:{code:"EUR",symbol:"\u20AC",name:"Euro"},SL:{code:"SLE",symbol:"Le",name:"Sierra Leonean Leone"},SM:{code:"EUR",symbol:"\u20AC",name:"Euro"},SN:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},SO:{code:"SOS",symbol:"S",name:"Somali Shilling"},SR:{code:"SRD",symbol:"$",name:"Surinamese Dollar"},SS:{code:"SSP",symbol:"\xA3",name:"South Sudanese Pound"},ST:{code:"STN",symbol:"Db",name:"S\xE3o Tom\xE9 and Pr\xEDncipe Dobra"},SV:{code:"USD",symbol:"$",name:"US Dollar"},SX:{code:"ANG",symbol:"\u0192",name:"Netherlands Antillean Guilder"},SY:{code:"SYP",symbol:"\xA3",name:"Syrian Pound"},SZ:{code:"SZL",symbol:"L",name:"Swazi Lilangeni"},TC:{code:"USD",symbol:"$",name:"US Dollar"},TD:{code:"XAF",symbol:"FCFA",name:"Central African CFA Franc"},TF:{code:"EUR",symbol:"\u20AC",name:"Euro"},TG:{code:"XOF",symbol:"CFA",name:"West African CFA Franc"},TH:{code:"THB",symbol:"\u0E3F",name:"Thai Baht"},TJ:{code:"TJS",symbol:"\u0405\u041C",name:"Tajikistani Somoni"},TK:{code:"NZD",symbol:"$",name:"New Zealand Dollar"},TL:{code:"USD",symbol:"$",name:"US Dollar"},TM:{code:"TMT",symbol:"m",name:"Turkmenistani Manat"},TN:{code:"TND",symbol:"\u062F.\u062A",name:"Tunisian Dinar"},TO:{code:"TOP",symbol:"T$",name:"Tongan Pa\u02BBanga"},TR:{code:"TRY",symbol:"\u20BA",name:"Turkish Lira"},TT:{code:"TTD",symbol:"$",name:"Trinidad and Tobago Dollar"},TV:{code:"AUD",symbol:"$",name:"Australian Dollar"},TW:{code:"TWD",symbol:"NT$",name:"New Taiwan Dollar"},TZ:{code:"TZS",symbol:"TSh",name:"Tanzanian Shilling"},UA:{code:"UAH",symbol:"\u20B4",name:"Ukrainian Hryvnia"},UG:{code:"UGX",symbol:"USh",name:"Ugandan Shilling"},UM:{code:"USD",symbol:"$",name:"US Dollar"},US:{code:"USD",symbol:"$",name:"US Dollar"},UY:{code:"UYU",symbol:"$",name:"Uruguayan Peso"},UZ:{code:"UZS",symbol:"\u0441\u045E\u043C",name:"Uzbekistani Som"},VA:{code:"EUR",symbol:"\u20AC",name:"Euro"},VC:{code:"XCD",symbol:"$",name:"East Caribbean Dollar"},VE:{code:"VES",symbol:"Bs.",name:"Venezuelan Bol\xEDvar"},VG:{code:"USD",symbol:"$",name:"US Dollar"},VI:{code:"USD",symbol:"$",name:"US Dollar"},VN:{code:"VND",symbol:"\u20AB",name:"Vietnamese Dong"},VU:{code:"VUV",symbol:"VT",name:"Vanuatu Vatu"},WF:{code:"XPF",symbol:"\u20A3",name:"CFP Franc"},WS:{code:"WST",symbol:"WS$",name:"Samoan Tala"},YE:{code:"YER",symbol:"\uFDFC",name:"Yemeni Rial"},YT:{code:"EUR",symbol:"\u20AC",name:"Euro"},ZA:{code:"ZAR",symbol:"R",name:"South African Rand"},ZM:{code:"ZMW",symbol:"ZK",name:"Zambian Kwacha"},ZW:{code:"ZWL",symbol:"$",name:"Zimbabwean Dollar"}},r=(()=>{let e={};for(let[o,m]of Object.entries(n))e[m.code]||(e[m.code]=[]),e[m.code].push(o);for(let o of Object.keys(e))e[o].sort();return e})();function s(e){let o=a(e);return n[o]??null}function c(e){let o=a(e);return n[o]?.code??null}function d(e){let o=a(e);return n[o]?.symbol??null}function y(e){let o=a(e);return n[o]?.name??null}function l(e){let o=a(e);return r[o]??[]}function i(e,o){let m=a(e),u=a(o);return n[m]?.code===u}var b=l;var F={getCurrency:s,getCurrencyCode:c,getCurrencySymbol:d,getCurrencyName:y,getCountriesByCurrency:b,countriesUsingCurrency:l,usesCurrency:i};exports.countriesUsingCurrency=l;exports.currencies=n;exports.currency=F;exports.currencyIndex=r;exports.getCountriesByCurrency=b;exports.getCurrency=s;exports.getCurrencyCode=c;exports.getCurrencyName=y;exports.getCurrencySymbol=d;exports.usesCurrency=i;

package/dist/currency/index.d.cts

@@ -0,0 +1,94 @@
+import { g as CurrencyInfo } from '../types-BPZJeVlW.cjs';
+
+/**
+ * Get currency for a country
+ * @param alpha2 - Country alpha-2 code
+ * @returns CurrencyInfo or null
+ * @example
+ * getCurrency('US') // { code: 'USD', symbol: '$', name: 'US Dollar' }
+ * getCurrency('FR') // { code: 'EUR', symbol: '€', name: 'Euro' }
+ */
+declare function getCurrency(alpha2: string): CurrencyInfo | null;
+/**
+ * Get just the currency code
+ * @param alpha2 - Country alpha-2 code
+ * @returns ISO 4217 currency code or null
+ * @example
+ * getCurrencyCode('US') // 'USD'
+ * getCurrencyCode('JP') // 'JPY'
+ */
+declare function getCurrencyCode(alpha2: string): string | null;
+/**
+ * Get just the currency symbol
+ * @param alpha2 - Country alpha-2 code
+ * @returns Currency symbol or null
+ * @example
+ * getCurrencySymbol('US') // '$'
+ * getCurrencySymbol('GB') // '£'
+ * getCurrencySymbol('JP') // '¥'
+ */
+declare function getCurrencySymbol(alpha2: string): string | null;
+/**
+ * Get just the currency name
+ * @param alpha2 - Country alpha-2 code
+ * @returns Currency name or null
+ * @example
+ * getCurrencyName('US') // 'US Dollar'
+ * getCurrencyName('JP') // 'Japanese Yen'
+ */
+declare function getCurrencyName(alpha2: string): string | null;
+/**
+ * Get all countries using a specific currency
+ * @param currencyCode - ISO 4217 currency code
+ * @returns Array of alpha-2 country codes
+ * @example
+ * countriesUsingCurrency('EUR') // ['AD', 'AT', 'BE', 'CY', 'DE', 'EE', 'ES', 'FI', 'FR', ...]
+ * countriesUsingCurrency('USD') // ['AS', 'BQ', 'EC', 'FM', 'GU', 'IO', 'MH', 'MP', 'PA', 'PR', 'PW', 'SV', 'TC', 'TL', 'UM', 'US', 'VG', 'VI']
+ */
+declare function countriesUsingCurrency(currencyCode: string): string[];
+/**
+ * Check if a country uses a specific currency
+ * @param alpha2 - Country alpha-2 code
+ * @param currencyCode - ISO 4217 currency code
+ * @returns true if country uses the currency
+ * @example
+ * usesCurrency('FR', 'EUR') // true
+ * usesCurrency('GB', 'EUR') // false
+ */
+declare function usesCurrency(alpha2: string, currencyCode: string): boolean;
+/**
+ * Alias for countriesUsingCurrency
+ */
+declare const getCountriesByCurrency: typeof countriesUsingCurrency;
+
+/**
+ * Currency data indexed by alpha-2 country code
+ * Based on ISO 4217 standard
+ */
+declare const currencies: Record<string, CurrencyInfo>;
+/**
+ * Currency code to countries index
+ */
+declare const currencyIndex: Record<string, string[]>;
+
+/**
+ * Currency module
+ *
+ * Provides currency lookup functions for countries.
+ */
+
+/**
+ * Currency functions
+ * Get currency information for any country
+ */
+declare const currency: {
+    getCurrency: typeof getCurrency;
+    getCurrencyCode: typeof getCurrencyCode;
+    getCurrencySymbol: typeof getCurrencySymbol;
+    getCurrencyName: typeof getCurrencyName;
+    getCountriesByCurrency: typeof countriesUsingCurrency;
+    countriesUsingCurrency: typeof countriesUsingCurrency;
+    usesCurrency: typeof usesCurrency;
+};
+
+export { countriesUsingCurrency, currencies, currency, currencyIndex, getCountriesByCurrency, getCurrency, getCurrencyCode, getCurrencyName, getCurrencySymbol, usesCurrency };