@mapmap/maps 0.7.0 → 0.10.0

package/llms-sdk.txt

@@ -145,6 +145,24 @@ below with a white halo. Everything renders in one source + symbol layer,
 both id `mm-user-markers`. Survives `setStyle` theme swaps.
 `renderMarkerImage({ icon, colour, size })` is exported for reuse.
 
+BAKED INTO THE STYLE. You do not need this SDK to see a published theme's
+glyph markers. The theme compiler translates `extra.markers` into real
+style constructs — an inline `mm-user-markers` GeoJSON source plus the
+`mm-user-markers` and `mm-user-markers-glyph` symbol layers, drawn from
+MapMap's SDF marker sprite and recoloured per marker with `icon-color` —
+so a plain `new maplibregl.Map({ style })`, MapLibre Native on iOS or
+Android, or a static renderer draws them from the style URL alone.
+
+The exception: markers with a custom `data:` `image`. A static sprite
+cannot carry per-theme artwork, so the compiler SKIPS those items rather
+than substituting a wrong glyph; they render only through `MarkersLayer`.
+
+MarkersLayer against a baked style: it TAKES OVER rather than drawing a
+second copy — given markers, it removes the two baked layers and installs
+its own (a strict superset: runtime updates, custom images, short-text
+pins). Constructed and never given markers, it leaves the baked layers
+alone. `hasBakedMarkers(map)` tells you which style you are on.
+
 Short-text pins: `renderMarkerImage({ text: "12", colour, size })` draws
 1–3 white bold characters in the pin head INSTEAD of a glyph, auto-shrunk
 to fit — this is what numbered waypoints and lettered stops use. Its
@@ -218,4 +236,9 @@ Gateway errors are RFC 9457 problem+json; SDK exceptions surface their
 ## Attribution
 
 "© OpenStreetMap contributors © OpenMapTiles" is legally required, baked
-into every style, and not removable. Do not attempt to hide it.
+into every style, and not removable. Do not attempt to hide it. Default
+corners: attribution bottom-left, MapMap mark bottom-right. To use another
+corner pass `attributionPosition: "bottom-right" | "bottom-left" |
+"top-left" | "top-right"` to `createMap`; never relocate the control by
+reaching into map internals. The mark and the credit never share a corner:
+on a collision the SDK moves the mark to the opposite bottom corner.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapmap/maps",
-  "version": "0.7.0",
+  "version": "0.10.0",
   "description": "MapMap Maps SDK \u2014 a thin, well-typed MapLibre GL JS wrapper that drops a MapMap-branded map with signed territory tiles and OSRM-compatible truck/ADR routing into any web app.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Mapmap AI Ltd",
@@ -67,4 +67,4 @@
   "engines": {
     "node": ">=18"
   }
-}
+}