@sil/data 0.1.10 → 0.1.12

package/dist/types/data/translations/zh.d.ts

@@ -0,0 +1,646 @@
+declare const _default: {
+    countries: {
+        AD: {
+            name: string;
+        };
+        AE: {
+            name: string;
+        };
+        AF: {
+            name: string;
+        };
+        AG: {
+            name: string;
+        };
+        AL: {
+            name: string;
+        };
+        AM: {
+            name: string;
+        };
+        AO: {
+            name: string;
+        };
+        AR: {
+            name: string;
+        };
+        AT: {
+            name: string;
+        };
+        AU: {
+            name: string;
+        };
+        AZ: {
+            name: string;
+        };
+        BA: {
+            name: string;
+        };
+        BB: {
+            name: string;
+        };
+        BD: {
+            name: string;
+        };
+        BE: {
+            name: string;
+        };
+        BF: {
+            name: string;
+        };
+        BG: {
+            name: string;
+        };
+        BH: {
+            name: string;
+        };
+        BI: {
+            name: string;
+        };
+        BJ: {
+            name: string;
+        };
+        BN: {
+            name: string;
+        };
+        BO: {
+            name: string;
+        };
+        BR: {
+            name: string;
+        };
+        BS: {
+            name: string;
+        };
+        BT: {
+            name: string;
+        };
+        BW: {
+            name: string;
+        };
+        BY: {
+            name: string;
+        };
+        BZ: {
+            name: string;
+        };
+        CA: {
+            name: string;
+        };
+        CD: {
+            name: string;
+        };
+        CF: {
+            name: string;
+        };
+        CG: {
+            name: string;
+        };
+        CH: {
+            name: string;
+        };
+        CL: {
+            name: string;
+        };
+        CM: {
+            name: string;
+        };
+        CN: {
+            name: string;
+        };
+        CO: {
+            name: string;
+        };
+        CR: {
+            name: string;
+        };
+        CU: {
+            name: string;
+        };
+        CV: {
+            name: string;
+        };
+        CY: {
+            name: string;
+        };
+        CZ: {
+            name: string;
+        };
+        DE: {
+            name: string;
+        };
+        DJ: {
+            name: string;
+        };
+        DK: {
+            name: string;
+        };
+        DM: {
+            name: string;
+        };
+        DO: {
+            name: string;
+        };
+        DZ: {
+            name: string;
+        };
+        EC: {
+            name: string;
+        };
+        EE: {
+            name: string;
+        };
+        EG: {
+            name: string;
+        };
+        ER: {
+            name: string;
+        };
+        ES: {
+            name: string;
+        };
+        ET: {
+            name: string;
+        };
+        FI: {
+            name: string;
+        };
+        FJ: {
+            name: string;
+        };
+        FM: {
+            name: string;
+        };
+        FR: {
+            name: string;
+        };
+        GA: {
+            name: string;
+        };
+        GB: {
+            name: string;
+        };
+        GD: {
+            name: string;
+        };
+        GE: {
+            name: string;
+        };
+        GH: {
+            name: string;
+        };
+        GM: {
+            name: string;
+        };
+        GN: {
+            name: string;
+        };
+        GQ: {
+            name: string;
+        };
+        GR: {
+            name: string;
+        };
+        GT: {
+            name: string;
+        };
+        GW: {
+            name: string;
+        };
+        GY: {
+            name: string;
+        };
+        HN: {
+            name: string;
+        };
+        HR: {
+            name: string;
+        };
+        HT: {
+            name: string;
+        };
+        HU: {
+            name: string;
+        };
+        ID: {
+            name: string;
+        };
+        IE: {
+            name: string;
+        };
+        IL: {
+            name: string;
+        };
+        IN: {
+            name: string;
+        };
+        IQ: {
+            name: string;
+        };
+        IR: {
+            name: string;
+        };
+        IS: {
+            name: string;
+        };
+        IT: {
+            name: string;
+        };
+        JM: {
+            name: string;
+        };
+        JO: {
+            name: string;
+        };
+        JP: {
+            name: string;
+        };
+        KE: {
+            name: string;
+        };
+        KG: {
+            name: string;
+        };
+        KH: {
+            name: string;
+        };
+        KI: {
+            name: string;
+        };
+        KM: {
+            name: string;
+        };
+        KN: {
+            name: string;
+        };
+        KP: {
+            name: string;
+        };
+        KR: {
+            name: string;
+        };
+        KW: {
+            name: string;
+        };
+        KZ: {
+            name: string;
+        };
+        LA: {
+            name: string;
+        };
+        LB: {
+            name: string;
+        };
+        LC: {
+            name: string;
+        };
+        LI: {
+            name: string;
+        };
+        LK: {
+            name: string;
+        };
+        LR: {
+            name: string;
+        };
+        LS: {
+            name: string;
+        };
+        LT: {
+            name: string;
+        };
+        LU: {
+            name: string;
+        };
+        LV: {
+            name: string;
+        };
+        LY: {
+            name: string;
+        };
+        MA: {
+            name: string;
+        };
+        MC: {
+            name: string;
+        };
+        MD: {
+            name: string;
+        };
+        ME: {
+            name: string;
+        };
+        MG: {
+            name: string;
+        };
+        MH: {
+            name: string;
+        };
+        MK: {
+            name: string;
+        };
+        ML: {
+            name: string;
+        };
+        MM: {
+            name: string;
+        };
+        MN: {
+            name: string;
+        };
+        MR: {
+            name: string;
+        };
+        MT: {
+            name: string;
+        };
+        MU: {
+            name: string;
+        };
+        MV: {
+            name: string;
+        };
+        MW: {
+            name: string;
+        };
+        MX: {
+            name: string;
+        };
+        MY: {
+            name: string;
+        };
+        MZ: {
+            name: string;
+        };
+        NA: {
+            name: string;
+        };
+        NE: {
+            name: string;
+        };
+        NG: {
+            name: string;
+        };
+        NI: {
+            name: string;
+        };
+        NL: {
+            name: string;
+        };
+        NO: {
+            name: string;
+        };
+        NP: {
+            name: string;
+        };
+        NR: {
+            name: string;
+        };
+        NZ: {
+            name: string;
+        };
+        OM: {
+            name: string;
+        };
+        PA: {
+            name: string;
+        };
+        PE: {
+            name: string;
+        };
+        PG: {
+            name: string;
+        };
+        PH: {
+            name: string;
+        };
+        PK: {
+            name: string;
+        };
+        PL: {
+            name: string;
+        };
+        PS: {
+            name: string;
+        };
+        PT: {
+            name: string;
+        };
+        PW: {
+            name: string;
+        };
+        PY: {
+            name: string;
+        };
+        QA: {
+            name: string;
+        };
+        RO: {
+            name: string;
+        };
+        RS: {
+            name: string;
+        };
+        RU: {
+            name: string;
+        };
+        RW: {
+            name: string;
+        };
+        SA: {
+            name: string;
+        };
+        SB: {
+            name: string;
+        };
+        SC: {
+            name: string;
+        };
+        SD: {
+            name: string;
+        };
+        SE: {
+            name: string;
+        };
+        SG: {
+            name: string;
+        };
+        SI: {
+            name: string;
+        };
+        SK: {
+            name: string;
+        };
+        SL: {
+            name: string;
+        };
+        SM: {
+            name: string;
+        };
+        SN: {
+            name: string;
+        };
+        SO: {
+            name: string;
+        };
+        SR: {
+            name: string;
+        };
+        SS: {
+            name: string;
+        };
+        ST: {
+            name: string;
+        };
+        SV: {
+            name: string;
+        };
+        SY: {
+            name: string;
+        };
+        SZ: {
+            name: string;
+        };
+        TD: {
+            name: string;
+        };
+        TG: {
+            name: string;
+        };
+        TH: {
+            name: string;
+        };
+        TJ: {
+            name: string;
+        };
+        TL: {
+            name: string;
+        };
+        TM: {
+            name: string;
+        };
+        TN: {
+            name: string;
+        };
+        TO: {
+            name: string;
+        };
+        TR: {
+            name: string;
+        };
+        TT: {
+            name: string;
+        };
+        TV: {
+            name: string;
+        };
+        TW: {
+            name: string;
+        };
+        TZ: {
+            name: string;
+        };
+        UA: {
+            name: string;
+        };
+        UG: {
+            name: string;
+        };
+        US: {
+            name: string;
+        };
+        UY: {
+            name: string;
+        };
+        UZ: {
+            name: string;
+        };
+        VA: {
+            name: string;
+        };
+        VC: {
+            name: string;
+        };
+        VE: {
+            name: string;
+        };
+        VN: {
+            name: string;
+        };
+        VU: {
+            name: string;
+        };
+        WS: {
+            name: string;
+        };
+        XK: {
+            name: string;
+        };
+        XN: {
+            name: string;
+        };
+        YE: {
+            name: string;
+        };
+        ZA: {
+            name: string;
+        };
+        ZM: {
+            name: string;
+        };
+        ZW: {
+            name: string;
+        };
+    };
+    continents: {
+        AF: string;
+        AN: string;
+        AS: string;
+        EU: string;
+        NA: string;
+        OC: string;
+        SA: string;
+    };
+    cities: {
+        Beijing: string;
+        Shanghai: string;
+        Tokyo: string;
+        Seoul: string;
+        Moscow: string;
+        London: string;
+        Paris: string;
+        "New York": string;
+        "New Delhi": string;
+        Bangkok: string;
+        Singapore: string;
+        "Hong Kong": string;
+        Taipei: string;
+        Osaka: string;
+        Cairo: string;
+        Vienna: string;
+        Athens: string;
+        Brussels: string;
+        Warsaw: string;
+        Prague: string;
+        Kyiv: string;
+    };
+    currencies: {
+        USD: string;
+        EUR: string;
+        GBP: string;
+        JPY: string;
+        CHF: string;
+        CNY: string;
+        CAD: string;
+        AUD: string;
+        HKD: string;
+        KRW: string;
+        INR: string;
+        RUB: string;
+        BRL: string;
+        SGD: string;
+        TWD: string;
+        MXN: string;
+    };
+};
+export default _default;

