Skip to content

README.md

Latest commit

 

History

History
172 lines (127 loc) · 4.89 KB

README.md

File metadata and controls

172 lines (127 loc) · 4.89 KB

Script Language VS Code Extension

CI Version Downloads Rating

Official VS Code extension for the Script programming language - an AI-native language with production-grade generics, pattern matching, and memory safety.

This extension provides language support for the Script programming language in VS Code and Cursor.

Features

  • 🎨 Syntax Highlighting: Full syntax highlighting for all Script language constructs
  • 🔧 Language Configuration: Auto-closing brackets, comment toggling, smart indentation
  • 📁 File Recognition: .script files automatically recognized
  • 🎯 Language ID: Proper script language identifier for other extensions
  • 💡 Coming Soon: Language Server Protocol support (85% complete)

Installation

Method 1: VS Code Marketplace (Recommended)

  1. Open VS Code or Cursor
  2. Press Ctrl+P / Cmd+P
  3. Type ext install script-lang.script-lang
  4. Press Enter and click Install

✨ Auto-Updates: Once installed, the extension updates automatically when new versions are released!

Method 2: GitHub Release

  1. Download the latest .vsix file from Releases
  2. In VS Code: Extensions → ... → Install from VSIX
  3. Select the downloaded file

Method 3: Build from Source

  1. Copy the vscode-script-extension folder to your VS Code extensions directory:

    • Windows: %USERPROFILE%\.vscode\extensions\
    • macOS/Linux: ~/.vscode/extensions/
    • Cursor: Same locations but replace .vscode with .cursor

  2. Restart VS Code/Cursor

  3. Clone the repository:

    git clone https://github.com/moikas-code/vscode-script-extension.git
cd vscode-script

  4. Install dependencies:

    npm install

  5. Package the extension:

    npm run package

  6. Install the generated .vsix file:

    code --install-extension script-lang-*.vsix

Usage

Once installed:

  • .script files will be recognized with the script language ID
  • Syntax highlighting will work automatically
  • File icons will appear in the explorer (may need icon theme support)

Configuration

To improve icon support with popular icon themes:

Material Icon Theme:

"material-icon-theme.languages.associations": {
  "script": "javascript"
}

vscode-icons:

"vsicons.associations.files": [
  { "icon": "script", "extensions": ["script"], "format": "svg" }
]

Syntax Examples

// Function definition
fn main() {
    print("Hello, Script!")
}

// Variables and types
let name: string = "Script"
let version: f32 = 0.5
let features = ["generics", "pattern matching", "memory safety"]

// Pattern matching
match result {
    Ok(value) => print("Success: ${value}"),
    Err(error) => print("Error: ${error}")
}

// Generics
fn map<T, U>(items: Array<T>, transform: fn(T) -> U) -> Array<U> {
    // Implementation
}

// Async/await
async fn fetch_data(url: string) -> Result<string, Error> {
    let response = await http_get(url)
    Ok(response.body)
}

Contributing

Contributions are welcome! Please see our Contributing Guide for details.

Development Setup

  1. Clone the repository
  2. Run npm install
  3. Open in VS Code
  4. Press F5 to launch a new VS Code window with the extension loaded
  5. Open any .script file to test

Testing

npm test        # Run tests
npm run lint    # Check code style

Roadmap

  • Basic syntax highlighting
  • Language configuration
  • File type recognition
  • Language Server Protocol integration (85% complete)
  • IntelliSense and auto-completion
  • Debugging support
  • REPL integration
  • Code snippets
  • Formatting support

Auto-Updates

The extension automatically updates when new versions are published to the marketplace. You can:

  • Control auto-updates in VS Code settings
  • View update notifications with changelog links
  • Manually check for updates in the Extensions view

See AUTO_UPDATE.md for more details.

License

MIT - See LICENSE for details.

Links