@zukall/zap 0.0.0-stage → 0.2.1

package/dist/esm/address_province_bounty.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Frozen address-grid snapshot; historical coverage notes are exported below.
+ * Scope: 22 countries and 530 province grids.
+ * Source: Natural Earth Admin-1 States/Provinces, 1:10 million, public domain.
+ * https://www.naturalearthdata.com/downloads/10m-cultural-vectors/10m-admin-1-states-provinces/
+ * https://raw.githubusercontent.com/nvkelso/natural-earth-vector/master/geojson/ne_10m_admin_1_states_provinces.geojson
+ * Retrieved: 2026-10-10. Retrieval date is NOT the date of administrative validity.
+ * SHA256: 22d0e3ad85eb3e27f17cabf8ba2d50e554fbc27a87796ff891d958185da62fb5
+ *
+ * Every country constant has exactly name, version, province.
+ * Province entries have name, version, corners.
+ * Four corners: topLeft, topRight, bottomRight, bottomLeft.
+ * Six decimal places, rounded OUTWARD to contain source geometry.
+ * Precision of representation does not imply centimeter boundary accuracy.
+ * For date-line rectangles, left/west longitude can exceed right/east longitude.
+ * ZAP supports these date-line rectangles.
+ *
+ * Keys prefer the source ISO-3166-2 suffix, e.g. AK, TX, ON, XJ, 01.
+ * Source codes are not verified current ISO codes. Duplicated, synthetic, or
+ * nonmatching codes get a stable NE_ source-ID key; none are silently overwritten.
+ * Review provinceDataNotes before presenting these as administrative choices.
+ * These snapshots can define fixed grid origins, but must not be advertised as
+ * current/all provinces. Replacing bounds later changes generated addresses.
+ * Source territorial groupings reflect map conventions, not sovereignty claims.
+ *
+ * Integration: the source constants use singular `province`.
+ * `provinceGrids` below adapts them to plural `provinces` for generateAddress.
+ */
+import type { Country, ProvinceCountry } from "./types.js";
+export declare const DZ: ProvinceCountry;
+export declare const CD: ProvinceCountry;
+export declare const SD: ProvinceCountry;
+export declare const LY: ProvinceCountry;
+export declare const TD: ProvinceCountry;
+export declare const NE: ProvinceCountry;
+export declare const AO: ProvinceCountry;
+export declare const ML: ProvinceCountry;
+export declare const ZA: ProvinceCountry;
+export declare const ET: ProvinceCountry;
+export declare const MR: ProvinceCountry;
+export declare const RU: ProvinceCountry;
+export declare const CA: ProvinceCountry;
+export declare const US: ProvinceCountry;
+export declare const CN: ProvinceCountry;
+export declare const BR: ProvinceCountry;
+export declare const AU: ProvinceCountry;
+export declare const IN: ProvinceCountry;
+export declare const AR: ProvinceCountry;
+export declare const KZ: ProvinceCountry;
+export declare const SA: ProvinceCountry;
+export declare const ID: ProvinceCountry;
+export declare const provinceCountries: Readonly<Record<string, ProvinceCountry>>;
+/** Use this adapter to replace country-wide entries in address_bounty.ts. */
+export declare const provinceGrids: Readonly<Record<string, Country>>;
+export declare const provinceDataNotes: Readonly<Record<string, readonly string[]>>;
+export declare const provinceCounts: Readonly<Record<string, number>>;