feat: Add initial ProXPL VS Code extension with run command, formatting, hover support, and quickstart guide.

Author: ProgrammerKR

extension/package.json

@@ -57,7 +57,7 @@
     ],
     "commands": [
       {
-        "command": "proxpl.runFile",
+        "command": "proxpl.run",
         "title": "ProXPL: Run File",
         "icon": "$(play)"
       }
@@ -66,7 +66,7 @@
       "editor/title": [
         {
           "when": "resourceExtname == .prox",
-          "command": "proxpl.runFile",
+          "command": "proxpl.run",
           "group": "navigation"
         }
       ]

extension/src/extension.ts

@@ -6,7 +6,7 @@ export function activate(context: vscode.ExtensionContext) {
     context.subscriptions.push(diagnosticCollection);
 
     // 1. Code Runner Command
-    let runCommand = vscode.commands.registerCommand('proxpl.runFile', () => {
+    let runCommand = vscode.commands.registerCommand('proxpl.run', () => {
         const editor = vscode.window.activeTextEditor;
         if (!editor) {
             vscode.window.showErrorMessage('No active editor found.');
@@ -67,17 +67,30 @@ export function activate(context: vscode.ExtensionContext) {
     const formattingProvider = vscode.languages.registerDocumentFormattingEditProvider('proxpl', {
         provideDocumentFormattingEdits(document: vscode.TextDocument): vscode.TextEdit[] {
             const edits: vscode.TextEdit[] = [];
+            let lastLineWasEmpty = false;
 
             for (let i = 0; i < document.lineCount; i++) {
                 const line = document.lineAt(i);
                 const text = line.text;
 
-                // Remove trailing whitespace
+                // 1. Remove extra empty lines (consecutive empty lines)
+                if (text.trim() === '') {
+                    if (lastLineWasEmpty) {
+                        // Delete this extra empty line
+                        edits.push(vscode.TextEdit.delete(line.rangeIncludingLineBreak));
+                        continue;
+                    }
+                    lastLineWasEmpty = true;
+                } else {
+                    lastLineWasEmpty = false;
+                }
+
+                // 2. Remove trailing whitespace
                 if (text.endsWith(' ') || text.endsWith('\t')) {
                     edits.push(vscode.TextEdit.delete(new vscode.Range(i, text.trimEnd().length, i, text.length)));
                 }
 
-                // Basic Indentation
+                // 3. Basic Indentation (Fix to 4 spaces)
                 const indentMatch = text.match(/^(\s+)/);
                 if (indentMatch) {
                     const oldIndent = indentMatch[1];

extension/vsc-extension-quickstart.md

@@ -0,0 +1,46 @@
+# VS Code Extension Quickstart for ProXPL
+
+Follow these steps to compile and test the extension features (Run Code, Formatter, and Hover Support).
+
+## Prerequisites
+
+Ensure you have [Node.js](https://nodejs.org/) installed, which includes `npm`.
+
+## 1. Install Dependencies
+
+Open a terminal in the `extension/` directory and run:
+
+```bash
+npm install
+```
+
+This will install the VS Code API types and the TypeScript compiler.
+
+## 2. Compile the TypeScript Code
+
+To translate the `.ts` files into executable `.js` files in the `out/` directory:
+
+```bash
+npm run compile
+```
+
+If you want to keep the compiler running and watching for changes:
+
+```bash
+npm run watch
+```
+
+## 3. Launch and Test the Extension
+
+1.  In the current VS Code window (where the `extension/` folder is open), press **F5**.
+2.  A new window titled **[Extension Development Host]** will open.
+3.  In that new window, open or create a file with the `.prox` extension (e.g., `hello.prox`).
+4.  **Test Run Code**: Click the **Play button** in the top-right corner of the editor.
+5.  **Test Hover**: Hover over keywords like `func`, `var`, or `print`.
+6.  **Test Formatter**: Right-click in the editor and select **Format Document** (or use `Alt+Shift+F`).
+
+## 4. Troubleshooting
+
+- If the **Play button** doesn't appear, ensure the file ends in `.prox`.
+- If the terminal says `proxpl not found`, ensure the ProXPL compiler is installed and added to your system PATH.
+- If changes aren't reflected, ensure you've run `npm run compile` and restarted the host window via the debug toolbar.