@mapmap/maps 0.10.0 → 0.11.0

package/llms-sdk.txt

@@ -25,6 +25,12 @@ height. A bare `<div id="map">` resolves to 0px and MapLibre renders an
 invisible canvas with no error. Fix: `#map { height: 100vh; }`. The SDK
 console.errors `[container-zero-height]` when it detects this.
 
+GOTCHA (Tailwind v4 / CSS cascade layers): maplibre-gl.css is UNLAYERED,
+so `.maplibregl-map { position: relative }` beats layered utilities like
+`absolute`/`inset-0` on the container and collapses it to 0px height.
+Style the map container's position/size with inline styles (or import
+maplibre-gl.css into a CSS layer), never with layered utility classes.
+
 ## Get an API key (self-serve, no account)
 
     curl -X POST https://api.mapmap.ai/v1/keys \
@@ -98,6 +104,25 @@ the tip, a `dot` at its centre; `label` draws below with a white halo and
 `text-optional: true`. They survive `setStyle` and are fully removed —
 layer, source and registered images — by `clear()`/`destroy()`.
 
+## Geocoding (search box, reverse lookup)
+
+    import { Geocoder } from "@mapmap/maps";
+    const geocoder = new Geocoder(map);   // or { baseUrl, apiKey } without a map
+    // Forward: free-text → GeocodeHit[], best first. Bias to the map centre.
+    const hits = await geocoder.geocode("tate modern", { bias: map.map.getCenter(), limit: 5 });
+    // hit: { lngLat: [lng, lat], name, kind, street, city, postcode,
+    //        categories?, details? (opening_hours, phone, website…), id?, raw }
+    // Reverse: point → nearest hits. First-party filters:
+    await geocoder.reverse(evt.lngLat, { kinds: ["poi"] });          // what did the user tap
+    await geocoder.reverse(centre, { categories: ["cafe"] });        // nearest cafés
+    await geocoder.reverse(centre, { name: "Lloyds", categories: ["bank"] });
+
+A 501 error means the deployment has no geocoding backend (self-host
+without one) — the thrown message says so. Pure helpers `buildGeocodeUrl`
+/ `buildReverseGeocodeUrl` / `parseGeocodeResponse` exist for manual
+fetches; like `buildRouteUrl`, the URL does NOT embed the API key — add
+the `Authorization: Bearer snk_…` header yourself.
+
 ## Markers, clustering, store finder
 
     import { PlacesLayer } from "@mapmap/maps";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mapmap/maps",
-  "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.",
+  "version": "0.11.0",
+  "description": "MapMap Maps SDK — 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",
   "type": "module",
@@ -44,7 +44,7 @@
     "pmtiles": "^4.3.0",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^4.1.10"
   },
   "keywords": [
     "map",
@@ -67,4 +67,4 @@
   "engines": {
     "node": ">=18"
   }
-}
+}