Extension init, syntax highlighting, autocompletion, install script

vscode-extension-ashes/INSTALL.md

@@ -0,0 +1,84 @@
+# Installation Guide for ASHES Language Support Extension
+
+## Quick Installation
+
+1. **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. **Reload VS Code** or restart the application
+
+4. **Test the extension** by opening any `.esc` file
+
+## Alternative Installation (Development Mode)
+
+1. **Open VS Code** in the extension directory:
+   ```bash
+   cd vscode-extension
+   code .
+   ```
+
+2. **Press F5** to run the extension in a new Extension Development Host window
+
+3. **Open a .esc file** in the new window to test the extension
+
+## Building from Source
+
+1. **Install dependencies**:
+   ```bash
+   npm install
+   ```
+
+2. **Compile TypeScript**:
+   ```bash
+   npm run compile
+   ```
+
+3. **Package the extension** (optional):
+   ```bash
+   npx vsce package
+   ```
+
+## Testing the Extension
+
+1. **Open the sample file**: `sample.esc` in the extension directory
+2. **Check syntax highlighting**: Events, commands, and variables should be colorized
+3. **Test auto-completion**: Type `say(` and press `Ctrl+Space`
+4. **Test snippets**: Type `event` and press `Tab`
+5. **Test hover**: Hover over commands like `say` or `set_global`
+6. **Test command reference**: Press `Ctrl+Shift+P` and type "ASHES: Show Command Reference"
+
+## Features to Test
+
+- ✅ Syntax highlighting for events (`:event_name`)
+- ✅ Syntax highlighting for commands (`say`, `set_global`, etc.)
+- ✅ Syntax highlighting for variables (`var`, `global`)
+- ✅ Syntax highlighting for dialog blocks (`?!`)
+- ✅ Auto-completion for commands
+- ✅ Auto-completion for built-in variables
+- ✅ Code snippets for common patterns
+- ✅ Hover information for commands
+- ✅ Smart indentation
+- ✅ Code folding for events
+
+## Troubleshooting
+
+### Extension not loading
+- Check that the folder is in the correct extensions directory
+- Restart VS Code completely
+- Check the Developer Console for errors (`Help > Toggle Developer Tools`)
+
+### Syntax highlighting not working
+- Make sure the file has a `.esc` extension
+- Check that the language is set to "ASHES" in the bottom-right corner of VS Code
+
+### Auto-completion not working
+- Press `Ctrl+Space` to manually trigger completion
+- Check that the extension is activated (should show in the Extensions panel)
+
+## Uninstalling
+
+Simply delete the extension folder from your VS Code extensions directory and restart VS Code.