@sakaniui/react 0.11.0 → 0.11.2

package/AGENTS.md

@@ -245,6 +245,20 @@ lists its other names under `aliases` in `manifest.json`, and `search_components
   row in a list. **Charts** — pick by question: trend over time → Line/Area; compare categories → Bar;
   part of whole → Pie/Donut (few slices only); progress to a target → Radial; compare several measures →
   Radar; drop-off → Funnel; intensity across two dimensions → Heatmap.
+- **Map / MapMarker / MapPopup / MapClusterLayer** — an interactive tile map with no map library. Put `MapMarker`
+  (`pin`, `dot`, `cluster`) and `MapPopup` children inside `Map`, placed by `[latitude, longitude]` (latitude
+  first). Give every marker a `label`; a marker with `onClick` is a button and `selected` is yours to set. The
+  default tiles are OpenStreetMap's, fine for development and light use: for production traffic pass `tileUrl`
+  (and `attribution`) from a tile provider. For a live feed keep positions in state and give the markers `glide`
+  (about the interval between updates, in ms) so they slide instead of jumping. For more than a few dozen places
+  use `MapClusterLayer` (`points`, `renderPoint`) instead of mapping hundreds of `MapMarker`s. Dark mode follows
+  `.dark`; `theme="dark"` makes one map dark, `tileUrlDark` supplies a dark tile style. It only draws a map: no
+  routing, geocoding or search, and a map is hard to use without a pointer, so list the places beside it.
+  **MapGlobe** — a 3D dotted globe for places across the whole world (offices, customers, routes), not for
+  navigation: `variant` land or ocean, `markers`, `arcs`. It has no background of its own, so place it on the
+  colour you want (`theme="dark"` for a dark surface inside a light page); give markers a `label` and
+  `onMarkerClick` to make them selectable. Choose Map when people need streets and zoom, MapGlobe when the point
+  is global spread.
 - **Avatar / AvatarGroup** — Avatar type is inferred: `src` → image, `initials` → initials, else icon.
   Prefer a real image when you have one; initials are the fallback, not the default.
 - **BoardCard / BoardColumn** — kanban pieces. `BoardColumn state="loading"` styles the column; *you* pass

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to `@sakaniui/react` are documented here.
 
+## 0.11.2
+
+- **Agent guide:** `AGENTS.md` gains a Map section (when to use `Map` or `MapGlobe`, latitude first, tile providers,
+  `glide` for live feeds, `MapClusterLayer` for many places, dark mode, accessibility), served by the MCP
+  server's `get_guide`.
+- **MCP server:** `@sakaniui/mcp` 0.11.2 carries the 0.11 reference, so Map and its parts are found even in a
+  project that has no `@sakaniui/react` installed (a project that has it was already answered from its own copy).
+- **Fixed: `since` for `MapControlButton` and `MapControls`** was 0.11.1; they shipped in 0.11.0. The release
+  history can now name the commit a version was actually published from (`scripts/manifest/releases.json`).
+- No component or API changes.
+
+## 0.11.1
+
+- **Fixed: `Map` markers on the server.** Rendered before the map is measured, markers and popups were placed
+  against a 0x0 map and then jumped, and Next.js logged a hydration warning. They now appear once the map has a
+  size. No API changes.
+- **Fixed: `--map-tile-filter` can be set from outside.** It was declared on the map itself, so a value set on a
+  wrapper was ignored, and a panel that forces the light tokens inside a dark page still got dark tiles. It now
+  falls back to the built-in light or dark filter, so setting `--map-tile-filter` on the map or on any ancestor wins.
+- **Fixed: `tileUrlDark` now reacts to a `.dark` class added or removed on any ancestor**, not only on `<html>`.
+
 ## 0.11.0
 
 - **New: `Map`**, an interactive tile map built from the new *↳ Map* page in Figma, with no map library.