vectorvesper 2.0.3 → 2.0.4

package/package.json

@@ -1,67 +1,67 @@
-{
-  "name": "vectorvesper",
-  "version": "2.0.3",
-  "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"
-  }
-}
+{
+  "name": "vectorvesper",
+  "version": "2.0.4",
+  "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/server-KUQHVML2.js

@@ -1,416 +0,0 @@
-import {
-  detectProject,
-  fetchRegistryIndex
-} from "./chunk-5YSVDVLK.js";
-import {
-  findHook,
-  loadHookManifest
-} from "./chunk-XN3PPCIM.js";
-import {
-  getAuthToken
-} from "./chunk-SFP5K3ZO.js";
-
-// src/mcp/server.ts
-import { z } from "zod";
-var VERSION = true ? "2.0.3" : "0.0.0-dev";
-function text(body) {
-  return { content: [{ type: "text", text: body }] };
-}
-function formatHookSummary(hook) {
-  return `**${hook.name}** (${hook.category}) \u2014 ${hook.tagline}
-  Problem: ${hook.problem}`;
-}
-function formatRuntimeContract(hook) {
-  const r = hook.runtime;
-  const lines = [];
-  lines.push(
-    r.requiresClient ? '- **Client only.** Needs `"use client"`. On Next.js App Router, a parent server component must not render it directly.' : "- Runs anywhere (no browser-only APIs at module scope)."
-  );
-  if (r.ownsTransform) {
-    lines.push(
-      "- **Owns the element's inline `transform`.** Give it its own element; do not also animate that node's transform with CSS, framer-motion or GSAP."
-    );
-  }
-  lines.push(
-    r.respectsReducedMotion ? "- Honours `prefers-reduced-motion` automatically \u2014 no extra work needed." : "- Does **not** self-disable under `prefers-reduced-motion`; gate it yourself if it drives autonomous motion."
-  );
-  const caps = [
-    r.usesPointer && "pointer",
-    r.usesScroll && "scroll",
-    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}`);
-  }
-  return lines.join("\n");
-}
-function formatHookDetail(hook) {
-  const out = [];
-  out.push(`# ${hook.name}`);
-  out.push(`> ${hook.tagline}`);
-  out.push("");
-  out.push(`**The problem it removes:** ${hook.problem}`);
-  out.push("");
-  out.push(hook.summary);
-  out.push("");
-  out.push(`## Import
-\`\`\`ts
-import { ${hook.name} } from "${hook.importFrom}";
-\`\`\``);
-  out.push(`Install with \`npm i ${hook.packageName}\`. Available since v${hook.since}.`);
-  out.push("");
-  out.push(`## Signature
-\`${hook.signature}\``);
-  if (hook.options.length) {
-    out.push("\n### Options");
-    out.push("| Option | Type | Default | Description |");
-    out.push("| --- | --- | --- | --- |");
-    for (const o of hook.options) {
-      out.push(`| \`${o.name}\`${o.required ? " *(required)*" : ""} | \`${o.type}\` | \`${o.default}\` | ${o.description} |`);
-    }
-  } else {
-    out.push("\n### Options\nNone \u2014 this hook takes no arguments.");
-  }
-  out.push("\n### Returns");
-  out.push("| Field | Type | Description |");
-  out.push("| --- | --- | --- |");
-  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);
-  out.push("```");
-  if (hook.recipes?.length) {
-    out.push("\n## Recipes");
-    for (const r of hook.recipes) {
-      out.push(`
-### ${r.name}
-${r.blurb}
-
-\`\`\`tsx
-${r.code}
-\`\`\``);
-    }
-  }
-  if (hook.dos?.length) out.push(`
-## Do
-${hook.dos.map((d) => `- ${d}`).join("\n")}`);
-  if (hook.donts?.length) out.push(`
-## Don't
-${hook.donts.map((d) => `- ${d}`).join("\n")}`);
-  out.push("\n## When NOT to use this");
-  for (const w of hook.whenNotToUse) out.push(`- **${w.when}** \u2192 ${w.instead}`);
-  if (hook.guardrails?.length) {
-    out.push(`
-## Required reading before writing motion code
-${hook.guardrails.map((g) => `- ${g}`).join("\n")}`);
-  }
-  out.push(`
-## Docs
-${hook.docsUrl}${hook.labUrl ? `
-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}_`);
-  }
-  return out.join("\n");
-}
-function formatComponentDetail(c) {
-  const out = [];
-  out.push(`# ${c.title} \`${c.slug}\``);
-  out.push(`> ${c.description}`);
-  out.push("");
-  out.push(`**Tier:** ${c.tier}${c.tier === "pro" ? " \u2014 requires a Vector Vesper membership" : ""}`);
-  out.push(`**Category:** ${c.category} \xB7 **Type:** ${c.type} \xB7 **Version:** ${c.version}`);
-  out.push(`**Frameworks:** ${c.frameworks.join(", ")}`);
-  out.push("\n## Motion contract");
-  const lines = [];
-  lines.push(
-    c.requiresClient ? '- **Client only.** Needs `"use client"`.' : "- No client boundary required."
-  );
-  if (c.usesWebGL) {
-    lines.push(
-      "- **Uses WebGL.** On Next.js, render it through `dynamic(() => import(...), { ssr: false })` or it will fail during server rendering."
-    );
-  }
-  lines.push(
-    c.supportsReducedMotion ? "- Respects `prefers-reduced-motion`." : "- Does **not** self-disable under `prefers-reduced-motion`."
-  );
-  const caps = [c.usesPointer && "pointer", c.usesScroll && "scroll"].filter(Boolean);
-  if (caps.length) lines.push(`- Uses: ${caps.join(", ")}.`);
-  if (c.usesTailwind) lines.push("- Ships hardcoded Tailwind classes \u2014 the project needs Tailwind configured.");
-  if (c.fallbacks?.length) lines.push(`- Fallbacks: ${c.fallbacks.join(", ")}`);
-  out.push(lines.join("\n"));
-  if (c.dependencies.length || c.registryDependencies.length) {
-    out.push("\n## Dependencies");
-    if (c.dependencies.length) out.push(`- npm: ${c.dependencies.map((d) => `\`${d}\``).join(", ")}`);
-    if (c.registryDependencies.length) {
-      out.push(`- other VV components: ${c.registryDependencies.map((d) => `\`${d}\``).join(", ")} (installed automatically)`);
-    }
-  }
-  out.push(`
-## Install
-\`\`\`bash
-npx vectorvesper add ${c.slug}
-\`\`\``);
-  if (c.tier === "pro") {
-    out.push(
-      "Requires an authenticated CLI: `npx vectorvesper login <token>`. Tokens come from https://vectorvesper.dev/account."
-    );
-  }
-  if (c.docsUrl) out.push(`
-## Docs
-${c.docsUrl}`);
-  out.push(
-    "\n---\n**Note.** Component source is delivered by running the install command above, which writes the files into the project. It is deliberately not returned here \u2014 pasting a component out of a discovery response skips dependency resolution, the TypeScript/JavaScript transpile step, and the install manifest that makes `update` and `remove` work later."
-  );
-  return out.join("\n");
-}
-async function registerTools(server) {
-  server.registerTool(
-    "list_hooks",
-    {
-      title: "List motion hooks",
-      description: "List every React hook in the @vectorvesper/motion runtime, with the problem each one solves. Start here when deciding which primitive fits a motion task.",
-      inputSchema: {
-        category: z.enum(["sensor", "governor", "gate", "interaction", "media", "effect"]).optional().describe("Filter to one category.")
-      }
-    },
-    async ({ category }) => {
-      const manifest = loadHookManifest();
-      if (!manifest) {
-        return text(
-          "Hook manifest unavailable \u2014 this CLI build is missing dist/hooks.json. Reinstall with `npm i -g vectorvesper@latest`."
-        );
-      }
-      const hooks = category ? manifest.hooks.filter((h) => h.category === category) : manifest.hooks;
-      if (!hooks.length) return text(`No hooks in category "${category}".`);
-      const body = [
-        `${hooks.length} hook${hooks.length === 1 ? "" : "s"} in @vectorvesper/motion v${manifest.engineVersion}`,
-        "",
-        ...hooks.map(formatHookSummary),
-        "",
-        "Call `get_hook` for the full contract of any of these before writing code with it."
-      ].join("\n");
-      return text(body);
-    }
-  );
-  server.registerTool(
-    "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, 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".')
-      }
-    },
-    async ({ name }) => {
-      const hook = findHook(name);
-      if (!hook) {
-        const manifest = loadHookManifest();
-        const available = manifest?.hooks.map((h) => h.name).join(", ") ?? "none loaded";
-        return text(`No hook named "${name}". Available: ${available}`);
-      }
-      return text(formatHookDetail(hook));
-    }
-  );
-  server.registerTool(
-    "list_components",
-    {
-      title: "List Vector Vesper components",
-      description: "List installable components from the Vector Vesper registry, with tier and category. Free components install for anyone; Pro components need a membership.",
-      inputSchema: {
-        tier: z.enum(["free", "pro"]).optional().describe("Filter by tier."),
-        category: z.string().optional().describe("Filter by category.")
-      }
-    },
-    async ({ tier, category }) => {
-      let index;
-      try {
-        index = await fetchRegistryIndex();
-      } catch (error) {
-        return text(
-          `Could not reach the component registry: ${error instanceof Error ? error.message : String(error)}
-
-Hook discovery still works offline \u2014 try \`list_hooks\`.`
-        );
-      }
-      let components = index.components;
-      if (tier) components = components.filter((c) => c.tier === tier);
-      if (category) components = components.filter((c) => c.category === category);
-      if (!components.length) return text("No components matched that filter.");
-      const body = [
-        `${components.length} component${components.length === 1 ? "" : "s"} (registry v${index.version})`,
-        "",
-        ...components.map(
-          (c) => `**${c.slug}** [${c.tier}] ${c.category} \u2014 ${c.description}`
-        ),
-        "",
-        "Call `get_component` for a component's motion contract and wiring requirements before installing it."
-      ].join("\n");
-      return text(body);
-    }
-  );
-  server.registerTool(
-    "get_component",
-    {
-      title: "Get a component's motion contract",
-      description: "Metadata and wiring requirements for one component: whether it needs a client boundary, whether it needs dynamic import to survive SSR, what it depends on, and how to install it. Does not return source \u2014 source is written into the project by the install command.",
-      inputSchema: { slug: z.string().describe('Component slug, e.g. "code-rain".') }
-    },
-    async ({ slug }) => {
-      let index;
-      try {
-        index = await fetchRegistryIndex();
-      } catch (error) {
-        return text(
-          `Could not reach the component registry: ${error instanceof Error ? error.message : String(error)}`
-        );
-      }
-      const component = index.components.find((c) => c.slug === slug);
-      if (!component) {
-        return text(
-          `No component with slug "${slug}". Call \`list_components\` to see what exists.`
-        );
-      }
-      return text(formatComponentDetail(component));
-    }
-  );
-  server.registerTool(
-    "get_setup_guidance",
-    {
-      title: "Inspect the current project",
-      description: "Detect the framework, package manager, TypeScript/JavaScript, Tailwind and Next router of the project in the working directory, plus Vector Vesper auth status. Call this before generating install commands or import paths so they match the project.",
-      inputSchema: {
-        cwd: z.string().optional().describe("Project root. Defaults to the server's working directory.")
-      }
-    },
-    async ({ cwd }) => {
-      const info = detectProject(cwd ?? process.cwd());
-      const authed = Boolean(getAuthToken());
-      const out = [];
-      out.push("# Project");
-      out.push(`- Root: \`${info.rootPath}\``);
-      out.push(`- Framework: **${info.framework}**${info.nextRouter ? ` (${info.nextRouter} router)` : ""}`);
-      out.push(`- Language: **${info.isTypeScript ? "TypeScript" : "JavaScript"}**`);
-      out.push(`- Package manager: **${info.packageManager}**`);
-      out.push(`- Tailwind: ${info.hasTailwind ? "yes" : "no"}`);
-      out.push(`- \`src/\` directory: ${info.hasSrcDir ? "yes" : "no"}`);
-      out.push("\n# Vector Vesper");
-      out.push(`- CLI authenticated: ${authed ? "yes \u2014 Pro components available" : "no \u2014 free components only"}`);
-      if (!authed) {
-        out.push("  - To unlock Pro: `npx vectorvesper login <token>` (tokens at https://vectorvesper.dev/account)");
-      }
-      out.push("\n# What this implies");
-      if (info.framework === "next" && info.nextRouter === "app") {
-        out.push(
-          '- App Router: any component or hook marked **client only** needs `"use client"` at the top of the file that uses it.'
-        );
-        out.push(
-          "- Anything using WebGL should be rendered via `dynamic(() => import(...), { ssr: false })`."
-        );
-      }
-      if (!info.hasTailwind) {
-        out.push("- No Tailwind detected: components that ship Tailwind classes will render unstyled.");
-      }
-      out.push("- Run `npx vectorvesper init` first if `vv.config.json` does not exist yet.");
-      return text(out.join("\n"));
-    }
-  );
-  server.registerTool(
-    "search",
-    {
-      title: "Search hooks and components",
-      description: 'Keyword search across both motion hooks and installable components. Use this when you know the effect you want ("magnetic button", "scroll video", "lazy 3d scene") but not which primitive provides it.',
-      inputSchema: { query: z.string().describe("What you are trying to build.") }
-    },
-    async ({ query }) => {
-      const q = query.toLowerCase();
-      const terms = q.split(/\s+/).filter((t) => t.length > 2);
-      const score = (haystack) => {
-        const h = haystack.toLowerCase();
-        if (h.includes(q)) return 100;
-        return terms.reduce((n, t) => n + (h.includes(t) ? 1 : 0), 0);
-      };
-      const results = [];
-      const manifest = loadHookManifest();
-      for (const h of manifest?.hooks ?? []) {
-        const s = score([h.name, h.tagline, h.problem, h.summary, h.category].join(" "));
-        if (s > 0) results.push({ score: s, line: `**hook** \`${h.name}\` \u2014 ${h.tagline}` });
-      }
-      try {
-        const index = await fetchRegistryIndex();
-        for (const c of index.components) {
-          const s = score([c.slug, c.title, c.description, c.category, c.type].join(" "));
-          if (s > 0) {
-            results.push({ score: s, line: `**component** \`${c.slug}\` [${c.tier}] \u2014 ${c.description}` });
-          }
-        }
-      } catch {
-      }
-      if (!results.length) {
-        return text(
-          `Nothing matched "${query}". Try \`list_hooks\` or \`list_components\` to browse everything.`
-        );
-      }
-      results.sort((a, b) => b.score - a.score);
-      return text(
-        [
-          `${results.length} result${results.length === 1 ? "" : "s"} for "${query}"`,
-          "",
-          ...results.slice(0, 12).map((r) => r.line),
-          "",
-          "Then call `get_hook` or `get_component` for the full contract before writing code."
-        ].join("\n")
-      );
-    }
-  );
-}
-async function startMcpServer() {
-  const [{ McpServer: McpServerCtor }, { StdioServerTransport }] = await Promise.all([
-    import("@modelcontextprotocol/sdk/server/mcp.js"),
-    import("@modelcontextprotocol/sdk/server/stdio.js")
-  ]);
-  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.\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);
-  await server.connect(new StdioServerTransport());
-}
-export {
-  startMcpServer
-};