package/dist/types/data/translations.d.ts

@@ -0,0 +1,66 @@
+import type { Country, City, Continent, Currency } from "../types/index.js";
+/**
+ * Translation record for a single country.
+ */
+export interface CountryTranslation {
+    /** Translated country name */
+    name: string;
+    /** Translated capital city name (optional; omit if same as the English name) */
+    capital?: string;
+}
+/**
+ * All translations for a single language.
+ */
+export interface TranslationMap {
+    /** Country translations keyed by ISO 3166-1 alpha-2 code */
+    countries: Record<string, CountryTranslation>;
+    /** Continent translations keyed by two-letter continent code */
+    continents: Record<string, string>;
+    /** City name translations keyed by English city name */
+    cities: Record<string, string>;
+    /** Currency name translations keyed by ISO 4217 code */
+    currencies: Record<string, string>;
+}
+/**
+ * All supported translation language codes (BCP 47 language tags).
+ * English ("en") is the default and is always derived from the source data.
+ */
+export type TranslationLanguage = "en" | "ar" | "de" | "es" | "fr" | "hi" | "it" | "ja" | "ko" | "nl" | "pl" | "pt" | "ru" | "tr" | "zh";
+/**
+ * Translation data for all supported languages.
+ * Each language is defined in its own file under src/data/translations/.
+ * English ("en") is intentionally omitted – the source data already contains English strings.
+ */
+export declare const translations: Record<string, TranslationMap>;
+/**
+ * Return the list of BCP 47 language codes that have translation data.
+ * "en" is always included because the source data is in English.
+ */
+export declare function getSupportedLanguages(): TranslationLanguage[];
+/**
+ * Retrieve the full translation map for a given language code.
+ * Returns `undefined` for unsupported languages (including "en", which uses the
+ * source data directly).
+ */
+export declare function getTranslations(lang: string): TranslationMap | undefined;
+/**
+ * Return a shallow copy of `country` with `name` (and optionally `capital`)
+ * replaced by the translated values for `lang`.
+ * Falls back to the original English values when no translation is found.
+ */
+export declare function translateCountry(country: Country, lang: string): Country;
+/**
+ * Return a shallow copy of `city` with `name` replaced by the translated value
+ * for `lang`. Falls back to the original English name when no translation exists.
+ */
+export declare function translateCity(city: City, lang: string): City;
+/**
+ * Return a shallow copy of `continent` with `name` replaced by the translated
+ * value for `lang`. Falls back to the original English name when no translation exists.
+ */
+export declare function translateContinent(continent: Continent, lang: string): Continent;
+/**
+ * Return a shallow copy of `currency` with `name` replaced by the translated
+ * value for `lang`. Falls back to the original English name when no translation exists.
+ */
+export declare function translateCurrency(currency: Currency, lang: string): Currency;

