vectorvesper 2.4.0 → 2.5.0

package/dist/hooks.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
   "engineVersion": "4.0.0",
-  "generatedAt": "2026-08-28T05:06:16.709Z",
+  "generatedAt": "2026-08-29T13:09:19.680Z",
   "contractLevel": "full",
   "hooks": [
     {
@@ -2804,8 +2804,8 @@
         "practices/react-motion-rules.md",
         "practices/adaptive-performance.md"
       ],
-      "docsUrl": "https://vectorvesper.dev/runtime/frame-conductor",
-      "labUrl": "https://vectorvesper.dev/runtime/frame-conductor",
+      "docsUrl": "https://vectorvesper.dev/runtime/tick",
+      "labUrl": "https://vectorvesper.dev/runtime/tick",
       "disclosure": {
         "exposeImplementation": false,
         "reason": "Reproducing this hook's implementation makes the consumer run a private requestAnimationFrame loop instead of joining the shared FrameConductor. That silently removes the coordination, scheduling and frame-budget governance the runtime exists to provide, and nothing errors when it happens. Copying is a correctness bug, not just a licensing question.",

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.4.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "2.5.0" : "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.4.0" : "0.0.0-dev";
+var version = true ? "2.5.0" : "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-UEQ2Y6FU.js");
+    const { mcpCommand } = await import("./mcp-QHRDHAME.js");
     await mcpCommand(action, { ...options, client });
   }
 );

package/dist/{mcp-UEQ2Y6FU.js → mcp-QHRDHAME.js}

@@ -12,7 +12,7 @@ import pc from "picocolors";
 import fs from "fs";
 import os from "os";
 import path from "path";
