@grampro/kit 2.6.1 → 2.6.3

package/.gbs/skills/gbs-components/SKILL.md

@@ -6,6 +6,22 @@ autoAttach: ["src/**/*.tsx", "src/**/*.jsx", "app/**/*.tsx", "components/**/*.ts
 
 # GBS components (2.0 beta)
 
+## If the MCP server is connected
+
+This file is a summary. The `grampro` MCP server answers from passports
+generated from the component source, so where the two differ it is right
+and this is stale. When its tools are available:
+
+- **`get_component <Name>`** before writing a component — every prop with
+  its type, the values a union accepts, which props are required, handler
+  signatures. Do not write a prop you have not read there.
+- **`validate_usage`** on the JSX before reporting back. It catches props
+  invented from memory, which is the one failure a passport cannot prevent.
+- **`figma_frame`** to read a design, from a `designFile` path or a Figma
+  URL, when building from one.
+
+Neither needs the other installed. Without the server this file is what
+you have, and everything below still applies.
 ## Install before you import
 
 Not an npm dependency — the CLI **copies source into the repo**:

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # Changelog
 
+## 2.6.3
+
+### Fixed
+
+**The text LLMs read was teaching a deprecated command.** `llms.txt` has a
+hand-written preamble, so it lagged behind the CLI: it told every model
+that reached the site to run `npx @grampro/kit -a <Component>`, a spelling
+the CLI itself marks "Deprecated. Use: add". It now says `add`, and names
+the Figma plugin, the whole-design export and `designFile`, none of which
+it mentioned.
+
+**The plugin's install link was invisible to every LLM.** It is rendered by
+a component, and the Markdown conversion passed that through verbatim — so
+`llms-full.txt` and every `.md` page carried a dangling `<FigmaPlugin />`
+tag where the URL should have been, and the plugin's address appeared
+nowhere a model could read it. The conversion emits a Markdown link now,
+and the URL lives in one place so the button and the converter cannot
+disagree about it.
+
+**The Figma plugin's listing is in review**, which Figma is quoting at a
+few weeks. Every place that links it now says so and gives the interim
+path: clone the repository and import `figma-plugin/manifest.json` through
+**Plugins → Development → Import plugin from manifest...** in the desktop
+app. The build is committed, so there is nothing to compile.
+
+**Six links in the docs went nowhere.** `datagrid.mdx` and
+`fileuploader.mdx` pointed at `#column-options`, `#grid-api-ref`,
+`#server-side-pagination`, `#upload-protocol`, `#custom-transport` and
+`#server-implementation` as same-page anchors. Those sections moved to
+child pages when the docs were split and the links were never updated, so
+they had been doing nothing since. They point at the child pages now.
+
+### Changed
+
+**Every command is listed in one place.** `list` and `passport` appeared
+in no user-facing documentation at all, and the rest were scattered across
+three pages, so there was nowhere to look to find out what the CLI does.
+The README now carries the lot in a table.
+
+## 2.6.2
+
+### Changed
+
+**The agent skill now knows the MCP server exists.** It described the
+component library and never mentioned the server, so an agent holding both
+had nothing to tell it which to trust. The skill is a summary; the server
+answers from passports generated from the source, so where they differ the
+server is right and the skill is stale — and it now says so, along with
+calling `get_component` before writing a component and `validate_usage`
+before reporting back.
+
+The only previous mention of "MCP" in the skill was WebMCP, the DataGrid's
+browser-agent surface, which is a different thing entirely.
+
+**Neither needs the other, and the docs now say so.** The server carries
+its own copy of the guidance inside the package, so `get_guidance` answers
+in a project with no `.gbs/` folder at all. What they do together is the
+useful part: the skill is always in an agent's context and the server is
+not, so the skill is what tells an agent to ask and the server is what it
+asks.
+
+The two pages now read in the order they are used — Theming, Agent skill,
+MCP server.
+
 ## 2.6.1
 
 ### Changed

package/README.md

@@ -80,6 +80,21 @@ Each component also has a **framework-free core** — `createDialogStore()`,
 `createGridEngine()` — with no React imports, usable on a server. That part is
 genuinely headless, and the component READMEs document it under "Headless use".
 
+## Commands
+
+| | |
+| --- | --- |
+| `add <Component>...` | Copy components into the project. `--dest` chooses where; `--legacy` reaches the 1.x set. |
+| `list` | What is available to add. |
+| `skill` | Install the agent skill. `--for claude,codex,antigravity` narrows it. |
+| `mcp` | Run the MCP server. Agents start this themselves; you rarely type it. |
+| `mcp install` | Write the server's configuration for Claude Code, Codex and Cursor. |
+| `secret set figma` | Store a Figma token in the OS credential store. Also `get`, `list`, `remove`. |
+| `design <file>` | Split a whole-design Figma export into a folder of screens. |
+| `passport --check` | Fail if a passport has drifted from its source. For CI, and after forking a component. |
+
+`npx @grampro/kit <command>`, or `grampro-kit` once it is a dev dependency.
+
 ## Documentation
 
 [kit.gramproindia.com](https://kit.gramproindia.com) — usage and props per
@@ -122,6 +137,38 @@ takes. Full walkthrough, including a prompt to paste:
 [kit.gramproindia.com/mcp-server](https://kit.gramproindia.com/mcp-server).
 Details in [`tools/mcp/README.md`](tools/mcp/README.md).
 
+## Figma plugin
+
+[**Grampro Kit on the Figma Community**](https://www.figma.com/community/plugin/1692828324805361551)
+
+> In review — Figma is quoting a few weeks. Until it clears, clone this
+> repository and import `figma-plugin/manifest.json` through **Plugins →
+> Development → Import plugin from manifest...** in the Figma desktop app.
+> The build is committed, so there is nothing to compile.
+
+Two jobs. It generates the whole design system inside Figma — 53 variables
+across light and dark, 13 text styles, 38 component sets — and it exports
+screens as JSON a coding agent can build from.
+
+```bash
+# in Figma: Grampro Kit → Export all screens for an agent → Save .json
+npx @grampro/kit design ./design.json
+```
+
+```text
+design/
+  purchase-orders.json
+  suppliers.json
+  index.json          every screen, the shared theme, the regions that repeat
+```
+
+The agent reads `index.json` to plan, then builds one screen at a time
+against `figma_frame`, `get_component` and `validate_usage`. It needs no
+Figma API token and makes no network requests of any kind.
+
+Source is in [`figma-plugin/`](figma-plugin/); the published listing is
+what to install.
+
 ## Agent skill
 
 Install the skill once per project so a coding agent uses these components

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grampro/kit",
-  "version": "2.6.1",
+  "version": "2.6.3",
   "description": "GramproKit \u2014 an agent-native UI runtime for React. Copy-in components you own, each publishing a contract that software can read.",
   "type": "module",
   "files": [

package/source/components/accordion/passport.json

@@ -10,7 +10,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/open.ts",

package/source/components/alert/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/live.ts",

package/source/components/avatar/passport.json

@@ -9,7 +9,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/identity.ts",
       "core/index.ts",

package/source/components/badge/passport.json

@@ -9,7 +9,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/count.ts",
       "core/index.ts",

package/source/components/breadcrumb/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/trail.ts",

package/source/components/button/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/state.ts",

package/source/components/card/passport.json

@@ -12,7 +12,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/trend.ts",

package/source/components/checkbox/passport.json

@@ -10,7 +10,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/group.ts",
       "core/index.ts",

package/source/components/combobox/passport.json

@@ -9,7 +9,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/filter.ts",
       "core/index.ts",

package/source/components/data-grid/passport.json

@@ -14,7 +14,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "agent/coerce.ts",
       "agent/contract.ts",

package/source/components/date-picker/passport.json

@@ -10,7 +10,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/calendar.ts",
       "core/format.ts",

package/source/components/dialog/passport.json

@@ -9,7 +9,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/api.ts",
       "core/dialog.ts",

package/source/components/file-uploader/passport.json

@@ -13,7 +13,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/format.ts",
       "core/index.ts",

package/source/components/input/passport.json

@@ -9,7 +9,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/count.ts",
       "core/index.ts",

package/source/components/menu/passport.json

@@ -16,7 +16,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/navigation.ts",

package/source/components/modal/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/dismiss.ts",
       "core/index.ts",

package/source/components/number-input/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/format.ts",
       "core/index.ts",

package/source/components/popover/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/types.ts",

package/source/components/progress/passport.json

@@ -9,7 +9,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/progress.ts",

package/source/components/radio-group/passport.json

@@ -10,7 +10,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/group.ts",
       "core/index.ts",

package/source/components/skeleton/passport.json

@@ -9,7 +9,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/lines.ts",

package/source/components/spinner/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/types.ts",

package/source/components/switch/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/toggle.ts",

package/source/components/tabs/passport.json

@@ -12,7 +12,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/navigation.ts",

package/source/components/textarea/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/count.ts",
       "core/index.ts",

package/source/components/toaster/passport.json

@@ -11,7 +11,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/api.ts",
       "core/index.ts",

package/source/components/tooltip/passport.json

@@ -8,7 +8,7 @@
     ]
   },
   "source": {
-    "libraryVersion": "2.6.1",
+    "libraryVersion": "2.6.3",
     "files": [
       "core/index.ts",
       "core/types.ts",

package/tools/mcp/README.md

@@ -127,7 +127,16 @@ invention, and this catches it:
 
 ## A whole design at once
 
-In Figma, **Grampro Kit → Export all screens for an agent** walks every
+Install [Grampro Kit from the Figma Community](https://www.figma.com/community/plugin/1692828324805361551).
+
+> The listing is in review, which Figma is quoting at a few weeks. Until it
+> clears: clone the repository and, in the Figma **desktop** app, use
+> **Plugins → Development → Import plugin from manifest...** on
+> `figma-plugin/manifest.json`. The build is committed, so there is nothing
+> to compile.
+
+Then
+**Grampro Kit → Export all screens for an agent** walks every
 page and exports each top-level frame, with one set of theme values read
 across the whole design rather than guessed per frame. Save it, then: