@visulima/iso-locale 1.0.0-alpha.8 → 1.0.0

package/dist/regions.d.ts

@@ -1,47 +1,1182 @@
-import type { Region } from "./types.d.ts";
-/**
- * Get region information for a country.
- * @param countryCode ISO 3166-1 alpha-2 country code (e.g., "US")
- * @returns Region object or undefined
- */
-export declare const getRegionsForCountry: (countryCode: string) => Region | undefined;
-/**
- * Get all countries in a continental region.
- * @param continent Continental region (e.g., "Africa", "Americas", "Asia", "Europe", "Oceania", "Antarctica")
- * @returns Array of ISO 3166-1 alpha-2 country codes
- */
-export declare const getCountriesInContinent: (continent: string) => string[];
-/**
- * Get all countries in a geographical subregion.
- * @param subregion Geographical subregion (e.g., "Northern Africa", "Western Europe")
- * @returns Array of ISO 3166-1 alpha-2 country codes
- */
-export declare const getCountriesInSubregion: (subregion: string) => string[];
-/**
- * Get all countries in an intermediary region.
- * @param intermediary Intermediary region (e.g., "Sub-Saharan Africa", "Latin America and the Caribbean")
- * @returns Array of ISO 3166-1 alpha-2 country codes
- */
-export declare const getCountriesInIntermediary: (intermediary: string) => string[];
-/**
- * Get all available continental regions.
- * @returns Array of continental region names
- */
-export declare const getContinents: () => string[];
-/**
- * Get all available geographical subregions.
- * @param continent Optional filter by continent
- * @returns Array of subregion names
- */
-export declare const getSubregions: (continent?: string) => string[];
-/**
- * Get all available intermediary regions.
- * @param continent Optional filter by continent
- * @returns Array of intermediary region names
- */
-export declare const getIntermediaryRegions: (continent?: string) => string[];
-/**
- * Get all regions data
- * @returns Record of country codes to regions
- */
-export declare const all: Readonly<Record<string, Region>>;
+import { Region } from "./types.js";
+/**
+* Country to region mapping based on UN geoscheme
+* Maps ISO 3166-1 alpha-2 country codes to their UN geoscheme regions
+*
+* Declared without a type annotation so the trailing `as const` captures the
+* literal keys/values; consumers in `src/regions.ts` derive precise unions from this.
+*/
+declare const countryRegions: {
+  readonly AD: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly AE: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly AF: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly AG: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly AI: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly AL: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly AM: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly AO: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly AQ: {
+    readonly continent: "Antarctica";
+    readonly subregion: "Antarctica";
+  };
+  readonly AR: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly AS: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly AT: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly AU: {
+    readonly continent: "Oceania";
+    readonly subregion: "Australia and New Zealand";
+  };
+  readonly AW: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly AX: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly AZ: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly BA: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly BB: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly BD: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly BE: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly BF: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly BG: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly BH: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly BI: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly BJ: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly BL: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly BM: {
+    readonly continent: "Americas";
+    readonly intermediary: "North America";
+    readonly subregion: "Northern America";
+  };
+  readonly BN: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly BO: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly BQ: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly BR: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly BS: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly BT: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly BV: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly BW: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Southern Africa";
+  };
+  readonly BY: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly BZ: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly CA: {
+    readonly continent: "Americas";
+    readonly intermediary: "North America";
+    readonly subregion: "Northern America";
+  };
+  readonly CC: {
+    readonly continent: "Oceania";
+    readonly subregion: "Australia and New Zealand";
+  };
+  readonly CD: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly CF: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly CG: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly CH: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly CI: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly CK: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly CL: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly CM: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly CN: {
+    readonly continent: "Asia";
+    readonly subregion: "Eastern Asia";
+  };
+  readonly CO: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly CR: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly CU: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly CV: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly CW: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly CX: {
+    readonly continent: "Oceania";
+    readonly subregion: "Australia and New Zealand";
+  };
+  readonly CY: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly CZ: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly DE: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly DJ: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly DK: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly DM: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly DO: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly DZ: {
+    readonly continent: "Africa";
+    readonly subregion: "Northern Africa";
+  };
+  readonly EC: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly EE: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly EG: {
+    readonly continent: "Africa";
+    readonly subregion: "Northern Africa";
+  };
+  readonly EH: {
+    readonly continent: "Africa";
+    readonly subregion: "Northern Africa";
+  };
+  readonly ER: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly ES: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly ET: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly FI: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly FJ: {
+    readonly continent: "Oceania";
+    readonly subregion: "Melanesia";
+  };
+  readonly FK: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly FM: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly FO: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly FR: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly GA: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly GB: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly GD: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly GE: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly GF: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly GG: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly GH: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly GI: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly GL: {
+    readonly continent: "Americas";
+    readonly intermediary: "North America";
+    readonly subregion: "Northern America";
+  };
+  readonly GM: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly GN: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly GP: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly GQ: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly GR: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly GS: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly GT: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly GU: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly GW: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly GY: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly HK: {
+    readonly continent: "Asia";
+    readonly subregion: "Eastern Asia";
+  };
+  readonly HM: {
+    readonly continent: "Oceania";
+    readonly subregion: "Australia and New Zealand";
+  };
+  readonly HN: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly HR: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly HT: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly HU: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly ID: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly IE: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly IL: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly IM: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly IN: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly IO: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly IQ: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly IR: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly IS: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly IT: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly JE: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly JM: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly JO: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly JP: {
+    readonly continent: "Asia";
+    readonly subregion: "Eastern Asia";
+  };
+  readonly KE: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly KG: {
+    readonly continent: "Asia";
+    readonly subregion: "Central Asia";
+  };
+  readonly KH: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly KI: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly KM: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly KN: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly KP: {
+    readonly continent: "Asia";
+    readonly subregion: "Eastern Asia";
+  };
+  readonly KR: {
+    readonly continent: "Asia";
+    readonly subregion: "Eastern Asia";
+  };
+  readonly KW: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly KY: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly KZ: {
+    readonly continent: "Asia";
+    readonly subregion: "Central Asia";
+  };
+  readonly LA: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly LB: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly LC: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly LI: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly LK: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly LR: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly LS: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Southern Africa";
+  };
+  readonly LT: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly LU: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly LV: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly LY: {
+    readonly continent: "Africa";
+    readonly subregion: "Northern Africa";
+  };
+  readonly MA: {
+    readonly continent: "Africa";
+    readonly subregion: "Northern Africa";
+  };
+  readonly MC: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly MD: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly ME: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly MF: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly MG: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly MH: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly MK: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly ML: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly MM: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly MN: {
+    readonly continent: "Asia";
+    readonly subregion: "Eastern Asia";
+  };
+  readonly MO: {
+    readonly continent: "Asia";
+    readonly subregion: "Eastern Asia";
+  };
+  readonly MP: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly MQ: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly MR: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly MS: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly MT: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly MU: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly MV: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly MW: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly MX: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly MY: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly MZ: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly NA: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Southern Africa";
+  };
+  readonly NC: {
+    readonly continent: "Oceania";
+    readonly subregion: "Melanesia";
+  };
+  readonly NE: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly NF: {
+    readonly continent: "Oceania";
+    readonly subregion: "Australia and New Zealand";
+  };
+  readonly NG: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly NI: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly NL: {
+    readonly continent: "Europe";
+    readonly subregion: "Western Europe";
+  };
+  readonly NO: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly NP: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly NR: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly NU: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly NZ: {
+    readonly continent: "Oceania";
+    readonly subregion: "Australia and New Zealand";
+  };
+  readonly OM: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly PA: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly PE: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly PF: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly PG: {
+    readonly continent: "Oceania";
+    readonly subregion: "Melanesia";
+  };
+  readonly PH: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly PK: {
+    readonly continent: "Asia";
+    readonly subregion: "Southern Asia";
+  };
+  readonly PL: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly PM: {
+    readonly continent: "Americas";
+    readonly intermediary: "North America";
+    readonly subregion: "Northern America";
+  };
+  readonly PN: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly PR: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly PS: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly PT: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly PW: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly PY: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly QA: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly RE: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly RO: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly RS: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly RU: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly RW: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly SA: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly SB: {
+    readonly continent: "Oceania";
+    readonly subregion: "Melanesia";
+  };
+  readonly SC: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly SD: {
+    readonly continent: "Africa";
+    readonly subregion: "Northern Africa";
+  };
+  readonly SE: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly SG: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly SH: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly SI: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly SJ: {
+    readonly continent: "Europe";
+    readonly subregion: "Northern Europe";
+  };
+  readonly SK: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly SL: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly SM: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly SN: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly SO: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly SR: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly SS: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly ST: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly SV: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Central America";
+  };
+  readonly SX: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly SY: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly SZ: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Southern Africa";
+  };
+  readonly TC: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly TD: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Middle Africa";
+  };
+  readonly TF: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly TG: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Western Africa";
+  };
+  readonly TH: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly TJ: {
+    readonly continent: "Asia";
+    readonly subregion: "Central Asia";
+  };
+  readonly TK: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly TL: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly TM: {
+    readonly continent: "Asia";
+    readonly subregion: "Central Asia";
+  };
+  readonly TN: {
+    readonly continent: "Africa";
+    readonly subregion: "Northern Africa";
+  };
+  readonly TO: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly TR: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly TT: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly TV: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly TZ: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly UA: {
+    readonly continent: "Europe";
+    readonly subregion: "Eastern Europe";
+  };
+  readonly UG: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly UM: {
+    readonly continent: "Oceania";
+    readonly subregion: "Micronesia";
+  };
+  readonly US: {
+    readonly continent: "Americas";
+    readonly intermediary: "North America";
+    readonly subregion: "Northern America";
+  };
+  readonly UY: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly UZ: {
+    readonly continent: "Asia";
+    readonly subregion: "Central Asia";
+  };
+  readonly VA: {
+    readonly continent: "Europe";
+    readonly subregion: "Southern Europe";
+  };
+  readonly VC: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly VE: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "South America";
+  };
+  readonly VG: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly VI: {
+    readonly continent: "Americas";
+    readonly intermediary: "Latin America and the Caribbean";
+    readonly subregion: "Caribbean";
+  };
+  readonly VN: {
+    readonly continent: "Asia";
+    readonly subregion: "South-eastern Asia";
+  };
+  readonly VU: {
+    readonly continent: "Oceania";
+    readonly subregion: "Melanesia";
+  };
+  readonly WF: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly WS: {
+    readonly continent: "Oceania";
+    readonly subregion: "Polynesia";
+  };
+  readonly YE: {
+    readonly continent: "Asia";
+    readonly subregion: "Western Asia";
+  };
+  readonly YT: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly ZA: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Southern Africa";
+  };
+  readonly ZM: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+  readonly ZW: {
+    readonly continent: "Africa";
+    readonly intermediary: "Sub-Saharan Africa";
+    readonly subregion: "Eastern Africa";
+  };
+};
+/**
+* Get region information for a country.
+* @param countryCode ISO 3166-1 alpha-2 country code (e.g., "US")
+* @returns Region object or undefined
+*/
+declare const getRegionsForCountry: (countryCode: string) => Region | undefined;
+/**
+* Get all countries in a continental region.
+* @param continent Continental region (e.g., "Africa", "Americas", "Asia", "Europe", "Oceania", "Antarctica")
+* @returns Array of ISO 3166-1 alpha-2 country codes
+*/
+declare const getCountriesInContinent: (continent: string) => string[];
+/**
+* Get all countries in a geographical subregion.
+* @param subregion Geographical subregion (e.g., "Northern Africa", "Western Europe")
+* @returns Array of ISO 3166-1 alpha-2 country codes
+*/
+declare const getCountriesInSubregion: (subregion: string) => string[];
+/**
+* Get all countries in an intermediary region.
+* @param intermediary Intermediary region (e.g., "Sub-Saharan Africa", "Latin America and the Caribbean")
+* @returns Array of ISO 3166-1 alpha-2 country codes
+*/
+declare const getCountriesInIntermediary: (intermediary: string) => string[];
+/**
+* Get all available continental regions.
+* @returns Array of continental region names
+*/
+declare const getContinents: () => string[];
+/**
+* Get all available geographical subregions.
+* @param continent Optional filter by continent
+* @returns Array of subregion names
+*/
+declare const getSubregions: (continent?: string) => string[];
+/**
+* Get all available intermediary regions.
+* @param continent Optional filter by continent
+* @returns Array of intermediary region names
+*/
+declare const getIntermediaryRegions: (continent?: string) => string[];
+/**
+* All region data, exposed with the precise const type so consumers get literal
+* keys/values (e.g. `regions.US.continent` narrows to {@link Continent}) at zero
+* runtime cost.
+*/
+declare const all: typeof countryRegions;
+/**
+* Precise per-country region record type, derived from the const dataset.
+*/
+type RegionData = (typeof countryRegions)[keyof typeof countryRegions];
+/**
+* Literal union of every ISO 3166-1 alpha-2 country code that has region data.
+*/
+type RegionCountryCode = keyof typeof countryRegions;
+/**
+* Literal union of every continental region present in the dataset.
+*/
+type Continent = RegionData["continent"];
+/**
+* Literal union of every geographical subregion present in the dataset.
+*/
+type Subregion = RegionData["subregion"];
+/**
+* Literal union of every intermediary region present in the dataset.
+*/
+type IntermediaryRegion = Extract<RegionData, {
+  intermediary: string;
+}>["intermediary"];
+export { Continent, IntermediaryRegion, RegionCountryCode, RegionData, Subregion, all, getContinents, getCountriesInContinent, getCountriesInIntermediary, getCountriesInSubregion, getIntermediaryRegions, getRegionsForCountry, getSubregions };