SimpleScript Syntax

VS Code Extension for the SimpleScript programming language (.sim)

This extension provides core developer features to make writing and reading SimpleScript code a clean and enjoyable experience, eliminating the frustrating syntax errors caused by standard editors.

✨ Features

This extension provides the foundational tools required for smooth SimpleScript development:

1. Syntax Highlighting: Correctly identifies and colorizes all SimpleScript keywords, operators, built-in types (TRUE, FALSE), strings, and numbers.
2. Code Folding: Allows you to collapse large structural blocks (If, While, To, Attempt) down to a single line using the standard folding controls in the editor gutter.
3. Bracket Matching: Enables automatic closing of parentheses (()) and quotes ("", '').
4. Comment Handling: Recognizes the hash symbol (#) as the line comment marker.

🛠️ Usage

Once installed, the extension automatically activates when you open any file ending with the .sim extension.

Example of Syntax Highlighting

The extension correctly identifies and colors the plain-text operators:

# Routine Declaration
To Calculate_Final_Price with distance, speed:
# Use 'plus', 'is greater than', and 'divided by'
Show "Current Speed: " plus speed

If speed is greater than 0:  
    time is distance divided by speed  
    GiveBack time  
End If.  

End Routine.

# Error Handling Block
Attempt:
result is Calculate_Final_Price with 500, 0
If Failed as error_message:
Show "Caught: " plus error_message
End Attempt.

📦 Installation

This extension is part of the overall SimpleScript project package.

1. Install the CLI: Ensure you have the core SimpleScript CLI tool installed globally:
   npm install -g simplescript-lang

2. Install the Extension: Search for "SimpleScript Syntax" in the VS Code Extensions Marketplace, or install manually via VSIX.

🤝 Contributing

This extension is built entirely on JSON configuration files. If you find any keywords that are not highlighted correctly, or if you would like to contribute more advanced features (like Go-to-Definition), please submit a pull request to the main SimpleScript repository.

The syntax grammar file is located at syntaxes/simplescript.tmLanguage.json.