River Runner Versions Save

• Incorporates Mapbox's new globe projection and cleans up some associates issues from the change
• Some general styling/UI cleanup

Updating version in package.json and fixing a dependency that causes deploy build issues

• Updated mapbox style to new custom style that incorporates city labels and 3D buildings (at high zoom)
• Automatically incorporates topo layer without having to load it in coade

Fixed an issue with path lengths displaying as 0km on very short (one flowline) paths. It was due to an off-by-one error from my own misinterpretation of one of the flowline properties, which gave the length remaining in the path from the end of a flowline, rather than the beginning. This meant that for some short (~5km), single flowline paths, the total length was being interpreted as 0km instead of 5km. In other cases, the total length was off by the length of the first flowline.

This release also adds several river/stopping feature names.

• Have incorporated a number of suggested feature names
• Corrected some stopping feature names/added a little to the dataset
• Incorporated some UI fixes (allowing escape key to abort autoplay/exit run, some layout fixes for shorter windows, etc)

• Fixed some typos and some feature names
• Added full source URL to name suggestions to make it easier to vet
• Merged global branch into main

Changes

This incorporates the new MERIT River Runner API for generating global flowpaths (more information here).

Additionally, addresses a whole host of issues associated with expanding globally, given that there were a lot of assumptions made in building the US-only version that do not hold here. A partial list is documented here:

Some features of notes besides geographic expansion:

• Fixes the clipped beginnings/ends of paths that came about as a result of path smoothing
• Expands stopping feature list significantly, particularly for ocean features, and incorporates inland lakes into navigation path
• Adds a modal for suggesting names when missing (name data coverage is lacking significantly on non-US paths, relatively)
• Fixes disjointedness from flight to path start by accurately gathering terrain-exaggeration-adjusted elevation data prior to run start

Issues of Concern

Note: due to some lingering issues, this version is considered in beta and will not yet be merged into main. It will also exist on a separate URL, here: https://river-runner-global.samlearner.com/, while the original US-only version persists on the original URL, here: https://river-runner.samlearner.com/. Some of these issues will be addressed in the front-end in this repo, others are issues being addressed in the underlying data/API. A few of these issues are notably worse in the global app than in the US-only app, for US flowpaths, which is part of the rationale of maintaining both, for the time being.

A partial list of issues being addressed:

• Incomplete feature name coverage, particularly outside of the United States
• Issues with over-grouping on feature names for paths that run through large inland lakes (many of these are documented here: https://github.com/ksonda/global-river-runner/issues/25)
• Paths may not reflect true river paths when affected by engineered features such as dams, canals, and conduits (the Chicago Sanitary and Ship Canal is a notable example of this)
• The current Mercator projection is not ideal for the global view. Currently, it's the only available Mapbox GL projection suitable for this application, but that is due to change soon with a release of a 3D globe view. When this feature is ready from Mapbox, it will be incorporated into the app.

Full Changelog: https://github.com/sdl60660/river-runner/compare/v1.6.2...v2.0.0