@sil/data 0.1.8 → 0.1.10

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

@@ -16,3 +16,8 @@ export declare function getCountriesByContinent(continent: Country["continent"])
  * Get a country's flag emoji by its ISO 3166-1 alpha-2 code.
  */
 export declare function getCountryFlag(alpha2: string): string;
+/**
+ * Get all officially recognized sovereign countries.
+ * Excludes disputed or unrecognized territories.
+ */
+export declare function getRecognizedCountries(): Country[];

package/dist/types/index.d.ts

@@ -15,8 +15,8 @@
  * }));
  * ```
  */
-export type { Country, PhoneCountryCode, City, State, StateType, Continent, ContinentName, Currency, CountryGeography, CountryBounds, ClimateZone, FlagInfo, FlagColor, CardinalDirection, WorldMapCountry, WorldMapOptions, WorldMapHighlight, CountryMapOptions, } from "./types/index.js";
-export { countries, getCountryByCode, getCountriesByContinent, getCountryFlag, } from "./data/countries.js";
+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 { 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";
 export { states, getStatesByCountry, getStateByCode, getStatesByType, } from "./data/states.js";

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

@@ -26,6 +26,12 @@ export interface Country {
     languages: string[];
     /** Top-level domain (e.g., ".us") */
     tld?: string;
+    /**
+     * Whether the country is officially recognized as a sovereign state.
+     * `false` for disputed or unrecognized territories (e.g., Kosovo, Nagorno-Karabakh)
+     * that use user-assigned ISO codes not endorsed by the UN.
+     */
+    recognized: boolean;
 }
 /**
  * Continent names
@@ -207,6 +213,46 @@ export interface WorldMapOptions {
     /** Optional CSS class added to the `<svg>` element. */
     className?: string;
 }
+/**
+ * A single religion and its approximate share of a country's population.
+ */
+export interface ReligionBreakdown {
+    /** Religion name (e.g., "Christianity", "Islam", "Hinduism") */
+    name: string;
+    /** Percentage of the population (0–100) */
+    percentage: number;
+}
+/**
+ * A single ethnic group and its approximate share of a country's population.
+ */
+export interface EthnicGroup {
+    /** Ethnic group name (e.g., "Han Chinese", "White", "Mestizo") */
+    name: string;
+    /** Percentage of the population (0–100) */
+    percentage: number;
+}
+/**
+ * Demographic data for a country: population, religions, and ethnic makeup.
+ * Data is sourced from the CIA World Factbook, Pew Research Center, and UN estimates.
+ */
+export interface CountryDemographics {
+    /** ISO 3166-1 alpha-2 code */
+    alpha2: string;
+    /** Approximate total population */
+    population: number;
+    /** Year of the population estimate */
+    populationYear: number;
+    /**
+     * Religious breakdown, sorted by percentage descending.
+     * Percentages may not sum to exactly 100 due to rounding or "other/unspecified" omissions.
+     */
+    religions: ReligionBreakdown[];
+    /**
+     * Ethnic group breakdown, sorted by percentage descending.
+     * Percentages may not sum to exactly 100 due to rounding or "other/unspecified" omissions.
+     */
+    ethnicGroups: EthnicGroup[];
+}
 /**
  * Describes a highlighted country on the world map.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sil/data",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "A comprehensive collection of reusable world data: countries, phone codes, flags, cities, states, provinces and more",
   "type": "module",
   "main": "./dist/sil-data.cjs",