refactor: move install-global-cli script to tools package (#457)

- Add install-global-cli subcommand to @voidzero-dev/vite-plus-tools
- Local dev (bootstrap-cli) now installs CLI as `vp` command
- CI (bootstrap-cli:ci) continues to install as `vite` command
- Uses different package name for local install to avoid conflicts

Author: fengmk2

CONTRIBUTING.md

@@ -42,5 +42,7 @@ pnpm install
 
 ```
 pnpm bootstrap-cli
-vite --version
+vp --version
 ```
+
+Note: Local development installs the CLI as `vp` (package name: `vite-plus-cli-dev`) to avoid overriding the published `vite-plus-cli` package and its `vite` bin name. In CI, `pnpm bootstrap-cli:ci` installs it as `vite`.

package.json

@@ -9,9 +9,10 @@
   "type": "module",
   "scripts": {
     "build": "pnpm -F @voidzero-dev/* -F vite-plus -F vite-plus-cli build",
-    "bootstrap-cli": "pnpm build && pnpm install-global-cli",
+    "bootstrap-cli": "pnpm build && pnpm install-global-cli:local",
     "bootstrap-cli:ci": "pnpm install-global-cli",
-    "install-global-cli": "pnpm --filter=vite-plus-cli copy-binding && npm install -g ./packages/global --force",
+    "install-global-cli": "pnpm --filter=vite-plus-cli copy-binding && tool install-global-cli vite",
+    "install-global-cli:local": "pnpm --filter=vite-plus-cli copy-binding && tool install-global-cli vp",
     "typecheck": "tsgo -b tsconfig.json",
     "tsgo": "tsgo -b tsconfig.json",
     "lint": "vite lint --type-aware --threads 4",

packages/tools/src/index.ts

@@ -21,10 +21,14 @@ switch (subcommand) {
     const { mergePeerDeps } = await import('./merge-peer-deps.ts');
     mergePeerDeps();
     break;
+  case 'install-global-cli':
+    const { installGlobalCli } = await import('./install-global-cli.ts');
+    installGlobalCli();
+    break;
   default:
     console.error(`Unknown subcommand: ${subcommand}`);
     console.error(
-      'Available subcommands: snap-test, replace-file-content, sync-remote, json-sort, merge-peer-deps',
+      'Available subcommands: snap-test, replace-file-content, sync-remote, json-sort, merge-peer-deps, install-global-cli',
     );
     process.exit(1);
 }

packages/tools/src/install-global-cli.ts

@@ -0,0 +1,44 @@
+import { execSync } from 'node:child_process';
+import { readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+
+export function installGlobalCli() {
+  const { positionals } = parseArgs({
+    allowPositionals: true,
+    args: process.argv.slice(3),
+  });
+
+  const binName = positionals[0];
+  if (!binName || !['vp', 'vite'].includes(binName)) {
+    console.error('Usage: tool install-global-cli <vp|vite>');
+    process.exit(1);
+  }
+
+  console.log(`Installing global CLI with bin name: ${binName}`);
+
+  if (binName === 'vite') {
+    // CI: use original package.json settings
+    execSync('npm install -g ./packages/global --force', {
+      stdio: 'inherit',
+    });
+    return;
+  }
+
+  // Local development: temporarily modify package.json to avoid conflicts
+  const packageJsonPath = path.resolve('packages/global/package.json');
+  const originalContent = readFileSync(packageJsonPath, 'utf-8');
+  const packageJson = JSON.parse(originalContent);
+
+  packageJson.name = 'vite-plus-cli-dev';
+  packageJson.bin = { vp: './bin/vite' };
+
+  try {
+    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+    execSync('npm install -g ./packages/global --force', {
+      stdio: 'inherit',
+    });
+  } finally {
+    writeFileSync(packageJsonPath, originalContent);
+  }
+}