-var CLIENT_IDS = ["claude", "cursor", "antigravity", "opencode"];
+var CLIENT_IDS = ["claude", "cursor", "windsurf", "antigravity", "opencode"];
 var SERVER_NAME = "vectorvesper";
 var ARGS = ["-y", "vectorvesper@latest", "mcp", "--stdio"];
 function home(...parts) {
@@ -32,6 +32,14 @@ var CLIENTS = {
     globalPath: home(".cursor", "mcp.json"),
     dialect: "mcpServers"
   },
+  windsurf: {
+    label: "Windsurf",
+    // Windsurf reads one user-level file; there is no workspace scope, so a
+    // --global flag would have nothing to switch to.
+    projectPath: null,
+    globalPath: home(".codeium", "windsurf", "mcp_config.json"),
+    dialect: "mcpServers"
+  },
   antigravity: {
     label: "Antigravity",
     // Workspace scope lives under .agents/; the global file is shared by the
@@ -138,7 +146,7 @@ function detectClients(cwd = process.cwd()) {
 }
 
 // src/commands/mcp.ts
-var VERSION = true ? "2.4.0" : "0.0.0-dev";
+var VERSION = true ? "2.5.0" : "0.0.0-dev";
 var CONFIG_SNIPPET = `{
   "mcpServers": {
     "vectorvesper": {
@@ -285,7 +293,7 @@ ${pc.red("\u2717")} Unknown argument "${action}" for \`vv mcp\`.
     return;
   }
   protectStdout();
-  const { startMcpServer } = await import("./server-H4XNBFKQ.js");
+  const { startMcpServer } = await import("./server-ENS44LZV.js");
   try {
     await startMcpServer();
   } catch (error) {

package/dist/{server-H4XNBFKQ.js → server-ENS44LZV.js}

@@ -38,6 +38,7 @@ var VV_ACCESSORS = /* @__PURE__ */ new Set([
   "getFramePressure",
   "getRendererHealth"
 ]);
+var CONTEXT_EVENTS = /* @__PURE__ */ new Set(["webglcontextlost", "webglcontextrestored"]);
 var TEARDOWN_RETURNING = /* @__PURE__ */ new Set(["subscribe", "retain"]);
 var LAYOUT_READ_PROPS = /* @__PURE__ */ new Set([
   "offsetWidth",
@@ -65,15 +66,45 @@ 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 accessorName(callee) {
+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(calleePath) {
+  const callee = calleePath?.node ?? calleePath;
   const obj = callee?.object;
-  if (obj?.type !== "CallExpression" && obj?.type !== "OptionalCallExpression") return void 0;
-  return obj.callee?.type === "Identifier" ? obj.callee.name : void 0;
+  if (!obj) return void 0;
+  if (obj.type === "CallExpression" || obj.type === "OptionalCallExpression") {
+    return obj.callee?.type === "Identifier" ? obj.callee.name : void 0;
+  }
+  if (obj.type === "Identifier" && typeof calleePath?.get === "function") {
+    const binding = calleePath.scope?.getBinding(obj.name);
+    const init = binding?.path?.node?.init;
+    if (init && (init.type === "CallExpression" || init.type === "OptionalCallExpression")) {
+      return init.callee?.type === "Identifier" ? init.callee.name : void 0;
+    }
+  }
+  return void 0;
+}
+function unsubscribeBinding(callPath) {
+  const declarator = callPath?.parentPath;
+  if (declarator?.node?.type !== "VariableDeclarator") return void 0;
+  return declarator.node.id?.type === "Identifier" ? declarator.node.id.name : void 0;
 }
 function asProgram(cbNode) {
   if (!cbNode) return null;
@@ -115,9 +146,11 @@ function collect(ast, traverse) {
     laneViolations: [],
     orphanSubscriptions: [],
     canvases: [],
+    rawGlContexts: [],
     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);
@@ -135,28 +168,79 @@ function collect(ast, traverse) {
     if (init && (init.type === "ArrowFunctionExpression" || init.type === "FunctionExpression")) return init;
     return null;
   };
-  const scanHotCallback = (cbNode, ctx, fromRaf) => {
+  const scanHotCallback = (cbNode, ctx, fromRaf, unsubName) => {
     const file = asProgram(cbNode);
     if (!file) return;
-    traverse(file, {
-      CallExpression(p) {
-        if (isStateSetterCall(p.node.callee)) {
-          f.setStateInHot.push({ line: cbNode.loc?.start.line ?? 0, ctx, fromRaf });
+    const isTerminal = (setterPath) => {
+      if (!unsubName) return false;
+      let node = setterPath;
+      while (node) {
+        if (node.node?.type === "BlockStatement") {
+          const parent = node.parentPath?.node?.type;
+          if (parent === "ArrowFunctionExpression" || parent === "FunctionExpression" || parent === "FunctionDeclaration") {
+            return false;
+          }
+          let found = false;
+          node.traverse({
+            CallExpression(inner) {
+              if (inner.node.callee?.type === "Identifier" && inner.node.callee.name === unsubName) {
+                found = true;
+              }
+            }
+          });
+          if (found) return true;
         }
-      },
-      OptionalCallExpression(p) {
-        if (isStateSetterCall(p.node.callee)) {
-          f.setStateInHot.push({ line: cbNode.loc?.start.line ?? 0, ctx, fromRaf });
+        node = node.parentPath;
+      }
+      return false;
+    };
+    const isLatched = (setterPath) => {
+      let node = setterPath;
+      while (node) {
+        const parent = node.parentPath;
+        if (parent?.node?.type === "IfStatement" && parent.node.test) {
+          const guards = /* @__PURE__ */ new Set();
+          const collect2 = (n) => {
+            if (!n || typeof n.type !== "string") return;
+            if (n.type === "Identifier") guards.add(n.name);
+            for (const key of Object.keys(n)) {
+              const v = n[key];
+              if (Array.isArray(v)) v.forEach(collect2);
+              else if (v && typeof v.type === "string") collect2(v);
+            }
+          };
+          collect2(parent.node.test);
+          let latched = false;
+          const check = (inner) => {
+            const target = inner.node.left ?? inner.node.argument;
+            if (target?.type === "Identifier" && guards.has(target.name)) latched = true;
+          };
+          if (typeof node.traverse === "function") {
+            node.traverse({ AssignmentExpression: check, UpdateExpression: check });
+          }
+          if (latched) return true;
         }
+        node = parent;
       }
-    });
+      return false;
+    };
+    const onCall = (p) => {
+      if (!isStateSetterCall(p.node.callee, reactSetters)) return;
+      f.setStateInHot.push({
+        line: cbNode.loc?.start.line ?? 0,
+        ctx,
+        fromRaf,
+        gated: isTerminal(p) || isLatched(p)
+      });
+    };
+    traverse(file, { CallExpression: onCall, OptionalCallExpression: onCall });
   };
   const containsStateSetter = (cbNode) => {
     const file = asProgram(cbNode);
     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;
@@ -210,7 +294,13 @@ function collect(ast, traverse) {
     f.frameCallbacks.push({ line, lane, via });
     const cb = resolveFunction(argPaths[1]);
     if (!cb) return;
-    scanHotCallback(cb, lane ? `a \`${via}("${lane}")\` frame callback` : `a \`${via}\` frame callback`, false);
+    const unsubName = unsubscribeBinding(p);
+    scanHotCallback(
+      cb,
+      lane ? `a \`${via}("${lane}")\` frame callback` : `a \`${via}\` frame callback`,
+      false,
+      unsubName
+    );
     if (lane === "input" || lane === "update" || lane === "render") scanLaneDiscipline(cb, lane, via);
   };
   const handleCall = (p) => {
@@ -237,7 +327,9 @@ function collect(ast, traverse) {
         f.hasClearInterval = true;
         break;
       case "addEventListener": {
-        f.addEventListener.push(line);
+        const evNode = node.arguments?.[0];
+        const evName = evNode?.type === "StringLiteral" ? evNode.value : null;
+        if (!evName || !CONTEXT_EVENTS.has(evName)) f.addEventListener.push(line);
         const ev = node.arguments?.[0];
         if (ev?.type === "StringLiteral" && HOT_EVENTS.has(ev.value)) {
           scanHotCallback(resolveFunction(argPaths[1]), `a "${ev.value}" listener`, false);
@@ -256,6 +348,13 @@ function collect(ast, traverse) {
       case "matchMedia":
         f.hasReducedMotionGuard = true;
         break;
+      case "getContext": {
+        const kind = node.arguments?.[0];
+        if (kind?.type === "StringLiteral" && /^(webgl2?|experimental-webgl)$/.test(kind.value)) {
+          f.rawGlContexts.push(line);
+        }
+        break;
+      }
       case "kill":
       case "revert":
         f.hasGsapCleanup = true;
@@ -265,7 +364,7 @@ function collect(ast, traverse) {
         break;
       case "subscribe":
       case "retain": {
-        const accessor = accessorName(node.callee);
+        const accessor = accessorName(typeof p.get === "function" ? p.get("callee") : node.callee);
         if (!accessor || !VV_ACCESSORS.has(accessor)) break;
         if (name === "subscribe" && accessor === "getConductor") {
           recordFrameCallback(p, argPaths, "getConductor().subscribe");
@@ -312,7 +411,9 @@ function collect(ast, traverse) {
       const v = p.node.value;
       if (v.includes("prefers-reduced-motion")) f.hasReducedMotionGuard = true;
       if (v === "webglcontextlost" || v === "webglcontextrestored") f.handlesContextLoss = true;
-      if (/\binfinite\b/.test(v)) f.looping.push({ line: p.node.loc?.start.line ?? 0, kind: "CSS `infinite` animation" });
+      if (/\binfinite\b/.test(v) && /\b\d+(?:\.\d+)?m?s\b/.test(v)) {
+        f.looping.push({ line: p.node.loc?.start.line ?? 0, kind: "CSS `infinite` animation" });
+      }
       if (/\btransition\b|\banimation\b/.test(v) && /\btransform\b|\ball\b/.test(v)) {
         f.transformAuthorities.push({ line: p.node.loc?.start.line ?? 0, source: "a CSS transition/animation" });
       }
@@ -484,7 +585,7 @@ function checkMissingCleanup(f, file) {
   return out;
 }
 function checkSetStatePerFrame(f, file) {
-  const hot = f.setStateInHot.filter((s) => !s.fromRaf || isRafLoop(f));
+  const hot = f.setStateInHot.filter((s) => (!s.fromRaf || isRafLoop(f)) && !s.gated);
   if (hot.length === 0) return [];
   const zeroReRender = f.vvHooks.find((v) => v.hook.runtime.reRendersPerFrame === 0);
   const first = hot[0];
@@ -568,7 +669,9 @@ function checkRenderQualityProps(f, file) {
   return out;
 }
 function checkContextLoss(f, file) {
-  if (!f.usesR3F || f.canvases.length === 0) return [];
+  const r3fCanvas = f.usesR3F && f.canvases.length > 0;
+  const rawContext = f.rawGlContexts.length > 0;
+  if (!r3fCanvas && !rawContext) return [];
   const handled = f.handlesContextLoss || f.vvImports.has("useRenderQuality") || f.vvImports.has("getRendererHealth");
   if (handled) return [];
   return [
@@ -576,15 +679,16 @@ function checkContextLoss(f, file) {
       rule: "webgl-context-loss",
       severity: "warning",
       file,
-      line: f.canvases[0].line,
+      line: r3fCanvas ? f.canvases[0].line : f.rawGlContexts[0],
       message: "Nothing in this file notices a lost graphics context. When the browser takes one away the canvas goes black permanently and nothing is logged, so it reads as a rendering bug rather than a recoverable event.",
-      fix: "Spread `useRenderQuality`'s props onto the canvas and key it on a scene gate's `generation` \u2014 the `onCreated` it returns attaches the listener and reports the loss, and the moving key rebuilds the tree against a fresh context. Failing that, attach a `webglcontextlost` listener that calls `preventDefault()` (without it some drivers refuse a replacement context outright) and report to `getRendererHealth()`.",
+      fix: (r3fCanvas ? "Spread `useRenderQuality`'s props onto the canvas and key it on a scene gate's `generation` \u2014 the `onCreated` it returns attaches the listener and reports the loss, and the moving key rebuilds the tree against a fresh context. Failing that, attach a " : "You created this context by hand, so the adapter does not apply. Attach a ") + "`webglcontextlost` listener that calls `preventDefault()` (without it some drivers refuse a replacement context outright) and report to `getRendererHealth()`.",
       nudge: 'Call `get_pattern("lazy-3d-section")` for the whole wiring.'
     }
   ];
 }
 function checkHandRolledGate(f, file) {
-  if (!f.usesR3F || f.canvases.length === 0) return [];
+  const ownsGpu = f.usesR3F && f.canvases.length > 0 || f.rawGlContexts.length > 0;
+  if (!ownsGpu) return [];
   if (f.gatingObserver.length === 0 || f.vvImports.has("useSceneGate")) return [];
   return [
     {
@@ -871,7 +975,7 @@ function formatPlan({ building, using }) {
 }
 
 // src/mcp/server.ts
-var VERSION = true ? "2.4.0" : "0.0.0-dev";
+var VERSION = true ? "2.5.0" : "0.0.0-dev";
 function text(body) {
   return { content: [{ type: "text", text: body }] };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vectorvesper",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "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",