╦  ╦╔═╗╦═╗╔═╗
╚╗╔╝║ ║╠╦╝╠═╣
 ╚╝ ╚═╝╩╚═╩ ╩

📋 About Vora Language

Features

✅ Syntax Highlighting

• Full syntax highlighting for all Vora keywords
• Support for async/await, match, coroutines
• ECS-specific syntax (system, component, entity, query)
• Math types (vec2, vec3, vec4, quaternion, mat4)

✅ Code Snippets

• main - Main entry point class
• func - Function definition
• asyncfunc - Async function
• class - Class definition
• struct - Struct definition
• system - ECS System
• component - ECS Component
• match - Pattern matching
• for - For loop
• while - While loop
• coroutine - Coroutine definition

✅ Commands

• Vora: Compile Current File (Ctrl+Shift+B) - Compile the active Vora file
• Vora: Run Current File (F5) - Run the active Vora file
• Vora: Format Document (Shift+Alt+F) - Format the current document

✅ Code Formatting

• Automatic indentation
• Configurable indent size
• Format on save support

✅ Linting

• Basic syntax checking
• Warning for missing semicolons
• TODO/FIXME highlighting

📦 Installation

Method 1: From VS Code Marketplace (Recommended)

1. Open VS Code
2. Press Ctrl+Shift+X to open Extensions view
3. Search for "Vora Language"
4. Click Install

Or install via command line:

code --install-extension cup-code-studio.vora

Method 2: From VSIX File

1. Download vora-1.0.0.vsix from Releases
2. Open VS Code
3. Press Ctrl+Shift+X to open Extensions
4. Click ... menu → Install from VSIX
5. Select the downloaded .vsix file

Method 3: From Source

# Clone repository
git clone https://github.com/majdengine/vora-vscode
cd vora-vscode

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Package extension
npx vsce package

# Install locally
code --install-extension vora-1.0.0.vsix

Requirements

• Visual Studio Code 1.80.0 or higher
• Vora compiler (vorac) installed and in PATH

Configuration

Open Settings (Ctrl+,) and search for "Vora":

• vora.compiler.path - Path to Vora compiler (default: "vorac")
• vora.format.indentSize - Indentation size (default: 4)
• vora.linting.enabled - Enable/disable linting (default: true)

Usage

Creating a Vora File

1. Create a new file with .vora extension
2. Start typing - syntax highlighting will activate automatically

Compiling

• Press Ctrl+Shift+B or
• Open Command Palette (Ctrl+Shift+P)
• Type "Vora: Compile Current File"

Running

• Press F5 or
• Open Command Palette (Ctrl+Shift+P)
• Type "Vora: Run Current File"

Formatting

• Press Shift+Alt+F or
• Right-click → "Format Document"

Example

// Simple Vora program
class Main {
    func start() {
        let message: string = "Hello, Vora!";
        print(message);
    }

    func update(deltaTime: float) {
        // Game loop
    }
}

Keyboard Shortcuts

Language Features

Keywords

• Control Flow: if, else, while, for, in, return, break, continue, match, yield
• Declarations: fn, func, class, struct, enum, let, mut, var, const, pub, import, as, from
• Async: async, await, spawn, coroutine
• ECS: system, component, entity, query, on, parallel

Types

• Primitives: i8, i16, i32, i64, u8, u16, u32, u64, f32, f64, bool, string, void
• Math: vec2, vec3, vec4, quaternion, mat4
• ECS: Entity, Transform, Rigidbody

Operators

• Arithmetic: +, -, *, /, %
• Comparison: ==, !=, <, >, <=, >=
• Logical: &&, ||, !
• Bitwise: &, |, ^, <<, >>
• Assignment: =, +=, -=, *=, /=
• Arrows: ->, =>

Troubleshooting

Syntax highlighting not working

• Make sure the file has .vora extension
• Reload VS Code (Ctrl+Shift+P → "Reload Window")

Compiler not found

• Ensure vorac is installed and in PATH
• Or set vora.compiler.path in settings to full path

Extension not loading

• Check Output panel (View → Output → "Vora Language Support")
• Ensure VS Code version is 1.80.0 or higher

Contributing

Found a bug or have a feature request? Please open an issue on GitHub.

License

MIT License - See LICENSE file for details

🔗 Links

• 🌐 Majd Engine Website
• 📖 Vora Documentation
• 💻 GitHub Repository
• 📦 VS Code Marketplace
• 💬 Discord Community

👥 Credits

code --install-extension cup-code-studio.vora

Enjoy coding with Vora! 🚀 استمتع بالبرمجة مع فورا!