localized-regions 1.0.1 → 1.0.2

package/README.md

@@ -6,7 +6,7 @@
 [![types](https://img.shields.io/npm/types/localized-regions.svg)](./dist/index.d.ts)
 
 **Country, province and city data with bilingual localized labels and ISO 3166 codes.**
-Get country / province / city dropdown options with labels like `Spain (España)`, stable ISO
+Get country / province / city dropdown options with labels like `España (Spain)`, stable ISO
 3166-1 and ISO 3166-2 codes, and the full set of **50 Spanish provinces** (not the 17
 autonomous communities). Framework-agnostic and TypeScript-first: the data drops straight into
 **react-select**, **MUI Autocomplete**, or any dropdown.
@@ -14,13 +14,13 @@ autonomous communities). Framework-agnostic and TypeScript-first: the data drops
 ```ts
 import { countryOptions, provinceOptions } from 'localized-regions';
 
-countryOptions('es');   // [{ value: 'ES', label: 'Spain (España)' }, { value: 'NL', label: 'Netherlands (Países Bajos)' }, ...]
+countryOptions('es');   // [{ value: 'ES', label: 'España (Spain)' }, { value: 'NL', label: 'Nederland (Netherlands)' }, ...]
 provinceOptions('ES');  // [{ value: 'ES-MA', label: 'Málaga' }, { value: 'ES-B', label: 'Barcelona' }, ...]
 ```
 
 ## Features
 
-- **Bilingual / localized country labels** - `Spain (España)`, `Germany (Alemania)`, `France (Francia)`, computed from the browser-native `Intl.DisplayNames` for any locale.
+- **Bilingual / localized country labels** - `España (Spain)`, `Deutschland (Germany)`, `Nederland (Netherlands)`, computed from the browser-native `Intl.DisplayNames` for any locale.
 - **Correct Spanish provinces** - all **50 provinces** with ISO 3166-2 codes and their parent autonomous community. (Popular datasets like `country-state-city` return only ~16 of them for Spain.)
 - **Stable, invoicing-safe values** - country = ISO 3166-1 code (`ES`), province = ISO 3166-2 code (`ES-MA`). Labels are display-only.
 - **Full city database** - cities for every country, sourced from `country-state-city` at runtime.
@@ -43,7 +43,7 @@ import {
 } from 'localized-regions';
 
 // Bilingual country labels (the locale drives the native part)
-getCountries({ locale: 'es' });  // [{ code:'ES', name:'Spain', localized:'España', label:'Spain (España)' }, ...]
+getCountries({ locale: 'es' });  // [{ code:'ES', name:'Spain', localized:'España', label:'España (Spain)' }, ...]
 getCountries();                  // English-only labels
 
 // Spain -> 50 provinces (ISO 3166-2 codes + community grouping)
@@ -53,11 +53,11 @@ getProvinces('ES');              // [{ code:'ES-MA', countryCode:'ES', name:'Má
 getCities('ES', 'ES-MA');
 
 // Ready-to-use dropdown options
-countryOptions('es');            // [{ value:'ES', label:'Spain (España)' }, ...]
+countryOptions('es');            // [{ value:'ES', label:'España (Spain)' }, ...]
 provinceOptions('ES');           // [{ value:'ES-MA', label:'Málaga' }, ...]
 cityOptions('ES', 'ES-MA');      // [{ value:'Málaga', label:'Málaga' }, ...]
 
-formatCountryLabel('ES', 'es');  // "Spain (España)"
+formatCountryLabel('ES', 'es');  // "España (Spain)"
 ```
 
 ### With react-select (editable / creatable dropdowns)

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import { Country, CountryOption, Province, City, Option } from './types';
 /**
  * All countries. Pass a locale (e.g. "es") to get bilingual labels like
- * "Spain (España)". Omit or pass "en" for English-only labels.
+ * "España (Spain)". Omit or pass "en" for English-only labels.
  */
 export declare function getCountries(opts?: {
     locale?: string;
 }): CountryOption[];
 export declare function getCountry(code: string): Country | undefined;
-/** Bilingual (or English) display label for a single country code. */
+/** Bilingual (Native (English)) or native-only display label for a single country code. */
 export declare function formatCountryLabel(code: string, locale?: string): string;
 /**
  * Provinces for a country. Spain returns the curated 50 Provinces (RAT-1776);

package/dist/index.js

@@ -41,11 +41,11 @@ function displayName(code, locale) {
     }
 }
 function buildLabel(name, localized) {
-    return localized && localized !== name ? `${name} (${localized})` : name;
+    return localized && localized !== name ? `${localized} (${name})` : name;
 }
 /**
  * All countries. Pass a locale (e.g. "es") to get bilingual labels like
- * "Spain (España)". Omit or pass "en" for English-only labels.
+ * "España (Spain)". Omit or pass "en" for English-only labels.
  */
 function getCountries(opts = {}) {
     const { locale } = opts;
@@ -57,7 +57,7 @@ function getCountries(opts = {}) {
 function getCountry(code) {
     return countries_1.default.find((c) => c.code === code.toUpperCase());
 }
-/** Bilingual (or English) display label for a single country code. */
+/** Bilingual (Native (English)) or native-only display label for a single country code. */
 function formatCountryLabel(code, locale) {
     const c = getCountry(code);
     if (!c)

package/dist/types.d.ts

@@ -10,7 +10,7 @@ export interface CountryOption {
     name: string;
     /** Name in the requested locale, e.g. "España" (undefined when locale is en/absent) */
     localized?: string;
-    /** Display label, e.g. "Spain (España)" when localized, else "Spain" */
+    /** Display label, e.g. "España (Spain)" when localized, else "Spain" */
     label: string;
 }
 export interface Province {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "localized-regions",
-  "version": "1.0.1",
-  "description": "Country, province and city data with bilingual localized labels (e.g. \"Spain (España)\") and ISO 3166-1 / ISO 3166-2 codes. Ships all 50 Spanish provinces. Framework-agnostic, drop-in options for react-select and MUI dropdowns.",
+  "version": "1.0.2",
+  "description": "Country, province and city data with bilingual localized labels (e.g. \"España (Spain)\") and ISO 3166-1 / ISO 3166-2 codes. Ships all 50 Spanish provinces. Framework-agnostic, drop-in options for react-select and MUI dropdowns.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [