@johnmorrisdotca/kuni 1.4.0 → 1.6.0

package/dist/cities.js

@@ -0,0 +1,645 @@
+// src/data/codes.data.ts
+var COUNTRY_CODES = [
+  "AD",
+  "AE",
+  "AF",
+  "AG",
+  "AI",
+  "AL",
+  "AM",
+  "AO",
+  "AQ",
+  "AR",
+  "AS",
+  "AT",
+  "AU",
+  "AW",
+  "AX",
+  "AZ",
+  "BA",
+  "BB",
+  "BD",
+  "BE",
+  "BF",
+  "BG",
+  "BH",
+  "BI",
+  "BJ",
+  "BL",
+  "BM",
+  "BN",
+  "BO",
+  "BQ",
+  "BR",
+  "BS",
+  "BT",
+  "BV",
+  "BW",
+  "BY",
+  "BZ",
+  "CA",
+  "CC",
+  "CD",
+  "CF",
+  "CG",
+  "CH",
+  "CI",
+  "CK",
+  "CL",
+  "CM",
+  "CN",
+  "CO",
+  "CR",
+  "CU",
+  "CV",
+  "CW",
+  "CX",
+  "CY",
+  "CZ",
+  "DE",
+  "DJ",
+  "DK",
+  "DM",
+  "DO",
+  "DZ",
+  "EC",
+  "EE",
+  "EG",
+  "EH",
+  "ER",
+  "ES",
+  "ET",
+  "FI",
+  "FJ",
+  "FK",
+  "FM",
+  "FO",
+  "FR",
+  "GA",
+  "GB",
+  "GD",
+  "GE",
+  "GF",
+  "GG",
+  "GH",
+  "GI",
+  "GL",
+  "GM",
+  "GN",
+  "GP",
+  "GQ",
+  "GR",
+  "GS",
+  "GT",
+  "GU",
+  "GW",
+  "GY",
+  "HK",
+  "HM",
+  "HN",
+  "HR",
+  "HT",
+  "HU",
+  "ID",
+  "IE",
+  "IL",
+  "IM",
+  "IN",
+  "IO",
+  "IQ",
+  "IR",
+  "IS",
+  "IT",
+  "JE",
+  "JM",
+  "JO",
+  "JP",
+  "KE",
+  "KG",
+  "KH",
+  "KI",
+  "KM",
+  "KN",
+  "KP",
+  "KR",
+  "KW",
+  "KY",
+  "KZ",
+  "LA",
+  "LB",
+  "LC",
+  "LI",
+  "LK",
+  "LR",
+  "LS",
+  "LT",
+  "LU",
+  "LV",
+  "LY",
+  "MA",
+  "MC",
+  "MD",
+  "ME",
+  "MF",
+  "MG",
+  "MH",
+  "MK",
+  "ML",
+  "MM",
+  "MN",
+  "MO",
+  "MP",
+  "MQ",
+  "MR",
+  "MS",
+  "MT",
+  "MU",
+  "MV",
+  "MW",
+  "MX",
+  "MY",
+  "MZ",
+  "NA",
+  "NC",
+  "NE",
+  "NF",
+  "NG",
+  "NI",
+  "NL",
+  "NO",
+  "NP",
+  "NR",
+  "NU",
+  "NZ",
+  "OM",
+  "PA",
+  "PE",
+  "PF",
+  "PG",
+  "PH",
+  "PK",
+  "PL",
+  "PM",
+  "PN",
+  "PR",
+  "PS",
+  "PT",
+  "PW",
+  "PY",
+  "QA",
+  "RE",
+  "RO",
+  "RS",
+  "RU",
+  "RW",
+  "SA",
+  "SB",
+  "SC",
+  "SD",
+  "SE",
+  "SG",
+  "SH",
+  "SI",
+  "SJ",
+  "SK",
+  "SL",
+  "SM",
+  "SN",
+  "SO",
+  "SR",
+  "SS",
+  "ST",
+  "SV",
+  "SX",
+  "SY",
+  "SZ",
+  "TC",
+  "TD",
+  "TF",
+  "TG",
+  "TH",
+  "TJ",
+  "TK",
+  "TL",
+  "TM",
+  "TN",
+  "TO",
+  "TR",
+  "TT",
+  "TV",
+  "TW",
+  "TZ",
+  "UA",
+  "UG",
+  "UM",
+  "US",
+  "UY",
+  "UZ",
+  "VA",
+  "VC",
+  "VE",
+  "VG",
+  "VI",
+  "VN",
+  "VU",
+  "WF",
+  "WS",
+  "XK",
+  "YE",
+  "YT",
+  "ZA",
+  "ZM",
+  "ZW"
+];
+
+// src/codes.ts
+var CODE_SET = new Set(COUNTRY_CODES);
+var isCountryCode = (value) => typeof value === "string" && CODE_SET.has(value);
+
+// src/data/city-aliases.data.ts
+var CITY_ALIASES = {};
+
+// src/data/city-loaders.data.ts
+var CITY_LOADERS = {
+  ad: () => import("./cities/ad.js"),
+  ae: () => import("./cities/ae.js"),
+  af: () => import("./cities/af.js"),
+  ag: () => import("./cities/ag.js"),
+  ai: () => import("./cities/ai.js"),
+  al: () => import("./cities/al.js"),
+  am: () => import("./cities/am.js"),
+  ao: () => import("./cities/ao.js"),
+  ar: () => import("./cities/ar.js"),
+  as: () => import("./cities/as.js"),
+  at: () => import("./cities/at.js"),
+  au: () => import("./cities/au.js"),
+  aw: () => import("./cities/aw.js"),
+  ax: () => import("./cities/ax.js"),
+  az: () => import("./cities/az.js"),
+  ba: () => import("./cities/ba.js"),
+  bb: () => import("./cities/bb.js"),
+  bd: () => import("./cities/bd.js"),
+  be: () => import("./cities/be.js"),
+  bf: () => import("./cities/bf.js"),
+  bg: () => import("./cities/bg.js"),
+  bh: () => import("./cities/bh.js"),
+  bi: () => import("./cities/bi.js"),
+  bj: () => import("./cities/bj.js"),
+  bl: () => import("./cities/bl.js"),
+  bm: () => import("./cities/bm.js"),
+  bn: () => import("./cities/bn.js"),
+  bo: () => import("./cities/bo.js"),
+  bq: () => import("./cities/bq.js"),
+  br: () => import("./cities/br.js"),
+  bs: () => import("./cities/bs.js"),
+  bt: () => import("./cities/bt.js"),
+  bw: () => import("./cities/bw.js"),
+  by: () => import("./cities/by.js"),
+  bz: () => import("./cities/bz.js"),
+  ca: () => import("./cities/ca.js"),
+  cc: () => import("./cities/cc.js"),
+  cd: () => import("./cities/cd.js"),
+  cf: () => import("./cities/cf.js"),
+  cg: () => import("./cities/cg.js"),
+  ch: () => import("./cities/ch.js"),
+  ci: () => import("./cities/ci.js"),
+  ck: () => import("./cities/ck.js"),
+  cl: () => import("./cities/cl.js"),
+  cm: () => import("./cities/cm.js"),
+  cn: () => import("./cities/cn.js"),
+  co: () => import("./cities/co.js"),
+  cr: () => import("./cities/cr.js"),
+  cu: () => import("./cities/cu.js"),
+  cv: () => import("./cities/cv.js"),
+  cw: () => import("./cities/cw.js"),
+  cx: () => import("./cities/cx.js"),
+  cy: () => import("./cities/cy.js"),
+  cz: () => import("./cities/cz.js"),
+  de: () => import("./cities/de.js"),
+  dj: () => import("./cities/dj.js"),
+  dk: () => import("./cities/dk.js"),
+  dm: () => import("./cities/dm.js"),
+  do: () => import("./cities/do.js"),
+  dz: () => import("./cities/dz.js"),
+  ec: () => import("./cities/ec.js"),
+  ee: () => import("./cities/ee.js"),
+  eg: () => import("./cities/eg.js"),
+  eh: () => import("./cities/eh.js"),
+  er: () => import("./cities/er.js"),
+  es: () => import("./cities/es.js"),
+  et: () => import("./cities/et.js"),
+  fi: () => import("./cities/fi.js"),
+  fj: () => import("./cities/fj.js"),
+  fk: () => import("./cities/fk.js"),
+  fm: () => import("./cities/fm.js"),
+  fo: () => import("./cities/fo.js"),
+  fr: () => import("./cities/fr.js"),
+  ga: () => import("./cities/ga.js"),
+  gb: () => import("./cities/gb.js"),
+  gd: () => import("./cities/gd.js"),
+  ge: () => import("./cities/ge.js"),
+  gf: () => import("./cities/gf.js"),
+  gg: () => import("./cities/gg.js"),
+  gh: () => import("./cities/gh.js"),
+  gi: () => import("./cities/gi.js"),
+  gl: () => import("./cities/gl.js"),
+  gm: () => import("./cities/gm.js"),
+  gn: () => import("./cities/gn.js"),
+  gp: () => import("./cities/gp.js"),
+  gq: () => import("./cities/gq.js"),
+  gr: () => import("./cities/gr.js"),
+  gs: () => import("./cities/gs.js"),
+  gt: () => import("./cities/gt.js"),
+  gu: () => import("./cities/gu.js"),
+  gw: () => import("./cities/gw.js"),
+  gy: () => import("./cities/gy.js"),
+  hn: () => import("./cities/hn.js"),
+  hr: () => import("./cities/hr.js"),
+  ht: () => import("./cities/ht.js"),
+  hu: () => import("./cities/hu.js"),
+  id: () => import("./cities/id.js"),
+  ie: () => import("./cities/ie.js"),
+  il: () => import("./cities/il.js"),
+  im: () => import("./cities/im.js"),
+  in: () => import("./cities/in.js"),
+  io: () => import("./cities/io.js"),
+  iq: () => import("./cities/iq.js"),
+  ir: () => import("./cities/ir.js"),
+  is: () => import("./cities/is.js"),
+  it: () => import("./cities/it.js"),
+  je: () => import("./cities/je.js"),
+  jm: () => import("./cities/jm.js"),
+  jo: () => import("./cities/jo.js"),
+  jp: () => import("./cities/jp.js"),
+  ke: () => import("./cities/ke.js"),
+  kg: () => import("./cities/kg.js"),
+  kh: () => import("./cities/kh.js"),
+  ki: () => import("./cities/ki.js"),
+  km: () => import("./cities/km.js"),
+  kn: () => import("./cities/kn.js"),
+  kp: () => import("./cities/kp.js"),
+  kr: () => import("./cities/kr.js"),
+  kw: () => import("./cities/kw.js"),
+  ky: () => import("./cities/ky.js"),
+  kz: () => import("./cities/kz.js"),
+  la: () => import("./cities/la.js"),
+  lb: () => import("./cities/lb.js"),
+  lc: () => import("./cities/lc.js"),
+  li: () => import("./cities/li.js"),
+  lk: () => import("./cities/lk.js"),
+  lr: () => import("./cities/lr.js"),
+  ls: () => import("./cities/ls.js"),
+  lt: () => import("./cities/lt.js"),
+  lu: () => import("./cities/lu.js"),
+  lv: () => import("./cities/lv.js"),
+  ly: () => import("./cities/ly.js"),
+  ma: () => import("./cities/ma.js"),
+  mc: () => import("./cities/mc.js"),
+  md: () => import("./cities/md.js"),
+  me: () => import("./cities/me.js"),
+  mf: () => import("./cities/mf.js"),
+  mg: () => import("./cities/mg.js"),
+  mh: () => import("./cities/mh.js"),
+  mk: () => import("./cities/mk.js"),
+  ml: () => import("./cities/ml.js"),
+  mm: () => import("./cities/mm.js"),
+  mn: () => import("./cities/mn.js"),
+  mo: () => import("./cities/mo.js"),
+  mp: () => import("./cities/mp.js"),
+  mq: () => import("./cities/mq.js"),
+  mr: () => import("./cities/mr.js"),
+  ms: () => import("./cities/ms.js"),
+  mt: () => import("./cities/mt.js"),
+  mu: () => import("./cities/mu.js"),
+  mv: () => import("./cities/mv.js"),
+  mw: () => import("./cities/mw.js"),
+  mx: () => import("./cities/mx.js"),
+  my: () => import("./cities/my.js"),
+  mz: () => import("./cities/mz.js"),
+  na: () => import("./cities/na.js"),
+  nc: () => import("./cities/nc.js"),
+  ne: () => import("./cities/ne.js"),
+  nf: () => import("./cities/nf.js"),
+  ng: () => import("./cities/ng.js"),
+  ni: () => import("./cities/ni.js"),
+  nl: () => import("./cities/nl.js"),
+  no: () => import("./cities/no.js"),
+  np: () => import("./cities/np.js"),
+  nr: () => import("./cities/nr.js"),
+  nu: () => import("./cities/nu.js"),
+  nz: () => import("./cities/nz.js"),
+  om: () => import("./cities/om.js"),
+  pa: () => import("./cities/pa.js"),
+  pe: () => import("./cities/pe.js"),
+  pf: () => import("./cities/pf.js"),
+  pg: () => import("./cities/pg.js"),
+  ph: () => import("./cities/ph.js"),
+  pk: () => import("./cities/pk.js"),
+  pl: () => import("./cities/pl.js"),
+  pm: () => import("./cities/pm.js"),
+  pn: () => import("./cities/pn.js"),
+  pr: () => import("./cities/pr.js"),
+  ps: () => import("./cities/ps.js"),
+  pt: () => import("./cities/pt.js"),
+  pw: () => import("./cities/pw.js"),
+  py: () => import("./cities/py.js"),
+  qa: () => import("./cities/qa.js"),
+  re: () => import("./cities/re.js"),
+  ro: () => import("./cities/ro.js"),
+  rs: () => import("./cities/rs.js"),
+  ru: () => import("./cities/ru.js"),
+  rw: () => import("./cities/rw.js"),
+  sa: () => import("./cities/sa.js"),
+  sb: () => import("./cities/sb.js"),
+  sc: () => import("./cities/sc.js"),
+  sd: () => import("./cities/sd.js"),
+  se: () => import("./cities/se.js"),
+  sg: () => import("./cities/sg.js"),
+  sh: () => import("./cities/sh.js"),
+  si: () => import("./cities/si.js"),
+  sk: () => import("./cities/sk.js"),
+  sl: () => import("./cities/sl.js"),
+  sm: () => import("./cities/sm.js"),
+  sn: () => import("./cities/sn.js"),
+  so: () => import("./cities/so.js"),
+  sr: () => import("./cities/sr.js"),
+  ss: () => import("./cities/ss.js"),
+  st: () => import("./cities/st.js"),
+  sv: () => import("./cities/sv.js"),
+  sx: () => import("./cities/sx.js"),
+  sy: () => import("./cities/sy.js"),
+  sz: () => import("./cities/sz.js"),
+  tc: () => import("./cities/tc.js"),
+  td: () => import("./cities/td.js"),
+  tf: () => import("./cities/tf.js"),
+  tg: () => import("./cities/tg.js"),
+  th: () => import("./cities/th.js"),
+  tj: () => import("./cities/tj.js"),
+  tl: () => import("./cities/tl.js"),
+  tm: () => import("./cities/tm.js"),
+  tn: () => import("./cities/tn.js"),
+  to: () => import("./cities/to.js"),
+  tr: () => import("./cities/tr.js"),
+  tt: () => import("./cities/tt.js"),
+  tv: () => import("./cities/tv.js"),
+  tw: () => import("./cities/tw.js"),
+  tz: () => import("./cities/tz.js"),
+  ua: () => import("./cities/ua.js"),
+  ug: () => import("./cities/ug.js"),
+  us: () => import("./cities/us.js"),
+  uy: () => import("./cities/uy.js"),
+  uz: () => import("./cities/uz.js"),
+  va: () => import("./cities/va.js"),
+  vc: () => import("./cities/vc.js"),
+  ve: () => import("./cities/ve.js"),
+  vg: () => import("./cities/vg.js"),
+  vi: () => import("./cities/vi.js"),
+  vn: () => import("./cities/vn.js"),
+  vu: () => import("./cities/vu.js"),
+  wf: () => import("./cities/wf.js"),
+  ws: () => import("./cities/ws.js"),
+  xk: () => import("./cities/xk.js"),
+  ye: () => import("./cities/ye.js"),
+  yt: () => import("./cities/yt.js"),
+  za: () => import("./cities/za.js"),
+  zm: () => import("./cities/zm.js"),
+  zw: () => import("./cities/zw.js")
+};
+
+// src/cities.ts
+var CITY_TIERS = Object.freeze(["capitals", "1m", "100k", "15k"]);
+var EARTH_KM = 6371.0088;
+var RADIANS = Math.PI / 180;
+var EMPTY = Object.freeze([]);
+var EMPTY_AT = Object.freeze([]);
+var normalId = (id) => typeof id === "string" ? id.trim().replace(/^NE:/i, "ne:").replace(/^q/, "Q") : null;
+var unit = (lat, lon) => {
+  const cosine = Math.cos(lat * RADIANS);
+  return [cosine * Math.cos(lon * RADIANS), cosine * Math.sin(lon * RADIANS), Math.sin(lat * RADIANS)];
+};
+var kmAt = (here, vectors, offset) => {
+  const x = vectors[offset];
+  const y = vectors[offset + 1];
+  const z = vectors[offset + 2];
+  const cross = Math.hypot(here[1] * z - here[2] * y, here[2] * x - here[0] * z, here[0] * y - here[1] * x);
+  return EARTH_KM * Math.atan2(cross, here[0] * x + here[1] * y + here[2] * z);
+};
+var isPoint = (point) => typeof point === "object" && point !== null && Number.isFinite(point.lat) && Number.isFinite(point.lon) && Math.abs(point.lat) <= 90;
+var citySet = (...lists) => {
+  const seen = /* @__PURE__ */ new Set();
+  const cities = [];
+  for (const list of lists) {
+    for (const city of list) {
+      if (seen.has(city.id)) continue;
+      seen.add(city.id);
+      cities.push(city);
+    }
+  }
+  const ids = /* @__PURE__ */ new Map();
+  const countries = /* @__PURE__ */ new Map();
+  const subdivisions = /* @__PURE__ */ new Map();
+  const add = (groups, key, city) => {
+    if (key === null) return;
+    const list = groups.get(key);
+    if (list === void 0) groups.set(key, [city]);
+    else list.push(city);
+  };
+  for (const city of cities) {
+    ids.set(city.id, city);
+    add(countries, city.country, city);
+    add(subdivisions, city.subdivision, city);
+  }
+  const vectors = new Float64Array(cities.length * 3);
+  cities.forEach((city, at) => vectors.set(unit(city.lat, city.lon), at * 3));
+  const allowed = (city, country, minPopulation) => (country === null || city.country === country) && (minPopulation <= 0 || (city.population ?? 0) >= minPopulation);
+  const countryOf = (options) => typeof options?.country === "string" ? options.country.trim().toUpperCase() : null;
+  const populationOf = (options) => Number.isFinite(options?.minPopulation) ? options.minPopulation : 0;
+  const nearest = (point, options) => {
+    if (!isPoint(point)) return null;
+    const here = unit(point.lat, point.lon);
+    const country = countryOf(options);
+    const minPopulation = populationOf(options);
+    const maxKm = Number.isFinite(options?.maxKm) ? options.maxKm : Infinity;
+    let best = -Infinity;
+    let at = -1;
+    for (let index = 0; index < cities.length; index += 1) {
+      const offset = index * 3;
+      const dot = here[0] * vectors[offset] + here[1] * vectors[offset + 1] + here[2] * vectors[offset + 2];
+      if (dot > best && allowed(cities[index], country, minPopulation)) {
+        best = dot;
+        at = index;
+      }
+    }
+    if (at < 0) return null;
+    const km = kmAt(here, vectors, at * 3);
+    return km > maxKm ? null : { city: cities[at], km };
+  };
+  const within = (point, km, options) => {
+    if (!isPoint(point) || !(km >= 0)) return EMPTY_AT;
+    const here = unit(point.lat, point.lon);
+    const country = countryOf(options);
+    const minPopulation = populationOf(options);
+    const limit = Math.min(km, Number.isFinite(options?.maxKm) ? options.maxKm : Infinity);
+    const least = Math.cos(Math.min(limit / EARTH_KM, Math.PI));
+    const found = [];
+    for (let index = 0; index < cities.length; index += 1) {
+      const offset = index * 3;
+      const dot = here[0] * vectors[offset] + here[1] * vectors[offset + 1] + here[2] * vectors[offset + 2];
+      if (dot < least - 1e-12 || !allowed(cities[index], country, minPopulation)) continue;
+      const away = kmAt(here, vectors, offset);
+      if (away <= limit) found.push({ city: cities[index], km: away });
+    }
+    found.sort((a, b) => a.km - b.km);
+    return Object.freeze(found);
+  };
+  return Object.freeze({
+    cities: Object.freeze(cities),
+    byId: (id) => {
+      const key = normalId(id);
+      return key === null ? null : ids.get(CITY_ALIASES[key] ?? key) ?? null;
+    },
+    inCountry: (code) => typeof code === "string" ? countries.get(code.trim().toUpperCase()) ?? EMPTY : EMPTY,
+    inSubdivision: (code) => typeof code === "string" ? subdivisions.get(code.trim().toUpperCase()) ?? EMPTY : EMPTY,
+    nearest,
+    within
+  });
+};
+var fromCountries = async (least, below) => {
+  const lists = await Promise.all(Object.values(CITY_LOADERS).map(async (load) => (await load()).CITIES));
+  return Object.freeze(lists.flatMap((list) => list.filter((city) => (city.population ?? 0) >= least && (city.population ?? 0) < below)).sort((a, b) => (b.population ?? 0) - (a.population ?? 0) || (a.id < b.id ? -1 : 1)));
+};
+var TIER_LOADERS = {
+  capitals: async () => (await import("./cities/capitals.js")).capitalCities(),
+  "1m": async () => (await import("./cities/1m.js")).cities1m(),
+  "100k": async () => (await import("./cities/100k.js")).cities100k(),
+  "15k": () => fromCountries(15e3, 1e5)
+};
+var loadCities = async (...tiers) => {
+  for (const tier of tiers) if (!CITY_TIERS.includes(tier)) throw new RangeError(`"${String(tier)}" is not a tier of cities: ${CITY_TIERS.join(", ")}`);
+  const lists = await Promise.all([...new Set(tiers)].map(async (tier) => await TIER_LOADERS[tier]()));
+  return citySet(...lists);
+};
+var citiesOf = async (countryCode) => {
+  const code = typeof countryCode === "string" ? countryCode.trim().toUpperCase() : "";
+  if (!isCountryCode(code)) return null;
+  const loader = CITY_LOADERS[code.toLowerCase()];
+  if (loader === void 0) return EMPTY;
+  return (await loader()).CITIES;
+};
+var cityById = async (id) => {
+  if (typeof id !== "string") return null;
+  const key = normalId(id);
+  const wanted = CITY_ALIASES[key] ?? key;
+  for (const tier of CITY_TIERS) {
+    const found = (await TIER_LOADERS[tier]()).find((city) => city.id === wanted);
+    if (found !== void 0) return found;
+  }
+  return null;
+};
+export {
+  CITY_TIERS,
+  citiesOf,
+  cityById,
+  citySet,
+  loadCities
+};