compile before symlink

vscode-extension-ashes/.nvmrc

@@ -0,0 +1 @@
+v22

vscode-extension-ashes/INSTALL.md

@@ -2,16 +2,45 @@
 
 ## Quick Installation
 
-1. **Copy the extension folder** to your VS Code extensions directory:
+### Automated Installation (Recommended)
+
+Use the provided installation script for the easiest setup:
+
+```bash
+./install-extension.sh
+```
+
+This script will:
+1. **Compile the extension** using npm and the correct Node.js version (via nvm if available)
+2. **Create a symlink** to your VS Code extensions directory
+3. **Handle dependencies** automatically
+
+### Manual Installation
+
+1. **Compile the extension**:
+   ```bash
+   cd vscode-extension-ashes
+   
+   # Use nvm if available (recommended)
+   nvm use  # Uses version from .nvmrc
+   
+   # Install dependencies
+   npm install
+   
+   # Compile TypeScript
+   npm run compile
+   ```
+
+2. **Copy the extension folder** to your VS Code extensions directory:
    - **Linux**: `~/.vscode/extensions/`
    - **macOS**: `~/.vscode/extensions/`
    - **Windows**: `%USERPROFILE%\.vscode\extensions\`
 
-2. **Rename the folder** to `ashes-language-support-0.1.0` (or similar)
+3. **Rename the folder** to `ashes-language-support-0.1.0` (or similar)
 
-3. **Reload VS Code** or restart the application
+4. **Reload VS Code** or restart the application
 
-4. **Test the extension** by opening any `.esc` file
+5. **Test the extension** by opening any `.esc` file
 
 ## Alternative Installation (Development Mode)
 
@@ -27,17 +56,23 @@
 
 ## Building from Source
 
-1. **Install dependencies**:
+1. **Set up Node.js version** (recommended):
+   ```bash
+   # Use nvm if available to get the correct Node.js version
+   nvm use  # Uses version from .nvmrc (v22)
+   ```
+
+2. **Install dependencies**:
    ```bash
    npm install
    ```
 
-2. **Compile TypeScript**:
+3. **Compile TypeScript**:
    ```bash
    npm run compile
    ```
 
-3. **Package the extension** (optional):
+4. **Package the extension** (optional):
    ```bash
    npx vsce package
    ```
@@ -79,6 +114,12 @@
 - Press `Ctrl+Space` to manually trigger completion
 - Check that the extension is activated (should show in the Extensions panel)
 
+### Compilation errors
+- Make sure you're using the correct Node.js version: `nvm use` (uses v22 from .nvmrc)
+- Clear node_modules and reinstall: `rm -rf node_modules && npm install`
+- Check that TypeScript is installed: `npm list typescript`
+- Ensure all dependencies are installed: `npm install`
+
 ## Uninstalling
 
 Simply delete the extension folder from your VS Code extensions directory and restart VS Code.