choropleth-kit 0.0.0-stage → 0.1.0

package/dist/geo.d.ts

@@ -0,0 +1,35 @@
+import { Topology } from 'topojson-specification';
+
+/**
+ * ISO 3166-1 numeric → alpha-2 (`"724"` → `"ES"`). For anyone using `world-atlas` directly
+ * (its ids are numeric) who has alpha-2 data: `getFeatureId={(f) => isoNumericToAlpha2[f.id]}`.
+ */
+declare const isoNumericToAlpha2: Readonly<Record<string, string>>;
+
+/** Point [x, y] in pixels or [lon, lat] in degrees, depending on context. */
+type Point = readonly [number, number];
+
+/**
+ * [lon, lat] of the countries and territories that `world-110m` does NOT draw (at 1:110m the
+ * microstates and most islands disappear). Pass it as `fallbackPoints` so a datum for Andorra or
+ * Singapore shows up as a colored dot instead of silently getting lost.
+ *
+ * It is not exhaustive: it covers the missing independent countries and the territories most common
+ * in business data (Hong Kong, Macao, Gibraltar, the Faroe Islands…). Add your own with a spread.
+ */
+declare const worldFallbackPoints: Readonly<Record<string, Point>>;
+
+/**
+ * World at 1:110m (Natural Earth, public domain) as TopoJSON, with **ISO 3166-1 alpha-2 in `id`**
+ * (`"ES"`) and the English name in `properties.name`. Use the `countries` object.
+ *
+ * It is `world-atlas` with the ids converted (see `scripts/build-geo/build-world-110m.mjs`), plus
+ * Kosovo as `"XK"`. Northern Cyprus and Somaliland still have no id: they are painted as a
+ * non-interactive layer. At this scale microstates are missing: use `worldFallbackPoints`.
+ *
+ * ⚠️ Disputed borders (Western Sahara, Crimea, Kashmir…) are Natural Earth's.
+ * Validate them before showing a map in a product.
+ */
+declare const world110m: Topology;
+
+export { isoNumericToAlpha2, world110m, worldFallbackPoints };