Soul Language Extension for VS Code

Comprehensive Visual Studio Code support for the Soul programming language - a modern, dynamically typed scripting language designed for AI automation, web scraping, and system integration.

✨ Features

🎨 Rich Syntax Highlighting

• Complete Soul language syntax support
• Beautiful dark theme optimized for Soul code
• Proper highlighting for sanctuaries (classes), oasis (traits), and soul functions
• Comment, string, and operator highlighting

🧠 Intelligent Code Completion

• Smart IntelliSense for Soul keywords and built-in functions
• Class-aware completions - get method suggestions when typing MyClass.
• Built-in module support - completions for console, http, ai, math, json, spirit, and more
• User-defined function suggestions - automatically detects and suggests your custom functions
• Constructor patterns - smart suggestions for static vs regular sanctuaries

📖 Hover Documentation

• Comprehensive documentation for built-in functions
• Parameter information and usage examples
• User-defined function signatures with line numbers
• Module method documentation (e.g., console.log, http.get, spirit.abort)

🔍 Go to Definition

• Jump to function definitions with F12 or Ctrl+Click
• Navigate to class and method declarations
• Works with both built-in and user-defined symbols

🎯 Code Formatting

• Format on Save support with proper Soul indentation
• Automatic code beautification with consistent spacing
• Smart indentation for nested blocks and control structures

📝 Code Snippets

• Quick insertion of common Soul patterns:
  • soul function - Creates a Soul function template
  • async soul function - Creates an async Soul function
  • sanctuary class - Creates a Soul class (sanctuary) template
  • oasis trait - Creates a Soul trait (oasis) template

🚀 Soul Language Overview

Soul is a powerful scripting language with modern features designed for AI automation, web scraping, and system integration.

Key Language Features:

• Sanctuaries - Object-oriented classes with constructors (__genesis__)
• Oasis - Trait system for shared behavior
• Built-in AI modules - Direct integration with Anthropic, OpenAI, Gemini
• HTTP & WebSocket support - Built-in networking capabilities
• Async/await - Modern asynchronous programming
• Channels & Select - Go-style concurrency primitives

📋 Installation

1. From VS Code Marketplace:

   • Open VS Code
   • Go to Extensions (Ctrl+Shift+X)
   • Search for "Soul Language"
   • Click Install

2. From Command Line:

   • Run: code --install-extension gantz-ai.soul-language

⚙️ Configuration

The extension works out of the box with sensible defaults. Available settings:

• soul.formatOnSave: Enable/disable format on save (default: true)
• soul.insertSpaces: Use spaces instead of tabs (default: true)
• soul.tabSize: Number of spaces per indentation level (default: 4)

Auto-formatting Setup:

• Format on Save is enabled by default for .soul files
• Uses 4 spaces for indentation (configurable)
• Automatically detects and preserves your indentation style

📚 Supported File Extensions

• .soul - Soul source files

🎨 Themes

The extension includes a custom Soul Dark theme optimized for Soul syntax highlighting. It provides excellent contrast and readability for all Soul language constructs.

🐛 Known Issues

• Comment formatting improvements are ongoing
• Additional built-in modules will be added in future releases

📖 Documentation & Resources

• Soul Language GitHub: github.com/gantz-ai/soul
• Report Issues: GitHub Issues
• Soul Documentation: Learn more about Soul language features and syntax

🤝 Contributing

We welcome contributions! Please feel free to:

• Report bugs and request features via GitHub Issues
• Submit pull requests for improvements
• Share feedback and suggestions

📄 License

This extension is licensed under the MIT License.

Happy coding with Soul! 🚀

Made with ❤️ for the Soul programming language community