@trailstash/ultra 3.0.0-dev

package/MapLibre-Examples/geojson-line.ultra

@@ -0,0 +1,114 @@
+---
+title: Add a GeoJSON line
+description: Add a GeoJSON line to a map using addSource, then style it using addLayer’s paint properties.
+type: geojson
+options:
+  zoom: 15
+  center: [ -122.486052, 37.83034 ]
+style:
+  extends: https://styles.trailsta.sh/osm-liberty.json
+  layers:
+    - type: line
+      line-color: '#888'
+      line-width: 8
+      line-cap: round
+      line-join: round
+---
+{
+  "type": "FeatureCollection",
+  "features": [
+    {
+      "type": "Feature",
+      "properties": {},
+      "geometry": {
+        "type": "LineString",
+        "coordinates": [
+          [
+            -122.48369693756104,
+            37.83381888486939
+          ],
+          [
+            -122.48348236083984,
+            37.83317489144141
+          ],
+          [
+            -122.48339653015138,
+            37.83270036637107
+          ],
+          [
+            -122.48356819152832,
+            37.832056363179625
+          ],
+          [
+            -122.48404026031496,
+            37.83114119107971
+          ],
+          [
+            -122.48404026031496,
+            37.83049717427869
+          ],
+          [
+            -122.48348236083984,
+            37.829920943955045
+          ],
+          [
+            -122.48356819152832,
+            37.82954808664175
+          ],
+          [
+            -122.48507022857666,
+            37.82944639795659
+          ],
+          [
+            -122.48610019683838,
+            37.82880236636284
+          ],
+          [
+            -122.48695850372314,
+            37.82931081282506
+          ],
+          [
+            -122.48700141906738,
+            37.83080223556934
+          ],
+          [
+            -122.48751640319824,
+            37.83168351665737
+          ],
+          [
+            -122.48803138732912,
+            37.832158048267786
+          ],
+          [
+            -122.48888969421387,
+            37.83297152392784
+          ],
+          [
+            -122.48987674713133,
+            37.83263257682617
+          ],
+          [
+            -122.49043464660643,
+            37.832937629287755
+          ],
+          [
+            -122.49125003814696,
+            37.832429207817725
+          ],
+          [
+            -122.49163627624512,
+            37.832564787218985
+          ],
+          [
+            -122.49223709106445,
+            37.83337825839438
+          ],
+          [
+            -122.49378204345702,
+            37.83368330777276
+          ]
+        ]
+      }
+    }
+  ]
+}

package/MapLibre-Examples/geojson-markers.ultra

@@ -0,0 +1,217 @@
+---
+title: Draw GeoJSON points
+description: Draw points from a GeoJSON collection to a map.
+type: geojson
+options:
+  zoom: 1
+  center: [ 0, 0 ]
+style:
+  extends: https://styles.trailsta.sh/positron.json
+  layers:
+    - type: symbol
+      icon-image: https://maplibre.org/maplibre-gl-js/docs/assets/osgeo-logo.png
+      text-field: [get, year]
+      text-offset: [0, 1.25]
+      text-font: [Open Sans Semibold]
+      text-anchor: top
+---
+{
+  "type": "FeatureCollection",
+  "features": [
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          100.4933,
+          13.7551
+        ]
+      },
+      "properties": {
+        "year": "2004"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          6.6523,
+          46.5535
+        ]
+      },
+      "properties": {
+        "year": "2006"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          -123.3596,
+          48.4268
+        ]
+      },
+      "properties": {
+        "year": "2007"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          18.4264,
+          -33.9224
+        ]
+      },
+      "properties": {
+        "year": "2008"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          151.195,
+          -33.8552
+        ]
+      },
+      "properties": {
+        "year": "2009"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          2.1404,
+          41.3925
+        ]
+      },
+      "properties": {
+        "year": "2010"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          -104.8548,
+          39.7644
+        ]
+      },
+      "properties": {
+        "year": "2011"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          -1.1665,
+          52.9539
+        ]
+      },
+      "properties": {
+        "year": "2013"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          -122.6544,
+          45.5428
+        ]
+      },
+      "properties": {
+        "year": "2014"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          126.974,
+          37.5651
+        ]
+      },
+      "properties": {
+        "year": "2015"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          7.1112,
+          50.7255
+        ]
+      },
+      "properties": {
+        "year": "2016"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          -71.0314,
+          42.3539
+        ]
+      },
+      "properties": {
+        "year": "2017"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          39.2794,
+          -6.8173
+        ]
+      },
+      "properties": {
+        "year": "2018"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          26.0961,
+          44.4379
+        ]
+      },
+      "properties": {
+        "year": "2019"
+      }
+    },
+    {
+      "type": "Feature",
+      "geometry": {
+        "type": "Point",
+        "coordinates": [
+          -114.0879,
+          51.0279
+        ]
+      },
+      "properties": {
+        "year": "2020"
+      }
+    }
+  ]
+}

package/MapLibre-Examples/geojson-polygon.ultra

