vectorvesper 2.3.0 → 2.4.1

package/README.md

@@ -53,6 +53,37 @@ export default function Page() {
 }
 ```
 
+## MCP server — motion advice for your coding agent
+
+The same CLI runs as an [MCP](https://modelcontextprotocol.io) server, so Claude Code, Cursor, Copilot and friends can ask about motion before they write it.
+
+```bash
+npx vectorvesper mcp install
+```
+
+That configures every supported editor it finds. Restart the editor and run `npx vectorvesper mcp status` to confirm. No account or token is needed — the runtime, its contracts and the linter are free.
+
+**Why bother.** Bad motion code does not error. TypeScript passes, the build is green, and the page janks on a mid-range phone six weeks later with nothing connecting the two. An agent has no feedback signal for the one quality dimension that matters here, so this server gives it three:
+
+- **`plan_motion`** — describe what you are building and get told whether it needs a primitive **at all**, which ones, in what order, and when that advice would be wrong. It says "use CSS, not this" for a hover state, a fade on mount, a spinner or a one-time scroll reveal, because those are compositor features that cost no main-thread time. Roughly a fifth of its answers recommend the platform over this library.
+- **`get_hook` / `get_pattern` / `get_component`** — the contract, not the source. Does this need a client boundary, does it own the element's transform, what does it conflict with, which frame lane does it run in, and when should you not use it.
+- **`check_motion`** — a static linter for the failure class that ships silently: a private `requestAnimationFrame` loop outside the shared budget, a discarded unsubscribe, `setState` in a frame callback, layout read in the write lane, one transform with two owners, a `<Canvas>` prop that quietly overrules the adapter that set it, a WebGL scene with nothing watching for a lost context, motion with no reduced-motion guard.
+
+Prefer to wire it by hand? Add this to your client's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "vectorvesper": {
+      "command": "npx",
+      "args": ["-y", "vectorvesper", "mcp"]
+    }
+  }
+}
+```
+
+Full setup notes and the per-client config paths: [vectorvesper.dev/docs/mcp](https://vectorvesper.dev/docs/mcp).
+
 ## CLI Command Reference
 
 | Command | Description |
@@ -63,6 +94,9 @@ export default function Page() {
 | `update [slug]` | Update installed components to the latest version |
 | `diff [slug]` | Check local files against registry updates |
 | `remove <slug>` | Safely remove a component's files from the project |
+| `mcp install [client]` | Configure the MCP server for your editor(s) |
+| `mcp status` | Check which clients are wired up |
+| `mcp` | Run the MCP server on stdio (what the editor invokes) |
 | `info` | Output workspace diagnostics for troubleshooting |
 
 Works out of the box with **npm, pnpm, yarn, and bun** by checking your lockfile.

package/dist/hooks.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
   "engineVersion": "4.0.0",
-  "generatedAt": "2026-08-27T13:26:41.858Z",
+  "generatedAt": "2026-08-28T08:18:25.103Z",
   "contractLevel": "full",
   "hooks": [
     {
@@ -3503,10 +3503,24 @@
         "parallax",
         "layers move with the mouse",
         "depth effect",
-        "tilt with cursor",
         "parallax scene"
       ],
-      "allOf": [],
+      "allOf": [
+        [
+          "tilt",
+          "lean",
+          "rotate",
+          "depth",
+          "layer",
+          "perspective",
+          "skew"
+        ],
+        [
+          "cursor",
+          "mouse",
+          "pointer"
+        ]
+      ],
       "unless": [],
       "minHits": 1,
       "priority": 630,

package/dist/index.js

@@ -1122,7 +1122,7 @@ Remove ${slug}
 import fs7 from "fs";
 import path7 from "path";
 import pc8 from "picocolors";
-var CLI_VERSION = true ? "2.3.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "2.4.1" : "0.0.0-dev";
 async function infoCommand() {
   console.log(pc8.bold(pc8.cyan("\nVector Vesper Diagnostics\n")));
   const projectInfo = detectProject();
@@ -1420,7 +1420,7 @@ async function whoamiCommand() {
 }
 
 // src/index.ts
-var version = true ? "2.3.0" : "0.0.0-dev";
+var version = true ? "2.4.1" : "0.0.0-dev";
 var program = new Command();
 program.name("vv").description("Vector Vesper CLI \u2014 add visual components to your React project").version(version).option("--verbose", "Show detailed debug output").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
@@ -1462,7 +1462,7 @@ program.command("mcp [action] [client]").description(
   "Run as an MCP server (stdio) for AI coding agents. `vv mcp install` wires it into your editor; `vv mcp status` checks the setup."
 ).option("--stdio", "Force server mode even from an interactive terminal").option("-g, --global", "Write user-level config instead of project-level (install)").action(
   async (action, client, options) => {
-    const { mcpCommand } = await import("./mcp-H5YYBZ5V.js");
+    const { mcpCommand } = await import("./mcp-FP5FICSI.js");
     await mcpCommand(action, { ...options, client });
   }
 );

package/dist/{mcp-H5YYBZ5V.js → mcp-FP5FICSI.js}

@@ -138,7 +138,7 @@ function detectClients(cwd = process.cwd()) {
 }
 
 // src/commands/mcp.ts
-var VERSION = true ? "2.3.0" : "0.0.0-dev";
+var VERSION = true ? "2.4.1" : "0.0.0-dev";
 var CONFIG_SNIPPET = `{
   "mcpServers": {
     "vectorvesper": {
@@ -285,7 +285,7 @@ ${pc.red("\u2717")} Unknown argument "${action}" for \`vv mcp\`.
     return;
   }
   protectStdout();
-  const { startMcpServer } = await import("./server-KJ3YQ7G4.js");
+  const { startMcpServer } = await import("./server-AYBXJAAO.js");
   try {
     await startMcpServer();
   } catch (error) {

package/dist/{server-KJ3YQ7G4.js → server-AYBXJAAO.js}

@@ -65,10 +65,24 @@ function calleeName(callee) {
   }
   return void 0;
 }
-function isStateSetterCall(callee) {
+function isStateSetterCall(callee, reactSetters) {
   if (!callee || callee.type !== "Identifier") return false;
-  const name = callee.name;
-  return /^set[A-Z]/.test(name) && name !== "setInterval" && name !== "setTimeout";
+  return reactSetters.has(callee.name);
+}
+function collectReactSetters(ast, traverse) {
+  const names = /* @__PURE__ */ new Set();
+  traverse(ast, {
+    VariableDeclarator(p) {
+      const { id, init } = p.node;
+      if (id?.type !== "ArrayPattern") return;
+      const callee = init?.callee;
+      const hook = callee?.type === "Identifier" ? callee.name : callee?.property?.name;
+      if (hook !== "useState" && hook !== "useReducer") return;
+      const second = id.elements?.[1];
+      if (second?.type === "Identifier") names.add(second.name);
+    }
+  });
+  return names;
 }
 function accessorName(callee) {
   const obj = callee?.object;
@@ -118,6 +132,7 @@ function collect(ast, traverse) {
     handlesContextLoss: false,
     gatingObserver: []
   };
+  const reactSetters = collectReactSetters(ast, traverse);
   const manifest = loadHookManifest();
   const hookByName = /* @__PURE__ */ new Map();
   for (const h of manifest?.hooks ?? []) hookByName.set(h.name, h);
@@ -140,12 +155,12 @@ function collect(ast, traverse) {
     if (!file) return;
     traverse(file, {
       CallExpression(p) {
-        if (isStateSetterCall(p.node.callee)) {
+        if (isStateSetterCall(p.node.callee, reactSetters)) {
           f.setStateInHot.push({ line: cbNode.loc?.start.line ?? 0, ctx, fromRaf });
         }
       },
       OptionalCallExpression(p) {
-        if (isStateSetterCall(p.node.callee)) {
+        if (isStateSetterCall(p.node.callee, reactSetters)) {
           f.setStateInHot.push({ line: cbNode.loc?.start.line ?? 0, ctx, fromRaf });
         }
       }
@@ -156,7 +171,7 @@ function collect(ast, traverse) {
     if (!file) return false;
     let found = false;
     const visit = (p) => {
-      if (isStateSetterCall(p.node.callee)) found = true;
+      if (isStateSetterCall(p.node.callee, reactSetters)) found = true;
     };
     traverse(file, { CallExpression: visit, OptionalCallExpression: visit });
     return found;
@@ -871,7 +886,7 @@ function formatPlan({ building, using }) {
 }
 
 // src/mcp/server.ts
-var VERSION = true ? "2.3.0" : "0.0.0-dev";
+var VERSION = true ? "2.4.1" : "0.0.0-dev";
 function text(body) {
   return { content: [{ type: "text", text: body }] };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vectorvesper",
-  "version": "2.3.0",
-  "description": "Add WebGL, React Three Fiber & advanced motion components to your project via CLI.",
+  "version": "2.4.1",
+  "description": "Motion runtime and WebGL/R3F component CLI for React, with an MCP server that tells your coding agent which primitive to use, how to wire it, and when not to.",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -25,18 +25,29 @@
   },
   "homepage": "https://vectorvesper.dev",
   "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "ai",
+    "agent",
+    "claude",
+    "cursor",
+    "copilot",
     "react",
     "webgl",
     "three",
     "threejs",
+    "react-three-fiber",
     "components",
     "cli",
     "ui",
-    "visual",
     "animation",
+    "motion",
     "gsap",
     "shader",
-    "interactive"
+    "interactive",
+    "performance",
+    "requestanimationframe"
   ],
   "scripts": {
     "build": "tsup",
@@ -65,5 +76,6 @@
     "tsup": "^8.0.2",
     "typescript": "^6.0.3",
     "vitest": "^2.1.8"
-  }
+  },
+  "mcpName": "dev.vectorvesper/motion"
 }