feat(vscode): add thin language client extension

.gitignore

@@ -274,6 +274,9 @@ FakesAssemblies/
 # Node.js Tools for Visual Studio
 .ntvs_analysis.dat
 node_modules/
+vscode-extension/artifacts/
+vscode-extension/dist/
+vscode-extension/server/
 
 # Visual Studio 6 build log
 *.plg

.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Run Expressif VS Code Extension",
+      "type": "extensionHost",
+      "request": "launch",
+      "args": [
+        "--extensionDevelopmentPath=${workspaceFolder}/vscode-extension"
+      ],
+      "outFiles": [
+        "${workspaceFolder}/vscode-extension/dist/**/*.js"
+      ],
+      "preLaunchTask": "build Expressif VS Code extension"
+    }
+  ]
+}

.vscode/tasks.json

@@ -0,0 +1,14 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "build Expressif VS Code extension",
+      "type": "shell",
+      "command": "npm run compile && node ./scripts/publish-server.mjs",
+      "options": {
+        "cwd": "${workspaceFolder}/vscode-extension"
+      },
+      "problemMatcher": "$tsc"
+    }
+  ]
+}

vscode-extension/.gitignore

@@ -0,0 +1,4 @@
+artifacts/
+dist/
+node_modules/
+server/

vscode-extension/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Register `.expressif` files and launch the bundled Expressif language server over stdio.

vscode-extension/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2025 Seddryck
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

vscode-extension/README.md

@@ -0,0 +1,35 @@
+# Expressif Language Support for VS Code
+
+This extension is a thin client for `Expressif.LanguageServer`. It registers `.expressif` files and forwards editor activity to the server over the Language Server Protocol. Parsing and every language feature remain in the server.
+
+## Development
+
+Prerequisites are Node.js, npm, the .NET 10 SDK, and VS Code.
+
+```powershell
+cd vscode-extension
+npm install
+npm run compile
+```
+
+Open the repository in VS Code and press **F5**. The extension development host uses the server path configured in `expressif.languageServer.path`. For an unpackaged development run, first publish the server with:
+
+```powershell
+node ./scripts/publish-server.mjs
+```
+
+Open a `.expressif` file in the development host to activate the extension. Server stderr and language-client traces are available in **View > Output > Expressif Language Server**. Set `expressifLanguageServer.trace.server` to `messages` or `verbose` for LSP tracing.
+
+## Package and install
+
+Run the following from this directory:
+
+```powershell
+npm install
+npm run package
+code --install-extension ./artifacts/expressif-language-support.vsix
+```
+
+Packaging publishes a self-contained server for the operating system and architecture on which the command runs, then embeds it in the VSIX. Build the VSIX on each target platform. A locally installed package therefore requires neither the .NET runtime nor a separate server installation.
+
+To use a separately installed server, set `expressif.languageServer.path` to its absolute executable path and reload VS Code.

vscode-extension/language-configuration.json

@@ -0,0 +1,21 @@
+{
+  "brackets": [
+    ["(", ")"],
+    ["[", "]"],
+    ["{", "}"]
+  ],
+  "autoClosingPairs": [
+    { "open": "(", "close": ")" },
+    { "open": "[", "close": "]" },
+    { "open": "{", "close": "}" },
+    { "open": "\"", "close": "\"", "notIn": ["string"] },
+    { "open": "'", "close": "'", "notIn": ["string"] }
+  ],
+  "surroundingPairs": [
+    ["(", ")"],
+    ["[", "]"],
+    ["{", "}"],
+    ["\"", "\""],
+    ["'", "'"]
+  ]
+}