@@ -0,0 +1,104 @@
+---
+title: Add a GeoJSON polygon
+description: Style a polygon with the fill layer type.
+type: geojson
+options:
+  zoom: 5
+  center: [ -68.13734351262877, 45.137451890638886 ]
+style:
+  extends: https://styles.trailsta.sh/osm-liberty.json
+  layers:
+    - type: fill
+      fill-color: '#088'
+      fill-opacity: 0.8
+---
+{
+  "type": "Feature",
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [
+      [
+        [
+          -67.13734351262877,
+          45.137451890638886
+        ],
+        [
+          -66.96466,
+          44.8097
+        ],
+        [
+          -68.03252,
+          44.3252
+        ],
+        [
+          -69.06,
+          43.98
+        ],
+        [
+          -70.11617,
+          43.68405
+        ],
+        [
+          -70.64573401557249,
+          43.090083319667144
+        ],
+        [
+          -70.75102474636725,
+          43.08003225358635
+        ],
+        [
+          -70.79761105007827,
+          43.21973948828747
+        ],
+        [
+          -70.98176001655037,
+          43.36789581966826
+        ],
+        [
+          -70.94416541205806,
+          43.46633942318431
+        ],
+        [
+          -71.08482,
+          45.3052400000002
+        ],
+        [
+          -70.6600225491012,
+          45.46022288673396
+        ],
+        [
+          -70.30495378282376,
+          45.914794623389355
+        ],
+        [
+          -70.00014034695016,
+          46.69317088478567
+        ],
+        [
+          -69.23708614772835,
+          47.44777598732787
+        ],
+        [
+          -68.90478084987546,
+          47.184794623394396
+        ],
+        [
+          -68.23430497910454,
+          47.35462921812177
+        ],
+        [
+          -67.79035274928509,
+          47.066248887716995
+        ],
+        [
+          -67.79141211614706,
+          45.702585354182816
+        ],
+        [
+          -67.13734351262877,
+          45.137451890638886
+        ]
+      ]
+    ]
+  }
+}

package/MapLibre-Examples/heatmap-layer.ultra

@@ -0,0 +1,111 @@
+---
+title: Create a heatmap layer
+description: Visualize earthquake frequency by location using a heatmap layer.
+type: geojson
+options:
+  zoom: 2
+  center: [ -120, 50 ]
+style:
+  extends: https://styles.trailsta.sh/maptiler-basic.json
+  layers:
+    - type: heatmap
+      beforeLayerId: waterway
+      maxzoom: 9
+      # Increase the heatmap weight based on frequency and property magnitude
+      heatmap-weight:
+        - interpolate
+        - [ linear ]
+        - [ get, mag ]
+        - 0
+        - 0
+        - 6
+        - 1
+      # Increase the heatmap color weight weight by zoom level
+      # heatmap-intensity is a multiplier on top of heatmap-weight
+      heatmap-intensity:
+        - interpolate
+        - [ linear ]
+        - [ zoom ]
+        - 0
+        - 1
+        - 9
+        - 3
+      # Color ramp for heatmap.  Domain is 0 (low) to 1 (high).
+      # Begin color ramp at 0-stop with a 0-transparency color
+      # to create a blur-like effect.
+      heatmap-color:
+        - interpolate
+        - [ linear ]
+        - [ heatmap-density ]
+        - 0
+        - rgba(33,102,172,0)
+        - 0.2
+        - rgb(103,169,207)
+        - 0.4
+        - rgb(209,229,240)
+        - 0.6
+        - rgb(253,219,199)
+        - 0.8
+        - rgb(239,138,98)
+        - 1
+        - rgb(178,24,43)
+      # Adjust the heatmap radius by zoom level
+      heatmap-radius:
+        - interpolate
+        - [ linear ]
+        - [ zoom ]
+        - 0
+        - 2
+        - 9
+        - 20
+      # Transition from heatmap to circle layer by zoom level
+      heatmap-opacity:
+        - interpolate
+        - [ linear ]
+        - [ zoom ]
+        - 7
+        - 1
+        - 9
+        - 0
+    - type: circle
+      beforeLayerId: waterway
+      minzoom: 7
+      # Size circle radius by earthquake magnitude and zoom level
+      circle-radius:
+        - interpolate
+        - [linear]
+        - [zoom]
+        - 7
+        - [interpolate, [linear], [get, mag], 1, 1, 6, 4]
+        - 16
+        - [interpolate, [linear], [get, mag], 1, 5, 6, 50]
+      # Color circle by earthquake magnitude
+      circle-color:
+        - interpolate
+        - [linear]
+        - [get, mag]
+        - 1
+        - rgba(33,102,172,0)
+        - 2
+        - rgb(103,169,207)
+        - 3
+        - rgb(209,229,240)
+        - 4
+        - rgb(253,219,199)
+        - 5
+        - rgb(239,138,98)
+        - 6
+        - rgb(178,24,43)
+      circle-stroke-color: white
+      circle-stroke-width: 1
+      # Transition from heatmap to circle layer by zoom level
+      circle-opacity:
+        - interpolate
+        - [linear]
+        - [zoom]
+        - 7
+        - 0
+        - 8
+        - 1
+---
+https://maplibre.org/maplibre-gl-js/docs/assets/earthquakes.geojson

