@sakaniui/mcp 0.10.0 → 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 +14 -0
- package/data/CHANGELOG.md +73 -0
- package/data/dist/emoji-index.json +1 -1
- package/data/dist/icon-index.json +1 -1
- package/data/dist/manifest.json +1589 -4
- package/data/package.json +1 -1
- package/package.json +1 -1
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,79 @@
|
|
|
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
|
+
|
|
70
|
+
## 0.10.1
|
|
71
|
+
|
|
72
|
+
- **New: an agent skill.** `skills/sakaniui/SKILL.md` ships in the package. It triggers when someone asks an
|
|
73
|
+
agent for UI in a project that uses `@sakaniui/react` and points it at the MCP server, `manifest.json` and
|
|
74
|
+
`AGENTS.md` instead of repeating them, so it cannot go stale. Install it with
|
|
75
|
+
`cp -r node_modules/@sakaniui/react/skills/sakaniui .claude/skills/` (or `~/.claude/skills/` for every project).
|
|
76
|
+
- No component or API changes.
|
|
77
|
+
|
|
5
78
|
## 0.10.0
|
|
6
79
|
|
|
7
80
|
- **New: `@sakaniui/react/emoji`**, 1,594 full-colour emoji (Fluent Emoji, Flat style, by Microsoft, MIT), built
|