A VS Code extension that integrates the Andromeda Language Server for comprehensive JavaScript and TypeScript development support.

• 🔍 Real-time Diagnostics - Live error reporting with comprehensive linting rules
• ⚡ Enhanced Auto-completion - Context-aware completions for:
  • Andromeda APIs (file system, environment, process operations)
  • Web APIs (Canvas, Crypto, Performance, Storage, Timers)
  • Console methods with rich descriptions
  • Database operations (SQLite)
• 🛠️ Code Actions & Quick Fixes - Auto-fix capabilities for common issues
• 📝 Document Formatting - Built-in code formatting support
• 💡 Hover Information - Rich documentation and type information on hover
• ⚙️ Configurable Diagnostics - Run on type, save, or never
• 📁 Multiple File Format Support - .js, .jsx, .ts, .tsx, .mjs, .cjs
• 🎯 Advanced Linting Rules including:
  • Empty statement detection
  • Variable usage validation
  • Unreachable code detection
  • Camelcase naming enforcement
  • Console usage warnings
  • Debugger statement detection
  • Type checking for TypeScript
  • And many more...

• Andromeda v0.1.0-draft14 or higher
• VS Code 1.74.0 or higher

1. Clone this repository
2. Run npm install to install dependencies
3. Run npm run compile to build the extension
4. Press F5 to launch a new Extension Development Host window

Make sure you have Andromeda installed:

# Install from source (requires Rust)
git clone https://github.com/tryandromeda/andromeda
cd andromeda
cargo install --path cli

# Or install from crates.io (when available)
cargo install --git https://github.com/tryandromeda/andromeda

The extension can be configured through VS Code settings:

{
  "andromeda.enable": true,
  "andromeda.run": "onType",
  "andromeda.configPath": null,
  "andromeda.unusedDisableDirectives": "allow",
  "andromeda.executablePath": "andromeda",
  "andromeda.trace.server": "off",
  "andromeda.format.enable": true,
  "andromeda.codeAction.autoFix.enable": true,
  "andromeda.completion.enable": true,
  "andromeda.hover.enable": true
}

• andromeda.enable: Enable/disable the Andromeda language server
• andromeda.run: When to run diagnostics (onType, onSave, never)
• andromeda.configPath: Path to custom Andromeda configuration file
• andromeda.unusedDisableDirectives: Handle unused disable directives (allow, warn, error)
• andromeda.executablePath: Path to the Andromeda executable (default: andromeda)
• andromeda.trace.server: Enable LSP communication tracing for debugging

• andromeda.format.enable: Enable code formatting (default: true)
• andromeda.codeAction.autoFix.enable: Enable auto-fix code actions (default: true)
• andromeda.completion.enable: Enable enhanced completions (default: true)
• andromeda.hover.enable: Enable hover information (default: true)

Access these commands via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

• Andromeda: Restart Language Server - Restart the language server
• Andromeda: Show Output - Show the language server output channel
• Andromeda: Apply Auto Fix - Apply auto-fixes for the current file
• Andromeda: Fix All Auto-fixable Problems - Fix all auto-fixable problems in the current file
• Andromeda: Format Document - Format the current document

1. Install the extension and ensure Andromeda is in your PATH
2. Open a JavaScript or TypeScript file
3. The extension will automatically start the language server
4. Enjoy real-time diagnostics, enhanced completions, and more!

The extension provides rich completions for various APIs:

// Andromeda File System APIs
Andromeda.readTextFileSync|  // 🗎 Reads a text file synchronously
Andromeda.writeFileSync|     // 💾 Writes binary data to a file

// Web APIs
crypto.subtle.digest|        // 🔐 Computes a digest of the given data
performance.now|             // ⏱️ High-precision timing
localStorage.setItem|        // 💾 Stores data in local storage

// Canvas APIs (when working with canvas)
ctx.fillRect|                // 🔳 Draws a filled rectangle
ctx.beginPath|               // 🎯 Begins a new path

The extension can automatically fix common issues:

• Convert var declarations to let or const
• Remove unused variables
• Fix camelCase naming issues
• Remove empty statements
• And more...

• JavaScript: .js, .mjs, .cjs
• JSX: .jsx
• TypeScript: .ts
• TSX: .tsx

1. Check Andromeda installation: andromeda --version
2. Check the Output panel: View → Output → "Andromeda Language Server"
3. Restart the language server: Command Palette → "Andromeda: Restart Language Server"
4. Check executable path: Ensure andromeda.executablePath is correctly set

1. Check run mode: Verify your andromeda.run setting
2. File type support: Ensure the file type is supported
3. Configuration conflicts: Check for conflicting configuration files
4. Enable diagnostics: Ensure andromeda.enable is set to true

1. Feature enabled: Check andromeda.completion.enable setting
2. Trigger characters: Try typing . after Andromeda, console, crypto, etc.
3. Server status: Check if the language server is running properly

1. Feature enabled: Check andromeda.format.enable setting
2. File saved: Ensure the file is saved before formatting
3. Syntax errors: Fix any syntax errors that might prevent formatting

npm install
npm run compile

1. Open this folder in VS Code
2. Press F5 to launch Extension Development Host
3. Test the extension in the new window
4. Check the Debug Console for any issues

npm run lint      # Check for TypeScript issues
npm run watch     # Watch for changes during development

• ✨ Enhanced Completions: Context-aware completions for Andromeda and Web APIs
• 🛠️ Code Actions: Auto-fix capabilities with quick fixes for common issues
• 📝 Formatting Support: Built-in document and range formatting
• 💡 Hover Information: Rich documentation on hover (when available)
• ⚙️ Improved Configuration: More granular control over features
• 🎯 Better Diagnostics: Enhanced linting rules with clearer error messages
• 🖱️ Context Menu Integration: Right-click to access auto-fix options

We welcome contributions! Please see the main Andromeda repository for contribution guidelines.

Mozilla Public License Version 2.0 - see LICENSE.md for details.

• Andromeda Runtime
• Issues & Bug Reports
• Discord Community