@sakaniui/mcp 0.10.1 → 0.11.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/data/AGENTS.md CHANGED
@@ -245,6 +245,20 @@ lists its other names under `aliases` in `manifest.json`, and `search_components
245
245
  row in a list. **Charts** — pick by question: trend over time → Line/Area; compare categories → Bar;
246
246
  part of whole → Pie/Donut (few slices only); progress to a target → Radial; compare several measures →
247
247
  Radar; drop-off → Funnel; intensity across two dimensions → Heatmap.
248
+ - **Map / MapMarker / MapPopup / MapClusterLayer** — an interactive tile map with no map library. Put `MapMarker`
249
+ (`pin`, `dot`, `cluster`) and `MapPopup` children inside `Map`, placed by `[latitude, longitude]` (latitude
250
+ first). Give every marker a `label`; a marker with `onClick` is a button and `selected` is yours to set. The
251
+ default tiles are OpenStreetMap's, fine for development and light use: for production traffic pass `tileUrl`
252
+ (and `attribution`) from a tile provider. For a live feed keep positions in state and give the markers `glide`
253
+ (about the interval between updates, in ms) so they slide instead of jumping. For more than a few dozen places
254
+ use `MapClusterLayer` (`points`, `renderPoint`) instead of mapping hundreds of `MapMarker`s. Dark mode follows
255
+ `.dark`; `theme="dark"` makes one map dark, `tileUrlDark` supplies a dark tile style. It only draws a map: no
256
+ routing, geocoding or search, and a map is hard to use without a pointer, so list the places beside it.
257
+ **MapGlobe** — a 3D dotted globe for places across the whole world (offices, customers, routes), not for
258
+ navigation: `variant` land or ocean, `markers`, `arcs`. It has no background of its own, so place it on the
259
+ colour you want (`theme="dark"` for a dark surface inside a light page); give markers a `label` and
260
+ `onMarkerClick` to make them selectable. Choose Map when people need streets and zoom, MapGlobe when the point
261
+ is global spread.
248
262
  - **Avatar / AvatarGroup** — Avatar type is inferred: `src` → image, `initials` → initials, else icon.
249
263
  Prefer a real image when you have one; initials are the fallback, not the default.
250
264
  - **BoardCard / BoardColumn** — kanban pieces. `BoardColumn state="loading"` styles the column; *you* pass
package/data/CHANGELOG.md CHANGED
@@ -2,6 +2,71 @@
2
2
 
3
3
  All notable changes to `@sakaniui/react` are documented here.
4
4
 
5
+ ## 0.11.2
6
+
7
+ - **Agent guide:** `AGENTS.md` gains a Map section (when to use `Map` or `MapGlobe`, latitude first, tile providers,
8
+ `glide` for live feeds, `MapClusterLayer` for many places, dark mode, accessibility), served by the MCP
9
+ server's `get_guide`.
10
+ - **MCP server:** `@sakaniui/mcp` 0.11.2 carries the 0.11 reference, so Map and its parts are found even in a
11
+ project that has no `@sakaniui/react` installed (a project that has it was already answered from its own copy).
12
+ - **Fixed: `since` for `MapControlButton` and `MapControls`** was 0.11.1; they shipped in 0.11.0. The release
13
+ history can now name the commit a version was actually published from (`scripts/manifest/releases.json`).
14
+ - No component or API changes.
15
+
16
+ ## 0.11.1
17
+
18
+ - **Fixed: `Map` markers on the server.** Rendered before the map is measured, markers and popups were placed
19
+ against a 0x0 map and then jumped, and Next.js logged a hydration warning. They now appear once the map has a
20
+ size. No API changes.
21
+ - **Fixed: `--map-tile-filter` can be set from outside.** It was declared on the map itself, so a value set on a
22
+ wrapper was ignored, and a panel that forces the light tokens inside a dark page still got dark tiles. It now
23
+ falls back to the built-in light or dark filter, so setting `--map-tile-filter` on the map or on any ancestor wins.
24
+ - **Fixed: `tileUrlDark` now reacts to a `.dark` class added or removed on any ancestor**, not only on `<html>`.
25
+
26
+ ## 0.11.0
27
+
28
+ - **New: `Map`**, an interactive tile map built from the new *↳ Map* page in Figma, with no map library.
29
+ Tiles are plain images on a Web Mercator grid (OpenStreetMap by default; pass `tileUrl` and `attribution` for
30
+ your own provider). Drag to pan with inertia, scroll or pinch to zoom at the pointer, double-click to zoom in;
31
+ with focus, arrows pan and + / - zoom. Props: `center`, `zoom`, `minZoom`, `maxZoom` (changing `center` or `zoom`
32
+ flies the map there), `onViewChange`, `controls`, `locate` with `onLocate` / `onLocateError`, `height`, `tileUrl`,
33
+ `attribution`. Dark mode inverts and mutes the tiles through `--map-tile-filter`, which you can override.
34
+ - **`MapMarker`**: `pin`, `dot` or `cluster` (with `count`), `selected`, `label`, `onClick`.
35
+ - **`MapPopup`**: a card that opens above a place, with `title`, `description`, `onClose` and `offset`.
36
+ - **Live data:** `glide` (ms) on `MapMarker` and `MapPopup` slides them to each new `position` instead of
37
+ jumping, for markers fed by a WebSocket, server-sent events or polling. It interpolates the place, so it stays
38
+ correct while the map is panned or zoomed, and reduced motion turns it off.
39
+ - **`MapClusterLayer`**: pass `points` and a `renderPoint`; nearby places group into counted cluster markers
40
+ that zoom to their places on click, and only what is in view is rendered (a zoom step takes about 5 ms with
41
+ 10,000 places). `radius`, `clusterMaxZoom` and `onClusterClick` tune it.
42
+ - **Dark mode** like the Figma *Dark* example: the map follows a `.dark` class on `<html>` or any ancestor, or
43
+ pass `theme="dark"` to make just that map dark on a light page (tiles, markers, controls and popups all switch).
44
+ The default tiles are darkened to flat near-black land with blue water and roads darker than the land;
45
+ `tileUrlDark` swaps in a provider's own dark tiles instead.
46
+ - **Every Figma variant and state:** `MapMarker` Pin / Dot / Cluster × Default / Hover / Selected (hover works on
47
+ every marker, and the hovered or selected one rises above its neighbours); new `MapControlButton` and
48
+ `MapControls` (Default / Hover / Disabled, with or without the locate button); `MapPopup` gains `pointer`
49
+ (Figma *Show pointer*). `hovered` pins the hover look on markers and control buttons for docs and visual tests.
50
+ - `useMapContext()` gives custom overlays `project`, `zoom`, `flyTo` and `fitBounds`.
51
+ - **New: `MapGlobe`**, a 3D dotted globe (the Figma *Map Globe*), with hover too: markers have Default, Hover
52
+ (soft halo), Selected (larger halo) and Active (pulse) states; hovering one stops the spin and shows its `label`
53
+ in a small card; `onMarkerClick` / `onMarkerHover` report the marker, and labelled markers are reachable with Tab.
54
+ `theme="dark"` makes a globe on a dark surface draw light dots. `variant` "land" dots the continents and "ocean"
55
+ dots the sea; it spins, can be dragged with inertia, and pauses offscreen and under reduced motion. `markers`
56
+ (with `active` pulses) and `arcs` are plain props, so a feed can drive them. It is a canvas with an orthographic
57
+ projection and an 11 KB land mask (Natural Earth, public domain, notice in `THIRD_PARTY_NOTICES.md`), so it adds
58
+ no dependency.
59
+ - Agent contract: `Map`, `MapMarker`, `MapPopup`, `MapClusterLayer` and `MapGlobe` are in the manifest with the
60
+ aliases *google maps*, *leaflet*, *mapbox*, *globe*, *marker clustering* and more, plus recipes for a live feed
61
+ and for clustering.
62
+
63
+ ## 0.10.2
64
+
65
+ - **New logo.** The SakaniUI arc mark replaces the orange "S" tile everywhere the library shows its own brand:
66
+ `PlaceholderLogo`'s default mark (now drawn inline in fg/default, so it re-themes), the demo blocks' sidebar
67
+ logos, and the Storybook tab icon. `SidebarHeader` drops its accent tile when the logo is the SakaniUI mark.
68
+ No API changes.
69
+
5
70
  ## 0.10.1
6
71
 
7
72
  - **New: an agent skill.** `skills/sakaniui/SKILL.md` ships in the package. It triggers when someone asks an