Release God's Eye View as open source

src/data/local_data/natural_earth/README.md

@@ -0,0 +1,36 @@
+# Natural Earth physical regions pack
+
+Offline named-region polygons for the voice-annotation resolver
+(`src/data/naturalEarthRegions.js`) — "outline the Alps" resolves to the real
+range geometry with no network dependency.
+
+| File | Source dataset | Features |
+|------|----------------|----------|
+| `regions.json` | `ne_10m_geography_regions_polys` (ranges, deserts, plateaus, peninsulas, islands, …) | 1,046 named |
+| `marine.json` | `ne_10m_geography_marine_polys` (seas, gulfs, straits, bays, …) | 292 named |
+
+**Source:** Natural Earth 10m physical vectors, via the canonical
+[nvkelso/natural-earth-vector](https://github.com/nvkelso/natural-earth-vector)
+GitHub repo, commit `ca96624a56bd078437bca8184e78163e5039ad19` (fetched
+2026-07-28T01:36:39Z — exact provenance is in each file's `meta` header).
+
+**License:** public domain (https://www.naturalearthdata.com/about/terms-of-use/).
+No attribution legally required; we credit "Made with Natural Earth" anyway.
+See DATA_SOURCES.md.
+
+**Curation** (script not committed — parameters recorded in `meta.curation`):
+
+- Named features only; the `Dragons-be-here` joke feature ("Null Island") dropped.
+- Outer rings only (holes are irrelevant at country-scale outline zoom).
+- Douglas-Peucker simplification at 0.01°, coordinates rounded to 3 decimals
+  (~110 m), rings stored open (no closing duplicate vertex).
+- MultiPolygon crumbs under 20 km² dropped (largest part always kept);
+  rings that survive with fewer than 8 distinct vertices are midpoint-densified
+  (shape-identical) so every ring has ≥8 vertices.
+- Zero-area sliver artifacts dropped. Two marine features are ONLY slivers in
+  the source and are therefore absent: **Drake Passage** and **Luzon Strait**.
+- Result: 7.3 MB source → 2.5 MB pack (budget ≤3 MB, enforced by
+  `src/data/naturalEarthRegions.test.mjs`).
+
+Duplicate names exist upstream (two "Cordillera Oriental", a sliver + real
+"Canadian Shield", …); the lookup module resolves ties by largest area.

src/data/local_data/natural_earth/marine.json

@@ -0,0 +1 @@
+{"meta":{"source":"Natural Earth 10m physical vectors — ne_10m_geography_marine_polys","url":"https://raw.githubusercontent.com/nvkelso/natural-earth-vector/ca96624a56bd078437bca8184e78163e5039ad19/geojson/ne_10m_geography_marine_polys.geojson","commit":"ca96624a56bd078437bca8184e78163e5039ad19","license":"Public domain (Natural Earth — naturalearthdata.com)","fetched":"2026-07-28T01:36:39Z","curation":{"toleranceDeg":0.01,"coordDecimals":3,"minPartKm2":20,"outerRingsOnly":true},"featureCount":292},"features":[{"name":"Arctic Ocean","featurecla":"ocean","polygons":[[[179.528,71.44],[156.042,77.47],[138.844,76.253],[96.197,81.267],[96.187,81.184],[95.984,81.211],[95.902,81.26],[95.8,81.281],[95.16,81.281],[91.39,81.187],[90.07,81.214],[89.901,81.171],[89.919,81.149],[89.87,81.148],[65.361,81.068],[65.136,81.15],[64.92,81.28],[63.809,81.598],[63.676,81.617],[63.782,81.65],[63.71,81.688],[63.049,81.71],[62.38,81.809],[59.364,81.862],[59.358,81.836],[59.262,81.854],[58.134,81.828],[58.001,81.8],[57.988,81.862],[55.818,81.862],[50.383,81.428],[49.826,80.895],[49.508,80.865],[49.244,80.821],[49.148,80.712],[49.193,80.656],[49.185,80.559],[49.088,80.516],[48.625,80.509],[48.403,80.569],[48.408,80.644],[48.683,80.633],[48.687,80.718],[48.446,80.806],[48.243,80.823],[47.9,80.813],[47.353,80.853],[47.021,80.814],[46.799,80.755],[45.124,80.652],[44.974,80.624],[44.97,80.645],[27.036,80.116],[26.861,80.16],[25.836,80.175],[25.667,80.21],[24.907,80.277],[24.786,80.301],[24.614,80.286],[24.547,80.295],[24.403,80.355],[24.297,80.36],[24.28,80.329],[24.234,80.303],[23.953,80.305],[23.688,80.206],[23.353,80.179],[23.115,80.187],[23.225,80.317],[23.25,80.381],[23.315,80.425],[23.251,80.447],[23.008,80.474],[22.897,80.469],[22.672,80.413],[22.451,80.402],[22.418,80.366],[22.446,80.308],[22.443,80.191],[22.376,80.089],[22.29,80.049],[22.19,80.06],[21.898,80.132],[21.696,80.159],[21.655,80.219],[21.549,80.243],[20.999,80.239],[20.898,80.25],[20.359,80.401],[19.851,80.471],[19.733,80.478],[19.614,80.462],[19.811,80.327],[19.751,80.227],[19.568,80.25],[19.264,80.336],[19.178,80.332],[19.157,80.302],[19.191,80.263],[19.355,80.185],[19.537,80.163],[19.343,80.116],[18.779,80.194],[18.09,80.171],[17.958,80.15],[-25.89,83.279],[-27.034,83.377],[-28.484,83.435],[-28.992,83.505],[-29.953,83.565],[-30.703,83.594],[-32.984,83.599],[-33.398,83.577],[-33.837,83.53],[-34.132,83.528],[-34.668,83.571],[-35.452,83.539],[-36.607,83.537],[-36.645,83.529],[-36.69,83.48],[-36.804,83.466],[-37.723,83.498],[-37.828,83.486],[-38.071,83.412],[-38.188,83.403],[-38.541,83.415],[-38.75,83.371],[-38.761,83.485],[-69.859,83.132],[-69.864,83.108],[-70.871,83.098],[-71.085,83.083],[-71.424,83.021],[-71.402,83.001],[-71.198,82.97],[-70.933,82.911],[-70.94,82.902],[-71.132,82.923],[-71.983,83.101],[-72.069,83.106],[-72.812,83.081],[-73.331,82.999],[-73.404,82.977],[-73.441,82.946],[-73.442,82.905],[-73.234,82.844],[-72.659,82.722],[-73.272,82.772],[-73.703,82.852],[-74.198,82.989],[-74.414,83.013],[-75.745,83.047],[-77.125,83.008],[-76.908,82.919],[-76.41,82.816],[-76.087,82.724],[-75.643,82.644],[-75.565,82.609],[-76.009,82.535],[-76.146,82.55],[-76.244,82.604],[-76.421,82.671],[-77.479,82.883],[-77.969,82.906],[-78.525,82.891],[-79.181,82.933],[-79.887,82.938],[-80.155,82.911],[-80.141,82.894],[-79.834,82.817],[-79.642,82.785],[-78.749,82.679],[-79.035,82.674],[-80.076,82.706],[-80.657,82.769],[-81.01,82.779],[-81.178,82.745],[-81.147,82.716],[-80.809,82.587],[-80.862,82.572],[-81.189,82.594],[-81.58,82.643],[-81.785,82.649],[-82.117,82.629],[-82.122,82.602],[-81.681,82.519],[-82.269,82.465],[-82.451,82.427],[-82.448,82.395],[-81.997,82.278],[-81.468,82.192],[-80.13,82.028],[-79.629,81.933],[-79.425,81.854],[-79.685,81.886],[-80.153,81.978],[-80.55,82.004],[-81.585,82.12],[-82.537,82.247],[-82.709,82.229],[-82.747,82.197],[-82.657,82.158],[-82.328,82.092],[-82.356,82.066],[-82.633,82.077],[-83.01,82.142],[-83.591,82.326],[-83.824,82.351],[-84.368,82.374],[-84.897,82.449],[-85.276,82.405],[-85.795,82.292],[-86.615,82.219],[-86.581,82.187],[-85.311,82.044],[-85.169,82.024],[-85.045,81.983],[-85.403,81.982],[-85.538,81.955],[-85.645,81.953],[-86.158,82.026],[-86.627,82.051],[-86.834,82.034],[-86.999,81.992],[-87.018,81.959],[-87.404,82.054],[-87.639,82.085],[-88.063,82.097],[-88.567,82.061],[-88.875,82.018],[-89.381,81.917],[-89.633,81.894],[-90.49,81.877],[-90.942,81.827],[-91.424,81.744],[-91.648,81.684],[-91.684,81.636],[-91.403,81.578],[-91.292,81.571],[-90.834,81.64],[-90.627,81.656],[-90.331,81.631],[-89.822,81.635],[-89.845,81.612],[-90.554,81.464],[-90.609,81.43],[-90.304,81.401],[-88.978,81.541],[-88.479,81.565],[-88.101,81.558],[-87.597,81.526],[-87.617,81.509],[-88.127,81.519],[-88.622,81.501],[-88.892,81.474],[-89.427,81.387],[-89.674,81.329],[-89.636,81.302],[-89.209,81.25],[-89.563,81.227],[-89.947,81.173],[-89.981,81.124],[-89.792,81.065],[-89.623,81.032],[-89.398,81.026],[-88.887,81.058],[-87.275,81.081],[-86.623,81.123],[-85.875,81.241],[-8Line truncated

src/data/local_data/natural_earth/regions.json

@@ -0,0 +1 @@
+{"meta":{"source":"Natural Earth 10m physical vectors — ne_10m_geography_regions_polys","url":"https://raw.githubusercontent.com/nvkelso/natural-earth-vector/ca96624a56bd078437bca8184e78163e5039ad19/geojson/ne_10m_geography_regions_polys.geojson","commit":"ca96624a56bd078437bca8184e78163e5039ad19","license":"Public domain (Natural Earth — naturalearthdata.com)","fetched":"2026-07-28T01:36:39Z","curation":{"toleranceDeg":0.01,"coordDecimals":3,"minPartKm2":20,"outerRingsOnly":true},"featureCount":1046},"features":[{"name":"Pentecost","featurecla":"Island","polygons":[[[168.184,-15.93],[168.123,-15.681],[168.16,-15.462],[168.185,-15.513],[168.199,-15.627],[168.268,-15.892],[168.256,-15.955],[168.196,-15.972]]]},{"name":"Anatom","featurecla":"Island","polygons":[[[169.808,-20.238],[169.796,-20.235],[169.738,-20.202],[169.751,-20.153],[169.829,-20.145],[169.851,-20.148],[169.857,-20.152],[169.896,-20.187],[169.861,-20.242],[169.816,-20.241]]]},{"name":"Gaua","featurecla":"Island","polygons":[[[167.582,-14.264],[167.543,-14.312],[167.43,-14.295],[167.404,-14.282],[167.411,-14.197],[167.439,-14.168],[167.506,-14.142],[167.599,-14.184]]]},{"name":"Vanikolo","featurecla":"Island","polygons":[[[166.929,-11.665],[166.841,-11.681],[166.829,-11.68],[166.818,-11.679],[166.806,-11.677],[166.748,-11.591],[166.748,-11.59],[166.791,-11.571],[166.867,-11.609],[166.866,-11.618],[166.873,-11.639],[166.891,-11.64]]]},{"name":"Adak","featurecla":"Island","polygons":[[[-176.502,51.751],[-176.59,51.7],[-176.771,51.63],[-176.826,51.668],[-176.827,51.721],[-176.887,51.647],[-176.962,51.604],[-176.874,51.79],[-176.779,51.805],[-176.736,51.84],[-176.745,51.895],[-176.715,51.954],[-176.585,51.972],[-176.55,51.944],[-176.556,51.914],[-176.582,51.91],[-176.597,51.839],[-176.437,51.82],[-176.437,51.754],[-176.452,51.736]]]},{"name":"Unimak I.","featurecla":"Island","polygons":[[[-163.373,54.794],[-163.302,54.76],[-163.187,54.748],[-163.135,54.723],[-163.083,54.669],[-163.358,54.736],[-163.531,54.638],[-163.583,54.626],[-163.879,54.631],[-164.114,54.617],[-164.299,54.548],[-164.356,54.477],[-164.404,54.448],[-164.573,54.415],[-164.781,54.413],[-164.866,54.461],[-164.904,54.545],[-164.888,54.608],[-164.739,54.654],[-164.53,54.881],[-164.479,54.907],[-164.236,54.892],[-164.202,54.931],[-164.145,54.955],[-163.807,55.049],[-163.607,55.051],[-163.54,55.031],[-163.469,54.969]]]},{"name":"Lanzarote","featurecla":"Island","polygons":[[[-13.463,29.133],[-13.478,29.006],[-13.554,28.96],[-13.709,28.916],[-13.784,28.845],[-13.86,28.869],[-13.824,29.013],[-13.788,29.056],[-13.65,29.119],[-13.537,29.139],[-13.501,29.211],[-13.464,29.237],[-13.424,29.198]]]},{"name":"Pemba I.","featurecla":"Island","polygons":[[[39.711,-4.94],[39.757,-4.941],[39.814,-4.978],[39.821,-5.003],[39.823,-4.966],[39.835,-4.954],[39.841,-4.975],[39.859,-4.909],[39.869,-4.937],[39.856,-5.023],[39.835,-5.035],[39.827,-5.111],[39.838,-5.146],[39.848,-5.118],[39.858,-5.123],[39.852,-5.258],[39.796,-5.394],[39.781,-5.41],[39.78,-5.392],[39.749,-5.444],[39.673,-5.407],[39.648,-5.37],[39.651,-5.347],[39.698,-5.351],[39.663,-5.296],[39.725,-5.289],[39.69,-5.269],[39.763,-5.271],[39.78,-5.248],[39.76,-5.256],[39.677,-5.226],[39.683,-5.207],[39.745,-5.214],[39.742,-5.171],[39.717,-5.179],[39.725,-5.153],[39.695,-5.144],[39.7,-5.088],[39.725,-5.089],[39.693,-5.06],[39.684,-4.995],[39.711,-5.002],[39.715,-4.986],[39.676,-4.942],[39.679,-4.928]]]},{"name":"Mahé I.","featurecla":"Island","polygons":[[[55.478,-4.611],[55.539,-4.691],[55.543,-4.785],[55.495,-4.755],[55.49,-4.692],[55.417,-4.65],[55.388,-4.615],[55.456,-4.559]]]},{"name":"Mohéli","featurecla":"Island","polygons":[[[43.662,-12.327],[43.659,-12.317],[43.65,-12.309],[43.643,-12.306],[43.633,-12.288],[43.631,-12.247],[43.703,-12.256],[43.704,-12.256],[43.789,-12.307],[43.859,-12.368],[43.664,-12.343]]]},{"name":"Mayotte","featurecla":"Island","polygons":[[[45.084,-12.667],[45.139,-12.714],[45.223,-12.752],[45.188,-12.816],[45.209,-12.848],[45.168,-12.943],[45.18,-12.977],[45.12,-12.985],[45.086,-12.953],[45.09,-12.923],[45.072,-12.888],[45.125,-12.92],[45.136,-12.903],[45.087,-12.84],[45.104,-12.832],[45.087,-12.758],[45.043,-12.701],[45.092,-12.653]]]},{"name":"Anjouan","featurecla":"Island","polygons":[[[44.527,-12.22],[44.526,-12.324],[44.505,-12.357],[44.385,-12.251],[44.22,-12.171],[44.323,-12.187],[44.343,-12.173],[44.373,-12.179],[44.4,-12.155],[44.413,-12.093],[44.452,-12.071],[44.476,-12.082]]]},{"name":"Mafia I.","featurecla":"Island","polygons":[[[39.755,-7.919],[39.711,-7.977],[39.657,-7.991],[39.611,-7.947],[39.74,-7.814],[39.815,-7.793],[39.776,-7.786],[39.845,-7.742],[39.905,-7.651],[39.898,-7.728],[39.824,-7.901]]]},{"name":"Flores","featurecla":"Island","polygons":[[[-31.173,39.497],[-31.139,39.479],[-31.137,39.408],[-31.181,39.359],[-31.283,39.394],[-31.261,39.497],[-31.203,39.52],[-31.208,39.51]]]},{"name":"Pico","featurecla":"Island","polygons":[[[-28.163,38.408],[-28.232,38.385],[-28.297,38.412],[-28.455,Line truncated