vectorvesper 0.2.0 → 0.3.0

package/dist/index.js

@@ -231,7 +231,7 @@ function loadConfig(cwd = process.cwd()) {
     raw = JSON.parse(content);
   } catch {
     throw new Error(
-      `Failed to parse vv.config.json \u2014 the file contains invalid JSON. Delete it and run "vv init" to regenerate.`
+      `Failed to parse vv.config.json \u2014 the file contains invalid JSON. Delete it and run "npx vectorvesper init" to regenerate.`
     );
   }
   const result = VVConfigSchema.safeParse(raw);
@@ -240,7 +240,7 @@ function loadConfig(cwd = process.cwd()) {
     throw new Error(
       `Invalid vv.config.json \u2014 schema validation failed:
 ${issues}
-Delete the file and run "vv init" to regenerate.`
+Delete the file and run "npx vectorvesper init" to regenerate.`
     );
   }
   return result.data;
@@ -398,7 +398,7 @@ async function initCommand(options = {}) {
   \u2022 Target directory created at ${pc2.cyan(targetLocalDir)}
   \u2022 Manifest created at ${pc2.cyan("vv-manifest.json")}
 
-  \u{1F449} Next, run: ${pc2.bold(pc2.cyan("vv add <slug>"))} to add a component.`
+  \u{1F449} Next, run: ${pc2.bold(pc2.cyan("npx vectorvesper add <slug>"))} to add a component.`
     );
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -427,25 +427,25 @@ function handleHttpError(status, url) {
     case 401:
       throw new Error(
         `Authentication required. This component requires a valid license key.
-\u{1F449} Run "vv login <your-license-key>" to authenticate.
+\u{1F449} Run "npx vectorvesper login <your-license-key>" to authenticate.
 \u{1F511} Get a license at https://vectorvesper.dev/pricing`
       );
     case 402:
       throw new Error(
         `This is a Pro component and requires a license.
 \u{1F449} Get lifetime access at https://vectorvesper.dev/pricing
-\u{1F4A1} Run "vv list" to see all free components.`
+\u{1F4A1} Run "npx vectorvesper list" to see all free components.`
       );
     case 403:
       throw new Error(
         `Access denied. Your license doesn't include this component.
 \u{1F449} Check your account at https://vectorvesper.dev/account
-\u{1F4A1} Run "vv whoami" to see your current access.`
+\u{1F4A1} Run "npx vectorvesper whoami" to see your current access.`
       );
     case 404:
       throw new Error(
         `Component not found in the registry.
-\u{1F449} Run "vv list" to see all available components.`
+\u{1F449} Run "npx vectorvesper list" to see all available components.`
       );
     case 429:
       throw new Error(
@@ -599,10 +599,10 @@ async function listCommand() {
     console.log(`
   ${pc3.green(String(freeCount))} free components${proCount > 0 ? ` \xB7 ${pc3.magenta(String(proCount))} pro components` : ""}`);
     if (proCount > 0 && !hasAuth) {
-      console.log(`  \u{1F511} ${pc3.dim("Unlock pro components:")} ${pc3.cyan("vv login <key>")} ${pc3.dim("\xB7")} ${pc3.cyan("https://vectorvesper.dev/pricing")}`);
+      console.log(`  \u{1F511} ${pc3.dim("Unlock pro components:")} ${pc3.cyan("npx vectorvesper login <key>")} ${pc3.dim("\xB7")} ${pc3.cyan("https://vectorvesper.dev/pricing")}`);
     }
     console.log(`
-\u{1F449} Run ${pc3.bold(pc3.cyan("vv add <slug>"))} to add a component to your project.
+\u{1F449} Run ${pc3.bold(pc3.cyan("npx vectorvesper add <slug>"))} to add a component to your project.
 `);
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -641,7 +641,7 @@ async function resolveComponentTree(slug) {
     if (component.tier === "pro" && !getAuthToken()) {
       throw new Error(
         `"${componentSlug}" is a Pro component and requires a license.
-\u{1F449} Run ${pc4.cyan("vv login <your-license-key>")} to unlock pro components.
+\u{1F449} Run ${pc4.cyan("npx vectorvesper login <your-license-key>")} to unlock pro components.
 \u{1F511} Get a license at ${pc4.cyan("https://vectorvesper.dev/pricing")}`
       );
     }
@@ -714,6 +714,37 @@ function recordInstall(components, installDir, projectRoot) {
   }
   writeManifest(projectRoot, manifest);
 }
+function findOrphanedFiles(components, installDir, projectRoot, previousManifest) {
+  const compDir = path5.join(projectRoot, installDir);
+  const currentTargets = /* @__PURE__ */ new Set();
+  for (const component of components) {
+    for (const file of component.files) currentTargets.add(file.target);
+  }
+  const orphans = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const component of components) {
+    const entry = previousManifest.components[component.slug];
+    if (!entry) continue;
+    for (const target of entry.files) {
+      if (currentTargets.has(target)) continue;
+      if (seen.has(target)) continue;
+      seen.add(target);
+      const absolutePath = path5.resolve(compDir, target);
+      const relativeFromRoot = path5.relative(projectRoot, absolutePath);
+      if (relativeFromRoot.startsWith("..") || path5.isAbsolute(relativeFromRoot)) continue;
+      if (!fs5.existsSync(absolutePath)) continue;
+      orphans.push({ absolutePath, relativePath: relativeFromRoot, target });
+    }
+  }
+  return orphans;
+}
+function removeFiles(files) {
+  for (const file of files) {
+    if (fs5.existsSync(file.absolutePath)) {
+      fs5.rmSync(file.absolutePath, { force: true });
+    }
+  }
+}
 
 // src/utils/install.ts
 import fs6 from "fs";
@@ -889,6 +920,39 @@ Installing dependencies with ${projectInfo.packageManager}...`));
     console.log(`  Run manually: ${pc6.bold(pc6.cyan(installCmd))}`);
   }
 }
