chore: improve vscode extension debug dx (#221)

.gitignore

@@ -1,7 +1,10 @@
 .DS_Store
 Profile-*.json
 # Editor configuration
-.vscode
+.vscode/*
+!.vscode/extensions.json
+!.vscode/launch.json
+!.vscode/tasks.json
 .idea
 .vs
 # Release artifacts

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+	"recommendations": [
+		"nhedger.ts-esbuild-problem-matchers"
+	]
+}

.vscode/launch.json

@@ -0,0 +1,18 @@
+{
+	"version": "0.2.0",
+	"configurations": [
+		{
+			"name": "🧩 Debug Extension",
+			"type": "extensionHost",
+			"request": "launch",
+			"args": [
+				"--disable-extensions",
+				"--extensionDevelopmentKind=node",
+				"--extensionDevelopmentPath=${workspaceFolder}/editors/vscode"
+			],
+			"outFiles": ["${workspaceFolder}/out/**/*.js"],
+			"preLaunchTask": "npm: watch",
+			"sourceMapRenames": true
+		}
+	]
+}

.vscode/tasks.json

@@ -0,0 +1,21 @@
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "npm",
+			"script": "watch",
+			"isBackground": true,
+			"problemMatcher": "$ts-esbuild-watch",
+			"options": {
+				"cwd": "${workspaceFolder}/editors/vscode"
+			},
+			"presentation": {
+				"echo": true,
+				"reveal": "always",
+				"showReuseMessage": false,
+				"clear": true
+			},
+			"group": "build"
+		}
+	]
+}

CONTRIBUTING.md

@@ -157,6 +157,12 @@ When you apply changes to the binary, you need to do two things:
 When the daemon is running, it's possible to inspect its logs in the folder `biome-logs`, placed
 in the temporary folder of the operative system.
 
+### Debugging the VS Code extension
+
+The Biome VS Code extension can be debugged by running the `Debug Extension` launch configuration
+in VS Code. This will compile the extension, watch for modifications and start a separate VS Code
+instance with only the Biome extension installed.
+
 ### User files
 
 If files specific to your local development environment should be ignored, please add these files to a global git ignore file rather than to a git ignore file within Biome.