package/dist/types/index.d.ts

@@ -16,6 +16,8 @@
  * ```
  */
 export type { Country, PhoneCountryCode, City, State, StateType, Continent, ContinentName, Currency, CountryGeography, CountryBounds, ClimateZone, FlagInfo, FlagColor, CardinalDirection, WorldMapCountry, WorldMapOptions, WorldMapHighlight, ReligionBreakdown, EthnicGroup, CountryDemographics, CountryMapOptions, } from "./types/index.js";
+export type { CountryTranslation, TranslationMap, TranslationLanguage, } from "./data/translations.js";
+export { translations, getSupportedLanguages, getTranslations, translateCountry, translateCity, translateContinent, translateCurrency, } from "./data/translations.js";
 export { countries, getCountryByCode, getCountriesByContinent, getCountryFlag, getRecognizedCountries, } from "./data/countries.js";
 export { phoneCountryCodes, getPhoneCodeByCountry, getCountriesByPhoneCode, } from "./data/phoneCodes.js";
 export { cities, getCitiesByCountry, getCapitalCity, getCitiesByPopulation, searchCities, } from "./data/cities.js";

package/dist/types/types/index.d.ts

@@ -22,6 +22,10 @@ export interface Country {
     continent: ContinentName;
     /** ISO 4217 currency code (e.g., "USD") */
     currency: string;
+    /** Full currency name, optionally translated (e.g., "US Dollar", "US-Dollar") */
+    currencyName?: string;
+    /** Currency symbol (e.g., "$") */
+    currencySymbol?: string;
     /** Primary language(s) spoken */
     languages: string[];
     /** Top-level domain (e.g., ".us") */