package/MapLibre-Examples/index.md

@@ -0,0 +1,4 @@
+# Overview
+
+These examples aim to replicate as much of the [MapLibre GL JS
+Examples](https://maplibre.org/maplibre-gl-js/docs/examples/) as possible.

package/MapLibre-Examples/locate-user.ultra

@@ -0,0 +1,14 @@
+---
+title: Locate the user
+description: Geolocate the user and then track their current location on the map using the GeolocateControl.
+options:
+  zoom: 3
+  center: [ -96, 37.8 ]
+style: https://styles.trailsta.sh/osm-liberty.json
+controls:
+  - type: GeolocateControl
+    options:
+      positionOptions:
+        enableHighAccuracy: true
+      trackUserLocation: true
+---

package/MapLibre-Examples/map-tiles.ultra

@@ -0,0 +1,9 @@
+---
+title: Add a raster tile source
+description: Add a third-party raster source to the map.
+options:
+  zoom: 2
+  center: [ -74.5, 40 ]
+type: raster
+---
+https://watercolormaps.collection.cooperhewitt.org/tile/watercolor/{z}/{x}/{y}.jpg

package/MapLibre-Examples/pmtiles.ultra

@@ -0,0 +1,25 @@
+---
+title: PMTiles source and protocol
+description: Uses the PMTiles plugin and protocol to present a map.
+# Overpass Ultra has built-in support for PMTiles
+type: vector
+options:
+  zoom: 12
+  center: [ 11.2414827, 43.779779 ]
+  attributionControl:
+    compact: true
+    # Setting custom attribution bc the tiles don't seem to include it.
+    customAttribution: '© <a href="https://openstreetmap.org">OpenStreetMap</a>'
+style:
+  version: 8
+  layers:
+    - type: fill
+      source-layer: landuse
+      fill-color: steelblue
+    - type: line
+      source-layer: roads
+    - type: fill
+      source-layer: mask
+      fill-color: white
+---
+pmtiles://https://pmtiles.io/protomaps(vector)ODbL_firenze.pmtiles

package/MapLibre-Examples/wms.ultra

@@ -0,0 +1,14 @@
+---
+title: Add a WMS source
+description: Add an external Web Map Service raster layer to the map using addSource's tiles option.
+type: raster
+options:
+  center: [-74.5447, 40.6892]
+  zoom: 8
+style:
+  extends: https://styles.trailsta.sh/osm-liberty.json
+  layers:
+    - type: raster
+      beforeLayerId: aeroway_fill
+---
+https://img.nj.gov/imagerywms/Natural2015?bbox={bbox-epsg-3857}&format=image/png&service=WMS&version=1.1.1&request=GetMap&srs=EPSG:3857&transparent=true&width=512&height=512&layers=Natural2015

package/README.md

@@ -0,0 +1,46 @@
+# Introduction
+
+Ultra is a web-application made to simplify making maps with [MapLibre GL
+JS](https://maplibre.org).
+
+[Overpass Ultra](https://overpass-ultra.us) is the main deployment of Ultra.
+
+The customization of the map comply with an [extended](https://overpass-ultra.us/docs/style#ultra-maplibre-styles) version
+of the the [MapLibre Style Spec](https://maplibre.org/maplibre-style-spec/).
+
+## Documentation
+
+The documentation for Overpass Ultra is available at <a target="_blank" href="https://overpass-ultra.us/docs/">overpass-ultra.us/docs</a>.
+The only difference between the base Ultra configuration and Overpass Ultra is that Overpass Ultra
+defaults to `type: overpass`.
+
+## Configuration
+
+Various aspects of Ultra, such as styling, can be
+configured via [YAML front-matter](https://overpass-ultra.us/docs/yaml).
+
+## Styling
+
+Ultra supports styling using the [MapLibre Style
+Specification](https://maplibre.org/maplibre-style-spec/).
+
+See the [Styling](https://overpass-ultra.us/docs/style) section for more information.
+
+## About
+
+Ultra is built by Daniel Schep.
+
+You can contact me on [Mastodon](https://mapstodon.space/@trailstash).
+
+## Feedback, Bug Reports, Feature Requests
+
+While Ultra has been in development for a while, it should still be considered
+experimental.
+
+If you would like to report a bug or provide other feedback, please do so in the project's
+[Issue Tracker](https://gitlab.com/trailstash/ultra/-/issues).
+
+## Source Code</h4>
+
+The [source code](https://gitlab.com/trailstash/ultra) of this application is released under the
+[MIT license](https://gitlab.com/trailstash/ultra/-/blob/master/LICENSE).

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env -S node
+
+// eslint-disable-next-line n/shebang
+import { execute } from "@oclif/core";
+
+await execute({ development: true, dir: import.meta.url });

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from "@oclif/core";
+
+await execute({ dir: import.meta.url });