@sakaniui/mcp 0.18.3 → 0.19.1
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/README.md +2 -2
- package/data/AGENTS.md +10 -0
- package/data/CHANGELOG.md +16 -0
- package/data/dist/emoji-index.json +1 -1
- package/data/dist/icon-index.json +1 -1
- package/data/dist/manifest.json +749 -14
- package/data/package.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -35,7 +35,7 @@ Any MCP client (Cursor, Windsurf, Claude Desktop, ...), or a `.mcp.json` in your
|
|
|
35
35
|
and in Claude Code: `claude mcp add sakaniui -- cmd /c npx -y @sakaniui/mcp`.
|
|
36
36
|
|
|
37
37
|
Needs Node.js 18 or later. Check it is connected in your editor's MCP list (in Claude Code: `/mcp`): `sakaniui` should
|
|
38
|
-
show
|
|
38
|
+
show 11 tools.
|
|
39
39
|
|
|
40
40
|
## Tools
|
|
41
41
|
|
|
@@ -71,7 +71,7 @@ npx -y @sakaniui/mcp --doctor
|
|
|
71
71
|
| Times out on the first start | The first run downloads about 200 kB. Run `npx -y @sakaniui/mcp --version` once in a terminal to warm the cache, then restart the editor. |
|
|
72
72
|
| Behind a company proxy or private npm registry | The machine must reach `registry.npmjs.org` (check `npm config get registry`) and `@sakaniui/*` packages must be allowed. |
|
|
73
73
|
| Odd `npx` errors, or an old version keeps running | Delete the `_npx` folder inside your npm cache (find it with `npm config get cache`), then restart the editor. |
|
|
74
|
-
| Added it but no tools appear | Restart the editor. In Claude Code run `/mcp` and look for `sakaniui` with
|
|
74
|
+
| Added it but no tools appear | Restart the editor. In Claude Code run `/mcp` and look for `sakaniui` with 11 tools. |
|
|
75
75
|
| `Failed to connect` after typing the command by hand | Check the package name for a full-width `@` or stray characters; copy the command from here instead. |
|
|
76
76
|
|
|
77
77
|
## Matches your version
|
package/data/AGENTS.md
CHANGED
|
@@ -279,6 +279,16 @@ lists its other names under `aliases` in `manifest.json`, and `search_components
|
|
|
279
279
|
Change `center` and the globe turns to face the new place; `zoom` scales it; `renderMarkerCard` puts your own card
|
|
280
280
|
on the hovered or selected marker (`cardPlacement="side"` puts it beside the marker). `markerScale={1}` keeps the
|
|
281
281
|
markers at design size on a small globe.
|
|
282
|
+
**RegionMap** — a choropleth: regions (states, countries, territories) shaded by a number, for "how does this vary by
|
|
283
|
+
place". `regions` + `viewBox` are the shapes (outlines ship per country and are imported on their own so an app only carries
|
|
284
|
+
the ones it uses: `import { UK_REGIONS, UK_REGIONS_VIEWBOX } from '@sakaniui/react/regions/uk'`, likewise `/us` US_STATES,
|
|
285
|
+
`/es` ES_REGIONS (autonomous communities), `/de` DE_REGIONS (Länder), `/ca` CA_REGIONS (provinces), `/au` AU_REGIONS (states and
|
|
286
|
+
territories); any SVG paths work), `values` is `{ [regionId]: number }` and `scale` is `{ breaks, diverging? }` (4 breaks = 5 bins; `diverging` paints
|
|
287
|
+
bins below zero orange, for growth or change). Hover shows a card (`renderTooltip`); click, Enter or Space selects a region
|
|
288
|
+
and the view eases to it (`selected` / `defaultSelected` / `onSelectedChange`; Escape or a second click goes back out).
|
|
289
|
+
Put `RegionMapLegend` (same `scale`, optional `caption`) under it. It has no tiles, streets or search: for places by
|
|
290
|
+
coordinates use Map or MapGlobe. `RegionMapBlock` is the full "Revenue by state" card (metric tabs, area select, ranked
|
|
291
|
+
list that becomes a region's detail); copy it and swap `sample.ts`.
|
|
282
292
|
**Flag** — a country flag (`country="JP"`, an ISO alpha-2 code; 16px beside text, 32px beside a heading). Not an emoji:
|
|
283
293
|
it is the Figma flag artwork, so use it instead of a flag emoji. Only the flags the library uses are imported; any other
|
|
284
294
|
code draws a neutral placeholder. Put the country's name in text beside it.
|
package/data/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to `@sakaniui/react` are documented here.
|
|
4
4
|
|
|
5
|
+
## 0.19.1
|
|
6
|
+
|
|
7
|
+
### Fixed
|
|
8
|
+
|
|
9
|
+
- **`RegionMap`'s hover card stays under the pointer inside a scaled container.** The card was placed from the pointer's screen position, so in a preview shrunk with `transform: scale()` (an expanded docs preview, a scale-to-fit frame) it landed off by the scale factor. It now divides by the scale. Nothing changes when the map is not scaled.
|
|
10
|
+
|
|
11
|
+
## 0.19.0
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- **`RegionMap`, `RegionMapLegend` and `RegionMapBlock`.** A choropleth for "how does this vary by place": regions shaded by a value, a hover card with the rank, and click-to-zoom into one region (the view eases to it; Escape or a second click goes back out; reduced motion jumps). Plain SVG, no map library, no new dependency. The shapes are data (`regions` + `viewBox`), so it is not tied to one country: outlines ship per country, each importable on its own so an app only carries the ones it uses: `@sakaniui/react/regions/us` (the 50 states and DC), `/uk` (the 12 statistical regions), `/es` (the 17 autonomous communities and Ceuta and Melilla, with the Canary Islands as an inset), `/de` (the 16 Länder), `/ca` (13 provinces and territories) and `/au` (6 states and 2 territories), 6 to 45 KB each, from Natural Earth and US Census boundaries (public domain), and any SVG paths work. `scale` takes `breaks` (4 breaks make 5 bins) and `diverging` for growth-style data (orange below zero, blue above). Keyboard: one tab stop, arrows move between regions, Enter or Space selects. `RegionMapBlock` is the full "Revenue by state" card (Blocks / Application / Region Map): a metric switch, a find-a-state search, the headline figure, the map and legend, and a ranked list (highest or lowest, or all) that becomes, once a region is zoomed, its first two metrics as compact cards (name and rank on top, the figure, then a green, red or grey pill: "+16.6 pts", "39% below", "On average"), the rest of the metrics as one line of help text under them ("Penetration 10.3%, 25th of 51, in line with the average") and the regions next to it in the ranking. The map, legend and list are linked: pointing at a region outlines it everywhere and marks its band on the legend; pointing at a legend band (or clicking it to hold it) fades every region outside it. `RegionMap` gains `onHoverChange`, `hovered` and `dimExcept`; `RegionMapLegend` gains `activeBin`, `lockedBin`, `markBin`, `onBinHover`, `onBinClick` and `noData`. The list plays a load animation: each bar grows from the left while its figure counts up from zero, row by row (on first load, when the metric changes, and when you come back from a zoom). `animate={false}` turns it off, and reduced motion skips it. The map colours are seven new tokens, `--color-map-bin-0` to `--color-map-bin-4` (the chart blue stepping from 25% to 100% over `--color-bg-muted`) and `--color-map-neg-0`, `--color-map-neg-1` (the chart orange, for values below zero), declared in light and dark and mirrored in Figma as Semantic `map/*`. Nothing existing changes.
|
|
16
|
+
|
|
17
|
+
### Fixed
|
|
18
|
+
|
|
19
|
+
- **`Combobox` shows a pointer cursor, not a text cursor.** The field is a button that opens a list, but a stray `cursor: text` made it look like a box you could type into. It now shows the pointer, and the value is no longer selectable text. No prop or layout changes.
|
|
20
|
+
|
|
5
21
|
## 0.18.3
|
|
6
22
|
|
|
7
23
|
### Fixed
|