+async function handlePrune(orphans, slug, options) {
+  if (orphans.length === 0) return;
+  const list = orphans.map((o) => `    ${pc6.dim("\u2022")} ${pc6.cyan(o.relativePath)}`).join("\n");
+  let shouldPrune = options.prune === true;
+  if (!shouldPrune) {
+    console.log(
+      pc6.yellow(
+        `
+\u{1F9F9} ${orphans.length} file(s) from a previous version of ${pc6.cyan(slug)} are no longer part of it:`
+      )
+    );
+    console.log(list);
+    if (options.yes) {
+      console.log(pc6.dim(`  Re-run with ${pc6.cyan("--prune")} to remove them.`));
+      return;
+    }
+    const answer = await confirm2({
+      message: "Remove these orphaned files?",
+      initialValue: true
+    });
+    if (isCancel2(answer) || !answer) {
+      console.log(pc6.dim(`  Left in place. Run with ${pc6.cyan("--prune")} later to remove them.`));
+      return;
+    }
+    shouldPrune = true;
+  }
+  removeFiles(orphans);
+  console.log(pc6.green(`
+\u{1F9F9} Removed ${orphans.length} orphaned file(s):`));
+  for (const o of orphans) {
+    console.log(`  ${pc6.red("\u2212")} ${pc6.cyan(o.relativePath)}`);
+  }
+}
 async function addCommand(slug, options = {}) {
   try {
     validateSlug(slug);
@@ -908,7 +972,7 @@ async function addCommand(slug, options = {}) {
   if (!config) {
     console.error(
       `${pc6.red(pc6.bold("Error:"))} No ${pc6.cyan("vv.config.json")} found in this directory.
-\u{1F449} Run ${pc6.bold(pc6.cyan("vv init"))} first to set up your project.`
+\u{1F449} Run ${pc6.bold(pc6.cyan("npx vectorvesper init"))} first to set up your project.`
     );
     process.exit(1);
     return;
@@ -959,6 +1023,13 @@ async function addCommand(slug, options = {}) {
   }
   const targetComponent = resolvedComponents[resolvedComponents.length - 1];
   const installPath = toForwardSlash(path7.join(componentInstallDir, targetComponent.slug));
+  let orphans = [];
+  try {
+    const previousManifest = readManifest(projectRoot);
+    orphans = findOrphanedFiles(resolvedComponents, componentInstallDir, projectRoot, previousManifest);
+  } catch {
+    orphans = [];
+  }
   if (options.dryRun) {
     spinner.succeed(pc6.yellow("Dry-run: simulation completed. No files were written."));
     console.log(pc6.bold(pc6.yellow("\n[Dry Run] Files that would be created/modified:")));
@@ -966,6 +1037,13 @@ async function addCommand(slug, options = {}) {
       const status = fs7.existsSync(file.absolutePath) ? pc6.yellow("(exists, would overwrite)") : pc6.green("(new)");
       console.log(`  ${pc6.cyan(file.relativePath)} ${status}`);
     }
+    if (orphans.length > 0) {
+      console.log(pc6.bold(pc6.yellow("\n[Dry Run] Orphaned files from a previous version:")));
+      for (const o of orphans) {
+        const note = options.prune ? pc6.red("(would remove)") : pc6.dim("(use --prune to remove)");
+        console.log(`  ${pc6.cyan(o.relativePath)} ${note}`);
+      }
+    }
     const missing = getMissingDependencies(resolvedComponents, projectRoot);
     if (missing.length > 0) {
       console.log(pc6.yellow(`
@@ -979,6 +1057,7 @@ async function addCommand(slug, options = {}) {
   }
   if (filesToWrite.length === 0) {
     spinner.succeed(pc6.green("All files skipped (already up to date)."));
+    await handlePrune(orphans, targetComponent.slug, options);
     return;
   }
   spinner.text = "Writing component files...";
@@ -995,13 +1074,14 @@ async function addCommand(slug, options = {}) {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     logger.warn(`Failed to update vv-manifest.json: ${message}`);
-    logger.warn("Component was installed but may not appear in 'vv info' or 'vv diff'.");
+    logger.warn("Component was installed but may not appear in 'npx vectorvesper info' or 'npx vectorvesper diff'.");
   }
   spinner.succeed(pc6.green("Files written successfully!"));
   console.log(pc6.dim("\nCreated files:"));
   for (const file of filesToWrite) {
     console.log(`  ${pc6.green("\u2714")} ${pc6.cyan(file.relativePath)}`);
   }
+  await handlePrune(orphans, targetComponent.slug, options);
   await handleDependencies(resolvedComponents, projectRoot, projectInfo, options);
   printGuidance(targetComponent, {
     alias: config.aliases.vv,
@@ -1033,7 +1113,7 @@ async function updateCommand(slug, options = {}) {
   if (!config) {
     console.error(
       `${pc7.red(pc7.bold("Error:"))} No ${pc7.cyan("vv.config.json")} found.
-\u{1F449} Run ${pc7.bold(pc7.cyan("vv init"))} first.`
+\u{1F449} Run ${pc7.bold(pc7.cyan("npx vectorvesper init"))} first.`
     );
     process.exit(1);
     return;
@@ -1045,7 +1125,7 @@ async function updateCommand(slug, options = {}) {
   if (installedSlugs.length === 0) {
     console.log(pc7.yellow(`
 \u26A0\uFE0F  No components are installed in this project.`));
-    console.log(`\u{1F449} Add one with ${pc7.bold(pc7.cyan("vv add <slug>"))}
+    console.log(`\u{1F449} Add one with ${pc7.bold(pc7.cyan("npx vectorvesper add <slug>"))}
 `);
     return;
   }
@@ -1064,7 +1144,7 @@ async function updateCommand(slug, options = {}) {
     if (!manifest.components[slug]) {
       console.log(pc7.red(`
 \u274C Component "${slug}" is not installed in this project.`));
-      console.log(`\u{1F449} Run ${pc7.cyan(`vv add ${slug}`)} to install it.
+      console.log(`\u{1F449} Run ${pc7.cyan(`npx vectorvesper add ${slug}`)} to install it.
 `);
       return;
     }
@@ -1076,6 +1156,7 @@ async function updateCommand(slug, options = {}) {
   const updated = [];
   const upToDate = [];
   const failed = [];
+  const updatedComponents = [];
   for (const target of targets) {
     spinner.text = `Updating ${pc7.cyan(target)}...`;
     try {
@@ -1090,6 +1171,7 @@ async function updateCommand(slug, options = {}) {
       writeFiles(planned.map((f) => ({ absolutePath: f.absolutePath, content: f.content })));
       recordInstall(components, installDir, projectRoot);
       updated.push(`${target} \u2192 ${remote.version}`);
+      updatedComponents.push(...components);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       failed.push({ slug: target, reason: message });
@@ -1113,6 +1195,9 @@ async function updateCommand(slug, options = {}) {
     for (const f of failed) console.log(`    ${pc7.red("\u2716")} ${f.slug}: ${pc7.dim(f.reason)}`);
   }
   console.log("");
+  if (updatedComponents.length > 0) {
+    await handleDependencies(updatedComponents, projectRoot, projectInfo, options);
+  }
   if (failed.length > 0) process.exit(1);
 }
 
@@ -1143,7 +1228,7 @@ async function removeCommand(slug, options = {}) {
   if (!config) {
     console.error(
       `${pc8.red(pc8.bold("Error:"))} No ${pc8.cyan("vv.config.json")} found.
-\u{1F449} Run ${pc8.bold(pc8.cyan("vv init"))} first.`
+\u{1F449} Run ${pc8.bold(pc8.cyan("npx vectorvesper init"))} first.`
     );
     process.exit(1);
     return;
@@ -1153,7 +1238,7 @@ async function removeCommand(slug, options = {}) {
   if (!entry) {
     console.log(pc8.yellow(`
 \u26A0\uFE0F  Component "${slug}" is not installed (not in vv-manifest.json).`));
-    console.log(`\u{1F449} See installed components with ${pc8.bold(pc8.cyan("vv info"))}
+    console.log(`\u{1F449} See installed components with ${pc8.bold(pc8.cyan("npx vectorvesper info"))}
 `);
     return;
   }
@@ -1217,7 +1302,7 @@ Remove ${slug}
 import fs9 from "fs";
 import path9 from "path";
 import pc9 from "picocolors";
-var CLI_VERSION = true ? "0.2.0" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.3.0" : "0.0.0-dev";
 async function infoCommand() {
   console.log(pc9.bold(pc9.cyan("\nVector Vesper Diagnostics\n")));
   const projectInfo = detectProject();
@@ -1237,17 +1322,6 @@ async function infoCommand() {
   console.log(`  \u2022 Has src/ folder: ${pc9.cyan(projectInfo.hasSrcDir ? "Yes" : "No")}`);
   console.log(`  \u2022 Tailwind CSS:    ${pc9.cyan(projectInfo.hasTailwind ? "Yes" : "No")}`);
   console.log("");
-  console.log(pc9.bold(pc9.white("Authentication:")));
-  const token = getAuthToken();
-  if (token) {
-    const maskedKey = token.slice(0, 6) + "\u2026" + token.slice(-4);
-    console.log(`  \u2022 Status:          ${pc9.green("Authenticated")}`);
-    console.log(`  \u2022 Key:             ${pc9.cyan(maskedKey)}`);
-  } else {
-    console.log(`  \u2022 Status:          ${pc9.yellow("Anonymous (free tier)")}`);
-    console.log(`  ${pc9.dim("  Run")} ${pc9.cyan("vv login <key>")} ${pc9.dim("to unlock pro components")}`);
-  }
-  console.log("");
   console.log(pc9.bold(pc9.white("Configuration (vv.config.json):")));
   if (config) {
     console.log(`  \u2022 Framework Set:   ${pc9.cyan(config.framework)}`);
@@ -1298,7 +1372,7 @@ async function diffCommand(slug) {
   if (!fs10.existsSync(manifestPath)) {
     console.log(pc10.yellow(`
 \u26A0\uFE0F  No vv-manifest.json found in this directory.`));
-    console.log(`\u{1F449} Add components first using ${pc10.bold(pc10.cyan("vv add <slug>"))}
+    console.log(`\u{1F449} Add components first using ${pc10.bold(pc10.cyan("npx vectorvesper add <slug>"))}
 `);
     return;
   }
@@ -1315,7 +1389,7 @@ async function diffCommand(slug) {
   if (installedSlugs.length === 0) {
     console.log(pc10.yellow(`
 \u26A0\uFE0F  No components are registered as installed in vv-manifest.json.`));
-    console.log(`\u{1F449} Add components using ${pc10.bold(pc10.cyan("vv add <slug>"))}
+    console.log(`\u{1F449} Add components using ${pc10.bold(pc10.cyan("npx vectorvesper add <slug>"))}
 `);
     return;
   }
@@ -1332,7 +1406,7 @@ async function diffCommand(slug) {
     if (!installedComponents[slug]) {
       console.log(pc10.red(`
 \u274C Component "${slug}" is not installed in this project.`));
-      console.log(`\u{1F449} Run ${pc10.cyan(`vv add ${slug}`)} to install it.
+      console.log(`\u{1F449} Run ${pc10.cyan(`npx vectorvesper add ${slug}`)} to install it.
 `);
       return;
     }
@@ -1355,7 +1429,7 @@ Component Diff: ${slug}`)));
 `);
       } else {
         console.log(`  \u2022 Status:         ${pc10.bold(pc10.yellow("\u26A0\uFE0F  Update available!"))}`);
-        console.log(`  \u2022 Run ${pc10.bold(pc10.cyan(`vv add ${slug} --overwrite`))} to update.
+        console.log(`  \u2022 Run ${pc10.bold(pc10.cyan(`npx vectorvesper add ${slug} --overwrite`))} to update.
 `);
       }
     } catch (error) {
@@ -1416,7 +1490,7 @@ Component Diff: ${slug}`)));
           `
 \u{1F4E2} ${pc10.bold(pc10.yellow(String(updatesAvailableCount)))} component(s) have updates available.`
         );
-        console.log(`\u{1F449} Run ${pc10.bold(pc10.cyan("vv add <slug> --overwrite"))} to update a component.
+        console.log(`\u{1F449} Run ${pc10.bold(pc10.cyan("npx vectorvesper add <slug> --overwrite"))} to update a component.
 `);
       } else {
         console.log(`
@@ -1437,7 +1511,7 @@ async function loginCommand(key) {
   if (!key || key.trim().length === 0) {
     logger.error("Please provide a license key.");
     console.log(`
-  Usage: ${pc11.cyan("vv login <your-license-key>")}`);
+  Usage: ${pc11.cyan("npx vectorvesper login <your-license-key>")}`);
     console.log(`  \u{1F511} Get a key at ${pc11.cyan("https://vectorvesper.dev/pricing")}
 `);
     process.exit(1);
@@ -1466,8 +1540,8 @@ async function loginCommand(key) {
   console.log(`  ${pc11.green(pc11.bold("\u2714"))} License key saved successfully!`);
   console.log(`  ${pc11.dim("Stored at:")} ${pc11.cyan(getGlobalConfigPath())}`);
   console.log("");
-  console.log(`  ${pc11.dim("Pro components are now available when you run")} ${pc11.cyan("vv add <slug>")}`);
-  console.log(`  ${pc11.dim("To verify your account:")} ${pc11.cyan("vv whoami")}`);
+  console.log(`  ${pc11.dim("Pro components are now available when you run")} ${pc11.cyan("npx vectorvesper add <slug>")}`);
+  console.log(`  ${pc11.dim("To verify your account:")} ${pc11.cyan("npx vectorvesper whoami")}`);
   console.log("");
 }
 async function logoutCommand() {
@@ -1519,14 +1593,14 @@ async function whoamiCommand() {
     console.log(`  ${pc11.bold("Access:")}   ${pc11.dim("Free components only")}`);
     console.log("");
     console.log(`  ${pc11.dim("To unlock pro components:")}`);
-    console.log(`  ${pc11.cyan("vv login <your-license-key>")}`);
+    console.log(`  ${pc11.cyan("npx vectorvesper login <your-license-key>")}`);
     console.log(`  \u{1F511} ${pc11.dim("Get a key at")} ${pc11.cyan("https://vectorvesper.dev/pricing")}`);
   }
   console.log("");
 }
 
 // src/index.ts
-var version = true ? "0.2.0" : "0.0.0-dev";
+var version = true ? "0.3.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();
@@ -1540,10 +1614,10 @@ program.command("init").description("Initialize Vector Vesper configuration in y
 program.command("list").description("List all available components in the registry").action(async () => {
   await listCommand();
 });
-program.command("add <slug>").description("Add a component to your project").option("-o, --overwrite", "Overwrite existing files without prompting").option("-y, --yes", "Accept all default prompts").option("-d, --dry-run", "Simulate the installation without writing files").option("--no-install", "Skip auto-installing missing dependencies").action(async (slug, options) => {
+program.command("add <slug>").description("Add a component to your project").option("-o, --overwrite", "Overwrite existing files without prompting").option("-y, --yes", "Accept all default prompts").option("-d, --dry-run", "Simulate the installation without writing files").option("--no-install", "Skip auto-installing missing dependencies").option("--prune", "Remove files left over from a previous version of the component").action(async (slug, options) => {
   await addCommand(slug, options);
 });
-program.command("update [slug]").description("Update installed components to the latest registry version").option("-f, --force", "Re-write files even if the version already matches").action(async (slug, options) => {
+program.command("update [slug]").description("Update installed components to the latest registry version").option("-f, --force", "Re-write files even if the version already matches").option("-y, --yes", "Accept all prompts (auto-install missing dependencies)").option("--no-install", "Skip auto-installing missing dependencies").action(async (slug, options) => {
   await updateCommand(slug, options);
 });
 program.command("remove <slug>").alias("rm").description("Remove an installed component and its files").option("-y, --yes", "Skip the confirmation prompt").action(async (slug, options) => {
@@ -1555,13 +1629,13 @@ 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>").description("Authenticate with a license key for pro components").action(async (key) => {
+program.command("login <key>", { hidden: true }).description("Authenticate with a license key for pro components").action(async (key) => {
   await loginCommand(key);
 });
-program.command("logout").description("Clear stored license credentials").action(async () => {
+program.command("logout", { hidden: true }).description("Clear stored license credentials").action(async () => {
   await logoutCommand();
 });
-program.command("whoami").description("Show current authentication status").action(async () => {
+program.command("whoami", { hidden: true }).description("Show current authentication status").action(async () => {
   await whoamiCommand();
 });
 process.on("unhandledRejection", (error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vectorvesper",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Add WebGL, React Three Fiber & advanced motion components to your project via CLI — motion, engineered.",
   "type": "module",
   "license": "MIT",