vectorvesper 2.4.1 → 2.6.0

package/README.md

@@ -1,113 +1,113 @@
-<!--
-  BANNER: host a wide image (≈1280×640) at an ABSOLUTE url — relative paths do
-  NOT render on npmjs.com — then uncomment this block:
-
-  <p align="center">
-    <a href="https://vectorvesper.dev">
-      <img src="https://vectorvesper.dev/banner.png" alt="Vector Vesper" width="100%" />
-    </a>
-  </p>
--->
-
-<h1 align="center">Vector Vesper</h1>
-
-<p align="center">
-  Production-grade WebGL, 3D, and motion components for React. Copy directly into your codebase and own the code.
-</p>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/vectorvesper"><img src="https://img.shields.io/npm/v/vectorvesper?color=7EACB5&label=npm" alt="npm version" /></a>
-  <a href="https://github.com/vectorvesper/vv-components/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vectorvesper/vv-components?color=7EACB5&label=license" alt="license" /></a>
-  <a href="https://vectorvesper.dev"><img src="https://img.shields.io/badge/docs-vectorvesper.dev-7EACB5" alt="docs" /></a>
-</p>
-
----
-
-> Vector Vesper is a CLI you run with `npx`, not a package you install. Start with `npx vectorvesper init` below.
-
-**Vector Vesper** is a motion toolkit for React consisting of 3D animations, shaders, and advanced motion components. 
-
-The CLI writes the component code directly into your repository. You have full control over the math, the shaders, and the styles.
-
-## Quick Start
-
-```bash
-# Initialize project configuration
-npx vectorvesper init
-
-# Add a visual component
-npx vectorvesper add video-card
-```
-
-The CLI auto-detects your workspace, installs required animation dependencies (such as `three`, `@react-three/fiber`, or `gsap`), and writes the code to `@/components/vv/`.
-
-```tsx
-import { VideoCard } from "@/components/vv/video-card";
-
-export default function Page() {
-  return (
-    <div className="h-screen w-full">
-      <VideoCard src="/clip.mp4" />
-    </div>
-  );
-}
-```
-
-## 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 |
-| --- | --- |
-| `init` | Detect project setup and write `vv.config.json` |
-| `add <slug>` | Add a component and auto-install its dependencies |
-| `list` | List all available components in the registry |
-| `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.
-
-## Links
-
-* **Documentation & Guides:** [vectorvesper.dev/docs](https://vectorvesper.dev/docs)
-* **Visual Component Catalog:** [vectorvesper.dev/components](https://vectorvesper.dev/components)
-* **GitHub Repository:** [github.com/vectorvesper/vv-components](https://github.com/vectorvesper/vv-components)
-* **Report Issues:** [github.com/vectorvesper/vv-components/issues](https://github.com/vectorvesper/vv-components/issues)
-
----
-
-Licensed under the MIT License for open-source components. Premium/commercial components are subject to the Vector Vesper terms of service.
+<!--
+  BANNER: host a wide image (≈1280×640) at an ABSOLUTE url — relative paths do
+  NOT render on npmjs.com — then uncomment this block:
+
+  <p align="center">
+    <a href="https://vectorvesper.dev">
+      <img src="https://vectorvesper.dev/banner.png" alt="Vector Vesper" width="100%" />
+    </a>
+  </p>
+-->
+
+<h1 align="center">Vector Vesper</h1>
+
+<p align="center">
+  Production-grade WebGL, 3D, and motion components for React. Copy directly into your codebase and own the code.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/vectorvesper"><img src="https://img.shields.io/npm/v/vectorvesper?color=7EACB5&label=npm" alt="npm version" /></a>
+  <a href="https://github.com/vectorvesper/vv-components/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vectorvesper/vv-components?color=7EACB5&label=license" alt="license" /></a>
+  <a href="https://vectorvesper.dev"><img src="https://img.shields.io/badge/docs-vectorvesper.dev-7EACB5" alt="docs" /></a>
+</p>
+
+---
+
+> Vector Vesper is a CLI you run with `npx`, not a package you install. Start with `npx vectorvesper init` below.
+
+**Vector Vesper** is a motion toolkit for React consisting of 3D animations, shaders, and advanced motion components. 
+
+The CLI writes the component code directly into your repository. You have full control over the math, the shaders, and the styles.
+
+## Quick Start
+
+```bash
+# Initialize project configuration
+npx vectorvesper init
+
+# Add a visual component
+npx vectorvesper add video-card
+```
+
+The CLI auto-detects your workspace, installs required animation dependencies (such as `three`, `@react-three/fiber`, or `gsap`), and writes the code to `@/components/vv/`.
+
+```tsx
+import { VideoCard } from "@/components/vv/video-card";
+
+export default function Page() {
+  return (
+    <div className="h-screen w-full">
+      <VideoCard src="/clip.mp4" />
+    </div>
+  );
+}
+```
+
+## 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 |
+| --- | --- |
+| `init` | Detect project setup and write `vv.config.json` |
+| `add <slug>` | Add a component and auto-install its dependencies |
+| `list` | List all available components in the registry |
+| `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.
+
+## Links
+
+* **Documentation & Guides:** [vectorvesper.dev/docs](https://vectorvesper.dev/docs)
+* **Visual Component Catalog:** [vectorvesper.dev/components](https://vectorvesper.dev/components)
+* **GitHub Repository:** [github.com/vectorvesper/vv-components](https://github.com/vectorvesper/vv-components)
+* **Report Issues:** [github.com/vectorvesper/vv-components/issues](https://github.com/vectorvesper/vv-components/issues)
+
+---
+
+Licensed under the MIT License for open-source components. Premium/commercial components are subject to the Vector Vesper terms of service.

package/dist/{chunk-5YSVDVLK.js → chunk-BI3LEGXE.js}

@@ -4,7 +4,7 @@ import {
   getAuthToken,
   logger,
   validateSlug
-} from "./chunk-SFP5K3ZO.js";
+} from "./chunk-ZFHVMCR6.js";
 
 // src/utils/project.ts
 import fs from "fs";

package/dist/{chunk-SFP5K3ZO.js → chunk-ZFHVMCR6.js}

@@ -130,7 +130,7 @@ var VVConfigSchema = z.object({
   })
 });
 var VVGlobalConfigSchema = z.object({
-  // Auth — license key for paid components
+  // Auth — access token for paid components
   auth: z.object({
     token: z.string().optional(),
     email: z.string().optional(),

package/dist/hooks.json

@@ -1,7 +1,7 @@
 {
   "version": "1.0.0",
-  "engineVersion": "4.0.0",
-  "generatedAt": "2026-08-28T08:18:25.103Z",
+  "engineVersion": "4.0.1",
+  "generatedAt": "2026-09-02T08:50:45.096Z",
   "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

@@ -3,7 +3,7 @@ import {
   detectProject,
   fetchComponent,
   fetchRegistryIndex
-} from "./chunk-5YSVDVLK.js";
+} from "./chunk-BI3LEGXE.js";
 import {
   getAuthToken,
   getGlobalConfigPath,
@@ -15,7 +15,7 @@ import {
   setVerbose,
   validateSlug,
   writeConfig
-} from "./chunk-SFP5K3ZO.js";
+} from "./chunk-ZFHVMCR6.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -295,7 +295,7 @@ async function listCommand() {
     console.log(`
   ${pc2.green(String(freeCount))} free components${proCount > 0 ? ` \xB7 ${pc2.magenta(String(proCount))} pro components` : ""}`);
     if (proCount > 0 && !hasAuth) {
-      console.log(`  \u{1F511} ${pc2.dim("Unlock pro components:")} ${pc2.cyan("npx vectorvesper login <key>")} ${pc2.dim("\xB7")} ${pc2.cyan("https://vectorvesper.dev/pricing")}`);
+      console.log(`  \u{1F511} ${pc2.dim("Unlock pro components:")} ${pc2.cyan("npx vectorvesper login <token>")} ${pc2.dim("\xB7")} ${pc2.cyan("https://vectorvesper.dev/pricing")}`);
     }
     console.log(`
 \u{1F449} Run ${pc2.bold(pc2.cyan("npx vectorvesper add <slug>"))} to add a component to your project.
@@ -303,7 +303,8 @@ async function listCommand() {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     spinner.fail(pc2.red(`Failed to fetch components list: ${message}`));
-    process.exit(1);
+    process.exitCode = 1;
+    return;
   }
 }
 
@@ -758,7 +759,7 @@ async function addCommand(slug, options = {}) {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     spinner.fail(pc5.red(`Failed to resolve component "${slug}": ${message}`));
-    process.exit(1);
+    process.exitCode = 1;
     return;
   }
   let transpileWarnings = [];
@@ -780,7 +781,7 @@ async function addCommand(slug, options = {}) {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     spinner.fail(pc5.red(message));
-    process.exit(1);
+    process.exitCode = 1;
     return;
   }
   const filesToWrite = [];
@@ -856,7 +857,7 @@ async function addCommand(slug, options = {}) {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     spinner.fail(pc5.red(`Failed to write files: ${message}`));
-    process.exit(1);
+    process.exitCode = 1;
     return;
   }
   try {
@@ -1018,7 +1019,7 @@ async function updateCommand(slug, options = {}) {
   if (updatedComponents.length > 0) {
     await handleDependencies(updatedComponents, projectRoot, projectInfo, options);
   }
-  if (failed.length > 0) process.exit(1);
+  if (failed.length > 0) process.exitCode = 1;
 }
 
 // src/commands/remove.ts
@@ -1122,7 +1123,7 @@ Remove ${slug}
 import fs7 from "fs";
 import path7 from "path";
 import pc8 from "picocolors";
-var CLI_VERSION = true ? "2.4.1" : "0.0.0-dev";
+var CLI_VERSION = true ? "2.6.0" : "0.0.0-dev";
 async function infoCommand() {
   console.log(pc8.bold(pc8.cyan("\nVector Vesper Diagnostics\n")));
   const projectInfo = detectProject();
@@ -1255,7 +1256,8 @@ Component Diff: ${slug}`)));
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       spinner.fail(pc9.red(`Failed to fetch remote component details: ${message}`));
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
   } else {
     const spinner = ora4({
@@ -1320,7 +1322,8 @@ ${pc9.green("\u2714")} All components are up to date!
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       spinner.fail(pc9.red(`Failed to check updates: ${message}`));
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
   }
 }
@@ -1420,7 +1423,7 @@ async function whoamiCommand() {
 }
 
 // src/index.ts
-var version = true ? "2.4.1" : "0.0.0-dev";
+var version = true ? "2.6.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();
@@ -1449,20 +1452,20 @@ program.command("info").description("Show project diagnostics and list installed
 program.command("diff [slug]").description("Check for updates against the component registry").action(async (slug) => {
   await diffCommand(slug);
 });
-program.command("login <key>", { hidden: true }).description("Authenticate with a license key for pro components").action(async (key) => {
+program.command("login <token>").description("Authenticate with an access token for pro components").action(async (key) => {
   await loginCommand(key);
 });
-program.command("logout", { hidden: true }).description("Clear stored license credentials").action(async () => {
+program.command("logout").description("Clear the stored access token").action(async () => {
   await logoutCommand();
 });
-program.command("whoami", { hidden: true }).description("Show current authentication status").action(async () => {
+program.command("whoami").description("Show current authentication status").action(async () => {
   await whoamiCommand();
 });
 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-FP5FICSI.js");
+    const { mcpCommand } = await import("./mcp-BEM4TVKM.js");
     await mcpCommand(action, { ...options, client });
   }
 );

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

@@ -3,7 +3,7 @@ import {
 } from "./chunk-CPZKZO3A.js";
 import {
   getAuthToken
-} from "./chunk-SFP5K3ZO.js";
+} from "./chunk-ZFHVMCR6.js";
 
 // src/commands/mcp.ts
 import pc from "picocolors";
@@ -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.1" : "0.0.0-dev";
+var VERSION = true ? "2.6.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-AYBXJAAO.js");
+  const { startMcpServer } = await import("./server-CIFO3HSN.js");
   try {
     await startMcpServer();
   } catch (error) {

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

@@ -1,7 +1,7 @@
 import {
   detectProject,
   fetchRegistryIndex
-} from "./chunk-5YSVDVLK.js";
+} from "./chunk-BI3LEGXE.js";
 import {
   findHook,
   findPattern,
@@ -9,7 +9,7 @@ import {
 } from "./chunk-CPZKZO3A.js";
 import {
   getAuthToken
-} from "./chunk-SFP5K3ZO.js";
+} from "./chunk-ZFHVMCR6.js";
 
 // src/mcp/server.ts
 import { z } from "zod";
@@ -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",
@@ -84,10 +85,26 @@ function collectReactSetters(ast, traverse) {
   });
   return names;
 }
-function accessorName(callee) {
+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;
@@ -129,6 +146,7 @@ function collect(ast, traverse) {
     laneViolations: [],
     orphanSubscriptions: [],
     canvases: [],
+    rawGlContexts: [],
     handlesContextLoss: false,
     gatingObserver: []
   };
@@ -150,21 +168,72 @@ 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, reactSetters)) {
-          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, reactSetters)) {
-          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);
@@ -225,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) => {
@@ -252,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);
@@ -271,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;
@@ -280,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");
@@ -327,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" });
       }
