Changelog & Release Notes

API updates, new features and bug fixes. Newest first.

---

Unreleased

Nothing yet.

---

Web Map SDK (@sovereignsolutions/ss-map-gl)

v2.0.0 (breaking)

• Complete map API, one package - Map, Marker, Popup, NavigationControl, LngLat, and the rest of a full map API are now available directly from @sovereignsolutions/ss-map-gl, alongside SS styles/defaults, drawing, clustering, and geolocation. Nothing else to install.
• Full MapLibre GL ecosystem compatibility - Map implements the open MapLibre GL standard exactly, so controls, overlays, geocoders, drawing tools, tile protocols, and framework bindings (react-map-gl, vue-maplibre-gl, deck.gl, terra-draw, the MapLibre geocoder, pmtiles, …) all work with it unmodified, with a single deduped engine instance on the page.
• A single-<script> CDN/UMD bundle (dist/ss-map-gl.umd.js) with everything included - no other <script> tags needed.
• New default map center: New Delhi, India ([77.2090, 28.6139]), replacing the previous Hanoi default.
• "Sovereign Solutions" attribution is now shown by default on every map (Map and MapEngine) - pass attributionControl: false to remove it, or your own customAttribution to extend it.
• Breaking: DrawingController (and the draw_circle/draw_notation modes) moved to the @sovereignsolutions/ss-map-gl/drawing subpath - update import { DrawingController } from '@sovereignsolutions/ss-map-gl' to from '@sovereignsolutions/ss-map-gl/drawing'. This keeps the drawing engine out of your bundle if you never draw.
• Breaking: the npm build's main/module paths changed (dist/index.{js,cjs} instead of dist/ss-map-gl.{es,umd}.js); if you imported those dist paths directly, switch to the package's root import instead.
• Breaking: DrawingController and ClusterController now accept either a MapEngine or a map created directly by another tool (e.g. react-map-gl or vue-maplibre-gl) - no change needed if you were already passing a MapEngine.

v1.0.7

• Editor popup now forces light theme (color-scheme: light) on all form controls - fully compatible with dark-mode host applications.
• Replaced native <select> size picker with a custom-styled dropdown component: rounded corners, smooth hover/selected states, consistent white background.
• Fixed: text input and size dropdown now show correct borders and matching focus highlight (#6366f1).
• Added onModeChange callback - fires when the SDK changes drawing mode internally (e.g. after a shape is completed), useful for syncing custom toolbars.
• Fixed: Save button height misalignment with Cancel/Delete buttons in the editor popup.

v1.0.6

• Added Text Notation drawing mode (setMode('notation')) - place editable text labels directly on the map.
• Notation editor popup with live preview: text content, font size (12-32px), color picker with preset palette.
• Fixed: existing features no longer disappear when switching into Text Notation mode.
• Fixed: notation mode cursor now changes to crosshair (+) when hovering over the map.

v1.0.5

• Fixed map crash when entering circle mode with empty coordinates.

v1.0.4

• Initial public release with polygon drawing, circle drawing, clustering, and GeoJSON serialization.