doxa-open/doxa-maps

History

Doxa Maps 6ed22cdba7 Some checks are pending Deploy to GitHub Pages / build (push) Waiting to run Details Deploy to GitHub Pages / deploy (push) Blocked by required conditions Details Update from source f849683d		2026-09-26 07:53:22 +00:00
..
.gitkeep	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
apiBaseUrl.js	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
ClusterHelpers.js	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
countries-meta.js	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
DataSourceManager.js	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
embedBase.js	Update from source 13e0e02c	2026-09-26 00:18:46 +00:00
geoUtils.js	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
html.js	Update from source c2af6b16	2026-09-26 07:01:59 +00:00
loadPinnedUmd.js	Update from source f849683d	2026-09-26 07:53:22 +00:00
MSTClusteringUtil.js	Update from source c2af6b16	2026-09-26 07:01:59 +00:00
NetworkClusteringUtil.js	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
README.md	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00
viewportScrim.js	Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf	2026-09-25 20:07:59 +00:00

README.md

library/utils/ — pure JS helpers

No Vue, no Pinia, no Mapbox. Anything reactive is a composable; anything stateful is a store.

File	Purpose
`apiBaseUrl.js`	Resolves the API base URL at runtime (`window.MAP_APP_API_URL` / `VITE_API_BASE_URL`)
`embedBase.js`	Share/embed URL ladder — the built bundle derives its tree root from its own script url (`profileConfig.shareUrl` / `embedBaseUrl` / `window.MAP_EMBED_BASE_URL` override) so tree-relative `<bundle>/<profile>/index.html` links work on any host
`geoUtils.js`	Centroid, bounds, validation, GeoJSON helpers
`ClusterHelpers.js`	Shared helpers for the two clustering utilities below
`MSTClusteringUtil.js`	Minimum-spanning-tree clustering for affinity blocks
`NetworkClusteringUtil.js`	Network-line clustering — connect nearby pins with edges

No import { ref } from 'vue' and no import mapboxgl in this folder — operate on plain [lng, lat] arrays.
Named exports (for tree-shaking), JSDoc on every export.
Writing reactive logic or needing Mapbox APIs? That's a composable — move it to ../composables/.