@grampro/kit 2.6.1 → 2.6.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/.gbs/skills/gbs-components/SKILL.md +16 -0
- package/CHANGELOG.md +45 -0
- package/README.md +42 -0
- package/package.json +1 -1
- package/source/components/accordion/passport.json +1 -1
- package/source/components/alert/passport.json +1 -1
- package/source/components/avatar/passport.json +1 -1
- package/source/components/badge/passport.json +1 -1
- package/source/components/breadcrumb/passport.json +1 -1
- package/source/components/button/passport.json +1 -1
- package/source/components/card/passport.json +1 -1
- package/source/components/checkbox/passport.json +1 -1
- package/source/components/combobox/passport.json +1 -1
- package/source/components/data-grid/passport.json +1 -1
- package/source/components/date-picker/passport.json +1 -1
- package/source/components/dialog/passport.json +1 -1
- package/source/components/file-uploader/passport.json +1 -1
- package/source/components/input/passport.json +1 -1
- package/source/components/menu/passport.json +1 -1
- package/source/components/modal/passport.json +1 -1
- package/source/components/number-input/passport.json +1 -1
- package/source/components/popover/passport.json +1 -1
- package/source/components/progress/passport.json +1 -1
- package/source/components/radio-group/passport.json +1 -1
- package/source/components/skeleton/passport.json +1 -1
- package/source/components/spinner/passport.json +1 -1
- package/source/components/switch/passport.json +1 -1
- package/source/components/tabs/passport.json +1 -1
- package/source/components/textarea/passport.json +1 -1
- package/source/components/toaster/passport.json +1 -1
- package/source/components/tooltip/passport.json +1 -1
- package/tools/mcp/README.md +2 -1
|
@@ -6,6 +6,22 @@ autoAttach: ["src/**/*.tsx", "src/**/*.jsx", "app/**/*.tsx", "components/**/*.ts
|
|
|
6
6
|
|
|
7
7
|
# GBS components (2.0 beta)
|
|
8
8
|
|
|
9
|
+
## If the MCP server is connected
|
|
10
|
+
|
|
11
|
+
This file is a summary. The `grampro` MCP server answers from passports
|
|
12
|
+
generated from the component source, so where the two differ it is right
|
|
13
|
+
and this is stale. When its tools are available:
|
|
14
|
+
|
|
15
|
+
- **`get_component <Name>`** before writing a component — every prop with
|
|
16
|
+
its type, the values a union accepts, which props are required, handler
|
|
17
|
+
signatures. Do not write a prop you have not read there.
|
|
18
|
+
- **`validate_usage`** on the JSX before reporting back. It catches props
|
|
19
|
+
invented from memory, which is the one failure a passport cannot prevent.
|
|
20
|
+
- **`figma_frame`** to read a design, from a `designFile` path or a Figma
|
|
21
|
+
URL, when building from one.
|
|
22
|
+
|
|
23
|
+
Neither needs the other installed. Without the server this file is what
|
|
24
|
+
you have, and everything below still applies.
|
|
9
25
|
## Install before you import
|
|
10
26
|
|
|
11
27
|
Not an npm dependency — the CLI **copies source into the repo**:
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,50 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.6.2
|
|
4
|
+
|
|
5
|
+
### Changed
|
|
6
|
+
|
|
7
|
+
**The agent skill now knows the MCP server exists.** It described the
|
|
8
|
+
component library and never mentioned the server, so an agent holding both
|
|
9
|
+
had nothing to tell it which to trust. The skill is a summary; the server
|
|
10
|
+
answers from passports generated from the source, so where they differ the
|
|
11
|
+
server is right and the skill is stale — and it now says so, along with
|
|
12
|
+
calling `get_component` before writing a component and `validate_usage`
|
|
13
|
+
before reporting back.
|
|
14
|
+
|
|
15
|
+
The only previous mention of "MCP" in the skill was WebMCP, the DataGrid's
|
|
16
|
+
browser-agent surface, which is a different thing entirely.
|
|
17
|
+
|
|
18
|
+
**Neither needs the other, and the docs now say so.** The server carries
|
|
19
|
+
its own copy of the guidance inside the package, so `get_guidance` answers
|
|
20
|
+
in a project with no `.gbs/` folder at all. What they do together is the
|
|
21
|
+
useful part: the skill is always in an agent's context and the server is
|
|
22
|
+
not, so the skill is what tells an agent to ask and the server is what it
|
|
23
|
+
asks.
|
|
24
|
+
|
|
25
|
+
The two pages now read in the order they are used — Theming, Agent skill,
|
|
26
|
+
MCP server.
|
|
27
|
+
|
|
28
|
+
**The text LLMs read was teaching a deprecated command.** `llms.txt` has a
|
|
29
|
+
hand-written preamble, so it lagged behind the CLI: it told every model
|
|
30
|
+
that reached the site to run `npx @grampro/kit -a <Component>`, a spelling
|
|
31
|
+
the CLI itself marks "Deprecated. Use: add". It now says `add`, and names
|
|
32
|
+
the Figma plugin, the whole-design export and `designFile`, none of which
|
|
33
|
+
it mentioned.
|
|
34
|
+
|
|
35
|
+
**The plugin's install link was invisible to every LLM.** It is rendered by
|
|
36
|
+
a component, and the Markdown conversion passed that through verbatim — so
|
|
37
|
+
`llms-full.txt` and every `.md` page carried a dangling `<FigmaPlugin />`
|
|
38
|
+
tag where the URL should have been, and the plugin's address appeared
|
|
39
|
+
nowhere a model could read it. The conversion emits a Markdown link now,
|
|
40
|
+
and the URL lives in one place so the button and the converter cannot
|
|
41
|
+
disagree about it.
|
|
42
|
+
|
|
43
|
+
**Every command is listed in one place.** `list` and `passport` appeared
|
|
44
|
+
in no user-facing documentation at all, and the rest were scattered across
|
|
45
|
+
three pages, so there was nowhere to look to find out what the CLI does.
|
|
46
|
+
The README now carries the lot in a table.
|
|
47
|
+
|
|
3
48
|
## 2.6.1
|
|
4
49
|
|
|
5
50
|
### Changed
|
package/README.md
CHANGED
|
@@ -80,6 +80,21 @@ Each component also has a **framework-free core** — `createDialogStore()`,
|
|
|
80
80
|
`createGridEngine()` — with no React imports, usable on a server. That part is
|
|
81
81
|
genuinely headless, and the component READMEs document it under "Headless use".
|
|
82
82
|
|
|
83
|
+
## Commands
|
|
84
|
+
|
|
85
|
+
| | |
|
|
86
|
+
| --- | --- |
|
|
87
|
+
| `add <Component>...` | Copy components into the project. `--dest` chooses where; `--legacy` reaches the 1.x set. |
|
|
88
|
+
| `list` | What is available to add. |
|
|
89
|
+
| `skill` | Install the agent skill. `--for claude,codex,antigravity` narrows it. |
|
|
90
|
+
| `mcp` | Run the MCP server. Agents start this themselves; you rarely type it. |
|
|
91
|
+
| `mcp install` | Write the server's configuration for Claude Code, Codex and Cursor. |
|
|
92
|
+
| `secret set figma` | Store a Figma token in the OS credential store. Also `get`, `list`, `remove`. |
|
|
93
|
+
| `design <file>` | Split a whole-design Figma export into a folder of screens. |
|
|
94
|
+
| `passport --check` | Fail if a passport has drifted from its source. For CI, and after forking a component. |
|
|
95
|
+
|
|
96
|
+
`npx @grampro/kit <command>`, or `grampro-kit` once it is a dev dependency.
|
|
97
|
+
|
|
83
98
|
## Documentation
|
|
84
99
|
|
|
85
100
|
[kit.gramproindia.com](https://kit.gramproindia.com) — usage and props per
|
|
@@ -122,6 +137,33 @@ takes. Full walkthrough, including a prompt to paste:
|
|
|
122
137
|
[kit.gramproindia.com/mcp-server](https://kit.gramproindia.com/mcp-server).
|
|
123
138
|
Details in [`tools/mcp/README.md`](tools/mcp/README.md).
|
|
124
139
|
|
|
140
|
+
## Figma plugin
|
|
141
|
+
|
|
142
|
+
[**Grampro Kit on the Figma Community**](https://www.figma.com/community/plugin/1692828324805361551)
|
|
143
|
+
|
|
144
|
+
Two jobs. It generates the whole design system inside Figma — 53 variables
|
|
145
|
+
across light and dark, 13 text styles, 38 component sets — and it exports
|
|
146
|
+
screens as JSON a coding agent can build from.
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
# in Figma: Grampro Kit → Export all screens for an agent → Save .json
|
|
150
|
+
npx @grampro/kit design ./design.json
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
```text
|
|
154
|
+
design/
|
|
155
|
+
purchase-orders.json
|
|
156
|
+
suppliers.json
|
|
157
|
+
index.json every screen, the shared theme, the regions that repeat
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
The agent reads `index.json` to plan, then builds one screen at a time
|
|
161
|
+
against `figma_frame`, `get_component` and `validate_usage`. It needs no
|
|
162
|
+
Figma API token and makes no network requests of any kind.
|
|
163
|
+
|
|
164
|
+
Source is in [`figma-plugin/`](figma-plugin/); the published listing is
|
|
165
|
+
what to install.
|
|
166
|
+
|
|
125
167
|
## Agent skill
|
|
126
168
|
|
|
127
169
|
Install the skill once per project so a coding agent uses these components
|
package/package.json
CHANGED
package/tools/mcp/README.md
CHANGED
|
@@ -127,7 +127,8 @@ invention, and this catches it:
|
|
|
127
127
|
|
|
128
128
|
## A whole design at once
|
|
129
129
|
|
|
130
|
-
|
|
130
|
+
Install [Grampro Kit from the Figma Community](https://www.figma.com/community/plugin/1692828324805361551). Then
|
|
131
|
+
**Grampro Kit → Export all screens for an agent** walks every
|
|
131
132
|
page and exports each top-level frame, with one set of theme values read
|
|
132
133
|
across the whole design rather than guessed per frame. Save it, then:
|
|
133
134
|
|