feat(env): add vp env list (local) and rename old list to vp env list-remote

- `vp env list` (alias `ls`): lists locally installed Node.js versions
  with current/default markers, fnm-style `* v{version}` format
- `vp env list-remote` (alias `ls-remote`): lists remote versions from
  registry with fnm-style output (v{version} per line, LTS in bright blue)
- Add `--sort asc|desc` flag to list-remote (default: asc)
- Add `SortingMethod` enum to CLI args

Author: fengmk2

.github/workflows/ci.yml

@@ -254,6 +254,12 @@ jobs:
           }
           Write-Host "tsc shim removed successfully"
 
+          # Test 5: use session
+          vp env use 18
+          node --version
+          vp env use --unset
+          node --version
+
       - name: Test global package install (cmd)
         if: ${{ matrix.os == 'windows-latest' }}
         shell: cmd
@@ -292,6 +298,12 @@ jobs:
           )
           echo tsc shell script removed successfully
 
+          :: Test 6: use session
+          vp env use 18
+          node --version
+          vp env use --unset
+          node --version
+
       - name: Test global package install (bash)
         run: |
           echo "PATH: $PATH"
@@ -323,6 +335,12 @@ jobs:
           fi
           echo "tsc shim removed successfully"
 
+          # Test 5: use session
+          vp env use 18
+          node --version
+          vp env use --unset
+          node --version
+
       - name: Install Playwright browsers
         run: pnpx playwright install chromium
 

crates/vite_global_cli/src/cli.rs

@@ -670,8 +670,17 @@ pub enum EnvSubcommands {
     /// Remove the .node-version file from current directory (alias for `pin --unpin`)
     Unpin,
 
-    /// List available Node.js versions
+    /// List locally installed Node.js versions
+    #[command(alias = "ls")]
     List {
+        /// Output as JSON
+        #[arg(long)]
+        json: bool,
+    },
+
+    /// List available Node.js versions from the registry
+    #[command(name = "list-remote", alias = "ls-remote")]
+    ListRemote {
         /// Filter versions by pattern (e.g., "20" for 20.x versions)
         pattern: Option<String>,
 
@@ -686,6 +695,10 @@ pub enum EnvSubcommands {
         /// Output as JSON
         #[arg(long)]
         json: bool,
+
+        /// Version sorting order
+        #[arg(long, value_enum, default_value_t = SortingMethod::Asc)]
+        sort: SortingMethod,
     },
 
     /// Run a command with a specific Node.js version
@@ -748,6 +761,16 @@ pub enum EnvSubcommands {
     },
 }
 
+/// Version sorting order for list-remote command
+#[derive(clap::ValueEnum, Clone, Debug, Default)]
+pub enum SortingMethod {
+    /// Sort versions in ascending order (earliest to latest)
+    #[default]
+    Asc,
+    /// Sort versions in descending order (latest to earliest)
+    Desc,
+}
+
 /// Package manager subcommands
 #[derive(Subcommand, Debug, Clone)]
 pub enum PmCommands {