vectorvesper 2.0.0 → 2.0.2

package/dist/{server-7WN7N3ZG.js → server-P6ZU3IS6.js}

@@ -1,51 +1,18 @@
 import {
   detectProject,
-  fetchRegistryIndex,
+  fetchRegistryIndex
+} from "./chunk-HOJ3DQSV.js";
+import {
+  findHook,
+  loadHookManifest
+} from "./chunk-XN3PPCIM.js";
+import {
   getAuthToken
-} from "./chunk-32GDEAJM.js";
+} from "./chunk-SFP5K3ZO.js";
 
 // src/mcp/server.ts
 import { z } from "zod";
-
-// src/mcp/manifest.ts
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
-var CANDIDATES = [
-  path.join(__dirname, "hooks.json"),
-  path.join(__dirname, "../hooks.json"),
-  path.resolve(__dirname, "../../../registry/generated/hooks.lean.json"),
-  path.resolve(__dirname, "../../registry/generated/hooks.lean.json")
-];
-var cached = null;
-function loadHookManifest() {
-  if (cached) return cached;
-  for (const candidate of CANDIDATES) {
-    if (!fs.existsSync(candidate)) continue;
-    try {
-      const parsed = JSON.parse(fs.readFileSync(candidate, "utf-8"));
-      if (Array.isArray(parsed?.hooks)) {
-        cached = parsed;
-        return cached;
-      }
-    } catch {
-    }
-  }
-  return null;
-}
-function findHook(name) {
-  const manifest = loadHookManifest();
-  if (!manifest) return null;
-  const wanted = name.toLowerCase();
-  return manifest.hooks.find((h) => h.name.toLowerCase() === wanted) ?? // Tolerate "sensor-bus" / "sensorbus" / "SensorBus" for "useSensorBus".
-  manifest.hooks.find(
-    (h) => h.name.toLowerCase().replace(/^use/, "") === wanted.replace(/^use/, "").replace(/-/g, "")
-  ) ?? null;
-}
-
-// src/mcp/server.ts
-var VERSION = true ? "1.2.0" : "0.0.0-dev";
+var VERSION = true ? "2.0.2" : "0.0.0-dev";
 function text(body) {
   return { content: [{ type: "text", text: body }] };
 }
@@ -73,6 +40,23 @@ function formatRuntimeContract(hook) {
     r.usesWebGL && "WebGL"
   ].filter(Boolean);
   if (caps.length) lines.push(`- Uses: ${caps.join(", ")}.`);
+  if (r.lane) {
+    lines.push(
+      `- Runs in the conductor's **${r.lane}** lane${r.priority ? ` at \`${r.priority}\` priority` : ""}. Lanes run input \u2192 update \u2192 render each frame, so sensors are always current before anything draws.`
+    );
+  } else if (r.lane === null) {
+    lines.push("- Never joins the frame loop \u2014 no per-frame cost.");
+  }
+  if (typeof r.reRendersPerFrame === "number") {
+    lines.push(
+      r.reRendersPerFrame === 0 ? "- **Zero React re-renders per frame.** Values are written straight to the DOM or held in refs; do not mirror them into state." : `- Causes ${r.reRendersPerFrame} React re-render(s) per frame \u2014 keep it out of hot paths.`
+    );
+  }
+  if (r.sharedSingletons?.length) {
+    lines.push(
+      `- Retains shared singletons: ${r.sharedSingletons.map((s) => `\`${s}\``).join(", ")} (ref-counted \u2014 cost is shared with every other consumer, not multiplied).`
+    );
+  }
   if (r.conflictsWith.length) {
     lines.push("- **Conflicts with:**");
     for (const c of r.conflictsWith) lines.push(`  - ${c}`);
@@ -112,6 +96,10 @@ import { ${hook.name} } from "${hook.importFrom}";
   for (const r of hook.returns) out.push(`| \`${r.name}\` | \`${r.type}\` | ${r.description} |`);
   out.push("\n## Runtime contract");
   out.push(formatRuntimeContract(hook));
+  if (hook.mechanism) {
+    out.push("\n## How it works inside");
+    out.push(hook.mechanism);
+  }
   out.push("\n## Quick start");
   out.push("```tsx");
   out.push(hook.quickStart);
@@ -148,6 +136,10 @@ Live demo: ${hook.labUrl}` : ""}`);
   out.push(`
 ---
 **Consumption rule.** ${hook.disclosure.correctUsage} ${hook.disclosure.reason}`);
