feat: add support for .nvmrc as node version source (#2244)

fixes #2207
adds `.nvmrc` as a supported source for node version resolution,
behaviour is as discussed in the issue

implemented after discussion with @TheAlexLichter on voidzero discord
(#2207 (comment))

thanks to @devmcclu who did a parallel implementation in #2213, i took
some tests from that PR

---------

Co-authored-by: Alexander Lichter <github@lichter.io>
Co-authored-by: MK (fengmk2) <fengmk2@gmail.com>

Author: 3 people

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/cli_helper_message/snapshots/cli_helper_message.md

@@ -467,7 +467,7 @@ Examples:
 
   Manage:
     vp env pin lts                # Pin to latest LTS version
-    vp env install                # Install version from .node-version / package.json
+    vp env install                # Install version from .node-version / package.json / .nvmrc
     vp env use 20                 # Use Node.js 20 for this shell session
     vp env use --unset            # Remove session override
     vp env clean                  # Remove unused managed caches

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_install_nvmrc/.nvmrc

@@ -0,0 +1 @@
+22

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_install_nvmrc/package.json

@@ -0,0 +1,3 @@
+{
+  "name": "command-env-install-nvmrc"
+}

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_install_nvmrc/snapshots.toml

@@ -0,0 +1,8 @@
+[[case]]
+name = "command_env_install_nvmrc"
+vp = "global"
+skip-platforms = ["windows"]
+seed-runtime = false
+steps = [
+  { argv = ["vp", "env", "install"], comment = "Install version from .nvmrc (22.x)", continue-on-failure = true },
+]

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_install_nvmrc/snapshots/command_env_install_nvmrc.md

@@ -0,0 +1,12 @@
+# command_env_install_nvmrc
+
+## `vp env install`
+
+Install version from .nvmrc (22.x)
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+Installing Node.js <version>...
+Installed Node.js <version>
+```

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_use/snapshots/command_env_use.md

@@ -12,7 +12,7 @@ Usage: vp env use [OPTIONS] [VERSION]
 Use a specific Node.js version for this shell session
 
 Arguments:
-  [VERSION]  Version to use (e.g., "20", "20.18.0", "lts", "latest"). If omitted, reads from .node-version or package.json
+  [VERSION]  Version to use (e.g., "20", "20.18.0", "lts", "latest"). If omitted, reads from .node-version, package.json, or .nvmrc
 
 Options:
   --unset                Remove session override (revert to file-based resolution)

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_which_nvmrc/.nvmrc

@@ -0,0 +1 @@
+20.18.0

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_which_nvmrc/package.json

@@ -0,0 +1 @@
+{}

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_which_nvmrc/snapshots.toml

@@ -0,0 +1,9 @@
+[[case]]
+name = "command_env_which_nvmrc"
+vp = "global"
+local-registry = true
+skip-platforms = ["windows"]
+steps = [
+  { argv = ["vp", "env", "exec", "node", "--version"], comment = "Ensure Node.js is installed first", continue-on-failure = true },
+  { argv = ["vp", "env", "which", "node"], comment = "Core tool - shows resolved Node.js binary path from .nvmrc", continue-on-failure = true },
+]

crates/vite_cli_snapshots/tests/cli_snapshots/fixtures/command_env_which_nvmrc/snapshots/command_env_which_nvmrc.md

@@ -0,0 +1,21 @@
+# command_env_which_nvmrc
+
+## `vp env exec node --version`
+
+Ensure Node.js is installed first
+
+```
+<version>
+```
+
+## `vp env which node`
+
+Core tool - shows resolved Node.js binary path from .nvmrc
+
+```
+VITE+ - The Unified Toolchain for the Web
+
+<home>/.vite-plus/js_runtime/node/<version>/bin/node
+  Version:    20.18.0
+  Source:     <workspace>/.nvmrc
+```