@@ -499,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];
@@ -583,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 [
@@ -591,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 [
     {
@@ -886,7 +975,7 @@ function formatPlan({ building, using }) {
 }
 
 // src/mcp/server.ts
-var VERSION = true ? "2.4.1" : "0.0.0-dev";
+var VERSION = true ? "2.6.0" : "0.0.0-dev";
 function text(body) {
   return { content: [{ type: "text", text: body }] };
 }

package/package.json

@@ -1,81 +1,81 @@
-{
-  "name": "vectorvesper",
-  "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",
-  "bin": {
-    "vectorvesper": "dist/index.js",
-    "vv": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "package.json"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/vectorvesper/vv-components.git"
-  },
-  "bugs": {
-    "url": "https://github.com/vectorvesper/vv-components/issues"
-  },
-  "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",
-    "animation",
-    "motion",
-    "gsap",
-    "shader",
-    "interactive",
-    "performance",
-    "requestanimationframe"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:mcp": "node scripts/mcp-e2e/harness.mjs --local",
-    "test:mcp:published": "node scripts/mcp-e2e/harness.mjs",
-    "postbuild": "node scripts/bundle-manifest.mjs",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@babel/core": "^7.24.0",
-    "@babel/preset-typescript": "^7.24.0",
-    "@clack/prompts": "^0.7.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "commander": "^12.0.0",
-    "ora": "^8.0.1",
-    "picocolors": "^1.0.0",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@types/babel__core": "^7.20.5",
-    "@types/node": "^25.9.2",
-    "tsup": "^8.0.2",
-    "typescript": "^6.0.3",
-    "vitest": "^2.1.8"
-  },
-  "mcpName": "dev.vectorvesper/motion"
-}
+{
+  "name": "vectorvesper",
+  "version": "2.6.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",
+  "main": "./dist/index.js",
+  "bin": {
+    "vectorvesper": "dist/index.js",
+    "vv": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vectorvesper/vv-components.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vectorvesper/vv-components/issues"
+  },
+  "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",
+    "animation",
+    "motion",
+    "gsap",
+    "shader",
+    "interactive",
+    "performance",
+    "requestanimationframe"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:mcp": "node scripts/mcp-e2e/harness.mjs --local",
+    "test:mcp:published": "node scripts/mcp-e2e/harness.mjs",
+    "postbuild": "node scripts/bundle-manifest.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@babel/core": "^7.24.0",
+    "@babel/preset-typescript": "^7.24.0",
+    "@clack/prompts": "^0.7.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^12.0.0",
+    "ora": "^8.0.1",
+    "picocolors": "^1.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/babel__core": "^7.20.5",
+    "@types/node": "^25.9.2",
+    "tsup": "^8.0.2",
+    "typescript": "^6.0.3",
+    "vitest": "^2.1.8"
+  },
+  "mcpName": "dev.vectorvesper/motion"
+}