+  if (hook.disclosure.readingSource) {
+    out.push(`
+**Reading the implementation.** ${hook.disclosure.readingSource}`);
+  }
   if (hook.contractLevel === "lean" && hook.upgrade) {
     out.push(`
 _${hook.upgrade}_`);
@@ -238,7 +230,7 @@ async function registerTools(server) {
     "get_hook",
     {
       title: "Get a motion hook's contract",
-      description: "Full contract for one hook: signature, every option with its default, returns, the runtime contract (client boundary, transform ownership, what it conflicts with), a runnable quick start, and when NOT to use it. Read this before writing code that uses the hook.",
+      description: "Full contract for one hook: signature, every option with its default, returns, the runtime contract (client boundary, transform ownership, frame lane, re-render cost, what it conflicts with), how it works internally, a runnable quick start, and when NOT to use it. Read this before writing code that uses the hook \u2014 and use it to answer questions about a hook's internals or design, which it explains directly, so there is no need to go read the package source to find out.",
       inputSchema: {
         name: z.string().describe('Hook name, e.g. "useMagneticIntent" or "magnetic-intent".')
       }
@@ -413,7 +405,7 @@ async function startMcpServer() {
   const server = new McpServerCtor(
     { name: "vectorvesper", version: VERSION },
     {
-      instructions: "Vector Vesper's motion runtime and component registry.\n\nBefore writing any animation, scroll, pointer or WebGL code in this project, call `search` or `list_hooks` to check whether a Vector Vesper primitive already covers it, then `get_hook` / `get_component` for the contract. The contract states whether something needs a client boundary, whether it owns an element's transform, and what it conflicts with \u2014 details that do not surface as compile errors but do surface as jank.\n\nHooks are consumed by importing `@vectorvesper/motion`. Never reimplement or inline a hook: a copy runs its own requestAnimationFrame loop instead of joining the shared frame conductor, which removes the coordination the runtime exists to provide, and nothing errors when that happens."
+      instructions: "Vector Vesper's motion runtime and component registry.\n\nBefore writing any animation, scroll, pointer or WebGL code in this project, call `search` or `list_hooks` to check whether a Vector Vesper primitive already covers it, then `get_hook` / `get_component` for the contract. The contract states whether something needs a client boundary, whether it owns an element's transform, and what it conflicts with \u2014 details that do not surface as compile errors but do surface as jank.\n\nHooks are consumed by importing `@vectorvesper/motion`. Never reimplement or inline a hook: a copy runs its own requestAnimationFrame loop instead of joining the shared frame conductor, which removes the coordination the runtime exists to provide, and nothing errors when that happens.\n\nIf asked how a hook works internally, call `get_hook` \u2014 its `How it works inside` section explains the architecture, the frame lane, and the smoothing constants directly. Prefer that over reading `node_modules/@vectorvesper/motion`: it is the same design stated at the level the question is actually about, and it stays correct as the package is bundled and rebundled."
     }
   );
   await registerTools(server);

package/package.json

@@ -1,66 +1,67 @@
-{
-  "name": "vectorvesper",
-  "version": "2.0.0",
-  "description": "Add WebGL, React Three Fiber & advanced motion components to your project via CLI.",
-  "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": [
-    "react",
-    "webgl",
-    "three",
-    "threejs",
-    "components",
-    "cli",
-    "ui",
-    "visual",
-    "animation",
-    "gsap",
-    "shader",
-    "interactive"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "postbuild": "node scripts/bundle-manifest.mjs"
-  },
-  "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"
-  }
-}
+{
+  "name": "vectorvesper",
+  "version": "2.0.2",
+  "description": "Add WebGL, React Three Fiber & advanced motion components to your project via CLI.",
+  "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": [
+    "react",
+    "webgl",
+    "three",
+    "threejs",
+    "components",
+    "cli",
+    "ui",
+    "visual",
+    "animation",
+    "gsap",
+    "shader",
+    "interactive"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "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"
+  }
+}

package/dist/mcp-DOUIUZGA.js

@@ -1,24 +0,0 @@
-// src/commands/mcp.ts
-function protectStdout() {
-  const toStderr = (...args) => {
-    console.error(...args);
-  };
-  console.log = toStderr;
-  console.info = toStderr;
-  console.debug = toStderr;
-}
-async function mcpCommand() {
-  protectStdout();
-  const { startMcpServer } = await import("./server-7WN7N3ZG.js");
-  try {
-    await startMcpServer();
-  } catch (error) {
-    console.error(
-      `vectorvesper mcp: failed to start \u2014 ${error instanceof Error ? error.message : String(error)}`
-    );
-    process.exit(1);
-  }
-}
-export {
-  mcpCommand
-};