support for installing correct version of Node.js. Closes #437 (#438)

## 🎯 Aim

Support installing correct version of Node.js

## 📷 Result


![image](https://github.com/user-attachments/assets/80f2be0e-e760-4a3d-a557-dfb28b7d7e5f)

## ✅ What was done

- [X] provides a link to download and install Node.js
- [X] provides common guidance to use NVM (based on users' current OS)
or NVS

## 🔗 Related issue

Closes: #437

Author: Saurabh7019

README.md

@@ -58,7 +58,7 @@ When running the extension for the first time it will present you a walkthrough
 
 ### 2️⃣ Set up your development environment
 
-To ensure that you can develop SPFx solutions, you may use the **check dependencies** functionality. 
+To ensure that you can develop SPFx solutions, you may use the **Validate local setup** functionality. 
 
 ![Validate dependency](./assets/images/validate-dependency.png)
 

assets/images/validate-dependency.png

@@ -368,7 +368,7 @@
 					{
 						"id": "set-up-local-workspace",
 						"title": "Validate your local workspace",
-						"description": "Validate if your local workspace is ready for SharePoint Framework development by checking and installing the required dependencies. \n[Check dependencies](command:spfx-toolkit.checkDependencies)",
+						"description": "Validate if your local workspace is ready for SharePoint Framework development by checking and installing the required dependencies. \n[Validate local setup](command:spfx-toolkit.checkDependencies)",
 						"media": {
 							"markdown": "assets/walkthrough/validate-local-setup.md"
 						}
@@ -605,7 +605,7 @@
 		"viewsWelcome": [
 			{
 				"view": "pnp-view-empty",
-				"contents": "Welcome to SharePoint Framework Toolkit\n\n\nTo start create a new SharePoint Framework project. \n[Create a new project](command:spfx-toolkit.createProject)\n\n\n\n\n\nUse a sample to kick off a new project and boost your development.\n[View samples](command:spfx-toolkit.samplesGallery)\n\n\n\n\n\nYou can also open an existing app.\n[Open folder](command:vscode.openFolder)\n\n\n\n\n\nValidate your local workspace and check if you have the required dependencies.\n[Check dependencies](command:spfx-toolkit.checkDependencies)\n\n\n\n\n\nInstall the required dependencies.\n[Install dependencies](command:spfx-toolkit.installDependencies)\n\n\n\nLearn more about SharePoint Framework and this toolkit.\n[Walkthrough](command:spfx-toolkit.welcome)\n\n\n\nStart effortlessly with GitHub Copilot. Get SPFx tailored support in setting up your local workspace, creating a new project, or managing your tenant.\n[Use @SPFx in GitHib Copilot](command:spfx-toolkit.openCopilot) \n\n\n\n\n\nFor additional help or resources visit the [extension wiki](https://github.com/pnp/vscode-viva/wiki)."
+				"contents": "Welcome to SharePoint Framework Toolkit\n\n\nTo start create a new SharePoint Framework project. \n[Create a new project](command:spfx-toolkit.createProject)\n\n\n\n\n\nUse a sample to kick off a new project and boost your development.\n[View samples](command:spfx-toolkit.samplesGallery)\n\n\n\n\n\nYou can also open an existing app.\n[Open folder](command:vscode.openFolder)\n\n\n\n\n\nValidate your local workspace and check if you have the required dependencies.\n[Validate local setup](command:spfx-toolkit.checkDependencies)\n\n\n\n\n\nInstall the required dependencies.\n[Install dependencies](command:spfx-toolkit.installDependencies)\n\n\n\nLearn more about SharePoint Framework and this toolkit.\n[Walkthrough](command:spfx-toolkit.welcome)\n\n\n\nStart effortlessly with GitHub Copilot. Get SPFx tailored support in setting up your local workspace, creating a new project, or managing your tenant.\n[Use @SPFx in GitHib Copilot](command:spfx-toolkit.openCopilot) \n\n\n\n\n\nFor additional help or resources visit the [extension wiki](https://github.com/pnp/vscode-viva/wiki)."
 			}
 		],
 		"commands": [
@@ -616,7 +616,7 @@
 			},
 			{
 				"command": "spfx-toolkit.checkDependencies",
-				"title": "Check dependencies",
+				"title": "Validate local setup",
 				"category": "SharePoint Framework Toolkit"
 			},
 			{

assets/images/welcome-experience.png

@@ -183,7 +183,7 @@ export class PromptHandlers {
         }
         return buttons;
       case 'setup':
-        if (chatResponse.toLowerCase().includes('check dependencies')) {
+        if (chatResponse.toLowerCase().includes('validate local setup')) {
           return [{
             command: Commands.checkDependencies,
             title: vscode.l10n.t('Check if my local workspace is ready'),

package.json

@@ -113,7 +113,7 @@ SharePoint Framework development requires the following:
 - Yeoman SharePoint generator - The Yeoman SharePoint web part generator helps you quickly create a SharePoint client-side solution project with the right toolchain and project structure. To install the SharePoint Framework Yeoman generator globally, enter the following command: npm install @microsoft/generator-sharepoint --global
 - You should be using a modern web browser like Microsoft Edge, Google Chrome, or Firefox as the development browser.
 You will suggest running this single command to install all three of the following: npm install gulp-cli yo @microsoft/generator-sharepoint --global
-You will suggest using SPFx Toolkit 'Check dependencies' action which allows to validate if your local workspace meets the needed requirements in order to develop an SPFx project.
+You will suggest using SPFx Toolkit 'Validate local setup' action which allows to validate if your local workspace meets the needed requirements in order to develop an SPFx project.
 When asked about creating new project you will suggest running the /new command instead of the /setup command in GitHub Copilot Chat with @spfx or using SPFx Toolkit Create new project form or Sample Gallery.`;
 
 // TODO: this is beta. We should add more correct context from current project and better grounding

src/chat/PromptHandlers.ts

@@ -1,7 +1,8 @@
 import { Commands } from '../../constants/Commands';
 import { Notifications } from '../dataType/Notifications';
 import { execSync } from 'child_process';
-import { commands, ProgressLocation, window } from 'vscode';
+import { commands, ProgressLocation, window, Uri } from 'vscode';
+import * as os from 'os';
 import { Logger } from '../dataType/Logger';
 import { NpmLs, Subscription } from '../../models';
 import { TerminalCommandExecuter } from '../executeWrappers/TerminalCommandExecuter';
@@ -33,28 +34,49 @@ export class Dependencies {
     await window.withProgress({
       location: ProgressLocation.Notification,
       cancellable: false,
-      title: 'Checking dependencies',
+      title: 'Validating local setup',
     }, async (progress) => {
       return new Promise((resolve) => {
         setTimeout(() => {
           try {
-            progress.report({ message: 'Checking node version...' });
+            progress.report({ message: 'Validating node version...' });
 
             // Validate node
             const isNodeValid = Dependencies.isValidNodeJs();
             if (!isNodeValid) {
-              Notifications.warning('Your Node.js version is not supported with SPFx development. Make sure you are using version: >=22.14.0 and <23.0.0');
+              const installNodeJSOption = 'Install Node.js';
+              const useNvmOption = os.platform() === 'win32' ? 'Use NVM for Windows' : 'Use NVM';
+              const useNvsOption = 'Use NVS';
+
+              Notifications.warning(
+                'Your Node.js version is not supported with SPFx development. Make sure you are using version: >=22.14.0 and <23.0.0',
+                installNodeJSOption,
+                useNvmOption,
+                useNvsOption
+              ).then((selectedOption) => {
+                if (selectedOption === installNodeJSOption) {
+                  commands.executeCommand('vscode.open', Uri.parse('https://nodejs.org/en/download/'));
+                } else if (selectedOption === useNvmOption) {
+                  const nvmInstallUrl = os.platform() === 'win32'
+                    ? 'https://github.com/coreybutler/nvm-windows?tab=readme-ov-file#overview'
+                    : 'https://github.com/nvm-sh/nvm?tab=readme-ov-file#intro';
+                  commands.executeCommand('vscode.open', Uri.parse(nvmInstallUrl));
+                } else if (selectedOption === useNvsOption) {
+                  const nvsInstallUrl = 'https://github.com/jasongin/nvs?tab=readme-ov-file#nvs-node-version-switcher';
+                  commands.executeCommand('vscode.open', Uri.parse(nvsInstallUrl));
+                }
+              });
               resolve(null);
               return;
             }
 
-            progress.report({ message: 'Checking npm dependencies...' });
+            progress.report({ message: 'Validating npm dependencies...' });
 
             const command = 'npm list -g --json --silent';
             const result = execSync(command, { shell: TerminalCommandExecuter.shell, timeout: 15000 });
 
             if (!result) {
-              Notifications.error('Failed checking dependencies');
+              Notifications.error('Failed validating local setup');
             }
 
             // Check for missing dependencies
@@ -82,7 +104,7 @@ export class Dependencies {
             }
             resolve(null);
           } catch (e) {
-            Notifications.error('Failed checking dependencies');
+            Notifications.error('Failed validating local setup');
             Logger.error(`${(e as Error).message}`);
             resolve(null);
           }